Build instructions for Embedded (ARM port)

Complete the setup (nix-shell + uv) described in index.md before proceeding.

Working with Developer Tools

If you need embedded development tools such as OpenOCD, gcc-arm-embedded, or gdb, run nix-shell with:

nix-shell --arg devTools true

Rust

Install the appropriate target with rustup:

rustup target add thumbv8m.main-none-eabihf # for T3xx
rustup target add thumbv7em-none-eabihf  # for T2xx
rustup target add thumbv7m-none-eabi     # for T1

Building

Most xtask commands require specifying the model via the --model or -m option. You can select one of the following models:

t2t1 - Model T
t3b1 - Trezor Safe 3
t3t1 - Trezor Safe 5
t3w1 - Trezor Safe 7
d001 - STM32F429I-DISC1 Discovery Kit
d002 - STM32U5G9J-DK Discovery Kit

xtask build boardloader -m t3t1
xtask build bootloader -m t3t1
xtask build firmware -m t3t1

Uploading

Use xtask upload firmware --m t3t1 to upload the firmware to a production device.

For TT: Do not forget to enter bootloader on the device beforehand.
For TS3: You will have to unlock bootloader first. Make sure to read the link in completeness for potentially unwanted effects.

Flashing

For flashing firmware to blank device (without bootloader) use xtask flash firmware -m t3t1. You need to have OpenOCD installed.

Building in debug mode

You can also build firmware in debug mode to see log output or run tests.

xtask build firmware -m t3t1 --pyopt=false

To get a full debug build, use:

xtask build firmware -m t3t1 --pyopt=false --btc-only --debug  !@#

Use screen to enter the device’s console. Do not forget to add your user to the dialout group or use sudo. Note that both the group and the tty name can differ, use ls -l /dev/tty* or ls /dev/tty* | grep usb to find out proper names on your machine.

screen /dev/ttyACM0

Keyboard shortcuts