Flash Prerequisites

This section provides step-by-step instructions for preparing your development host for flashing the image to the device.

Note

The following instructions assume you are using Ubuntu 22.04 LTS.

For more information and custom setup check MediaTek IoT Yocto documentation.

Install Fastboot

Fastboot is used by Genio tools to flash the image.

It can be installed from apt repository.

sudo apt install android-tools-fastboot

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.

Install Serial Terminal Emulator

Install the preferred Serial Terminal Emulator tool. The following command installs the recommended terminal emulator minicom.

sudo apt install minicom

Install genio-tools

Install the genio-tools package using pip.

pip3 install -U genio-tools

Verify installation and development host setup by running:

genio-config

If everything was set up correctly genio-config should output the following summary:

fastboot: OK
udev rules: OK (md5: a3b2767b42ee01d7c62bf394400528ae)
Serial device write access: OK

Note

Updates may change the expected udev rules file content, so the MD5 hash might be different than above.

In case of any errors follow instructions provided by the tool or consult MediaTek IoT Yocto documentation.