TX8M-1610

Build and flash quick guide

This is a summary of the steps to create images with Yocto and then flash the module with it. Just copy&paste the commands. The whole process usually takes less than 10 minutes.

1. Check System requirements - Supported Linux Distributions

Refer to Yocto Scarthgap Reference Manual - System Requirements for details

Ubuntu 23.04	Ubuntu 22.04 (LTS)	Ubuntu 20.04 (LTS)	Debian GNU/Linux 12 (Bookworm)	Debian GNU/Linux 11 (Bullseye)	Debian 10
√	√	√	√	√	not supported

2. Host PC

Use either a Linux PC or Linux on Windows with WSL

3. Install required packages

Refer to Yocto Scarthgap Reference Manual - Required Packages for details

sudo apt update
sudo apt install build-essential chrpath cpio debianutils diffstat file gawk gcc git \
iputils-ping libacl1 liblz4-tool locales python3 python3-git python3-jinja2 python3-pexpect \
python3-pip python3-subunit socat texinfo unzip wget xz-utils zstd \
sudo locale-gen en_US.UTF-8
sudo apt install python-is-python3

4. Setup Git

Refer to BSP Setup for details

git config --global user.name "Your Name"
git config --global user.email "Your Email"

5. Setup Repo

Refer to BSP Setup for details

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

6. Setup BSP

Refer to BSP Setup for details

mkdir karo-nxp-bsp;cd karo-nxp-bsp
repo init -u https://github.com/karo-electronics/karo-nxp-bsp -b scarthgap
repo sync

7. Setup Build Directory

Refer to Setup Build Directory for details

KARO_BASEBOARD is optional. Possible values are: mipi-mb, mb7

KARO_BASEBOARD=mb7
DISTRO=karo-minimal MACHINE=tx8m-1610 source karo-setup-release.sh -b build-tx8m-1610

8. Enable sstate cache

Refer to Enable sstate cache for details

echo SSTATE_MIRRORS = \"file://.* http://sstate.karo-electronics.de/scarthgap/PATH\" >> conf/local.conf

9. Build

Refer to Build the Image for details

bitbake karo-image-minimal

10. Flash the module

Refer to Enabling USB-Bootmode and UUU - Universal Update Utility for details

Close the Bootmode Jumper (Bootmode: USB) - Reset the Board

Linux PC

cd tmp/deploy/images/tx8m-1610/karo-image-minimal
wget https://github.com/nxp-imx/mfgtools/releases/download/uuu_1.5.141/uuu
chmod a+x uuu
sudo ./uuu -v

Windows PC - Linux on Windows with WSL

Linux uuu fails with a USB device attached to WSL. Use Windows uuu.exe instead.

cp -r tmp/deploy/images/tx8m-1610/karo-image-minimal /mnt/c/
cd /mnt/c/karo-image-minimal
wget https://github.com/nxp-imx/mfgtools/releases/download/uuu_1.5.141/uuu.exe

Open a Windows cmd shell:

cd /d c:\karo-image-minimal
uuu -v

If programming fails, simply retry uuu without resetting the board.