From f304951dedbb8f49d912b4e8eded2783af6f05ba Mon Sep 17 00:00:00 2001
From: Marti Bolivar <mbolivar@leaflabs.com>
Date: Thu, 12 May 2011 18:42:50 -0400
Subject: More technical specs fixes.

---
 docs/source/hardware/maple-ret6.rst | 28 +++++++++++++++++++++-------
 docs/source/hardware/maple.rst      | 32 +++++++++++++++++++++++++++-----
 2 files changed, 48 insertions(+), 12 deletions(-)

(limited to 'docs/source')

diff --git a/docs/source/hardware/maple-ret6.rst b/docs/source/hardware/maple-ret6.rst
index 45a59cd..5fa43a8 100644
--- a/docs/source/hardware/maple-ret6.rst
+++ b/docs/source/hardware/maple-ret6.rst
@@ -13,22 +13,27 @@ Technical Specifications
 
     * MCU: **STM32F103RET6**, a 32-bit ARM Cortex M3 microprocessor
     * Clock Speed: **72 MHz**
-    * Operating Voltage: 3.3V
-    * Input Voltage (recommended): 3V-12V
+    * **512KB Flash** and **64KB SRAM**
     * 44 Digital I/O Pins (:ref:`GPIO <gpio>`)
     * 16 Analog Input pins, 12 bit **ADC** resolution (:ref:`ADC <adc>`)
+    * Built-in, 2 channel **DAC** at 12 bit resolution
+      (:ref:`libmaple-dac`).
     * 19 **PWM** pins at 16-bit resolution (:ref:`PWM <pwm>`)
     * Dedicated **USB** port for programming and communications (:ref:`USB<usb>`)
     * External **JTAG** interface (:ref:`JTAG <jtag>`)
-    * **512KB Flash** and **64KB SRAM**
-    * 64 Channel nested vector interrupt handler (including external interrupt on GPIOs)
+    * 64 Channel nested vector interrupt handler (including
+      :ref:`external interrupt <lang-attachinterrupt>` on GPIOs)
     * Integrated **SPI** (:ref:`SPI <spi>`)
+    * Integrated **SDIO**
     * Integrated **I2C** and **I2S** (:ref:`I2C <i2c>`)
-    * 12 Channels of Direct Memory Access (**DMA**)
+    * 12 Channels of Direct Memory Access (**DMA**) (:ref:`libmaple-dma`)
     * 3 **USART** and 2 **UART** devices (:ref:`USART <usart>`)
-    * Six 4-channel and two basic **timers** (:ref:`Timers <timers>`)
+    * Two advanced control, four general purpose, two basic **timers**
+      (:ref:`timers`)
     * Supplies up to 800mA @ 3.3v
     * Support for low power and sleep modes (<500uA)
+    * Operating Voltage: 3.3V
+    * Input Voltage (recommended): 3V-12V
     * Dimensions are 2.05″x2.1″
 
 .. _maple-ret6-powering:
@@ -256,12 +261,21 @@ Errata
 
 This section lists known issues and warnings for the Maple RET6 Edition.
 
-* **DAC, UART4, UART5 GPIOs unavailable**: Pins related to the digital
+* **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
   the Maple Rev 5, which wasn't designed for use with these
   STM32F103RET6-only peripherals.
 
+* **DAC channel 2 on BOARD_LED_PIN**: The Maple Rev 5 connects PA5 to
+  the board's built-in LED; this is the same GPIO bit which is
+  connected to the DAC's channel 2 output.
+
+* **Reset and NJTRST tied together**: The MCU's reset pin is tied to
+  PB4, the NJTRST (JTAG reset) pin, which is pin 43.  Thus, attempting
+  to use pin 43 as a GPIO will reset your board (and also prevents the
+  JTAG "reset halt" command from working properly).
+
 Recommended Reading
 -------------------
 
diff --git a/docs/source/hardware/maple.rst b/docs/source/hardware/maple.rst
index 87878e9..4616ac7 100644
--- a/docs/source/hardware/maple.rst
+++ b/docs/source/hardware/maple.rst
@@ -13,22 +13,23 @@ Technical Specifications
 
     * MCU: **STM32F103RBT6**, a 32-bit ARM Cortex M3 microprocessor
     * Clock Speed: **72 MHz**
-    * Operating Voltage: 3.3V
-    * Input Voltage (recommended): 3V-12V
+    * **128KB Flash** and **20KB SRAM**
     * 44 Digital I/O Pins (:ref:`GPIO <gpio>`)
     * 16 Analog Input Pins, 12-bit **ADC** resolution (:ref:`ADC <adc>`)
     * 15 **PWM** pins at 16-bit resolution (:ref:`PWM <pwm>`)
     * Dedicated **USB** port for programming and communications (:ref:`USB <usb>`)
     * External **JTAG** interface (:ref:`JTAG <jtag>`)
-    * **128KB Flash** and **20KB SRAM**
-    * 64 Channel nested vector interrupt handler (including external interrupt on GPIOs)
+    * 64 Channel nested vector interrupt handler (including
+      :ref:`external interrupt <lang-attachinterrupt>` on GPIOs)
     * Integrated **SPI** (:ref:`SPI <spi>`)
     * Integrated **I2C** (:ref:`I2C <i2c>`)
-    * 7 Channels of Direct Memory Access (**DMA**)
+    * 7 Channels of Direct Memory Access (**DMA**) (:ref:`libmaple.dma`)
     * 3 **USART** divices (:ref:`USART <usart>`)
     * Four 4-channel **timers** (:ref:`Timers <timers>`)
     * Supplies up to 800mA @ 3.3v
     * Support for low power and sleep modes (<500uA)
+    * Operating Voltage: 3.3V
+    * Input Voltage (recommended): 3V-12V
     * Dimensions are 2.05″x2.1″
 
 .. _maple-identify-rev:
@@ -307,6 +308,13 @@ Rev 5
   from its silkscreen.  This mistake was fixed in later manufacturing
   runs.
 
+* **Reset and NJTRST tied together**: The MCU's reset pin is tied to
+  PB4, the NJTRST pin, which is pin 43.  Thus, attempting to use pin
+  43 as a GPIO will reset your board (and also prevents the JTAG
+  "reset halt") command from working properly.  It's possible to cut
+  the trace, but doing so will damage your board, so we *do not
+  recommend it* unless you're very sure about what you're doing.
+
 Rev 3
 ^^^^^
 
@@ -352,6 +360,13 @@ Rev 3
 * **PWM Marketing Mistake**: We originally sold the Maple advertising
   22 channels of 16-bit hardware PWM; actually the Maple only has 15.
 
+* **Reset and NJTRST tied together**: The MCU's reset pin is tied to
+  PB4, the NJTRST pin, which is pin 43.  Thus, attempting to use pin
+  43 as a GPIO will reset your board (and also prevents the JTAG
+  "reset halt") command from working properly.  It's possible to cut
+  the trace, but doing so will damage your board, so we *do not
+  recommend it* unless you're very sure about what you're doing.
+
 Rev 1
 ^^^^^
 
@@ -386,6 +401,13 @@ Rev 1
 * **PWM Marketing Mistake**: We originally sold the Maple advertising
   22 channels of 16-bit hardware PWM; the correct number is 15.
 
+* **Reset and NJTRST tied together**: The MCU's reset pin is tied to
+  PB4, the NJTRST pin, which is pin 43.  Thus, attempting to use pin
+  43 as a GPIO will reset your board (and also prevents the JTAG
+  "reset halt") command from working properly.  It's possible to cut
+  the trace, but doing so will damage your board, so we *do not
+  recommend it* unless you're very sure about what you're doing.
+
 Recommended Reading
 -------------------
 
-- 
cgit v1.2.3