diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index e17f965d26bcd64d8018358d5a551425c0ef4ae4..f7e4675b4a8649efd0587de668b2b630d2678264 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -4,7 +4,7 @@ variables:
GIT_SUBMODULE_STRATEGY: recursive
cache:
- key: sphinx-build-env-docs-002
+ key: sphinx-build-env-docs-003
paths:
- .venv
- .cache
diff --git a/accessories/cables.rst b/accessories/cables.rst
index f8ae6d9aa8c1d36359d04f772b3649cb3ab8ed8a..5a742f198702dc5831d38f847eeca8f5c3fc7f5f 100644
--- a/accessories/cables.rst
+++ b/accessories/cables.rst
@@ -32,6 +32,8 @@ The type of cable you have to procure is listed in the table below:
+----------------------------+---------------------------+---------------+---------------------+
| Board | USB | Host capable? | Power required [2]_ |
+============================+===========================+===============+=====================+
+ | BeagleY-AI | High-speed USB-C | Unsupported | 1000mA |
+ +----------------------------+---------------------------+---------------+---------------------+
| BeaglePlay | High-speed USB-C | Yes [1]_ | 500mA |
+----------------------------+---------------------------+---------------+---------------------+
| BeagleV-Fire | High-speed USB-C | Yes [1]_ | 750mA |
diff --git a/accessories/power-supplies.rst b/accessories/power-supplies.rst
index 615e7260b01f16f46b76c13ac60544e1cf3f9569..a8d95976712cb2faaad83fee8a4fba469069c107 100644
--- a/accessories/power-supplies.rst
+++ b/accessories/power-supplies.rst
@@ -27,12 +27,14 @@ have to either supply the power via USB jack or a matching (center positive) bar
| | | | - `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 AC Adater <https://a.co/d/hH8SbG5>`|
+ +----------------------------+ | | - `Lenovo 65W USB Type C Adater <https://a.co/d/hH8SbG5>`_ |
| BeaglePlay | | | |
+----------------------------+ | | |
| BeagleBone AI | | | |
+----------------------------+ | | |
- | BeagleV-Fire | | | |
+ | BeagleV-Fire | | | |
+ +----------------------------+ | | |
+ | BeagleY-AI | | | |
+----------------------------+-------------------+-------------+-------------------------------------------------------------+
| BeagleBone Green Gateway | 2.1mm Barrel Jack | 12V @ 5A | - `PSAC60M-120-R <https://mou.sr/3Rs657U>`_ |
+----------------------------+ | | |
diff --git a/boards/beagleconnect/freedom/index.rst b/boards/beagleconnect/freedom/index.rst
index d91792047dd2e36f7b3665cc4a7a2d4f5fe08c8d..e8cfe59ab8cd2579fa4a5dbe41cd652bdf9fa31d 100644
--- a/boards/beagleconnect/freedom/index.rst
+++ b/boards/beagleconnect/freedom/index.rst
@@ -3,6 +3,8 @@
BeagleConnect Freedom
#####################
+:bdg-danger:`Work in progress`
+
BeagleConnectâ„¢ Freedom is an open-hardware wireless hardware platform developed by BeagleBoard.org and built around the TI CC1352P7 microcontroller, which supports both
2.4-GHz and long-range, low-power Sub-1 GHz wireless protocols. Rapidly prototyping of IoT applications is accelerated by hardware compatibility with over 1,000 mikroBUS add-on sensors,
acutators, indicators and additional connectivity and storage options, and backed with software support utilizing the Zephyr scalable and modular real-time operating system, allowing developers
@@ -16,11 +18,6 @@ over-the-air upgrades (OTA) capability. This MCU provides flexible support for m
:align: center
:alt: BeagleConnectâ„¢ Freedom board
-.. important::
-
- This is a work in progress, for latest documentation please
- visit https://docs.beagleboard.org/latest/
-
.. only:: html
.. grid:: 1 1 2 2
diff --git a/boards/beagleplay/04-expansion.rst b/boards/beagleplay/04-expansion.rst
index bc7cab08a6cef66ed1af7d1024a0bd69a8b98b1a..49f6fb193fd774131f6bb6cafb83c879813d590b 100644
--- a/boards/beagleplay/04-expansion.rst
+++ b/boards/beagleplay/04-expansion.rst
@@ -3,9 +3,11 @@
Expansion
#########
-.. note::
+:bdg-danger:`Work in progress`
- This chapter is a work in progress and will include information on building expansion hardware for BeaglePlay.
+.. todo::
+
+ Add information on building expansion hardware for BeaglePlay.
mikroBUS
*********
diff --git a/boards/beagleplay/index.rst b/boards/beagleplay/index.rst
index 72a4f6558b7148b61b2739360ed5758eb61fb0c4..05fc1f8fbc5c27864fd5fe06bccb0b60e543bd19 100644
--- a/boards/beagleplay/index.rst
+++ b/boards/beagleplay/index.rst
@@ -3,9 +3,7 @@
BeaglePlay
##########
-.. important::
- This is a work in progress, for latest documentation please
- visit https://docs.beagleboard.org/latest/
+:bdg-danger:`Work in progress`
BeaglePlay is an open-source single board computer based on the Texas Instruments AM6254 quad-core Cortex-A53 Arm SoC designed to simplify the process of adding
sensors, actuators, indicators, human interfaces, and connectivity to a reliable embedded system.
diff --git a/boards/beaglev/ahead/index.rst b/boards/beaglev/ahead/index.rst
index 1cf55ee1d68636a9a6e75c4bfba86f3bbb409feb..4a98a0d6cda4d1b420355f20fa34c85358ddb603 100644
--- a/boards/beaglev/ahead/index.rst
+++ b/boards/beaglev/ahead/index.rst
@@ -3,6 +3,8 @@
BeagleV-Ahead
###################
+:bdg-danger:`Work in progress`
+
BeagleV-Ahead is a high-performance open-source RISC-V single board computer (SBC) built around the Alibaba TH1520 SoC. It has the same P8 & P9 cape header pins as
BeagleBone Black allowing you to stack your favourite BeagleBone cape on top to expand it's capability.
Featuring a powerful quad-core RISC-V processor BeagleV Ahead is designed as an affordable
@@ -12,10 +14,6 @@ RISC-V enabled pocket-size computer for anybody who want's to dive deep into the
:align: center
:alt: BeagleV Ahead with hand
-.. important::
- This is a work in progress, for latest documentation please
- visit https://docs.beagleboard.org/latest/
-
.. only:: html
.. grid:: 1 1 2 2
diff --git a/boards/beaglev/fire/04-expansion.rst b/boards/beaglev/fire/04-expansion.rst
index 304e0a51df290a83996d01902e60cf9dc0267401..eed3e59cab65d4c5f597f0588ff31734e24d093a 100644
--- a/boards/beaglev/fire/04-expansion.rst
+++ b/boards/beaglev/fire/04-expansion.rst
@@ -3,10 +3,12 @@
Expansion
#########
+:bdg-danger:`Work in progress`
+
Cape Headers
*************
-.. important:: This page is a work in progress, don't use if for debugging.
+.. todo:: Add information for custom hardware building and debugging.
The expansion interface on the board is comprised of two headers P8 (46 pin) & P9 (46 pin).
All signals on the expansion headers are **3.3V** unless otherwise indicated.
diff --git a/boards/beaglev/fire/index.rst b/boards/beaglev/fire/index.rst
index 9ef918e2c4a1b46658778917edf6256b3583f1a9..fc634c01af59ecb7fef468dd434050adb30fbd59 100644
--- a/boards/beaglev/fire/index.rst
+++ b/boards/beaglev/fire/index.rst
@@ -3,6 +3,8 @@
BeagleV-Fire
###################
+:bdg-danger:`Work in progress`
+
BeagleV®-Fire is a revolutionary SBC powered by the Microchip's PolarFire® MPFS025T RISC-V System on Chip
(SoC) with FPGA fabric. BeagleV®-Fire opens up new horizons for developers, tinkerers, and the open-source community to explore the vast potential
of RISC-V architecture and FPGA technology. It has the same P8 & P9 cape header pins as BeagleBone Black allowing you to stack your favorite BeagleBone
@@ -13,10 +15,6 @@ BeagleV®-Fire SBC offers unparalleled opportunities for developers, hobbyists,
:align: center
:alt: BeagleV-Fire hero image
-.. important::
- This is a work in progress, for latest documentation please
- visit https://docs.beagleboard.org/latest/
-
.. only:: html
.. grid:: 1 1 2 2
diff --git a/boards/beagley/ai/01-introduction.rst b/boards/beagley/ai/01-introduction.rst
index d79f7a939cfdf225d64f9a32c71b60043e7cfb33..a430e1edc641018b77990c0a7810ad005f38e6d9 100644
--- a/boards/beagley/ai/01-introduction.rst
+++ b/boards/beagley/ai/01-introduction.rst
@@ -5,7 +5,7 @@ Introduction
BeagleY-AI is an open-source single board computer designed for edge AI applications.
-.. image:: images/beagley-ai-board.png
+.. image:: images/beagley-ai-board.*
.. _beagley-ai-detailed-overview:
@@ -54,10 +54,41 @@ I/O and control, a 50 GFlop GPU, video and vision accelerators, and other specia
| Tag Connect | 1 x JTAG, 1 x External PMIC programming port |
+-----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+
+.. _AM67A: https://www.ti.com/product/AM67A
+
AM67A SoC
=========
-.. todo:: Add AM67A SoC details
+The `AM67A`_ scalable processor family is based on the evolutionary Jacintoâ„¢ 7 architecture, targeted at Smart
+Vision Camera and General Compute applications and built on extensive market knowledge accumulated over
+a decade of TI’s leadership in the Vision processor market. The `AM67A`_ family is built for a broad set of
+cost-sensitive high performance compute applications in Factory Automation, Building Automation, and other
+markets.
+
+Some Applications include:
+
+- Human Machine Interface (HMI)
+- Hospital patient monitoring
+- Industrial PC
+- Building security system
+- Off-highway vehicle
+- Test and measurement
+- Energy storage systems
+- Video Surveillance
+- Machine Vision
+- Industrial mobile robot (AGV/AMR)
+- Front camera systems
+
+
+
+The `AM67A`_ provides high performance compute technology for both traditional and deep learning algorithms
+at industry leading power/performance ratios with a high level of system integration to enable scalability and
+lower costs for advanced vision camera applications. Key cores include the latest Arm and GPU processors for
+general compute, next generation DSP with scalar and vector cores, dedicated deep learning and traditional
+algorithm accelerators, an integrated next generation imaging subsystem (ISP), video codec, and MCU cores. All
+protected by industrial-grade security hardware accelerators.
+
+.. tip:: For more information about AM67A SoC you can checkout https://www.ti.com/product/AM67A
Board components location
***************************
diff --git a/boards/beagley/ai/02-quick-start.rst b/boards/beagley/ai/02-quick-start.rst
index bd8d7443dfd544e6d2a9861cc1c64fcfb149ef3d..f99ccd1d039b2e530b1e948fde56ed9284b643d3 100644
--- a/boards/beagley/ai/02-quick-start.rst
+++ b/boards/beagley/ai/02-quick-start.rst
@@ -6,16 +6,12 @@ BeagleY-AI Quick Start
What's included in the box?
****************************
-.. todo:: Update BeagleY-AI what's included in the box section as per production release.
-
When you purchase a BeagleY-AI, you'll get the following in the box:
1. `BeagleY-AI <https://www.beagleboard.org/boards/beagley-ai>`_
2. 2.4GHz antenna
3. Quick-start card
-.. tip:: For board files, 3D model, and more, you can checkout the `BeagleY-AI repository on OpenBeagle <https://openbeagle.org/beagley-ai/beagley-ai>`_.
-
.. todo:: Attaching antennas instructions for BeagleY-AI
.. todo:: BeagleY-AI unboxing video
@@ -23,106 +19,301 @@ When you purchase a BeagleY-AI, you'll get the following in the box:
Getting started
***************
-To get started you need the following:
+To get started your BeagleY-AI you need the following:
+
+1. :ref:`5V @ 3A power supply <accessories-power-supplies>`
+2. MicromicroSD card (32GB)
+3. :ref:`beagley-ai-boot-media`
+
+You may need additional accessories based on the mode of operation, you can use your BeagleY-AI in different ways.
+
+1. :ref:`USB Tethering by directly connecting via USB type-c port <beagley-ai-usb-tethering>`
+2. :ref:`Headless connection via UART debug port <beagley-ai-headless>`
+3. :ref:`Standalone connection with Monitor and other peripherals attached <standalone-connection>`
+
+Easiest option is to connect the board directly to your PC or Laptop using a USB type-C to type-c cable. There is only one USB type-C port on board, if you
+choose to use a dedicated power supply for first time setup, you may choose to access the board via any other methods listed above.
+
+Power Supply
+**************
+
+To power the board you can either connect it to a dedicated power supply like a mobile charger or a wall adapter that
+can provide 5V ≥ 3A. Checkout the :ref:`docs power supply page <accessories-power-supplies>` for power supply recommendations.
+
+.. note::
+ Instead of using a :ref:`power supply or power adapter <accessories-power-supplies>` if you are using a :ref:`Type-C to Type-C cable
+ <accessories-cables-usb>` to connect the board to your laptop/PC then make sure it can supply at least 1000mA.
+
+.. _beagley-ai-boot-media:
-1. :ref:`USB type-A to type-C cable or type-C to type-C cable <accessories-cables-usb>`
-2. :ref:`5V - 3A power supply <accessories-power-supplies>`
-3. MicroSD Card
-4. Boot media
+Boot Media (Software image)
+*****************************
-Boot Media
-===========
+.. todo:: Update this section to use latest boot media (software image) for BeagleY-AI.
Download the boot media from
`https://www.beagleboard.org/distros/beagley-ai-debian-xfce-12-5-2024-03-25 <https://www.beagleboard.org/distros/beagley-ai-debian-xfce-12-5-2024-03-25>`_
-and flash it on a micro SD Card using using `Balena Etcher <https://etcher.balena.io/>`_ following these steps:
+and flash it on a micro microSD card using using `Balena Etcher <https://etcher.balena.io/>`_ following these steps:
1. Select downloaded boot media
-2. Select SD Card
+2. Select microSD card
3. Flash!
-.. image:: images/balena-etcher.*
+.. tip:: For more detailed steps checkout the :ref:`beagleboard-getting-started` under support section of the documentation.
-Once flashed, you can insert the SD card into your BeagleY-AI as shown in the image below:
+.. figure:: images/balena-etcher.*
+ :align: center
+ :alt: Flashing BeagleY-AI boot image (software image) to microSD card
-.. image:: images/beagley-ai-micro-sd-card.*
+ Flashing BeagleY-AI boot image (software image) to microSD card
-Power Supply
-=============
+Once the microSD card is flashed you should see ``BOOT`` and ``rootfs`` mounted on your system as shown in image below,
-To power the board you can either connect it to a dedicated power supply like a mobile charger or a wall adapter that
-can provide 5V ≥ 3A. Checkout the `docs power supply page <https://docs.beagleboard.org/latest/accessories/power-supplies.html#accessories-power-supplies>`_
-for power supply recommendations.
+.. figure:: images/disk.*
+ :align: center
+ :alt: Flashed microSD card mounted partitions
+
+ Flashed microSD card mounted partitions
+
+Under ``BOOT`` partition open ``sysconf.txt`` to edit login ``username`` and ``password``.
+
+.. figure:: images/sysconf.*
+ :align: center
+ :alt: sysconf file under BOOT partition
+
+ sysconf file under BOOT partition
+
+In ``sysconf.txt`` file you have to edit the two lines highlighted below.
+
+.. callout::
+
+ .. code-block:: text
+ :linenos:
+ :lineno-start: 29
+ :emphasize-lines: 2,5
-Board connection
-=================
+ # user_name - Set a user name for the user (1000)
+ #user_name=beagle <1>
-There is only one USB type-C port on board, if you choose to use a dedicated power supply for first time setup, you may access the board via one of the following methods:
+ # user_password - Set a password for user (1000)
+ #user_password=FooBar <2>
-1. Connection to HDMI display, Keyboard and Mouse
-2. UART using RPi debug probe or similar
-3. Ethernet network connection
+ .. annotations::
-Another direct and easy option is to connect the board directly to your PC or Laptop using a USB type-C cable.
+ <1> If ``boris`` is your username, update ``#user_name=beagle`` to ``user_name=boris``
+
+ <2> If ``bash`` is your password, update ``#user_password=FooBar`` to ``user_password=bash``
.. note::
- If you are using the board with a fan or running a heavy task you should always power
- the board with a dedicated power supply that can supply 5V ≥ 3A.
+ Make sure to remove ``#`` from in front of these lines else the lines will still be
+ interpreted like a comment and your username & password will not be updated.
+
+Once username and password are updated, you can insert the microSD card into
+your BeagleY-AI as shown in the image below:
+
+.. figure:: images/beagley-ai-micro-sd-card.*
+ :align: center
+ :alt: Insert microSD card in BeagleY-AI
+
+ Insert microSD card in BeagleY-AI
+
+.. _beagley-ai-usb-tethering:
USB Tethering
-==============
+**************
+
+.. note::
+ If you are using the board with a fan or running a computationally intensive
+ task you should always power the board with a dedicated power supply that can supply 5V ≥ 3A (15W+).
+
+ As per USB standards these are the current at 5V that each downstream USB port type can (max) supply:
+
+ - USB Type-A 3.x port - 900mA (4.5W)
+ - USB Type-C 1.2 port - 1500mA (7.5W) to 3000mA (15W)
+
+ Thus it's recommended to use type-C to type-C cable.
+
+To initially test your board, you can connect the board directly to your computer using a ``type-C to type-C`` cable shown in the image below.
+
+.. figure:: images/beagley-ai-tethered-connection.*
+ :align: center
+ :alt: BeagleY-AI tethered connection
+
+ BeagleY-AI tethered connection
+
+SSH connection
+===============
+
+After connecting, you should see the power LED glow, and soon just like with other Beagles, BeagleY-AI will create a virtual wired connection on your computer.
+To access the board, open up a terminal (`Linux <https://www.wikihow.com/Open-a-Terminal-Window-in-Ubuntu>`_/`Mac <https://www.wikihow.com/Open-a-Terminal-Window-in-Mac>`_)
+or command prompt (`Windows <https://www.wikihow.com/Open-the-Command-Prompt-in-Windows>`_) and use the SSH command as shown below.
+
+.. code:: shell
+
+ ssh debian@192.168.7.2
+
+.. tip:: If you are not able to find your beagle at ``192.168.7.2`` make sure to checkout :ref:`start-browse-to-beagle` to resolve your connection issue.
+
+.. important:: If you have not updated your default username and password during :ref:`beagley-ai-boot-media`, you must update the default password at this step to something safer.
+
+.. figure:: images/ssh-connection.*
+ :align: center
+ :alt: BeagleY-AI SSH connection
-To initially test your board, you can connect the board directly to your computer using a type-A to type-C cable shown in the image below.
+ BeagleY-AI SSH connection
-.. image:: images/beagley-ai-tethered-connection.*
+UART connection
+================
-After connecting, you should see the power LED glow, and soon just like with other Beagles, you’ll see a virtual wired connection on your computer. To access the board you can use SSH as shown below.
+Your BeagleY-AI board creates a UART connection (No additional hardware required) when tethered to a Laptop/PC which you can access using ``Putty`` of ``tio``.
+On a linux machine it may come up as ``dev/ttyACM*``, it will be different for Mac and Windows operatig systems. To find serial port for your system you can checkout
+`this guide <https://www.mathworks.com/help/matlab/supportpkg/find-arduino-port-on-windows-mac-and-linux.html;jsessionid=c2d3127cd10411c66f33468cbd5b>`_.
-.. note::
- Here you must update the default password to something safer.
+.. figure:: images/uart/putty.*
+ :align: center
+ :alt: Putty serial connection
-.. image:: images/ssh-connection.*
+ Putty serial connection
-Using BeagleY-AI
-=================
+- If you are on linux, try ``tio`` with default setting using command below,
-To setup your BeagleY-AI for normal usage, connect the following:
+.. code:: console
- 1. 5V ≥ 3A power supply
- 2. HDMI monitor using micro HDMI to full-size HDMI cable
- 3. Ethernet cable from the board to your router
- 4. Wireless or wired keyboard & mice
+ tio /dev/ttyACM0
-.. image:: images/beagley-ai-tethered-connection.*
+With this you have the access to BeagleY-AI terminal. Now, you can connect your board to :ref:`WiFi <beagley-ai-connecting-wifi>`,
+try out all the :ref:`cool demos <beagley-ai-demos>` and explore all the other ways to access your BeagleY-AI listed below.
+
+- :ref:`beagley-ai-connecting-wifi`
+- :ref:`beagley-ai-demos`
+
+.. _beagley-ai-headless:
+
+Headless connection
+===================
+
+If you want to run your BeagleY-AI in headless mode, you need `Raspberry Pi Debug Probe <https://www.raspberrypi.com/documentation/microcontrollers/debug-probe.html>`_ or similar serial adapter.
+
+.. todo:: Add images and description for this section.
+
+.. _standalone-connection:
+
+Standalone connection
+=====================
+
+To setup your BeagleY-AI for standalone usage, you need the following additional accessories,
+
+1. HDMI monitor
+2. micro HDMI to full-size HDMI cable
+3. Wireless keyboard & mice combo
+4. Ethernet cable (Optional)
+
+Make sure you have the microSD card with boot media (software image) inserted in to the BeagleY-AI. Now connect,
+
+1. microHDMI to BeagleY-AI and full size HDMI to monitor
+2. keyboard and mice combo to one of the four USB port of BeagleY-AI
+3. Power supply to USB type-c connector of BeagleY-AI
+
+The connection diagram below provides a clear representation of all the connections,
+
+.. figure:: images/standalone.*
+ :align: center
+ :alt: BeagleY-AI standalone connection
+
+ BeagleY-AI standalone connection
If everything is connected properly you should see four penguins on your monitor.
-.. image:: images/boot-penguins.*
+.. figure:: images/boot-penguins.*
+ :align: center
+ :alt: BeagleY-AI boot penguins
+
+ BeagleY-AI boot penguins
When prompted, log in using the updated login credentials you updated during the USB tethering step.
-.. note:: You can not update login credentials at this step, you must update them during USB tethering step!
+.. Important:: You can not update login credentials at this step, you must update them during boot media (software image) micrSD card flashing or USB tethering step!
-.. image:: images/login.*
+.. figure:: images/login.*
+ :align: center
+ :alt: BeagleY-AI XFCE desktop login
+
+ BeagleY-AI XFCE desktop login
Once logged in you should see the splash screen shown in the image below:
-.. image:: images/screen-saver.*
+.. figure:: images/screen-saver.*
+ :align: center
+ :alt: BeagleY-AI XFCE home screen
+
+ BeagleY-AI XFCE home screen
Test network connection by running ping 8.8.8.8
-.. image:: images/ping-test.*
+.. figure:: images/ping-test.*
+ :align: center
+ :alt: BeagleY-AI network ping test
+
+ BeagleY-AI network ping test
Explore and build with your new BeagleY-AI board!
-.. image:: images/htop.*
+.. figure:: images/htop.*
+ :align: center
+ :alt: BeagleY-AI running htop
+
+ BeagleY-AI running htop
+
+.. _beagley-ai-connecting-wifi:
Connecting to WiFi
-===================
+**********************
+
+We have two options to connect to WiFi,
+
+1. :ref:`beagley-ai-nmtui`
+2. :ref:`beagley-ai-iwctl`
+
+.. _beagley-ai-nmtui:
+
+nmtui
+======
+
+- Enable ``NetworkManager``
+
+.. code:: console
+
+ sudo systemctl enable NetworkManager
+
+- Start ``NetworkManager``
+
+.. code:: console
+
+ sudo systemctl start NetworkManager
-Connect 2x antennas to your BeagleY-AI board if not pre-attached.
+- Start ``nmtui`` application
-After successfully attaching the antenna, power up the board. Once booted you can follow the commands below to connect to any WiFi access point,
+.. code:: console
+
+ sudo nmtui
+
+- To navigate, use the ``arrow keys`` or press ``Tab`` to step forwards and press ``Shift+Tab`` to step back through the options. Press ``Enter`` to select an option. The ``Space bar`` toggles the status of a check box.
+- You should see a screen as shown below, here you have to press ``Enter`` on ``Acticate a connection`` option to `activate wired and wireless connection options <https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/networking_guide/sec-configuring_ip_networking_with_nmtui>`_.
+
+.. figure:: images/wifi/nmtui.*
+ :align: center
+ :alt: NetworkManager TUI
+
+ NetworkManager TUI
+
+There under ``WiFi`` section press ``Enter`` on desired access point and provide password to connect. When successfully connected press ``Esc`` to get out of the ``nmtui`` application window.
+
+.. _beagley-ai-iwctl:
+
+iwctl
+======
+
+Once board is fully booted and you have access to the shell, follow the commands below to connect to any WiFi access point,
- To list the wireless devices attached, (you should see wlan0 listed)
@@ -166,6 +357,11 @@ After successfully attaching the antenna, power up the board. Once booted you ca
ping 8.8.8.8
+Attach fan
+***********
+
+.. todo:: add instructions to attach raspberrypi official fan.
+
Demos and Tutorials
*******************
diff --git a/boards/beagley/ai/03-design.rst b/boards/beagley/ai/03-design.rst
index 36459af41dbb498a13ddee7cf396819b768a3b11..7c4d4d1c401ba62d1613ff039bff34594265e2a4 100644
--- a/boards/beagley/ai/03-design.rst
+++ b/boards/beagley/ai/03-design.rst
@@ -11,6 +11,8 @@ If you want to know how BeagleY-AI is designed and the detailed specifications,
this chapter is for you. We are going to attept to provide you a short and crisp overview
followed by discussing each hardware design element in detail.
+.. tip:: For board files, 3D model, and more, you can checkout the `BeagleY-AI repository on OpenBeagle <https://openbeagle.org/beagley-ai/beagley-ai>`_.
+
Block diagram and overview
***************************
@@ -38,6 +40,12 @@ Block diagram and overview
SoC
****
+.. figure:: images/am67a.png
+ :align: center
+ :alt: AM67A block diagram
+
+ AM67A block diagram
+
.. figure:: images/hardware-design/beagley-ai-soc-csi-0123.*
:width: 1040
:align: center
diff --git a/boards/beagley/ai/demos/beagley-ai-arducam-imx219-v3link-dual-camera-kit.rst b/boards/beagley/ai/demos/beagley-ai-arducam-imx219-v3link-dual-camera-kit.rst
index adb3467a1b559bb5fc8977d25e27d72379b9d8af..9af40a96ffaf86d44c287e8fcb3248e2ff463de5 100644
--- a/boards/beagley/ai/demos/beagley-ai-arducam-imx219-v3link-dual-camera-kit.rst
+++ b/boards/beagley/ai/demos/beagley-ai-arducam-imx219-v3link-dual-camera-kit.rst
@@ -3,7 +3,9 @@
Using the Arducam Dual V3Link Camera Kit
############################################
-.. todo:: This page is a work in progress. Further drive testing and images will be added soon
+:bdg-danger:`Work in progress`
+
+.. todo:: Add further testing steps, results, and images.
`The Arducam Dual V3Link Camera Kit <https://www.arducam.com/product/arducam-imx219-v3link-camera-kit-for-raspberry-pi/>`_ is an IMX219 based kit that leverages Texas Instruments' FPDLink technology to enable using two CSI cameras over a single port up to 15 meters away using twisted pair cables.
diff --git a/boards/beagley/ai/demos/beagley-ai-pca9685-motor-drivers.rst b/boards/beagley/ai/demos/beagley-ai-pca9685-motor-drivers.rst
index ee726c61920187ef81654f0d119a892471ed1b30..e3e235c6a7b2d466fd7d8dfc8fd4365a732083b0 100644
--- a/boards/beagley/ai/demos/beagley-ai-pca9685-motor-drivers.rst
+++ b/boards/beagley/ai/demos/beagley-ai-pca9685-motor-drivers.rst
@@ -1,6 +1,8 @@
.. _beagley-ai-pca9685-motor-drivers:
-.. note:: This page is a work in progress. Further drive testing and images will be added soon
+:bdg-danger:`Work in progress`
+
+.. todo:: Add further testing steps, results, and images.
Using PCA9685 Motor Drivers
#############################
diff --git a/boards/beagley/ai/demos/beagley-ai-using-gpio.rst b/boards/beagley/ai/demos/beagley-ai-using-gpio.rst
index 85cbcb56c1e168d11d58f8cddeaad57bbf624d85..fbc1d870565fc52345d37762b52f1ee9382cd6c9 100644
--- a/boards/beagley/ai/demos/beagley-ai-using-gpio.rst
+++ b/boards/beagley/ai/demos/beagley-ai-using-gpio.rst
@@ -3,7 +3,9 @@
Using GPIO
#################
-.. todo:: This page is a work in progress. Further testing and images will be added soon!
+:bdg-danger:`Work in progress`
+
+.. todo:: Add information about software image used for this demo.
**GPIO** stands for **General-Purpose Input/Output**. It's a set of programmable pins that you can use to connect and control various electronic components.
@@ -13,7 +15,7 @@ the physical world using code!
A great resource for understanding pin numbering can be found at `pinout.beagley.ai <https://pinout.beagley.ai/>`_
-.. note:: **WARNING** - BeagleY-AI GPIOs are 3.3V tolerant, using higher voltages WILL damage the processor!
+.. warning:: BeagleY-AI GPIOs are 3.3V tolerant, using higher voltages **WILL DAMAGE** the processor!
Pin Numbering
**********************
@@ -53,32 +55,62 @@ to simulate a button press.
GPIO Write
***********
+Before using any pin with HAT Pin number we need to configure it using command below,
+
+.. code:: console
+
+ sudo beagle-pin-mux --pin hat-08 --mode gpio
+
+.. figure:: ../images/gpio/led-pin8.*
+ :align: center
+ :alt: LED connected to HAT Pin8
+
+ LED connected to HAT Pin8
+
At it's most basic, we can set a GPIO using the **gpioset** command.
-To set HAT **Pin 8** to **ON**:
+- To set HAT **Pin 8** to **ON**:
.. code:: console
gpioset hat-08-gpio 0=1
-.. image:: ../images/gpio/on.png
- :width: 50 %
+.. figure:: ../images/gpio/on.png
:align: center
+ :alt: GPIO ON state
-To set HAT **Pin 8** to **OFF**:
+ GPIO ON state
+
+- To set HAT **Pin 8** to **OFF**:
.. code:: console
gpioset hat-08-gpio 0=0
-.. image:: ../images/gpio/off.png
- :width: 50 %
+.. figure:: ../images/gpio/off.png
:align: center
+ :alt: GPIO OFF state
+
+ GPIO OFF state
Blink an LED
-**********************
+**************
+
+Let's create a script called **blinky.sh**,
-Let's write a script called **blinky.sh** that contains the following:
+- Create the file,
+
+.. code:: console
+
+ touch blinky.sh
+
+- Open the file using ``nano`` editor,
+
+.. code:: console
+
+ nano blinky.sh
+
+- Copy paste the code below to ``blinky.sh`` file,
.. code:: bash
@@ -92,51 +124,98 @@ Let's write a script called **blinky.sh** that contains the following:
sleep 1
done
-The script is quite simple, it's an infinite "while" loop in which we do the following:
-
-1. set the HAT Pin 8 as 1 (HIGH)
-2. Wait 1 Second
-3. set the HAT Pin 8 as 0 (LOW)
-4. Wait 1 Second
+- Close the editor by pressing ``Ctrl + O`` followed by ``Enter`` to save the file and then press to ``Ctrl + X`` exit
-Now execute it by typing:
+- Now execute the ``blinky.sh`` script by typing:
.. code:: console
bash blinky.sh
-.. image:: ../images/gpio/blinky.gif
- :width: 50 %
+.. figure:: ../images/gpio/blinky.gif
:align: center
+ :alt: LED blinking
-You can exit by pressing ``Ctrl + c`` on your keyboard.
+ LED blinking
-GPIO Read
-**********
+- You can exit the ``blinky.sh`` progrm by pressing ``CTRL + C`` on your keyboard.
-Reading GPIOs can be done using the ``gpioget`` command
+Understanding the code
+======================
-.. code:: console
+.. callout::
- gpioget hat-08-gpio 0
-
-Results in **1** if the Input is held **HIGH** or **0** if the Input is held **LOW**
+ .. code-block:: bash
+
+ #!/bin/bash
+
+ while :
+ do
+ gpioset hat-08-gpio 0=1 <1>
+ sleep 1 <2>
+ gpioset hat-08-gpio 0=0 <3>
+ sleep 1 <4>
+ done
+
+ .. annotations::
+
+ The script is an infinite ``while`` loop in which we do the following:
+
+ <1> set the HAT Pin 8 as 1 (HIGH)
+
+ <2> Wait 1 Second
+
+ <3> set the HAT Pin 8 as 0 (LOW)
+
+ <4> Wait 1 Second
Read a Button
**************
-A push button simply completes an electric circuit when pressed. Depending on wiring, it can drive a signal either "Low" (GND) or "High" (3.3V)
+A push button simply completes an electric circuit when pressed. Depending on wiring, it can drive a signal either "Low" (GND) or "High" (3.3V).
+
+We will connect our Button between HAT Pin 12 (GPIO18) and Ground (GND).
+
+.. figure:: ../images/gpio/switch-pin12.*
+ :align: center
+ :alt: Button connected to HAT Pin12
+
+ Button connected to HAT Pin12
+
+- Configure pin12 as ``gpio`` using command below,
-We will connect our Button between HAT Pin 16 (GPIO23) and Ground (GND).
+.. code:: console
+
+ sudo beagle-pin-mux --pin hat-12 --mode gpio-pu
The cool part is since we have an internal pull-up resistor, we don't need an external one!
The pull resistor guarantees that the Pin stays in a known (HIGH) state unless the button is pressed,
in which case it will go LOW.
-.. todo:: Add fritzing diagram here
+- Reading GPIOs can be done using the ``gpioget`` command
+
+.. code:: console
+
+ gpioget hat-12-gpio-pu 0
+
+Results in ``1`` if the Input is held ``HIGH`` or ``0`` if the Input is held ``LOW``
-Let's write a script called **button.sh** to continuously read an input pin connected
-to a button and print out when it's pressed! :
+Let's create a script called ``button.sh`` to continuously read an input pin connected
+to a button and print out when it's pressed!
+
+- Create the file,
+
+.. code:: console
+
+ touch button.sh
+
+- Open the file using ``nano`` editor,
+
+.. code:: console
+
+ nano button.sh
+
+- Copy paste the code below to ``button.sh`` file,
.. code:: bash
@@ -144,18 +223,48 @@ to a button and print out when it's pressed! :
while :
do
- if (( $(gpioget hat-12-gpio 0) == 0))
+ if (( $(gpioget hat-12-gpio-pu 0) == 0))
then
echo "Button Pressed!"
fi
done
+- Close the editor by pressing ``Ctrl + O`` followed by ``Enter`` to save the file and then press to ``Ctrl + X`` exit
+
+- Now execute the ``button.sh`` script by typing:
+
+.. code:: console
+
+ bash button.sh
+
+- You can exit the ``button.sh`` by pressing ``Ctrl + C`` on your keyboard.
+
Combining the Two
**********************
+.. figure:: ../images/gpio/switch-pin12-led-pin8.*
+ :align: center
+ :alt: Button connected to HAT Pin12 & LED connected to HAT Pin8
+
+ Button connected to HAT Pin12 & LED connected to HAT Pin8
+
Now, logically, let's make an LED match the state of the button.
-Let's modify our script and call it **blinkyButton.sh**:
+Let's create a script called **blinkyButton.sh**:
+
+- Create the file,
+
+.. code:: console
+
+ touch blinkyButton.sh
+
+- Open the file using ``nano`` editor,
+
+.. code:: console
+
+ nano blinkyButton.sh
+
+- Copy paste the code below to ``blinkyButton.sh`` file,
.. code:: bash
@@ -163,7 +272,7 @@ Let's modify our script and call it **blinkyButton.sh**:
while :
do
- if (( $(gpioget hat-12-gpio 0) == 0))
+ if (( $(gpioget hat-12-gpio-pu 0) == 0))
then
gpioset hat-08-gpio 0=1
else
@@ -171,29 +280,33 @@ Let's modify our script and call it **blinkyButton.sh**:
fi
done
-This means when we see HAT Pin 12 go LOW, we know the button is pressed, so we set HAT Pin 8 (our LED) to ON, otherwise, we turn it OFF.
+- Close the editor by pressing ``Ctrl + O`` followed by ``Enter`` to save the file and then press to ``Ctrl + X`` exit
-Now execute it by typing:
+- Now execute the ``blinkyButton.sh`` script by typing:
.. code:: console
- bash blinkyButton.sh.sh
+ bash blinkyButton.sh
-.. image:: ../images/gpio/BlinkyButton.gif
- :width: 50 %
+This means when we see HAT Pin 12 go LOW, we know the button is pressed,
+so we set HAT Pin 8 (our LED) to ON, otherwise, we turn it OFF.
+
+.. figure:: ../images/gpio/BlinkyButton.gif
:align: center
+ :alt: LED is ON when button is pressed
-You can exit by pressing **Ctrl + c** on your keyboard.
+ LED is ON when button is pressed
+- You can exit the ``blinkyButton.sh`` program by pressing ``Ctrl + C`` on your keyboard.
Understanding Internal Pull Resistors
*******************************************
Pull-up and pull-down resistors are used in digital circuits to ensure that inputs to logic settle at expected levels.
-* Pull-up resistors: Connect the input to a high voltage level (e.g., 3.3V) to ensure the input reads as a logic high (1) when no active device is pulling it low.
+* ``Internal pull-up resistors`` connects the pin to a high voltage level (e.g., 3.3V) to ensure the pin input reads as a logic high (1) when no active device is pulling it low.
-* Pull-down resistors: Connect the input to ground (GND) to ensure the input reads as a logic low (0) when no active device is pulling it high.
+* ``Internal pull-down resistors`` connects the pin to ground (GND) to ensure the input reads as a logic low (0) when no active device is pulling it high.
These resistors prevent floating inputs and undefined states.
@@ -226,17 +339,17 @@ This article from SparkFun Electronics is a good basic primer - `Link <https://l
Troubleshooting
*******************
-* **My script won't run!**
+- **My script won't run!**
-Make sure you gave the script execute permissions first and that you're executing it with a **./** before
+Make sure you gave the script execute permissions first and that you're executing it with a ``./`` before
-To make it executable:
+- To make it executable:
.. code:: bash
chmod +X scriptName.sh
-To run it:
+- To run it:
.. code:: bash
@@ -246,17 +359,19 @@ To run it:
Bonus - Turn all GPIOs ON/OFF
*******************************
-.. image:: ../images/gpio/allonoff.gif
- :width: 50 %
+.. figure:: ../images/gpio/allonoff.gif
:align: center
+ :alt: All HAT GPIO toggle
+
+ All HAT GPIO toggle
-Copy and paste this with the button on the right to turn **all pins ON**.
+- Copy and paste this with the button on the right to turn **all pins ON**.
.. code:: bash
gpioset hat-03-gpio 0=1 ;\ gpioset hat-05-gpio 0=1 ;\ gpioset hat-08-gpio 0=1 ;\ gpioset hat-10-gpio 0=1 ;\ gpioset hat-11-gpio 0=1 ;\ gpioset hat-12-gpio 0=1 ;\ gpioset hat-13-gpio 0=1 ;\ gpioset hat-15-gpio 0=1 ;\ gpioset hat-16-gpio 0=1 ;\ gpioset hat-18-gpio 0=1 ;\ gpioset hat-19-gpio 0=1 ;\ gpioset hat-21-gpio 0=1 ;\ gpioset hat-22-gpio 0=1 ;\ gpioset hat-23-gpio 0=1 ;\ gpioset hat-24-gpio 0=1 ;\ gpioset hat-26-gpio 0=1 ;\ gpioset hat-29-gpio 0=1 ;\ gpioset hat-31-gpio 0=1 ;\ gpioset hat-32-gpio 0=1 ;\ gpioset hat-33-gpio 0=1 ;\ gpioset hat-35-gpio 0=1 ;\ gpioset hat-36-gpio 0=1 ;\ gpioset hat-37-gpio 0=1 ;\ gpioset hat-40-gpio 0=1
-Similarly, copy and paste this to turn **all pins OFF**.
+- Similarly, copy and paste this to turn **all pins OFF**.
.. code:: bash
diff --git a/boards/beagley/ai/demos/beagley-ai-using-imx219-csi-cameras.rst b/boards/beagley/ai/demos/beagley-ai-using-imx219-csi-cameras.rst
index eb9b66052430ec4250eb8edd3565c755ea9661da..0db5bb37e5083bf97b468fae2461873ba2cfb3a1 100644
--- a/boards/beagley/ai/demos/beagley-ai-using-imx219-csi-cameras.rst
+++ b/boards/beagley/ai/demos/beagley-ai-using-imx219-csi-cameras.rst
@@ -3,7 +3,9 @@
Using IMX219 CSI Cameras
############################
-.. note:: This page is a work in progress. Further drive testing and images will be added soon
+:bdg-danger:`Work in progress`
+
+.. todo:: Add further testing steps, results, and images.
To enable an IMX219 CSI camera, modify the following file: `/boot/firmware/extlinux/extlinux.conf`
diff --git a/boards/beagley/ai/demos/beagley-ai-using-pwm.rst b/boards/beagley/ai/demos/beagley-ai-using-pwm.rst
index 7a39a8fb30abd38b028e107d8f4ae54298afa957..0411d2f19a9367a768613c187f55cd8208710634 100644
--- a/boards/beagley/ai/demos/beagley-ai-using-pwm.rst
+++ b/boards/beagley/ai/demos/beagley-ai-using-pwm.rst
@@ -3,12 +3,14 @@
Pulse Width Modulation (PWM)
#############################
-.. todo:: This page is a work in progress. Further testing and images will be added soon
+:bdg-danger:`Work in progress`
+
+.. todo:: Add further testing steps, results, and images..
What is it
************
-PWM, or Pulse Width Modulation, is a technique used to control the amount of power delivered to an electronic device by breaking up the power signal into discrete ON and OFF periods.
+``PWM`` or ``Pulse Width Modulation``, is a technique used to control the amount of power delivered to an electronic device by breaking up the power signal into discrete ON and OFF periods.
The amount of time the signal spends ON during each cycle determines the output power level (brightness of the LED).
.. image:: ../images/gpio/pwm.jpg
@@ -19,27 +21,25 @@ The amount of time the signal spends ON during each cycle determines the output
How do we do it
*****************
-First we unbind the pin as GPIO
-
-.. code:: bash
+To configure HAT pin8 as PWM pin using ``beagle-pin-mux`` execute the command below,
- echo hat-08-gpio > /sys/bus/platform/drivers/gpio-aggregator/unbind
+.. code:: console
-Now we override the driver
+ sudo beagle-pin-mux --pin hat-08 --mode pwm
-.. code:: bash
+Let's create a script called ``fade.sh`` that cycles through LED brightness on HAT pin8 by changing PWM duty cycle.
- echo gpio-aggregator > /sys/devices/platform/hat-08-pwm/driver_override
+.. code:: console
-Then we bind the pin
+ touch fade.sh
-.. code:: bash
+Now open the file with nano editor,
- echo hat-08-pwm > /sys/bus/platform/drivers/gpio-aggregator/bind
+.. code:: console
-.. todo:: Add note about matching PWM channel to Pin
+ nano fade.sh
-Let's write a script called **fade.sh** that contains the following:
+In the editor copy paste the script content below,
.. code:: bash
@@ -68,15 +68,21 @@ Let's write a script called **fade.sh** that contains the following:
echo $i
sleep 0.0005
done
+- Close the editor by pressing ``Ctrl + O`` followed by ``Enter`` to save the file and then press to ``Ctrl + X`` exit
-Now execute it by typing:
+- Now execute the ``fade.sh`` script by typing:
.. code:: console
bash fade.sh
-.. image:: ../images/gpio/pwm.gif
+.. figure:: ../images/gpio/pwm.gif
:align: center
+ :alt: LED PWM fade demo
+
+ LED PWM fade demo
+
+- You can exit the ``fade.sh`` program by pressing ``Ctrl + C`` on your keyboard.
.. todo:: Add section about driving Servo Motors at 50KHz
diff --git a/boards/beagley/ai/demos/beagley-ai-using-rtc.rst b/boards/beagley/ai/demos/beagley-ai-using-rtc.rst
index a8c5d4056a7226bcca40978a4f875a70a99522a1..8593e5b76f1f81fd996b2bac860c0cfeaf9388a3 100644
--- a/boards/beagley/ai/demos/beagley-ai-using-rtc.rst
+++ b/boards/beagley/ai/demos/beagley-ai-using-rtc.rst
@@ -24,7 +24,7 @@ These batteries are available from several vendors:
* `Raspberry Pi 5 RTC Battery via Adafruit <https://www.adafruit.com/product/5817>`_
* `Raspberry Pi 5 RTC Battery via DigiKey <https://www.digikey.com/en/products/detail/raspberry-pi/SC1163/21658274>`_
* `CR2023 battery holder for Pi 5 via Amazon <https://www.amazon.com/KODASW-RTCBattery-Holder-Include-Battery/dp/B0CRKQ2MG1/>`_
-
+
.. image:: ../images/beagley_rtc.png
Uses for an RTC
@@ -43,7 +43,7 @@ Uses for an RTC
Reading time
**********************
-.. note:: If you have not connected your BeagleY-AI to a network so it can get time from an NTP server, you must set the time before being able to read it. If you don't do this first, you'll see errors.
+.. note:: You must set the time before being able to read it. If you don't do this first, you'll see errors. You may connect your BeagleY-AI to a network so it can get time from an NTP server.
Reading the current time on the RTC is achieved using the **hwclock** command.
diff --git a/boards/beagley/ai/demos/expansion-nvme.rst b/boards/beagley/ai/demos/expansion-nvme.rst
index 79a4db30193e96aefbc3e22dd853839432b46ae1..af7f531e860c7dc0c7f8bfb450b2fb8088a5ab2a 100644
--- a/boards/beagley/ai/demos/expansion-nvme.rst
+++ b/boards/beagley/ai/demos/expansion-nvme.rst
@@ -3,9 +3,9 @@
Booting from NVMe Drives
##########################
-.. todo:: remove notes about work-in-progress. they just make the site more janky.
+:bdg-danger:`Work in progress`
-.. note:: This page is a work in progress. Further drive testing and images will be added soon
+.. todo:: Add further testing steps, results, and images.
BeagleY-AI supports a PCI-Express x1 interface which enables data rates of up to 1GB/s for high speed expansion.
diff --git a/boards/beagley/ai/images/am67a.png b/boards/beagley/ai/images/am67a.png
new file mode 100644
index 0000000000000000000000000000000000000000..da5b7d78fb9838d97bdb3150d6400e84a1386c56
Binary files /dev/null and b/boards/beagley/ai/images/am67a.png differ
diff --git a/boards/beagley/ai/images/beagley-ai-in-hand.jpg b/boards/beagley/ai/images/beagley-ai-in-hand.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cbc85bf4baaa47b09b47a77cba19983c41167379
Binary files /dev/null and b/boards/beagley/ai/images/beagley-ai-in-hand.jpg differ
diff --git a/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg b/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg
index 7d610a61cd62ecb7eedb43b56dc0406d594d6fe1..50aa0f4c87d8722c4c3cb688e8e8bc712e254ce3 100644
Binary files a/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg and b/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg differ
diff --git a/boards/beagley/ai/images/beagley-ai-tethered-connection.png b/boards/beagley/ai/images/beagley-ai-tethered-connection.png
deleted file mode 100644
index 51c57198fc50febaf6db922619b00d6559708161..0000000000000000000000000000000000000000
Binary files a/boards/beagley/ai/images/beagley-ai-tethered-connection.png and /dev/null differ
diff --git a/boards/beagley/ai/images/disk.png b/boards/beagley/ai/images/disk.png
new file mode 100644
index 0000000000000000000000000000000000000000..84c69dd553d4ef2be49666b8de2e77f2330c1703
Binary files /dev/null and b/boards/beagley/ai/images/disk.png differ
diff --git a/boards/beagley/ai/images/gpio/led-pin8.png b/boards/beagley/ai/images/gpio/led-pin8.png
new file mode 100644
index 0000000000000000000000000000000000000000..67d6c27be418bc054c1bb2b431092b65b0881d7f
Binary files /dev/null and b/boards/beagley/ai/images/gpio/led-pin8.png differ
diff --git a/boards/beagley/ai/images/gpio/switch-pin12-led-pin8.png b/boards/beagley/ai/images/gpio/switch-pin12-led-pin8.png
new file mode 100644
index 0000000000000000000000000000000000000000..3be257a37a72e21331e55d9462deed5f6b1e5b7b
Binary files /dev/null and b/boards/beagley/ai/images/gpio/switch-pin12-led-pin8.png differ
diff --git a/boards/beagley/ai/images/gpio/switch-pin12.png b/boards/beagley/ai/images/gpio/switch-pin12.png
new file mode 100644
index 0000000000000000000000000000000000000000..db3174588bf6e3dbc0e43874aaa9e4b668421d9c
Binary files /dev/null and b/boards/beagley/ai/images/gpio/switch-pin12.png differ
diff --git a/boards/beagley/ai/images/sysconf.png b/boards/beagley/ai/images/sysconf.png
new file mode 100644
index 0000000000000000000000000000000000000000..750df3c7f98a5ebab1d57f730105d7fd6b1b1598
Binary files /dev/null and b/boards/beagley/ai/images/sysconf.png differ
diff --git a/boards/beagley/ai/images/uart/putty.png b/boards/beagley/ai/images/uart/putty.png
new file mode 100644
index 0000000000000000000000000000000000000000..308db6f8cd2ea65e9afbf7c5a9aa8f9bd5ff0330
Binary files /dev/null and b/boards/beagley/ai/images/uart/putty.png differ
diff --git a/boards/beagley/ai/images/wifi/nmtui.png b/boards/beagley/ai/images/wifi/nmtui.png
new file mode 100644
index 0000000000000000000000000000000000000000..8322eac8a221b40eeabd7c7e7989dca67fff2cef
Binary files /dev/null and b/boards/beagley/ai/images/wifi/nmtui.png differ
diff --git a/boards/beagley/ai/index.rst b/boards/beagley/ai/index.rst
index 035cdd4ca0cebd78c1fe9a4e32cae583ace8e933..50eb227140035f97e47004649f0281797502da43 100644
--- a/boards/beagley/ai/index.rst
+++ b/boards/beagley/ai/index.rst
@@ -3,13 +3,11 @@
BeagleY-AI
##########
-.. important::
- This is a work in progress, for latest documentation please
- visit https://docs.beagleboard.org/latest/
+:bdg-danger:`Work in progress`
BeagleY-AI is an open-source single board computer based on the Texas Instruments AM67A Arm-based vision processor.
-.. image:: images/beagley-ai-board.png
+.. image:: images/beagley-ai-in-hand.*
.. only:: html
diff --git a/gitlab-build.sh b/gitlab-build.sh
index 680a7452a4fe11308e594e116569ecfdec4d2409..d154d12ee57ee029dd70c8ef28bf6edc2cf07f4e 100755
--- a/gitlab-build.sh
+++ b/gitlab-build.sh
@@ -80,9 +80,9 @@ HERE
eval "$(ssh-agent -s)"
echo "${PRIVATE_KEY}" | base64 -d | ssh-add -
if [ "$VER_DIR" = "latest" ]; then
- rsync -v public/index.html docs@beagleboard.org:/var/www/docs/
+ rsync -e 'ssh -p 45 -o "StrictHostKeyChecking=no"' -vP public/index.html docs@beagleboard.org:/var/www/docs/
fi
- rsync -v -a --delete public/$VER_DIR/. docs@beagleboard.org:/var/www/docs/$VER_DIR
+ rsync -e 'ssh -p 45 -o "StrictHostKeyChecking=no"' -avP --delete public/$VER_DIR/. docs@beagleboard.org:/var/www/docs/$VER_DIR
fi
fi
}