CL-SOM-iMX8MAX: Yocto Linux: Manual Installation: SD card

From Compulab Mediawiki
Jump to: navigation, search


This article provides instructions needed to install the Yocto Linux SD-card image on SD card using a Linux Host workstation. The image provides a full boot system including U-Boot, Linux kernel, device driver modules and example root filesystem.

Preparation steps

  • Obtain a Linux PC workstation.
  • Obtain a USB Card reader and a micro-SD Card. Any commercially available micro-SD card of 4GB (or larger) may be used for the installation.
  • Download the CL-SOM-iMX8MAX Yocto Linux package from CompuLab website.
  • Unzip the package to a directory on the host workstation.
  • The Yocto Linux SD-card image file, mentioned below, can be found in the images subdirectory.
  • Plug the USB SD Card reader into the host PC. Insert the micro-SD Card into the USB Card reader. From now we assume the device name of the MMC/SD card on your Linux PC is /dev/sdX.


Using bb utility

  • Flash the image file to the micro-SD card:
bzcat ~/path/to/cl-som-imx8max_yocto-linux/images/compulab-image-cl-som-imx8max.wic.bz2 | sudo dd of=/dev/sdX bs=1M status=progress conv=fsync

Using bmaptool utility

  • Flash the image file to the micro-SD card:
sudo bmaptool copy ~/path/to/cl-som-imx8max_yocto-linux/images/compulab-image-cl-som-imx8max.wic.bz2 --bmap ~/path/to/cl-som-imx8max_yocto-linux/images/compulab-image-cl-som-imx8max.wic.bmap /dev/sdX

Run Yocto Linux image

  • Insert the micro-SD card into the SD card socket P13.
  • Connect a DP Display to DP connector P4 using a standard DP cable.
  • Connect a standard USB cable (included in the kit) between your host PC and the evaluation kit micro-USB2.0 connector P12.
    Use a terminal emulator as described here
  • Connect the 12V power supply adapter to DC power connector J3 and turn on the system.
  • The system will automatically boot into Linux.

Admolition note.png The above procedure assumes slightly modified default U-boot settings.

When U-Boot starts press any key to stop autoboot. Set the correct U-Boot environment in the U-Boot prompt:

CL-SOM-iMX8MAX # env default -a
CL-SOM-iMX8MAX # setenv hdp_file dpfw.bin
CL-SOM-iMX8MAX # setenv fdt_file imx8qm-sbc-imx8max-dp.dtb
CL-SOM-iMX8MAX # saveenv
CL-SOM-iMX8MAX # reset