Go to file

Pavol Rusnak e8a46d46c2 ethereum: update to new API		6 years ago
bootloader	docs: update changelogs	6 years ago
demo	…
emulator	…
firmware	ethereum: update to new API	6 years ago
gen	gen: update trezor logo	6 years ago
gitian	…
script	build: ciscript includes firmware sign	6 years ago
vendor	ethereum: update to new API	6 years ago
.gitignore	…
.gitmodules	…
.travis.yml	build: ciscript includes firmware sign	6 years ago
COPYING	…
Dockerfile	…
Dockerfile.emulator	…
Makefile	…
Makefile.include	build: ciscript includes firmware sign	6 years ago
Pipfile	travis: use pipenv to ensure stable environment for python tests	6 years ago
Pipfile.lock	travis: use pipenv to ensure stable environment for python tests	6 years ago
README.md	…
build-emulator.sh	…
build.sh	build: add more verbose output to build script	6 years ago
buttons.c	…
buttons.h	…
layout.c	…
layout.h	…
memory.c	…
memory.h	fix emulator build	6 years ago
memory.ld	…
memory_app_0.0.0.ld	…
memory_app_1.0.0.ld	…
memory_app_fastflash.ld	…
oled.c	…
oled.h	…
rng.c	…
rng.h	…
serialno.c	…
serialno.h	…
setup.c	memory: use 1M for flash storage	7 years ago
setup.h	…
startup.s	…
supervise.c	memory: use 1M for flash storage	7 years ago
supervise.h	…
timer.c	…
timer.h	…
usb21_standard.c	…
usb21_standard.h	…
util.c	…
util.h	Fixed compilation of emulator (#370 )	6 years ago

README.md

TREZOR One Bootloader and Firmware

https://trezor.io/

How to build the TREZOR bootloader and firmware?

Install Docker
git clone https://github.com/trezor/trezor-mcu.git
cd trezor-mcu
./build.sh BOOTLOADER_TAG FIRMWARE_TAG (where BOOTLOADER_TAG is bl1.5.0 and FIRMWARE_TAG is v1.7.0 for example, if left blank the script builds latest commit in master branch)

This creates the files build/bootloader-BOOTLOADER_TAG.bin and build/trezor-FIRMWARE_TAG.bin and prints their fingerprints and sizes at the end of the build log.

How to build TREZOR emulator for Linux?

Install Docker
git clone https://github.com/trezor/trezor-mcu.git
cd trezor-mcu
./build-emulator.sh TAG (where TAG is v1.5.0 for example, if left blank the script builds latest commit in master branch)

This creates binary file build/trezor-emulator-TAG, which can be run and works as a trezor emulator. (Use TREZOR_OLED_SCALE env. variable to make 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

Building for development

If you want to build device firmware, make sure you have the GNU ARM Embedded toolchain installed.

If you want to build the emulator instead of the firmware, run export EMULATOR=1 TREZOR_TRANSPORT_V1=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 build the firmware or emulator, 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 -t udp (for example, trezorctl -t udp get_features).

If trezorctl -t udp appears to hang, make sure you have run export TREZOR_TRANSPORT_V1=1.