C Python C++ Shell Makefile Perl Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bootloader docs: update changelogs Jun 23, 2018
demo fix demo Jan 18, 2018
emulator Added fullscreen mode for emulator. Setting the environment variable … Aug 15, 2018
firmware eth: Add Pirl support (#400) Aug 15, 2018
gen gen: update trezor logo Apr 28, 2018
gitian add gitian build (work in progress) Jan 19, 2016
script build: drop the sleep that is now superseded by waiting script Aug 14, 2018
vendor vendor: update trezor-common; reflect rename of common.proto to messa… Jul 16, 2018
.gitignore add vscode to .gitignore Feb 13, 2018
.gitmodules vendor: remove python-trezor submodule for now Dec 18, 2017
.travis.yml build: ciscript includes firmware sign Jun 8, 2018
COPYING import v1.0.0 Apr 29, 2014
Dockerfile build: Refactor Docker build Jun 27, 2018
Dockerfile.emulator Fix emulator build in docker Mar 31, 2018
Makefile build: added --recursive to git clone in Makefile and script/bootstrap Jul 16, 2018
Makefile.include use pkg-config to find sdl2 installation correctly. (#391) Aug 15, 2018
Pipfile travis: add protobuf to pipfile, to enable building new python-trezor Jul 10, 2018
Pipfile.lock travis: add protobuf to pipfile, to enable building new python-trezor Jul 10, 2018
README.md update bootloader padding/alignment and integrate build process for b… Apr 10, 2018
build-emulator.sh Fix emulator build in docker Mar 31, 2018
build.sh build: Refactor Docker build Jun 27, 2018
buttons.c emulator: Initial commit Dec 18, 2017
buttons.h emulator: Initial commit Dec 18, 2017
layout.c Remove duplicated code Feb 20, 2018
layout.h Remove duplicated code Feb 20, 2018
memory.c Cleaner flash handling using FLASH_PTR Mar 28, 2018
memory.h fix emulator build May 23, 2018
memory.ld firmware: use full 1M flash Jun 27, 2018
memory_app_0.0.0.ld firmware: use full 1M flash Jun 27, 2018
memory_app_1.0.0.ld firmware: use full 1M flash Jun 27, 2018
memory_app_fastflash.ld firmware: use full 1M flash Jun 27, 2018
oled.c Added fixed-width font and multi-font support Feb 20, 2018
oled.h Added fixed-width font and multi-font support Feb 20, 2018
rng.c update trezor-crypto, adapt firmware to to changes Jan 13, 2018
rng.h update trezor-crypto, adapt firmware to to changes Jan 13, 2018
serialno.c add project website (trezor.io) to license header Nov 5, 2017
serialno.h add project website (trezor.io) to license header Nov 5, 2017
setup.c memory: use 1M for flash storage Apr 16, 2018
setup.h setup: Enable MPU Feb 13, 2018
startup.s startup: shutdown at end instead of loop Apr 11, 2018
supervise.c memory: use 1M for flash storage Apr 16, 2018
supervise.h Fixes for emulator Mar 28, 2018
timer.c Put persistent variables at end of stack Mar 28, 2018
timer.h Supervisor Calls Mar 28, 2018
usb21_standard.c Add USB 2.1 (WebUSB preparation) Feb 20, 2018
usb21_standard.h Revert WinUSB feature Mar 13, 2018
util.c util: use shutdown from trezor-core instead of system_halt Mar 21, 2018
util.h Fixed compilation of emulator (#370) Jun 21, 2018

README.md

TREZOR One Bootloader and Firmware

Build Status gitter

https://trezor.io/

How to build the TREZOR bootloader and firmware?

  1. Install Docker
  2. git clone https://github.com/trezor/trezor-mcu.git
  3. cd trezor-mcu
  4. ./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?

  1. Install Docker
  2. git clone https://github.com/trezor/trezor-mcu.git
  3. cd trezor-mcu
  4. ./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?

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

  1. Install python-trezor: pip install trezor (more info)
  2. 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
  1. To initialize the repository, run script/setup
  2. 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.