From 784dac29b515a08f5fdcbf8f396ce0141ba71c76 Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Wed, 1 Feb 2023 11:18:19 +0530
Subject: [PATCH] Update content
---
accessories/adapters.rst | 70 ++------------------------
accessories/cables.rst | 44 ++++++++++++----
accessories/cameras.rst | 7 +++
accessories/peripherals.rst | 18 +++++--
boards/beaglebone/ai-64/ch03.rst | 4 +-
boards/beaglebone/ai-64/ch07.rst | 2 +-
boards/capes/relay.rst | 8 +--
books/pru-cookbook/01case/case.rst | 10 ++--
books/pru-cookbook/05blocks/blocks.rst | 2 +-
books/pru-cookbook/08ai/ai.rst | 2 +-
intro/contribution/linux-upstream.rst | 2 +-
11 files changed, 75 insertions(+), 94 deletions(-)
diff --git a/accessories/adapters.rst b/accessories/adapters.rst
index ca6ef4bb..40cbd98a 100644
--- a/accessories/adapters.rst
+++ b/accessories/adapters.rst
@@ -15,44 +15,13 @@ HDMI Type A to VGA Male/Female with 3.5mm Stereo Adapter
`HDMI to VGA link <https://www.amazon.com/Cable-Matters-Active-Female-Adapter/dp/B00879EZJI/ref=sr_1_2?ie=UTF8&qid=1381610066&sr=8-2&keywords=micro-hdmi+to+vga>`_
-**Additional Parts Required:** (Click on the links to view the parts)
+**Additional Parts Required:**
- `Stereo Adapter (Included) <http://kbsinc.com/media/catalog/category/audiocable.jpg>`_
- `VGA Male to VGA Male <http://pixels.uk.com/images/uploads/cables/vga-m-m.png>`_
- `Micro-USB Cable <http://image.made-in-china.com/2f0j00wvsTIeQCZhqG/Micro-USB-Cable.jpg>`_
- `HDMI to Mini HDMI <http://www.archos.com/manuals/A101_EN_v1.1_files/hdmi_cable.jpg>`_
-EDID Information:
-
-.. code-block::
-
- Section "Monitor"
- # Block type: 2:0 3:fd
- # Block type: 2:0 3:fc
- Identifier "LCDTV16"
- VendorName "___"
- ModelName "LCDTV16"
- # Block type: 2:0 3:fd
- HorizSync 30-49
- VertRefresh 57-63
- # Max dot clock (video bandwidth) 90 MHz
- # Block type: 2:0 3:fc
- # DPMS capabilities: Active off:no Suspend:no Standby:no
- Mode "1360x768" # vfreq 60.366Hz, hfreq 47.991kHz
- DotClock 86.000000
- HTimings 1360 1424 1536 1792
- VTimings 768 771 777 795
- Flags "+HSync" "+VSync"
- EndMode
- Mode "1280x768" # vfreq 60.247Hz, hfreq 48.077kHz
- DotClock 80.000000
- HTimings 1280 1344 1472 1664
- VTimings 768 771 778 798
- Flags "+HSync" "-VSync"
- EndMode
- # Block type: 2:0 3:fd
- # Block type: 2:0 3:fc
- EndSection
Mini HDMI to Composite/CVBS/RCA AV Video Converter
---------------------------------------------------
@@ -70,40 +39,9 @@ Additional Parts Required: (Click on the links to view the parts)
- `HDMI to Mini HDMI Converter <http://ecx.images-amazon.com/images/I/31JeVuRNx1L._SX385_.jpg>`_
- `HDMI to Mini HDMI <http://www.archos.com/manuals/A101_EN_v1.1_files/hdmi_cable.jpg>`_
-.. code-block::
-
- EDID Information:
-
- # EDID version 1 revision 3
- Section "Monitor"
- # Block type: 2:0 3:fc
- Identifier "HDMI TO AV"
- VendorName "SNY"
- ModelName "HDMI TO AV"
- # Block type: 2:0 3:fc
- # Block type: 2:0 3:fd
- HorizSync 14-70
- VertRefresh 48-62
- # Max dot clock (video bandwidth) 150 MHz
- # DPMS capabilities: Active off:no Suspend:no Standby:no
- Mode "1920x1080" # vfreq 50.000Hz, hfreq 56.250kHz
- DotClock 148.500000
- HTimings 1920 1968 2012 2640
- VTimings 1080 1084 1089 1125
- Flags "+HSync" "+VSync"
- EndMode
- Mode "720x480" # vfreq 59.940Hz, hfreq 31.469kHz
- DotClock 27.000000
- HTimings 720 736 798 858
- VTimings 480 489 495 525
- Flags "-HSync" "-VSync"
- EndMode
- # Block type: 2:0 3:fc
- # Block type: 2:0 3:fd
- EndSection
-
-HDMI-F to Micro HDMI-M Adapter
--------------------------------
+
+HDMI-Female to Micro HDMI-Male Adapter
+---------------------------------------
This adapter is compatible with the Blackberry Z10.
`Click here <http://www.newegg.com/Product/Product.aspx?Item=9SIA0PG0RV2736>`_ to view.
\ No newline at end of file
diff --git a/accessories/cables.rst b/accessories/cables.rst
index 2201a204..13db0860 100644
--- a/accessories/cables.rst
+++ b/accessories/cables.rst
@@ -5,26 +5,52 @@ Cables
USB Cables
***********
+A USB 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.
+
+.. table:: USB ports on BeagleBone hardware
+
+ +-------------------+--------------+
+ | Board | USB type |
+ +===================+==============+
+ | BeagleBone Black | miniUSB |
+ +-------------------+--------------+
+ | Pocket Beagle | microUSB |
+ +-------------------+--------------+
+ | BeagleBone AI | USB-C |
+ +-------------------+--------------+
+ | BeagleBone AI-64 | USB-C |
+ +-------------------+--------------+
+
+
-This will normally be supplied with the BeagleBone Black, but in the case of the BBB RevA4, it was not.
-For other beaglebone boards like Pocket Beagle, BeagleBone AI, BeagleBone Ai-64 you'll have . The connector on the board is a miniUSB type B female connector and requires a miniUSB type B male mating connector.
-The original BeagleBone uses a miniUSB type AB connector.
Serial Debug Cables
====================
The default serial port settings for the board are:
-Baud 115,200
-Bits 8
-Parity N
-Stop Bits 1
-Handshake None
+.. table:: UART settings
+
+ +--------------+--------------+
+ | Setting | Value |
+ +==============+==============+
+ | Baud | 115,200 |
+ +--------------+--------------+
+ | Bits | 8 |
+ +--------------+--------------+
+ | Parity | N |
+ +--------------+--------------+
+ | Stop Bits | 1 |
+ +--------------+--------------+
+ | Handshake | None |
+ +--------------+--------------+
Standard FTDI Cable
--------------------
-The debug cable is a standard FTDI to TTL cable. Make sure you get the 3.3V version. You can purchase this from several different sources including but not limited to:
+The debug cable is a standard FTDI to TTL cable. Make sure you get the 3.3V version.
+You can purchase this from several different sources including but not limited to:
- `DigiKey <http://www.digikey.com/product-detail/en/TTL-232R-3V3/768-1015-ND/1836393>`_
- `Newark <http://www.newark.com/jsp/search/productdetail.jsp?SKU=34M8872&CMP=KNC-GPLA&mckv=%7Cpcrid%7C19038771501%7Cplid%7C>`_
diff --git a/accessories/cameras.rst b/accessories/cameras.rst
index 63b7c74f..5cba4388 100644
--- a/accessories/cameras.rst
+++ b/accessories/cameras.rst
@@ -8,6 +8,13 @@ USB Cameras
- Logitech c270
++-----------------+---------------------+----------------------+
+| Camera | BeagleBone Black | BeagleBone AI-64 |
++=================+=====================+======================+
+| Logitech C270 | | Tested |
++-----------------+---------------------+----------------------+
+
+
CSI Cameras
************
diff --git a/accessories/peripherals.rst b/accessories/peripherals.rst
index 75e261d7..24adf565 100644
--- a/accessories/peripherals.rst
+++ b/accessories/peripherals.rst
@@ -8,8 +8,17 @@ Peripherals
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.
+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/>`_
+
Keyboards
-==========
+************
**Make sure that you plug the keyboard into the USB Host connector before powering on the board.**
@@ -24,7 +33,7 @@ Keyboards
- `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.**
@@ -34,7 +43,7 @@ Mice
- `Logitech M310 <http://www.logitech.com/en-us/product/wireless-mouse-m310>`_
USB HUBS
-=========
+**********
**Make sure that you plug the HUB into the USB Host connector before powering on the board.**
@@ -46,4 +55,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.
+ See :ref:`accessories-power-supplies` for more information on power requirements.
diff --git a/boards/beaglebone/ai-64/ch03.rst b/boards/beaglebone/ai-64/ch03.rst
index 0da386b2..a5da3738 100644
--- a/boards/beaglebone/ai-64/ch03.rst
+++ b/boards/beaglebone/ai-64/ch03.rst
@@ -25,7 +25,7 @@ Methods of operation
----------------------
1. Tethered to a PC
-2. Standalone development platform in a PC configurtion using external peripherals
+2. Standalone development platform in a PC configuration using external peripherals
.. _whats-in-the-box:
@@ -75,7 +75,7 @@ Each of these configurations is discussed in general terms in the following sect
Tethered To A PC
-------------------------
-In this configuration, the board is powered by the PC via a single USB cable. The board is accessed either as a USB storage drive or via the browser on the conected PC. You need to use either Firefox or Chrome on the PC, Internet Explorer will not work properly.
+In this configuration, the board is powered by the PC via a single USB cable. The board is accessed either as a USB storage drive or via the browser on the connected PC. You need to use either Firefox or Chrome on the PC, Internet Explorer will not work properly.
.. _tethered-figure:
diff --git a/boards/beaglebone/ai-64/ch07.rst b/boards/beaglebone/ai-64/ch07.rst
index 64843aaa..8d468e9b 100644
--- a/boards/beaglebone/ai-64/ch07.rst
+++ b/boards/beaglebone/ai-64/ch07.rst
@@ -772,7 +772,7 @@ The **GPIO** row is the expected gpio identifier number in the Linux
kernel.
Each row includes the gpiochipX and pinY in the format of
-`X Y`. You can use these values to direcly control the GPIO pins with the
+`X Y`. You can use these values to directly control the GPIO pins with the
commands shown below.
.. code::
diff --git a/boards/capes/relay.rst b/boards/capes/relay.rst
index d59de3d9..fc026ef4 100644
--- a/boards/capes/relay.rst
+++ b/boards/capes/relay.rst
@@ -72,7 +72,7 @@ python3 files with the Relay Cape work well!
There are newer images and kernels if you want to update and there are older ones in case you
would like to go back in time to use older kernels and images for the Relay Cape. Please remember
-that older firmware will work differently on the BBB or other related am335x SBC.
+that older firmware will work differently on the BeagleBone Black or other related am335x SBC.
C Source with File Descriptors
******************************
@@ -88,13 +88,13 @@ You can name this file GPIO.c and use gcc to handle compiling the source into a
This is an example of programming GPIO from C using the sysfs interface on
a BeagleBone Black/BeagleBone Black Wireless or other am335x board with the Relay Cape.
- Use the Relay Cape attached to the BBB for a change in seconds and then exit with CTRL-C.
+ Use the Relay Cape attached to the BeagleBone Black for a change in seconds and then exit with CTRL-C.
The original source can be found here by Mr. Tranter: https://github.com/tranter/blogs/blob/master/gpio/part5/demo1.c
Jeff Tranter <jtranter@ics.com>
- and...Seth. I changed the source a bit to fit the BBB and Relay Cape while using sysfs.
+ and...Seth. I changed the source a bit to fit the BeagleBone Black and Relay Cape while using sysfs.
*/
@@ -249,4 +249,4 @@ One thing to note: `sudo apt install cmake`
8. ./LibGPIO
-These are a few examples on how to use the RelayCape and am335x supported BBBW/BBB SBCs.
\ No newline at end of file
+These are a few examples on how to use the RelayCape and am335x supported BeagleBone Black Wireless/BeagleBone Black SBCs.
\ No newline at end of file
diff --git a/books/pru-cookbook/01case/case.rst b/books/pru-cookbook/01case/case.rst
index 6cc17c58..01a9e92b 100644
--- a/books/pru-cookbook/01case/case.rst
+++ b/books/pru-cookbook/01case/case.rst
@@ -48,7 +48,7 @@ The following are resources used in this chapter.
.. admonition:: Resources
- * `Pocket Beagle System Reference Manual <https://docs.beagleboard.io/latest/boards/pocketbeagle/original/index.html>`_
+ * `PocketBeagle System Reference Manual <https://docs.beagleboard.io/latest/boards/pocketbeagle/original/index.html>`_
* `BeagleBone Black P8 Header Table <https://docs.beagleboard.io/latest/boards/beaglebone/black/ch07.html#id2>`_
* `P8 Header Table from exploringBB <https://github.com/derekmolloy/exploringBB/blob/master/chp06/docs/BeagleboneBlackP8HeaderTable.pdf>`_
* `BeagleBone Black P9 Header Table <https://docs.beagleboard.io/latest/boards/beaglebone/black/ch07.html#id3>`_
@@ -133,7 +133,7 @@ The ``-f 10`` says to use a frequency of 10 Hz and the ``-p 1.5`` says to set th
-s {limit} Sweep servo back/forth between +- limit
Limit can be between 0 & 1.5
-r {ch} Use DSM radio channel {ch} to control servo
- -h Print this help messege
+ -h Print this help message
sample use to center servo channel 1:
rc_test_servo -c 1 -p 0.0
@@ -174,7 +174,7 @@ PRU register to pin table
You can find these details in the
-* `Pocket Beagle pinout <https://docs.google.com/spreadsheets/d/1FRGvYOyW1RiNSEVprvstfJAVeapnASgDXHtxeDOjgqw/edit?usp=sharing>`_
+* `PocketBeagle pinout <https://docs.google.com/spreadsheets/d/1FRGvYOyW1RiNSEVprvstfJAVeapnASgDXHtxeDOjgqw/edit?usp=sharing>`_
* `BeagleBone AI PRU pins <https://docs.google.com/spreadsheets/d/1dFSBVem86vAUD7MLXvqdS-N0Efi8_g_O1iTqzql8DAo/edit#gid=0>`_
@@ -649,9 +649,9 @@ to full white at the same time you will need at least a 4A supply.
.. figure:: figures/pocketscroller.jpg
:align: center
- :alt: Pocket Beagle Driving a P5 RGB LED Matrix via the PocketScroller Cape
+ :alt: PocketBeagle Driving a P5 RGB LED Matrix via the PocketScroller Cape
- Pocket Beagle Driving a P5 RGB LED Matrix via the PocketScroller Cape
+ PocketBeagle Driving a P5 RGB LED Matrix via the PocketScroller Cape
Software
---------
diff --git a/books/pru-cookbook/05blocks/blocks.rst b/books/pru-cookbook/05blocks/blocks.rst
index 84c6785d..5b56cf55 100644
--- a/books/pru-cookbook/05blocks/blocks.rst
+++ b/books/pru-cookbook/05blocks/blocks.rst
@@ -1804,7 +1804,7 @@ First, the connector looks like :ref:`blocks_matrix_j1`.
Notice the labels on the connect match the labels in the code.
:ref:`blocks_pocket_scroller_pins` shows how the pins on the display are
-mapped to the pins on the Pocket Beagle.
+mapped to the pins on the PocketBeagle.
.. ToDo Make a mapping table for the Black
.. https://github.com/FalconChristmas/fpp/blob/master/src/pru/OctoscrollerV2.hp
diff --git a/books/pru-cookbook/08ai/ai.rst b/books/pru-cookbook/08ai/ai.rst
index b37f13ac..bf503c7f 100644
--- a/books/pru-cookbook/08ai/ai.rst
+++ b/books/pru-cookbook/08ai/ai.rst
@@ -3,7 +3,7 @@
Moving to the BeagleBone AI
############################
-So far all our examples have focussed mostly on the BeagleBone Black and Pocket Beagle.
+So far all our examples have focussed mostly on the BeagleBone Black and PocketBeagle.
These are both based on the am335x chip. The new kid on the block is the BeagleBone AI
which is based on the am5729. The new chip brings with it new capabilities one of
which is four PRUs. This chapter details what changes when moving from two to
diff --git a/intro/contribution/linux-upstream.rst b/intro/contribution/linux-upstream.rst
index da9a740a..5768053c 100644
--- a/intro/contribution/linux-upstream.rst
+++ b/intro/contribution/linux-upstream.rst
@@ -121,7 +121,7 @@ Cross-arch Development
While working with the kernel, you'll most likely not be compiling it on the machine
that you intend to actually boot it on.
For example if you are compiling the Kernel for BeageBone Black it's probably not ideal
-for you to actually clone the entire kernel on BBB and then compile it there.
+for you to actually clone the entire kernel on BeagleBone Black and then compile it there.
What you'd do instead is pick a much powerful machine like a Desktop PC or laptop and
then use cross arch compilers like the arm-gcc for instance to compile the kernel for your
target device.
--
GitLab