QSMP-1351

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-bsp;cd karo-bsp
repo init -u https://github.com/karo-electronics/karo-bsp -b scarthgap
repo sync

7. Setup Build Directory

Refer to Setup Build Directory for details

KARO_BASEBOARD is optional. Possible values are: qsbase1, qsbase2, qsbase4, qsqlyn1

KARO_BASEBOARD=qsbase4
DISTRO=karo-minimal MACHINE=qsmp-1351 source karo-setup-release.sh -b build-qsmp-1351

8. Build

Refer to Build the Image for details

bitbake karo-image-minimal

9. Flash the module

Start fastboot from U-Boot manually.

fastboot usb 0

Only if the above is not possible

U-Boot in fastboot mode can also be started via USB from DFU mode

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

sudo apt install dfu-util
bash tmp/deploy/images/qsmp-1351/karo-image-${image}/start-fastboot.sh

Only for Linux on Windows with WSL

Refer to Linux on Windows with WSL -> Connect USB devices

Windows uuu.exe fails. Use WSL and attach the USB device to it.

Open a Windows command shell with administrator permissions. Get the {busid} of the download gadget and attach it.

usbipd list
usbipd bind --busid {busid}
usbipd attach --wsl --busid {busid}

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

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