aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@leaflabs.com>2011-05-28 00:16:12 -0400
committerMarti Bolivar <mbolivar@leaflabs.com>2011-05-28 00:18:17 -0400
commitcfcd77d491f2f548dbf40d048a74acf86fd96029 (patch)
tree3e3b554376543c31cadd93474ccca4f718f2a249
parent17a7a35f7b1c083225f35770798bc288a1c43fc1 (diff)
downloadlibrambutan-cfcd77d491f2f548dbf40d048a74acf86fd96029.tar.gz
librambutan-cfcd77d491f2f548dbf40d048a74acf86fd96029.zip
Docs: Simplify and clarify usart.rst.
Make the language a little friendlier, say the words "serial port", and let them know that baud rate is a speed.
-rw-r--r--docs/source/usart.rst12
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/source/usart.rst b/docs/source/usart.rst
index 8766e3f..e65821d 100644
--- a/docs/source/usart.rst
+++ b/docs/source/usart.rst
@@ -3,19 +3,25 @@
USART
=====
+A USART is more commonly known a *serial port*. It's used to transmit
+information between Maple and another device (like your computer,
+another Maple, etc.).
+
.. contents:: Contents
:local:
Hardware/Circuit Design
-----------------------
+.. TODO [0.0.12] Add some more information here (like how you should
+.. connect TX_a to RX_b and RX_a to TX_b).
+
.. TODO [0.0.12/Maple Native] UART4 and UART5, Native links
Each LeafLabs board has at least 3 separate USART devices. In the most
simple use case, the RX and TX pins are used to send data at a
-predetermined baud rate with the line voltage level relative to
-ground. Their usage is documented in the :ref:`Serial Ports
-<lang-serial>` language reference page.
+predetermined speed (or *baud rate*). Their usage is documented in
+the :ref:`Serial Ports <lang-serial>` language reference page.
Which pins correspond to the USART TX and RX pins are given on your
board's silkscreen, and also in the board-specific USART pin maps