BeagleBone AI docs update

Update tables and headings formatting.

boards/beaglebone/ai/ch02.rst

@@ -10,13 +10,13 @@ Change History
 .. ****************************
 
 Rev A0
-==============
+*******
 
 Initial prototype revision. Not taken to production.
 eMMC flash image provided by Embest.
 
 Rev A1
-==============
+*******
 
 Second round prototype.
 
@@ -31,7 +31,7 @@ Second round prototype.
 eMMC flash image provided by Embest.
 
 Rev A1a
-============
+********
 
 Alpha pilot-run units and initial production.
 
@@ -45,7 +45,7 @@ Production eMMC flash image:
 http://debian.beagleboard.org/images/am57xx-eMMC-flasher-debian-9.9-lxqt-armhf-2019-08-03-4gb.img.xz
 
 Rev A2
-==========
+*******
 
 Proposed changes.
 

boards/beaglebone/ai/ch03.rst

@@ -4,7 +4,7 @@ Connecting Up Your BeagleBone AI
 ####################################
 
 What’s In the Box
-*******************
+******************
 
 BeagleBone® AI comes in the box with the heat sink and antenna already
 attached. Developers can get up and running in five minutes with no
@@ -17,10 +17,11 @@ distribution. In the box you will find:
 TODO: Add links to the design materials for both
 
 .. image:: images/BB_AI_antenna_heat_sink_place_500px.jpg
+   :align: center
    :alt: BeagleBone AI Overview
 
 What’s Not in the Box
-=========================
+**********************
 
 You will need to purchase:
 
@@ -34,7 +35,7 @@ More information or to purchase a replacement heat sink or antenna, please go to
 -  `Heat Sink <https://bit.ly/2klxxJa>`_
 
 Fans
-===========
+*****
 
 The pre-attached heat sink has M3 holes spaced 20x20 mm. The height of
 the heat sink clears the USB type A socket, and all other components on
@@ -55,7 +56,7 @@ https://www.newark.com/element14/6100310/beaglebone-ai-fan-cape/dp/50AH3704
 TODO: create short-links for any long URLs so that text works.
 
 Main Connection Scenarios
-******************************
+**************************
 
 This section will describe how to connect the board for use. The board
 can be configured in several different ways. Below we will walk through
@@ -64,13 +65,13 @@ dependent on the software image presently on your BeagleBone® AI. When
 all else fails, follow the instructions at
 https://beagleboard.org/upgrade
 
--  `Tethered to a PC via USB C cable <#tethered-to-a-pc>`__
+-  `Tethered to a PC via USB C cable <#tethered-to-a-pc>`_
 -  `Standalone Desktop with powered USB hub, display, keyboard and
-   mouse <#standalone-wdisplay-and-keyboardmouse>`__
--  `Wireless Connection to BeagleBone® AI <#wireless-connection>`__
+   mouse <#standalone-wdisplay-and-keyboardmouse>`_
+-  `Wireless Connection to BeagleBone® AI <#wireless-connection>`_
 
 Tethered to a PC
-========================
+*****************
 
 The most common way to program BeagleBone® AI is via a USB connection to
 a PC. If your computer has a USB C type port, BeagleBone® AI will both
@@ -88,14 +89,20 @@ loaded on your BeagleBone® AI.
 1.  Locate the USB Type-C connector on BeagleBone® AI 
 
 .. image:: images/BB_AI_USBC_and_3pin_500px.png
+   :align: center
+   :alt: USB connector and serial debug.
 
 2.  Connect a USB type-C cable to BeagleBone® AI USB type-C port.
 
 .. image:: images/BB_AI_connectingUSBC_500px.jpg
+   :align: center
+   :alt: Connecting serial cable.
 
 3.  Connect the other end of the USB cable to the PC USB 3 port.
 
 .. image:: images/BB_AI_PlugIn_500px.jpg
+   :align: center
+   :alt: connecting to PC
 
 4.  BeagleBone® AI will boot.
 
@@ -104,27 +111,38 @@ loaded on your BeagleBone® AI.
 6.  Look for a new mass storage drive to appear on the PC.
 
 .. image:: images/BB_AI_asadrive_500px.jpg
+   :align: center
+   :alt: BeagleBone storage drive options
 
 7.  Open the drive and open START.HTM with your web browser.
 
 .. image:: images/BB_AI_starthtm_500px.png
+   :align: center
+   :alt: BeagleBone drive 
 
 .. image:: images/BB_AI_connectedscreen_500px.jpg
+   :align: center
+   :alt: Getting started
 
 8.  Follow the instructions in the browser window.
 
 .. image:: images/BB_AI_ss_cloud9_500px.jpg
+   :align: center
+   :alt: BeagleBone instructions
 
 9.  Go to Cloud9 IDE.
 
 10. Open the directories in the left navigation of Cloud9.
 
 .. image:: images/BB_AI_ss_cloud9_dir_500px.jpg
+   :align: center
+   :alt: Cloud9 navigation
 
 Standalone w/Display and Keyboard/Mouse
-==============================================
+****************************************
 
 .. image:: images/BB_AI_Standalone_setup_750px.jpg
+   :align: center
    :alt: BeagleBone AI Overview
 
 .. note::
@@ -147,7 +165,7 @@ this configuration. We re working on a better solution.
 7. Follow the instructions at https://beagleboard.org/upgrade
 
 Wireless Connection
-===========================
+********************
 
 NOTE:Start with this image "am57xx-eMMC-flasher-debian-10.3-iot-tidl-armhf-2020-04-06-6gb.img.xz"
 loaded on your BeagleBone® AI.
@@ -160,7 +178,7 @@ loaded on your BeagleBone® AI.
 6. Follow the instructions in the browser window.
 
 Connecting a 3 PIN Serial Debug Cable
-*****************************************
+**************************************
 
 A 3 PIN serial debug cable can be helpful to debug when you need to view
 the boot messages through a terminal program such as putty on your host
@@ -171,6 +189,7 @@ Cables: https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Quest
 Locate the 3 PIN debug header on BeagleBone® AI, near the USB C connection.
 
 .. image:: images/BB_AI_USBC_and_3pin_500px.png
+   :align: center
    :alt: BeagleBone AI Overview
 
 Press the small white connector into the 3 PIN debug header. The pinout is:
@@ -180,4 +199,5 @@ Press the small white connector into the 3 PIN debug header. The pinout is:
 - Pin 3: UART1_TX (i.e. BB-AI transmits out on this pin)
 
 .. image:: images/BB_AI_3pincableattach_500px.jpg
+   :align: center
    :alt: BeagleBone AI Overview
\ No newline at end of file

boards/beaglebone/ai/ch04.rst

@@ -4,12 +4,14 @@ BeagleBone AI Overview
 ########################
 
 .. image:: images/BB_AI_overview_image.png
+   :align: center
    :alt: BeagleBone AI Overview
 
 BeagleBone® AI Features
 ************************
 
-**Main Processor Features of the AM5729 Within BeagleBone® AI**
+Main Processor Features of the AM5729 Within BeagleBone® AI
+============================================================
 
 -  Dual 1.5GHz ARM® Cortex®-A15 with out-of-order speculative issue
    3-way superscalar execution pipeline for the fastest execution of
@@ -26,7 +28,8 @@ BeagleBone® AI Features
 -  Vivante® GC320 2D graphics accelerator
 -  Dual-Core PowerVR® SGX544™ 3D GPU
 
-**Communications**
+Communications
+===============
 
 -  BeagleBone Black header and mechanical compatibility
 -  16-bit LCD interfaces
@@ -35,24 +38,28 @@ BeagleBone® AI Features
 -  2 SPI ports
 -  Lots of PRU I/O pins
 
-**Memory**
+Memory
+=======
 
 -  1GB DDR3L
 -  16GB on-board eMMC flash
 
-**Connectors**
+Connectors
+===========
 
 -  USB Type-C connector for power and SuperSpeed dual-role controller
 -  Gigabit Ethernet
 -  802.11ac 2.4/5GHz WiFi via the AzureWave AW-CM256SM
 
-**Out of Box Software**
+Out of Box Software
+====================
 
 -  Zero-download out of box software environment
 
 Board Component Locations
-*******************************
+**************************
 
 .. image:: images/BB_AI_ICPlacement_800px.png
+   :align: center
    :alt: beaglebone ai component placement
 

boards/beaglebone/ai/ch05.rst

@@ -6,16 +6,17 @@ BeagleBone AI High Level Specification
 This section provides the high level specification of BeagleBone® AI
 
 Block Diagram
-******************
+**************
 
 The figure below is the high level block diagram of BeagleBone® AI. For
 detailed layout information please check the schematics.
 
 .. image:: images/BB_AI_Blockdiagram_1000px.jpg
+   :align: center
    :alt: beaglebone ai component placement
 
 AM572x Sitara™ Processor
-**************************
+*************************
 
 The Texas Instruments AM572x Sitara™ processor family of SOC devices
 brings high processing performance through the maximum flexibility of a
@@ -33,6 +34,7 @@ and coprocessors, thus reducing the complexity of the system software.
 Texas Instruments AM572x Sitara™ Processor Family Block Diagram\*
 
 .. image:: images/BB_AI_AM5729_blockdiagram.jpg
+   :align: center
    :alt: beaglebone ai component placement
 
 **MPU Subsystem** The Dual Cortex-A15 MPU subsystem integrates the
@@ -98,6 +100,7 @@ subsystem contains the following submodules:
    library
 
 .. image:: images/BB_AI_EVEmodule.jpg
+   :align: center
    :alt: BeagleBone AI component placement
 
 The Embedded Vision Engine (EVE) module is a programmable imaging and
@@ -224,12 +227,12 @@ following features:
    memory architecture (MMU)
 
 Memory
-************
+********
 
 .. __5_3_1_1gb_ddr3l:
 
 1GB DDR3L
-============
+==========
 
 Dual 256M x 16 DDR3L memory devices are used, one on each side of the
 board, for a total of 1 GB. They will each operate at a clock frequency
@@ -259,19 +262,16 @@ Power Management
 Connectivity
 ******************
 
-TODO: Add WiFi/Bluetooth/Ethernet
+.. TODO: Add WiFi/Bluetooth/Ethernet
 
 BeagleBone® AI supports the majority of the functions of the AM5729 SOC
 through connectors or expansion header pin accessibility. See section 7
 for more information on expansion header pinouts. There are a few
 functions that are not accessible which are: (TBD)
 
-TODO: This text needs to go somewhere.
-
-On-board I2C Devices
-**********************
+.. TODO: This text needs to go somewhere.
 
-.. table:: 
+.. table:: On-board I2C Devices
 
    +---------+--------------+-----------------+
    | Address | Identifier   | Description     |

boards/beaglebone/ai/ch08.rst

@@ -46,66 +46,69 @@ UART or PRU UART
 This section is about both UART pins on the header and PRU UART pins on
 the headers we will include a chart and later some code
 
-+-------------+--------+-----------+-------------------+-------+
-| Function    | Pin    | ABC Ball  | Pinctrl Register  | Mode  |
-+=============+========+===========+===================+=======+
-| uart3_txd   | P9.21  | B22       | 0x17C4            | 1     |
-+-------------+--------+-----------+-------------------+-------+
-| uart3_rxd   | P9.22  | A26       | 0x17C0            | 1     |
-+-------------+--------+-----------+-------------------+-------+
-| uart5_txd   | P9.13  | C17       | 0x1730            | 4     |
-+-------------+--------+-----------+-------------------+-------+
-| uart5_rxd   | P9.11  | B19       | 0x172C            | 4     |
-+-------------+--------+-----------+-------------------+-------+
-| uart5_ctsn  | P8.05  | AC9       | 0x178C            | 2     |
-+-------------+--------+-----------+-------------------+-------+
-| uart5_rtsn  | P8.06  | AC3       | 0x1790            | 2     |
-+-------------+--------+-----------+-------------------+-------+
-| uart8_txd   | P8.37  | A21       | 0x1738            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart8_rxd   | P8.38  | C18       | 0x1734            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart8_ctsn  | P8.31  | G16       | 0x173C            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart8_rtsn  | P8.32  | D17       | 0x1740            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_txd  | P9.24  | F20       | 0x168C            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_rxd  | P9.26  | E21       | 0x1688            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_ctsn | P8.03  | AB8       | 0x179C            | 2     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_rtsn | P8.04  | AB5       | 0x17A0            | 2     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_txd  | P9.24  | F20       | 0x168C            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_rxd  | P9.26  | E21       | 0x1688            | 3     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_ctsn | P9.20  | D2        | 0x1578            | 8     |
-+-------------+--------+-----------+-------------------+-------+
-| uart10_rtsn | P9.19  | F4        | 0x157C            | 8     |
-+-------------+--------+-----------+-------------------+-------+
-
-
-+------------------+--------+-----------+-------------------+-------+
-| Function         | Pin    | ABC Ball  | Pinctrl Register  | Mode  |
-+==================+========+===========+===================+=======+
-| pr2_uart0_txd    | P8.31  | C8        | 0x1614            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr2_uart0_rxd    | P8.33  | C6        | 0x1610            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr2_uart0_cts_n  | P8.34  | D8        | 0x1608            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr2_uart0_rts_n  | P8.35  | A5        | 0x160C            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr1_uart0_rxd    | P8.43  | F10       | 0x15E4            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr1_uart0_txd    | P8.44  | G11       | 0x15E8            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr1_uart0_cts_n  | P8.45  | F11       | 0x15DC            | 10    |
-+------------------+--------+-----------+-------------------+-------+
-| pr1_uart0_rts_n  | P8.46  | G10       | 0x15E0            | 10    |
-+------------------+--------+-----------+-------------------+-------+
+.. table::  UART
+
+    +-------------+--------+-----------+-------------------+-------+
+    | Function    | Pin    | ABC Ball  | Pinctrl Register  | Mode  |
+    +=============+========+===========+===================+=======+
+    | uart3_txd   | P9.21  | B22       | 0x17C4            | 1     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart3_rxd   | P9.22  | A26       | 0x17C0            | 1     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart5_txd   | P9.13  | C17       | 0x1730            | 4     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart5_rxd   | P9.11  | B19       | 0x172C            | 4     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart5_ctsn  | P8.05  | AC9       | 0x178C            | 2     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart5_rtsn  | P8.06  | AC3       | 0x1790            | 2     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart8_txd   | P8.37  | A21       | 0x1738            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart8_rxd   | P8.38  | C18       | 0x1734            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart8_ctsn  | P8.31  | G16       | 0x173C            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart8_rtsn  | P8.32  | D17       | 0x1740            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_txd  | P9.24  | F20       | 0x168C            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_rxd  | P9.26  | E21       | 0x1688            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_ctsn | P8.03  | AB8       | 0x179C            | 2     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_rtsn | P8.04  | AB5       | 0x17A0            | 2     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_txd  | P9.24  | F20       | 0x168C            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_rxd  | P9.26  | E21       | 0x1688            | 3     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_ctsn | P9.20  | D2        | 0x1578            | 8     |
+    +-------------+--------+-----------+-------------------+-------+
+    | uart10_rtsn | P9.19  | F4        | 0x157C            | 8     |
+    +-------------+--------+-----------+-------------------+-------+
+
+.. table:: PRU UART
+
+    +------------------+--------+-----------+-------------------+-------+
+    | Function         | Pin    | ABC Ball  | Pinctrl Register  | Mode  |
+    +==================+========+===========+===================+=======+
+    | pr2_uart0_txd    | P8.31  | C8        | 0x1614            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr2_uart0_rxd    | P8.33  | C6        | 0x1610            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr2_uart0_cts_n  | P8.34  | D8        | 0x1608            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr2_uart0_rts_n  | P8.35  | A5        | 0x160C            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr1_uart0_rxd    | P8.43  | F10       | 0x15E4            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr1_uart0_txd    | P8.44  | G11       | 0x15E8            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr1_uart0_cts_n  | P8.45  | F11       | 0x15DC            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
+    | pr1_uart0_rts_n  | P8.46  | G10       | 0x15E0            | 10    |
+    +------------------+--------+-----------+-------------------+-------+
 
 
 TODO

intro/contribution/rst-cheat-sheet.rst

@@ -17,7 +17,7 @@ you should keep in mind while working with rst,
 Text formatting
 ****************
 
-With asterisk you can fomat the text as italic & bold,
+With asterisk you can format the text as italic & bold,
 
 1. Single asterisk (``*``) like ``*emphasis*`` gives you *italic text*
 2. Double asterisk (``**``) like ``**strong emphasis**`` gives you **bold text**