diff --git a/accessories/cables.rst b/accessories/cables.rst index 598b56219a7bff82c6d891285c9df4107d3d55a0..933a0e0dd7eba3a2eacae4643566f5730c9f7af2 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 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. .. 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 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 -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 Beagles 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 @@ -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 -this is a Prolific chipset based cable, as of Dec. 21, 2016 we will be -shipping cables with SiLabs CP2012 chipset instead of Prolific.) +`Adafruit 4-pin serial cable <http://www.adafruit.com/products/954>`_ (SiLabs CP2102 based, boards older than 2017 use a Prolific chipset instead) .. 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 - (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,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/>`_ diff --git a/accessories/displays.rst b/accessories/displays.rst index da2034be979ffaeacc398185a42fd9c1a831b105..ada3d7e2e247a5e5750b179947c9a97b6055fa73 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 487dade8f8bfa406284e8be6b2c2b693d95e7ce2..730e7bfc4d7b88632a9aa8ef8228f40f11c649cd 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 24adf5659eb4cdeb8c55162aeaa0c48f283c22a9..1bf8d4ea9a37f9a653725616dd1f1737f7d1da1c 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 93793c0e5bc1dc1ed272abb4e567c4272cff4c0d..f7b5e992ac35c9ee5294bbdb60d81930a5ca4a32 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,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. -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, but it is recommended to use supplies from well-known manufacturers to + avoid supplies that may break the USB-C PD specification.