Forum | Documentation | Website | Blog

Skip to content
Snippets Groups Projects
Commit 2b434042 authored by Deepak Khatri's avatar Deepak Khatri :dog:
Browse files

BeagleBone AI docs update 

Update tables and headings formatting.
parent 2b0e4217
Branches
Tags
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 3299 additions and 3271 deletions
boards/beaglebone/ai/ch02.rst
+ 4
− 4
View file @ 2b434042
......@@ -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
+ 31
− 11
View file @ 2b434042
......@@ -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
+ 13
− 6
View file @ 2b434042
......@@ -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
+ 10
− 10
View file @ 2b434042
......@@ -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/ch06.rst
+ 1727
− 1703
View file @ 2b434042
source diff could not be displayed: it is too large. Options to address this: view the blob.
boards/beaglebone/ai/ch07.rst
+ 1450
− 1476
View file @ 2b434042
source diff could not be displayed: it is too large. Options to address this: view the blob.
boards/beaglebone/ai/ch08.rst
+ 63
− 60
View file @ 2b434042
......@@ -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
+ 1
− 1
View file @ 2b434042
......@@ -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**
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment

Open hardware computers for makers, educators and professionals