Ilko: Rename iMX8MP-CM to iMX8MP-COMPACT-CM

2024-02-06T09:26:29Z

Rename iMX8MP-CM to iMX8MP-COMPACT-CM

← Older revision		Revision as of 10:26, 6 February 2024
Line 1:		Line 1:
	{{#vardefine:HARDWARE_NAME\|iMX8MP-CM}}		{{#vardefine:HARDWARE_NAME\|iMX8MP-COMPACT-CM}}
	{{#vardefine:MACHINE_NAME\|imx8mp-cm}}		{{#vardefine:MACHINE_NAME\|imx8mp-cm}}
	{{#vardefine:YOCTO_NAME\|micledore}}		{{#vardefine:YOCTO_NAME\|micledore}}

Ilko: Ilko moved page iMX8MP-CM Yocto Linux to iMX8MP-COMPACT-CM Yocto Linux

2024-02-06T09:24:56Z

Ilko moved page iMX8MP-CM Yocto Linux to iMX8MP-COMPACT-CM Yocto Linux

← Older revision	Revision as of 10:24, 6 February 2024
(No difference)

Ilko: initial creation

2024-01-25T14:29:55Z

initial creation

New page

{{#vardefine:HARDWARE_NAME|iMX8MP-CM}}
{{#vardefine:MACHINE_NAME|imx8mp-cm}}
{{#vardefine:YOCTO_NAME|micledore}}
{{#vardefine:KERNEL_VER|6.1.55}}
{{#vardefine:UBOOT_VER|v2023.04}}
[[File:iMX8MP-CM-top.png|thumb]]

== Overview ==
The Yocto Project is an open source collaboration project that helps developers create custom Linux-based systems for embedded products, regardless of the hardware architecture. 
This article show how to build Yocto Image for {{#var:HARDWARE_NAME}} CPU module using: 
{| class="wikitable"
|-
!
! Linux Kernel
! U-BOOT
|-
| Yocto {{#var:YOCTO_NAME}}
| {{#var:KERNEL_VER}}
| {{#var:UBOOT_VER}}
|}

[https://www.yoctoproject.org/docs/ Learn more about Yocto]

== Setting Boot mode ==
{| class="wikitable"
|+ Boot mode setting on carrier board
|-
! BOOT !! J4:1-2 !! J4:3-4 !! J4:5-6 !! J4:7-8
|-
| Cortex-A53 Serial Downloader || close || open || open || open
|-
| Cortex-A53, eMMC || open || close || open || open
|}

== Terminal Setup ==
The carrier board connects the host PC using the micro-B USB connector (J6). 
Common serial communication programs such as Minicom, HyperTerminal, Tera Term, or PuTTY can be used. 
The {{#var:HARDWARE_NAME}} board uses the second port for the Arm Cortex-A cores console.

== Installing required packages ==

Please make sure your host PC is running Ubuntu 20.04+ 64-bit and install the following packages:
<pre>
$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
build-essential chrpath socat cpio python3 python3-pip python3-pexpect \
xz-utils debianutils iputils-ping libsdl1.2-dev xterm python-is-python3 lz4

$ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev python-git-doc \
sed cvs subversion coreutils texi2html docbook-utils \
help2man make gcc g++ desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev \
mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \
libncurses5 libncurses5-dev libncursesw5-dev libelf-dev zlib1g-dev bmap-tools
</pre>

More details about the Yocto Environment Setup can be found
[https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html on the Yocto official site]

== Download Yocto based on Freescale Community BSP ==

$ git config --global user.name "Your Name"
$ git config --global user.email "Your Email"

$ mkdir ~/bin
$ curl <nowiki>http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo</nowiki>
$ chmod a+x ~/bin/repo
$ export PATH=~/bin:$PATH

$ mkdir ~/yocto-ronetix
$ cd ~/yocto-ronetix

* '''Download the Yocto repository''' 
$ repo init -u https://github.com/ronetix/imx-manifest -b imx-linux-mickledore -m imx-6.1.55-2.2.0.xml
$ repo sync

== Setup and build Yocto ==
* Setup first time:
$ MACHINE={{#var:MACHINE_NAME}} DISTRO=fsl-imx-xwayland source ./imx-setup-release.sh -b build-{{#var:MACHINE_NAME}}

* or setup if already configured:
$ source setup-environment build-{{#var:MACHINE_NAME}}

* Build:
$ bitbake imx-image-core

=== Build Results ===
The resulted images are located in tmp/deploy/images/{{#var:MACHINE_NAME}}.

=== Booting Linux ===
This section describes how to copy the images (U-Boot, Linux kernel, device tree, and
rootfs) to the eMMC device on the module.

==== Universal update utility ====
The Universal Update Utility (UUU) runs on a Windows or Linux OS host and is used to download images to devices on an i.MX board.

===== Downloading UUU =====
Download UUU version 1.5.21 or later from https://github.com/nxp-imx/mfgtools/releases

===== Write WIC image info eMMC =====
Follow the instructions below:
* Connect a USB cable from a computer to the J7, port USB Type C port on the carrier board for download link.
* Connect a USB cable from J6, port UART-DBG (Micro-AB) port to the computer for console output.
* Open a Terminal emulator program
* Set the boot mode to "Cortex-A53 Serial Downloader", see [[#Setting Boot mode]]

$ cd tmp/deploy/images/{{#var:MACHINE_NAME}}
$ uuu -b emmc_all imx-boot-tagged imx-image-core-{{#var:MACHINE_NAME}}.wic.zst

==== Boot Linux ====
* set the boot mode to "Cortex-A53, eMMC", see [[#Setting Boot mode]]
* reset the board

== See also ==
* [[{{#var:HARDWARE_NAME}} Yocto Linux | Yocto Linux]]
* [[{{#var:HARDWARE_NAME}} Linux|Building Linux Kernel]]
* [[{{#var:HARDWARE_NAME}} U-Boot|Building U-Boot]]

iMX8MP-COMPACT-CM Yocto Linux - Revision history

Ilko: Rename iMX8MP-CM to iMX8MP-COMPACT-CM

Ilko: Ilko moved page iMX8MP-CM Yocto Linux to iMX8MP-COMPACT-CM Yocto Linux

Ilko: initial creation