Go to file

Pavol Rusnak 9588e8f273 update bootloader to 1.4.0 via firmware, run unsigned firmware in unprivileged mode		6 years ago
bootloader	update bootloader to 1.4.0 via firmware, run unsigned firmware in unprivileged mode	6 years ago
demo	fix demo	6 years ago
emulator	emulator: Add TREZOR_OLED_SCALE variable	6 years ago
fastflash	fix fastflash	6 years ago
firmware	update bootloader to 1.4.0 via firmware, run unsigned firmware in unprivileged mode	6 years ago
gen	Distinguish 1 and l better.	6 years ago
gitian	add gitian build (work in progress)	8 years ago
script	script: Refactor test	7 years ago
vendor	session: rework get_state	6 years ago
.gitignore	add vscode to .gitignore	6 years ago
.gitmodules	vendor: remove python-trezor submodule for now	7 years ago
.travis.yml	tests: use marker, not function name	7 years ago
COPYING	import v1.0.0	10 years ago
Dockerfile	dockerfile: small typos to make them two Dockerfiles more similar	6 years ago
Dockerfile.emulator	emulator: Removing useless build and install	6 years ago
Makefile	Revert WinUSB feature	6 years ago
Makefile.include	emulator: use SDL2 directly	6 years ago
README.md	emulator: Add instructions	6 years ago
build-bootloader.sh	cleanup build, update libopencm3 (#215 )	7 years ago
build-emulator.sh	emulator: Removing useless build and install	6 years ago
build-firmware.sh	Generate the protobuf files at build time (#219 )	7 years ago
buttons.c	emulator: Initial commit	7 years ago
buttons.h	emulator: Initial commit	7 years ago
layout.c	Remove duplicated code	6 years ago
layout.h	Remove duplicated code	6 years ago
memory.c	update bootloader to 1.4.0 via firmware, run unsigned firmware in unprivileged mode	6 years ago
memory.h	update bootloader to 1.4.0 via firmware, run unsigned firmware in unprivileged mode	6 years ago
memory.ld	firmware: rework protectChangePin	7 years ago
memory_app_0.0.0.ld	import v1.0.0	10 years ago
memory_app_1.0.0.ld	firmware: rework protectChangePin	7 years ago
memory_app_fastflash.ld	firmware: rework protectChangePin	7 years ago
oled.c	Added fixed-width font and multi-font support	6 years ago
oled.h	Added fixed-width font and multi-font support	6 years ago
rng.c	update trezor-crypto, adapt firmware to to changes	6 years ago
rng.h	update trezor-crypto, adapt firmware to to changes	6 years ago
serialno.c	add project website (trezor.io) to license header	7 years ago
serialno.h	add project website (trezor.io) to license header	7 years ago
setup.c	setup: Switch to unprivileged execution	6 years ago
setup.h	setup: Enable MPU	6 years ago
startup.s	startup: use custom reset_handler	7 years ago
timer.c	emulator: Initial commit	7 years ago
timer.h	emulator: Initial commit	7 years ago
usb21_standard.c	Add USB 2.1 (WebUSB preparation)	6 years ago
usb21_standard.h	Revert WinUSB feature	6 years ago
util.c	emulator: Initial commit	7 years ago
util.h	update bootloader to 1.4.0 via firmware, run unsigned firmware in unprivileged mode	6 years ago

README.md

TREZOR Firmware

https://trezor.io/

How to build TREZOR firmware?

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

This creates file build/trezor-TAG.bin and prints its fingerprint and size 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 build TREZOR bootloader?

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

This creates file build/bootloader-TAG.bin and prints its fingerprint and size at the end of the build log.

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

Pick version of firmware binary listed on https://wallet.trezor.io/data/firmware/releases.json
Download it: wget -O trezor.signed.bin https://wallet.trezor.io/data/firmware/trezor-1.3.6.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.