diff --git a/boards/beagley/ai/02-quick-start.rst b/boards/beagley/ai/02-quick-start.rst index eec6c15e5180f7512b200a520e28354c8cf18f11..6c6a03e7e4add7060245134502f8d418325f668e 100644 --- a/boards/beagley/ai/02-quick-start.rst +++ b/boards/beagley/ai/02-quick-start.rst @@ -3,7 +3,153 @@ BeagleY-AI Quick Start ###################### -.. important:: Coming Soon! +.. todo:: What's included in the box? +.. todo:: Attaching antennas -For now, see https://www.beagleboard.org/app/uploads/2024/03/Getting-started-with-your-BeagleY-AI.pdf +Getting started +*************** + +To get started you need the following: + +1. USB Type-A to Type-C cable or Type-C to Type-C cable +2. 5V ≥ 3A power adapter +3. Micro SD Card +4. Boot media + +Boot Media +=========== + +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: + +1. Select downloaded boot media +2. Select SD Card +3. Flash! + +.. image:: images/balena-etcher.* + +Once flashed, you can insert the SD card into your BeagleY-AI as shown in the image below: + +.. image:: images/beagley-ai-micro-sd-card.* + +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 `docs power supply page <https://docs.beagleboard.org/latest/accessories/power-supplies.html#accessories-power-supplies>`_ +for recommended power supply. + +Board connection +================= + +There is only one USB type-c port on board, if you choose to use a dedicated power supply you have to access to board via any of the following methods: + +1. Connection to HDMI display, Keyboard and Mouse +2. UART using rpi pico debug probe or similar +3. Ethernet network connection + +Another direct and easy option is to connect the board directly to your PC or Laptop using a USB type-a to type-c cable. +This is not recommended if you are doing any heavy task on your BeagleY-AI but, for testing this should be fine. + +.. 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. + +USB Tethering +============== + +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. + +.. image:: images/beagley-ai-tethered-connection.* + +After connecting, you should see 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. + +.. note:: + Here you must update the default password to something safer. + +.. image:: images/ssh-connection.* + +Using BeagleY-AI +================= + +To setup your BeagleY-AI for normal usage, connect the following: + + 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 + +.. image:: images/beagley-ai-tethered-connection.* + +If everything is connected properly you should see four penguins on your monitor. + +.. image:: images/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! + +.. image:: images/login.* + +Once logged in you should see the splash screen shown in the image below: + +.. image:: images/screen-saver.* + +Test network connection by running ping 8.8.8.8 + +.. image:: images/ping-test.* + +Explore and build with your new BeagleY-AI board! + +.. image:: images/htop.* + +Connecting to WiFi +=================== + +Connect 2x antennas to your BeagleY-AI board if not pre-attached. + +After successfully attaching the antenna, power up the board. Once booted you can follow the commands below to connect to any WiFi access point, + +- To list the wireless devices attached, (you should see wlan0 listed) + +.. code:: shell + + iwctl device list + +- Scan WiFi using, + +.. code:: shell + + iwctl station wlan0 scan + +- Get networks using, + +.. code:: shell + + iwctl station wlan0 get-networks + +- Connect to your wifi network using, + +.. code:: + + iwctl --passphrase "<wifi-pass>" station wlan0 connect "<wifi-name>" + +- Check wlan0 status with, + +.. code:: + + iwctl station wlan0 show + +- To list the networks with connected WiFi marked you can again use, + +.. code:: + + iwctl station wlan0 get-networks + +- Test connection with ping command, + +.. code:: + + ping 8.8.8.8 \ No newline at end of file diff --git a/boards/beagley/ai/images/balena-etcher.png b/boards/beagley/ai/images/balena-etcher.png new file mode 100644 index 0000000000000000000000000000000000000000..d20061e954f73a4a275574320f25ef88a7e08c0b Binary files /dev/null and b/boards/beagley/ai/images/balena-etcher.png differ diff --git a/boards/beagley/ai/images/beagley-ai-micro-sd-card.jpg b/boards/beagley/ai/images/beagley-ai-micro-sd-card.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d936bc85d9069c7b169852a5209e9e1aba062156 Binary files /dev/null and b/boards/beagley/ai/images/beagley-ai-micro-sd-card.jpg differ diff --git a/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg b/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg new file mode 100644 index 0000000000000000000000000000000000000000..285c647d9756c6cdeddaa953647eb5f04a177c03 Binary files /dev/null and b/boards/beagley/ai/images/beagley-ai-tethered-connection.jpg differ diff --git a/boards/beagley/ai/images/boot-penguins.jpg b/boards/beagley/ai/images/boot-penguins.jpg new file mode 100644 index 0000000000000000000000000000000000000000..432a86b800d8893f0b05ce8efd4763f55ca70558 Binary files /dev/null and b/boards/beagley/ai/images/boot-penguins.jpg differ diff --git a/boards/beagley/ai/images/htop.jpg b/boards/beagley/ai/images/htop.jpg new file mode 100644 index 0000000000000000000000000000000000000000..21a8811c83357593913799d8342576f3736499bb Binary files /dev/null and b/boards/beagley/ai/images/htop.jpg differ diff --git a/boards/beagley/ai/images/login.jpg b/boards/beagley/ai/images/login.jpg new file mode 100644 index 0000000000000000000000000000000000000000..79d30445d3c8ad04f8c1f62641048f06a6dc00c2 Binary files /dev/null and b/boards/beagley/ai/images/login.jpg differ diff --git a/boards/beagley/ai/images/ping-test.jpg b/boards/beagley/ai/images/ping-test.jpg new file mode 100644 index 0000000000000000000000000000000000000000..18ff31f4f05a2131b9cbe19ac277ed6c1ab5fa40 Binary files /dev/null and b/boards/beagley/ai/images/ping-test.jpg differ diff --git a/boards/beagley/ai/images/screen-saver.jpg b/boards/beagley/ai/images/screen-saver.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9a629bd60bae8ec833cee4b5b56e5a801f2583b3 Binary files /dev/null and b/boards/beagley/ai/images/screen-saver.jpg differ diff --git a/boards/beagley/ai/images/ssh-connection.png b/boards/beagley/ai/images/ssh-connection.png new file mode 100644 index 0000000000000000000000000000000000000000..7d4e9361d504d2abe266d947c49aee57cdf14ba7 Binary files /dev/null and b/boards/beagley/ai/images/ssh-connection.png differ