trezor-firmware/docs/hardware/model-t/index.md


# Trezor Model T Open Source Hardware Reference Documentation

## Photo

![Photo Front](photo-front.jpg)

## Photo of assembled board (top)

![Assembled Board Top](model-t-top-v12.jpg)

## Photo of assembled board (bottom)

![Assembled Board Bottom](model-t-bottom-v12.jpg)

## Photo of assembled TFT LCD display + capacitive touch panel module (top)

![Display Module Top](model-t-display-module-top.jpg)

## Photo of assembled TFT LCD display + capacitive touch panel module (bottom)

![Display Module Bottom](model-t-display-module-bottom.jpg)

## Photo of disassembled TFT LCD display + capacitive touch panel module (top) (CTPM on left) (TFT LCD broken glass removed)

![Display Module Disassembled Top](model-t-display-module-disassembled-top.jpg)

## Photo of disassembled TFT LCD display + capacitive touch panel module (bottom) (CTPM on left) (TFT LCD broken glass removed)

![Display Module Disassembled Bottom](model-t-display-module-disassembled-bottom.jpg)

## Bill of Materials / BOM

[BOM](bom.txt)

## Schematic

![Schematic](schematic.png)

## Developer Kit

* 1 x [STM32F429I-DISC1](https://www.st.com/en/evaluation-tools/32f429idiscovery.html) (note: [Manual with pin to dev board function mapping](https://www.st.com/content/ccc/resource/technical/document/user_manual/6b/25/05/23/a9/45/4d/6a/DM00093903.pdf/files/DM00093903.pdf/jcr:content/translations/en.DM00093903.pdf))
* 1 x USB Cable Type A Plug/Male to Type Mini-B Plug/Male
* 1 x USB Cable Type A Plug/Male to Type Micro-B Plug/Male
* 1 x [ER-TFTM028-4 Display + Capacitive Touch Panel Module](https://www.ebay.com/itm/302049581340) (Note: specify 40-Pin Header, 8080 8-bit Parallel, VDD=3.3V, Capacitive Touch Panel) (note: [Manual](https://www.buydisplay.com/download/manual/ER-TFTM028-4_Datasheet.pdf))
* 1 x [microSD Board](https://www.waveshare.com/product/modules/storage/sd-tf-storage/micro-sd-storage-board.htm)
* 1 x [Pack of 40 Female to female jumper wires with 0.1" header contacts](https://www.adafruit.com/product/266)

### Display

* Resolution: 240px x 240px -OR- 240px x 320px
* Driver IC: ST7789V, GC9307, or ILI9341V (on-chip display data RAM of 240x320x18 bits)
* 18-bit (262,144) RGB color graphic type TFT-LCD
* Bus/Interface: 8080-I 8-bit parallel with 16-bit/pixel (RGB 5-6-5)

#### Pinout

|Description|MCU Pin|Notes|
|-----------|-------|-----|
|LCD_RST|PC14|display module pin 21. benign conflict with unpopulated OSC32_IN on dev board.|
|LCD_FMARK|PD12|tearing effect input; display module pin 22|
|LCD_PWM|PA7|backlight control (brightness); display module pin 29. benign conflict with I2C_EXT_RST on dev board.|
|LCD_CS|PD7|display module pin 23|
|LCD_RS|PD11|register select aka command/data; display module pin 24|
|LCD_RD|PD4|display module pin 26|
|LCD_WR|PD5|display module pin 25|
|LCD_D0|PD14|display module pin 3|
|LCD_D1|PD15|display module pin 4|
|LCD_D2|PD0|display module pin 5|
|LCD_D3|PD1|display module pin 6|
|LCD_D4|PE7|display module pin 7|
|LCD_D5|PE8|display module pin 8|
|LCD_D6|PE9|display module pin 9|
|LCD_D7|PE10|display module pin 10|
|LCD_D8|PE11|not currently used|

### Capacitive Touch Panel / Sensor

* Bus/Interface: I2C
* Driver IC: FT6236 or FT6206
* single touch

#### Pinout

|Description|MCU Pin|Notes|
|-----------|-------|-----|
|TOUCH_ON|PB10|no mapped pin on display module|
|I2C1_SCL|PB6|display module pin 30|
|I2C1_SDA|PB7|display module pin 31|
|EINT|PC4|not currently used. display module pin 39. conflict with USB OTG FS PSO on dev board.|
|REST|PC5|benign conflict with USB OTG FS OC on dev board. no mapped pin on display module.|

### microSD Socket

* Bus/Interface: 4-bit

#### Pinout

|Description|MCU Pin|
|-----------|-------|
|SDIO_D0|PC8|
|SDIO_D1|PC9|
|SDIO_D2|PC10|
|SDIO_D3|PC11|
|SDIO_CK|PC12|
|SDIO_CMD|PD2|
|SD_CARDDETECT|PC13|
|SD_ON|PC0|

### USB Socket

* USB HS (high-speed) peripheral in FS (full-speed) mode

#### Pinout

|Description|MCU Pin|Notes|
|-----------|-------|-----|
|OTG_HS_VBUS|PB13||
|OTG_HS_ID|PB12||
|OTG_HS_DM|PB14||
|OTG_HS_DP|PB15||
|SBU1|PA2|not currently used. conflict with L3GD20 Gyroscope MEMS on dev board.|
|SBU2|PA3|not currently used|

### Dev Board

* [STM32F429ZIT6](https://www.st.com/en/microcontrollers-microprocessors/stm32f429zi.html)
* HSE / High-Speed External Crystal: 8 MHz
* Integrated STMicroelectronics ST-LINK/V2.1 debugger

Note: There are many conflicts between how the software maps GPIO pins and how the dev board maps them to its functions.
Many of the conflicts are resolved by removing the external SDRAM chip and the TFT LCD display + resistive touch panel that come attached to the dev board.
The unresolved conflicts are noted in the pinout descriptions above.
Currently, testing has shown that it is not necessary to remove either the SDRAM or the TFT LCD display + resistive touch panel.
If you choose to remove them, our experience is that the easiest way to remove the SDRAM chip is by first cutting the leads on one side of the chip (e.g.- with an X-Acto knife) and then lifting the chip and rocking it until the leads on the other side break. Be sure that no broken leads short to another pin as this can cause the dev board and/or display to malfunction. If some do, just clean them up so that they are separate again.
This method reduces the amount of knife work, and the chance for slicing other things on the board (or yourself).
To remove the TFT LCD display + resistive touch panel module, lift the module away from the metal tray, bend the metal tray out of the way, then cleanly pull/tear the flex PCB away from the solder connections to the main board (the connections usually break without much force).
The metal tray is attached to the board with double stick tape. You just have to pull that up.

## Photo of dev board before modifications (top)

![Dev Board Top Before](dev-board-top-before.jpg)

## Photo of dev board before modifications (bottom)

![Dev Board Bottom Before](dev-board-bottom-before.jpg)

Minimum MCU requirements:

* STM32F4 family [STM32F427VIT6](https://www.st.com/en/microcontrollers-microprocessors/stm32f427vi.html)
* 168 MHz, 8 MHz HSE
* 2048 KB Flash memory
* 192 KB SRAM
* 64 KB CCMRAM
* FMC controller
* TRNG

### Clock Tree

![Clock Tree](clock-tree.png)
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`# Trezor Model T Open Source Hardware Reference Documentation`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo`
rough draft 2017-08-29 13:20:29 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Photo Front](photo-front.jpg)`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of assembled board (top)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Assembled Board Top](model-t-top-v12.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of assembled board (bottom)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Assembled Board Bottom](model-t-bottom-v12.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of assembled TFT LCD display + capacitive touch panel module (top)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Display Module Top](model-t-display-module-top.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of assembled TFT LCD display + capacitive touch panel module (bottom)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Display Module Bottom](model-t-display-module-bottom.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of disassembled TFT LCD display + capacitive touch panel module (top) (CTPM on left) (TFT LCD broken glass removed)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Display Module Disassembled Top](model-t-display-module-disassembled-top.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of disassembled TFT LCD display + capacitive touch panel module (bottom) (CTPM on left) (TFT LCD broken glass removed)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Display Module Disassembled Bottom](model-t-display-module-disassembled-bottom.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Bill of Materials / BOM`
rough draft 2017-08-29 13:20:29 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`[BOM](bom.txt)`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Schematic`
docs: add photo, schematic, bom, etc. 2018-03-21 15:49:00 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Schematic](schematic.png)`
rough draft 2017-08-29 13:20:29 +00:00
			`## Developer Kit`

docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`* 1 x [STM32F429I-DISC1](https://www.st.com/en/evaluation-tools/32f429idiscovery.html) (note: [Manual with pin to dev board function mapping](https://www.st.com/content/ccc/resource/technical/document/user_manual/6b/25/05/23/a9/45/4d/6a/DM00093903.pdf/files/DM00093903.pdf/jcr:content/translations/en.DM00093903.pdf))`
rough draft 2017-08-29 13:20:29 +00:00			`* 1 x USB Cable Type A Plug/Male to Type Mini-B Plug/Male`
fix minor compile time bug and update docs 2017-09-05 20:21:53 +00:00			`* 1 x USB Cable Type A Plug/Male to Type Micro-B Plug/Male`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`* 1 x [ER-TFTM028-4 Display + Capacitive Touch Panel Module](https://www.ebay.com/itm/302049581340) (Note: specify 40-Pin Header, 8080 8-bit Parallel, VDD=3.3V, Capacitive Touch Panel) (note: [Manual](https://www.buydisplay.com/download/manual/ER-TFTM028-4_Datasheet.pdf))`
docs: hardware updates 2017-09-27 16:39:56 +00:00			`* 1 x [microSD Board](https://www.waveshare.com/product/modules/storage/sd-tf-storage/micro-sd-storage-board.htm)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`* 1 x [Pack of 40 Female to female jumper wires with 0.1" header contacts](https://www.adafruit.com/product/266)`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`### Display`
docs: hardware updates 2017-09-27 16:39:56 +00:00
rough draft 2017-08-29 13:20:29 +00:00			`* Resolution: 240px x 240px -OR- 240px x 320px`
docs: add GC9307 to hardware.md 2018-08-04 19:53:55 +00:00			`* Driver IC: ST7789V, GC9307, or ILI9341V (on-chip display data RAM of 240x320x18 bits)`
rough draft 2017-08-29 13:20:29 +00:00			`* 18-bit (262,144) RGB color graphic type TFT-LCD`
docs: pip to pip3 no cache, add some hardware details (#60) 2017-10-19 13:20:24 +00:00			`* Bus/Interface: 8080-I 8-bit parallel with 16-bit/pixel (RGB 5-6-5)`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`#### Pinout`
rough draft 2017-08-29 13:20:29 +00:00
fix minor compile time bug and update docs 2017-09-05 20:21:53 +00:00			`\|Description\|MCU Pin\|Notes\|`
			`\|-----------\|-------\|-----\|`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|LCD_RST\|PC14\|display module pin 21. benign conflict with unpopulated OSC32_IN on dev board.\|`
display: tearing effect cleanup 2017-10-15 02:15:34 +00:00			`\|LCD_FMARK\|PD12\|tearing effect input; display module pin 22\|`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|LCD_PWM\|PA7\|backlight control (brightness); display module pin 29. benign conflict with I2C_EXT_RST on dev board.\|`
docs: dev kit hardware updates related to mcu upgrade (#45) 2017-10-14 10:26:34 +00:00			`\|LCD_CS\|PD7\|display module pin 23\|`
			`\|LCD_RS\|PD11\|register select aka command/data; display module pin 24\|`
			`\|LCD_RD\|PD4\|display module pin 26\|`
			`\|LCD_WR\|PD5\|display module pin 25\|`
			`\|LCD_D0\|PD14\|display module pin 3\|`
			`\|LCD_D1\|PD15\|display module pin 4\|`
			`\|LCD_D2\|PD0\|display module pin 5\|`
			`\|LCD_D3\|PD1\|display module pin 6\|`
			`\|LCD_D4\|PE7\|display module pin 7\|`
			`\|LCD_D5\|PE8\|display module pin 8\|`
			`\|LCD_D6\|PE9\|display module pin 9\|`
			`\|LCD_D7\|PE10\|display module pin 10\|`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|LCD_D8\|PE11\|not currently used\|`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`### Capacitive Touch Panel / Sensor`
docs: hardware updates 2017-09-27 16:39:56 +00:00
rough draft 2017-08-29 13:20:29 +00:00			`* Bus/Interface: I2C`
docs: pip to pip3 no cache, add some hardware details (#60) 2017-10-19 13:20:24 +00:00			`* Driver IC: FT6236 or FT6206`
rough draft 2017-08-29 13:20:29 +00:00			`* single touch`

docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`#### Pinout`
rough draft 2017-08-29 13:20:29 +00:00
docs: dev kit hardware updates related to mcu upgrade (#45) 2017-10-14 10:26:34 +00:00			`\|Description\|MCU Pin\|Notes\|`
			`\|-----------\|-------\|-----\|`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|TOUCH_ON\|PB10\|no mapped pin on display module\|`
docs: dev kit hardware updates related to mcu upgrade (#45) 2017-10-14 10:26:34 +00:00			`\|I2C1_SCL\|PB6\|display module pin 30\|`
			`\|I2C1_SDA\|PB7\|display module pin 31\|`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|EINT\|PC4\|not currently used. display module pin 39. conflict with USB OTG FS PSO on dev board.\|`
			`\|REST\|PC5\|benign conflict with USB OTG FS OC on dev board. no mapped pin on display module.\|`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`### microSD Socket`
docs: hardware updates 2017-09-27 16:39:56 +00:00
rough draft 2017-08-29 13:20:29 +00:00			`* Bus/Interface: 4-bit`

docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`#### Pinout`
rough draft 2017-08-29 13:20:29 +00:00
			`\|Description\|MCU Pin\|`
			`\|-----------\|-------\|`
			`\|SDIO_D0\|PC8\|`
			`\|SDIO_D1\|PC9\|`
			`\|SDIO_D2\|PC10\|`
			`\|SDIO_D3\|PC11\|`
			`\|SDIO_CK\|PC12\|`
			`\|SDIO_CMD\|PD2\|`
			`\|SD_CARDDETECT\|PC13\|`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|SD_ON\|PC0\|`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`### USB Socket`
rough draft 2017-08-29 13:20:29 +00:00
docs: dev kit hardware updates mainly usb (#37) 2017-10-11 10:50:10 +00:00			`* USB HS (high-speed) peripheral in FS (full-speed) mode`
docs: hardware updates 2017-09-27 16:39:56 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`#### Pinout`
rough draft 2017-08-29 13:20:29 +00:00
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`\|Description\|MCU Pin\|Notes\|`
			`\|-----------\|-------\|-----\|`
			`\|OTG_HS_VBUS\|PB13\|\|`
			`\|OTG_HS_ID\|PB12\|\|`
			`\|OTG_HS_DM\|PB14\|\|`
			`\|OTG_HS_DP\|PB15\|\|`
			`\|SBU1\|PA2\|not currently used. conflict with L3GD20 Gyroscope MEMS on dev board.\|`
			`\|SBU2\|PA3\|not currently used\|`
rough draft 2017-08-29 13:20:29 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`### Dev Board`
docs: hardware updates 2017-09-27 16:39:56 +00:00
docs: switch http to https in links (#419) 2019-08-16 15:28:15 +00:00			`* [STM32F429ZIT6](https://www.st.com/en/microcontrollers-microprocessors/stm32f429zi.html)`
rough draft 2017-08-29 13:20:29 +00:00			`* HSE / High-Speed External Crystal: 8 MHz`
fix minor compile time bug and update docs 2017-09-05 20:21:53 +00:00			`* Integrated STMicroelectronics ST-LINK/V2.1 debugger`
rough draft 2017-08-29 13:20:29 +00:00
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00			`Note: There are many conflicts between how the software maps GPIO pins and how the dev board maps them to its functions.`
			`Many of the conflicts are resolved by removing the external SDRAM chip and the TFT LCD display + resistive touch panel that come attached to the dev board.`
			`The unresolved conflicts are noted in the pinout descriptions above.`
			`Currently, testing has shown that it is not necessary to remove either the SDRAM or the TFT LCD display + resistive touch panel.`
			`If you choose to remove them, our experience is that the easiest way to remove the SDRAM chip is by first cutting the leads on one side of the chip (e.g.- with an X-Acto knife) and then lifting the chip and rocking it until the leads on the other side break. Be sure that no broken leads short to another pin as this can cause the dev board and/or display to malfunction. If some do, just clean them up so that they are separate again.`
			`This method reduces the amount of knife work, and the chance for slicing other things on the board (or yourself).`
			`To remove the TFT LCD display + resistive touch panel module, lift the module away from the metal tray, bend the metal tray out of the way, then cleanly pull/tear the flex PCB away from the solder connections to the main board (the connections usually break without much force).`
			`The metal tray is attached to the board with double stick tape. You just have to pull that up.`

docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of dev board before modifications (top)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Dev Board Top Before](dev-board-top-before.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`## Photo of dev board before modifications (bottom)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Dev Board Bottom Before](dev-board-bottom-before.jpg)`
docs: hardware: add photos, add more pin info, other related updates 2018-07-14 10:35:48 +00:00
docs: hardware updates 2017-09-27 16:39:56 +00:00			`Minimum MCU requirements:`
docs: fix markdown issues 2018-06-05 21:42:26 +00:00
docs: switch http to https in links (#419) 2019-08-16 15:28:15 +00:00			`* STM32F4 family [STM32F427VIT6](https://www.st.com/en/microcontrollers-microprocessors/stm32f427vi.html)`
docs: hardware updates 2017-09-27 16:39:56 +00:00			`* 168 MHz, 8 MHz HSE`
docs: dev kit hardware updates related to mcu upgrade (#45) 2017-10-14 10:26:34 +00:00			`* 2048 KB Flash memory`
			`* 192 KB SRAM`
docs: hardware updates 2017-09-27 16:39:56 +00:00			`* 64 KB CCMRAM`
docs: pip to pip3 no cache, add some hardware details (#60) 2017-10-19 13:20:24 +00:00			`* FMC controller`
docs: hardware updates 2017-09-27 16:39:56 +00:00			`* TRNG`

docs: restructure, add SUMMARY, add a few things 2019-08-02 13:58:12 +00:00			`### Clock Tree`
docs: dev kit hardware updates related to mcu upgrade (#45) 2017-10-14 10:26:34 +00:00
docs(hardware): drop assets folder [skip_ci] 2021-02-12 10:00:10 +00:00			`![Clock Tree](clock-tree.png)`