Add BeagleBone AI

boards/beaglebone/ai/ch01.rst

+.. _beaglebone-ai-intro:
+
+Introduction
+##############
+
+Built on the proven BeagleBoard.org® open source Linux approach,
+BeagleBone® AI fills the gap between small SBCs and more powerful
+industrial computers. Based on the Texas Instruments AM5729, developers
+have access to the powerful SoC with the ease of BeagleBone® Black
+header and mechanical compatibility. BeagleBone® AI makes it easy to
+explore how artificial intelligence (AI) can be used in everyday life
+via TI C66x digital-signal-processor (DSP) cores and
+embedded-vision-engine (EVE) cores supported through an optimized TIDL
+machine learning OpenCL API with pre-installed tools. Focused on
+everyday automation in industrial, commercial and home applications.
+
+.. image:: images/BB_AI_BeautyAngle_800px.jpg
+   :align: center
+   :alt: BeagleBone AI Beauty Angle
+

boards/beaglebone/ai/ch02.rst

+.. _beaglebone-ai-change-history:
+
+Change History
+##################
+
+.. Document Change History
+.. ****************************
+
+.. Board changes
+.. ****************************
+
+Rev A0
+==============
+
+Initial prototype revision. Not taken to production.
+eMMC flash image provided by Embest.
+
+Rev A1
+==============
+
+Second round prototype.
+
+-  Fixed size of mounting holes.
+-  Added LED for WiFi status.
+-  Added microHDMI.
+-  Changed eMMC voltage from 3.3V to 1.8V to support HS200.
+-  Changed eMMC from 4GB to 16GB.
+-  Changed serial debug header from 6-pin 100mil pitch to 3-pin 1.5mm pitch.
+-  Switched expansion header from UART4 to UART5. The UART4 pins were used for the microHDMI.
+
+eMMC flash image provided by Embest.
+
+Rev A1a
+============
+
+Alpha pilot-run units and initial production.
+
+-  `Added pull-down resistor on serial debug header RX
+   line <https://github.com/beagleboard/beaglebone-ai/issues/24>`__.
+
+Alpha pilot-run eMMC flash image:
+https://debian.beagleboard.org/images/bbai-pilot-20190408.img.xz
+
+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.
+
+-  `Add footprint for pull-down resistor on serial debug header RX
+   line <https://github.com/beagleboard/beaglebone-ai/issues/24>`__.
+
+-  `Move microSD card cage closer to microHDMI to fit cases
+   better <https://github.com/beagleboard/beaglebone-ai/issues/25>`__.
+
+-  `Connect AM5729 ball AB10 to to P9.13 to provide a
+   GPIO <https://github.com/beagleboard/beaglebone-ai/issues/22>`__.
+
+-  `HDMI hot-plug detection
+   fixes <https://github.com/beagleboard/beaglebone-ai/issues/19>`__.
+
+-  `Add additional CAN port to the expansion
+   headers <https://github.com/beagleboard/beaglebone-ai/issues/20>`__.
+
+-  `Fix JTAG connector to not require wire
+   mods <https://github.com/beagleboard/beaglebone-ai/issues/21>`__.
+
+-  `Add I2C EEPROM for board
+   identifier <https://github.com/beagleboard/beaglebone-ai/issues/23>`__.

boards/beaglebone/ai/ch03.rst

+.. _beaglebone-ai-connecting:
+
+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
+microSD card needed. BeagleBone® AI comes preloaded with a Linux
+distribution. In the box you will find:
+
+-  BeagleBone® AI
+-  Quick Start Guide
+
+TODO: Add links to the design materials for both
+
+.. image:: images/BB_AI_antenna_heat_sink_place_500px.jpg
+   :alt: BeagleBone AI Overview
+
+What’s Not in the Box
+=========================
+
+You will need to purchase:
+
+-  USB C cable or USB C to USB A cable
+-  MicroSD Card (optional)
+-  `Serial cable <https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Questions#serial-cable>`_ (optional)
+
+More information or to purchase a replacement heat sink or antenna, please go to these web sites:
+
+-  `Antenna <https://bit.ly/2kmXAzF>`_
+-  `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
+the board except the 46-way header sockets and the Ethernet socket.
+
+If you run all of the accelerators or have an older software image,
+you’ll likely need fan. To find a fan, visit the link to `fans in the
+FAQ <https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Questions#fans>`_.
+
+.. caution::
+
+   BeagleBone AI can run **HOT**! Even without running the accelerators,
+   getting up to 70C is not uncommon.
+
+Official BeagleBone Fan Cape:
+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
+the most common scenarios. NOTE: These connection scenarios are
+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>`__
+-  `Standalone Desktop with powered USB hub, display, keyboard and
+   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
+communicate and receive power directly from the PC. If your computer
+does not support USB C type, you can utilize a powered USB C hub to
+power and connect to BeagleBone® AI which in turn will connect to your
+PC. You can also use a powered USB C hub to power and connect peripheral
+devices such as a USB camera. After booting, the board is accessed
+either as a USB storage device or via the browser on the PC. You will
+need Chrome or Firefox on the PC.
+
+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.
+
+1.  Locate the USB Type-C connector on BeagleBone® AI 
+
+.. image:: images/BB_AI_USBC_and_3pin_500px.png
+
+2.  Connect a USB type-C cable to BeagleBone® AI USB type-C port.
+
+.. image:: images/BB_AI_connectingUSBC_500px.jpg
+
+3.  Connect the other end of the USB cable to the PC USB 3 port.
+
+.. image:: images/BB_AI_PlugIn_500px.jpg
+
+4.  BeagleBone® AI will boot.
+
+5.  You will notice some of the 5 user LEDs flashing
+
+6.  Look for a new mass storage drive to appear on the PC.
+
+.. image:: images/BB_AI_asadrive_500px.jpg
+
+7.  Open the drive and open START.HTM with your web browser.
+
+.. image:: images/BB_AI_starthtm_500px.png
+
+.. image:: images/BB_AI_connectedscreen_500px.jpg
+
+8.  Follow the instructions in the browser window.
+
+.. image:: images/BB_AI_ss_cloud9_500px.jpg
+
+9.  Go to Cloud9 IDE.
+
+10. Open the directories in the left navigation of Cloud9.
+
+.. image:: images/BB_AI_ss_cloud9_dir_500px.jpg
+
+Standalone w/Display and Keyboard/Mouse
+==============================================
+
+.. image:: images/BB_AI_Standalone_setup_750px.jpg
+   :alt: BeagleBone AI Overview
+
+.. note::
+
+    This configuration requires loading the latest debian 9 image from
+    https://elinux.org/Beagleboard:Latest-images-testing
+
+Load "am57xx-eMMC-flasher-debian-9.13-lxqt-tidl-armhf-2020-08-25-6gb.img.xz"
+image on the BeagleBone® AI
+
+Presently, the "Cloud 9" application is broken in debian 10 only for
+this configuration. We re working on a better solution.
+
+1. Connect a combo keyboard and mouse to BeagleBone® AI’s USB host port.
+2. Connect a microHDMI-to-HDMI cable to BeagleBone® AI’s microHDMI port.
+3. Connect the microHDMI-to-HDMI cable to an HDMI monitor.
+4. Plug a 5V 3A USB type-C power supply into BeagleBone® AI’s USB type-C port.
+5. BeagleBone® AI will boot. No need to enter any passwords.
+6. Depending on which software image is loaded, either a Desktop or a login shell will appear on the monitor.
+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.
+
+1. Plug a 5V 3A USB type-C power supply into BeagleBone® AI’s USB type-C port.
+2. BeagleBone® AI will boot.
+3. Connect your PC’s WiFi to SSID "BeagleBone-XXXX" where XXXX varies for your BeagleBone® AI.
+4. Use password "BeagleBone" to complete the WiFi connection.
+5. Open http://192.168.8.1 in your web browser.
+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
+PC. This cable is not needed for most BeagleBone® AI boot up scenarios.
+
+Cables: https://github.com/beagleboard/beaglebone-ai/wiki/Frequently-Asked-Questions#serial-cable
+
+Locate the 3 PIN debug header on BeagleBone® AI, near the USB C connection.
+
+.. image:: images/BB_AI_USBC_and_3pin_500px.png
+   :alt: BeagleBone AI Overview
+
+Press the small white connector into the 3 PIN debug header. The pinout is:
+
+- Pin 1 (the pin closest to the screw-hole in the board. It is also marked with a shape on the silkscreen): GND
+- Pin 2: UART1_RX (i.e. this is a BB-AI input pin)
+- Pin 3: UART1_TX (i.e. BB-AI transmits out on this pin)
+
+.. image:: images/BB_AI_3pincableattach_500px.jpg
+   :alt: BeagleBone AI Overview
\ No newline at end of file

boards/beaglebone/ai/ch04.rst

+.. _beaglebone-ai-overview:
+
+BeagleBone AI Overview
+########################
+
+.. image:: images/BB_AI_overview_image.png
+   :alt: BeagleBone AI Overview
+
+BeagleBone® AI Features
+************************
+
+**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
+   existing 32-bit code
+-  2 C66x Floating-Point VLIW DSP supported by OpenCL
+-  4 Embedded Vision Engines (EVEs) supported by TIDL machine learning
+   library
+-  2x Dual-Core Programmable Real-Time Unit (PRU) subsystems (4 PRUs
+   total) for ultra low-latency control and software generated
+   peripherals
+-  2x Dual ARM® Cortex®-M4 co-processors for real-time control
+-  IVA-HD subsystem with support for 4K @ 15fps H.264 encode/decode and
+   other codecs @ 1080p60
+-  Vivante® GC320 2D graphics accelerator
+-  Dual-Core PowerVR® SGX544™ 3D GPU
+
+**Communications**
+
+-  BeagleBone Black header and mechanical compatibility
+-  16-bit LCD interfaces
+-  4+ UARTs
+-  2 I2C ports
+-  2 SPI ports
+-  Lots of PRU I/O pins
+
+**Memory**
+
+-  1GB DDR3L
+-  16GB on-board eMMC flash
+
+**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**
+
+-  Zero-download out of box software environment
+
+Board Component Locations
+*******************************
+
+.. image:: images/BB_AI_ICPlacement_800px.png
+   :alt: beaglebone ai component placement
+

boards/beaglebone/ai/ch05.rst

+.. _beaglebone-ai-specs:
+
+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
+   :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
+fully integrated mixed processor solution. The devices also combine
+programmable video processing with a highly integrated peripheral set
+ideal for AI applications. The AM5729 used on BeagleBone® AI is the
+super-set device of the family.
+
+Programmability is provided by dual-core ARM® Cortex®-A15 RISC CPUs with
+Arm® Neon™ extension, and two TI C66x VLIW floating-point DSP core, and
+Vision AccelerationPac (with 4x EVEs). The Arm allows developers to keep
+control functions separate from other algorithms programmed on the DSPs
+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
+   :alt: beaglebone ai component placement
+
+**MPU Subsystem** The Dual Cortex-A15 MPU subsystem integrates the
+following submodules:
+
+-  ARM Cortex-A15 MPCore
+
+   -  Two central processing units (CPUs)
+
+   -  ARM Version 7 ISA: Standard ARM instruction set plus Thumb®-2,
+      Jazelle® RCT Java™ accelerator, hardware virtualization support,
+      and large physical address extensions (LPAE)
+
+   -  Neon™ SIMD coprocessor and VFPv4 per CPU
+
+   -  Interrupt controller with up to 160 interrupt requests
+
+   -  One general-purpose timer and one watchdog timer per CPU – Debug
+      and trace features
+
+   -  32-KiB instruction and 32-KiB data level 1 (L1) cache per CPU
+
+-  Shared 2-MiB level 2 (L2) cache
+
+-  48-KiB bootable ROM
+
+-  Local power, reset, and clock management (PRCM) module
+
+-  Emulation features
+
+-  Digital phase-locked loop (DPLL)
+
+**DSP Subsystems** There are two DSP subsystems in the device. Each DSP
+subsystem contains the following submodules:
+
+-  TMS320C66x™ Floating-Point VLIW DSP core for audio processing, and
+   general-purpose imaging and video processing. It extends the
+   performance of existing C64x+™ and C647x™ DSPs through enhancements
+   and new features.
+
+   -  32-KiB L1D and 32-KiB L1P cache or addressable SRAM
+
+   -  288-KiB L2 cache
+
+-  256-KiB configurable as cache or SRAM
+
+-  32-KiB SRAM
+
+-  Enhanced direct memory access (EDMA) engine for video and audio data
+   transfer
+
+-  Memory management units (MMU) for address management.
+
+-  Interrupt controller (INTC)
+
+-  Emulation capabilities
+
+-  Supported by OpenCL
+
+**EVE Subsystems**
+
+-  4 Embedded Vision Engines (EVEs) supported by TIDL machine learning
+   library
+
+.. image:: images/BB_AI_EVEmodule.jpg
+   :alt: BeagleBone AI component placement
+
+The Embedded Vision Engine (EVE) module is a programmable imaging and
+vision processing engine. Software support for the EVE module is
+available through OpenCL Custom Device model with fixed set of
+functions. More information is available
+http://www.ti.com/lit/wp/spry251/spry251.pdf
+
+**PRU-ICSS Subsystems**
+
+-  2x Dual-Core Programmable Real-Time Unit (PRU) subsystems (4 PRUs
+   total) for ultra low-latency control and software generated
+   peripherals. Access to these powerful subsystems is available through
+   through the P8 and P9 headers. These are detailed in Section 7.
+
+**IPU Subsystems** There are two Dual Cortex-M4 IPU subsystems in the
+device available for general purpose usage, particularly real-time
+control. Each IPU subsystem includes the following components:
+
+-  Two Cortex-M4 CPUs
+
+-  ARMv7E-M and Thumb-2 instruction set architectures
+
+-  Hardware division and single-cycle multiplication acceleration
+
+-  Dedicated INTC with up to 63 physical interrupt events with 16-level
+   priority
+
+-  Two-level memory subsystem hierarchy
+
+   -  L1 (32-KiB shared cache memory)
+
+   -  L2 ROM + RAM
+
+-  64-KiB RAM
+
+-  16-KiB bootable ROM
+
+-  MMU for address translation
+
+-  Integrated power management
+
+-  Emulation feature embedded in the Cortex-M4
+
+**IVA-HD Subsystem**
+
+-  IVA-HD subsystem with support for 4K @ 15fps H.264 encode/decode and
+   other codecs @ 1080p60 The IVA-HD subsystem is a set of video encoder
+   and decoder hardware accelerators. The list of supported codecs can
+   be found in the software development kit (SDK) documentation.
+
+**BB2D Graphics Accelerator Subsystem** The Vivante® GC320 2D graphics
+accelerator is the 2D BitBlt (BB2D) graphics accelerator subsystem on
+the device with the following features:
+
+-  API support:
+
+   -  OpenWF™, DirectFB
+
+   -  GDI/DirectDraw
+
+-  BB2D architecture:
+
+   -  BitBlt and StretchBlt
+
+   -  DirectFB hardware acceleration
+
+   -  ROP2, ROP3, ROP4 full alpha blending and transparency
+
+   -  Clipping rectangle support
+
+   -  Alpha blending includes Java 2 Porter-Duff compositing rules
+
+   -  90-, 180-, 270-degree rotation on every primitive
+
+   -  YUV-to-RGB color space conversion
+
+   -  Programmable display format conversion with 14 source and 7
+      destination formats
+
+   -  High-quality, 9-tap, 32-phase filter for image and video scaling
+      at 1080p
+
+   -  Monochrome expansion for text rendering
+
+   -  32K × 32K coordinate system
+
+**Dual-Core PowerVR® SGX544™ 3D GPU** The 3D graphics processing unit
+(GPU) subsystem is based on POWERVR® SGX544 subsystem from Imagination
+Technologies. It supports general embedded applications. The GPU can
+process different data types simultaneously, such as: pixel data, vertex
+data, video data, and general-purpose data. The GPU subsystem has the
+following features:
+
+-  Multicore GPU architecture: two SGX544 cores.
+
+-  Shared system level cache of 128 KiB
+
+-  Tile-based deferred rendering architecture
+
+-  Second-generation universal scalable shader engines (USSE2),
+   multithreaded engines incorporating pixel and vertex shader
+   functionality
+
+-  Present and texture load accelerators
+
+   -  Enables to move, rotate, twiddle, and scale texture surfaces.
+
+   -  Supports RGB, ARGB, YUV422, and YUV420 surface formats.
+
+   -  Supports bilinear upscale.
+
+   -  Supports source colorkey.
+
+-  Fine-grained task switching, load balancing, and power management
+
+-  Programmable high-quality image antialiasing
+
+-  Bilinear, trilinear, anisotropic texture filtering
+
+-  Advanced geometry DMA driven operation for minimum CPU interaction
+
+-  Fully virtualized memory addressing for OS operation in a unified
+   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
+of up to 533 MHz yielding an effective rate of 1066Mb/s on the DDR3L bus
+allowing for 4GB/s of DDR3L memory bandwidth.
+
+16GB Embedded MMC
+===================
+
+A single 16GB embedded MMC (eMMC) device is on the board.
+
+
+microSD Connector
+==================
+
+The board is equipped with a single microSD connector to act as a
+secondary boot source for the board and, if selected as such, can be the
+primary booth source. The connector will support larger capacity microSD
+cards. The microSD card is not provided with the board.
+
+Boot Modes
+*************
+
+Power Management
+******************
+
+Connectivity
+******************
+
+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
+***********************
+
++--------+--------+-----------------+
+| A      | Iden   | Description     |
+| ddress | tifier |                 |
++========+========+=================+
+| 0x12   | U3     | TPS6590379 PMIC |
+|        |        | DVS             |
++--------+--------+-----------------+
+| 0x41   | U78    | STMPE811Q ADC   |
+|        |        | and GPIO        |
+|        |        | expander        |
++--------+--------+-----------------+
+| 0x47   | U13    | HD3SS3220 USB   |
+|        |        | Type-C DRP port |
+|        |        | controller      |
++--------+--------+-----------------+
+| 0x50   | U9     | 24LC32 board ID |
+|        |        | EEPROM          |
++--------+--------+-----------------+
+| 0x58   | U3     | TPS6590379 PMIC |
+|        |        | power registers |
++--------+--------+-----------------+
+| 0x5a   | U3     | TPS6590379 PMIC |
+|        |        | interfaces and  |
+|        |        | auxilaries      |
++--------+--------+-----------------+
+| 0x5c   | U3     | TPS6590379 PMIC |
+|        |        | trimming and    |
+|        |        | test            |
++--------+--------+-----------------+
+| 0x5e   | U3     | TPS6590379 PMIC |
+|        |        | OTP             |
++--------+--------+-----------------+

boards/beaglebone/ai/ch08.rst

+.. _beaglebone-ai-cape-support:
+
+Cape Board Support
+#####################
+
+There is a `Cape Headers Google
+Spreadsheet <https://docs.google.com/spreadsheets/d/1fE-AsDZvJ-bBwzNBj1_sPDrutvEvsmARqFwvbw_HkrE/edit?usp=sharing>`__
+which has a lot of detail regarding various boards and cape add-on
+boards.
+
+See also https://elinux.org/Beagleboard:BeagleBone_cape_interface_spec
+
+TODO
+
+BeagleBone® Black Cape Compatibility
+**************************************
+
+TODO
+
+See https://elinux.org/Beagleboard:BeagleBone_cape_interface_spec for
+now.
+
+EEPROM
+************
+
+TODO
+
+Pin Usage Consideration
+************************
+
+TODO
+
+GPIO
+*********
+
+TODO
+
+I2C
+*********
+
+TODO
+
+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    |
++------------------+--------+-----------+-------------------+-------+
+
+
+TODO
+
+SPI
+****
+
+TODO
+
+Analog
+********
+
+TODO
+
+.. _pwm-timer-ecap-or-pru-pwm-ecap:
+
+PWM, TIMER, eCAP or PRU PWM/eCAP
+**********************************
+
+TODO
+
+eQEP
+******
+
+TODO
+
+CAN
+*****
+
+TODO
+
+.. _mcasp-audio-serial-like-i2c-and-ac97:
+
+McASP (audio serial like I2S and AC97)
+****************************************
+
+TODO
+
+MMC
+*****
+
+TODO
+
+LCD
+*****
+
+TODO
+
+PRU GPIO
+**********
+
+TODO
+
+CLKOUT
+********
+
+TODO
+
+Expansion Connector Headers
+******************************
+
+TODO: discuss header options for working with the expansion connectors
+per
+https://github.com/beagleboard/beaglebone-black/wiki/System-Reference-Manual#84-expansion-connectors
+
+Signal Usage
+****************
+
+TODO
+
+Cape Power
+************
+
+TODO
+
+Mechanical
+************
+
+TODO

boards/beaglebone/ai/ch09.rst

+.. _beaglebone-ai-mechanical:
+
+Mechanical Information
+########################
+
+-  Board Dimensions: 8.9cm x 5.4cm x 1.5cm
+
+-  Board Net Weight 48g
+
+-  Packaging Dimensions: 13.8cm x 10cm x 4cm
+
+-  Gross Weight (including packaging): 110g
+
+-  3D STEP model:
+   https://github.com/beagleboard/beaglebone-ai/tree/master/Mechanical
\ No newline at end of file

boards/beaglebone/ai/ch10.rst

+.. _beaglebone-ai-pictures:
+
+Pictures
+#########
+
+BeagleBone AI Back of Board Image
+
+
+.. image:: images/BB_AI_Front.jpg
+    :align: center
+
+.. image:: images/BB_AI_Back.jpg
+    :align: center
\ No newline at end of file

boards/beaglebone/ai/ch11.rst

+.. _beaglebone-ai-support:
+
+Support Information
+######################
+
+TODO: Reference https://beagleboard.org/support and
+https://beagleboard.org/resources
+
+Related TI documentation: http://www.ti.com/tool/BEAGLE-3P-BBONE-AI
\ No newline at end of file

boards/beaglebone/ai/ch12.rst

+.. _beaglebone-ai-terms-condition:
+
+Terms and Conditions
+#####################
+
+REGULATORY, COMPLIANCE, AND EXPORT INFORMATION
+*************************************************
+
+-  Country of origin: PRC
+-  FCC: 2ATUT-BBONE-AI
+-  CE: TBD
+-  CNHTS: 8543909000
+-  USHTS: 8473301180
+-  MXHTS: 84733001
+-  TARIC: 8473302000
+-  ECCN: 5A992.C
+-  CCATS:
+   `Z1613110/G180570 <https://github.com/beagleboard/beaglebone-ai/blob/master/regulatory/Validation_Z1613110.pdf>`__
+-  RoHS/REACH: TBD
+-  Volatility: TBD
+
+BeagleBone AI is annotated to comply with Part 15 of the FCC Rules.
+Operation is subject to the following two conditions: (1) This device
+may not cause harmful interference, and (2) this device must accept any
+interference received, including interference that may cause undesired
+operation. Changes or modifications not expressly approved by the party
+responsible for compliance could void the user’s authority to operate
+the equipment.
+
+This Class A or B digital apparatus complies with Canadian ICES-003.
+Changes or modifications not expressly approved by the party responsible
+for compliance could void the user’s authority to operate the equipment.
+Cet appareil numérique de la classe A ou B est conforme à la norme
+NMB-003 du Canada. Les changements ou les modifications pas expressément
+approuvés par la partie responsible de la conformité ont pu vider
+l’autorité de l’utilisateur pour actionner l’équipement.
+
+WARRANTY AND DISCLAIMERS
+****************************
+
+The design materials referred to in this document are *\*NOT
+SUPPORTED\** and **DO NOT** constitute a reference design. Support of
+the open source developer community is provided through the the
+resources defined at https://beagleboard.org/support.
+
+THERE IS NO WARRANTY FOR THE DESIGN MATERIALS, TO THE EXTENT PERMITTED
+BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE DESIGN MATERIALS “AS IS”
+WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
+BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
+PERFORMANCE OF THE DESIGN MATERIALS IS WITH YOU. SHOULD THE DESIGN
+MATERIALS PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
+SERVICING, REPAIR OR CORRECTION.
+
+This board was designed as an evaluation and development tool. It was
+not designed with any other application in mind. As such, the design
+materials that are provided which include schematic, BOM, and PCB files,
+may or may not be suitable for any other purposes. If used, the design
+material becomes your responsibility as to whether or not it meets your
+specific needs or your specific applications and may require changes to
+meet your requirements.
+
+Additional terms
+=================
+
+BeagleBoard.org Foundation and logo-licensed manufacturers (together,
+henceforth identified as "Supplier") provide BeagleBone AI under the
+following conditions:
+
+The user assumes all responsibility and liability for proper and safe
+handling of the goods. Further, the user indemnifies Supplier from all
+claims arising from the handling or use of the goods.
+
+Should BeagleBone AI not meet the specifications indicated in the System
+Reference Manual, BeagleBone AI may be returned within 90 days from the
+date of delivery to the distributor of purchase for a full refund. THE
+FOREGOING LIMITED WARRANTY IS THE EXCLUSIVE WARRANTY MADE BY SELLER TO
+BUYER AND IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESSED, IMPLIED, OR
+STATUTORY, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY
+PARTICULAR PURPOSE. EXCEPT TO THE EXTENT OF THE INDEMNITY SET FORTH
+ABOVE, NEITHER PARTY SHALL BE LIABLE TO THE OTHER FOR ANY INDIRECT,
+SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES.
+
+Please read the System Reference Manual and, specifically, the Warnings
+and Restrictions notice in the Systems Reference Manual prior to
+handling the product. This notice contains important safety information
+about temperatures and voltages.
+
+No license is granted under any patent right or other intellectual
+property right of Supplier covering or relating to any machine, process,
+or combination in which such Supplier products or services might be or
+are used. The Supplier currently deals with a variety of customers for
+products, and therefore our arrangement with the user is not exclusive.
+The Supplier assume no liability for applications assistance, customer
+product design, software performance, or infringement of patents or
+services described herein.
+
+Warnings and Restrictions
+******************************************
+
+For Feasibility Evaluation Only, in Laboratory/Development Environments
+========================================================================
+
+BeagleBone AI is not a complete product. It is intended solely for use
+for preliminary feasibility evaluation in laboratory/development
+environments by technically qualified electronics experts who are
+familiar with the dangers and application risks associated with handling
+electrical mechanical components, systems and subsystems. It should not
+be used as all or part of a finished end product.
+
+Your Sole Responsibility and Risk
+==========================================
+
+You acknowledge, represent, and agree that:
+
+1. You have unique knowledge concerning Federal, State and local
+   regulatory requirements (including but not limited to Food and Drug
+   Administration regulations, if applicable) which relate to your
+   products and which relate to your use (and/or that of your employees,
+   affiliates, contractors or designees) of BeagleBone AI for
+   evaluation, testing and other purposes.
+
+2. You have full and exclusive responsibility to assure the safety and
+   compliance of your products with all such laws and other applicable
+   regulatory requirements, and also to assure the safety of any
+   activities to be conducted by you and/or your employees, affiliates,
+   contractors or designees, using BeagleBone AI. Further, you are
+   responsible to assure that any interfaces (electronic and/or
+   mechanical) between BeagleBone AI and any human body are designed
+   with suitable isolation and means to safely limit accessible leakage
+   currents to minimize the risk of electrical shock hazard.
+
+3. Since BeagleBone AI is not a completed product, it may not meet all
+   applicable regulatory and safety compliance standards which may
+   normally be associated with similar items. You assume full
+   responsibility to determine and/or assure compliance with any such
+   standards and related certifications as may be applicable. You will
+   employ reasonable safeguards to ensure that your use of BeagleBone AI
+   will not result in any property damage, injury or death, even if
+   BeagleBone AI should fail to perform as described or expected.
+
+Certain Instructions
+======================
+
+It is important to operate BeagleBone AI within Supplier’s recommended
+specifications and environmental considerations per the user guidelines.
+Exceeding the specified BeagleBone AI ratings (including but not limited
+to input and output voltage, current, power, and environmental ranges)
+may cause property damage, personal injury or death. If there are
+questions concerning these ratings please contact the Supplier
+representative prior to connecting interface electronics including input
+power and intended loads. Any loads applied outside of the specified
+output range may result in unintended and/or inaccurate operation and/or
+possible permanent damage to BeagleBone AI and/or interface electronics.
+Please consult the System Reference Manual prior to connecting any load
+to BeagleBone AI output. If there is uncertainty as to the load
+specification, please contact the Supplier representative. During normal
+operation, some circuit components may have case temperatures greater
+than 60 C as long as the input and output are maintained at a normal
+ambient operating temperature. These components include but are not
+limited to linear regulators, switching transistors, pass transistors,
+and current sense resistors which can be identified using BeagleBone
+AI’s schematic located at the link in BeagleBone AI’s System Reference
+Manual. When placing measurement probes near these devices during normal
+operation, please be aware that these devices may be very warm to the
+touch. As with all electronic evaluation tools, only qualified personnel
+knowledgeable in electronic measurement and diagnostics normally found
+in development environments should use BeagleBone AI.
+
+Agreement to Defend, Indemnify and Hold Harmless
+=================================================
+
+You agree to defend, indemnify and hold Supplier, its licensors and
+their representatives harmless from and against any and all claims,
+damages, losses, expenses, costs and liabilities (collectively,
+"Claims") arising out of or in connection with any use of BeagleBone AI
+that is not in accordance with the terms of the agreement. This
+obligation shall apply whether Claims arise under law of tort or
+contract or any other legal theory, and even if BeagleBone AI fails to
+perform as described or expected.
+
+Safety-Critical or Life-Critical Applications
+===============================================
+
+If you intend to evaluate the components for possible use in safety
+critical applications (such as life support) where a failure of the
+Supplier’s product would reasonably be expected to cause severe personal
+injury or death, such as devices which are classified as FDA Class III
+or similar classification, then you must specifically notify Supplier of
+such intent and enter into a separate Assurance and Indemnity Agreement.
+