Restructure BeagleBone AI chapters

accessories/cables.rst

@@ -86,6 +86,8 @@ The default serial port settings for Beagles are:
     | Handshake    | None         |
     +--------------+--------------+
 
+.. _jst-sh-serial-cables:
+
 JST-SH serial cables
 ====================
 

boards/beaglebone/ai-64/01-introduction.rst

@@ -3,7 +3,7 @@
 Introduction
 ###############
 
-BeagleBone AI-64 like its predecessors :ref:`beaglebone-ai-home`, is designed to address the 
+BeagleBone AI-64 like its predecessors :ref:`bbai-home`, is designed to address the 
 open-source Community, early adopters, and anyone interested in a low cost 64-bit 
 Dual Arm® Cortex®-A72 processor based Single Board Computer (SBC). It also offers 
 access to many of the interfaces and allows for the use of add-on boards called 

boards/beaglebone/ai-64/06-support.rst

@@ -144,21 +144,21 @@ Weight: 192gm
 Silkscreen and Component Locations
 =====================================
 
-.. figure:: media/ch09/board-dimensions.*
+.. figure:: media/hardware-design/board-dimensions.*
    :width: 400px
    :align: center 
    :alt: Board Dimensions
    
    Board Dimensions
 
-.. figure:: media/ch09/top-silkscreen.*
+.. figure:: media/hardware-design/top-silkscreen.*
    :width: 400px
    :align: center 
    :alt: Top silkscreen
    
    Top silkscreen
 
-.. figure:: media/ch09/bottom-silkscreen.*
+.. figure:: media/hardware-design/bottom-silkscreen.*
    :width: 400px
    :align: center 
    :alt: Bottom silkscreen

boards/beaglebone/ai/01-introduction.rst

@@ -18,193 +18,78 @@ everyday automation in industrial, commercial and home applications.
    :align: center
    :alt: BeagleBone AI Beauty Angle
 
-What’s In the Box
-*****************
+.. _beaglebone-ai-overview:
 
-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 Overview
+======================
 
--  BeagleBone® AI
--  Quick Start Guide
-
-TODO: Add links to the design materials for both
-
-.. image:: media/BB_AI_antenna_heat_sink_place_500px.jpg
+.. image:: media/BB_AI_overview_image.*
    :align: center
    :alt: BeagleBone AI Overview
 
-What’s Not in the Box
-**********************
-
-You will need to purchase:
+BeagleBone® AI Features
+************************
 
--  USB C cable or USB C to USB A cable
--  MicroSD Card (optional)
--  `Serial cable <https://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#serial-cable>`_ (optional)
+Main Processor Features of the AM5729 Within BeagleBone® AI
+============================================================
 
-More information or to purchase a replacement heat sink or antenna, please go to these websites:
+-  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
 
--  `Antenna <https://bit.ly/2kmXAzF>`_
--  `Heat Sink <https://bit.ly/2klxxJa>`_
+Communications
+===============
 
-Fans
-*****
+-  BeagleBone Black header and mechanical compatibility
+-  16-bit LCD interfaces
+-  4+ UARTs
+-  2 I2C ports
+-  2 SPI ports
+-  Lots of PRU I/O pins
 
-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.
+Memory
+=======
 
-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://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#fans>`_.
+-  1GB DDR3L
+-  16GB on-board eMMC flash
 
-.. caution::
+Connectors
+===========
 
-   BeagleBone AI can run **HOT**! Even without running the accelerators,
-   getting up to 70C is not uncommon.
+-  USB Type-C connector for power and SuperSpeed dual-role controller
+-  Gigabit Ethernet
+-  802.11ac 2.4/5GHz WiFi via the AzureWave AW-CM256SM
 
-Official BeagleBone Fan Cape:
-https://www.newark.com/element14/6100310/beaglebone-ai-fan-cape/dp/50AH3704
+Out of Box Software
+====================
 
-TODO: create short-links for any long URLs so that text works.
+-  Zero-download out of box software environment
 
-Main Connection Scenarios
+Board Component Locations
 **************************
 
-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:: media/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:: media/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:: media/BB_AI_PlugIn_500px.jpg
-   :align: center
-   :alt: connecting to PC
-
-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:: media/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:: media/BB_AI_starthtm_500px.png
-   :align: center
-   :alt: BeagleBone drive 
-
-.. image:: media/BB_AI_connectedscreen_500px.jpg
-   :align: center
-   :alt: Getting started
-
-8.  Follow the instructions in the browser window.
-
-.. image:: media/vscode.png
+.. image:: media/BB_AI_ICPlacement_800px.png
+   :width: 740
    :align: center
-   :alt: BeagleBone instructions
-
-9.  Go to Visual Studio Code IDE.
-
-
-Standalone w/Display and Keyboard/Mouse
-****************************************
-
-.. image:: media/BB_AI_Standalone_setup_750px.jpg
-   :align: center
-   :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
-
-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://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#serial-cable
-
-Locate the 3 PIN debug header on BeagleBone® AI, near the USB C connection.
-
-.. image:: media/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:
+   :alt: beaglebone ai component placement
 
-- 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:: media/BB_AI_Connectorplacement_800px.png
+    :width: 740
+    :align: center
+    :alt: Connector placement front
 
-.. image:: media/BB_AI_3pincableattach_500px.jpg
+.. image:: media/BB_AI_Connectorplacement_back_800px.png
+   :width: 740   
    :align: center
-   :alt: BeagleBone AI Overview
+   :alt: Connector placement back
\ No newline at end of file

boards/beaglebone/ai/02-quick-start.rst

 .. _bbai-quick-start:
 
 Quick start
-###########
+###########
\ No newline at end of file
+
+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 <https://openbeagle.org/beagleboard/beaglebone-ai>`_
+-  Quick Start Guide
+
+.. image:: media/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:
+
+-  USB C cable or USB C to USB A cable
+-  MicroSD Card (optional)
+-  :ref:`Serial cable <jst-sh-serial-cables>` (optional)
+
+More information or to purchase a replacement heat sink or antenna, please go to these websites:
+
+-  `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://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/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>`_
+
+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://old.beagleboard.org/upgrade
+
+-  Tethered to a PC via USB C cable
+-  Standalone Desktop with powered USB hub, display, keyboard and mouse
+-  Wireless Connection to BeagleBone® AI
+
+.. tabs:: 
+
+    .. group-tab:: Tethered
+
+      **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:: media/BB_AI_USBC_and_3pin_500px.png
+         :width: 740
+         :align: center
+         :alt: USB connector and serial debug.
+
+      2.  Connect a USB type-C cable to BeagleBone® AI USB type-C port.
+
+      .. image:: media/BB_AI_connectingUSBC_500px.jpg
+         :width: 740
+         :align: center
+         :alt: Connecting serial cable.
+
+      3.  Connect the other end of the USB cable to the PC USB 3 port.
+
+      .. image:: media/BB_AI_PlugIn_500px.jpg
+         :width: 740
+         :align: center
+         :alt: connecting to PC
+
+      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:: media/BB_AI_asadrive_500px.jpg
+         :width: 740
+         :align: center
+         :alt: BeagleBone storage drive options
+
+      7.  Open the drive and open START.HTM with your web browser.
+
+      .. image:: media/BB_AI_starthtm_500px.png
+         :width: 740
+         :align: center
+         :alt: BeagleBone drive 
+
+      .. image:: media/BB_AI_connectedscreen_500px.jpg
+         :width: 740
+         :align: center
+         :alt: Getting started
+
+      8.  Follow the instructions in the browser window.
+
+      .. image:: media/vscode.png
+         :width: 740
+         :align: center
+         :alt: BeagleBone instructions
+
+      9.  Go to Visual Studio Code IDE.
+
+    .. group-tab:: Standalone
+
+      **Standalone w/Display and Keyboard/Mouse**
+
+      .. image:: media/BB_AI_Standalone_setup_750px.jpg
+         :width: 740
+         :align: center
+         :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
+
+      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
+
+    .. group-tab:: Wireless
+
+      **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://git.beagleboard.org/beagleboard/beaglebone-ai/-/wikis/Frequently-Asked-Questions#serial-cable
+
+Locate the 3 PIN debug header on BeagleBone® AI, near the USB C connection.
+
+.. image:: media/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:
+
+- 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:: media/BB_AI_3pincableattach_500px.jpg
+   :align: center
+   :alt: BeagleBone AI Overview
\ No newline at end of file

boards/beaglebone/ai/03-design-and-specifications.rst

@@ -12,10 +12,310 @@ those who may be concerned, this is the same figure found in section 5.
 It is placed here again for convenience so it is closer to the topics to
 follow.
 
+Block Diagram
+**************
+
+The figure below is the high level block diagram of BeagleBone® AI. For
+detailed layout information please check the schematics.
+
 .. image:: media/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
+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:: media/BB_AI_AM5729_blockdiagram.jpg
+   :align: center
+   :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:: media/BB_AI_EVEmodule.jpg
+   :align: center
+   :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
+********
+
+.. _bbai_ddr:
+
+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
+*************
+
+.. todo:: Need info on BBAI boot mode settings
+
+Power Management
+******************
+
+.. todo:: Need info on BBAI 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.
+
+.. table:: On-board I2C Devices
+
+   +---------+--------------+-----------------+
+   | Address | Identifier   | Description     |
+   +=========+==============+=================+
+   | 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  |
+   |         |              | auxiliaries     |
+   +---------+--------------+-----------------+
+   | 0x5c    | U3           | TPS6590379 PMIC |
+   |         |              | trimming and    |
+   |         |              | test            |
+   +---------+--------------+-----------------+
+   | 0x5e    | U3           | TPS6590379 PMIC |
+   |         |              | OTP             |
+   +---------+--------------+-----------------+
+
 Power Section
 **************
 

boards/beaglebone/ai/04-expansion.rst

@@ -3,385 +3,7 @@
 Expansion
 #########
 
-.. _beaglebone-ai-overview:
 
-BeagleBone AI Overview
-======================
-
-.. image:: media/BB_AI_overview_image.*
-   :align: center
-   :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:: media/BB_AI_ICPlacement_800px.png
-   :align: center
-   :alt: beaglebone ai component placement
-
-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:: media/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
-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:: media/BB_AI_AM5729_blockdiagram.jpg
-   :align: center
-   :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:: media/BB_AI_EVEmodule.jpg
-   :align: center
-   :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
-********
-
-.. _bbai_ddr:
-
-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
-*************
-
-.. todo:: Need info on BBAI boot mode settings
-
-Power Management
-******************
-
-.. todo:: Need info on BBAI 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.
-
-.. table:: On-board I2C Devices
-
-   +---------+--------------+-----------------+
-   | Address | Identifier   | Description     |
-   +=========+==============+=================+
-   | 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  |
-   |         |              | auxiliaries     |
-   +---------+--------------+-----------------+
-   | 0x5c    | U3           | TPS6590379 PMIC |
-   |         |              | trimming and    |
-   |         |              | test            |
-   +---------+--------------+-----------------+
-   | 0x5e    | U3           | TPS6590379 PMIC |
-   |         |              | OTP             |
-   +---------+--------------+-----------------+
-
-Connectors
-############
-
-.. image:: media/BB_AI_Connectorplacement_800px.png
-    :align: center
-
-.. image:: media/BB_AI_Connectorplacement_back_800px.png
-    :align: center
 
 Expansion Connectors
 **********************