Forum | Documentation | Website | Blog

Skip to content
Snippets Groups Projects
Commit 7e3a079f authored by Deepak Khatri's avatar Deepak Khatri :dog:
Browse files

Update AI-64 chapter 2

parent 6e7ce874
Branches
Tags
1 merge request!89Docs updates - chapter restructuring, images, and more
...@@ -3,13 +3,13 @@ ...@@ -3,13 +3,13 @@
Quick Start Guide Quick Start Guide
################## ##################
This section provides instructions on how to hook up your board. This beagle requires a 5V > 3A 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. power supply to work properly via either USB Type-C power adapter or a barrel jack power adapter.
Recommended adapters: 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 `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. * 5V > 3A `laptop/mobile adapter <https://www.amazon.com/Lenovo-Laptop-Charger-USB-C-Adapter/dp/B0CH3S7TF4/ref=sr_1_3?crid=3AJB8P9KC7IKU&keywords=type+c+65w+thinkpad&qid=1704510213&sprefix=tye+c+65+w+thinkp%2Caps%2C348&sr=8-3>`_ with USB-C cable.
All the :ref:`BeagleBone AI-64 connections ports` we will use in this chapter are shown in the figure below. All the :ref:`BeagleBone AI-64 connections ports` we will use in this chapter are shown in the figure below.
...@@ -69,223 +69,215 @@ different ways, but we will discuss the two most common scenarios. ...@@ -69,223 +69,215 @@ different ways, but we will discuss the two most common scenarios.
Each of these configurations is discussed in general terms in the following sections. Each of these configurations is discussed in general terms in the following sections.
.. _tethered-to-a-pc: .. tabs::
Tethered To A PC .. group-tab:: 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. 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.
.. _tethered-figure: .. _tethered-figure:
.. figure:: media/ch03/usb-tethering.* .. figure:: media/ch03/usb-tethering.*
:width: 740px :width: 740px
:align: center :align: center
Tethered Configuration 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: 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. **Connect the Cable to the Board**
.. _usb-c-connect-figure: 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.
.. figure:: media/ch03/usb-c-connection.* .. _usb-c-connect-figure:
: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 :ref:`usb-a-connect-figure` below. .. figure:: media/ch03/usb-c-connection.*
:width: 740px
:align: center
USB Connection to the Board
.. _usb-a-connect-figure: 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.
.. figure:: media/ch03/usb-a-connection.* .. _usb-a-connect-figure:
: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 :ref:`power-led-figure` below. .. figure:: media/ch03/usb-a-connection.*
:width: 740px
:align: center
USB Connection to the PC/Laptop
.. _power-led-figure: 3. The board will power on and the power LED will be on as shown in :ref:`power-led-figure` below.
.. figure:: media/ch03/power-led.* .. _power-led-figure:
: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 :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. .. figure:: media/ch03/power-led.*
:width: 740px
:align: center
Board Power LED
.. _boot-status-figure: 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.
.. figure:: media/ch03/led-pattern.* .. _boot-status-figure:
:width: 740px
:align: center
Board Boot Status
.. _accessing-the-board-as-a-storage-drive: .. figure:: media/ch03/led-pattern.*
:width: 740px
:align: center
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: **Accessing the Board as a Storage Drive**
1. Open the USB Drive folder. 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:
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: 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 w/Display and Keyboard/Mouse .. group-tab:: 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. 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-config-figure:
.. figure:: media/ch03/desktop-configuration.* .. figure:: media/ch03/desktop-configuration.*
:width: 740px :width: 740px
:align: center :align: center
Desktop Configuration Desktop Configuration
Ethernet cable and M.2 WiFi + Bluetooth card are optional. They can be used if network access required. Ethernet cable and M.2 WiFi + Bluetooth card are optional. They can be used if network access required.
.. _required-accessories: .. _required-accessories:
Required Accessories **Required Accessories**
~~~~~~~~~~~~~~~~~~~~~
In order to use the board in this configuration, you will need the following accessories: In order to use the board in this configuration, you will need the following accessories:
* 5V > 3A power supply. * 5V > 3A power supply.
* Display Port or HDMI monitor. * 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). * 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. * 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. * 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. * 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:
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. 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: .. _display-cable-figure,miniDP-DP or active miniDP-HDMI cable connection figure:
.. figure:: media/ch03/monitor-cable.* .. figure:: media/ch03/monitor-cable.*
:width: 740px :width: 740px
:align: center :align: center
Connect miniDP-DP or active miniDP-HDMI cable to BeagleBone AI-64 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`. 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: .. _display-adapters-figure:
.. figure:: media/ch03/display-adapters.* .. figure:: media/ch03/display-adapters.*
:width: 740px :width: 740px
:align: center :align: center
Display adapters 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`. 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: .. _keyboard-mouse-figure:
.. figure:: media/ch03/mouse-keyboard.* .. figure:: media/ch03/mouse-keyboard.*
:width: 740px :width: 740px
:align: center :align: center
Keyboard and Mouse Keyboard and Mouse
4. Connect the Ethernet Cable 4. Connect the Ethernet Cable
If you decide you want to connect to your local area network, an Ethernet cable can be used. 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 Connect the Ethernet Cable to the Ethernet port as shown in :ref:`ethernet-cable-figure`. Any
standard 100M Ethernet cable should work. standard 100M Ethernet cable should work.
.. _ethernet-cable-figure: .. _ethernet-cable-figure:
.. figure:: media/ch03/ethernet-cable.* .. figure:: media/ch03/ethernet-cable.*
:width: 740px :width: 740px
:align: center :align: center
Ethernet Cable Connection 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. 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: .. _barrel-jack-figure:
.. figure:: media/ch03/barrel-jack.* .. figure:: media/ch03/barrel-jack.*
:width: 740px :width: 740px
:align: center :align: center
External DC Power 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. 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-figure:
.. figure:: media/ch03/miniDP-connector.* .. figure:: media/ch03/miniDP-connector.*
:width: 740px :width: 740px
:align: center :align: center
Connect miniDP to DP or active miniDP to HDMI Cable to the Board 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. 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 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. 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: .. _LEDs-figure,BeagleBone AI-64 LEDs figure:
.. figure:: media/ch03/leds.* .. figure:: media/ch03/leds.*
:width: 740px :width: 740px
:align: center :align: center
BeagleBone AI-64 LEDs BeagleBone AI-64 LEDs
While the four user LEDS can be over written and used as desired, they do have specific 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. 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. * **USR0** is the heartbeat indicator from the Linux kernel.
* **USR1** turns on when the microSD card is being accessed * **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. * **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. * **USR3** turns on when the onboard eMMC is being accessed.
* **USR4** is an activity indicator for WiFi. * **USR4** is an activity indicator for WiFi.
8. A Booted System 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. 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. 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. 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. d. And at this point you are ready to go! :ref:`figure-16` shows the desktop after booting.
.. _figure-16: .. _figure-16:
.. figure:: media/ch03/xfce-desktop.* .. figure:: media/ch03/xfce-desktop.*
:width: 740px :width: 740px
:align: center :align: center
BeagleBone XFCE Desktop Screen BeagleBone XFCE Desktop Screen
.. _bbai64-update: .. _bbai64-update:
...@@ -298,10 +290,15 @@ reflash the board. If you do want to reflash it, visit the flashing instructions ...@@ -298,10 +290,15 @@ reflash the board. If you do want to reflash it, visit the flashing instructions
started page. Factory Image update (without reflashing)… started page. Factory Image update (without reflashing)…
.. code-block:: bash .. code-block:: bash
:linenos:
sudo apt update sudo apt update
.. code-block:: bash
sudo apt install --only-upgrade bb-j721e-evm-firmware generic-sys-mods sudo apt install --only-upgrade bb-j721e-evm-firmware generic-sys-mods
.. code-block:: bash
sudo apt upgrade sudo apt upgrade
Update U-Boot: Update U-Boot:
...@@ -310,17 +307,21 @@ Update U-Boot: ...@@ -310,17 +307,21 @@ Update U-Boot:
to ensure only tiboot3.bin is in boot0, the pre-production image we tried to do more in boot0, but failed… to ensure only tiboot3.bin is in boot0, the pre-production image we tried to do more in boot0, but failed…
.. code-block:: bash .. code-block:: bash
:linenos:
sudo /opt/u-boot/bb-u-boot-beagleboneai64/install-emmc.sh 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 sudo /opt/u-boot/bb-u-boot-beagleboneai64/install-microsd.sh
.. code-block:: bash
sudo reboot sudo reboot
Update Kernel and SGX modules: Update Kernel and SGX modules:
============================== ==============================
.. code-block:: bash .. code-block:: bash
:linenos:
sudo apt install bbb.io-kernel-5.10-ti-k3-j721e sudo apt install bbb.io-kernel-5.10-ti-k3-j721e
...@@ -328,7 +329,6 @@ Update xfce: ...@@ -328,7 +329,6 @@ Update xfce:
============ ============
.. code-block:: bash .. code-block:: bash
:linenos:
sudo apt install bbb.io-xfce4-desktop sudo apt install bbb.io-xfce4-desktop
...@@ -336,7 +336,6 @@ Update ti-edge-ai 8.2 examples ...@@ -336,7 +336,6 @@ Update ti-edge-ai 8.2 examples
============================== ==============================
.. code-block:: bash .. code-block:: bash
:linenos:
sudo apt install ti-edgeai-8.2-base ti-vision-apps-8.2 ti-vision-apps-eaik-firmware-8.2 sudo apt install ti-edgeai-8.2-base ti-vision-apps-8.2 ti-vision-apps-eaik-firmware-8.2
...@@ -344,7 +343,6 @@ Cleanup: ...@@ -344,7 +343,6 @@ Cleanup:
======== ========
.. code-block:: bash .. code-block:: bash
:linenos:
sudo apt autoremove --purge sudo apt autoremove --purge
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment