You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Pavol Rusnak 964a622bb5
bootloader: fix typo
5 years ago
bootloader bootloader: fix typo 5 years ago
demo demo: fix crypto call 6 years ago
emulator introduce new memory layout 5 years ago
firmware bootloader: fix typo 5 years ago
gen gen: update trezor logo 6 years ago
gitian add gitian build (work in progress) 9 years ago
script build: don't try to sign emulator build 5 years ago
vendor config: Auto-unlock storage if no PIN is set. Update trezor-storage with improved ui_callback() reporting. 5 years ago
.dockerignore add .dockerignore 6 years ago
.gitignore add vscode to .gitignore 6 years ago
.gitmodules vendor: add ignore=untracked to QR code generator submodule 5 years ago
.travis.yml update Dockerfile and .travis.yml to be more similar to trezor-core 5 years ago
CONTRIBUTING.md docs: contributing file 5 years ago
COPYING import v1.0.0 10 years ago
Dockerfile update Dockerfile and .travis.yml to be more similar to trezor-core 5 years ago
Makefile bootloader: enable MPU, introduce delays to USB stack 5 years ago
Makefile.include introduce new memory layout 5 years ago
Pipfile travis: move everything into pipenv, update to python 3.6 6 years ago
Pipfile.lock travis: move everything into pipenv, update to python 3.6 6 years ago
README.md readme: update Python instructions (fixes #426) 6 years ago
build.sh docker: update build scripts and instructions to fix Docker emulator (#419) 6 years ago
buttons.c bootloader: require only left button to start the bootloader 5 years ago
buttons.h emulator: Initial commit 7 years ago
common.c use shutdown from startup.s 5 years ago
common.h firmware: use OTP block 3 for storing randomness 5 years ago
flash.c Fix spaces/tabs so that a single convention is used in each file. 5 years ago
flash.h Fix emulator memory access. 5 years ago
layout.c bootloader: small changes to ui, replace vendor string 5 years ago
layout.h Remove duplicated code 6 years ago
memory.c introduce new memory layout 5 years ago
memory.h introduce new memory layout 5 years ago
memory.ld adjust message sizes 6 years ago
memory_app_0.0.0.ld firmware: use full 1M flash 6 years ago
memory_app_1.0.0.ld adjust message sizes 6 years ago
memory_app_1.8.0.ld setup: change mpu definition for bootloader, fix typo 5 years ago
memory_app_fastflash.ld adjust message sizes 6 years ago
norcow_config.h firmware: set NORCOW_HEADER_LEN to 0 5 years ago
oled.c bootloader: small changes to ui, replace vendor string 5 years ago
oled.h bootloader: small changes to ui, replace vendor string 5 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
secbool.h firmware: integrate trezor-storage 5 years ago
setup.c setup: change mpu definition for bootloader, fix typo 5 years ago
setup.h bootloader: enable MPU, introduce delays to USB stack 5 years ago
shell.nix nix: use python3, not python36 5 years ago
startup.s bootloader: compatibility with old bootloaders 5 years ago
supervise.c introduce new memory layout 5 years ago
supervise.h Fixes for emulator 6 years ago
timer.c Put persistent variables at end of stack 6 years ago
timer.h Supervisor Calls 6 years ago
usb21_standard.c bootloader: enable MPU, introduce delays to USB stack 5 years ago
usb21_standard.h re-enable WebUSB 6 years ago
usb_private.h bootloader: enable MPU, introduce delays to USB stack 5 years ago
usb_standard.c bootloader: enable MPU, introduce delays to USB stack 5 years ago
util.c bootloader: enable MPU, introduce delays to USB stack 5 years ago
util.h bootloader: move timer_init to jump_to_firmware 5 years ago
webusb.c bootloader: enable MPU, introduce delays to USB stack 5 years ago
webusb.h firmware: don't use WebUSB landing page for firmware, it's annoying 6 years ago
webusb_defs.h re-enable WebUSB 6 years ago
winusb.c bootloader: enable MPU, introduce delays to USB stack 5 years ago
winusb.h re-enable WebUSB 6 years ago
winusb_defs.h re-enable WebUSB 6 years ago

README.md

TREZOR One Bootloader and Firmware

Build Status gitter

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?

  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. 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 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 initialize a Python environment, run pipenv install
  3. 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).