aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-05-28 00:25:05 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-05-28 00:25:05 -0400
commitfe2f541e42bab2c8aeb719468daadecb2463c3f3 (patch)
tree30427c21bc7d24c60bef7807f69800c35398f7cd
parentcfcd77d491f2f548dbf40d048a74acf86fd96029 (diff)
downloadlibrambutan-fe2f541e42bab2c8aeb719468daadecb2463c3f3.tar.gz
librambutan-fe2f541e42bab2c8aeb719468daadecb2463c3f3.zip
Docs: Tweak disabling JTAG debugging information.
-rw-r--r--docs/source/arduino-compatibility.rst17
-rw-r--r--docs/source/lang/api/disabledebugports.rst6
2 files changed, 13 insertions, 10 deletions
diff --git a/docs/source/arduino-compatibility.rst b/docs/source/arduino-compatibility.rst
index e6852a0..c200411 100644
--- a/docs/source/arduino-compatibility.rst
+++ b/docs/source/arduino-compatibility.rst
@@ -26,12 +26,12 @@ EABI target (:command:`arm-non-eabi-gcc`). A (preliminary) reference
on :ref:`using arm-none-eabi-gcc <arm-gcc>` is available.
The bitwidth of the processor means that the Maple can process 32-bit
-operations (like adding two 32-bit integers) in a single instruction,
-while an Arduino processor would have to split up large operations
-into several smaller ones. In a lot of cases 8-bit operations are
-plenty (integers 0-255, single characters of text, etc.), but if
-you're dealing with higher resolution data, the speed up could be
-significant.
+operations (like adding or multiplying two 32-bit integers) in a
+single instruction, while an Arduino processor would have to split up
+large operations into several smaller ones. In a lot of cases 8-bit
+operations are plenty (integers 0-255, single characters of text,
+etc.), but if you're dealing with higher resolution data, the speed up
+could be significant.
A trade-off is that code could be larger as well; program instructions
and memory locations can be up to 32 bits each. However, removal of
@@ -45,8 +45,9 @@ Header Numbering and Incompatibilities
The numbering of headers is different; on the Maple each GPIO has a
unique number: 0, 1, 2, all the way up to 37 (actually, there are
-:ref:`a few more <jtag>`...). On the Arduino, the analog pins are
-numbered separately (A0-A5) from the digital pins (D0\ -D13).
+:ref:`a few more <lang-disabledebugports>`...). On the Arduino, the
+analog pins are numbered separately (A0-A5) from the digital pins (D0\
+-D13).
The incompatible hardware differences are:
diff --git a/docs/source/lang/api/disabledebugports.rst b/docs/source/lang/api/disabledebugports.rst
index 43ac337..283cdbf 100644
--- a/docs/source/lang/api/disabledebugports.rst
+++ b/docs/source/lang/api/disabledebugports.rst
@@ -22,10 +22,12 @@ Example
}
void loop() {
- // Now you can use the debug port pins as ordinary pins
+ // Now you can use the debug port pins (the pins on the JTAG
+ // header on the Maple) as ordinary pins.
}
See Also
--------
-* :ref:`lang-enabledebugports`
+- :ref:`lang-enabledebugports`
+- :ref:`Important erratum on Maple pin 43 <maple-nrst-pb4>`