Merge branch 'add-chestnut-hardware-info' into 'master'

Add a basic hardware page for Chestnut

Closes #150

See merge request Librem5/developer.puri.sm!369

Hardware_Reference.rst

@@ -12,5 +12,6 @@ This chapter contains a description of the hardware included with the Librem 5 d
 
    Hardware_Reference/devkit
    Hardware_Reference/Birch
+   Hardware_Reference/Chestnut
 
 .. include:: /links.txt

Hardware_Reference/Birch.rst

@@ -85,14 +85,6 @@ Hardware Kill Switches
 
 .. _hardware_ref_birch_headers:
 
-Headers
-~~~~~~~
-
- * JTAG header (unpopulated)
- * UART debug (UART1 interface, unpopulated):
-
-.. _`hardware_ref_birch_push_buttons`:
-
 LEDs
 ~~~~
 

Hardware_Reference/Chestnut.rst

+.. _hardware_reference_chestnut:
+
+Librem 5 Phone -- Chestnut
+==========================
+
+The sections on this page contain information about the Chestnut revision of the Librem 5 phone.
+
+.. contents::
+   :local:
+
+Improvements over Birch
+-----------------------
+
+Phones in the Chestnut shipment have these improvements over those in the Birch shipment:
+
+ * The red LED always indicates the charging state, regardless of whether or not the PMIC is powered. (It can illuminate when the phone is “off”.)
+ * Fixed an issue where the TPS65982 was not entering its APP mode when VBUS was presented before the PMIC's BUCK6 VDD_3V3 rail. This means that rapid charging occurs regardless of whether the TPS65982 is first powered via USB or via the battery -- rapid charging always works.
+ * The microSD card is now read-write.
+ * The USB 2.0 D+/D- is now routed directly to the USB-C receptacle so it does not rely on the TPS65982 entering its APP mode to use the data interface. This prevents an extremely unlikely but potential brick situation, which could only really be achieved on a Birch unit if done deliberately.
+ * Improved the WWAN kill switch inrush current such that using a PLS8 M.2 module would not cause the device to reset if you flip the switch off and back on.
+
+Quick Start Guide
+-----------------
+
+The version of the Quick Start Guide included with the phone can be downloaded: :download:`Librem5-Quick-Start-1.1.0.pdf <_files/Librem5-Quick-Start-1.1.0.pdf>`
+
+Components
+----------
+
+System on Chip and Peripherals
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+  * `Customer grade i.MX 8M Quad <https://www.nxp.com/products/processors-and-microcontrollers/arm-based-processors-and-mcus/i.mx-applications-processors/i.mx-8-processors/i.mx-8m-family-armcortex-a53-cortex-m4-audio-voice-video:i.MX8M>`_ [`datasheet <https://www.nxp.com/docs/en/data-sheet/IMX8MDQLQIEC.pdf>`_]
+    and [`reference manual <https://www.nxp.com/webapp/Download?colCode=IMX8MDQLQRM>`_]
+
+    * Four ARM Cortex-A53 cores.
+    * One Cortex-M4.
+    * Vivante GC7000Lite graphics
+    * 1 ⨉ Gigabit Ethernet
+
+  * 32 GB eMMC
+  * 3GB RAM
+  * SPI NOR Flash
+  * Real Time Clock (RTC)
+
+.. _`hardware_ref_chestnut_audio`:
+
+Audio
+~~~~~
+
+  * Wolfson Media WM8962
+  * Headphones and external microphone via CTIA-configured 3.5mm jack
+  * Loudspeaker
+
+Battery
+~~~~~~~
+
+  * `Texas Instruments BQ25895 <http://www.ti.com/product/BQ25895>`_ battery charge controller [`datasheet <BQ25895_>`_]
+
+Bluetooth, Wi-Fi, WWAN
+~~~~~~~~~~~~~~~~~~~~~~
+
+  * Bluetooth I2S interface
+  * Bluetooth (SDIO)
+  * RedPine WiFi/BT M.2 module on SDIO
+  * Broadmobi BM818-E1 or BM818-A1 WWAN module
+
+Camera
+~~~~~~
+
+ * `LN3560 Synchronous Boost Flash Driver <https://www.ti.com/product/LM3560/technicaldocuments>`_ [`datasheet <LM3560_>`_]
+
+.. _`hardware_ref_chestnut_display`:
+
+Display
+~~~~~~~
+
+ * Mantix MLAF057WE51 MIPI DSI LCD panel: 720x1440 pixels and touch
+   controller
+
+.. _`hardware_ref_chestnut_kill_switches`:
+
+GNSS
+~~~~
+
+  * `Teseo-LIV3F`_ multiconstellation GNSS receiver (UART2 interface and antenna)
+
+Hardware Kill Switches
+~~~~~~~~~~~~~~~~~~~~~~
+
+ * Diodes Incorporated Power Switch [`datasheet <AP2281_>`_]
+
+   * WWAN (Modem)
+   * WiFi/Bluetooth
+   * Microphone and Camera
+
+.. _hardware_ref_chestnut_headers:
+
+LEDs
+~~~~
+
+ * Used for `indicating charging status <LED colors_>`_
+
+.. _`hardware_ref_chestnut_micro_sd`:
+.. _`hardware_ref_chestnut_nano_sim`:
+
+nano-SIM and microSD Cards
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ * Combined microSD and nano-SIM slot
+
+Push Buttons
+~~~~~~~~~~~~
+
+  * Power
+  * Volume up
+  * Volume down
+
+Sensors and Motors
+~~~~~~~~~~~~~~~~~~
+
+  * Haptic motor
+  * `ST LSM9DS1 accelerometer, gyro, magnetometer <https://www.st.com/en/mems-and-sensors/lsm9ds1.html>`_ [`datasheet <LSM9DS1_>`_]
+  * Vishay VCML4040 proximity and ambient light sensor [`datasheet <VCNL4040M3OE-H5_>`_]
+
+.. _`hardware_ref_chestnut_smart_card`:
+
+Smart Card
+~~~~~~~~~~
+
+..  * `Microchip SEC1110 <https://www.microchip.com/wwwproducts/en/SEC1110>`_ smart card reader [`datasheet <SEC1110_>`_]
+..  * Amphenol 1010027182 smart card slot [`datasheet <1010027182_>`_]
+
+.. _`hardware_ref_chestnut_usb`:
+
+USB
+~~~
+
+  * Serial Downloader support (loading u-boot via USB)
+  * USB-C port including USB-C role switching
+  * `USB Hub and SD controller <https://www.microchip.com/wwwproducts/en/USB2642>`_ [`datasheet <USB2642_>`_]
+
+Schematics
+----------
+
+The following schematics are available:
+
+ * Librem 5 Chestnut main board: :download:`librem5_chestnut_mainboard_schematic.pdf <_files/librem5_chestnut_mainboard_schematic.pdf>`
+ * Librem 5 Chestnut USB C board: :download:`librem5_chestnut_usb-c_board_schematic.pdf <_files/librem5_chestnut_usb-c_board_schematic.pdf>`
+
+.. include:: /links.txt