imx93‐versa‐som - eaglelinuxplatform/meta-calixto-nxp GitHub Wiki

1. Host System Requirements

Yocto releases tested on Host machine versions

Yocto Host
Scarthgap Ubuntu 20.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

cd /home/${USER}/                         
mkdir calixto-yocto-bsp && cd calixto-yocto-bsp

Install the Calixto Linux BSP repo

repo init -u https://github.com/eaglelinuxplatform/calixto-manifest -b scarthgap -m cs-imx-6.6.52-2.2.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
imx93-calixto-versa_256mb i.MX93 Processor, NPU, 256MB LPDDR4x RAM, Versa SOM Family
imx93-calixto-versa_512mb i.MX93 Processor, NPU, 512MB LPDDR4x RAM, Versa SOM Family
imx93-calixto-versa_1gb i.MX93 Processor, NPU, 1GB LPDDR4x RAM, Versa SOM Family
imx93-calixto-versa_2gb i.MX93 Processor, NPU, 2GB LPDDR4x RAM, Versa SOM Family

Configure the distro and machine. Create a build directory for the BSP build

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

3. Build an Image

Setup the environment

cd calixto_workdir
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 iMX image with iMX test applications to be used for wayland backends
calixto-image-multimedia iMX image with a GUI without any Qt content
calixto-image-full An Opensource Qt6 image with ML features.

Run bitbake command to initiate the build process

bitbake <image>                                  

4. Output Image Location

Yocto generated images will be in the following directory

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

5. Booting

Check whether following images are in the Output Image Location :

Components Images
Example of Bootloader imx-boot-imx93-calixto-versa_1gb-sd.bin-flash_singleboot
Example of kernel Image--6.6.52+git0+ecaa84c029-r0-imx93-calixto-versa_1gb-20250201124256.bin
Example of dtb imx93-calixto-versa.dtb
Example of rootfs calixto-image-minimal-imx93-calixto-versa_1gb.rootfs-20250201124256.tar.zst

6. SD Card preparation

Follow the steps described in the link to create bootable SD Card for i.MX93 VERSA SOM

7. Board power up and booting

  • Insert SD Card on SD card J8 connector

  • Connect 12V DC power supply to J1 connector

8. Root File System Login details

Root Username root

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