1
0
mirror of https://github.com/trezor/trezor-firmware.git synced 2024-12-23 06:48:16 +00:00
Go to file
Tomas Susanka 3185eb0fd4 build: ciscript includes firmware sign
so that emulator build uses pipenv to ensure stable environment for python-trezor
but fetching python-trezor and friends doesn't needlessly slow down non-emulator builds
that don't need it
2018-06-08 16:57:06 +02:00
bootloader update bootloader padding/alignment and integrate build process for bootloader and firmware 2018-04-10 14:19:27 +02:00
demo fix demo 2018-01-18 18:40:43 +01:00
emulator emulator: open a second socket for debuglink, same as T2 2018-04-04 16:21:43 +02:00
firmware firmware: refactor expiry into tx_init 2018-06-07 13:17:51 +02:00
gen gen: update trezor logo 2018-04-28 14:01:33 +01:00
gitian add gitian build (work in progress) 2016-01-19 21:15:39 +01:00
script build: ciscript includes firmware sign 2018-06-08 16:57:06 +02:00
vendor firmware: rename decred_expiry to expiry 2018-06-05 14:09:38 +02:00
.gitignore add vscode to .gitignore 2018-02-13 15:17:33 +01:00
.gitmodules vendor: remove python-trezor submodule for now 2017-12-18 21:38:31 +01:00
.travis.yml build: ciscript includes firmware sign 2018-06-08 16:57:06 +02:00
build-emulator.sh Fix emulator build in docker 2018-03-31 12:25:04 +02:00
build.sh update bootloader padding/alignment and integrate build process for bootloader and firmware 2018-04-10 14:19:27 +02:00
buttons.c emulator: Initial commit 2017-12-18 20:09:59 +01:00
buttons.h emulator: Initial commit 2017-12-18 20:09:59 +01:00
COPYING import v1.0.0 2014-04-29 14:38:32 +02:00
Dockerfile dockerfile: small typos to make them two Dockerfiles more similar 2018-02-19 01:03:40 +01:00
Dockerfile.emulator Fix emulator build in docker 2018-03-31 12:25:04 +02:00
layout.c Remove duplicated code 2018-02-20 18:22:47 +01:00
layout.h Remove duplicated code 2018-02-20 18:22:47 +01:00
Makefile Supervisor Calls 2018-03-29 01:30:40 +02:00
Makefile.include build: ciscript includes firmware sign 2018-06-08 16:57:06 +02:00
memory_app_0.0.0.ld import v1.0.0 2014-04-29 14:38:32 +02:00
memory_app_1.0.0.ld Put persistent variables at end of stack 2018-03-29 01:30:40 +02:00
memory_app_fastflash.ld firmware: rework protectChangePin 2017-12-12 12:51:08 +01:00
memory.c Cleaner flash handling using FLASH_PTR 2018-03-29 01:16:46 +02:00
memory.h fix emulator build 2018-05-23 15:46:38 +02:00
memory.ld Put persistent variables at end of stack 2018-03-29 01:30:40 +02:00
oled.c Added fixed-width font and multi-font support 2018-02-20 18:22:47 +01:00
oled.h Added fixed-width font and multi-font support 2018-02-20 18:22:47 +01:00
Pipfile travis: use pipenv to ensure stable environment for python tests 2018-05-11 14:49:22 +02:00
Pipfile.lock travis: use pipenv to ensure stable environment for python tests 2018-05-11 14:49:22 +02:00
README.md update bootloader padding/alignment and integrate build process for bootloader and firmware 2018-04-10 14:19:27 +02:00
rng.c update trezor-crypto, adapt firmware to to changes 2018-01-13 15:20:10 +01:00
rng.h update trezor-crypto, adapt firmware to to changes 2018-01-13 15:20:10 +01:00
serialno.c add project website (trezor.io) to license header 2017-11-05 17:47:23 +01:00
serialno.h add project website (trezor.io) to license header 2017-11-05 17:47:23 +01:00
setup.c memory: use 1M for flash storage 2018-04-16 14:12:47 +02:00
setup.h setup: Enable MPU 2018-02-13 15:48:42 +01:00
startup.s startup: shutdown at end instead of loop 2018-04-11 15:47:08 +02:00
supervise.c memory: use 1M for flash storage 2018-04-16 14:12:47 +02:00
supervise.h Fixes for emulator 2018-03-29 01:30:40 +02:00
timer.c Put persistent variables at end of stack 2018-03-29 01:30:40 +02:00
timer.h Supervisor Calls 2018-03-29 01:30:40 +02:00
usb21_standard.c Add USB 2.1 (WebUSB preparation) 2018-02-20 19:13:38 +01:00
usb21_standard.h Revert WinUSB feature 2018-03-14 00:37:08 +01:00
util.c util: use shutdown from trezor-core instead of system_halt 2018-03-21 12:18:36 +01:00
util.h Put persistent variables at end of stack 2018-03-29 01:30:40 +02:00

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.