Linux on SMARC-iMX8MP
The main purpose of this document is to help developers understand the overall software layout structure and enable them to compile each part of the software separately. It provides instructions for advanced users how Embedian offers patches and builds a customized version of u-boot and linux kernel for Embedian’s SMARC-iMX8MP product platform and how to install the images to bring the evaluation board up and running. It is very helpful for gaining a better understanding of the entire system.
The host Linux machine is recommended Ubuntu 20.04 or 22.04.
Once you have Ubuntu 20.04 or 22.04 LTS running, install the additional required support packages using the following console command:
$ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat cpio python python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint xterm rsync curl zstd lz4 libssl-dev pv device-tree-compiler libghc-gnutls-dev
Availability
SMARC-iMX8MP at Embedian.
Carrier Board
EVK-STD-CARRIER-S20 (universal carrier board for all SMARC 1.1 and 2.0 modules) at Embedian.
Basic Resources
- ARM Cross Compiler
- ARM: https://developer.arm.com/downloads/-/gnu-a
- Bootloader
- Das U-Boot – the Universal Boot Loader http://www.denx.de/wiki/U-Boot
- Source – http://git.denx.de/?p=u-boot.git;a=summary
- Linux Kernel
- Linus’s Mainline tree: http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=summary
- NXP Linux source tree: git://github.com/nxp-imx/linux-imx.git
- NXP Yocto BSP meta layer: https://github.com/nxp-imx/meta-imx/meta-bsp
- Freescale community BSP release: https://github.com/Freescale/meta-freescale-distro
- Embedian SMARC-iMX8MP Linux kernel source tree: https://github.com/embedian/smarc-fsl-linux-kernel.git
ARM Cross Compiler: GCC
To build Embedian’s SMARC-iMX8MP u-boot and linux kernel, you will need to install the following ARM compiler:
For u-boot 2024.04/2023.04 and Linux kernel 6.6.52/6.1.55 (paired by Yocto release), you need to use the following Arm compiler.
$ wget -c https://developer.arm.com/-/media/Files/downloads/gnu-a/10.3-2021.07/binrel/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz
$ sudo tar -Jxvf gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt
$ export CC=/opt/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu-
For u-boot 2022.04 and Linux kernel 5.15.71, you need to use the following ARM compiler.
$ wget -c https://developer.arm.com/-/media/Files/downloads/gnu-a/9.2-2019.12/binrel/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz
$ sudo tar -Jxvf gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz -C /opt
$ export CC=/opt/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu-
Test:
$ ${CC}gcc --version
Copyright (C) 2020 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Boot File: flash.bin
The boot file is called flash.bin. It is made up of some pieces of programs. This section instruct you how to generate flash.bin.
For u-boot 2024.04 and Linux kernel 6.6.52 (Paired from NXP Yocto Scarthgap release)
1. Download the imx-mkimage tool and apply Embedian’s patch to accept Embedian’s device tree blob.
Notes
Note 1:
For u-boot 2023.04 and Linux kernel 6.1.55 (Paired from NXP Yocto Mickledore release)
$ git clone https://github.com/nxp-imx/imx-mkimage -b lf-6.1.55_2.2.0
$ cd imx-mkimage
$ wget -c ftp://ftp.embedian.com/public/smarcimx8m/0001-imx8mp-mickledore-change-uboot-device-tree-name.patch
$ patch -p1 <0001-imx8m-mickledore-change-uboot-device-tree-name.patch
$ cd ../
Note 2:
For u-boot 2022.04 and Linux kernel 5.15.71 (Paired from NXP Yocto Kirkstone release)
$ git clone https://github.com/nxp-imx/imx-mkimage -b lf-5.15.71_2.2.0
$ cd imx-mkimage
$ wget -c ftp://ftp.embedian.com/public/smarcimx8m/0001-imx8mp-kirkstone-change-uboot-device-tree-name.patch
$ patch -p1 <0001-imx8m-kirkstone-change-uboot-device-tree-name.patch
$ cd ../
2. Get and Build the ARM Trusted firmware and copy bl31.bin to imx-mkimage/iMX8M directory.
$ git clone https://github.com/nxp-imx/imx-atf -b lf_v2.10
$ cd imx-atf
$ make CROSS_COMPILE=${CC} PLAT=imx8mp bl31
$ cp build/imx8mp/release/bl31.bin ../imx-mkimage/iMX8M/
$ cd ../
Notes
Note 1:
For u-boot 2023.04 and Linux kernel 6.1.55 (Paired from NXP Yocto Mickledore release)
$ git clone https://github.com/nxp-imx/imx-atf -b lf_v2.8
$ cd imx-atf
$ make CROSS_COMPILE=${CC} PLAT=imx8mp bl31
$ cp build/imx8mp/release/bl31.bin ../imx-mkimage/iMX8M/
$ cd ../
Note 2:
For u-boot 2022.04 and Linux kernel 5.15.71 (Paired from NXP Yocto Kirkstone release)
$ git clone https://github.com/nxp-imx/imx-atf -b lf_v2.6
$ cd imx-atf
$ make CROSS_COMPILE=${CC} PLAT=imx8mp bl31
$ cp build/imx8mp/release/bl31.bin ../imx-mkimage/iMX8M/
$ cd ../
3. Get the DDR firmware and copy to imx-mkimage/iMX8M/ directory.
$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.26.bin
$ chmod a+x firmware-imx-8.26.bin
$ ./firmware-imx-8.26
enter ”y” to accept EULA
$ cd firmware-imx-8.26
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/hdmi/cadence/signed_hdmi_imx8m.bin ../imx-mkimage/iMX8M/
$ cd ../
Notes
Note1:
For u-boot 2023.04 and Linux kernel 6.1.55 (Paired from NXP Yocto Mickledore release)
$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.22.bin
$ chmod a+x firmware-imx-8.22.bin
$ ./firmware-imx-8.22
enter ”y” to accept EULA
$ cd firmware-imx-8.22
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/hdmi/cadence/signed_hdmi_imx8m.bin ../imx-mkimage/iMX8M/
$ cd ../
Note 2:
For u-boot 2022.04 and Linux kernel 5.15.71 (Paired from NXP Yocto Kirkstone release)
$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.18.bin
$ chmod a+x firmware-imx-8.18.bin
$ ./firmware-imx-8.18
enter ”y” to accept EULA
$ cd firmware-imx-8.18
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_202006.bin ../imx-mkimage/iMX8M/
$ cp firmware/hdmi/cadence/signed_hdmi_imx8m.bin ../imx-mkimage/iMX8M/
$ cd ../
4. Clone the U-Boot source code from Embedian Guthub Server and copy related files to imx-mkimage/iMX8M/ directory.
Download:
For u-boot v2024.04: (Paired from NXP Yocto Scarthgap release)
$ git clone https://github.com/embedian/smarc-uboot.git v2024.04 -b emb_lf_v2024.04
Notes
Note 1:
For u-boot 2023.04 and Linux kernel 6.1.55 (Paired from NXP Yocto Mickledore release)
$ git clone https://github.com/embedian/smarc-uboot.git v2023.04 -b emb_lf_v2023.04
Note 2:
For u-boot 2022.04 and Linux kernel 5.15.71 (Paired from NXP Yocto Kirkstone release)
$ git clone https://github.com/embedian/smarc-uboot.git v2022.04 -b emb_lf_v2022.04
Configure and Build:
$ make ARCH=arm CROSS_COMPILE=${CC} distclean
$ make ARCH=arm CROSS_COMPILE=${CC} smarcimx8mp_4g_ser3_defconfig
$ make ARCH=arm CROSS_COMPILE=${CC}
Notes
Note 1:
If the board is 2GB LPDDR4 in commercial or industrial temperature, use
$ make ARCH=arm CROSS_COMPILE=${CC} smarcimx8mp_2g_ser3_defconfig
If the board is 4GB LPDDR4, use
$ make ARCH=arm CROSS_COMPILE=${CC} smarcimx8mp_4g_ser3_defconfig
If the board is 6GB LPDDR4, use
$ make ARCH=arm CROSS_COMPILE=${CC} smarcimx8mp_6g_ser3_defconfig
Note 2:
”ser3” stands for console debug port in SMARC definition. In this example, we uses SER3 as debug port. If user uses SER0 as your debug port, make change to ”ser0” instead. Same as SER1 and SER2.
Note 3:
To change the debug port, in addition to u-boot defconfig and uEnv.txt files, you also need to modify plat/imx/imx8m/imx8mp/platform.mk in the imx-atf. Find ”IMX_BOOT_UART_BASE ?= 0x30890000” and change to the correct address that defined in uEnv.txt file.
Note 4:
The SMARC-iMX8MP module always boot up from the on-module eMMC flash. The factory default will be flash.bin pre-installed with SER3 as console output. In some cases when the eMMC flash is empty or needs to be upgraded. Users can shunt crossed the TEST# to ground. In this way, the SMARC-iMX8MP module will boot up to carrier SD card. The flash.bin image are the same, the difference is where you flash flash.bin. This will be explained in the ”Setup SD card” section.
Copy u-boot-nodtb.bin spl/u-boot-spl.bin arch/arm/dts/imx8mp-smarc.dtb to imx-mkimage/iMX8M directory and copy tools/mkimage to imx-mkimage/iMX8M/mkimage_uboot
$ cp u-boot-nodtb.bin spl/u-boot-spl.bin arch/arm/dts/imx8mp-smarc.dtb ../imx-mkimage/iMX8M/
$ cp tools/mkimage ../imx-mkimage/iMX8M/mkimage_uboot
5. Generate flash.bin file.
$ cd ../imx-mkimage
$ make CROSS_COMPILE=${CC} SOC=iMX8MP clean
$ make CROSS_COMPILE=${CC} SOC=iMX8MP flash_evk
The flash.bin file will be located at imx-mkimage/iMX8M directory. Go to ”Setup SD Card” section to instruct you how to flash this file into SD card.
Linux Kernel
Download:
For Linux Kernel v6.6.52 (Paired from NXP Yocto Scarthgap release)
$ git clone https://github.com/embedian/smarc-fsl-linux-kernel.git v6.6.52 -b emb_imx_lf-6.6.y
Notes
Note1:
For u-boot 2023.04 and Linux kernel 6.1.55 (Paired from NXP Yocto Mickledore release)
$ git clone https://github.com/embedian/smarc-fsl-linux-kernel.git v6.1.55 -b emb_imx_lf-6.1.y
Note 2:
For u-boot 2022.04 and Linux kernel 5.15.71 (Paired from NXP Yocto Kirkstone release)
$ git clone https://github.com/embedian/smarc-fsl-linux-kernel.git v5.15.71 -b emb_imx_lf-5.15.y
Configure and Build:
$ make ARCH=arm64 CROSS_COMPILE=${CC} distclean
$ make ARCH=arm64 CROSS_COMPILE=${CC} emb_imx_v8_defconfig
$ make ARCH=arm64 CROSS_COMPILE=${CC} Image modules dtbs
Selecting display configuration is a matter of selecting an appropriate DTB file under arch/arm64/boot/dts/embedian.
All available DTB files are listed in the table below.
DTB FILENAME | DESCRIPTION |
imx8mp-smarc.dtb | Device tree blob for no display configuration |
imx8mp-smarc-hdmi.dtb | Device tree blob for HDMI display configuration |
imx8mp-smarc-lvds.dtb | Device tree blob for LVDS display configuration |
imx8mp-smarc-m7.dtb | Device tree blob for Cortex-M7 co-processor configuration |
Root File System
Ubuntu 22.04 Jammy Jellyfish:
USERNAME | PASSWORD |
user | user |
Ubuntu 22.04 Jammy Jellyfish Download:
$ wget -c ftp://ftp.embedian.com/public/dev/minfs/ubuntu/jammy_jellyfish/smarcimx8mp/imx-image-desktop-smarcimx8mp4g.tar.bz2
Verify:
$ md5sum imx-image-desktop-smarcimx8mp4g.tar.bz2
b54abbf8d70176e064e83e81c8cde138 imx-image-desktop-smarcimx8mp4g.tar.bz2
Debian 11 Bullseye:
USERNAME | PASSWORD |
root | root |
Debian 11 Bulleyes Download:
$ wget -c ftp://ftp.embedian.com/public/dev/minfs/debian/bullseye/imx8mp-bulleys-arm64.tar.gz
Verify:
$ md5sum imx8mp-bulleys-arm64.tar.gz
46cfa6a20116b77f5439ef8521b793f2 imx8mp-bulleys-arm64.tar.gz
Yocto Scarthgap:
USERNAME | PASSWORD |
root | N/A |
Yocto Scarthgap Download:
$ wget -c ftp://ftp.embedian.com/public/dev/minfs/ubuntu/jammy_jellyfish/smarcimx8mp/imx-image-desktop-smarcimx8mp4g.tar.bz2
Verify:
$ md5sum imx-image-desktop-smarcimx8mp4g.tar.bz2
b54abbf8d70176e064e83e81c8cde138 imx-image-desktop-smarcimx8mp4g.tar.bz2
Yocto Mickledore:
USERNAME | PASSWORD |
root | N/A |
Yocto Mickledore Download:
$ wget -c ftp://ftp.embedian.com/public/dev/minfs/dev/minfs/mickledore/fsl-image-qt6-validation-imx-smarcimx8mp4g.tar.bz2
Verify:
$ md5sum fsl-image-qt6-validation-imx-smarcimx8mp4g.tar.bz2
b54abbf8d70176e064e83e81c8cde138 imx-image-desktop-smarcimx8mp4g.tar.bz2
Yocto Kirkstone:
USERNAME | PASSWORD |
root | N/A |
Yocto Kirkstone Download:
$ wget -c ftp://ftp.embedian.com/public/dev/minfs/dev/minfs/kirkstone/fsl-image-qt6-validation-imx-smarcimx8mp4g.tar.bz2
Verify:
$ md5sum imx-image-desktop-smarcimx8mp4g.tar.bz2
17cc73111596590d004bd1601820e2e9 fsl-image-qt6-validation-imx-smarcimx8mp4g.tar.bz2
Setup SD Card
For these instruction, we are assuming: DISK=/dev/mmcblk0, ”lsblk” is very useful for determining the device id.
$ export DISK=/dev/mmcblk0
Erase SD card:
$ sudo dd if=/dev/zero of=${DISK} bs=2M count=160
Create Partition Layout: Leave 2MB offset for boot file. With util-linux v2.26, sfdisk was rewritten and is now based on libfdisk.
(sfdisk)
$ sudo sfdisk –version
sfdisk from util-linux 2.34
Create Partitions:
(sfdisk >=2.26.x)
$ sudo sfdisk ${DISK} <<-__EOF__
2M,48M,0x83,*
50M,,,
__EOF__
Format Partitions:
for: DISK=/dev/mmcblk0
$ sudo mkfs.vfat -F 16 ${DISK}p1 -n boot
$ sudo mkfs.ext4 ${DISK}p2 -L rootfs
for: DISK=/dev/sdX
$ sudo mkfs.vfat -F 16 ${DISK}1 -n boot
$ sudo mkfs.ext4 ${DISK}2 -L rootfs
Mount Partitions:
On some systems, these partitions may be auto-mounted…
$ sudo mkdir -p /media/boot/
$ sudo mkdir -p /media/rootfs/
for: DISK=/dev/mmcblk0
$ sudo mount ${DISK}p1 /media/boot/
$ sudo mount ${DISK}p2 /media/rootfs/
for: DISK=/dev/sdX
$ sudo mount ${DISK}1 /media/boot/
$ sudo mount ${DISK}2 /media/rootfs/
Boot file is factory default flashed at on-module eMMC flash.
Install Boot File (flash.bin
In some cases, when eMMC flash is erased or the u-boot is under development, we need a way to boot from SD card first. Users need to shunt cross the TEST# pin to ground. In this way, SMARC-iMX8MP will always boot up from SD card.
Write flash.bin to SD card.
~/imx-mkimage/
$ sudo dd if=iMX8M/flash.bin of=${DISK} bs=1024 seek=32
The flash.bin is pre-installed in on-module eMMC flash at factory default. SMARC-iMX8MP is designed to always boot up from on-module eMMC flash and to load Image, device tree blob and root file systems based on the setting of BOOT_SEL. If users need to fuse your own flash.bin or perform u-boot upgrade. This section will instruct you how to do that.
Copy flash.bin to the second partition home directory of your SD card and boot into SD card. Boot up from SD card and go to home directory and you should see flash.bin file.
~/imx-mkimage/
$ sudo cp -v iMX8M/flash.bin /media/rootfs/home/root/
Write flash.bin to the on-module eMMC flash. (The eMMC flash is emulated as /dev/mmcblk2 in SMARC-iMX8MP)
(home directory of device)
$ sudo dd if=flash.bin of=/dev/mmcblk2 bs=1024 seek=32
Notes
1. If your u-boot hasn’t been finalized and still under development, it is recommended to shunt cross the test pin and boot directly from SD card first (shunt cross TEST# to GND). Once your u-boot is fully tested and finalized, you can fuse your <boot file> to eMMC flash.
2. When TEST# pin of SMARC-iMX8MP is not shunt crossed, it will always boot up from on-module eMMC flash. U-boot will read the BOOT_SEL configuration and determine where it should load Image and device tree blob. When TEST# is shunt crossed (pull low), it will always boot up from SD card.
Install uEnv.txt based bootscript
Create ”uEnv.txt” boot script: ($ vim uEnv.txt)
~/uEnv.txt
optargs=”video=HDMI-A-1:1920×1080-32@60 consoleblank=0″
#optargs=”video=HDMI-A-1:3840×2160-32@30 consoleblank=0″
#optargs=”video=HDMI-A-1:3840×2160-32@60 consoleblank=0″
#console port SER3
console=ttymxc1,115200 earlycon=ec_imx6q,0x30890000,115200
#console port SER2
#console=ttymxc2,115200 earlycon=ec_imx6q,0x30880000,115200
#console port SER1
#console=ttymxc3,115200 earlycon=ec_imx6q,0x30a60000,115200
#console port SER0
#console=ttymxc0,115200 earlycon=ec_imx6q,0x30860000,115200
mmcdev=1
mmcpart=1
image=Image
loadaddr=0x40480000
fdt_addr=0x43000000
mmcroot=/dev/mmcblk1p2 rw
usbroot=/dev/sda2 rw
mmcrootfstype=ext4 rootwait fixrtc
netdev=eth0
ethact=FEC0
ipaddr=192.168.1.150
serverip=192.168.1.53
gatewayip=192.168.1.254
mmcargs=setenv bootargs ${mcore_clk} console=${console} root=${mmcroot} rootfstype=${mmcrootfstype} ${optargs}
uenvcmd=run loadimage; run loadfdt; run mmcboot
# USB Boot
#usbargs=setenv bootargs console=${console} root=${usbroot} rootfstype=${mmcrootfstype} ${optargs}
#uenvcmd=run loadusbimage; run loadusbfdt; run usbboot
Copy uEnv.txt to the boot partition:
~/
$ sudo cp -v ~/uEnv.txt /media/boot/
Install Linux Kernel Image
Copy Image to the boot partition:
~/<linux kernel source directory>/
$ sudo cp -v arch/arm/boot/Image /media/boot/
Install Linux Kernel Device Tree Binary
~/<linux kernel source directory>/
$ sudo mkdir -p /media/boot/dtbs
$ sudo cp -v arch/arm/boot/dts/embedian/<device tree binary> /media/boot/dtbs/imx8mp-smarc.dtb
All available DTB binary files are listed in the table below.
DTB FILENAME | DESCRIPTION |
imx8mp-smarc.dtb | Device tree blob for no display configuration |
imx8mp-smarc-hdmi.dtb | Device tree blob for HDMI display configuration |
imx8mp-smarc-lvds.dtb | Device tree blob for LVDS display configuration |
imx8mp-smarc-m7.dtb | Device tree blob for Cortex-M7 co-processor configuration |
Notes
The device tree name in your SD card has be to imx8mp-smarc.dtb
Install Root Filesystem
Extract the Yocto built root filesystem to your SD card
~/<directory where your rootfs is>/
$ sudo tar jxvf <filename.tar.bz2> -C /media/rootfs
~/<directory where your rootfs is>/
$ sudo tar xvfz <filename.tar.gz> -C /media/rootfs
Install Kernel Modules
~/<Linux kernel source directory>/
$ sudo make ARCH=arm64 CROSS_COMPILE=${CC} INSTALL_MOD_PATH=/media/rootfs modules_install
Notes
1. SMARC-iMX8MP always boots up from on-module eMMC flash first. The boot file in eMMC flash is factory pre-installed from Embedian. It will read the BOOT_SEL configuration that defined by SMARC specification on your carrier board and load Image and device tree blob from the partition one of the device (could be SD card, eMMC, GBE,..etc) that you selected.
2. MAC address is factory pre-installed at on board I2C EEPROM at offset 60 bytes. It starts with Embedian’s vendor code 10:0D:32. u-boot will read it and pass this parameter to kernel.
3. The kernel modules is included in the Yocto rootfs.
Remove SD card:
$ sync
$ sudo umount /media/boot
$ sudo umount /media/rootfs
Setup eMMC
Setting up eMMC usually is the last step at development stage after the development work is done at your SD card or NFS environments. From software point of view, eMMC is nothing but a non-removable SD card on board. For SMARC-iMX8MP, the SD card is always emulated as /dev/mmcblk1 and on-module eMMC is always emulated as /dev/mmcblk2. Setting up eMMC now is nothing but changing the device descriptor.
This section gives a step-by-step procedure to setup eMMC flash. Users can write a shell script your own at production to simplify the steps.
First, we need to backup the final firmware from your SD card or NFS.
Prepare for eMMC binaries from SD card (or NFS):
Insert SD card into your Linux PC. For these instructions, we are assuming: DISK=/dev/mmcblk0, ”lsblk” is very useful for determining the device id.
For these instruction, we are assuming: DISK=/dev/mmcblk0, ”lsblk” is very useful for determining the device id.
$ export DISK=/dev/mmcblk0
Mount Partitions:
On some systems, these partitions may be auto-mounted…
$ sudo mkdir -p /media/boot/
$ sudo mkdir -p /media/rootfs/
for: DISK=/dev/mmcblk0
$ sudo mount ${DISK}p1 /media/boot/
$ sudo mount ${DISK}p2 /media/rootfs/
for: DISK=/dev/sdX
<Host Computer>
$ sudo mount ${DISK}1 /media/boot/
$ sudo mount ${DISK}2 /media/rootfs/
Copy Image to rootfs partition
<Host Computer>
$ sudo cp -v /media/boot/Image /media/rootfs/home/root
Copy uEnv.txt to rootfs partition
Copy and paste the following contents to /media/rootfs/home/root ($ sudo vim /media/rootfs/home/root/uEnv.txt)
<Host Computer>
optargs=”video=HDMI-A-1:1920×1080-32@60 consoleblank=0″
#optargs=”video=HDMI-A-1:3840×2160-32@30 consoleblank=0″
#optargs=”video=HDMI-A-1:3840×2160-32@60 consoleblank=0″
#console port SER3
console=ttymxc1,115200 earlycon=ec_imx6q,0x30890000,115200
#console port SER2
#console=ttymxc2,115200 earlycon=ec_imx6q,0x30880000,115200
#console port SER1
#console=ttymxc3,115200 earlycon=ec_imx6q,0x30a60000,115200
#console port SER0
#console=ttymxc0,115200 earlycon=ec_imx6q,0x30860000,115200
mmcdev=2
mmcpart=1
image=Image
loadaddr=0x40480000
fdt_addr=0x43000000
mmcroot=/dev/mmcblk2p2 rw
usbroot=/dev/sda2 rw
mmcrootfstype=ext4 rootwait fixrtc
netdev=eth0
ethact=FEC0
ipaddr=192.168.1.150
serverip=192.168.1.53
gatewayip=192.168.1.254
mmcargs=setenv bootargs ${mcore_clk} console=${console} root=${mmcroot} rootfstype=${mmcrootfstype} ${optargs}
uenvcmd=run loadimage; run loadfdt; run mmcboot
# USB Boot
#usbargs=setenv bootargs console=${console} root=${usbroot} rootfstype=${mmcrootfstype} ${optargs}
#uenvcmd=run loadusbimage; run loadusbfdt; run usbboot
Copy device tree binary to rootfs partition
<Host Computer>
$ sudo cp -v /media/boot/dtbs/imx8mp-smarc.dtb /media/rootfs/home/root/imx8mp-smarc.dtb
Copy boot file to rootfs partition
~/imx-mkimage/
$ sudo cp -v iMX8M/flash.bin /media/rootfs/home/root/flash.bin
Copy final root file system to rootfs partition
<Host Computer>
$ pushd /media/rootfs
$ sudo tar cvfz ~/smarcimx8mp-emmc-rootfs.tar.gz .
$ sudo mv ~/smarcimx8mp-emmc-rootfs.tar.gz /media/rootfs/home/root
$ popd
Remove SD card:
$ sync
$ sudo umount /media/boot
$ sudo umount /media/rootfs
Copy Binaries to eMMC from SD card
Insert this SD card into your SMARC-iMX8MP device.
Now it will be almost the same as you did when setup your SD card, but the eMMC device descriptor is /dev/mmcblk2 now. Booting up the device from SD card (shunt cross TEST#).
$ export DISK=/dev/mmcblk2
Erase eMMC:
$ sudo dd if=/dev/zero of=${DISK} bs=2M count=160
Create Partition Layout:
$ sudo sfdisk ${DISK} <<-__EOF__
2M,48M,0x83,*
50M,,,
__EOF__
Format Partitions:
$ sudo mkfs.vfat -F 16 ${DISK}p1 -n boot
$ sudo mkfs.ext4 ${DISK}p2 -L rootfs
Mount Partitions:
$ sudo mkdir -p /media/boot/
$ sudo mkdir -p /media/rootfs/
$ sudo mount ${DISK}p1 /media/boot/
$ sudo mount ${DISK}p2 /media/rootfs/
Copy binaries to boot partition
Copy uEnv.txt/Image/*.dtb to the boot partition
$ sudo cp -v Image uEnv.txt /media/boot/
Copy Linux kernel device tree binary
$ sudo mkdir -p /media/boot/dtbs
$ sudo cp -v imx8mp-smarc.dtb /media/boot/dtbs/
Copy root file system to rootfs partition
$ sudo tar -zxvf smarcimx8mp-emmc-rootfs.tar.gz -C /media/rootfs
Unmount eMMC:
$ sync
$ sudo umount /media/boot
$ sudo umount /media/rootfs
Write boot file to eMMC
$ sudo dd if=flash.bin of=${DISK} bs=1024 seek=32
Switch your Boot Select to eMMC (OFF ON ON) and you will be able to boot up from eMMC now.
Video Decoding
For playing video, we can use three solutions to support it.
1. $ gplay-1.0 <video file>
2. $ gst-launch-1.0 playbin uri=file://<video absolute path>
3. (i) if video container on .mp4 format
$ gst-launch-1.0 filesrc location=<file name.mp4> typefind=true ! video/quicktime ! qtdemux ! queue max-size-time=0 ! vpudec ! queue max-size-time=0 ! kmssink force-hantrope=true sync=false &
(ii) if video container on .ts format
$ gst-launch-1.0 filesrc location=<file name.ts> typefind=true ! video/mpegts ! tsdemux ! queue max-size-time=0 ! vpudec ! queue max-size-time=0 ! waylandsink
Wi-Fi
The BSP includes NXP 88W8997 wifi chipset. Users can choose mPCIe or M.2 key E form factor wifi modules based on NXP 88W8997 chipset.
Recommended M.2 Form Factor WiFi Card
Recommended mPCIe Form Factor WiFi Card
Boot up the device and load the driver modules in the kernel.
root@smarcimx8mp4g:~# modprobe moal mod_para=nxp/wifi_mod_para.conf
[ 33.834782] can2-stby: disabling
[ 33.838051] VSD1_3V3: disabling
[ 33.979809] wlan: Loading MWLAN driver
[ 33.984701] wlan_pcie 0000:01:00.0: enabling device (0000 -> 0002)
[ 33.991014] Attach moal handle ops, card interface type: 0x204
[ 34.000829] PCIE8997: init module param from usr cfg
[ 34.005845] card_type: PCIE8997, config block: 0
[ 34.010483] cfg80211_wext=0xf
[ 34.013465] wfd_name=p2p
[ 34.016011] max_vir_bss=1
[ 34.018632] cal_data_cfg=none
[ 34.021611] drv_mode = 7
[ 34.024159] ps_mode = 2
[ 34.026604] auto_ds = 2
[ 34.029084] fw_name=nxp/pcieuart8997_combo_v4.bin
[ 34.033830] rx_work=1 cpu_num=4
[ 34.037010] Attach mlan adapter operations.card_type is 0x204.
[ 34.046917] Request firmware: nxp/pcieuart8997_combo_v4.bin
[ 35.013725] FW download over, size 627620 bytes
[ 35.879247] WLAN FW is active
[ 35.882226] on_time is 35807347500
[ 35.917890] fw_cap_info=0x18fcffa3, dev_cap_mask=0xffffffff
[ 35.923500] max_p2p_conn = 8, max_sta_conn = 8
[ 35.956580] wlan: version = PCIE8997-16.68.10.p16-MXM5X16214-GPL-(FP92)
[ 35.966307] wlan: Driver loaded successfully
root@smarcimx8mp4g:~#
Verify that the module is now visible to the system.
root@smarcimx8mp4g:~# ifconfig -a
can0: flags=128<NOARP> mtu 16
unspec 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 txqueuelen 10 (UNSPEC)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
device interrupt 35
can1: flags=128<NOARP> mtu 16
unspec 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 txqueuelen 10 (UNSPEC)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
device interrupt 36
eth0: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 10:0d:32:01:00:01 txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
eth1: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 10:0d:32:02:00:01 txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
device interrupt 54
lo: flags=73<UP,LOOPBACK,RUNNING> mtu 65536
inet 127.0.0.1 netmask 255.0.0.0
inet6 ::1 prefixlen 128 scopeid 0x10<host>
loop txqueuelen 1000 (Local Loopback)
RX packets 3452 bytes 216146 (211.0 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 3452 bytes 216146 (211.0 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
mlan0: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 4a:6b:15:b3:7f:a4 txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
p2p0: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 2a:08:86:b1:27:cb txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
uap0: flags=4099<UP,BROADCAST,MULTICAST> mtu 1500
ether 5a:57:c4:46:2b:68 txqueuelen 1000 (Ethernet)
RX packets 0 bytes 0 (0.0 B)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 0 bytes 0 (0.0 B)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
root@smarcimx8mp4g:~#
In case you need to see which network and you can scan it and select the one you need.
root@smarcimx8mp4g:~# iwlist mlan0 scan
mlan0 Scan completed :
Cell 01 – Address: 78:C5:7D:D9:62:02
ESSID:”daint”
Mode:Master
Frequency=5.22 GHz (Channel 44)
Quality:1/5 Signal level:-86 dBm Noise level:-96 dBm
Encryption key:on
Bit Rates:6 Mb/s; 9 Mb/s; 12 Mb/s; 18 Mb/s; 24 Mb/s
36 Mb/s; 48 Mb/s; 54 Mb/s
Extra:Beacon interval=100
IE: IEEE 802.11i/WPA2 Version 1
Group Cipher : CCMP
Pairwise Ciphers (1) : CCMP
Authentication Suites (1) : PSK
IE: Unknown: DD360050F204104A0001101044000102105700010110470010BC329E001DD811B2860178C57D D96202103C0001021049000600372A000120
IE: Unknown: DD180050F2020101800003A4000027A4000042435E0062322F00
IE: Unknown: DD07000C4300000000
IE: Unknown: DD21000CE700000000BF0CB101C0332AFF92042AFF9204C0050000002AFFC303010202
IE: Unknown: DD1F000CE700010000000000012710000000000000000000000000000000000000
Extra:band=a
….
Cell 13 – Address: 48:EE:0C:ED:D7:38
ESSID:”embedian” [13]
Mode:Master
Frequency=5.805 GHz
Quality:5/5 Signal level:-42 dBm Noise level:-96 dBm
Encryption key:on
Bit Rates:6 Mb/s; 9 Mb/s; 12 Mb/s; 18 Mb/s; 24 Mb/s
36 Mb/s; 48 Mb/s; 54 Mb/s
Extra:Beacon interval=100
IE: WPA Version 1
Group Cipher : TKIP
Pairwise Ciphers (2) : TKIP CCMP
Authentication Suites (1) : PSK
IE: IEEE 802.11i/WPA2 Version 1
Group Cipher : TKIP
Pairwise Ciphers (2) : TKIP CCMP
Authentication Suites (1) : PSK
IE: Unknown: DD180050F2020101000003A4000027A4000042435E0062322F00
IE: Unknown: DD1E00904C336E181FFFFF00000000000000000000000000000000000000000 0
IE: Unknown: DD1A00904C34A1070000000000000000000000000000000000000000
IE: Unknown: DD0700E04C02026004
IE: Unknown: DD7F0050F204104A0001101044000102103B00010310470010112233445566778899AA48EE0C EDD73610210006442D4C696E6B102300074449522D383432102400074449522D383432104200 0830303030303030301054000800060050F2040001101100074449522D38343210080002208C 103C0001031049000600372A000120
Extra:band=a
…
Identify the network and add it to the WPA supplicant file.
root@smarcimx8mp4g:~# vim /etc/wpa_supplicant.conf
ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
update_config=1
network={
scan_ssid=1
ssid=”embedian”
psk=”xxxxxxxxxx”
}
Associate the Wi-Fi with config
root@smarcimx8mp4g:~# wpa_supplicant -B -i mlan0 -c /etc/wpa_supplicant.conf
Successfully initialized wpa_supplicant
rfkill: Cannot open RFKILL control device
root@smarcimx8mp4g:~# [ 320.336481] wlan: mlan0 START SCAN
[ 325.293957] wlan: SCAN COMPLETED: scanned AP count=21
[ 325.310912] wlan: HostMlme mlan0 send auth to bssid 48:XX:XX:XX:d7:38
[ 325.318413] mlan0:
[ 325.318428] wlan: HostMlme Auth received from 48:XX:XX:XX:d7:38
[ 325.350060] wlan: HostMlme mlan0 Connected to bssid 48:XX:XX:XX:d7:38 successfully
[ 325.359406] mlan0:
[ 325.359424] wlan: Send EAPOL pkt to 48:XX:XX:XX:d7:38
[ 325.368630] mlan0:
[ 325.368645] wlan: Send EAPOL pkt to 48:XX:XX:XX:d7:38
[ 325.385563] IPv6: ADDRCONF(NETDEV_CHANGE): mlan0: link becomes ready
[ 325.392567] woal_cfg80211_set_rekey_data return: gtk_rekey_offload is DISABLE
root@smarcimx8mp4g:~#
Check if you have right SSID associated.
root@smarcimx8mp4g:~# iwconfig mlan0
mlan0 IEEE 802.11-DS ESSID:”embedian” [11]
Mode:Managed Frequency=5.805 GHz Access Point: 48:EE:0C:ED:D7:38
Bit Rate:433.5 Mb/s Tx-Power=24 dBm
Retry limit:9 RTS thr=2347 B Fragment thr=2346 B
Encryption key:****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-****-**** Security mode:open
Power Management:on
Link Quality=5/5 Signal level=-44 dBm Noise level=-89 dBm
Rx invalid nwid:0 Rx invalid crypt:0 Rx invalid frag:457
Tx excessive retries:2 Invalid misc:8 Missed beacon:0
root@smarcimx8mp4g:~#
Use DHCP to get IP
root@smarcimx8mp4g:~# udhcpc -i mlan0
udhcpc: started, v1.32.0
udhcpc: sending discover
udhcpc: sending select for 192.168.1.57
udhcpc: lease of 192.168.1.57 obtained, lease time 86400
/etc/udhcpc.d/50default: Adding DNS 192.168.1.254
root@smarcimx8mp4g:~#
You should be able to ping local network now.
root@smarcimx8mp4g:~# ping 192.168.1.10
PING 192.168.1.10 (192.168.1.10) 56(84) bytes of data.
64 bytes from 192.168.1.10: icmp_seq=1 ttl=64 time=2141 ms
64 bytes from 192.168.1.10: icmp_seq=2 ttl=64 time=1120 ms
64 bytes from 192.168.1.10: icmp_seq=3 ttl=64 time=95.7 ms
64 bytes from 192.168.1.10: icmp_seq=4 ttl=64 time=1.63 ms
version 1.0a, 10/28/2024
Last updated 2024-10-28