Trucrux Inc

Building OS for TRUX-iMX8MM

Host system required OS environment Ubuntu 18.04/20.04 64-bit

Host system required  Minimum storage : 150GB

Installing Dependencies #

Run the following command to install dependencies

$ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib \
build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \
xz-utils debianutils iputils-ping libsdl1.2-dev xterm
$ sudo apt-get install autoconf libtool libglib2.0-dev libarchive-dev python-git \
sed cvs subversion coreutils texi2html docbook-utils python-pysqlite2 \
help2man make gcc g++ desktop-file-utils libgl1-mesa-dev libglu1-mesa-dev \
mercurial automake groff curl lzop asciidoc u-boot-tools dos2unix mtd-utils pv \
libncurses5 libncurses5-dev libncursesw5-dev libelf-dev zlib1g-dev bc rename

If the environment OS is Ubuntu 20.04 a warning message  Package python-git is not available, … is received. Run this command to install python package

$ sudo apt-get install python3-git

GIT configurations and Repo setup #

$ git config --global <name>
$ git config --global <email>
$ mkdir ~/bin (this step may not be needed if the bin folder already exists)
$ curl > ~/bin/repo
$ chmod a+x ~/bin/repo
$ export PATH=~/bin:$PATH

Replace <name> by git username and <email> by git registered email

Downloading codesetup #

Create a new directory “CodeSetup” (or any name preferred)for the setup.

$ mkdir ~/CodeSetup
$ cd ~/CodeSetup

Run the below commands to sync the repos required for build in the CodeSetup directory

$ repo init -u -b dunfell -m default.xml
$ repo sync -j$(nproc)


  • Download a release tag
$ repo init -u -b refs/tags/dunfell-imx8mm-v1.0.0_release -m default.xml
$ repo sync -j$(nproc)

Setup and OS build #

Trucrux provides below image:

  • fsl-image-gui – is a default trucrux image with GUI and without Qt5 support

Supported Distro

  • fslc-xwayland: Distro for Wayland with X11. This distro includes both wayland and X11 features.
  • fslc-wayland: Distro for Wayland without X11. This distro includes wayland feature but doesn’t have x11 support.

To build xwayland distro image follow the below steps:

Use the below command to setup the build environment for the first time

$ cd ~/CodeSetup
$ MACHINE=imx8mm-trux-q01 DISTRO=fslc-xwayland . setup-environment build_xwayland

Once the machine is set the build environment with the following command

$ source setup-environment build_xwayland

Use bitbake command to build OS image

$ bitbake fsl-image-gui

For more bitbake options follow bitbake cheat sheet

The output image is located in


NOTE: The resulting image is the default image of Trucrux.

For customization of OS follow the customization documentation

Linux Customization

Uboot Customization