Setup

1. If you don't have the repo tool installed, please refer to Build Torizon OS From Source with Yocto Project.
2. Initialize and sync the repo manifest for NXP:

   $ mkdir common-torizon; cd common-torizon
   $ repo init -u https://git.toradex.com/toradex-manifest.git -b master -m common-torizon/nxp/default.xml
   $ repo sync -j 10
   

   We strongly recommend using the default.xml manifest. The integration.xml and next.xml are development manifests used internally and they might be unstable. default.xml is the manifest used for our releases, so they are reliable.

Alternatively, you can manually clone all layers one by one. Refer to the section Manual Setup at the end of this document to learn how.

Build

Board	MACHINE	Status
FRDM i.MX 93	imx93frdm	Supported
Verdin i.MX95 EVK	imx95-19x19-verdin	Supported

1. Source setup-environment, specifying the machine to build with the MACHINE variable e.g.:

   $ MACHINE=imx93frdm . torizon-setup-environment <build-directory>
   

   If a build directory is not given, the script will create one named build, where all build artifacts will be stored.

2. Inside the build directory, start the build e.g.:

   $ bitbake torizon-docker
   

   All artifacts should be inside <build-directory>/deploy/images/${MACHINE}.

Flash the Device (Verdin i.MX95 EVK)

1. Change board boot switch to ON OFF OFF ON (CM33 Serial Download)
2. Download uuu or build it from source
3. Download image:

   sudo ./uuu -b emmc_all <bootloader> <wic image>
   

   For example, flashing a local build we've generated:

   sudo ./uuu -v -b emmc_all imx-boot-imx95-19x19-verdin-sd.bin-flash_all torizon-docker-imx95-19x19-verdin-7.0.0-devel-20250602173442+build.0.wic.zst
   

4. Change boot switch to ON OFF ON OFF (CM33 eMMC) to boot from eMMC.

Flash the Device (FRDM i.MX93 SDCard)

1. Change board boot switch to ON ON OFF OFF to boot from SDCard.
2. Flash the wic image to an SDCard.

   zstdcat if=torizon-docker-imx93-11x11-lpddr4x-frdm-7.0.0-devel-20250602173442+build.0.wic.zst | sudo dd of=<sdcard-device-node>
   

3. Insert the SDCard.
4. Power on the board.

Flash the Device (FRDM i.MX93 eMMC)

Coming Soon

Manual Setup

1. Create the project folder:

   $ mkdir common-torizon; cd common-torizon
   

2. Clone NXP's BSP layers:

   $ repo init -u https://github.com/nxp-imx/imx-manifest.git -b imx-linux-scarthgap -m imx-6.6.52-2.2.0.xml
   $ repo sync -j 10
   

3. Clone the meta-torizon and meta-torizon-bsp layers, and their dependencies:

   $ git clone https://github.com/torizon/meta-torizon.git -b master sources/meta-torizon
   $ git clone https://github.com/torizon/meta-torizon-bsp.git -b master sources/meta-torizon-bsp
   $ git clone https://github.com/uptane/meta-updater.git -b scarthgap sources/meta-updater
   $ ln -s sources/meta-torizon-bsp/scripts/setup-environment torizon-setup-environment
   

Additional Setup for i.MX93 FRDM boards

1. Clone NXP's BSP layers specific to the i.MX93 FRDM board:

   $ git clone https://github.com/nxp-imx-support/meta-imx-frdm.git -b imx-frdm-4.0 sources/meta-imx-frdm
   $ ln -s sources/meta-imx-frdm/tools/imx-frdm-setup.sh imx-frdm-setup.sh