Merge branch 'main' into 'main'

Accessories cleanup See merge request !67

Merge branch 'main' into 'main'
Accessories cleanup See merge request !67
af6a1cbe · Deepak Khatri · 008aa013 · 7d84cf91 · af6a1cbe · af6a1cbe
Commit af6a1cbe authored 1 year ago by Deepak Khatri
--- 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, 
+A miniUSB 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.
-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      |
+    | BeagleV-Fire               | USB-C        |
-    +----------------------------+--------------+
-    | PocketBeagle               | microUSB     |
    +----------------------------+--------------+
    | 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 Beagles 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 
+These cables are not active (only wries and connector) and provide an interface 
-between serial cables listed below and serial debug ports on new BeagleBone boards like BeagleBone AI 
+between USB to Serial converter cables such as the ones listed below and serial debug ports on Beagles such as the BeagleBone AI 
-and BeagleBone AI-64. You can purchase these cables from different sources including:
+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>`_
+1. `Farnell <https://www.newark.com/element14/1103004000156/serial-cable-ai-board/dp/50AH3702>`_
-2. `DigiKey <https://www.digikey.in/en/products/detail/digi-key-electronics/BBCAI/10187731?s=N4Ig7CBcoIYE5QIwA5EGYA0IYBcmZAAcBLJABgDYxEyBOMAXwaA>`_
+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
@@ -87,9 +92,7 @@ Pin 1 on the cable is the black wire and connects to pin 1 on the board. (the pi
 Adafruit 4 Pin Cable (CP2102)
 ==============================
-`Adafruit 4-pin serial cable <http://www.adafruit.com/products/954>`_ (Originally 
+`Adafruit 4-pin serial cable <http://www.adafruit.com/products/954>`_ (SiLabs CP2102 based, boards older than 2017 use a Prolific chipset instead)
-this is a Prolific chipset based cable, as of Dec. 21, 2016 we will be 
-shipping cables with SiLabs CP2012 chipset instead of Prolific.)
 .. image:: images/RPI_Serial.png
    :align: center
@@ -113,29 +116,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 
+    board if connected to one of the VDD_5V pins. 
-    (P9_05, P9_06). Just leave it unconnected.
+    It's recommended that you leave it unconnected.
-FTDI 3 Pin Cable
-================
-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,8 +154,8 @@ microHDMI to VGA
 miniDP to HDMI 
 ****************
-Working miniDP to HDMI
+Working miniDP to HDMI Adapters
-=======================
+================================
 .. note::
    BeagleBone-AI64 requires an **ACTIVE** Mini DisplayPort to HDMI cable or adaptor to work, 
@@ -181,7 +164,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/>`_

--- 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.

--- 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 
+    This documentation is actively evolving and we are always looking for volunteers to test 
-    and add new hardware accessories that they have already with them. General feedback and contribution 
+    and add new hardware accessories that they have tested. General feedback and contribution 
-    is also appreciated. You can checkout these pages to contribuite to BeagleBoard.org docs project,\
+    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 

--- 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 
+    Most Keyboards, Mouse, and USB Hubs are plug-and-play devices and are 
-    supported out of the box in linux. List below only shows what has been tested. 
+    supported out of the box in Linux. The list below only shows a subset that has been tested by contributors. 
-    You may have something different and it will work without any additional software requirement.
+    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>`_
+- `Adafruit keyboard & Mouse w/batteries <https://www.mouser.com/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/>`_
+- `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/>`_
+- `Logitech K400 Plus Keyboard/Touchpad Combo <https://www.amazon.com/Logitech-Wireless-Keyboard-Touchpad-PC-connected/dp/B014EUQOGK/>`_
- `Inland USB 70010 <http://inlandproduct.com/usbwiredkeyboard.aspx>`_
+- `Logitech MK345 Keyboard/Mouse Combo <https://www.amazon.com/Logitech-MK345-Wireless-Combo-Right-Handed/dp/B00QXT5T3U/>`_
- `Gear Head Wireless KB3800TPW <http://www.amazon.com/Wireless-Touch-Touchpad-Keyboard-Smart/dp/B003GU1028/>`_
+- `Logitech MK270 Keyboard/Mouse Combo <https://www.amazon.com/Logitech-MK270-Wireless-Keyboard-Mouse/dp/B079JLY5M5/>`_
- `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>`_
 - `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>`_
+- `Amazon Basics Wireless Computer Mouse <https://www.amazon.com/AmazonBasics-Wireless-Computer-Mouse-Receiver/dp/B005EJH6Z4/>`_
- `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/>`_
 - `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.
--- 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 
+Different BeagleBoard products require different power supplies. While BeagleBone Black and other AM335X 
-based boards will be fine with a 5VDC @ 1A  but, BeagleBone AI-64 requires aleast 5VDC @ 3A. You 
+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 2.1mm/2.5mm inner diameter and 5.5mm outer 
+have to either supply the power via USB jack or a matching (center positive) barrel jack as shown in the table below.
-diameter (center positive) barrel jack.
 .. 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,12 @@ 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.
+If you plan to use capes or add your own circuitry, a power supply capable of higher current may be required.
-Make sure that you have a grounded connection. This can be the USB cable or the HDMI cable.
+.. 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, but it is recommended to use supplies from well-known manufacturers to 
+    avoid supplies that may break the USB-C PD specification.