docs: hardware: add photos, add more pin info, other related updates

docs/hardware.md

@@ -1,11 +1,35 @@
 # TREZOR Core Hardware
 
-## TREZOR v2 Open Source Hardware Reference Documentation
+## TREZOR Model T Open Source Hardware Reference Documentation
 
 ### Photo
 
 ![Photo Front](hardware/photo-front.jpg)
 
+### Photo of assembled board (top)
+
+![Assembled Board Top](hardware/model-t-top-v12.png)
+
+### Photo of assembled board (bottom)
+
+![Assembled Board Bottom](hardware/model-t-bottom-v12.png)
+
+### Photo of assembled TFT LCD display + capacitive touch panel module (top)
+
+![Display Module Top](hardware/model-t-display-module-top.png)
+
+### Photo of assembled TFT LCD display + capacitive touch panel module (bottom)
+
+![Display Module Bottom](hardware/model-t-display-module-bottom.png)
+
+### Photo of disassembled TFT LCD display + capacitive touch panel module (top) (CTPM on left) (TFT LCD broken glass removed)
+
+![Display Module Disassembled Top](hardware/model-t-display-module-disassembled-top.png)
+
+### Photo of disassembled TFT LCD display + capacitive touch panel module (bottom) (CTPM on left) (TFT LCD broken glass removed)
+
+![Display Module Disassembled Bottom](hardware/model-t-display-module-disassembled-bottom.png)
+
 ### Bill of Materials / BOM
 
 [BOM](hardware/bom.txt)
@@ -16,12 +40,12 @@
 
 ## Developer Kit
 
-* 1 x [STM32F429I-DISC1](http://www.st.com/en/evaluation-tools/32f429idiscovery.html)
+* 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](http://www.ebay.com/itm/302049581340) (Note: specify 40-Pin Header, 8080 8-bit Parallel, VDD=3.3V, Capacitive Touch Panel)
+* 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)
-* 28 x Female to female jumper wires with 0.1" header contacts
+* 1 x [Pack of 40 Female to female jumper wires with 0.1" header contacts](https://www.adafruit.com/product/266)
 
 #### Display
 
@@ -34,9 +58,9 @@
 
 |Description|MCU Pin|Notes|
 |-----------|-------|-----|
-|LCD_RST|PC14|display module pin 21|
+|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|
+|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|
@@ -49,6 +73,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
 
@@ -60,10 +85,11 @@
 
 |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|display module pin 39|
-|REST|PC5||
+|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
 
@@ -80,6 +106,7 @@
 |SDIO_CK|PC12|
 |SDIO_CMD|PD2|
 |SD_CARDDETECT|PC13|
+|SD_ON|PC0|
 
 #### USB Socket
 
@@ -87,12 +114,14 @@
 
 ##### Pinout
 
-|Description|MCU Pin|
-|-----------|-------|
-|OTG_HS_VBUS|PB13|
-|OTG_HS_ID|PB12|
-|OTG_HS_DM|PB14|
-|OTG_HS_DP|PB15|
+|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
 
@@ -100,6 +129,23 @@
 * 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](hardware/dev-board-top-before.png)
+
+### Photo of dev board before modifications (bottom)
+
+![Dev Board Bottom Before](hardware/dev-board-bottom-before.png)
+
 Minimum MCU requirements:
 
 * STM32F4 family [STM32F427VIT6](http://www.st.com/en/microcontrollers/stm32f427vi.html)