2017-03-20 14:49:11 +00:00
|
|
|
# TREZOR Core
|
|
|
|
|
|
2016-10-05 17:45:09 +00:00
|
|
|
|
2016-02-01 10:52:57 +00:00
|
|
|
|
2016-10-03 14:32:58 +00:00
|
|
|
[](https://travis-ci.org/trezor/trezor-core) [](https://gitter.im/trezor/community)
|
|
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
This is the core of the upcoming TREZOR v2.
|
2016-10-07 12:41:21 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
## Documentation
|
2016-10-10 10:32:38 +00:00
|
|
|
|
2016-02-01 16:25:52 +00:00
|
|
|
* [Documentation](docs/)
|
2016-04-30 22:30:16 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
## Build instructions for emulator
|
2016-04-30 22:30:16 +00:00
|
|
|
|
2017-06-06 14:55:12 +00:00
|
|
|
Run the following to checkout the project:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
git clone --recursive https://github.com/trezor/trezor-core.git
|
|
|
|
|
cd trezor-core
|
|
|
|
|
```
|
|
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
### Linux
|
2016-04-30 22:30:16 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
#### Debian/Ubuntu
|
2016-06-03 14:16:07 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
```sh
|
2016-10-03 18:20:59 +00:00
|
|
|
sudo dpkg --add-architecture i386
|
|
|
|
|
sudo apt-get update
|
2017-03-28 13:02:02 +00:00
|
|
|
sudo apt-get install libsdl2-dev:i386 libsdl2-image-dev:i386 gcc-multilib
|
2016-04-30 22:30:16 +00:00
|
|
|
make build_unix
|
|
|
|
|
```
|
|
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
#### Fedora
|
2016-06-03 14:16:07 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
```sh
|
2016-10-05 22:02:46 +00:00
|
|
|
sudo yum install SDL2-devel.i686 SDL2_image-devel.i686
|
2016-06-03 14:16:07 +00:00
|
|
|
make build_unix
|
|
|
|
|
```
|
|
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
#### openSUSE
|
2016-06-03 14:16:07 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
```sh
|
2016-10-05 22:02:46 +00:00
|
|
|
sudo zypper install libSDL2-devel-32bit libSDL2_image-devel-32bit
|
2016-06-03 14:16:07 +00:00
|
|
|
make build_unix
|
|
|
|
|
```
|
|
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
### OS X
|
2016-04-30 22:30:16 +00:00
|
|
|
|
2017-04-19 19:39:44 +00:00
|
|
|
Install SDL2 using DMG installer from [SDL download page](https://www.libsdl.org/download-2.0.php) or run the following if you use Homebrew:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
brew install sdl2 sdl2_image
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Build the emulator:
|
|
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
```sh
|
2016-06-03 14:16:07 +00:00
|
|
|
make build_unix
|
2016-04-30 22:30:16 +00:00
|
|
|
```
|
2016-06-03 14:16:07 +00:00
|
|
|
|
|
|
|
|
### Windows
|
|
|
|
|
|
|
|
|
|
Not supported yet ...
|
2016-09-29 10:37:52 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
## Build instructions for ARM
|
2016-09-29 10:37:52 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
### Linux
|
2016-09-29 10:37:52 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
For flashing firmware to blank device (without bootloader) by `make flash`,
|
|
|
|
|
please install [stlink](https://github.com/texane/stlink).
|
2016-09-29 11:35:24 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
#### Debian/Ubuntu
|
2016-09-29 10:37:52 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
```sh
|
2016-09-29 10:37:52 +00:00
|
|
|
sudo apt-get install gcc-arm-none-eabi libnewlib-arm-none-eabi
|
2017-03-13 12:20:40 +00:00
|
|
|
make build_trezorhal
|
2016-09-29 10:37:52 +00:00
|
|
|
```
|
2016-10-17 15:32:06 +00:00
|
|
|
|
2017-03-20 14:49:11 +00:00
|
|
|
### OS X
|
2016-10-17 15:32:06 +00:00
|
|
|
|
2016-11-08 17:35:01 +00:00
|
|
|
1. Download [gcc-arm-none-eabi](https://launchpad.net/gcc-arm-embedded/5.0/5-2016-q3-update/)
|
|
|
|
|
2. Follow the [install instructions](https://launchpadlibrarian.net/287100883/readme.txt)
|
|
|
|
|
3. To install stlink, run `brew install stlink`
|
