From e9cebcc2e5638ab190e9a540775590336355d1ef Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Fri, 1 Dec 2023 21:56:06 +0530
Subject: [PATCH] Update AI-64 chapters (v1.0 release)
---
boards/beaglebone/ai-64/01-introduction.rst | 132 +++++++++++++-----
boards/beaglebone/ai-64/02-quick-start.rst | 34 ++---
.../ai-64/03-design-and-specifications.rst | 4 +-
...ctors-and-pinouts.rst => 04-expansion.rst} | 28 +++-
boards/beaglebone/ai-64/06-support.rst | 2 +-
boards/beaglebone/ai-64/index.rst | 110 ++++++++++++++-
6 files changed, 253 insertions(+), 57 deletions(-)
rename boards/beaglebone/ai-64/{04-connectors-and-pinouts.rst => 04-expansion.rst} (99%)
diff --git a/boards/beaglebone/ai-64/01-introduction.rst b/boards/beaglebone/ai-64/01-introduction.rst
index bcda7f95..a8579697 100644
--- a/boards/beaglebone/ai-64/01-introduction.rst
+++ b/boards/beaglebone/ai-64/01-introduction.rst
@@ -18,9 +18,19 @@ their own board or add their own circuitry.
foundation for experimentation and learning how to program the processor and to access the
peripherals by the creation of your own software and hardware.
+.. table::
+ :align: center
+ :widths: auto
+ +----------------------------------------------------+---------------------------------------------------------+
+ | .. image:: media/front.* | .. image:: media/back.* |
+ | :width: 700 | :width: 700 |
+ | :align: center | :align: center |
+ | :alt: BeagleBone AI-64 front | :alt: BeagleBone AI-64 back |
+ +----------------------------------------------------+---------------------------------------------------------+
-.. _beaglebone-compatibility:
+
+.. _bbai64-beaglebone-compatibility:
BeagleBone Compatibility
-------------------------
@@ -67,7 +77,7 @@ much as possible. There are several significant differences between the three de
add cape compatibility details
-.. _beaglebone-ai-64-features-and-specificationd:
+.. _bbai64-features-and-specificationd:
BeagleBone AI-64 Features and Specification
---------------------------------------------
@@ -126,7 +136,7 @@ description of the major components and interfaces that make up the board.
+-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
-.. _board-component-locations:
+.. _bbai64-component-locations:
Board Component Locations
----------------------------
@@ -134,36 +144,94 @@ Board Component Locations
This section describes the key components on the board. It provides information on their location
and function. Familiarize yourself with the various components on the board.
-.. _board-components:
+.. _bbai64-components:
Board components
-----------------
-:ref:`board-components-figure` below shows the locations of the connectors, LEDs, and switches on the PCB layout of the board.
-
-.. _board-components-figure:
-
-.. figure:: media/ch04/components.*
- :width: 400px
- :align: center
-
- BeagleBone AI-64 board components
-
-* **DC Power** is the main DC input that accepts 5V power.
-* **Power Button** alerts the processor to initiate the power down sequence and is used to power down the board.
-* **GigaBit Ethernet** is the connection to the LAN.
-* **Serial Debug ports** WKUP_UART0 for early boot from the management MCU and UART0 is for the main processor.
-* **USB Client** is a USB-C connection to a PC that can also power the board.
-* **BOOT switch** can be used to force a boot from the microSD card if the power is cycled on the board, removing power and reapplying the power to the board.
-* There are five green **LEDs** that can be used by the user.
-* **Reset Button** allows the user to reset the processor.
-* **microSD** slot is where a microSD card can be installed.
-* **miniDP** connector is where the display is connected to.
-* **USB Host** can be connected different USB interfaces such as Wi-Fi, Bluetooth, Keyboard, etc.
-
-On bottom side we have,
-
-* **TI TDA4VM** processor.
-* **4GB LPDDR4** Dual Data Rate RAM memory.
-* **Ethernet PHY** physical interface to the network.
-* **eMMC** onboard MMC chip that holds up to 16GB of data.
+This section describes the key components on the board, their location and function.
+
+.. tabs::
+
+ .. group-tab:: Front components location
+
+ .. figure:: media/components/front.*
+ :width: 1240
+ :align: center
+ :alt: BeagleBone AI-64 board front components location
+
+ BeagleBone AI-64 board front components location
+
+
+ .. table:: BeagleBone AI-64 board front components location
+ :align: center
+
+ +----------------------------+---------------------------------------------------------------------------+
+ | Feature | Description |
+ +============================+===========================================================================+
+ | User & power LEDs | USR0 - USR4 user LEDs & Power (Board ON) LED indicator |
+ +----------------------------+---------------------------------------------------------------------------+
+ | UART debug ports | 3pin Wake-up domain and Main domain UART debug ports |
+ +----------------------------+---------------------------------------------------------------------------+
+ | USB C | Power, connectivity, and board flashing. |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Barrel jack | Power input (accepts 5V power) |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Mini-Display port | Output for Display/Monitor connection |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Dual USB-A | 5Gbps USB-A ports for peripherals (Wi-Fi, Bluetooth, Keyboard, etc) |
+ +----------------------------+---------------------------------------------------------------------------+
+ | GigaBit Ethernet | 1Gb/s Wired internet connectivity |
+ +----------------------------+---------------------------------------------------------------------------+
+ | mikroBUS Shuttle | 16pin mikroBUS Shuttle connector for interfacing mikroE click boards |
+ +----------------------------+---------------------------------------------------------------------------+
+ | P8 & P9 cape header | Expansion headers for BeagleBone capes. |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Reset button | Press to reset BeagleBone AI-64 board (TDA4VM SoC) |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Power button | Press to shut-down (OFF), hold down to boot (ON) |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Boot button | Boot selection button (force to boot from microSD if power is cycled) |
+ +----------------------------+---------------------------------------------------------------------------+
+ | M.2 Key E | PCIE M.2 Key E connector |
+ +----------------------------+---------------------------------------------------------------------------+
+
+ .. group-tab:: Back components location
+
+ .. figure:: media/components/back.*
+ :width: 1240
+ :align: center
+ :alt: BeagleBone AI-64 board back components location
+
+ BeagleBone AI-64 board back components location
+
+
+ .. table:: BeagleBone AI-64 board back components location
+ :align: center
+
+ +----------------------------+---------------------------------------------------------------------------+
+ | Feature | Description |
+ +============================+===========================================================================+
+ | microSD | Micro SD Card holder |
+ +----------------------------+---------------------------------------------------------------------------+
+ | JTAG debug port | Tag-Connect JTAG (TDA4Vm) debug port |
+ +----------------------------+---------------------------------------------------------------------------+
+ | Fan connector | PWM controllable 4pin fan connector |
+ +----------------------------+---------------------------------------------------------------------------+
+ | DP83867E | Ethernet PHY |
+ +----------------------------+---------------------------------------------------------------------------+
+ | TUSB8041 | USB 3.0 hub IC |
+ +----------------------------+---------------------------------------------------------------------------+
+ | TDA4VM | Dual Arm® Cortex®-A72 SoC and C7x DSP with deep-learning, vision and MMA |
+ +----------------------------+---------------------------------------------------------------------------+
+ | PMIC | Power management TPS65941213 (PMIC-A) & TPS65941111 (PMIC-B) |
+ +----------------------------+---------------------------------------------------------------------------+
+ | 16GB eMMC | Flash storage |
+ +----------------------------+---------------------------------------------------------------------------+
+ | 4GB RAM | 4GB LPDDR4 RAM |
+ +----------------------------+---------------------------------------------------------------------------+
+ | DSI | MIPI Display connector |
+ +----------------------------+---------------------------------------------------------------------------+
+ | CSI0 & CSI1 | MIPI Camera connectors |
+ +----------------------------+---------------------------------------------------------------------------+
+
\ No newline at end of file
diff --git a/boards/beaglebone/ai-64/02-quick-start.rst b/boards/beaglebone/ai-64/02-quick-start.rst
index f03f3d21..162a29a3 100644
--- a/boards/beaglebone/ai-64/02-quick-start.rst
+++ b/boards/beaglebone/ai-64/02-quick-start.rst
@@ -1,4 +1,4 @@
-.. _connecting-up-your-beaglebone-ai-64:
+.. _bbai64-quick-start:
Quick Start Guide
##################
@@ -16,7 +16,7 @@ All the :ref:`BeagleBone AI-64 connections ports` we will use in this chapter ar
.. _BeagleBone AI-64 connections ports:
.. figure:: media/ch03/ports.*
- :width: 400px
+ :width: 740px
:align: center
BeagleBone AI-64 connections ports
@@ -37,7 +37,7 @@ a developer experience where the board can be used immediately with no other equ
.. _bbai-64-pacakage:
.. figure:: media/ch03/bbai64-in-box.*
- :width: 400px
+ :width: 740px
:align: center
BeagleBone AI-64 box content
@@ -79,7 +79,7 @@ In this configuration, the board is powered by the PC via a single USB cable. Th
.. _tethered-figure:
.. figure:: media/ch03/usb-tethering.*
- :width: 400px
+ :width: 740px
:align: center
Tethered Configuration
@@ -100,7 +100,7 @@ Connect the Cable to the Board
.. _usb-c-connect-figure:
.. figure:: media/ch03/usb-c-connection.*
- :width: 400px
+ :width: 740px
:align: center
USB Connection to the Board
@@ -110,7 +110,7 @@ Connect the Cable to the Board
.. _usb-a-connect-figure:
.. figure:: media/ch03/usb-a-connection.*
- :width: 400px
+ :width: 740px
:align: center
USB Connection to the PC/Laptop
@@ -120,7 +120,7 @@ Connect the Cable to the Board
.. _power-led-figure:
.. figure:: media/ch03/power-led.*
- :width: 400px
+ :width: 740px
:align: center
Board Power LED
@@ -130,7 +130,7 @@ Connect the Cable to the Board
.. _boot-status-figure:
.. figure:: media/ch03/led-pattern.*
- :width: 400px
+ :width: 740px
:align: center
Board Boot Status
@@ -157,7 +157,7 @@ In this configuration, the board works more like a PC, totally free from any con
.. _desktop-config-figure:
.. figure:: media/ch03/desktop-configuration.*
- :width: 400px
+ :width: 740px
:align: center
Desktop Configuration
@@ -188,7 +188,7 @@ Connecting Up the Board
.. _display-cable-figure,miniDP-DP or active miniDP-HDMI cable connection figure:
.. figure:: media/ch03/monitor-cable.*
- :width: 400px
+ :width: 740px
:align: center
Connect miniDP-DP or active miniDP-HDMI cable to BeagleBone AI-64
@@ -198,7 +198,7 @@ Connecting Up the Board
.. _display-adapters-figure:
.. figure:: media/ch03/display-adapters.*
- :width: 400px
+ :width: 740px
:align: center
Display adapters
@@ -209,7 +209,7 @@ Connecting Up the Board
.. _keyboard-mouse-figure:
.. figure:: media/ch03/mouse-keyboard.*
- :width: 400px
+ :width: 740px
:align: center
Keyboard and Mouse
@@ -223,7 +223,7 @@ standard 100M Ethernet cable should work.
.. _ethernet-cable-figure:
.. figure:: media/ch03/ethernet-cable.*
- :width: 400px
+ :width: 740px
:align: center
Ethernet Cable Connection
@@ -234,7 +234,7 @@ standard 100M Ethernet cable should work.
.. _barrel-jack-figure:
.. figure:: media/ch03/barrel-jack.*
- :width: 400px
+ :width: 740px
:align: center
External DC Power
@@ -244,7 +244,7 @@ standard 100M Ethernet cable should work.
.. _miniDP-figure:
.. figure:: media/ch03/miniDP-connector.*
- :width: 400px
+ :width: 740px
:align: center
Connect miniDP to DP or active miniDP to HDMI Cable to the Board
@@ -258,7 +258,7 @@ As soon as the power is applied to the board, it will start the booting up proce
.. _LEDs-figure,BeagleBone AI-64 LEDs figure:
.. figure:: media/ch03/leds.*
- :width: 400px
+ :width: 740px
:align: center
BeagleBone AI-64 LEDs
@@ -282,7 +282,7 @@ meanings in the image that is shipped with the board once the Linux kernel has b
.. _figure-16:
.. figure:: media/ch03/xfce-desktop.*
- :width: 400px
+ :width: 740px
:align: center
BeagleBone XFCE Desktop Screen
diff --git a/boards/beaglebone/ai-64/03-design-and-specifications.rst b/boards/beaglebone/ai-64/03-design-and-specifications.rst
index 79f1a811..37ab0ed0 100644
--- a/boards/beaglebone/ai-64/03-design-and-specifications.rst
+++ b/boards/beaglebone/ai-64/03-design-and-specifications.rst
@@ -1,4 +1,4 @@
-.. _beaglebone-ai-64-design:
+.. _bbai64-design:
Design and Specifications
##########################
@@ -16,7 +16,7 @@ diagram of BeagleBone AI-64 board surrounding TDA4VM SoC.
.. _BeagleBone_AI-64-block-diagram:
.. figure:: media/ch05/board-block-diagram.*
- :width: 400px
+ :width: 740px
:align: center
BeagleBone AI-64 Key Components
diff --git a/boards/beaglebone/ai-64/04-connectors-and-pinouts.rst b/boards/beaglebone/ai-64/04-expansion.rst
similarity index 99%
rename from boards/beaglebone/ai-64/04-connectors-and-pinouts.rst
rename to boards/beaglebone/ai-64/04-expansion.rst
index ac6f742f..cfff04f2 100644
--- a/boards/beaglebone/ai-64/04-connectors-and-pinouts.rst
+++ b/boards/beaglebone/ai-64/04-expansion.rst
@@ -1,8 +1,34 @@
-.. _beaglebone-ai-64-expansion:
+.. _bbai64-expansion:
Expansion
############
+Pinout Diagrams
+***************
+
+Choose the cape header to see respective pinout diagram.
+
+.. tabs::
+
+ .. group-tab:: P8 cape header
+
+ .. figure:: media/pinout/BeagleBone-AI-64-P8.*
+ :align: center
+ :alt: BeagleBone AI-64 P8 cape header pinout
+
+ BeagleBone AI-64 P8 cape header pinout
+
+
+ .. group-tab:: P9 cape header
+
+ .. figure:: media/pinout/BeagleBone-AI-64-P9.*
+ :align: center
+ :alt: BeagleBone AI-64 P9 cape header pinout
+
+ BeagleBone AI-64 P9 cape header pinout
+
+.. _beaglebone-ai-64-connectors:
+
Cape Header Connectors
**********************
diff --git a/boards/beaglebone/ai-64/06-support.rst b/boards/beaglebone/ai-64/06-support.rst
index 15643d88..2e16c4ad 100644
--- a/boards/beaglebone/ai-64/06-support.rst
+++ b/boards/beaglebone/ai-64/06-support.rst
@@ -1,4 +1,4 @@
-.. _beaglebone-ai-64-support-information:
+.. _bbai64-support:
Additional Support Information
##############################
diff --git a/boards/beaglebone/ai-64/index.rst b/boards/beaglebone/ai-64/index.rst
index 6c85a3fd..9d229145 100644
--- a/boards/beaglebone/ai-64/index.rst
+++ b/boards/beaglebone/ai-64/index.rst
@@ -30,19 +30,121 @@ hardware examples and dozens of readily available embedded expansion options ava
* Design materials and license can be found in the `git repository <https://git.beagleboard.org/beagleboard/beaglebone-ai-64>`__
* Use of the boards or design materials constitutes an agreement to the :ref:`boards-terms-and-conditions`
* Software images and purchase links available on the `board page <https://www.beagleboard.org/boards/beaglebone-ai-64>`__
- * For export, emissions and other compliance, see :ref:`beaglebone-ai-64-support-information`
+ * For export, emissions and other compliance, see :ref:`bbai64-support`
.. image:: media/bbai64-45-front.jpg
- :width: 400px
+ :width: 740px
:align: center
- :alt: Fig: BeagleBone AI-64 front at 45° angle
+ :alt: BeagleBone AI-64 front at 45° angle
+
+.. only:: html
+
+ .. grid:: 1 1 2 3
+ :margin: 4 4 0 0
+ :gutter: 4
+
+ .. grid-item-card::
+ :link: bbai64-introduction
+ :link-type: ref
+
+ **1. Introduction**
+ ^^^
+
+ .. image:: media/chapter-thumbnails/01-introduction.*
+ :align: center
+ :alt: BeagleBone AI-64 Chapter01 thumbnail
+
+ +++
+
+ Introduction to BeagleBone AI-64 board with information on each component
+ location on both front and back of the board.
+
+ .. grid-item-card::
+ :link: bbai64-quick-start
+ :link-type: ref
+
+ **2. Quick start**
+ ^^^
+
+ .. image:: media/chapter-thumbnails/02-quick-start.*
+ :align: center
+ :alt: BeagleBone AI-64 Chapter02 thumbnail
+
+ +++
+
+ Getting started guide to enable you to start building your projects
+ in no time.
+
+ .. grid-item-card::
+ :link: bbai64-design
+ :link-type: ref
+
+ **3. Design & Specifications**
+ ^^^
+
+ .. image:: media/chapter-thumbnails/03-design-and-specifications.*
+ :align: center
+ :alt: BeagleBone AI-64 Chapter03 thumbnail
+
+ +++
+
+ Hardware and mechanical design and specifications of BeagleBone AI-64 board
+ for those who want to know their board inside and out.
+
+ .. grid-item-card::
+ :link: bbai64-expansion
+ :link-type: ref
+
+ **4. Expansion**
+ ^^^
+
+ .. image:: media/chapter-thumbnails/04-connectors-and-pinouts.*
+ :align: center
+ :alt: BeagleBone AI-64 Chapter04 thumbnail
+
+ +++
+
+ Connector pinout diagrams with expansion details so that you can
+ easily debug your connections and create custom expansion hardware.
+
+ .. grid-item-card::
+ :link: bbai64-demos-and-tutorials
+ :link-type: ref
+
+ **5. Demos**
+ ^^^
+
+ .. image:: media/chapter-thumbnails/05-demos-and-tutorials.*
+ :align: center
+ :alt: BeagleBone AI-64 Chapter5 thumbnail
+
+ +++
+
+ Demos and tutorials to quickly learn about BeagleBone AI-64 capabilities.
+
+ .. grid-item-card::
+ :link: bbai64-support
+ :link-type: ref
+
+ **6. Support**
+ ^^^
+
+ .. image:: media/chapter-thumbnails/06-support.*
+ :align: center
+ :alt: BeagleBone AI-64 Chapter6 thumbnail
+
+ +++
+
+ Additional supporting information, images, documents, change history and
+ hardware & software repositories including issue trackers.
.. toctree::
:maxdepth: 1
+ :hidden:
01-introduction
02-quick-start
03-design-and-specifications
- 04-connectors-and-pinouts
+ 04-expansion
05-demos-and-tutorials
06-support
--
GitLab