History

matejcik eaf1e940a8 build: update test runners for new paths		5 years ago
..
bootloader	core+legacy: add new changelog entries	5 years ago
demo	all: rename TREZOR to Trezor where possible	5 years ago
emulator	all: rename TREZOR to Trezor where possible	5 years ago
firmware	core+legacy: fix KMD signing (introduce negative_fee coin field)	5 years ago
gen	legacy: don't add more pixels than needed in oledSCA	5 years ago
gitian	MONOREPO MERGE trezor-mcu	5 years ago
script	build: update test runners for new paths	5 years ago
vendor	move vendored submodules to root vendor/ dir	5 years ago
.dockerignore	MONOREPO MERGE trezor-mcu	5 years ago
.gitignore	toplevel: reorganize .gitignore files	5 years ago
CONTRIBUTING.md	MONOREPO MERGE trezor-mcu	5 years ago
COPYING	MONOREPO MERGE trezor-mcu	5 years ago
Makefile	MONOREPO MERGE trezor-mcu	5 years ago
Makefile.include	core+legacy: drop NOUI and HEADLESS, SDL_VIDEODRIVER works fine	5 years ago
README.md	legacy/docs: add additional info required to flash custom firmware	5 years ago
build.sh	ci: split gitlab configuration files and store them in a 'ci' folder	5 years ago
buttons.c	all: rename TREZOR to Trezor where possible	5 years ago
buttons.h	all: rename TREZOR to Trezor where possible	5 years ago
common.c	all: rename TREZOR to Trezor where possible	5 years ago
common.h	all: rename TREZOR to Trezor where possible	5 years ago
flash.c	all: rename TREZOR to Trezor where possible	5 years ago
flash.h	all: rename TREZOR to Trezor where possible	5 years ago
layout.c	all: rename TREZOR to Trezor where possible	5 years ago
layout.h	all: rename TREZOR to Trezor where possible	5 years ago
memory.c	all: rename TREZOR to Trezor where possible	5 years ago
memory.h	all: rename TREZOR to Trezor where possible	5 years ago
memory.ld	MONOREPO MERGE trezor-mcu	5 years ago
memory_app_0.0.0.ld	MONOREPO MERGE trezor-mcu	5 years ago
memory_app_1.0.0.ld	MONOREPO MERGE trezor-mcu	5 years ago
memory_app_1.8.0.ld	MONOREPO MERGE trezor-mcu	5 years ago
memory_app_fastflash.ld	MONOREPO MERGE trezor-mcu	5 years ago
norcow_config.h	all: rename TREZOR to Trezor where possible	5 years ago
oled.c	legacy: don't add more pixels than needed in oledSCA	5 years ago
oled.h	legacy: fix SCA when displaying the words	5 years ago
rng.c	all: rename TREZOR to Trezor where possible	5 years ago
rng.h	all: rename TREZOR to Trezor where possible	5 years ago
secbool.h	all: rename TREZOR to Trezor where possible	5 years ago
setup.c	all: rename TREZOR to Trezor where possible	5 years ago
setup.h	all: rename TREZOR to Trezor where possible	5 years ago
startup.s	MONOREPO MERGE trezor-mcu	5 years ago
supervise.c	all: rename TREZOR to Trezor where possible	5 years ago
supervise.h	all: rename TREZOR to Trezor where possible	5 years ago
timer.c	all: rename TREZOR to Trezor where possible	5 years ago
timer.h	all: rename TREZOR to Trezor where possible	5 years ago
usb21_standard.c	legacy: Move wait_random() to common.c and use HMAC DRBG to generate delays.	5 years ago
usb21_standard.h	MONOREPO MERGE trezor-mcu	5 years ago
usb_private.h	MONOREPO MERGE trezor-mcu	5 years ago
usb_standard.c	legacy: Move wait_random() to common.c and use HMAC DRBG to generate delays.	5 years ago
util.c	all: rename TREZOR to Trezor where possible	5 years ago
util.h	all: rename TREZOR to Trezor where possible	5 years ago
webusb.c	legacy: Move wait_random() to common.c and use HMAC DRBG to generate delays.	5 years ago
webusb.h	core+legacy: reintroduce USB 2.1 landing page for firmware	5 years ago
webusb_defs.h	MONOREPO MERGE trezor-mcu	5 years ago
winusb.c	legacy: Move wait_random() to common.c and use HMAC DRBG to generate delays.	5 years ago
winusb.h	MONOREPO MERGE trezor-mcu	5 years ago
winusb_defs.h	MONOREPO MERGE trezor-mcu	5 years ago

README.md

Trezor One Bootloader and Firmware

https://trezor.io/

How to build the Trezor bootloader, firmware and emulator

Ensure that you have Docker installed. You can follow Docker's installation instructions.

Clone this repository:

git clone https://github.com/trezor/trezor-mcu.git`
cd trezor-mcu

Use the build.sh command to build the images.

to build bootloader 1.6.0 and firmware 1.7.0:
```
./build.sh bl1.6.0 v1.7.0
```
to build latest firmware from master:
```
./build.sh
```
to build the emulator from master:
```
./build.sh EMU
```
to build the emulator for version 1.7.0:
```
./build.sh EMU v1.7.0
```

Build results are stored in the build/ directory. File bootloader-<tag>.bin represents the bootloader, trezor-<tag>.bin is the firmware image, and trezor-emulator-<tag>.elf is the emulator executable.

You can use TREZOR_OLED_SCALE environment variable to make emulator screen bigger.

How to get fingerprint of firmware signed and distributed by SatoshiLabs?

Pick version of firmware binary listed on https://wallet.trezor.io/data/firmware/1/releases.json
Download it: wget -O trezor.signed.bin https://wallet.trezor.io/data/firmware/1/trezor-1.6.1.bin
Compute fingerprint: tail -c +257 trezor.signed.bin | sha256sum

Step 3 should produce the same sha256 fingerprint like your local build (for the same version tag). Firmware has a special header (of length 256 bytes) holding signatures themselves, which must be avoided while calculating the fingerprint, that's why tail command has to be used.

How to install custom built firmware?

WARNING: This will erase the recovery seed stored on the device! You should never do this on Trezor that contains coins!

Install python-trezor: pip install trezor (more info)
trezorctl firmware_update -f build/trezor-TAG.bin

Note: if your device is on the latest bootloader version and you flash custom firmware then you will receive a hard fault warning when booting the firmware image. To avoid this issue, just remove the code in startup.s added by this commit.

Building for development

If you want to build device firmware, make sure you have the GNU ARM Embedded toolchain installed. You will also need Python 3.5 or later and pipenv.

If you want to build the emulator instead of the firmware, run export EMULATOR=1
If you want to build with the debug link, run export DEBUG_LINK=1. Use this if you want to run the device tests.
When you change these variables, use script/setup to clean the repository

To initialize the repository, run script/setup
To initialize a Python environment, run pipenv install
To build the firmware or emulator, run pipenv run script/cibuild

If you are building device firmware, the firmware will be in firmware/trezor.bin.

You can launch the emulator using firmware/trezor.elf. To use trezorctl with the emulator, use trezorctl -p udp (for example, trezorctl -p udp get_features).