Skip to main content

Flash Prerequisites

This section provides step-by-step instructions for preparing your development host for flashing the image to the device. Follow the guide that matches your operating system.

note
The instructions below assume a Debian-based Linux distribution and were verified on Ubuntu 24.04 LTS.

Create udev Rules​

To enable USB device access for your user account, create new udev rules, reload the udev rules, and trigger them.

echo -n 'SUBSYSTEM=="usb", ATTR{idVendor}=="0e8d", ATTR{idProduct}=="201c", MODE="0660", TAG+="uaccess"
SUBSYSTEM=="usb", ATTR{idVendor}=="0e8d", ATTR{idProduct}=="0003", MODE="0660", TAG+="uaccess"
SUBSYSTEM=="usb", ATTR{idVendor}=="0403", MODE="0660", TAG+="uaccess"
SUBSYSTEM=="gpio", MODE="0660", TAG+="uaccess"
' | sudo tee /etc/udev/rules.d/72-aiot.rules
sudo udevadm control --reload-rules
sudo udevadm trigger

Enable UART Access​

Your user account must be in the dialout group to access UART devices.

Check your group memberships:

groups

If dialout is not listed, add your user to the group:

sudo usermod -a -G dialout $USER
note

You must log out and log back in for the new group membership to take effect.

Ensure System is Updated​

sudo apt update
sudo apt upgrade -y

Install fastboot​

Fastboot is used by Genio tools to flash the image.

Install it using the following command:

sudo apt install android-tools-fastboot

Install pipx​

pipx is a tool for installing and running Python applications in isolated environments.

Install pipx:

sudo apt install pipx

Ensure pipx installation path is added to your shell's PATH:

pipx ensurepath

Open a new terminal or re-login for the PATH changes to take effect.

Install genio-tools​

Install the genio-tools package:

pipx install genio-tools

Verify the installation and development host setup by running:

genio-config

Expected output:

fastboot: OK
udev rules: OK
Serial device write access: OK

If any checks fail, follow the tool guidance or consult the MediaTek IoT Yocto (Linux) documentation.