From 37b0f74d22830b3231f7e2bf2c5fe0b4af9a24da Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Sun, 15 Oct 2023 02:10:36 +0530
Subject: [PATCH] Add BVF ROBOTICS gateware pin usage

---
 boards/beaglev/fire/04-expansion.rst | 129 +++++++++++++++++++++++----
 1 file changed, 113 insertions(+), 16 deletions(-)

diff --git a/boards/beaglev/fire/04-expansion.rst b/boards/beaglev/fire/04-expansion.rst
index ebc1abc3..c6a63001 100644
--- a/boards/beaglev/fire/04-expansion.rst
+++ b/boards/beaglev/fire/04-expansion.rst
@@ -73,6 +73,10 @@ P8.03-P8.05
 +            +--------------------------+------------------------------+--------------------------+
 |            | User LED 0               | User LED 1                   | User LED 2               |
 +------------+--------------------------+------------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[0]            | MSS GPIO_2[1]                | MSS GPIO_2[2]            |
++            +--------------------------+------------------------------+--------------------------+
+|            | User LED 0               | User LED 1                   | User LED 2               |
++------------+--------------------------+------------------------------+--------------------------+
 
 P8.06-P8.09
 -------------
@@ -92,6 +96,10 @@ P8.06-P8.09
 +            +----------------------------------------+--------------------------+---------------------------------------+--------------------------+
 |            | User LED 3                             | User LED 4               | User LED 5                            | User LED 6               |
 +------------+----------------------------------------+--------------------------+---------------------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[3]                          | MSS GPIO_2[4]            | MSS GPIO_2[5]                         | MSS GPIO_2[6]            |
++            +----------------------------------------+--------------------------+---------------------------------------+--------------------------+
+|            | User LED 3                             | User LED 4               | User LED 5                            | User LED 6               |
++------------+----------------------------------------+--------------------------+---------------------------------------+--------------------------+
 
 P8.10-P8.13
 ------------
@@ -111,6 +119,10 @@ P8.10-P8.13
 +            +-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
 |            | User LED 7                                      | User LED 8               | User LED 9                  | User LED 10              |
 +------------+-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[7]                                   | MSS GPIO_2[8]            | MSS GPIO_2[9]               | core_pwm[1] @ 0x41500000 |
++            +-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
+|            | User LED 7                                      | User LED 8               | User LED 9                  | PWM_2:1                  |
++------------+-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
 
 P8.14-P8.16
 ------------
@@ -130,6 +142,10 @@ P8.14-P8.16
 +            +--------------------------+--------------------------+-------------------------------+
 |            | User LED 11              | GPIO                     | GPIO                          |
 +------------+--------------------------+--------------------------+-------------------------------+
+| ROBOTICS   | MSS GPIO_2[11]           | MSS GPIO_2[12]           | MSS GPIO_2[13]                |
++            +--------------------------+--------------------------+-------------------------------+
+|            | User LED 11              | GPIO                     | GPIO                          |
++------------+--------------------------+--------------------------+-------------------------------+
 
 P8.17-P8.19
 -------------
@@ -149,6 +165,10 @@ P8.17-P8.19
 +            +--------------------------+---------------------------------+--------------------------+
 |            | GPIO                     | GPIO                            | GPIO                     |
 +------------+--------------------------+---------------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[14]           | MSS GPIO_2[15]                  | core_pwm[0] @ 0x41500000 |
++            +--------------------------+---------------------------------+--------------------------+
+|            | GPIO                     | GPIO                            | PWM_2:0                  |
++------------+--------------------------+---------------------------------+--------------------------+
 
 
 P8.20-P8.22
@@ -169,6 +189,11 @@ P8.20-P8.22
 +            +--------------------------+--------------------------------+--------------------------+
 |            | GPIO                     | GPIO                           | GPIO                     |
 +------------+--------------------------+--------------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[17]           | MSS GPIO_2[18]                 | MSS GPIO_2[19]           |
++            +--------------------------+--------------------------------+--------------------------+
+|            | GPIO                     | GPIO                           | GPIO                     |
++------------+--------------------------+--------------------------------+--------------------------+
+
 
 P8.23-P8.26
 -------------
@@ -188,6 +213,11 @@ P8.23-P8.26
 +            +--------------------------+--------------------------+--------------------------+--------------------------+
 |            | GPIO                     | GPIO                     | GPIO                     | GPIO                     |
 +------------+--------------------------+--------------------------+--------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[20]           | MSS GPIO_2[21]           | MSS GPIO_2[22]           | MSS GPIO_2[23]           |
++            +--------------------------+--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+--------------------------+
+
 
 P8.27-P8.29
 -------------
@@ -207,6 +237,11 @@ P8.27-P8.29
 +            +--------------------------+--------------------------+--------------------------+
 |            | GPIO                     | GPIO                     | GPIO                     |
 +------------+--------------------------+--------------------------+--------------------------+
+| ROBOTICS   | MSS GPIO_2[24]           | MSS GPIO_2[25]           | MSS GPIO_2[26]           |
++            +--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+
+
 
 P8.30-P8.32
 -------------
@@ -226,25 +261,34 @@ P8.30-P8.32
 +            +--------------------------+------------------------------+------------------------------+
 |            | GPIO                     | GPIO                         | GPIO                         |
 +------------+--------------------------+------------------------------+------------------------------+
+| ROBOTICS   | MSS GPIO_2[27]           | core_gpio[0] @ 0x41100000    | core_gpio[1] @ 0x41100000    |
++            +--------------------------+------------------------------+------------------------------+
+|            | GPIO                     | GPIO                         | GPIO                         |
++------------+--------------------------+------------------------------+------------------------------+
+
 
 P8.33-P8.35
 -------------
 
-+------------+--------------------------+--------------------------+--------------------------+
-| Pin        | P8.33                    | P8.34                    | P8.35                    |
-+============+==========================+==========================+==========================+
-| Name       | GPIO53PB1/CLKIN_S_7      | GPIO52NB1/LPRB_B         | GPIO52PB1/LPRB_A         |
-+------------+--------------------------+--------------------------+--------------------------+
-| BALL       | A15                      | C15                      | C14                      |
-+------------+--------------------------+--------------------------+--------------------------+
-| DEFAULT    | core_gpio[2] @ 0x41100000| core_gpio[3] @ 0x41100000| core_gpio[4] @ 0x41100000|
-+            +--------------------------+--------------------------+--------------------------+
-|            | GPIO                     | GPIO                     | GPIO                     |
-+------------+--------------------------+--------------------------+--------------------------+
-| GPIOS      | core_gpio[2] @ 0x41100000| core_gpio[3] @ 0x41100000| core_gpio[4] @ 0x41100000|
-+            +--------------------------+--------------------------+--------------------------+
-|            | GPIO                     | GPIO                     | GPIO                     |
-+------------+--------------------------+--------------------------+--------------------------+
++------------+------------------------------+------------------------------+------------------------------+
+| Pin        | P8.33                        | P8.34                        | P8.35                        |
++============+==============================+==============================+==============================+
+| Name       | GPIO53PB1/CLKIN_S_7          | GPIO52NB1/LPRB_B             | GPIO52PB1/LPRB_A             |
++------------+------------------------------+------------------------------+------------------------------+
+| BALL       | A15                          | C15                          | C14                          |
++------------+------------------------------+------------------------------+------------------------------+
+| DEFAULT    | core_gpio[2] @ 0x41100000    | core_gpio[3] @ 0x41100000    | core_gpio[4] @ 0x41100000    |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
+| GPIOS      | core_gpio[2] @ 0x41100000    | core_gpio[3] @ 0x41100000    | core_gpio[4] @ 0x41100000    |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
+| ROBOTICS   | core_gpio[2] @ 0x41100000    | core_gpio[3] @ 0x41100000    | core_gpio[4] @ 0x41100000    |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
 
 P8.36-P8.38
 -------------
@@ -264,7 +308,10 @@ P8.36-P8.38
 +            +--------------------------+------------------------------+------------------------------+
 |            | GPIO                     | GPIO                         | GPIO                         |
 +------------+--------------------------+------------------------------+------------------------------+
-
+| ROBOTICS   | core_gpio[5] @ 0x41100000| core_gpio[6] @ 0x41100000    | core_gpio[7] @ 0x41100000    |
++            +--------------------------+------------------------------+------------------------------+
+|            | GPIO                     | GPIO                         | GPIO                         |
++------------+--------------------------+------------------------------+------------------------------+
 
 P8.39-P8.41
 ------------
@@ -284,6 +331,11 @@ P8.39-P8.41
 +            +-----------------------------------------------+--------------------------+------------------------------+
 |            | GPIO                                          | GPIO                     | GPIO                         |
 +------------+-----------------------------------------------+--------------------------+------------------------------+
+| ROBOTICS   | core_gpio[8] @ 0x41100000                     | core_gpio[9] @ 0x41100000| core_gpio[10] @ 0x41100000   |
++            +-----------------------------------------------+--------------------------+------------------------------+
+|            | GPIO                                          | GPIO                     | GPIO                         |
++------------+-----------------------------------------------+--------------------------+------------------------------+
+
 
 P8.42-P8.44
 ------------
@@ -303,6 +355,11 @@ P8.42-P8.44
 +            +------------------------------+------------------------------+------------------------------+
 |            | GPIO                         | GPIO                         | GPIO                         |
 +------------+------------------------------+------------------------------+------------------------------+
+| ROBOTICS   | core_gpio[11] @ 0x41100000   | core_gpio[12] @ 0x41100000   | core_gpio[13] @ 0x41100000   |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
+
 
 P8.45-P8.46
 ------------
@@ -322,6 +379,10 @@ P8.45-P8.46
 +            +-------------------------------+-------------------------------+
 |            | GPIO                          | GPIO                          |
 +------------+-------------------------------+-------------------------------+
+| ROBOTICS   | core_gpio[14] @ 0x41100000    | core_gpio[15] @ 0x41100000    |
++            +-------------------------------+-------------------------------+
+|            | GPIO                          | GPIO                          |
++------------+-------------------------------+-------------------------------+
 
 Connector P9
 ==============
@@ -393,6 +454,10 @@ P9.11-P9.13
 +            +------------------------------+---------------------------------+------------------------------+
 |            | GPIO                         | GPIO                            | GPIO                         |
 +------------+------------------------------+---------------------------------+------------------------------+
+| ROBOTICS   | ~                            | core_gpio[0] @ 0x41200000       | core_gpio[7] @ 0x41200000    |
++            +------------------------------+---------------------------------+------------------------------+
+|            | ~                            | GPIO                            | GPIO                         |
++------------+------------------------------+---------------------------------+------------------------------+
 
 P9.14-P9.16
 -------------
@@ -412,6 +477,11 @@ P9.14-P9.16
 +            +---------------------------------------------------------+------------------------------+------------------------------+
 |            | GPIO                                                    | GPIO                         | GPIO                         |
 +------------+---------------------------------------------------------+------------------------------+------------------------------+
+| ROBOTICS   | core_pwm[0] @ 0x41400000                                | core_gpio[1] @ 0x41200000    | core_pwm[1] @ 0x41400000     |
++            +---------------------------------------------------------+------------------------------+------------------------------+
+|            | PWM_1:0                                                 | GPIO                         | PWM_1:1                      |
++------------+---------------------------------------------------------+------------------------------+------------------------------+
+
 
 P9.17-P9.19
 -------------
@@ -431,6 +501,11 @@ P9.17-P9.19
 +            +------------------------------+----------------------------------+----------------------------------+
 |            | GPIO                         | GPIO                             | I2C0 SCL                         |
 +------------+------------------------------+----------------------------------+----------------------------------+
+| ROBOTICS   | ~                            | ~                                | MSS I2C0                         |
++            +------------------------------+----------------------------------+----------------------------------+
+|            | ~                            | ~                                | I2C0 SCL                         |
++------------+------------------------------+----------------------------------+----------------------------------+
+
 
 P9.20-P9.22
 ------------
@@ -450,6 +525,10 @@ P9.20-P9.22
 +            +------------------------------+------------------------------+------------------------------+
 |            | I2C0 SDA                     | GPIO                         | GPIO                         |
 +------------+------------------------------+------------------------------+------------------------------+
+| ROBOTICS   | MSS I2C0                     | ~                            | ~                            |
++            +------------------------------+------------------------------+------------------------------+
+|            | I2C0 SDA                     | ~                            | ~                            |
++------------+------------------------------+------------------------------+------------------------------+
 
 
 P9.23-P9.25
@@ -470,6 +549,11 @@ P9.23-P9.25
 +            +------------------------------+------------------------------+------------------------------+
 |            | GPIO                         | GPIO                         | GPIO                         |
 +------------+------------------------------+------------------------------+------------------------------+
+| ROBOTICS   | core_gpio[2] @ 0x41200000    | ~                            | core_gpio[3] @ 0x41200000    |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | ~                            | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
+
 
 P9.26-P9.28
 ------------
@@ -489,6 +573,10 @@ P9.26-P9.28
 +            +----------------------------------------+------------------------------+-------------------------------+
 |            | GPIO                                   | GPIO                         | GPIO                          |
 +------------+----------------------------------------+------------------------------+-------------------------------+
+| GPIOS      | ~                                      | ~                            | ~                             |
++            +----------------------------------------+------------------------------+-------------------------------+
+|            | ~                                      | ~                            | ~                             |
++------------+----------------------------------------+------------------------------+-------------------------------+
 
 
 P9.29-P9.31
@@ -509,6 +597,11 @@ P9.29-P9.31
 +            +--------------------------------------+------------------------------+------------------------------+
 |            | GPIO                                 | GPIO                         | GPIO                         |                              
 +------------+--------------------------------------+------------------------------+------------------------------+
+| ROBOTICS   | ~                                    | core_gpio[5] @ 0x41200000    | ~                            |
++            +--------------------------------------+------------------------------+------------------------------+
+|            | ~                                    | GPIO                         | ~                            |                              
++------------+--------------------------------------+------------------------------+------------------------------+
+
 
 P9.32-P9.40
 -------------
@@ -543,6 +636,10 @@ P9.41-P9.42
 +            +---------------------------------------------------------+------------------------------+
 |            | GPIO                                                    | GPIO                         |
 +------------+---------------------------------------------------------+------------------------------+
+| ROBOTICS   | core_gpio[19] @ 0x41200000                              | ~                            |
++            +---------------------------------------------------------+------------------------------+
+|            | GPIO                                                    | ~                            |
++------------+---------------------------------------------------------+------------------------------+
 
 P9.43-P9.46
 -------------
-- 
GitLab