From a1b4a2ba1e654879282c640e0e8a2513b0f99760 Mon Sep 17 00:00:00 2001
From: Andrei Aldea <andrei1998@gmail.com>
Date: Mon, 6 Nov 2023 10:14:52 -0500
Subject: [PATCH] Accessories cleanup
Still need to do a deep dive on Displays.
Changes include:
* Fixing broken links and removing products no longer available/relevant
* Changed links to point to US version of websites
* Added details for new boards including BeagleV
* Fixed some board names, spelling, etc.
---
accessories/cables.rst | 61 +++++++++++++---------------------
accessories/displays.rst | 6 ++--
accessories/index.rst | 10 +++---
accessories/peripherals.rst | 29 ++++++----------
accessories/power-supplies.rst | 27 ++++++++++-----
5 files changed, 61 insertions(+), 72 deletions(-)
diff --git a/accessories/cables.rst b/accessories/cables.rst
index 598b5621..a64dc717 100644
--- a/accessories/cables.rst
+++ b/accessories/cables.rst
@@ -6,24 +6,27 @@ Cables
USB Cables
***********
-A microUSB cable will normally be supplied with the BeagleBone Black. For other beaglebone boards like PocketBeagle, BeagleBone AI,
-BeagleBone AI-64 you'll have to procure your own USB cable.
+A microUSB cable will normally be supplied with the BeagleBone Black. For other boards like PocketBeagle, BeagleBone AI & BeagleBone AI-64 you'll have to procure your own USB cable.
.. table:: USB ports on BeagleBone hardware
+----------------------------+--------------+
| Board | USB type |
+============================+==============+
- | BeagleBone Play | USB-C |
+ | BeaglePlay | USB-C |
+----------------------------+--------------+
- | BeagleBone Black | miniUSB |
- +----------------------------+--------------+
- | PocketBeagle | microUSB |
+ | BeagleV-Fire | USB-C |
+----------------------------+--------------+
| BeagleBone AI | USB-C |
+----------------------------+--------------+
| BeagleBone AI-64 | USB-C |
+----------------------------+--------------+
+ | BeagleV-Ahead | microUSB 3.0 |
+ +----------------------------+--------------+
+ | BeagleBone Black | miniUSB |
+ +----------------------------+--------------+
+ | PocketBeagle | microUSB |
+ +----------------------------+--------------+
| BeagleBone Blue | microUSB |
+----------------------------+--------------+
| BeagleBone Black Wireless | microUSB |
@@ -38,7 +41,7 @@ BeagleBone AI-64 you'll have to procure your own USB cable.
Serial Debug Cables
********************
-The default serial port settings for the board are:
+The default serial port settings for BeagleBoards are:
.. table:: UART settings
@@ -59,17 +62,17 @@ The default serial port settings for the board are:
JST-SH serial cables
====================
-These cables are not active (only wries and connector) and provide interface
-between serial cables listed below and serial debug ports on new BeagleBone boards like BeagleBone AI
-and BeagleBone AI-64. You can purchase these cables from different sources including:
+These cables are not active (only wries and connector) and provide an interface
+between USB to Serial converter cables such as the ones listed below and serial debug ports on BeagleBoards such as the BeagleBone AI
+and AI-64. You can purchase these cables from different sources including:
-1. `Farnell <https://uk.farnell.com/element14/1103004000156/beaglebone-ai-serials-cable/dp/3291081>`_
-2. `DigiKey <https://www.digikey.in/en/products/detail/digi-key-electronics/BBCAI/10187731?s=N4Ig7CBcoIYE5QIwA5EGYA0IYBcmZAAcBLJABgDYxEyBOMAXwaA>`_
+1. `Farnell <https://www.newark.com/element14/1103004000156/serial-cable-ai-board/dp/50AH3702>`_
+2. `DigiKey <https://www.digikey.com/en/products/detail/digi-key-electronics/BBCAI/10187731>`_
Standard FTDI Cable
====================
-The debug cable is a standard FTDI to TTL cable. Make sure you get the 3.3V version.
+The debug cable is a standard FTDI to TTL cable. **Make sure you get the 3.3V version**!
It can purchased from several different sources including but not limited to:
- `FTDI serial cable direct <https://www.ftdichip.com/Products/Cables/USBTTLSerial.htm>`_
@@ -78,6 +81,8 @@ It can purchased from several different sources including but not limited to:
- `FTDI serial cable at Sparkfun <https://www.sparkfun.com/products/9717>`_
- `FTDI serial cable at Adafruit <https://www.adafruit.com/products/70>`_
+Other options with different USB to Serial ICs exist and will work as well, such as CP2102, CH340G etc but may require additional drivers depending on your operating system.
+
.. image:: images/FTDI_Cable.jpg
:align: center
:alt: FTDI Cable
@@ -88,7 +93,7 @@ Adafruit 4 Pin Cable (CP2102)
==============================
`Adafruit 4-pin serial cable <http://www.adafruit.com/products/954>`_ (Originally
-this is a Prolific chipset based cable, as of Dec. 21, 2016 we will be
+this was a Prolific chipset based cable, as of Dec. 21, 2016 Adafruit will be
shipping cables with SiLabs CP2012 chipset instead of Prolific.)
.. image:: images/RPI_Serial.png
@@ -113,29 +118,9 @@ shipping cables with SiLabs CP2012 chipset instead of Prolific.)
You will also find an extra RED wire on this cable
that supplies 5V @ 500mA which could power the
- board if connected to one of the VDD_5V pins
- (P9_05, P9_06). Just leave it unconnected.
-
-FTDI 3 Pin Cable
-================
+ board if connected to one of the VDD_5V pins.
+ It's recommended that you leave it unconnected.
-You can purchase the another version direct from
-`FTDI <http://apple.clickandbuild.com/cnb/shop/ftdichip?op=catalogue-products-null&prodCategoryID=167&title=TTL-232R-RPi>`_
-This cable only has three wires for connection. You can
-find the datasheet and a picture at
-`Cable <http://www.ftdichip.com/Support/Documents/DataSheets/Cables/DS_TTL-232R_RPi.pdf>`_
-
-.. table::
-
- +--------------+--------------+
- | Board | Wire |
- +==============+==============+
- | Pin 1 (GND) | Black (GND) |
- +--------------+--------------+
- | Pin 4 (RX) | Orange (TX) |
- +--------------+--------------+
- | Pin 5 (TX) | Yellow (RX) |
- +--------------+--------------+
JTAG debug Cables
*****************
@@ -171,7 +156,7 @@ microHDMI to VGA
miniDP to HDMI
****************
-Working miniDP to HDMI
+Working miniDP to HDMI Adapters
=======================
.. note::
@@ -181,7 +166,7 @@ Working miniDP to HDMI
- `IVANKY 4K Active Mini DisplayPort to HDMI Adapter <https://www.amazon.com/dp/B089GF8M87/>`_
- `CableCreation Mini DP (Thunderbolt 2 Compatible) to HDMI <https://www.amazon.in/CD0257-Mini-DP-to-HDMI/dp/B01FM51O0W/>`_
-Examples of "Bad" MiniDP to HDMI
+Examples of "Bad" MiniDP to HDMI Adapters
=================================
- `UGREEN Mini DP Male to HDMI <https://www.amazon.in/Mini-Male-Female-Converter-Cable/dp/B01CL1P6TA/>`_
diff --git a/accessories/displays.rst b/accessories/displays.rst
index da2034be..ada3d7e2 100644
--- a/accessories/displays.rst
+++ b/accessories/displays.rst
@@ -6,7 +6,9 @@ Displays
Monitors and Resolutions
=========================
-Supported Monitors
+
+
+Verified Desktop Monitors
-------------------
The following monitors and resolutions have been tested for operation with the BeagleBone Black.
@@ -39,7 +41,7 @@ Unsupported Monitors
LG 37LH30 - did not seem to work, the display didn't even recognize that anything was plugged in at all.
-Supported Televisions
+Verified Televisions
-----------------------
The following TVs and resolutions have been tested for operation with the BeagleBone Black. Check here often as we will update the list as we confirm the operation.
diff --git a/accessories/index.rst b/accessories/index.rst
index 487dade8..730e7bfc 100644
--- a/accessories/index.rst
+++ b/accessories/index.rst
@@ -3,20 +3,20 @@
Accessories
#############
-This section will include all the tested accessories for BeagleBoard.org hardware and kits.
+This section includes tested accessories for BeagleBoard.org hardware and kits.
.. note::
- This documentation is not complete and we are actively looking for volunteers to test
- and add new hardware accessories that they have already with them. General feedback and contribution
- is also appreciated. You can checkout these pages to contribuite to BeagleBoard.org docs project,\
+ This documentation is actively evolving and we are always looking for volunteers to test
+ and add new hardware accessories that they have tested. General feedback and contribution
+ is also appreciated. You can checkout these pages to contribuite to the BeagleBoard.org docs project,\
1. `Docs contribution guide <https://docs.beagleboard.io/latest/intro/contribution/index.html>`_
2. `Docs project issue tracker. <https://git.beagleboard.org/docs/docs.beagleboard.io/-/issues>`_
.. danger::
- Accessories section contains only 3rd party products that have been manually used by community members with BeagleBoard.org products.
+ The accessories section only contains a subset of 3rd party products that have been manually used by community members with BeagleBoard.org products.
BeagleBoard.org should not be held liable for the functionality of BeagleBoard.org products in association with these 3rd party
products in any way possible. This is just a place for people to report their experiences and not a statement of compatibility.
BeagleBoard.org approve that these items have at least some aspect of testing by foundation members, though only specific
diff --git a/accessories/peripherals.rst b/accessories/peripherals.rst
index 24adf565..1bf8d4ea 100644
--- a/accessories/peripherals.rst
+++ b/accessories/peripherals.rst
@@ -4,9 +4,9 @@ Peripherals
############
.. note::
- Most Keyboards, Mouse, and USB Hubs are plug-n-play devices and they are
- supported out of the box in linux. List below only shows what has been tested.
- You may have something different and it will work without any additional software requirement.
+ Most Keyboards, Mouse, and USB Hubs are plug-and-play devices and are
+ supported out of the box in Linux. The list below only shows a subset that has been tested by contributors.
+ Many other options will work without any additional tinkering required on behalf of the user.
Keyboard & Mouse Combo
***********************
@@ -14,32 +14,25 @@ Keyboard & Mouse Combo
With limited ports availability on BeagleBones it is recommended to use wireless
Keyboard & Mouse combos.
-- `Adafruit keyboard & Mouse w/batteries <https://www.mouser.in/ProductDetail/Adafruit/1738?qs=GURawfaeGuBoaqdx8E%2Fl7w%3D%3D>`_
-- `Portronics Key2-A Combo of Multimedia Wireless Keyboard & Mouse <https://www.amazon.in/Portronics-Combo-Multimedia-Wireless-Light-Weight/dp/B07X1KRPDZ/>`_
+- `Adafruit keyboard & Mouse w/batteries <https://www.mouser.com/ProductDetail/Adafruit/1738?qs=GURawfaeGuBoaqdx8E%2Fl7w%3D%3D>`_
+- `Logitech K400 Plus Keyboard/Touchpad Combo <https://www.amazon.com/Logitech-Wireless-Keyboard-Touchpad-PC-connected/dp/B014EUQOGK/>`_
Keyboards
************
**Make sure that you plug the keyboard into the USB Host connector before powering on the board.**
-- `BTC USB 6100C <http://www.amazon.com/BTC-6100C-Compact-MultiMedia-Keyboard/dp/B000VITZ98/>`_
-- `Inland USB 70010 <http://inlandproduct.com/usbwiredkeyboard.aspx>`_
-- `Gear Head Wireless KB3800TPW <http://www.amazon.com/Wireless-Touch-Touchpad-Keyboard-Smart/dp/B003GU1028/>`_
-- `Microsoft Wireless 800 <http://www.amazon.com/Microsoft-Wireless-Keyboard-800-2VJ-00001/dp/B004JO16KG/>`_
-- `Logitech MK320 Keyboard/Mouse Combo <http://www.amazon.com/Logitech-Wireless-Desktop-MK320-Keyboard/dp/B003VAGXZC/ref=sr_1_1?s=electronics&ie=UTF8&qid=1371841107&sr=1-1&keywords=mk320>`_
-- `Logitech MK710 Keyboard/Mouse Combo <http://www.amazon.com/Logitech-Wireless-Desktop-Keyboard-920-002416/dp/B0036E8V08/>`_
-- `Logitech MK260 Keyboard/Mouse Combo <http://www.amazon.com/Logitech-Wireless-Combo-Keyboard-920-002950/dp/B004KSQANO>`_
+- `Logitech K400 Plus Keyboard/Touchpad Combo <https://www.amazon.com/Logitech-Wireless-Keyboard-Touchpad-PC-connected/dp/B014EUQOGK/>`_
+- `Logitech MK345 Keyboard/Mouse Combo <https://www.amazon.com/Logitech-MK345-Wireless-Combo-Right-Handed/dp/B00QXT5T3U/>`_
+- `Logitech MK270 Keyboard/Mouse Combo <https://www.amazon.com/Logitech-MK270-Wireless-Keyboard-Mouse/dp/B079JLY5M5/>`_
- `Inland Keyboard and Mouse Combo <http://www.amazon.com/Inland-Wireless-2-4GHz-Optical-Keyboard/dp/B009V9IWCO/ref=sr_sp-btf_image_1_10?s=electronics&ie=UTF8&qid=1376403707&sr=1-10&keywords=inland+mouse+and+keyboard>`_
-- `Solidtek KB-5010BU Keyboard+Roller Ball <http://www.logicsupply.com/products/kb_5010bu>`_
Mice
******
-**Make sure that you plug the mice into the USB Host connector before powering on the board.**
+**Make sure that you plug the mouse into the USB Host connector before powering on the board.**
-- `Microsoft Wireless 1000 <http://www.amazon.com/Microsoft-Wireless-Mobile-Mouse-1000/dp/B003STDQQU/ref=sr_1_1?s=electronics&ie=UTF8&qid=1371841170&sr=1-1&keywords=microsoft+wireless+1000>`_
-- `Logitech M705 <http://www.amazon.com/Logitech-Wireless-Marathon-Battery-910-001935/dp/B003TG75EG/>`_
-- `Logitech M600 <http://www.amazon.com/Logitech-Touch-Mouse-M600-910-002666/dp/B006MBP7T0/>`_
+- `Amazon Basics Wireless Computer Mouse <https://www.amazon.com/AmazonBasics-Wireless-Computer-Mouse-Receiver/dp/B005EJH6Z4/>`_
- `Logitech M310 <http://www.logitech.com/en-us/product/wireless-mouse-m310>`_
USB HUBS
@@ -55,5 +48,5 @@ USB HUBS
.. tip::
Make sure you are powering BeagleBone with decent power supply with
- enough current before attaching any additional Peripherals.
+ enough current before attaching any additional peripherals. If you require many USB peripheral USB devices to be attached, consider using a "Powered USB Hub"
See :ref:`accessories-power-supplies` for more information on power requirements.
diff --git a/accessories/power-supplies.rst b/accessories/power-supplies.rst
index 93793c0e..89389b84 100644
--- a/accessories/power-supplies.rst
+++ b/accessories/power-supplies.rst
@@ -3,15 +3,14 @@
Power supplies
###############
-All BeagleBone boards require different power supplies like BeagleBone Balack and other AM335X
-based boards will be fine with a 5VDC @ 1A but, BeagleBone AI-64 requires aleast 5VDC @ 3A. You
-have to either supply the power via USB jack or a 2.1mm/2.5mm inner diameter and 5.5mm outer
-diameter (center positive) barrel jack.
+Different BeagleBoard products require different power supplies. While BeagleBone Black and other AM335X
+based boards will be fine with a 5V @ 1A, others, such as BeagleBone AI-64 require aleast 5V @ 3A. You
+have to either supply the power via USB jack or a matching (center positive) barrel jack as shown in the table below.
.. note::
The power supply is not supplied with the board.
-.. table:: BeagleBone power supplies
+.. table:: BeagleBoard power supplies
+----------------------------+-------------------+-------------+-------------------------------------------------------------+
| Board | Connector | Power | Tested accessories |
@@ -20,6 +19,8 @@ diameter (center positive) barrel jack.
+----------------------------+ | | - `Sparkfun <https://www.sparkfun.com/products/8269?>`_ |
| BeagleBone Black Wireless | | | - `Logic Supply <http://www.logicsupply.com/pw-5v2a/>`_ |
+----------------------------+ | | |
+ | BeagleV-Ahead | | | |
+ +----------------------------+ | | |
| Beaglebone xM | | | |
+----------------------------+-------------------+-------------+-------------------------------------------------------------+
| PocketBeagle | microUSB | 5V @ 2A | - `AA10A-050A(M)-R <https://mou.sr/3XUPOL0>`_ |
@@ -27,7 +28,11 @@ diameter (center positive) barrel jack.
+----------------------------+-------------------+-------------+-------------------------------------------------------------+
| BeagleBone AI-64 | Type-C | 5V @ 3A | - `AA65M-59FKA-R <https://mou.sr/3Dz9P1E>`_ |
+----------------------------+ | | |
- | Beaglebone AI | | | |
+ | BeaglePlay | | | |
+ +----------------------------+ | | |
+ | BeagleBone AI | | | |
+ +----------------------------+ | | |
+ | BeagleV-Fire | | | |
+----------------------------+-------------------+-------------+-------------------------------------------------------------+
| BeagleBone Green Gateway | 2.1mm Barrel Jack | 12V @ 5A | - `PSAC60M-120-R <https://mou.sr/3Rs657U>`_ |
+----------------------------+ | | |
@@ -38,7 +43,11 @@ diameter (center positive) barrel jack.
.. tip::
Most modern day mobile phone chargers are capable of delivering enough current to power any BeagleBone.
- You may try using that with suitable cable before buying any standalone power srource for your board.
+ You may try using that with a suitable cable before buying any standalone power source for your board. Please ensure the expected output voltage
+ and current capabilities are listed on your power supply before attempting to power your board.
-If you plan to use capes or add your own circuitry, higher amperage may be required.
-Make sure that you have a grounded connection. This can be the USB cable or the HDMI cable.
+If you plan to use capes or add your own circuitry, a power supply capable of higher current may be required.
+
+.. note::
+ USB-C supplies will auto-negotiate the highest power mode that both power supply and BeagleBoard support. In most cases, this will be
+ 5V @ 3A. It is OK to use a higher Wattage USB-C PD supply with a board.
--
GitLab