Disclaimer

!IMPORTANT!	This is a development branch, that is not relelased by CompuLab officially yet

Supported Compulab Products

• UCM-iMX8M-Plus - NXP i.MX8M Plus System-on-Module
• MCM-iMX8M-Plus - SMD solder-down System-on-Module
• CL-SOM-iMX8Plus - NXP i.MX8M-Plus System-on-Module
• IOT-GATE-IMX8PLUS - Industrial IoT Gateway
• IOT-DIN-IMX8PLUS IoT Edge Gateway

Configuring the build

Setup Yocto environment

• WorkDir:

mkdir compulab-nxp-bsp && cd compulab-nxp-bsp

• Set a CompuLab machine:

Machine	Command Line
ucm-imx8m-plus	export MACHINE=ucm-imx8m-plus
ucm-imx8m-plus-sbev	export MACHINE=ucm-imx8m-plus-sbev
mcm-imx8m-plus	export MACHINE=mcm-imx8m-plus
som-imx8m-plus	export MACHINE=som-imx8m-plus
iot-gate-imx8plus	export MACHINE=iot-gate-imx8plus
sbc-iot-imx8plus	export MACHINE=iot-gate-imx8plus
iotdin-imx8p	export MACHINE=iotdin-imx8p

Initialize repo manifests

• NXP

repo init -u https://github.com/nxp-imx/imx-manifest.git -b imx-linux-scarthgap -m imx-6.6.23-2.0.0.xml

• CompuLab

wget --directory-prefix .repo/local_manifests https://raw.githubusercontent.com/compulab-yokneam/meta-bsp-imx8mp/scarthgap/scripts/meta-bsp-imx8mp.xml

• Sync Them all

repo sync

Setup build environment

• Initialize the build environment:

source compulab-setup-env build-${MACHINE}

• Enable the required dram setting's subset:
  Use Get the product DRAM configuration for more details

sed -i '$ a DRAM_CONF = "d2d4"' ${BUILDDIR}/conf/local.conf

• Enable the d1d8 dram setting's subset:

sed -i '/DRAM_CONF/d' ${BUILDDIR}/conf/local.conf

Get back to the build environment

In order to use the already created build environment issue these commands:

cd /path/to/compulab-nxp-bsp
repo sync
source setup-environment build-${MACHINE}

Build targets

• Main targets:

Target	Command	The target file location
full image	bitbake -k imx-image-full	${BUILDDIR}/tmp/deploy/images/${MACHINE}/imx-image-full-${MACHINE}.wic.zst
boot loader	bitbake -k imx-boot	${BUILDDIR}/tmp/deploy/images/${MACHINE}/imx-boot-tagged

• Other available targets (no desktop environment):

Target	Command	The target file location
fsl network image	bitbake -k fsl-image-network-full-cmdline	${BUILDDIR}/tmp/deploy/images/${MACHINE}/fsl-image-network-full-cmdline-${MACHINE}.wic.zst
oe core image	bitbake -k core-image-full-cmdline	${BUILDDIR}/tmp/deploy/images/${MACHINE}/core-image-full-cmdline-${MACHINE}.wic.zst

Deployment

Bootable sd card method

Host Machine

• Goto the tmp/deploy/images/${MACHINE} directory:

cd tmp/deploy/images/${MACHINE}

• Deploy the image:

zstd -dc imx-image-full-${MACHINE}.wic.zst > imx-image-full-${MACHINE}.wic
sudo bmaptool copy --bmap imx-image-full-${MACHINE}.wic.bmap imx-image-full-${MACHINE}.wic /dev/sdX

Target Device

• Turn off the device
• Insert the created sd-card
• Turn on the device and issue AltBoot

UUU method

Host Machine

• Goto the tmp/deploy/images/${MACHINE} directory:

cd tmp/deploy/images/${MACHINE}

• Issue uuu command with the root credentials:

zstd -dc imx-image-full-${MACHINE}.wic.zst > imx-image-full-${MACHINE}.wic
sudo uuu -v -b emmc_all imx-boot-tagged mx-image-full-${MACHINE}.wic

Target Device

NOTE	The target device must be in SDP or FB mode

MODE	Procedure to turn on	note
SDP	mmc dev 2 1; mmc erase 0x0 0x1000; reset	For advanced users only
FB	fastboot 0