Disclaimer

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:

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

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