Building OS for TRUX-IMX8MQ

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

Host system required  Minimum storage : 100GB

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 an 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 #

$ 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 #

Before downloading code setup its necessary to create a seperate folder for codesetup
change directory to desire location (home in this case) and run following commands

$ mkdir ~/CodeSetup_Trucrux
$ cd ~/CodeSetup_Trucrux

Now download codesetup in CodeSetup_Trucrux directory

$ repo init -u < copy link here provided in registered email > -b dunfell -m default.xml
$ repo sync -j$(nproc)

Setup and OS build #

Trucrux provides 1 images :

  • 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

Use this command for building code for first time to set MACHINE

$ cd ~/CodeSetup_Trucrux
$ MACHINE=imx8mq-trucrux DISTRO=fslc-xwayland . setup-environment build_trucrux

once the machine is set build code with following command

$ source setup-environment build_trucrux

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 default image of Trucrux.

For customization of OS follow customization documentation

Linux Customization

Uboot Customization