Docs: board-specific values for Maple and Maple RET6 Edition.

2 files changed, 88 insertions, 15 deletions

diff --git a/docs/source/hardware/maple-ret6.rst b/docs/source/hardware/maple-ret6.rst
index d6a7c0e..fa7e50e 100644
--- a/docs/source/hardware/maple-ret6.rst
+++ b/docs/source/hardware/maple-ret6.rst
@@ -75,7 +75,7 @@ GPIO Information
 The RET6 Edition features 38 ready-to-use general purpose input/output
 (GPIO) pins for digital input/output, numbered ``D0`` through ``D37``.
 These numbers correspond to the numeric values next to each header on
-the Maple silkscreen.  More GPIOs (numbered ``D39``\ --``43``) are
+the Maple silkscreen.  More GPIOs (numbered ``D39``\ --``D43``) are
 available through use in combination with the
 :ref:`lang-disabledebugports` function; see the :ref:`board-specific
 debug pin constants <lang-board-values-debug>` for more information.
@@ -207,11 +207,10 @@ The following table shows which pins connect to which :ref:`EXTI lines
 USART Pin Map
 ^^^^^^^^^^^^^
 
-.. FIXME [0.0.10] UART4 and UART5 information
-
-The Maple RET6 Edition has three serial ports (also known as a UARTs
-or USARTs): ``Serial1``, ``Serial2``, and ``Serial3``. They
-communicate using the pins summarized in the following table:
+The Maple RET6 Edition has three serial ports whose pins are broken
+out to headers (also known as a UARTs or USARTs): ``Serial1``,
+``Serial2``, and ``Serial3``. They communicate using the pins
+summarized in the following table:
 
 .. csv-table::
    :header: Serial Port, TX, RX, CK, CTS, RTS
@@ -221,12 +220,53 @@ communicate using the pins summarized in the following table:
    ``Serial2`` | 1  | 0  | 10 | 2  | 3
    ``Serial3`` | 29 | 30 | 31 | 32 | 33
 
+Unfortunately, :ref:`UART4 and UART5 aren't completely available
+<maple-ret6-uart-errata>`.
+
 Board-Specific Values
 ---------------------
 
-.. TODO [0.0.10]
-
-Stub.
+This section lists the Maple RET6 Edition's :ref:`board-specific
+values <lang-board-values>`.
+
+- ``CYCLES_PER_MICROSECOND``: 72
+- ``BOARD_BUTTON_PIN``: 38
+- ``BOARD_LED_PIN``: 13
+- ``BOARD_NR_GPIO_PINS``: 44
+- ``BOARD_NR_PWM_PINS``: 16
+- ``boardPWMPins``: 0, 1, 2, 3, 5, 6, 7, 8, 9, 11, 12, 14, 24, 25, 27, 28
+- ``BOARD_NR_ADC_PINS``: 15
+- ``boardADCPins``: 0, 1, 2, 10, 11, 12, 13, 15, 16, 17, 18, 19, 20, 27, 28
+- ``BOARD_NR_USED_PINS``: 7
+- ``boardUsedPins``: ``BOARD_LED_PIN``, ``BOARD_BUTTON_PIN``,
+  ``BOARD_JTMS_SWDIO_PIN``, ``BOARD_JTCK_SWCLK_PIN``,
+  ``BOARD_JTDI_PIN``, ``BOARD_JTDO_PIN``, ``BOARD_NJTRST_PIN``
+- ``BOARD_NR_USARTS``: 3 (unfortunately, due to the Maple Rev 5
+  design, UARTs 4 and 5 have pins which are not broken out)
+- ``BOARD_USART1_TX_PIN``: 7
+- ``BOARD_USART1_RX_PIN``: 8
+- ``BOARD_USART2_TX_PIN``: 1
+- ``BOARD_USART2_RX_PIN``: 0
+- ``BOARD_USART3_TX_PIN``: 29
+- ``BOARD_USART3_RX_PIN``: 30
+- ``BOARD_NR_SPI``: 3
+- ``BOARD_SPI1_NSS_PIN``: 10
+- ``BOARD_SPI1_MOSI_PIN``: 11
+- ``BOARD_SPI1_MISO_PIN``: 12
+- ``BOARD_SPI1_SCK_PIN``: 13
+- ``BOARD_SPI2_NSS_PIN``: 31
+- ``BOARD_SPI2_MOSI_PIN``: 34
+- ``BOARD_SPI2_MISO_PIN``: 33
+- ``BOARD_SPI2_SCK_PIN``: 32
+- ``BOARD_SPI3_NSS_PIN``: 41
+- ``BOARD_SPI3_MOSI_PIN``: 4
+- ``BOARD_SPI3_MISO_PIN``: 43
+- ``BOARD_SPI3_SCK_PIN``: 42
+- ``BOARD_JTMS_SWDIO_PIN``: 39
+- ``BOARD_JTCK_SWCLK_PIN``: 40
+- ``BOARD_JTDI_PIN``: 41
+- ``BOARD_JTDO_PIN``: 42
+- ``BOARD_NJTRST_PIN``: 43
 
 Hardware Design Files
 ---------------------
@@ -269,6 +309,8 @@ This section lists known issues and warnings for the Maple RET6 Edition.
   advertising that it was capable of supplying up to 800 mA; the
   correct value is 500 mA.
 
+.. _maple-ret6-uart-errata:
+
 * **UART4, UART5 GPIOs unavailable**: Pins related to the digital
   to analog converter (DAC) and UARTs 4 and 5 are not broken out to
   headers.  The RET6 Edition's hardware layout is identical to that of
diff --git a/docs/source/hardware/maple.rst b/docs/source/hardware/maple.rst
index d0434ab..4aed91d 100644
--- a/docs/source/hardware/maple.rst
+++ b/docs/source/hardware/maple.rst
@@ -118,7 +118,7 @@ GPIO Information
 The Maple features 38 ready-to-use general purpose input/output (GPIO)
 pins for digital input/output, numbered ``D0`` through ``D37``.  These
 numbers correspond to the numeric values next to each header on the
-Maple silkscreen.  More GPIOs (numbered ``D39``\ --``43``) are
+Maple silkscreen.  More GPIOs (numbered ``D39``\ --``D43``) are
 available through use in combination with the
 :ref:`lang-disabledebugports` function; see the :ref:`board-specific
 debug pin constants <lang-board-values-debug>` for more information.
@@ -246,8 +246,6 @@ The following table shows which pins connect to which :ref:`EXTI lines
 USART Pin Map
 ^^^^^^^^^^^^^
 
-.. FIXME [0.0.10] UART4, UART5
-
 The Maple has three serial ports (also known as a UARTs or USARTs):
 ``Serial1``, ``Serial2``, and ``Serial3``. They communicate using the
 pins summarized in the following table:
@@ -263,9 +261,42 @@ pins summarized in the following table:
 Board-Specific Values
 ---------------------
 
-.. TODO [0.0.10]
-
-Stub.
+This section lists the Maple's :ref:`board-specific values
+<lang-board-values>`.
+
+- ``CYCLES_PER_MICROSECOND``: 72
+- ``BOARD_BUTTON_PIN``: 38
+- ``BOARD_LED_PIN``: 13
+- ``BOARD_NR_GPIO_PINS``: 44
+- ``BOARD_NR_PWM_PINS``: 16
+- ``boardPWMPins``: 0, 1, 2, 3, 5, 6, 7, 8, 9, 11, 12, 14, 24, 25, 27, 28
+- ``BOARD_NR_ADC_PINS``: 15
+- ``boardADCPins``: 0, 1, 2, 10, 11, 12, 13, 15, 16, 17, 18, 19, 20, 27, 28
+- ``BOARD_NR_USED_PINS``: 7
+- ``boardUsedPins``: ``BOARD_LED_PIN``, ``BOARD_BUTTON_PIN``,
+  ``BOARD_JTMS_SWDIO_PIN``, ``BOARD_JTCK_SWCLK_PIN``,
+  ``BOARD_JTDI_PIN``, ``BOARD_JTDO_PIN``, ``BOARD_NJTRST_PIN``
+- ``BOARD_NR_USARTS``: 3
+- ``BOARD_USART1_TX_PIN``: 7
+- ``BOARD_USART1_RX_PIN``: 8
+- ``BOARD_USART2_TX_PIN``: 1
+- ``BOARD_USART2_RX_PIN``: 0
+- ``BOARD_USART3_TX_PIN``: 29
+- ``BOARD_USART3_RX_PIN``: 30
+- ``BOARD_NR_SPI``: 2 
+- ``BOARD_SPI1_NSS_PIN``: 10
+- ``BOARD_SPI1_MOSI_PIN``: 11
+- ``BOARD_SPI1_MISO_PIN``: 12
+- ``BOARD_SPI1_SCK_PIN``: 13
+- ``BOARD_SPI2_NSS_PIN``: 31
+- ``BOARD_SPI2_MOSI_PIN``: 34
+- ``BOARD_SPI2_MISO_PIN``: 33
+- ``BOARD_SPI2_SCK_PIN``: 32
+- ``BOARD_JTMS_SWDIO_PIN``: 39
+- ``BOARD_JTCK_SWCLK_PIN``: 40
+- ``BOARD_JTDI_PIN``: 41
+- ``BOARD_JTDO_PIN``: 42
+- ``BOARD_NJTRST_PIN``: 43
 
 Hardware Design Files
 ---------------------