imx8mp‐optima‐som - eaglelinuxplatform/meta-calixto-nxp GitHub Wiki

1. Host System Requirements

Yocto releases tested on Host machine versions

Yocto Host
Wrynose Ubuntu 22.04

Please ensure you have git installed in your host machine.

sudo apt-get install git

Setting up the Repo utility

mkdir ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

Create a work directory

mkdir calixto-yocto-bsp && cd calixto-yocto-bsp

Install the BSP repo

repo init -u https://github.com/eaglelinuxplatform/calixto-manifest.git -b wrynose -m cs-imx-6.18.20-2.0.0.xml

Download the Yocto Project Layers

repo sync

Install packages required for building the images

sudo ./install_prerequisites.sh 

2. Create the build directory

Note

Select DISTRO and MACHINE from the table and use it in the following commands

distro Description
fsl-imx-wayland Pure wayland graphics
fsl-imx-xwayland wayland graphics and X11
machine Description
imx8mp-calixto-optima_2gb i.MX8MP Processor, 2GB LPDDR4 RAM, Optima SOM Family
imx8mp-calixto-optima_4gb i.MX8MP Processor, 4GB LPDDR4 RAM, Optima SOM Family

Configure the distro and machine. Create a build directory

DISTRO=<distro> MACHINE=<machine> source calixto-setup-release.sh -b build_dir

3. Build an Image

Setup the environment

source setup-environment build_dir

Note

Select image from the table and use it in the following commands.

image Description
calixto-image-minimal A small image that only allows a device to boot
calixto-image-core An i.MX image with i.MX test applications to be used for Wayland backends
calixto-image-multimedia Builds an i.MX image with a GUI without any Qt content
calixto-image-full Builds an open source Qt 6 image with Machine Learning features

Run bitbake command to start build

bitbake <image>

4. Output Image Location

ls /home/${USER}/calixto-yocto-bsp/<build_dir>/tmp/deploy/images/<machine> 

5. Booting

Components Images
Example of Bootloader imx-boot-imx8mp-calixto-optima_2gb-sd.bin-flash_evk
Example of kernel Image--6.18.20+git0+75ab78417e-r0-imx8mp-calixto-optima_2gb-20260916073158.bin
Example of dtb imx8mp-calixto-optima.dtb
Example of rootfs.tar image calixto-image-full-imx8mp-calixto-optima_2gb.rootfs-20261001045810.tar.zst
Example of rootfs.wic image calixto-image-full-imx8mp-calixto-optima_2gb.rootfs-20261009070955.wic.zst

6. Image Flashing

An OS image can be flashed to an SD card using one of two primary methods: directly flashing a pre-built .wic image, or manually partitioning the SD card and writing individual components (bootloader, kernel, and rootfs).

6.1 Flashing wic image

Copy the wic.zst image in a directory. Insert the SD card into your host system and list all block devices to determine its assigned node:

lsblk

Eg: The device node assigned is /dev/sdb (a block is 1024 Bytes).

zstdcat <image_name>.wic.zst | sudo dd of=/dev/sd<partition> bs=1M conv=fsync

Note

Make sure that the device node is correct for the SD/MMC card. Otherwise, it may damage your operating system or data on your computer.

6.2 SD Card Partition and Flash

Follow steps in link to partition SD Card and flash the images

7. Board power up and booting

  • Insert SD Card on SD card J8 connector
  • Connect 12V DC power supply to J25 connector

8. Root File System Login details

Root Username root

Go Back to HOME

Calixto Systems - 2026

⚠️ **GitHub.com Fallback** ⚠️