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
commitd104f3b2dad7c315cebb9dc6e8eaeddcb209dafe (patch)
tree9989cd97a456b007c3703d422b5e839519749313
parentc2d042ff66dad8e6d21b8101a5b4d30465a559d8 (diff)
downloadlibrambutan-d104f3b2dad7c315cebb9dc6e8eaeddcb209dafe.tar.gz
librambutan-d104f3b2dad7c315cebb9dc6e8eaeddcb209dafe.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--source/usart.rst12
1 files changed, 9 insertions, 3 deletions
diff --git a/source/usart.rst b/source/usart.rst
index 8766e3f..e65821d 100644
--- a/source/usart.rst
+++ b/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