boards/beaglebone/ai-64/ch02.rst

-.. _Change-history:
-
-Change History
-###################
-
-This section describes the change history of this document and board. Document changes are not always a result of a board change. A board change will always result in a document change.
-
-.. _document-change-history:
-
-Document Change History
------------------------------------------
-
-This table seeks to keep track of major revision cycles in the documentation. Moving forward, we'll seek to align these version numbers across all of the various documentation.
-
-.. _change-history-table, Change History:
-
-.. list-table:: Table 1: Change History
-   :header-rows: 1
-
-   * - Rev
-     - Changes
-     - Date
-     - By
-   * - 0.0.1
-     - AI-64 initial prototype
-     - September 2021
-     - James Anderson
-   * - 0.0.2 
-     - AI-64 final prototype 
-     - December 2021  
-     - James Anderson
-   * - 0.0.3 
-     - AI-64 initial production release 
-     - June 9, 2022   
-     - Deepak Khatri and Jason Kridner
-
-.. _board-changes:
-
-Board Changes
-------------------
-
-Be sure to check the board revision history in the schematic file in the `BeagleBone AI-64 git repository <https://git.beagleboard.org/beagleboard/beaglebone-ai-64>`_ . Also check the `issues list <https://git.beagleboard.org/beagleboard/beaglebone-ai-64/-/issues>`_ .
-
-.. _rev-B:
-
-Rev B
-*********
-We are starting with revision B based on this being an update to the BeagleBone Black AI. However, because this board ended up being so different, we've decided to name it BeagleBone AI-64, rather than simply a new revision. This refers to the Seeed release on 21 Dec 2021 of "BeagleBone AI-64_SCH_Rev B_211221". This is the initial production release.
-

boards/beaglebone/ai-64/ch03.rst

-.. _connecting-up-your-beaglebone-ai-64:
-
-Connecting up your BeagleBone AI-64
-#####################################
-
-This section provides instructions on how to hook up your board. This beagle requires a 5V > 3A power supply to work properly via either USB Type-C power adapter or a barrel jack power adapter. 
-
-Recommended adapters:
-
-* 5V @ 3A `USB C power supply <https://www.digikey.com/en/products/detail/raspberry-pi/RPI-USB-C-power-supply-White-US/10258760>`_ adapter for SBCs.
-* 5V > 3A laptop/mobile adapter with USB-C cable.
-
-All the :ref:`BeagleBone AI-64 connections ports` we will use in this chapter are shown in the figure below.
-
-.. _BeagleBone AI-64 connections ports:
-
-.. figure:: images/ch03/ports.jpg
-   :width: 400px
-   :align: center 
-   :alt: BeagleBone AI-64 connections ports
-
-   Fig 3.1 BeagleBone AI-64 connections ports
-
-Methods of operation
---------------------------
-
-1.  Tethered to a PC
-2.  Standalone development platform in a PC configurtion using external peripherals
-
-.. _whats-in-the-box:
-
-What’s In the Box
----------------------------
-
-In the box you will find three main items as shown in :ref:`bbai-64-pacakage`.
-
-* BeagleBone AI-64.
-* Instruction card.
-
-A USB-C to USB-C cable is not included bot recommended for the tethered scenario and creates an out of box experience where the board can be used immediately with no other equipment needed.
-
-.. _bbai-64-pacakage:
-
-.. figure:: images/ch03/bbai64-in-box.jpg
-   :width: 400px
-   :align: center 
-   :alt: BeagleBone AI-64 box content
-
-   Fig: BeagleBone AI-64 box content
- 
-
-.. _main-connection-scenarios:
-
-Main Connection Scenarios
--------------------------------
-
-This section describes how to connect and power the board and serves as a slightly more detailed description of the Quick Start Guide included in the box. 
-
-The board can be configured in several different ways, but we will discuss the two most common scenarios.
-
-* Tethered to a PC via the USB cable 
-  
-  * ``Board is accessed as a storage drive and virtual Ethernet connection.``
-  
-* Standalone Desktop 
-  
-  * ``Display``
-  * ``Keyboard and Mouse``
-  * ``External 5V > 3A power supply``
-
-Each of these configurations is discussed in general terms in the following sections.
-
-.. _tethered-to-a-pc:
-
-Tethered To A PC
--------------------------
-
-In this configuration, the board is powered by the PC via a single USB cable. The board is accessed either as a USB storage drive or via the browser on the conected PC. You need to use either Firefox or Chrome on the PC, Internet Explorer will not work properly. 
-
-.. _tethered-figure:
-
-.. figure:: images/ch03/usb-tethering.jpg
-   :width: 400px
-   :align: center 
-   :alt: Tethered Configuration
-
-   Fig: Tethered Configuration
-
-At least 5V @ 3A is required to power the board, In most cases the PC may not be able to supply sufficient power for the board unless the connection is made over a Type-C to Type-C cable. You should always use an external 5V > 3A DC power supply connected to the barrel jack if you are unsure that the system can provide the required power or are otherwise using a USB-A to Type-C cable which will always require power from the DC barrel jack.
-
-.. _connect-the-cable-to-the-board:
-
-Connect the Cable to the Board
-*************************************
-
-1. Connect the type C USB cable to the board as shown in :ref:`usb-c-connect-figure`. The connector is on the top side of the board near barrel jack.
-
-.. _usb-c-connect-figure:
-
-.. figure:: images/ch03/usb-c-connection.jpg
-   :width: 400px
-   :align: center 
-   :alt: USB Connection to the Board
-
-   Fig: USB Connection to the Board
-
-2.  Connect the USB-A end of the cable to your PC or laptop USB port as shown in the :ref:`usb-a-connect-figure` below.
-
-.. _usb-a-connect-figure,USB Connection to the PC/Laptop figure:
-
-.. figure:: images/ch03/usb-a-connection.jpg
-   :width: 400px
-   :align: center 
-   :alt: USB Connection to the PC/Laptop
-
-   Fig: USB Connection to the PC/Laptop
-
-3.  The board will power on and the power LED will be on as shown in :ref:`power-led-figure` below.
-
-.. _power-led-figure:
-
-.. figure:: images/ch03/power-led.jpg
-   :width: 400px
-   :align: center 
-   :alt: Board Power LED
-
-   Fig: Board Power LED
-
-4. When the board starts to the booting process started by the process of applying power, the LEDs will come on in sequence as shown in :ref:`boot-status-figure` below. It will take a few seconds for the status LEDs to come on, so be patient. The LEDs will be flashing in an erratic manner as it begins to boot the Linux kernel.
-
-.. _boot-status-figure,Board Boot Status figure:
-
-.. figure:: images/ch03/led-pattern.jpg
-   :width: 400px
-   :align: center 
-   :alt: Board Boot Status
-
-   Fig: Board Boot Status
-
-
-.. _accessing-the-board-as-a-storage-drive:
-
-Accessing the Board as a Storage Drive
-***********************************************
-
-The board will appear around a USB Storage drive on your PC after thekernel has booted, which will take a round 10 seconds. The kernel on the board needs to boot before the port gets enumerated. Once the board appears as a storage drive, do the following:
-
-1.  Open the USB Drive folder.
-2.  Click on the file named **start.htm**
-3.  The file will be opened by your browser on the PC and you should get a display showing the Quick Start Guide.
-4.  Your board is now operational! Follow the instructions on your PC screen.
-
-.. _standalone-wdisplay-and-keyboardmouse:
-
-Standalone w/Display and Keyboard/Mouse
------------------------------------------------
-
-In this configuration, the board works more like a PC, totally free from any connection to a PC as shown in :ref:`desktop-config-figure`. It allows you to create your code to make the board do whatever you need it to do. It will however require certain common PC accessories. These accessories and instructions are described in the following section.
-
-.. _desktop-config-figure,Desktop Configuration figure:
-
-.. figure:: images/ch03/desktop-configuration.jpg
-   :width: 400px
-   :align: center 
-   :alt: Desktop Configuration
-
-   Fig: Desktop Configuration
-
-
-Ethernet cable and M.2 WiFi + Bluetooth card are optional. They can be used if network access required.
-
-.. _required-accessories:
-
-Required Accessories
-***************************
-
-In order to use the board in this configuration, you will need the following accessories:
-
-* 5V > 3A power supply.
-* Display Port or HDMI monitor.
-* miniDP-DP or active miniDP-HDMI cable (or a recommended **miniDP-DP or active miniDP-HDMI adapter** https://www.amazon.com/dp/B089GF8M87 has been tested and worked beautifully).
-* USB wired/wireless keyboard and mouse.
-* powered USB HUB (OPTIONAL). The board has only two USB Type-A host ports, so you may need to use a powered USB Hub if you wish to add additional USB devices, such as a USB WiFi adapter.
-* M.2 Bluetooth & WiFi module (OPTIONAL). For wireless connections, a USB WiFi adapter or a recommended M.2 WiFi module can provide wireless networking.
-
-.. _connecting-up-the-board:
-
-Connecting Up the Board
-******************************
-
-1. Connect the miniDP to DP or active miniDP to HDMI cable from your BeagleBone AI-64 to your monitor.
-
-.. _display-cable-figure,miniDP-DP or active miniDP-HDMI cable connection figure:
-
-.. figure:: images/ch03/monitor-cable.jpg
-   :width: 400px
-   :align: center 
-   :alt: Connect miniDP-DP or active miniDP-HDMI cable to BeagleBone AI-64
-
-   Fig: Connect miniDP-DP or active miniDP-HDMI cable to BeagleBone AI-64
-
-2. If you have an Display Port or HDMI monitor with HDMI-HDMI or DP-DP cable you can use adapters as shown in. :ref:`display-adapters-figure`.
-
-.. _display-adapters-figure:
-
-.. figure:: images/ch03/display-adapters.jpg
-   :width: 400px
-   :align: center 
-   :alt: Display adapters
-
-   Fig: Display adapters
-
-3. If you have wired/wireless USB keyboard and mouse such as 
-   
-   seen in :ref:`keyboard-mouse-figure` below, you need to plug the receiver in the USB host port of the board as shown in :ref:`keyboard-mouse-figure`.
-
-
-.. _keyboard-mouse-figure:
-
-.. figure:: images/ch03/mouse-keyboard.jpg
-   :width: 400px
-   :align: center 
-   :alt: Keyboard and Mouse
-
-   FigKeyboard and Mouse
-
-4. Connect the Ethernet Cable
-
-If you decide you want to connect to your local area network, an Ethernet cable can be used. Connect the Ethernet Cable to the Ethernet port as shown in :ref:`ethernet-cable-figure`. Any standard 100M Ethernet cable should work.
-
-.. _ethernet-cable-figure:
-
-.. figure:: images/ch03/ethernet-cable.jpg
-   :width: 400px
-   :align: center 
-   :alt: Ethernet Cable Connection
-
-   Fig: Ethernet Cable Connection
-
-
-5. The final step is to plug in the DC power supply to the DC power jack as shown in :ref:`barrel-jack-figure` below.
-
-.. _barrel-jack-figure,External DC Power figure:
-
-.. figure:: images/ch03/barrel-jack.jpg
-   :width: 400px
-   :align: center 
-   :alt: External DC Power
-
-   Fig: External DC Power
-
-6. The cable needed to connect to your display is a miniDP-DP or active miniDP-HDMI. Connect the miniDP connector end to the board at this time. The connector is on the top side of the board as shown in :ref:`miniDP-figure` below.
-
-.. _miniDP-figure,miniDP to DP or active miniDP to HDMI connection figure:
-
-.. figure:: images/ch03/miniDP-connector.jpg
-   :width: 400px
-   :align: center 
-   :alt: Connect miniDP to DP or active miniDP to HDMI Cable to the Board
-
-   Fig: Connect miniDP to DP or active miniDP to HDMI Cable to the Board
-
-The connector is fairly robust, but we suggest that you not use the cable as a leash for your Beagle. Take proper care not to put too much stress on the connector or cable.
-
-7. Booting the Board
-
-As soon as the power is applied to the board, it will start the booting up process. When the board starts to boot the LEDs will come on. It will take a few seconds for the status LEDs to come on, so be patient. The LEDs will be flashing in an erratic manner as it boots the Linux kernel.
-
-.. _LEDs-figure,BeagleBone AI-64 LEDs figure:
-
-.. figure:: images/ch03/leds.jpg
-   :width: 400px
-   :align: center 
-   :alt: BeagleBone AI-64 LEDs
-
-   Fig: BeagleBone AI-64 LEDs
-
-While the four user LEDS can be over written and used as desired, they do have specific meanings in the image that is shipped with the board once the Linux kernel has booted.
-
-* **USR0** is the heartbeat indicator from the Linux kernel.
-* **USR1** turns on when the microSD card is being accessed
-* **USR2** is an activity indicator. It turns on when the kernel is not in the idle loop.
-* **USR3** turns on when the onboard eMMC is being accessed.
-* **USR4** is an activity indicator for WiFi.
-
-8. A Booted System
-   
-   a. The board will have a mouse pointer appear on the screen as it enters the Linux boot step. You may have to move the physical mouse to get the mouse pointer to appear. The system can come up in the suspend mode with the monitor in a sleep mode.
-   b. After a minute or two a login screen will appear. You do not have to do anything at this point.
-   c. After a minute or two the desktop will appear. It should be similar to the one shown in :ref:`figure-16`. HOWEVER, it will change from one release to the next, so do not expect your system to look exactly like the one in the figure, but it will be very similar.
-   d. And at this point you are ready to go! :ref:`figure-16` shows the desktop after booting.
-
-.. _figure-16:
-
-.. figure:: images/ch03/xfce-desktop.jpg
-   :width: 400px
-   :align: center 
-   :alt: BeagleBone XFCE Desktop Screen
-
-   Fig: BeagleBone XFCE Desktop Screen
-

boards/beaglebone/ai-64/ch04.rst

-.. _beaglebone-ai-64-overviewd:
-
-BeagleBone AI-64 Overview
-###############################
-
-BeagleBone AI-64 is the latest addition to BeagleBoard.org family and like its predecessors, 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 has been equipped with a minimum set of features to allow the user to
-experience the power of the processor and is not intended as a full
-development platform as many of the features and interfaces supplied by
-the processor are not accessible from BeagleBone AI-64 via onboard
-support of some interfaces. It is not a complete product designed to do
-any particular function. It is a foundation for experimentation and
-learning how to program the processor and to access the peripherals by
-the creation of your own software and hardware.
-
-It also offers access to many of the interfaces and allows for the use
-of add-on boards called capes, to add many different combinations of
-features. A user may also develop their own board or add their own
-circuitry.
-
-BeagleBone AI-64 is manufactured and warranted by partners listed at https://beagleboard.org/logo for the benefit of the community and its supporters including the current BeagleBoard.org Foundation board members
-
-* Jason Kridner, principal of JK Embedded Consulting an independent contractor and architect for new Beagle designs.
-* Drew Fustini, independent Linux developer
-* Robert Nelson, applications engineer at Digi-Key
-* Mark Yoder, professor at Rose-Hulman Institute of Technology
-* Kathy Giori, product engineer at ZEDEDA
-
-See `bbb.io/about <https://beagleboard.org/about>`_
-
-BeagleBone AI-64 has been designed by Seeed Studio (Seeed Development Limited) under guidance from BeagleBoard.org Foundation.
-
-.. _beaglebone-compatibilityd:
-
-BeagleBone Compatibility
---------------------------------
-
-The board is intended to provide functionality well beyond BeagleBone Black or BeagleBone AI, while still providing compatibility with BeagleBone Black's expansion headers as 
-much as possible. There are several significant differences between the three designs. 
-
-.. _beaglebone-comparison-table, BeagleBone Comparisond:
-
-.. list-table:: Table: BeagleBone Compatibility
-   :header-rows: 1
-
-   * - Feature 
-     - AI-64 
-     - AI 
-     - Black
-   * - SoC 
-     - TDA4VM 
-     - AM5729 
-     - AM3358
-   * - Arm CPU 
-     - Cortex-A72 (64-bit) 
-     - Cortex-A15 (32-bit) 
-     - Cortex-A8 (32-bit)
-   * - Arm cores/MHz 
-     - 2x 2GHz 
-     - 2x 1.5GHz 
-     - 1x 1GHz
-   * - RAM 
-     - 4GB 
-     - 1GB  
-     - 512MB
-   * - eMMC flash 
-     - 16GB 
-     - 16GB 
-     - 4GB
-   * - Size 
-     - 4" x 3.1" 
-     - 3.4" x 2.1" 
-     - .4" x 2.1"
-   * - Display 
-     - miniDP + DSI 
-     - microHDMI 
-     - microHDMI
-   * - USB host (Type-A) 
-     - 2x 5Gbps 
-     - 1x 480Mbps 
-     - 1x 480Mbps
-   * - USB dual-role 
-     - Type-C 5Gbps 
-     - Type-C 5Gbps 
-     - mini-AB 480Mbps
-   * - Ethernet 
-     - 10/100/1000M 
-     - 10/100/1000M 
-     - 10/100M
-   * - M.2 
-     - E-key 
-     - `-`
-     - `-`
-   * - WiFi/ Bluetooth 
-     - `-` 
-     - AzureWave AW&#8209;CM256SM 
-     - `-`
-
-.. note ::
-
-   TODO: add cape compatibility details
-
-
-.. _beaglebone-ai-64-features-and-specificationd:
-
-BeagleBone AI-64 Features and Specification
------------------------------------------------
-
-This section covers the specifications and features of the board and provides a high level description of the major components and interfaces that make up the board.
-
-.. _ai64-features,BeagleBone AI-64 features tabled:
-
-.. list-table:: Table: BeagleBone AI-64 Features and Specification
-   :header-rows: 1
-
-   * - 
-     - Feature
-   * - **Processor**
-     - Texas Instruments TDA4VM
-   * - **Graphics Engine**  
-     - PowerVR® Series8XE GE8430
-   * - **SDRAM Memory**   
-     - LPDDR4 3.2GHz (4GB) Kingston Q3222PM1WDGTK-U
-   * - **Onboard Flash**   
-     - eMMC (16GB) Kingston EMMC16G-TB29-PZ90
-   * - **PMIC**  
-     - TPS65941213 and TPS65941111 PMICs regulator and one additional LDO.
-   * - **Debug Support**   
-     - 2x 3 pin 3.3V TTL header  
-        1. WKUP_UART0: Wake-up domain serial port 
-        2. UART0: Main domain serial port
-      
-       10-pin JTAG TAG-CONNECT footprint
-   * - **Power Source**    
-     - USB C or DC Jack (5V, >3A)
-   * - **PCB**  
-     - 4” x 3.1”
-   * - **Indicators**  
-     - 1-Power, 5-User Controllable LEDs
-   * - **USB-3.0 Client Port**  
-     - Access to USB0, SuperSpeed, dual-role mode via USB-C (no power output)
-   * - **USB-3.0 Host Port** 
-     - TUSB8041 4-port SuperSpeed hub on USB1, 2xType A Socket, up-to 2.8A total, depending on power input
-   * - **Ethernet**   
-     - Gigabit, RJ45, link indicator, speed indicator
-   * - **SD/MMC Connector**   
-     - microSD , 1.8/3.3V
-   * - **User Input**
-     - 
-        1. Reset Button 
-        2. Boot Button 
-        3. Power Button
-   * - **Video Out**  
-     - miniDP
-   * - **Audio**    
-     - via miniDP (stereo)
-   * - **Weight**   
-     - 192gm (with heatsink)
-   * - **Power**  
-     - Refer to :ref:`main-board-power` section
-
-.. _board-component-locations:
-
-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:
-
-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:: images/ch04/components.png
-   :width: 400px
-   :align: center 
-   :alt: BeagleBone AI-64 board components
-
-   Fig: 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.

boards/beaglebone/ai-64/ch09.rst

-.. _section-9,Section 9.0 BeagleBone AI-64 Mechanical:
-
-BeagleBone AI-64 Mechanical
-#############################
-
-.. _dimensions-and-weight:
-
-Dimensions and Weight
-------------------------------------
-
-Size: 102.5 x 80 (4" x 3.15")
-
-Max height: #TODO#
-
-PCB Layers: #TODO#
-
-PCB thickness: 2mm (0.08")
-
-RoHS Compliant: Yes
-
-Weight: 192gm
-
-.. _silkscreen-and-component-locations:
-
-Silkscreen and Component Locations
-------------------------------------
-
-.. figure:: images/ch09/board-dimensions.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: Board Dimensions
-
-   Fig: Board Dimensions
-
-.. figure:: images/ch09/top-silkscreen.png
-   :width: 400px
-   :align: center 
-   :alt: Fig: Top silkscreen
-
-   Fig: Top silkscreen
-
-.. figure:: images/ch09/bottom-silkscreen.png
-   :width: 400px
-   :align: center 
-   :alt: Fig: Bottom silkscreen
-
-   Fig: Bottom silkscreen

boards/beaglebone/ai-64/ch10.rst

-.. _pictures:
-
-Pictures
-##########
-
-.. figure:: images/ch10/front.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 front
-
-   Fig: BeagleBone AI-64 front
-
-.. figure:: images/ch10/back.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 back
-
-   Fig: BeagleBone AI-64 back
-
-.. figure:: images/ch10/back-heatsink.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 back with heatsink
-
-   Fig: BeagleBone AI-64 back with heatsink
-
-.. figure:: images/ch10/45-front.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 front at 45° angle
-
-   Fig: BeagleBone AI-64 front at 45° angle
-
-.. figure:: images/ch10/45-back.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 back at 45° angle
-
-   Fig: BeagleBone AI-64 back at 45° angle
-
-.. figure:: images/ch10/45-back-heatsink.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 back with heatsink at 45° angle
-
-   Fig: BeagleBone AI-64 back with heatsink at 45° angle
-
-.. figure:: images/ch10/feature.jpg
-   :width: 400px
-   :align: center 
-   :alt: Fig: BeagleBone AI-64 ports
-
-   Fig: BeagleBone AI-64 ports
-
-

boards/beaglebone/ai-64/ch11.rst

-.. _support-information:
-
-Support Information
-####################
-
-All support for this design is through BeagleBoard.org community at: link: `BeagleBoard.org forum <https://forum.beagleboard.org/>`_ .
-
-
-.. _hardware-design:
-
-Hardware Design
-------------------
-
-You can find all BeagleBone AI-64 hardware files `here <https://git.beagleboard.org/beagleboard/beaglebone-ai-64>`_ under the `hw` folder.
-
-
-.. _software-updates:
-
-Software Updates
--------------------------------------
-
-You can download and flash the supported image onto your BeagleBone AI-64 from `this <https://debian.beagle.cc/images/bbai64-emmc-flasher-debian-11.2-xfce-arm64-2022-01-14-8gb.img.xz>`_ source.
-
-To see what SW revision is loaded into the eMMC check `/etc/dogtag`.
-It should look something like as shown below,
-
-```
-root@BeagleBone:~# cat /etc/dogtag
-BeagleBoard.org Debian Bullseye Xfce Image 2022-01-14
-```
-
-.. _rma-support:
-
-RMA Support
--------------------------------------
-
-If you feel your board is defective or has issues, request an Return Merchandise Application (RMA) by filling out the form at http://beagleboard.org/support/rma . You will need the serial number and revision of the board. The serial numbers and revisions keep moving. Different boards can have different locations depending on when they were made. The following figures show the three locations of the serial and revision number.
-
-.. _trouble-shooting-video-output-issues:
-
-Troubleshooting video output issues
--------------------------------------
-
-.. warning:: 
-
-   When connecting to an HDMI monitor, make sure your miniDP adapter is *active*. A *passive* adapter will not work. See :ref:`display-adapters-figure`.
-
-
-.. _getting-help:
-
-Getting Help
-*************
-
-If you need some up to date troubleshooting techniques, you can post your queries on link: `BeagleBoard.org forum <https://forum.beagleboard.org/>`_

boards/beaglebone/ai-64/edge_ai_apps/configuration_file.rst

@@ -230,7 +230,7 @@ Below are some of the use case specific properties:
    output
 
 The content of the model directory and its structure is discussed in detail in
-:ref:`pub_edgeai_import_custom_models`
+:ref:`ai_64_edgeai_import_custom_models`
 
 
 Outputs

boards/beaglebone/ai-64/edge_ai_apps/data_flows.rst

@@ -12,7 +12,7 @@ The **app_edgeai** application at a high level can be split into 3 parts,
 
 Here are the data flows for each reference demo and the corresponding GStreamer
 launch strings that **app_edgeai** application generates. User can interact with
-the application via the :ref:`pub_edgeai_configuration`
+the application via the :ref:`ai_64_edgeai_configuration`
 
 .. _ai_64_edgeai_image_classification_data_flow:
 

boards/beaglebone/ai-64/edge_ai_apps/docker_environment.rst

@@ -76,7 +76,7 @@ access camera, display and other hardware accelerators the SoC has to offer.
 
     After building and running the docker container, one needs to run 
     ``setup_script.sh`` before running any of the demo applications.
-    Please refer to :ref:`pub_edgeai_install_dependencies` for more details.
+    Please refer to :ref:`ai_64_edgeai_install_dependencies` for more details.
 
 .. _ai_64_edgeai_docker_additional_commands:
 
@@ -202,14 +202,14 @@ current location is the desired location then exit this procedure.
 .. code-block:: json
 
   {
-    "graph": "/run/media/nvme0n1/docker_root",
+    "graph": "/run/images/nvme0n1/docker_root",
     "storage-driver": "overlay",
     "live-restore": true
   }
 
 In the configuration above, the key/value pair
-**'"graph": "/run/media/nvme0n1/docker_root"'** defines the root location
-**'/run/media/nvme0n1/docker_root'.**
+**'"graph": "/run/images/nvme0n1/docker_root"'** defines the root location
+**'/run/images/nvme0n1/docker_root'.**
 
 4. Once the daemon.json file has been copied and updated, run the following
    commands

boards/beaglebone/ai-64/edge_ai_apps/getting_started.rst

@@ -60,7 +60,7 @@ USB Camera
 UVC (USB video class) compliant USB cameras are supported on the BeagleBone® AI-64.
 The driver for the same is enabled in linux image. The linux image has been tested with
 C270/C920/C922 versions of Logitech USB cameras. Please refer to
-:ref:`pub_edgeai_multiple_usb_cams` to stream from multiple USB cameras
+`the TI Edge AI SDK FAQ <https://software-dl.ti.com/jacinto7/esd/edgeai-sdk-j721e/latest/exports/docs/faq.html>`__ to stream from multiple USB cameras
 simultaneously.
 
 .. _ai_64_edgeai_imx219_sensor:
@@ -75,18 +75,16 @@ https://www.amazon.com/Raspberry-Pi-Camera-Module-Megapixel/dp/B01ER2SKFS
 The camera can be connected to any of the 2 RPi zero 22 pin camera headers on BB AI-64 as
 shown below
 
-.. figure:: 
-   :scale: 20
-   :align: center
+.. todo::
 
-   TODO: IMX219 CSI sensor connection with BeagleBone® AI-64 for Edge AI
+   IMX219 CSI sensor connection with BeagleBone® AI-64 for Edge AI
 
 Note that the headers have to be lifted up to connect the cameras
 
 .. note:: To be updated
     By default IMX219 is disabled. After connecting the camera you can enable it
     by specifying the dtb overlay file in
-    ``/run/media/mmcblk0p1/uenv.txt`` as below,
+    ``/run/images/mmcblk0p1/uenv.txt`` as below,
 
     ``name_overlays=k3-j721e-edgeai-apps.dtbo k3-j721e-sk-rpi-cam-imx219.dtbo``
 
@@ -94,7 +92,7 @@ Note that the headers have to be lifted up to connect the cameras
 
 Two RPi cameras can be connected to 2 headers for multi camera use-cases
 
-Please refer :ref:`pub_edgeai_camera_sources` to know how to list all the cameras
+Please refer :ref:`ai_64_edgeai_camera_sources` to know how to list all the cameras
 connected and select which one to use for the demo.
 
 By default imx219 will be configured to capture at 8 bit, but it also supports
@@ -121,6 +119,7 @@ required:
     - Set the input format in the ``/opt/edge_ai_apps/configs/rpiV2_cam_example.yaml``
       as ``rggb10``
 
+.. _ai_64_edgeai_install_dependencies:
 
 Software setup
 ==============
@@ -133,8 +132,10 @@ Preparing SD card image
 Download the ``bullseye-xfce-edgeai-arm64`` image from the links below and
 flash it to SD card using `Balena etcher <https://www.balena.io/etcher/>`_ tool.
 
-- To use via SD card: `bbai64-debian-11.4-xfce-edgeai-arm64-2022-08-02-10gb.img.xz <https://rcn-ee.net/rootfs/bb.org/testing/2022-08-02/bullseye-xfce-edgeai-arm64/bbai64-debian-11.4-xfce-edgeai-arm64-2022-08-02-10gb.img.xz>`_
-- To flash on eMMC: `bbai64-emmc-flasher-debian-11.4-xfce-edgeai-arm64-2022-08-02-10gb.img.xz <https://rcn-ee.net/rootfs/bb.org/testing/2022-08-02/bullseye-xfce-edgeai-arm64/bbai64-emmc-flasher-debian-11.4-xfce-edgeai-arm64-2022-08-02-10gb.img.xz>`_
+.. todo: Images should be on https://files.debian.cc and linked from https://www.beagleboard.org/distros
+
+- To use via SD card: `bbai64-debian-11.7-xfce-edgeai-arm64-2023-08-05-10gb.img.xz <https://rcn-ee.com/rootfs/release/2023-08-05/bullseye-xfce-edgeai-arm64/bbai64-debian-11.7-xfce-edgeai-arm64-2023-08-05-10gb.img.xz>`_
+- To flash on eMMC: `bbai64-emmc-flasher-debian-11.7-xfce-edgeai-arm64-2023-08-05-10gb.img.xz <https://rcn-ee.com/rootfs/release/2023-08-05/bullseye-xfce-edgeai-arm64/bbai64-emmc-flasher-debian-11.7-xfce-edgeai-arm64-2023-08-05-10gb.img.xz>`_
 
 
 The Balena etcher tool can be installed either on Windows/Linux. Just download the
@@ -178,11 +179,9 @@ Once the SD card is firmly inserted in its slot and the board is powered ON,
 the board will take less than 20sec to boot and display a wallpaper as
 shown in the image below.
 
-.. figure:: 
-   :scale: 25
-   :align: center
+.. todo::
 
-   TODO: BeagleBone® AI-64 wallpaper upon boot
+   BeagleBone® AI-64 wallpaper upon boot
 
 You can also view the boot log by connecting the UART cable to your PC and
 use a serial port communications program.
@@ -241,8 +240,6 @@ as mentioned here:
 
 https://code.visualstudio.com/docs/remote/ssh
 
-.. figure:: 
-   :scale: 90
-   :align: center
+.. todo::
 
-   TODO: Microsoft Visual Studio Code for connecting to BeagleBone® AI-64 for Edge AI via SSH
+   Microsoft Visual Studio Code for connecting to BeagleBone® AI-64 for Edge AI via SSH

boards/beaglebone/ai-64/edge_ai_apps/index.rst

@@ -3,6 +3,8 @@
 Edge AI
 ========
 
+.. todo:: Update to latest text from Texas Instruments Edge AI docs
+
 .. toctree::
    :maxdepth: 1