Disclaimer

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

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
som-imx8m-plus	export MACHINE=som-imx8m-plus
iot-gate-imx8plus	export MACHINE=iot-gate-imx8plus
sbc-iot-imx8plus	export MACHINE=iot-gate-imx8plus

Initialize repo manifests

• NXP

repo init -u https://github.com/nxp-imx/imx-manifest.git -b imx-linux-kirkstone -m imx-5.15.71-2.2.0.xml

• CompuLab

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

• Sync Them all

repo sync

Get the product DRAM configuration

The device DRAM configuration is at the device label and is also stored in the device EEPROM.

• Getting memory configuration from the label: Use the 'D' option code from the device label.

• Getting memory configuration from the EEPROM:

Environment	Command	Output	Description
U-Boot	i2c dev 1; i2c md 0x50 0x90 0x10	0090: 43 31 38 30 30 51 4d 2d 44 34 2d 4e 33 32 2d 00 C1800QM-D4-N32-.	D4 = 4G
Kernel	i2cdump -f -y 1 0x50 2>/dev/null | awk '/^90:/'	0: 43 31 38 30 30 51 4d 2d 44 34 2d 4e 33 32 2d 00 C1800QM-D4-N32-.

• Mapping of product DRAM configuration to DRAM_CONF:

Product DRAM Option	DRAM_CONF
D1,D8	d1d8
D2,D4	d2d4

Setup build environment

• Initialize the build environment:

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

• Enable the d2d4 dram setting's subset:

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

Build targets

• Building the image:

bitbake -k imx-image-full

• Building the bootloader file only:

build command	binary file location
bitbake -k imx-boot	${BUILDDIR}/tmp/deploy/images/${MACHINE}/imx-boot-tagged

Get back to the already created build environment

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

Deployment

Create a bootable sd card

• 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