diff --git a/CONTRIB.rst b/CONTRIB.rst
new file mode 100644
index 0000000000000000000000000000000000000000..920370bfa4c6f285376e2aafec5d2e1267f5c9ea
--- /dev/null
+++ b/CONTRIB.rst
@@ -0,0 +1,31 @@
+.. _contributors:
+
+Contributors
+#############
+
+This is a list of people who have made contributions to BeagleBoard.org unified documentation project.
+
+People are listed alphabetically, as verified with Unix sort:
+
+.. code-block:: shell
+
+ $ grep "^- " CONTRIB.rst | LC_ALL=C sort -u -c -f
+
+
+This is certainly not comprehensive, and if you've been overlooked (sorry!), please open an issue on GitLab or mention it on the forum.
+
+- `Andrei Aldea <https://git.beagleboard.org/andrei1998>`_
+- `Ayush Singh <https://git.beagleboard.org/ayush1325>`_
+- Cathy Wicks
+- `Deepak Khatri <https://git.beagleboard.org/lorforlinux>`_
+- `Dhruva Gole <https://git.beagleboard.org/dhruvag2000>`_
+- `Harshil Bhatt <https://git.beagleboard.org/harshilbhatt2001>`_
+- `Jason Kridner <https://git.beagleboard.org/jkridner/>`_
+- `Jian De <https://git.beagleboard.org/jiande>`_
+- `Joshua Neal <https://git.beagleboard.org/jdneal>`_
+- `Kai Yamada <https://git.beagleboard.org/gpioblink>`_
+- `Krishna Narayanan <https://git.beagleboard.org/Krishna_13>`_
+- `Mark A. Yoder <https://git.beagleboard.org/yoder>`_
+- `Robert Nelson <https://git.beagleboard.org/RobertCNelson>`_
+- `Sabeeh Khan <https://git.beagleboard.org/sabeeh.khan14>`_
+- `Seth N <https://git.beagleboard.org/silver2row>`_
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5ca379058e90dab0a0e23d07f423cfe0266cc8e5..4835570d99be6a468286ecf2d8357bcd84dd0856 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -7,15 +7,21 @@ the BeagleBoard.org Foundation at https://git.beagleboard.org/docs/docs.beaglebo
mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this
document in a pull request.
-## Code of Conduct
+## Contribution
-This project and everyone participating in it is governed by
-the [BeagleBoard.org Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to
-uphold this code. Please report unacceptable behavior to [coc@bbb.io](mailto:coc@bbb.io) or
-contact one of the administrators on https://forum.beagleboard.org.
+Contributions in any form are appreciated. If you want to contribute to the docs but not sure
+where to start then you can checkout our contribution documents to help you with your first pull request.
-## FAQ
+### Code of Conduct
-* [Frequently Asked Questions category on the BeagleBoard.org Forum](https://forum.beagleboard.org/c/faq/19)
+This project and everyone participating in it is governed by the [BeagleBoard.org Code of Conduct](https://docs.beagleboard.org/latest/intro/contribution/index.html#code-of-conduct). By participating, you are expected to uphold this code. Please report unacceptable behavior to [coc@bbb.io](mailto:coc@bbb.io) or contact one of the administrators on https://forum.beagleboard.org.
+
+### Style and usage guidelines
+
+If you are new to Sphinx, RST, or git then you can checkout out our [Style and usage guidelines](https://docs.beagleboard.org/latest/intro/contribution/index.html#style-and-usage-guidelines).
See more at https://docs.beagleboard.org/en/latest/intro/contribution/.
+
+## FAQ
+
+* [Frequently Asked Questions category on the BeagleBoard.org Forum](https://forum.beagleboard.org/c/faq/19)
diff --git a/boards/beaglebone/ai-64/index.rst b/boards/beaglebone/ai-64/index.rst
index baa85ee1ff351090c2a94896fe812f28cb39e151..5ed36ecb825a2b28e40f63f42c5b12b99d3b822b 100644
--- a/boards/beaglebone/ai-64/index.rst
+++ b/boards/beaglebone/ai-64/index.rst
@@ -11,11 +11,6 @@ are all that need to be added to start building performance-optimized embedded a
expansion possibilities are enabled through familiar BeagleBone® cape headers, with hundreds of open-source
hardware examples and dozens of readily available embedded expansion options available off-the-shelf.
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
.. admonition:: OSHWA Certification mark
.. figure:: images/OSHW_mark_US002120.*
@@ -24,6 +19,13 @@ hardware examples and dozens of readily available embedded expansion options ava
:alt: BeagleBone AI-64 OSHW Mark
.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beagleboard/beaglebone-ai-64
+
+.. tip::
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beaglebone/ai/index.rst b/boards/beaglebone/ai/index.rst
index 7007d139487ee702a82f5abddf35af5a76561b50..29427990b5153898c31b6b89dfa841c844de9f49 100644
--- a/boards/beaglebone/ai/index.rst
+++ b/boards/beaglebone/ai/index.rst
@@ -3,14 +3,6 @@
BeagleBone AI
###############
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
- All derivative works are to be attributed to `Jason Kridner of
- BeagleBoard.org <https://beagleboard.org/about/jkridner>`__.
-
.. admonition:: OSHWA Certification mark
.. figure:: images/OSHW_mark_US000169.*
@@ -19,6 +11,14 @@ BeagleBone AI
:alt: BeagleBone AI OSHW Mark
.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beagleboard/beaglebone-ai
+
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beaglebone/black/index.rst b/boards/beaglebone/black/index.rst
index 983aec2b3c431767672b227d1c26af1fc401a245..549e7e33605343928aaae408ee54e7dcb13569de 100644
--- a/boards/beaglebone/black/index.rst
+++ b/boards/beaglebone/black/index.rst
@@ -6,11 +6,6 @@ BeagleBone Black
BeagleBone Black is a low-cost, community-supported development platform for developers and hobbyists.
Boot Linux in under 10 seconds and get started on development in less than 5 minutes with just a single USB cable.
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
.. admonition:: OSHWA Certification mark (BeagleBone Black)
.. figure:: images/OSHW_mark_US000236.*
@@ -25,8 +20,17 @@ Boot Linux in under 10 seconds and get started on development in less than 5 min
:target: https://certification.oshwa.org/us000011.html
:alt: BeagleBone Black Wireless OSHW Mark
+.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at,
+
+ - BeagleBone Black: https://git.beagleboard.org/beagleboard/beaglebone-black
+ - BeagleBone Black Wireless: https://git.beagleboard.org/beagleboard/beaglebone-black-wireless
-.. note::
+.. tip::
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beaglebone/blue/index.rst b/boards/beaglebone/blue/index.rst
index b8be573d47849979296c2ca219688ea21370db16..21e004a3b263a5b73696f7a194d826c33fb2e24a 100644
--- a/boards/beaglebone/blue/index.rst
+++ b/boards/beaglebone/blue/index.rst
@@ -15,11 +15,6 @@ robotics by `UCSD Flow Control and Coordinated Robotics Lab <http://robotics.ucs
`WowWee <http://www.wowwee.com/mip/>`_, `National Instruments LabVIEW <http://www.ni.com/labview/>`_
and of course the `BeagleBoard.org Foundation <https://beagleboard.org/about>`_.
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
.. admonition:: OSHWA Certification mark
.. figure:: media/OSHW_mark_US000064.*
@@ -27,7 +22,17 @@ and of course the `BeagleBoard.org Foundation <https://beagleboard.org/about>`_.
:target: https://certification.oshwa.org/us000064.html
:alt: BeagleBone Blue OSHW Mark
+
.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beagleboard/beaglebone-blue
+
+
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beaglebone/index.rst b/boards/beaglebone/index.rst
index 5a4e348c8e5862d15f24ecec371e144699593f07..780dc00a5bb05990b82619951e2702b250052296 100644
--- a/boards/beaglebone/index.rst
+++ b/boards/beaglebone/index.rst
@@ -22,12 +22,12 @@ with links to their latest PDF-formatted System Reference Manual and the latest
included both here and in the downloadable beagleboard-docs.pdf linked on the bottom-left
of your screen.
-.. admonition:: Contributors
+.. note::
This work is licensed under a `Creative Commons Attribution-ShareAlike
4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-.. note::
+.. tip::
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beagleconnect/freedom/index.rst b/boards/beagleconnect/freedom/index.rst
index c55b3f3f20cf7db3a200f946a952303158dc895c..68bcadf251aa70ec37739398a436e57c6d8b71a3 100644
--- a/boards/beagleconnect/freedom/index.rst
+++ b/boards/beagleconnect/freedom/index.rst
@@ -17,22 +17,26 @@ over-the-air upgrades (OTA) capability. This MCU provides flexible support for m
:alt: BeagleConnectâ„¢ Freedom board
.. important::
+
This is a work in progress, for latest documentation please
visit https://docs.beagleboard.org/latest/
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
.. admonition:: OSHWA Certification mark
.. figure:: media/OSHW_mark_US002175.*
:width: 200
:target: https://certification.oshwa.org/us002175.html
:alt: BeagleConnectâ„¢ Freedom OSHW Mark
-
+
.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beagleconnect/freedom
+
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beagleconnect/index.rst b/boards/beagleconnect/index.rst
index 0ebaa334019fce75af8c21ab4fdd0583bc8d63d8..137bd541805cf17f9cf9b801f237a61739d84032 100644
--- a/boards/beagleconnect/index.rst
+++ b/boards/beagleconnect/index.rst
@@ -7,12 +7,13 @@ BeagleConnect
Currently under development
-.. admonition:: Contributors
+.. note::
This work is licensed under a `Creative Commons Attribution-ShareAlike
4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-.. note::
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beagleplay/05-demos.rst b/boards/beagleplay/05-demos.rst
index 4501442468961174c9e87c9ff7123f05ef158989..948ce50a8536a05e070a58f768fe8b02696cc5af 100644
--- a/boards/beagleplay/05-demos.rst
+++ b/boards/beagleplay/05-demos.rst
@@ -115,6 +115,16 @@ Demos and tutorials
intermediate
+.. card::
+ :link: greybus-host
+ :link-type: ref
+
+ **Bealgplay Greybus Host**
+ +++
+ .. admonition:: Complexity level
+
+ intermediate
+
.. raw:: latex
\end{comment}
@@ -132,3 +142,4 @@ Demos and tutorials
demos-and-tutorials/using-csi
demos-and-tutorials/zephyr-cc1352-development
demos-and-tutorials/play-kernel-development
+ demos-and-tutorials/greybus-host
diff --git a/boards/beagleplay/demos-and-tutorials/greybus-host.rst b/boards/beagleplay/demos-and-tutorials/greybus-host.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c94f8027c0660f2b6daada6923cd6506a534ef46
--- /dev/null
+++ b/boards/beagleplay/demos-and-tutorials/greybus-host.rst
@@ -0,0 +1,302 @@
+.. _greybus-host:
+
+BeagleConnectâ„¢ Greybus demo using BeagleConnectâ„¢ Freedom and BeaglePlay
+#######################################################################
+
+BeaglePlay CC1352 Firmware
+**************************
+
+Build (Download and Setup Zephyr for BeaglePlay)
+================================================
+
+#. Install prerequisites
+
+ .. code-block:: bash
+
+ cd
+ sudo apt update
+ sudo apt install --no-install-recommends -y \
+ gperf \
+ ccache dfu-util \
+ libsdl2-dev \
+ libxml2-dev libxslt1-dev libssl-dev libjpeg62-turbo-dev libmagic1 \
+ libtool-bin autoconf automake libusb-1.0-0-dev \
+ python3-tk python3-virtualenv
+
+ .. code-block:: bash
+
+#. Download the latest Zephyr Release, extract it and cleanup
+
+ sudo wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.16.3/zephyr-sdk-0.16.3_linux-aarch64_minimal.tar.xz
+ tar xf zephyr-sdk-0.16.3_linux-aarch64_minimal.tar.xz
+ rm zephyr-sdk-0.16.3_linux-aarch64_minimal.tar.xz
+
+
+#. Run the Zephyr SDK Setup Script
+
+ .. code-block:: bash
+
+ ./zephyr-sdk-0.16.3/setup.sh -t arm-zephyr-eabi -c
+
+#. Download and Initialize `West <https://docs.zephyrproject.org/latest/develop/west/index.html/>`_. (Zephyr's meta-tool)
+
+ Note - You may want to add `/home/debian/.local/bin` to your `.bashrc` file to make the West command available after a reboot
+
+ .. code-block:: bash
+
+ pip3 install --user -U west
+ export PATH="/home/debian/.local/bin:$PATH"
+ west init -m https://git.beagleboard.org/beagleconnect/zephyr/zephyr --mr sdk-next zephyr-beagle-cc1352-sdk
+ cd $HOME/zephyr-beagle-cc1352-sdk
+
+
+#. Setup a Python Virtual Environment and add our PATH Variables
+
+ .. code-block:: bash
+
+ virtualenv zephyr-beagle-cc1352-env
+ echo "export ZEPHYR_TOOLCHAIN_VARIANT=zephyr" >> $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+ echo "export ZEPHYR_SDK_INSTALL_DIR=$HOME/zephyr-sdk-0.16.3" >> $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+ echo "export ZEPHYR_BASE=$HOME/zephyr-beagle-cc1352-sdk/zephyr" >> $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+ echo 'export PATH=$HOME/zephyr-beagle-cc1352-sdk/zephyr/scripts:$PATH' >> $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+ echo "export BOARD=beagleplay_cc1352" >> $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+ source $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+
+
+#. Update West
+
+ .. code-block:: bash
+
+ west update
+ west zephyr-export
+
+#. Install Python Prerequisites
+
+ .. code-block:: bash
+
+ pip3 install -r zephyr/scripts/requirements-base.txt
+
+#. Activate the Zephyr build environment
+
+ NOTE - If you exit and come back, you'll need to reactivate your Zephyr build environment.
+
+ .. code-block:: bash
+
+ source $HOME/zephyr-beagle-cc1352-sdk/zephyr-beagle-cc1352-env/bin/activate
+
+#. Verify Zephyr setup for BeaglePlay
+
+ .. code-block:: shell-session
+
+ (zephyr-beagle-cc1352-env) debian@BeaglePlay:~$ cmake --version
+ cmake version 3.22.1
+
+ CMake suite maintained and supported by Kitware (kitware.com/cmake).
+
+ (zephyr-beagle-cc1352-env) debian@BeaglePlay:~$ python3 --version
+ Python 3.9.2
+
+ (zephyr-beagle-cc1352-env) debian@BeaglePlay:~$ dtc --version
+ Version: DTC 1.6.0
+
+ (zephyr-beagle-cc1352-env) debian@BeaglePlay:~$ west --version
+ West version: v0.14.0
+
+ (zephyr-beagle-cc1352-env) debian@BeaglePlay:~$ ./zephyr-sdk-0.16.3/arm-zephyr-eabi/bin/arm-zephyr-eabi-gcc --version
+ arm-zephyr-eabi-gcc (Zephyr SDK 0.16.3) 12.1.0
+
+ Copyright (C) 2022 Free Software Foundation, Inc.
+ This is free software; see the source for copying conditions. There is NO
+ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+#. Clone CC1352 Firmware at top level: https://git.beagleboard.org/gsoc/greybus/cc1352-firmware
+
+ .. code-block:: bash
+
+ cd ~
+ git clone https://git.beagleboard.org/gsoc/greybus/cc1352-firmware
+
+#. Build the Firmware
+
+ .. code-block:: bash
+
+ west build -b beagleplay_cc1352 -p always cc1352-firmware
+
+#. You can now find the built firmware at `build/zephyr/zephyr.bin`
+
+Flash
+=====
+#. Ensure the `gb-beagleplay` driver isn't blocking the serial port.
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~$ echo " fdtoverlays /overlays/k3-am625-beagleplay-bcfserial-no-firmware.dtbo" | sudo tee -a /boot/firmware/extlinux/extlinux.conf
+ debian@BeaglePlay:~$ sudo shutdown -r now
+
+ .. note::
+
+ The default password is `temppwd`.
+
+#. Flash Firmware
+
+ .. code-block:: bash
+
+ west flash -b beagleplay_cc1352
+
+#. Ensure the `gb-beagleplay` driver is set to load.
+
+ .. code-block:: bash
+
+ sudo sed -e '/bcfserial-no-firmware/ s/^#*/#/' -i /boot/firmware/extlinux/extlinux.conf
+ sudo shutdown -r now
+
+Building gb-beagleplay Kernel Module
+**************************************
+`gb-beagleplay` is still not merged upstream and thus needs to be built seperately. This should not be required in the future.
+
+#. Disable bcfserial driver. Add `module_blacklist=bcfserial` to kernel parameters at `/boot/firmware/extlinux/extlinux.conf` (line 3).
+
+#. Reboot
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~$ sudo shutdown -r now
+
+#. Download the upstream module
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~$ git clone https://git.beagleboard.org/gsoc/greybus/beagleplay-greybus-driver.git
+ debian@BeaglePlay:~$ cd beagleplay-greybus-driver
+
+#. Install dependencies
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~$ sudo apt install linux-headers-$(uname -r)
+
+#. Build Kernel moudle
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~/beagleplay-greybus-driver$ make
+ make -C /lib/modules/5.10.168-ti-arm64-r111/build M=/home/debian/beagleplay-greybus-driver modules
+ make[1]: Entering directory '/usr/src/linux-headers-5.10.168-ti-arm64-r111'
+ CC [M] /home/debian/beagleplay-greybus-driver/gb-beagleplay.o
+ MODPOST /home/debian/beagleplay-greybus-driver/Module.symvers
+ CC [M] /home/debian/beagleplay-greybus-driver/gb-beagleplay.mod.o
+ LD [M] /home/debian/beagleplay-greybus-driver/gb-beagleplay.ko
+ make[1]: Leaving directory '/usr/src/linux-headers-5.10.168-ti-arm64-r111'
+
+Flashing BeagleConnect Freedom Greybus Firmware
+***********************************************
+#. Connect BeagleConnect Freedom to BeaglePlay
+#. Build the BeagleConnect Freedom firmware
+
+ .. code-block:: bash
+
+ west build -b beagleconnect_freedom modules/greybus/samples/subsys/greybus/net/ -p -- -DOVERLAY_CONFIG=overlay-802154-subg.conf
+
+#. Flash the BeagleConnect Freedom
+
+ .. code-block:: bash
+
+ west flash
+
+Run the Demo
+*************
+
+#. Connect BeagleConnect Freedom.
+#. See shell output using `tio`
+
+ .. code-block:: bash
+
+ tio /dev/ACM0
+
+#. Press the Reset button on BeagleConnect Freedom
+
+#. Verify that greybus is working by checking the `tio` output. It should look as follows:
+
+ .. code-block:: shell-session
+
+ [00:00:00.000,976] <dbg> greybus_platform_bus: greybus_init: probed greybus: 0 major: 0 minor: 1
+ [00:00:00.001,068] <dbg> greybus_platform_string: greybus_string_init: probed greybus string 4: hdc2010
+ [00:00:00.001,129] <dbg> greybus_platform_string: greybus_string_init: probed greybus string 3: opt3001
+ [00:00:00.001,190] <dbg> greybus_platform_string: greybus_string_init: probed greybus string 2: Greybus Service Sample Application
+ [00:00:00.001,251] <dbg> greybus_platform_string: greybus_string_init: probed greybus string 1: Zephyr Project RTOS
+ [00:00:00.001,251] <dbg> greybus_platform_interface: greybus_interface_init: probed greybus interface 0
+ [00:00:00.001,281] <dbg> greybus_platform_bundle: greybus_bundle_init: probed greybus bundle 1: class: 10
+ [00:00:00.001,312] <dbg> greybus_platform_bundle: greybus_bundle_init: probed greybus bundle 0: class: 0
+ [00:00:00.001,342] <dbg> greybus_platform_control: greybus_control_init: probed cport 0: bundle: 0 protocol: 0
+ [00:00:00.001,434] <dbg> greybus_platform: gb_add_cport_device_mapping: added mapping between cport 1 and device gpio@40022000
+ [00:00:00.001,464] <dbg> greybus_platform_gpio_control: greybus_gpio_control_init: probed cport 1: bundle: 1 protocol: 2
+ [00:00:00.001,556] <dbg> greybus_platform: gb_add_cport_device_mapping: added mapping between cport 2 and device sensor-switch
+ [00:00:00.001,556] <dbg> greybus_platform_i2c_control: greybus_i2c_control_init: probed cport 2: bundle: 1 protocol: 3
+ *** Booting Zephyr OS build bcf-sdk-0.2.1-3384-ge76584f824c8 ***
+ [00:00:00.009,704] <dbg> greybus_service: greybus_service_init: Greybus initializing..
+ [00:00:00.009,765] <dbg> greybus_manifest: identify_descriptor: cport_id = 0
+ [00:00:00.009,796] <dbg> greybus_manifest: identify_descriptor: cport_id = 1
+ [00:00:00.009,826] <dbg> greybus_manifest: identify_descriptor: cport_id = 2
+ [00:00:00.009,857] <dbg> greybus_transport_tcpip: gb_transport_backend_init: Greybus TCP/IP Transport initializing..
+ [00:00:00.010,101] <inf> greybus_transport_tcpip: CPort 0 mapped to TCP/IP port 4242
+ [00:00:00.014,709] <inf> greybus_transport_tcpip: CPort 1 mapped to TCP/IP port 4243
+ [00:00:00.014,953] <inf> greybus_transport_tcpip: CPort 2 mapped to TCP/IP port 4244
+ [00:00:00.015,075] <inf> greybus_transport_tcpip: Greybus TCP/IP Transport initialized
+ [00:00:00.015,136] <inf> greybus_manifest: Registering CONTROL greybus driver.
+ [00:00:00.015,167] <dbg> greybus: _gb_register_driver: Registering Greybus driver on CP0
+ [00:00:00.015,411] <inf> greybus_manifest: Registering GPIO greybus driver.
+ [00:00:00.015,411] <dbg> greybus: _gb_register_driver: Registering Greybus driver on CP1
+ [00:00:00.015,625] <inf> greybus_manifest: Registering I2C greybus driver.
+ [00:00:00.015,625] <dbg> greybus: _gb_register_driver: Registering Greybus driver on CP2
+ [00:00:00.015,777] <inf> greybus_service: Greybus is active
+
+#. Load gb-beagleplay
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~$ sudo insmod $HOME/beagleplay-greybus-driver/gb-beagleplay.ko
+
+#. Check `iio_device` to verify that greybus node has been detected:
+
+ .. code-block:: shell-session
+
+ debian@BeaglePlay:~$ iio_info
+ Library version: 0.24 (git tag: v0.24)
+ Compiled with backends: local xml ip usb
+ IIO context created with local backend.
+ Backend version: 0.24 (git tag: v0.24)
+ Backend description string: Linux BeaglePlay 5.10.168-ti-arm64-r111 #1bullseye SMP Tue Sep 26 14:22:20 UTC 2023 aarch64
+ IIO context has 2 attributes:
+ local,kernel: 5.10.168-ti-arm64-r111
+ uri: local:
+ IIO context has 2 devices:
+ iio:device0: adc102s051
+ 2 channels found:
+ voltage1: (input)
+ 2 channel-specific attributes found:
+ attr 0: raw value: 4068
+ attr 1: scale value: 0.805664062
+ voltage0: (input)
+ 2 channel-specific attributes found:
+ attr 0: raw value: 0
+ attr 1: scale value: 0.805664062
+ No trigger on this device
+ iio:device1: hdc2010
+ 3 channels found:
+ temp: (input)
+ 4 channel-specific attributes found:
+ attr 0: offset value: -15887.515151
+ attr 1: peak_raw value: 28928
+ attr 2: raw value: 28990
+ attr 3: scale value: 2.517700195
+ humidityrelative: (input)
+ 3 channel-specific attributes found:
+ attr 0: peak_raw value: 43264
+ attr 1: raw value: 41892
+ attr 2: scale value: 1.525878906
+ current: (output)
+ 2 channel-specific attributes found:
+ attr 0: heater_raw value: 0
+ attr 1: heater_raw_available value: 0 1
+ No trigger on this device
+
diff --git a/boards/beagleplay/index.rst b/boards/beagleplay/index.rst
index b18cfc49cddb1b1635ad8223252fecc0a51a0459..c59c12c5874fe4381c873efef52ce4fdbad4053a 100644
--- a/boards/beagleplay/index.rst
+++ b/boards/beagleplay/index.rst
@@ -7,11 +7,6 @@ BeaglePlay
This is a work in progress, for latest documentation please
visit https://docs.beagleboard.org/latest/
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
.. admonition:: OSHWA Certification mark
.. figure:: images/OSHW_mark_US002174.*
@@ -31,7 +26,15 @@ BeaglePlay
| :alt: BeaglePlay | :alt: BeaglePlay |
+----------------------------------------------------+---------------------------------------------------------+
-.. note::
+.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beagleplay/beagleplay
+
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/beaglev/ahead/index.rst b/boards/beaglev/ahead/index.rst
index d1d6dbcf360df7a9ae540c4741d4291b3c87ab2d..654841b0b08b09f19766df50e2a9b20eb9afe122 100644
--- a/boards/beaglev/ahead/index.rst
+++ b/boards/beaglev/ahead/index.rst
@@ -11,11 +11,6 @@ BeagleV-Ahead
This is a work in progress, for latest documentation please
visit https://docs.beagleboard.org/latest/
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
.. admonition:: OSHWA Certification mark
.. figure:: media/OSHW_mark_US002535.*
@@ -23,7 +18,15 @@ BeagleV-Ahead
:target: https://certification.oshwa.org/us002535.html
:alt: BeagleV-Ahead OSHW Mark
-.. note::
+.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beaglev-ahead/beaglev-ahead
+
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/capes/images/RelayOne.png b/boards/capes/images/RelayOne.png
new file mode 100644
index 0000000000000000000000000000000000000000..bd6184eb1f0382acbef48ba26edd741584c6ca14
Binary files /dev/null and b/boards/capes/images/RelayOne.png differ
diff --git a/boards/capes/relay.rst b/boards/capes/relay.rst
index fc026ef4af8f19b811bbc786a2fface5487cf29d..c9867c37427e7672bf4d01b19272d534d4fe46ce 100644
--- a/boards/capes/relay.rst
+++ b/boards/capes/relay.rst
@@ -19,8 +19,8 @@ It contains four relays, each of which can be operated independently from the Be
Installation
************
-No special configuration is required. When you plug Cape into your BeagleBoard,
-it is automatically recognized by the Cape Universal function.
+No special configuration is required. When you plug the Relay Cape into your BeagleBoard,
+it will automatically be recognized by the Cape Universal function.
You can check to see if the Relay Cape is recognized with the following command.
@@ -33,7 +33,7 @@ If you see `BBORG_RELAY-00A2.kernel` in this list, it has been loaded correctly.
If it is not loaded correctly, you can also load it directly
by adding the following to the U-Boot options
-(which can be reflected by changing /boot/uEnv.txt).
+(which can be reflected by changing the file /boot/uEnv.txt) to reflect the text below.
.. code-block::
@@ -54,8 +54,8 @@ The LEDs can be controlled by modifying the files in its directory.
echo 1 > relay1/brightness
-This allows you to adjust the brightness;
-entering 1 for brightness turns it ON, and entering 0 for OFF.
+This allows you to adjust the brightness;
+entering 1 for brightness turns it ON while entering 0 turns it OFF.
The four relays can be changed individually
by changing the number after "relay" in /sys/class/leds/relay.
@@ -162,9 +162,11 @@ One thing to note: `sudo apt install cmake`
.. code-block::
/*
+
Simple gpiod example of toggling a LED connected to a gpio line from
the BeagleBone Black Wireless and Relay Cape.
Exits with or without CTRL-C.
+
*/
// This source can be found here: https://github.com/tranter/blogs/blob/master/gpio/part9/example.c
@@ -231,7 +233,7 @@ One thing to note: `sudo apt install cmake`
4. mkdir build && touch CMakeLists.txt
-5. In CMakeLists.txt, add these values and text
+5. In CMakeLists.txt, add these values and text via nano or your favorite editor!
.. code-block::
@@ -249,4 +251,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 BeagleBone Black Wireless/BeagleBone Black 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.
diff --git a/boards/index.rst b/boards/index.rst
index ed22495725d4903fd6dd021caaeb336214fda971..0aec9f1de91954f3274e75cd197279aa623327ed 100644
--- a/boards/index.rst
+++ b/boards/index.rst
@@ -25,12 +25,13 @@ options that enable almost endless sensing and actuation expansion.
:ref:`BeagleBoard <beagleboard-boards-home>` is a family of ARM-based, Linux-capable boards where this project
started.
-.. admonition:: Contributors
+.. note::
This work is licensed under a `Creative Commons Attribution-ShareAlike
4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-.. note::
+.. tip::
+
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/boards/pocketbeagle/original/index.rst b/boards/pocketbeagle/original/index.rst
index 6e38371600e0510fe6945a50055ec6e533a4a9c4..2d2a40a360adf5f35d0bf708df01c516513fec23 100644
--- a/boards/pocketbeagle/original/index.rst
+++ b/boards/pocketbeagle/original/index.rst
@@ -3,14 +3,6 @@
PocketBeagle
###################
-.. admonition:: Contributors
-
- This work is licensed under a `Creative Commons Attribution-ShareAlike
- 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
-
- - Maintaining author: `Jason Kridner <jkridner@beagleboard.org>`_
- - Contributing Editor: `Cathy Wicks <cathy@beagleboard.org>`_
-
.. admonition:: OSHWA Certification mark
.. figure:: images/OSHW_mark_US000083.*
@@ -19,6 +11,13 @@ PocketBeagle
:alt: PocketBeagle OSHW mark
.. note::
+
+ This work is licensed under a `Creative Commons Attribution-ShareAlike
+ 4.0 International License <http://creativecommons.org/licenses/by-sa/4.0/>`__
+
+ Hardware design files can be found at https://git.beagleboard.org/beagleboard/pocketbeagle
+
+.. tip::
Make sure to read and accept all the terms & condition provided in the :ref:`boards-terms-and-conditions` page.
Use of either the boards or the design materials constitutes agreement to the T&C including any
diff --git a/books/beaglebone-cookbook/02sensors/sensors.rst b/books/beaglebone-cookbook/02sensors/sensors.rst
index 23117bb5a48b28f16909eb8aafd4033f11781891..ef9f0b667f759ae76a69e71e0b080cb9c84d80b7 100644
--- a/books/beaglebone-cookbook/02sensors/sensors.rst
+++ b/books/beaglebone-cookbook/02sensors/sensors.rst
@@ -230,7 +230,7 @@ Mapping Header Numbers to gpio Numbers
Problem
--------
-You have a sensor attached to the P8 or P9 header and need to know which gpio pin it's using.
+You have a sensor attached to the P8 or P9 header and need to know which gpio pin it is using.
Solution
---------
@@ -508,9 +508,9 @@ the Bone's eQEP ports, as shown in :ref:`digital_rotaryEncoder_fig`.
.. table:: On the BeagleBone and PocketBeage the three encoders are:
+-------------+------------------------------------+
- | eQEP0 | P9.27 and P9.42 OR P1_33 and P2_34 |
+ |eQEP0 | P9.27 and P9.42 OR P1_33 and P2_34 |
+-------------+------------------------------------+
- |eQEP | P9.33 and P9.35 |
+ |eQEP1 | P9.33 and P9.35 |
+-------------+------------------------------------+
|eQEP2 | P8.11 and P8.12 OR P2_24 and P2_33 |
+-------------+------------------------------------+
@@ -729,7 +729,7 @@ shows that you have wired your device to |I2C| bus *2*.
Once the |I2C| device is wired up, you can use a couple handy |I2C|
tools to test the device. Because these are Linux command-line tools,
you have to use *2* as the bus number. *i2cdetect*, shown in :ref:`js_i2cTools`,
-shows which |I2C| devices are on the bus. The *-r* flag indicates which bus to use.
+shows which |I2C| devices are on the bus. The *-r* flag indicates which bus to use.
Our TMP101 is appearing at address *0x49*. You can use the *i2cget* command to read
the value. It returns the temperature in hexadecimal and degrees C.
In this example, 0x18 = 24{deg}C, which is 75.2{deg}F. (Hmmm, the office is a bit warm today.)
@@ -763,7 +763,7 @@ Try warming up the TMP101 with your finger and running *i2cget* again.
Reading the temperature via the kernel driver
==============================================
-The cleanest way to read the temperature from at TMP101 sensor is to use the kernel drive.
+The cleanest way to read the temperature from at TMP101 sensor is to use the kernel driver.
Assuming the TMP101 is on bus 2 (the last digit is the bus number)
@@ -867,13 +867,13 @@ Run the code by using the following command:
^C
-Notice using the kernel interface gets you more digits of accuracy.
+Notice using the kernel interface gets you more digits of accuracy.
Reading i2c device directly
===========================
The TMP102 sensor can be read directly with i2c commands rather than
-using the kernel driver. First you need to install the i2c module.
+using the kernel driver. First you need to install the i2c module.
.. code-block:: bash
@@ -890,7 +890,7 @@ using the kernel driver. First you need to install the i2c module.
This gets only 8 bits for the temperature. See the TMP101 datasheet
(https://www.ti.com/product/TMP101)
-for details on how to get up to 12 bits.
+for details on how to get up to 12 bits.
Reading Temperature via a Dallas 1-Wire Device
===============================================
diff --git a/books/pru-cookbook/02start/figures/bb-code-server.png b/books/pru-cookbook/02start/figures/bb-code-server.png
new file mode 100644
index 0000000000000000000000000000000000000000..5754a4b0de1fa09b74cb8429eefa31b394748dc6
Binary files /dev/null and b/books/pru-cookbook/02start/figures/bb-code-server.png differ
diff --git a/books/pru-cookbook/02start/start.rst b/books/pru-cookbook/02start/start.rst
index 664a58afea018ee10b5138fd4b299525c0845b55..dc5f3c450c6d9ee8f6e428a81ab304c9c6ff662d 100644
--- a/books/pru-cookbook/02start/start.rst
+++ b/books/pru-cookbook/02start/start.rst
@@ -5,7 +5,10 @@ Getting Started
We assume you have some experience with the Beagle and are here to learn about
the PRU. This chapter discusses what Beagles are out there, how to load the
-latest software image on your beagle, how to run the Visual Studio Code
+latest software image on your Beagle, how to run the Visual Studio Code IDE and how to
+blink an LED.
+=======
+latest software image on your Beagle, how to run the Visual Studio Code
(VS Code) IDE and how to blink an LED.
If you already have your Beagle and know your way around it, you can find the
@@ -77,13 +80,13 @@ The `Blue <http://beagleboard.org/blue>`_ is a good choice if you are doing robo
BeagleBone Blue
-The Blue has everything the Black has except it has no Ethernet or HDMI.
+The Blue has everything the Black has except it has no Ethernet and no HDMI.
But it also has:
* Wireless: 802.11bgn, Bluetooth 4.1 and BLE
* Battery support: 2-cell LiPo with balancing, LED state-of-charge monitor
* Charger input: 9-18V
-* Motor control: 8 6V servo out, 4 bidirectional DC motor out, 4 quadrature encoder in
+* Motor control: 8 6V @ 4A servo out, 4 bidirectional DC motor out, 4 quadrature encoder in
* Sensors: 9 axis IMU (accels, gyros, magnetometer), barometer, thermometer
* User interface: 11 user programmable LEDs, 2 user programmable buttons
@@ -229,17 +232,35 @@ How do I manage and edit my files?
Solution
--------
-The image you downloaded includes `Visual Studio Code <https://code.visualstudio.com/>`_,
+The image you downloaded includes `Visual Studio Code <https://github.com/coder/code-server>`_,
a web-based integrated development environment (IDE) as shown in
-:ref:`start_vsc`.
+:ref:`start_bb-code-server`.
+
+.. _start_bb-code-server:
+
+.. figure:: figures/bb-code-server.png
+ :align: center
+ :alt: The Visual Studio Code IDE
+
+ Visual Studio Code IDE
+
+Just point the browser on your host computer to http://192.168.7.2:3000
+and start exploring. You may also want to upgrade bb-code-server to pull in the latest updates.
+Another route to take is to apply this command to boot the service called bb-code-server.
+
+`sudo systemctl start bb-code-server.service`
+
+If you want the files in your home directory to appear
+in the tree structure click the settings gear and select *Show Home in Favorites*
+as shown in :ref:`start_vsc`.
.. _start_vsc:
.. figure:: figures/vsc.png
:align: center
- :alt: The Visual Studio Code IDE
+ :alt: Vidual Studio Code showing home files
- The Visual Studio Code IDE
+ Visual Studio Code Showing Home files
Just point the browser on your host computer to http://192.168.7.2:3000
and start exploring.
@@ -333,7 +354,7 @@ to run it right now do the following.
If the following doesn't work see
:ref:`compiling_with_clpru_and_lnkpru`
- for instillation instructions.
+ for installation instructions.
.. _start_running_code:
@@ -375,13 +396,13 @@ Running Code on the AI
.. code-block:: shell-session
- bone:~$ make TARGET=hello.pru1_1
- /opt/source/pru-cookbook-code/common/Makefile:28: MODEL=BeagleBoard.org_BeagleBone_AI,TARGET=hello.pru1_1
+ bone$ make TARGET=hello.pru1_1
+ /var/lib/code-server/common/Makefile:28: MODEL=BeagleBoard.org_BeagleBone_AI,TARGET=hello.pru1_1
- Stopping PRU 1_1
CC hello.pru1_1.c
- "/opt/source/pru-cookbook-code/common/prugpio.h", line 4: warning #1181-D: #warning directive: "Found AI"
- LD /tmp/vsx-examples/hello.pru1_1.o
- - copying firmware file /tmp/vsx-examples/hello.pru1_1.out to /lib/firmware/am57xx-pru1_1-fw
+ "/var/lib/code-server/common/prugpio.h", line 4: warning #1181-D: #warning directive: "Found AI"
+ LD /tmp/code-server-examples/hello.pru1_1.o
+ - copying firmware file /tmp/code-server-examples/hello.pru1_1.out to /lib/firmware/am57xx-pru1_1-fw
write_init_pins.sh
writing "none" to "/sys/class/leds/beaglebone:green:usr3/trigger"
- Starting PRU 1_1
@@ -389,7 +410,7 @@ Running Code on the AI
PROC = pru
PRUN = 1_1
PRU_DIR = /dev/remoteproc/pruss1-core1
- rm /tmp/vsx-examples/hello.pru1_1.o
+ rm /tmp/code-server-examples/hello.pru1_1.o
Look quickly and you will see the ``USR3`` LED blinking.
diff --git a/books/pru-cookbook/03details/details.rst b/books/pru-cookbook/03details/details.rst
index e9907c4685595aa97cb888bd8a8cb7557c13f32b..2a1fca7f40263c962a4e05c7e2159989366c8da0 100644
--- a/books/pru-cookbook/03details/details.rst
+++ b/books/pru-cookbook/03details/details.rst
@@ -330,7 +330,11 @@ Solution
``am335x_pru.cmd`` is the standard linker command file that tells the linker
where to put what for the BeagleBone Black and Blue, and the Pocket.
The ``am57xx_pru.cmd`` does the same for the AI.
+<<<<<<< HEAD
+Both files can be found in ``/var/lib/code-server/common``.
+=======
Both files can be found in ``/opt/source/pru-cookbook-code/common``.
+>>>>>>> bf423e10a7d607eb485449d3f53e7823264dfebb
.. literalinclude:: ../code/03details/am335x_pru.cmd
diff --git a/index.rst b/index.rst
index 2696bea737efbe0756043f5a3eabfc465943c4a8..b20cdc894a6af96cfc3153184ff94ad63e34c933 100644
--- a/index.rst
+++ b/index.rst
@@ -34,6 +34,7 @@ Get started engaging the BeagleBoard.org developer community by reading our :ref
/intro/support/index
/intro/beagle101/index
/intro/contribution/index
+ CONTRIB
Boards