diff --git a/boards/beaglev/ahead/02-quick-start.rst b/boards/beaglev/ahead/02-quick-start.rst index 1adf9ad331bbc66827c02549ac2f707aa2d40352..88ee2a4ca0f1b45bf2220d44bb095d9ccf2780ce 100644 --- a/boards/beaglev/ahead/02-quick-start.rst +++ b/boards/beaglev/ahead/02-quick-start.rst @@ -10,7 +10,7 @@ When you purchase a brand new BeagleV Ahead, In the box you'll get: 1. BeagleV Ahead board 2. One (1) 2.4GHz/5GHz antenna -3. microUSB OTG cable +3. super-speed micro-B OTG cable 4. Quick-start card .. image:: media/BeagleV-Ahead-all.* @@ -18,6 +18,28 @@ When you purchase a brand new BeagleV Ahead, In the box you'll get: :align: center :alt: BeaglePlay box contents +Unboxing +********* + +.. only:: latex + + .. image:: https://img.youtube.com/vi/SVC9peUUzE0/maxresdefault.jpg + :alt: BeagleV Ahead Unboxing YouTube video + :width: 1280 + :target: https://www.youtube.com/watch?v=SVC9peUUzE0 + +.. only:: html + + .. raw:: html + + <iframe style="display: block; margin: auto;" width="1280" height="720" style="align:center" + src="https://www.youtube.com/embed/SVC9peUUzE0" + title="YouTube video player" + frameborder="0" + allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" + allowfullscreen> + </iframe> + Antenna guide ************* @@ -44,7 +66,7 @@ Antenna guide If for some reason you want to disconnect the antenna from your BeagleV Ahead board you can follow the guide below to remove the antenna without beaking the uFL antenna connector. - .. figure:: media/antenna-guide/remove.* + .. figure:: media/antenna-guide/disconnect.* :align: center :alt: Removing 2.4GHz/5GHz antenna to BeagleV Ahead. @@ -53,6 +75,192 @@ Antenna guide Tethering to PC **************** +To connect the board to PC via USB 3.0 port you can use either a standard high-speed micro-B cable +or a USB 3.0 super-speed micro-B cable. Connection guide for both are shown below: + +.. important:: high-speed micro-B will support only USB 2.0 speed but super-speed micro-B cable will support USB 3.0 speed. + +.. tabs:: + + .. group-tab:: super-speed micro-B connection (USB 3.0) + + For super speed USB 3.0 connection it's recommended to use super-speed micro-B USB cable. + To get a super-speed micro-B cable you can checkout links below: + + 1. `USB 3.0 Micro-B Cable - 1m (sparkfun) <https://www.sparkfun.com/products/14724>`_ + 2. `Stewart Connector super-speed micro-B (DigiKey) <https://www.digikey.com/en/products/detail/stewart-connector/SC-3ATK003F/8544565>`_ + 3. `CNC Tech super-speed micro-B (DigiKey) <https://www.digikey.com/en/products/detail/cnc-tech/103-1092-BL-00100/5023751>`_ + 4. `Assmann WSW Components super-speed micro-B (DigiKey) <https://www.digikey.com/en/products/detail/assmann-wsw-components/A-USB30AM-30MBM-200/10408379>`_ + + .. note:: If you only have a high-speed micro-B cable you can checkout high-speed micro-B connection guide. + + .. figure:: media/usb-guide/super-speed-micro-B-connection.* + :align: center + :alt: super-speed micro-B (USB 3.0) connection guide for BeagleV Ahead. + + super-speed micro-B (USB 3.0) connection guide for BeagleV Ahead. + + .. group-tab:: high-speed micro-B connection (USB 2.0) + + + For USB 2.0 connection it's recommended to use high-speed micro-B USB cable. + To get a high-speed micro-B cable you can checkout links below: + + 1. `USB micro-B Cable - 6 Foot (sparkfun) <https://www.sparkfun.com/products/10215>`_ + 2. `Stewart Connector high-speed micro-B (DigiKey) <https://www.digikey.com/en/products/detail/stewart-connector/SC-2AMK003F/8544577>`_ + 3. `Assmann WSW Components high-speed micro-B (DigiKey) <https://www.digikey.com/en/products/detail/assmann-wsw-components/AK67421-0-3-VM/5428793>`_ + 4. `Cvilux USA high-speed micro-B (DigiKey) <https://www.digikey.com/en/products/detail/cvilux-usa/DH-20M50055/13175849>`_ + + .. note:: Make sure the high-speed micro-B cable you have is a data cable as some high-speed micro-B cables are power only. + + .. figure:: media/usb-guide/high-speed-micro-B-connection.* + :align: center + :alt: high-speed micro-B (USB 2.0) connection guide BeagleV Ahead. + + high-speed micro-B (USB 2.0) connection guide BeagleV Ahead. + +Flashing eMMC +************** + +.. note:: To flash your BeagleV Ahead you need either a super-speed micro-B or high-speed micro-B cable as shown in section above. + +Download latest software image +=============================== + +To download the latest software image visit `https://www.beagleboard.org/distros <https://www.beagleboard.org/distros>`_ and +search for BeagleV Ahead as shown below. + +.. figure:: media/Software-Image.png + :align: center + :alt: Download latest software image for BeagleV Ahead board + + Download latest software image for BeagleV Ahead board + +Put BeagleV Ahead in USB flash mode +==================================== + +.. note:: Only super-speed micro-B is shown in graphic below but you can use + a high-speed micro-B cable. Only difference will be lower flash speeds. + +To put your BeagleV Ahead board into eMMC flash mode you can follow the steps below: + +1. Press and hold USB button. +2. Connect to PC with super-speed micro-B or high-speed micro-B cable. +3. Release USB button. + +.. figure:: media/usb-guide/Flash-eMMC.* + :align: center + :alt: Connecting BeagleV Ahead to flash eMMC + + Connecting BeagleV Ahead to flash eMMC + +.. important:: If you want to put the board into eMMC flashing while it is already + connected to a PC you can follow these steps: + + 1. Press and hold USB button. + 2. Press reset button once. + 3. Release USB button. + + +Flash the latest image on eMMC +=============================== + +.. tabs:: + + .. group-tab:: Linux + + First you need to install android platform tools which includes `adb` and `fastboot`. + + - Debian/Ubuntu-based Linux users can type the following command: + + .. code-block:: bash + + sudo apt-get install android-sdk-platform-tools + + + - Fedora/SUSE-based Linux users can type the following command: + + .. code-block:: bash + + sudo dnf install android-tools + + Now unzip the latest software image zip file you have downloaded from + `https://www.beagleboard.org/distros <https://www.beagleboard.org/distros>`_ + which contains four files shown below: + + .. code-block:: bash + + [lorforlinux@fedora deploy] $ ls + boot.ext4 fastboot_emmc.sh root.ext4 u-boot-with-spl.bin + + .. important:: Make sure your board is in flash mode, you can follow the guide above to do that. + + To flash the board you just have to exexute the script `fastboot_emmc.sh` as root and provide your passoword: + + .. code-block:: bash + + [lorforlinux@fedora deploy] $ sudo ./fastboot_emmc.sh + [sudo] password for lorforlinux: + + + + .. group-tab:: Windows + + .. todo:: add instructions for flashing in windows. + + .. group-tab:: Mac + + .. todo:: add instructions for flashing in Mac. + +Access UART debug console +************************** + +.. note:: It has been noticed that 6pin FTDI cables like `this <https://www.adafruit.com/product/70>`_ + doesn't seem work with BeagleV Ahead debug port and there might be other cables/modules that will + show garbage when connected to the board. + + Some tested devices that are working good includes: + + 1. `Adafruit CP2102N Friend - USB to Serial Converter <https://www.adafruit.com/product/5335>`_ + 2. `Raspberry Pi Debug Probe Kit for Pico and RP2040 <https://www.adafruit.com/product/5699>`_ + +To access a BeagleV Ahead serial debug console you can connected a USB to UART +to your board as shown below: + +.. figure:: media/debug/BeagleV-Ahead-UART-Debug.* + :align: center + :alt: BeagleV Ahead UART debug port connection + + BeagleV Ahead UART debug port connection + +To see the board boot log and access your BeagleV Ahead's console you can use application like ``tio`` +to access the conole. If you are using Linux your USB to UART converter may appear as ``/dev/ttyUSB``. +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/supportpkg/arduinoio/ug/find-arduino-port-on-windows-mac-and-linux.html>`_. + +.. code-block:: shell + + [lorforlinux@fedora ~] $ tio /dev/ttyUSB0 + tio v2.5 + Press ctrl-t q to quit + Connected + +Connect USB gadgets +******************** + +A super-speed micro-B (male) to USB A (female) OTG cable included in the box +can be used to connect USB gadgets to your BeagleV Ahead board. +When you do this, you'll be required to power the board via Barrel jack. + +.. important:: To properly power the board and USB gadgets you must power + the board with 5V @ 2A power supply. + +.. figure:: media/usb-guide/OTG-usage.* + :align: center + :alt: USB OTG to connect USB gadgets to BeagleV Ahead board + + USB OTG to connect USB gadgets to BeagleV Ahead board + Demos and Tutorials ******************* diff --git a/boards/beaglev/ahead/04-expansion.rst b/boards/beaglev/ahead/04-expansion.rst index 6addc9eaa1e32dca9f76e139863fa4c6ff0a7866..4f0159f9c11cc702a3ce43b8460e1839b446bc97 100644 --- a/boards/beaglev/ahead/04-expansion.rst +++ b/boards/beaglev/ahead/04-expansion.rst @@ -756,7 +756,7 @@ P9.32-P9.40 | ADC_VIN_CH4 | ADC_VIN_CH6 | ADC_VIN_CH5 | ADC_VIN_CH2 | ADC_VIN_CH3 | ADC_VIN_CH0 | ADC_VIN_CH1 | +--------------+--------------+--------------+--------------+--------------+--------------+--------------+ -P9.41-P8.42 +P9.41-P9.42 ------------ +------------+--------------------------+--------------------------+ diff --git a/boards/beaglev/ahead/media/Software-Image.png b/boards/beaglev/ahead/media/Software-Image.png new file mode 100644 index 0000000000000000000000000000000000000000..3724f6017a44e03159567195e3e7ab16750d77a6 Binary files /dev/null and b/boards/beaglev/ahead/media/Software-Image.png differ diff --git a/boards/beaglev/ahead/media/antenna-guide/connect.jpg b/boards/beaglev/ahead/media/antenna-guide/connect.jpg index 6e89cd462e382caca45a4d6f1d4c3fae5ceb18ee..be05e3b84bd00fbac772798b228754b38d0e35c3 100644 Binary files a/boards/beaglev/ahead/media/antenna-guide/connect.jpg and b/boards/beaglev/ahead/media/antenna-guide/connect.jpg differ diff --git a/boards/beaglev/ahead/media/antenna-guide/connect.png b/boards/beaglev/ahead/media/antenna-guide/connect.png index 39f17b1a671074ade6e76c0e2d3e7e2203c651f6..521e2e6d543d17de785a613398232e2d225cf3a6 100644 Binary files a/boards/beaglev/ahead/media/antenna-guide/connect.png and b/boards/beaglev/ahead/media/antenna-guide/connect.png differ diff --git a/boards/beaglev/ahead/media/antenna-guide/connect.webp b/boards/beaglev/ahead/media/antenna-guide/connect.webp index 5dfdc0042de6900d11001312f6c406e1632a5c9d..01f897112275501524b08e0b99217cade590aad1 100644 Binary files a/boards/beaglev/ahead/media/antenna-guide/connect.webp and b/boards/beaglev/ahead/media/antenna-guide/connect.webp differ diff --git a/boards/beaglev/ahead/media/antenna-guide/disconnect.jpg b/boards/beaglev/ahead/media/antenna-guide/disconnect.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b74a92463502c9947a554f4f6cae84252b0c8240 Binary files /dev/null and b/boards/beaglev/ahead/media/antenna-guide/disconnect.jpg differ diff --git a/boards/beaglev/ahead/media/antenna-guide/disconnect.png b/boards/beaglev/ahead/media/antenna-guide/disconnect.png new file mode 100644 index 0000000000000000000000000000000000000000..b78801240d8d61f4fe4a41c3f6f613d9d84473ed Binary files /dev/null and b/boards/beaglev/ahead/media/antenna-guide/disconnect.png differ diff --git a/boards/beaglev/ahead/media/antenna-guide/disconnect.webp b/boards/beaglev/ahead/media/antenna-guide/disconnect.webp new file mode 100644 index 0000000000000000000000000000000000000000..f91a5dc857a25bbb38f3423e02bb2c030a21894e Binary files /dev/null and b/boards/beaglev/ahead/media/antenna-guide/disconnect.webp differ diff --git a/boards/beaglev/ahead/media/antenna-guide/remove.jpg b/boards/beaglev/ahead/media/antenna-guide/remove.jpg deleted file mode 100644 index 67d536ee2ddc165356c2c4b84d3d5e20ef5ceeb4..0000000000000000000000000000000000000000 Binary files a/boards/beaglev/ahead/media/antenna-guide/remove.jpg and /dev/null differ diff --git a/boards/beaglev/ahead/media/antenna-guide/remove.png b/boards/beaglev/ahead/media/antenna-guide/remove.png deleted file mode 100644 index 8ca5e8e497e93cd1211903e3c7de2adaa3d315b5..0000000000000000000000000000000000000000 Binary files a/boards/beaglev/ahead/media/antenna-guide/remove.png and /dev/null differ diff --git a/boards/beaglev/ahead/media/antenna-guide/remove.webp b/boards/beaglev/ahead/media/antenna-guide/remove.webp deleted file mode 100644 index 4219717238c4bfdee3446aa0c7c435eaa9016aa3..0000000000000000000000000000000000000000 Binary files a/boards/beaglev/ahead/media/antenna-guide/remove.webp and /dev/null differ diff --git a/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.jpg b/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.jpg new file mode 100644 index 0000000000000000000000000000000000000000..73fa4041cb3a2823815064f5d881022c8bae7474 Binary files /dev/null and b/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.jpg differ diff --git a/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.png b/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.png new file mode 100644 index 0000000000000000000000000000000000000000..506cb770d7ed30aa30b85a1f13a3a4c96ee6bc3c Binary files /dev/null and b/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.png differ diff --git a/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.webp b/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.webp new file mode 100644 index 0000000000000000000000000000000000000000..c17f2d44bc167f49080ae648bb28314ce56c7746 Binary files /dev/null and b/boards/beaglev/ahead/media/debug/BeagleV-Ahead-UART-Debug.webp differ diff --git a/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.jpg b/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8409e40d6f1a1248280f51158f2e887b8c96c706 Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.jpg differ diff --git a/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.png b/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.png new file mode 100644 index 0000000000000000000000000000000000000000..f50c7ea7a1afd3979703725174446901db86c915 Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.png differ diff --git a/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.webp b/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.webp new file mode 100644 index 0000000000000000000000000000000000000000..32f0d5204b7150e4ae3d9ea1605f73719aab5fa9 Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/Flash-eMMC.webp differ diff --git a/boards/beaglev/ahead/media/usb-guide/OTG-usage.jpg b/boards/beaglev/ahead/media/usb-guide/OTG-usage.jpg new file mode 100644 index 0000000000000000000000000000000000000000..40fe5c22d51c16741fa9251ac381fb6f01c5447f Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/OTG-usage.jpg differ diff --git a/boards/beaglev/ahead/media/usb-guide/OTG-usage.png b/boards/beaglev/ahead/media/usb-guide/OTG-usage.png new file mode 100644 index 0000000000000000000000000000000000000000..f08edd7f55322fb89bbc78cdf2e78742cc549743 Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/OTG-usage.png differ diff --git a/boards/beaglev/ahead/media/usb-guide/OTG-usage.webp b/boards/beaglev/ahead/media/usb-guide/OTG-usage.webp new file mode 100644 index 0000000000000000000000000000000000000000..522207eaf29d38ddb1bbc030f9360d3939b9722b Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/OTG-usage.webp differ diff --git a/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.jpg b/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6e68e81c4af8bddff09cba4b8554508c57d3d50e Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.jpg differ diff --git a/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.png b/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.png new file mode 100644 index 0000000000000000000000000000000000000000..fea04eb7446ba4a63306354201dd498bc564b14e Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.png differ diff --git a/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.webp b/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.webp new file mode 100644 index 0000000000000000000000000000000000000000..eaabb21fa489315df4b4336c063dfc433ee75237 Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/high-speed-micro-B-connection.webp differ diff --git a/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.jpg b/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ecaa09f8e1c92c7086704e332324434fb4a528ce Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.jpg differ diff --git a/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.png b/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.png new file mode 100644 index 0000000000000000000000000000000000000000..62515b91ed9492310be111e8b47164b837395caa Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.png differ diff --git a/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.webp b/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.webp new file mode 100644 index 0000000000000000000000000000000000000000..bbff9920ff8d06d2b264e7b29c6a53629df3ffb8 Binary files /dev/null and b/boards/beaglev/ahead/media/usb-guide/super-speed-micro-B-connection.webp differ