arno
/
trezor-firmware
mirror of https://github.com/trezor/trezor-firmware.git
1
0
Fork 0
Code Issues Releases Wiki Activity
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.
959 Commits
319 Branches
191 Tags
242 MiB
 
 
 
 
 
 
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '67852dcaba'
${ noResults }
Go to file
Saleem Rashid 67852dcaba
script: Add toolchain-{download,run} 		6 years ago
bootloader docs: update changelogs 6 years ago
demo fix demo 6 years ago
emulator emulator: open a second socket for debuglink, same as T2 6 years ago
firmware Stellar: use strings instead of bytes for addresses (#372) 6 years ago
gen gen: update trezor logo 6 years ago
gitian add gitian build (work in progress) 8 years ago
script script: Add toolchain-{download,run} 6 years ago
vendor script: Add toolchain-{download,run} 6 years ago
.gitignore add vscode to .gitignore 6 years ago
.gitmodules vendor: remove python-trezor submodule for now 7 years ago
.travis.yml build: ciscript includes firmware sign 6 years ago
COPYING import v1.0.0 10 years ago
Dockerfile build: Refactor Docker build 6 years ago
Dockerfile.emulator Fix emulator build in docker 6 years ago
Makefile Supervisor Calls 6 years ago
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 update bootloader padding/alignment and integrate build process for bootloader and firmware 6 years ago
build-emulator.sh Fix emulator build in docker 6 years ago
build.sh build: Refactor Docker build 6 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 Cleaner flash handling using FLASH_PTR 6 years ago
memory.h fix emulator build 6 years ago
memory.ld Put persistent variables at end of stack 6 years ago
memory_app_0.0.0.ld import v1.0.0 10 years ago
memory_app_1.0.0.ld Put persistent variables at end of stack 6 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 memory: use 1M for flash storage 6 years ago
setup.h setup: Enable MPU 6 years ago
startup.s startup: shutdown at end instead of loop 6 years ago
supervise.c memory: use 1M for flash storage 6 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 Add USB 2.1 (WebUSB preparation) 6 years ago
usb21_standard.h Revert WinUSB feature 6 years ago
util.c util: use shutdown from trezor-core instead of system_halt 6 years ago
util.h Fixed compilation of emulator (#370) 6 years ago

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.