From 29cc4015752f886355b759bce18715f2057efaf4 Mon Sep 17 00:00:00 2001
From: Jason Kridner <jkridner@beagleboard.org>
Date: Wed, 7 Sep 2022 16:23:57 -0400
Subject: [PATCH] pru-cookbook: some indentation and external references
---
books/pru-cookbook/01case/case.rst | 4 ++--
books/pru-cookbook/05blocks/blocks.rst | 17 +++++++++--------
books/pru-cookbook/06io/io.rst | 17 +++++++++--------
books/pru-cookbook/07more/more.rst | 11 ++++++-----
books/pru-cookbook/08ai/ai.rst | 9 +++++----
books/pru-cookbook/projects.rst | 2 +-
6 files changed, 32 insertions(+), 28 deletions(-)
diff --git a/books/pru-cookbook/01case/case.rst b/books/pru-cookbook/01case/case.rst
index 5f5cbd44..27b035e7 100644
--- a/books/pru-cookbook/01case/case.rst
+++ b/books/pru-cookbook/01case/case.rst
@@ -35,7 +35,7 @@ Here we present:
.. TODO Switch from LEDscape to FPP
-* `Robotics Control Library <http://strawsondesign.com/docs/roboticscape/>`_
+* `Robotics Control Library <https://beagleboard.org/librobotcontrol>`_
* `BeagleLogic <https://github.com/abhishek-kakkar/BeagleLogic/wiki>`_
* `NeoPixels -- 5050 RGB LEDs with Integrated Drivers (Falcon Christmas) <http://falconchristmas.com>`_
* `RGB LED Matrix (Falcon Christmas) <http://falconchristmas.com>`_
@@ -77,7 +77,7 @@ in :ref:`case_blue`.
Blue balancing
-The `Robotics Control Library <http://strawsondesign.com/docs/roboticscape/>`_ is a
+The `Robotics Control Library <https://beagleboard.org/librobotcontrol>`_ is a
package that is already installed on the Beagle
that contains a C library and example/testing programs. It uses the PRU to extend the
real-time hardware of the Bone by adding eight addional servo channels and one
diff --git a/books/pru-cookbook/05blocks/blocks.rst b/books/pru-cookbook/05blocks/blocks.rst
index 1b62a966..f675235c 100644
--- a/books/pru-cookbook/05blocks/blocks.rst
+++ b/books/pru-cookbook/05blocks/blocks.rst
@@ -7,14 +7,15 @@ Here are some examples that use the basic PRU building blocks.
The following are resources used in this chapter.
-Resources
-~~~~~~~~~~
-
-* `PRU Optimizing C/C++ Compiler, v2.2, User's Guide <http://www.ti.com/lit/ug/spruhv7b/spruhv7b.pdf>`_
-* `AM572x Technical Reference Manual <http://www.ti.com/lit/pdf/spruhz6l>`_ (AI)
-* `AM335x Technical Reference Manual <http://www.ti.com/lit/pdf/spruh73>`_ (All others)
-* `Exploring BeagleBone by Derek Molloy <http://exploringbeaglebone.com/>`_
-* `WS2812 Data Sheet <https://cdn-shop.adafruit.com/datasheets/WS2812.pdf>`_
+.. note::
+
+ *Resources*
+
+ * `PRU Optimizing C/C++ Compiler, v2.2, User's Guide <http://www.ti.com/lit/ug/spruhv7b/spruhv7b.pdf>`_
+ * `AM572x Technical Reference Manual <http://www.ti.com/lit/pdf/spruhz6l>`_ (AI)
+ * `AM335x Technical Reference Manual <http://www.ti.com/lit/pdf/spruh73>`_ (All others)
+ * `Exploring BeagleBone by Derek Molloy <http://exploringbeaglebone.com/>`_
+ * `WS2812 Data Sheet <https://cdn-shop.adafruit.com/datasheets/WS2812.pdf>`_
.. _memory_allocation:
diff --git a/books/pru-cookbook/06io/io.rst b/books/pru-cookbook/06io/io.rst
index 2d019de0..80f20a53 100644
--- a/books/pru-cookbook/06io/io.rst
+++ b/books/pru-cookbook/06io/io.rst
@@ -8,14 +8,15 @@ through the ``pass:[__]R30`` register. Below shows how more GPIO pins can be ac
The following are resources used in this chapter.
-Resources
-~~~~~~~~~~
-
-* `P8 Header Table <https://github.com/derekmolloy/exploringBB/blob/master/chp06/docs/BeagleboneBlackP8HeaderTable.pdf>`_
-* `P9 Header Table <https://github.com/derekmolloy/exploringBB/blob/master/chp06/docs/BeagleboneBlackP9HeaderTable.pdf>`_
-* `AM572x Technical Reference Manual <http://www.ti.com/lit/pdf/spruhz6l>`_ (AI)
-* `AM335x Technical Reference Manual <http://www.ti.com/lit/pdf/spruh73>`_ (All others)
-* `PRU Assembly Language Tools <http://www.ti.com/lit/ug/spruhv6a/spruhv6a.pdf>`_
+.. note::
+
+ *Resources*
+
+ * `P8 Header Table <https://github.com/derekmolloy/exploringBB/blob/master/chp06/docs/BeagleboneBlackP8HeaderTable.pdf>`_
+ * `P9 Header Table <https://github.com/derekmolloy/exploringBB/blob/master/chp06/docs/BeagleboneBlackP9HeaderTable.pdf>`_
+ * `AM572x Technical Reference Manual <http://www.ti.com/lit/pdf/spruhz6l>`_ (AI)
+ * `AM335x Technical Reference Manual <http://www.ti.com/lit/pdf/spruh73>`_ (All others)
+ * `PRU Assembly Language Tools <http://www.ti.com/lit/ug/spruhv6a/spruhv6a.pdf>`_
Editing /boot/uEnv.txt to Access the P8 Header on the Black
************************************************************
diff --git a/books/pru-cookbook/07more/more.rst b/books/pru-cookbook/07more/more.rst
index 4bae78b1..f70501a8 100644
--- a/books/pru-cookbook/07more/more.rst
+++ b/books/pru-cookbook/07more/more.rst
@@ -14,12 +14,13 @@ C. Detailing on how to program in assembly are beyond the scope of this text.
The following are resources used in this chapter.
-Resources
-~~~~~~~~~~
+.. note::
-* `PRU Optimizing C/C++ Compiler, v2.2, User's Guide <http://www.ti.com/lit/ug/spruhv7b/spruhv7b.pdf>`_
-* `PRU Assembly Language Tools User's Guide <http://www.ti.com/lit/ug/spruhv6b/spruhv6b.pdf>`_
-* `PRU Assembly Instruction User Guide <http://www.ti.com/lit/ug/spruij2/spruij2.pdf>`_
+ *Resources*
+
+ * `PRU Optimizing C/C++ Compiler, v2.2, User's Guide <http://www.ti.com/lit/ug/spruhv7b/spruhv7b.pdf>`_
+ * `PRU Assembly Language Tools User's Guide <http://www.ti.com/lit/ug/spruhv6b/spruhv6b.pdf>`_
+ * `PRU Assembly Instruction User Guide <http://www.ti.com/lit/ug/spruij2/spruij2.pdf>`_
Calling Assembly from C
************************
diff --git a/books/pru-cookbook/08ai/ai.rst b/books/pru-cookbook/08ai/ai.rst
index ca507562..d2e055c0 100644
--- a/books/pru-cookbook/08ai/ai.rst
+++ b/books/pru-cookbook/08ai/ai.rst
@@ -11,11 +11,12 @@ four PRUs.
The following are resources used in this chapter.
-Resources
-~~~~~~~~~~~
+.. note::
-* `AM572x Technical Reference Manual <http://www.ti.com/lit/pdf/spruhz6l>`_ (AI)
-* `BeagleBone AI PRU pins <https://docs.google.com/spreadsheets/d/1dFSBVem86vAUD7MLXvqdS-N0Efi8_g_O1iTqzql8DAo/edit#gid=0>`_
+ *Resources*
+
+ * `AM572x Technical Reference Manual <http://www.ti.com/lit/pdf/spruhz6l>`_ (AI)
+ * `BeagleBone AI PRU pins <https://docs.google.com/spreadsheets/d/1dFSBVem86vAUD7MLXvqdS-N0Efi8_g_O1iTqzql8DAo/edit#gid=0>`_
Moving from two to four PRUs
*****************************
diff --git a/books/pru-cookbook/projects.rst b/books/pru-cookbook/projects.rst
index 808d06b1..60a2482b 100644
--- a/books/pru-cookbook/projects.rst
+++ b/books/pru-cookbook/projects.rst
@@ -155,7 +155,7 @@ documentation visit the PRU-ICSS wiki.
**Type:** Code Library Reference
**References:**
- * http://processors.wiki.ti.com/index.php/Soft-UART_Implementation_on_AM335X_PRU_-_Software_Users_Guide
+ * https://software-dl.ti.com/processor-sdk-linux/esd/docs/latest/linux/Foundational_Components/PRU-ICSS/Linux_Drivers/pru-sw-uart.html
.. dropdown:: **Deviant LCD**
:open:
--
GitLab