diff --git a/boards/beagleplay/demos-and-tutorials/greybus-host.rst b/boards/beagleplay/demos-and-tutorials/greybus-host.rst
index c07e7bd3cadcf8c7edf92b421f40bb8a6f09eda4..7ffe35cf03d7b1fb8d2ccdc1b89ae35be970457d 100644
--- a/boards/beagleplay/demos-and-tutorials/greybus-host.rst
+++ b/boards/beagleplay/demos-and-tutorials/greybus-host.rst
@@ -6,9 +6,9 @@ BeagleConnectâ„¢ Greybus demo using BeagleConnectâ„¢ Freedom and BeaglePlay
BeaglePlay CC1352 Firmware
**************************
-Build
+Build (Download and Setup Zephyr for BeaglePlay)
=====
-#. Download and setup Zephyr for BeaglePlay
+#. Install prerequisites
.. code-block:: bash
@@ -21,26 +21,62 @@ Build
libxml2-dev libxslt1-dev libssl-dev libjpeg62-turbo-dev libmagic1 \
libtool-bin autoconf automake libusb-1.0-0-dev \
python3-tk python3-virtualenv
- wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.16.3/zephyr-sdk-0.16.3_linux-aarch64_minimal.tar.xz
+
+ .. 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
- python3 -m virtualenv zephyr-beagle-cc1352-env
+
+
+#. 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
- If you exit and come back, you'll need to reactivate your Zephyr build environment.
+ NOTE - If you exit and come back, you'll need to reactivate your Zephyr build environment.
.. code-block:: bash
@@ -54,14 +90,19 @@ Build
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.
@@ -69,7 +110,7 @@ Build
#. 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
@@ -146,29 +187,29 @@ Building gb-beagleplay Kernel Module
Flashing BeagleConnect Freedom Greybus Firmware
***********************************************
-#. Connect beagleconnect freedom to beagleplay
-#. Build beagleconnect freedom 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 bcf
+#. Flash the BeagleConnect Freedom
.. code-block:: bash
west flash
-Run Demo
+Run the Demo
*********
-#. Connect beagleconnect.
+#. Connect BeagleConnect Freedom.
#. See shell output using `tio`
.. code-block:: bash
tio /dev/ACM0
-#. Press reset button on beagleconnect freedom.
+#. Press the Reset button on BeagleConnect Freedom
#. Verify that greybus is working by checking the `tio` output. It should look as follows:
@@ -204,7 +245,6 @@ Run Demo
[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
- uart:~$
#. Load gb-beagleplay