accessories/index.rst

@@ -3,20 +3,20 @@
 Accessories
 #############
 
-This section will include all the tested accessories for BeagleBoard.org hardware and kits.
+This section includes tested accessories for BeagleBoard.org hardware and kits.
 
 .. note::
 
-    This documentation is not complete and we are actively looking for volunteers to test 
-    and add new hardware accessories that they have already with them. General feedback and contribution 
-    is also appreciated. You can checkout these pages to contribuite to BeagleBoard.org docs project,\
+    This documentation is actively evolving and we are always looking for volunteers to test 
+    and add new hardware accessories that they have tested. General feedback and contribution 
+    is also appreciated. You can checkout these pages to contribuite to the BeagleBoard.org docs project,\
     
     1. `Docs contribution guide <https://docs.beagleboard.io/latest/intro/contribution/index.html>`_
     2. `Docs project issue tracker. <https://git.beagleboard.org/docs/docs.beagleboard.io/-/issues>`_
 
 .. danger::
 
-    Accessories section contains only 3rd party products that have been manually used by community members with BeagleBoard.org products. 
+    The accessories section only contains a subset of 3rd party products that have been manually used by community members with BeagleBoard.org products. 
     BeagleBoard.org should not be held liable for the functionality of BeagleBoard.org products in association with these 3rd party 
     products in any way possible. This is just a place for people to report their experiences and not a statement of compatibility. 
     BeagleBoard.org approve that these items have at least some aspect of testing by foundation members, though only specific 

accessories/peripherals.rst

@@ -4,9 +4,9 @@ Peripherals
 ############
 
 .. note::
-    Most Keyboards, Mouse, and USB Hubs are plug-n-play devices and they are 
-    supported out of the box in linux. List below only shows what has been tested. 
-    You may have something different and it will work without any additional software requirement.
+    Most Keyboards, Mouse, and USB Hubs are plug-and-play devices and are 
+    supported out of the box in Linux. The list below only shows a subset that has been tested by contributors. 
+    Many other options will work without any additional tinkering required on behalf of the user.
 
 Keyboard & Mouse Combo
 ***********************
@@ -14,7 +14,8 @@ Keyboard & Mouse Combo
 With limited ports availability on BeagleBones it is recommended to use wireless 
 Keyboard & Mouse combos.
 
-- `Adafruit keyboard & Mouse w/batteries <https://www.mouser.in/ProductDetail/Adafruit/1738?qs=GURawfaeGuBoaqdx8E%2Fl7w%3D%3D>`_
+- `Adafruit keyboard & Mouse w/batteries <https://www.mouser.com/ProductDetail/Adafruit/1738?qs=GURawfaeGuBoaqdx8E%2Fl7w%3D%3D>`_
+- `Logitech K400 Plus Keyboard/Touchpad Combo <https://www.amazon.com/Logitech-Wireless-Keyboard-Touchpad-PC-connected/dp/B014EUQOGK/>`_
 - `Portronics Key2-A Combo of Multimedia Wireless Keyboard & Mouse <https://www.amazon.in/Portronics-Combo-Multimedia-Wireless-Light-Weight/dp/B07X1KRPDZ/>`_
 
 Keyboards
@@ -22,24 +23,17 @@ Keyboards
 
 **Make sure that you plug the keyboard into the USB Host connector before powering on the board.**
 
-- `BTC USB 6100C <http://www.amazon.com/BTC-6100C-Compact-MultiMedia-Keyboard/dp/B000VITZ98/>`_
-- `Inland USB 70010 <http://inlandproduct.com/usbwiredkeyboard.aspx>`_
-- `Gear Head Wireless KB3800TPW <http://www.amazon.com/Wireless-Touch-Touchpad-Keyboard-Smart/dp/B003GU1028/>`_
-- `Microsoft Wireless 800 <http://www.amazon.com/Microsoft-Wireless-Keyboard-800-2VJ-00001/dp/B004JO16KG/>`_
-- `Logitech MK320 Keyboard/Mouse Combo <http://www.amazon.com/Logitech-Wireless-Desktop-MK320-Keyboard/dp/B003VAGXZC/ref=sr_1_1?s=electronics&ie=UTF8&qid=1371841107&sr=1-1&keywords=mk320>`_
-- `Logitech MK710 Keyboard/Mouse Combo <http://www.amazon.com/Logitech-Wireless-Desktop-Keyboard-920-002416/dp/B0036E8V08/>`_
-- `Logitech MK260 Keyboard/Mouse Combo <http://www.amazon.com/Logitech-Wireless-Combo-Keyboard-920-002950/dp/B004KSQANO>`_
+- `Logitech K400 Plus Keyboard/Touchpad Combo <https://www.amazon.com/Logitech-Wireless-Keyboard-Touchpad-PC-connected/dp/B014EUQOGK/>`_
+- `Logitech MK345 Keyboard/Mouse Combo <https://www.amazon.com/Logitech-MK345-Wireless-Combo-Right-Handed/dp/B00QXT5T3U/>`_
+- `Logitech MK270 Keyboard/Mouse Combo <https://www.amazon.com/Logitech-MK270-Wireless-Keyboard-Mouse/dp/B079JLY5M5/>`_
 - `Inland Keyboard and Mouse Combo <http://www.amazon.com/Inland-Wireless-2-4GHz-Optical-Keyboard/dp/B009V9IWCO/ref=sr_sp-btf_image_1_10?s=electronics&ie=UTF8&qid=1376403707&sr=1-10&keywords=inland+mouse+and+keyboard>`_
-- `Solidtek KB-5010BU Keyboard+Roller Ball <http://www.logicsupply.com/products/kb_5010bu>`_
 
 Mice
 ******
 
-**Make sure that you plug the mice into the USB Host connector before powering on the board.**
+**Make sure that you plug the mouse into the USB Host connector before powering on the board.**
 
-- `Microsoft Wireless 1000 <http://www.amazon.com/Microsoft-Wireless-Mobile-Mouse-1000/dp/B003STDQQU/ref=sr_1_1?s=electronics&ie=UTF8&qid=1371841170&sr=1-1&keywords=microsoft+wireless+1000>`_
-- `Logitech M705 <http://www.amazon.com/Logitech-Wireless-Marathon-Battery-910-001935/dp/B003TG75EG/>`_
-- `Logitech M600 <http://www.amazon.com/Logitech-Touch-Mouse-M600-910-002666/dp/B006MBP7T0/>`_
+- `Amazon Basics Wireless Computer Mouse <https://www.amazon.com/AmazonBasics-Wireless-Computer-Mouse-Receiver/dp/B005EJH6Z4/>`_
 - `Logitech M310 <http://www.logitech.com/en-us/product/wireless-mouse-m310>`_
 
 USB HUBS
@@ -50,10 +44,10 @@ USB HUBS
 - `Inland 4 Port <http://www.microcenter.com/product/360458/4-Port_USB_20_Hub>`_
 - `Manhattan 10-port HUB <http://www.microcenter.com/product/393316/10-Port_USB_20_Hi-Speed_Desktop_Hub>`_
 - `4-Port USB Cable HUB <http://www.microcenter.com/product/354122/4-Port_USB_20_Cable_Hub>`_
-- `D-LINK DUB-H7 <http://www.dlink.com/us/en/home-solutions/connect/usb/dub-h7-7-port-usb-2-0-hub>`_
+- `D-Link 7-Port USB 2.0 Hub DUB-H7 <https://www.dlink.com/en/products/dub-h7-7-port-usb-2-0-hub>`_
 - `Trust HU-5770 7-Port Powered Hub <http://www.amazon.co.uk/TRUST-UK-HU-5770-PORT-POWERED/dp/B000HG5Q42>`_
 
 .. tip::
     Make sure you are powering BeagleBone with decent power supply with 
-    enough current before attaching any additional Peripherals. 
+    enough current before attaching any additional peripherals. If you require many USB peripheral USB devices to be attached, consider using a "Powered USB Hub"
     See :ref:`accessories-power-supplies` for more information on power requirements.

accessories/power-supplies.rst

@@ -3,15 +3,14 @@
 Power supplies
 ###############
 
-All BeagleBone boards require different power supplies like BeagleBone Balack and other AM335X 
-based boards will be fine with a 5VDC @ 1A  but, BeagleBone AI-64 requires aleast 5VDC @ 3A. You 
-have to either supply the power via USB jack or a 2.1mm/2.5mm inner diameter and 5.5mm outer 
-diameter (center positive) barrel jack.
+Different BeagleBoard products require different power supplies. While BeagleBone Black and other AM335X 
+based boards will be fine with a 5V @ 1A, others, such as BeagleBone AI-64 require aleast 5V @ 3A. You 
+have to either supply the power via USB jack or a matching (center positive) barrel jack as shown in the table below.
 
 .. note::
     The power supply is not supplied with the board.
 
-.. table:: BeagleBone power supplies
+.. table:: BeagleBoard power supplies
     
     +----------------------------+-------------------+-------------+-------------------------------------------------------------+
     | Board                      | Connector         | Power       |  Tested accessories                                         |
@@ -20,14 +19,22 @@ diameter (center positive) barrel jack.
     +----------------------------+                   |             | - `Sparkfun <https://www.sparkfun.com/products/8269?>`_     |
     | BeagleBone Black Wireless  |                   |             | - `Logic Supply <http://www.logicsupply.com/pw-5v2a/>`_     |
     +----------------------------+                   |             |                                                             |
+    | BeagleV-Ahead              |                   |             |                                                             |
+    +----------------------------+                   |             |                                                             |
     | Beaglebone xM              |                   |             |                                                             |
     +----------------------------+-------------------+-------------+-------------------------------------------------------------+
     | PocketBeagle               | microUSB          | 5V @ 2A     | - `AA10A-050A(M)-R <https://mou.sr/3XUPOL0>`_               |
     |                            |                   |             | - `AA10E-050A(M)-R <https://mou.sr/3jrA4zZ>`_               |
     +----------------------------+-------------------+-------------+-------------------------------------------------------------+
     | BeagleBone AI-64           | Type-C            | 5V @ 3A     | - `AA65M-59FKA-R <https://mou.sr/3Dz9P1E>`_                 |
+    +----------------------------+                   |             | - `Lenovo 65W USB Type C Adater <https://a.co/d/hH8SbG5>`_  |
+    | BeaglePlay                 |                   |             |                                                             |      
+    +----------------------------+                   |             |                                                             |
+    | BeagleBone AI              |                   |             |                                                             | 
+    +----------------------------+                   |             |                                                             |
+    | BeagleV-Fire               |                   |             |                                                             |
     +----------------------------+                   |             |                                                             |
-    | Beaglebone AI              |                   |             |                                                             |      
+    | BeagleY-AI                 |                   |             |                                                             |          
     +----------------------------+-------------------+-------------+-------------------------------------------------------------+
     | BeagleBone Green Gateway   | 2.1mm Barrel Jack | 12V @ 5A    | - `PSAC60M-120-R <https://mou.sr/3Rs657U>`_                 |
     +----------------------------+                   |             |                                                             |
@@ -38,7 +45,12 @@ diameter (center positive) barrel jack.
 
 .. tip::
     Most modern day mobile phone chargers are capable of delivering enough current to power any BeagleBone. 
-    You may try using that with suitable cable before buying any standalone power srource for your board.
+    You may try using that with a suitable cable before buying any standalone power source for your board. Please ensure the expected output voltage
+    and current capabilities are listed on your power supply before attempting to power your board. 
 
-If you plan to use capes or add your own circuitry, higher amperage may be required.
-Make sure that you have a grounded connection. This can be the USB cable or the HDMI cable.
+If you plan to use capes or add your own circuitry, a power supply capable of higher current may be required.
+
+.. note::
+    USB-C supplies will auto-negotiate the highest power mode that both power supply and BeagleBoard support. In most cases, this will be 
+    5V @ 3A. It is OK to use a higher Wattage USB-C PD supply with a board, but it is recommended to use supplies from well-known manufacturers to 
+    avoid supplies that may break the USB-C PD specification.

boards/beagleboard/index.rst

@@ -3,8 +3,9 @@
 BeagleBoard (all)
 ###################
 
-BeagleBoard boards are low-cost, ARM-based development boards suitable for rapid prototyping and 
-open-hardware to enable professionals to develop production systems.
+BeagleBoard.org single board computers (SBCs) and microcontroller development boards are fully open-source, low-cost, RISC-V & ARM 
+based boards. Which makes them suitable for students to learn about embedded electronics & embedded Linux. Beagle development 
+platforms also enable rapid prototyping for professionals to develop industrial & production systems.
 
 .. note::
     Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page. 
@@ -12,7 +13,11 @@ open-hardware to enable professionals to develop production systems.
     Use of either the boards or the design materials constitutes agreement to the T&C including any 
     modifications done to the hardware or software solutions provided by beagleboard.org foundation.
 
-The latest PDF-formatted System Reference Manual for each BeagleBoard board is linked below.
+The latest unified docs PDF is linked below.
+
+* `BeagleBoard.org unified docs PDF <https://docs.beagleboard.org/latest/beagleboard-docs.pdf>`_
+
+The latest System Reference Manual (PDF) for older BeagleBoard boards are linked below.
 
 * `BeagleBoard <https://git.beagleboard.org/beagleboard/beagleboard/-/blob/master/BeagleBoard_revC5_SRM.pdf>`_
 * `BeagleBoard-xM <https://git.beagleboard.org/beagleboard/beagleboard-xm/-/blob/master/BeagleBoard-xM_SRM.pdf>`_

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

+.. _bbai64-quick-start:
+
+Quick Start Guide
+##################
+
+This section provides instructions on how to hook up your board. This Beagle requires a 5V > 3A (15W) 
+power supply to work properly via either USB Type-C power adapter or a barrel jack power adapter. 
+
+Recommended adapters can be found at :ref:`accessories-power-supplies` section. 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.*
+   :width: 740px
+   :align: center 
+   
+   BeagleBone AI-64 connections ports
+
+.. _whats-in-the-box:
+
+What’s In the Box
+*******************
+
+In the box you will find two main items as shown in :ref:`bbai-64-pacakage`.
+
+* `BeagleBone AI-64 <https://www.beagleboard.org/boards/beaglebone-ai-64>`_
+* Instruction card
+
+.. note:: A USB-C to USB-C cable is not included, but recommended for the tethered scenario and creates 
+    a developer experience where the board can be used immediately with no other equipment needed.
+
+.. tip:: For board files, 3D model, and more, you can checkout `BeagleBona AI-64 repository on OpenBeagle <https://openbeagle.org/beagleboard/beaglebone-ai-64>`_.
+
+.. _bbai-64-pacakage:
+
+.. figure:: images/ch03/bbai64-in-box.*
+   :width: 740px
+   :align: center 
+   
+   BeagleBone AI-64 box content
+
+Methods of operation
+*********************
+
+1.  Tethered to a PC
+2.  Standalone development platform in a PC configuration using external peripherals
+
+.. _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.
+
+.. tab-set::
+
+   .. tab-item:: 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 connected PC. You need to use either Firefox or Chrome on the PC, Internet Explorer will not work properly. 
+
+      .. figure:: images/ch03/usb-tethering.*
+         :width: 740px
+         :align: center 
+         
+         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**
+
+      1. Connect the type C USB cable to the board as shown in the figure below. The connector is on the top side of the board near barrel jack.
+
+      .. figure:: images/ch03/usb-c-connection.*
+         :width: 740px
+         :align: center 
+         
+         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 figure below.
+
+      .. figure:: images/ch03/usb-a-connection.*
+         :width: 740px
+         :align: center 
+         
+         USB Connection to the PC/Laptop
+
+      3.  The board will power on and the power LED will be on as shown in the figure below.
+
+      .. figure:: images/ch03/power-led.*
+         :width: 740px
+         :align: center 
+         
+         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 the 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.
+
+      .. figure:: images/ch03/led-pattern.*
+         :width: 740px
+         :align: center 
+         
+         Board Boot Status
+
+      **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.
+
+   .. tab-item:: 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 the figure below. 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.
+
+      .. figure:: images/ch03/desktop-configuration.*
+         :width: 740px
+         :align: center 
+         
+         Desktop Configuration
+
+      Ethernet cable and M.2 WiFi + Bluetooth card are optional. They can be used if network access required.
+
+      **Required Accessories**
+
+      In order to use the board in this configuration, you will need the following accessories:
+
+      * :ref:`5V > 3A power supply <accessories-power-supplies>`.
+      * :ref:`Display Port or HDMI monitor <accessories-displays>`.
+      * :ref:`miniDP-DP or active miniDP-HDMI cable <accessories-cables_minidp_hdmi>`.
+      * :ref:`USB wired/wireless keyboard and mouse <accessories-peripherals>`.
+
+      **Optional Accessories**
+
+      * Powered USB hub, 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, For wireless connections, a USB WiFi adapter or a recommended M.2 WiFi module can provide wireless networking.
+
+      **Connecting Up the Board**
+
+      1. Connect the miniDP to DP or active miniDP to HDMI cable from your BeagleBone AI-64 to your monitor.
+
+      .. figure:: images/ch03/monitor-cable.*
+         :width: 740px
+         :align: center 
+         
+         Connect miniDP-DP or active miniDP-HDMI cable to BeagleBone AI-64
+
+      1. If you have an Display Port or HDMI monitor with HDMI-HDMI or DP-DP cable you can use adapters as shown in the figure below.
+
+      .. figure:: images/ch03/display-adapters.*
+         :width: 740px
+         :align: center 
+         
+         Display adapters
+
+      1. If you have wired/wireless USB keyboard and mouse such as seen in the figure below, you need to plug the receiver in the USB host port of the board as shown in the figure below.
+
+      .. figure:: images/ch03/mouse-keyboard.*
+         :width: 740px
+         :align: center 
+         
+         Keyboard and Mouse
+
+      1. 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 the figure below. Any 
+      standard 100M Ethernet cable should work.
+
+      .. figure:: images/ch03/ethernet-cable.*
+         :width: 740px
+         :align: center 
+         
+         Ethernet Cable Connection
+
+
+      1. The final step is to plug in the DC power supply to the DC power jack as shown in the figure below.
+
+      .. figure:: images/ch03/barrel-jack.*
+         :width: 740px
+         :align: center 
+         
+         External DC Power
+
+      1. 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 the figure below.
+
+      .. figure:: images/ch03/miniDP-connector.*
+         :width: 740px
+         :align: center 
+         
+         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.
+
+      1. 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.
+
+      .. figure:: images/ch03/leds.*
+         :width: 740px
+         :align: center 
+         
+         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.
+
+      1. 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 the figure below. 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! The figure below shows the desktop after booting.
+
+      .. figure:: images/ch03/xfce-desktop.*
+         :width: 740px
+         :align: center 
+         
+         BeagleBone XFCE Desktop Screen
+
+.. _bbai64-update:
+
+Update software
+****************
+
+Production boards currently ship with the factory-installed 2022-01-14-8GB image. To upgrade 
+from the software image on your BeagleBone AI-64 to the latest, you don't need to completely 
+reflash the board. If you do want to reflash it, visit the flashing instructions on the getting 
+started page. Factory Image update (without reflashing)…
+
+.. code-block:: bash
+
+   sudo apt update
+
+.. code-block:: bash
+
+   sudo apt install --only-upgrade bb-j721e-evm-firmware generic-sys-mods
+
+.. code-block:: bash
+
+   sudo apt upgrade
+
+Update U-Boot:
+==============
+
+to ensure only tiboot3.bin is in boot0, the pre-production image we tried to do more in boot0, but failed…
+
+.. code-block:: bash
+
+   sudo /opt/u-boot/bb-u-boot-beagleboneai64/install-emmc.sh
+
+.. code-block:: bash
+
+   sudo /opt/u-boot/bb-u-boot-beagleboneai64/install-microsd.sh
+
+.. code-block:: bash
+
+   sudo reboot
+
+Update Kernel and SGX modules:
+==============================
+
+.. code-block:: bash
+
+   sudo apt install bbb.io-kernel-5.10-ti-k3-j721e    
+
+Update xfce:
+============
+
+.. code-block:: bash
+
+   sudo apt install bbb.io-xfce4-desktop
+
+Update ti-edge-ai 8.2 examples
+==============================
+
+.. code-block:: bash
+
+   sudo apt install ti-edgeai-8.2-base ti-vision-apps-8.2 ti-vision-apps-eaik-firmware-8.2
+
+Cleanup:
+========
+
+.. code-block:: bash
+
+   sudo apt autoremove --purge
+
+Next steps
+**********
+
+* :ref:`ai_64_edgeai_home`

boards/beaglebone/ai-64/05-demos-and-tutorials.rst

+.. _bbai64-demos-and-tutorials:
+
+Demos and Tutorials
+###################
+
+* :ref:`ai_64_edgeai_home`
+
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+
+   edge_ai_apps/index

boards/beaglebone/ai-64/ch01.rst

-Introduction
-###############
-
-This document is the *System Reference Manual* for BeagleBone AI-64
-and covers its use and design. The board will primarily be referred to
-in the remainder of this document simply as the board, although it may
-also be referred to as AI-64 or BeagleBone AI-64 as a reminder.
-
-This design is subject to change without notice as we will work to keep
-improving the design as the product matures based on feedback and
-experience. Software updates will be frequent and will be independent of
-the hardware revisions and as such not result in a change in the
-revision number.
-
-Make sure you frequently check the `BeagleBone AI-64 git repository <https://git.beagleboard.org/beagleboard/beaglebone-ai-64/>`_ for the most up to date support documents.
-

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/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
------------------
-
-Follow instructions below to download the latest image for your BeagleBone AI-64:
-
-1. Go to `BeagleBoard.org distro <https://www.beagleboard.org/distros>`_ page.
-2. :ref:`filter-software-distribution-AI-64` from dropdown and download the image.
-
-.. _filter-software-distribution-AI-64:
-
-.. figure:: images/ch11/distros.png
-   :align: center
-   :alt: Filter Software Distributions for BeagleBone AI-64 
-
-   Filter Software Distributions for BeagleBone AI-64
-
-.. tip::
-   You can follow the :ref:`flash-latest-image` guide for more information on 
-   flashing the downloaded image to your board.
-
-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/>`_