From 2b59c4752079bd9a8e3d983cdd49b7e63094c571 Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Sun, 15 Oct 2023 01:48:40 +0530
Subject: [PATCH] Add BVF GPIOS gateware pin usage

---
 boards/beaglev/fire/04-expansion.rst | 215 +++++++++++++++++++--------
 1 file changed, 151 insertions(+), 64 deletions(-)

diff --git a/boards/beaglev/fire/04-expansion.rst b/boards/beaglev/fire/04-expansion.rst
index 4439bcc7..ebc1abc3 100644
--- a/boards/beaglev/fire/04-expansion.rst
+++ b/boards/beaglev/fire/04-expansion.rst
@@ -8,8 +8,6 @@ Cape Headers
 
 .. important:: This page is a work in progress, don't use if for debugging.
 
-.. todo:: update the tables with BeagleV-Fire pinout.
-
 The expansion interface on the board is comprised of two headers P8 (46 pin) & P9 (46 pin).
 All signals on the expansion headers are **3.3V** unless otherwise indicated.
 
@@ -71,7 +69,10 @@ P8.03-P8.05
 +            +--------------------------+------------------------------+--------------------------+
 |            | User LED 0               | User LED 1                   | User LED 2               |
 +------------+--------------------------+------------------------------+--------------------------+
-
+| GPIOS      | 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
 -------------
@@ -87,6 +88,10 @@ P8.06-P8.09
 +            +----------------------------------------+--------------------------+---------------------------------------+--------------------------+
 |            | User LED 3                             | User LED 4               | User LED 5                            | User LED 6               |
 +------------+----------------------------------------+--------------------------+---------------------------------------+--------------------------+
+| GPIOS      | 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
 ------------
@@ -102,6 +107,10 @@ P8.10-P8.13
 +            +-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
 |            | User LED 7                                      | User LED 8               | User LED 9                  | PWM_2:1                  |
 +------------+-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
+| GPIOS      | MSS GPIO_2[7]                                   | MSS GPIO_2[8]            | MSS GPIO_2[9]               | MSS GPIO_2[10]           |
++            +-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
+|            | User LED 7                                      | User LED 8               | User LED 9                  | User LED 10              |
++------------+-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
 
 P8.14-P8.16
 ------------
@@ -117,6 +126,10 @@ P8.14-P8.16
 +            +--------------------------+--------------------------+-------------------------------+
 |            | User LED 11              | GPIO                     | GPIO                          |
 +------------+--------------------------+--------------------------+-------------------------------+
+| GPIOS      | MSS GPIO_2[11]           | MSS GPIO_2[12]           | MSS GPIO_2[13]                |
++            +--------------------------+--------------------------+-------------------------------+
+|            | User LED 11              | GPIO                     | GPIO                          |
++------------+--------------------------+--------------------------+-------------------------------+
 
 P8.17-P8.19
 -------------
@@ -132,6 +145,11 @@ P8.17-P8.19
 +            +--------------------------+---------------------------------+--------------------------+
 |            | GPIO                     | GPIO                            | PWM_2:0                  |
 +------------+--------------------------+---------------------------------+--------------------------+
+| GPIOS      | MSS GPIO_2[14]           | MSS GPIO_2[15]                  |  MSS GPIO_2[16]          |
++            +--------------------------+---------------------------------+--------------------------+
+|            | GPIO                     | GPIO                            | GPIO                     |
++------------+--------------------------+---------------------------------+--------------------------+
+
 
 P8.20-P8.22
 ------------
@@ -147,6 +165,10 @@ P8.20-P8.22
 +            +--------------------------+--------------------------------+--------------------------+
 |            | GPIO                     | GPIO                           | GPIO                     |
 +------------+--------------------------+--------------------------------+--------------------------+
+| GPIOS      | MSS GPIO_2[17]           | MSS GPIO_2[18]                 | MSS GPIO_2[19]           |
++            +--------------------------+--------------------------------+--------------------------+
+|            | GPIO                     | GPIO                           | GPIO                     |
++------------+--------------------------+--------------------------------+--------------------------+
 
 P8.23-P8.26
 -------------
@@ -162,6 +184,10 @@ P8.23-P8.26
 +            +--------------------------+--------------------------+--------------------------+--------------------------+
 |            | GPIO                     | GPIO                     | GPIO                     | GPIO                     |
 +------------+--------------------------+--------------------------+--------------------------+--------------------------+
+| GOIOS      | MSS GPIO_2[20]           | MSS GPIO_2[21]           | MSS GPIO_2[22]           | MSS GPIO_2[23]           |
++            +--------------------------+--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+--------------------------+
 
 P8.27-P8.29
 -------------
@@ -177,6 +203,10 @@ P8.27-P8.29
 +            +--------------------------+--------------------------+--------------------------+
 |            | GPIO                     | GPIO                     | GPIO                     |
 +------------+--------------------------+--------------------------+--------------------------+
+| GPIOS      | MSS GPIO_2[24]           | MSS GPIO_2[25]           | MSS GPIO_2[26]           |
++            +--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+
 
 P8.30-P8.32
 -------------
@@ -192,6 +222,10 @@ P8.30-P8.32
 +            +--------------------------+------------------------------+------------------------------+
 |            | GPIO                     | GPIO                         | GPIO                         |
 +------------+--------------------------+------------------------------+------------------------------+
+| GPIOS      | MSS GPIO_2[27]           | core_gpio[0] @ 0x41100000    | core_gpio[1] @ 0x41100000    |
++            +--------------------------+------------------------------+------------------------------+
+|            | GPIO                     | GPIO                         | GPIO                         |
++------------+--------------------------+------------------------------+------------------------------+
 
 P8.33-P8.35
 -------------
@@ -207,6 +241,10 @@ P8.33-P8.35
 +            +--------------------------+--------------------------+--------------------------+
 |            | GPIO                     | GPIO                     | GPIO                     |
 +------------+--------------------------+--------------------------+--------------------------+
+| GPIOS      | core_gpio[2] @ 0x41100000| core_gpio[3] @ 0x41100000| core_gpio[4] @ 0x41100000|
++            +--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+
 
 P8.36-P8.38
 -------------
@@ -222,6 +260,11 @@ P8.36-P8.38
 +            +--------------------------+------------------------------+------------------------------+
 |            | GPIO                     | GPIO                         | GPIO                         |
 +------------+--------------------------+------------------------------+------------------------------+
+| GPIOS      | core_gpio[5] @ 0x41100000| core_gpio[6] @ 0x41100000    | core_gpio[7] @ 0x41100000    |
++            +--------------------------+------------------------------+------------------------------+
+|            | GPIO                     | GPIO                         | GPIO                         |
++------------+--------------------------+------------------------------+------------------------------+
+
 
 P8.39-P8.41
 ------------
@@ -237,6 +280,10 @@ P8.39-P8.41
 +            +-----------------------------------------------+--------------------------+------------------------------+
 |            | GPIO                                          | GPIO                     | GPIO                         |
 +------------+-----------------------------------------------+--------------------------+------------------------------+
+| GPIOS      | core_gpio[8] @ 0x41100000                     | core_gpio[9] @ 0x41100000| core_gpio[10] @ 0x41100000   |
++            +-----------------------------------------------+--------------------------+------------------------------+
+|            | GPIO                                          | GPIO                     | GPIO                         |
++------------+-----------------------------------------------+--------------------------+------------------------------+
 
 P8.42-P8.44
 ------------
@@ -252,6 +299,10 @@ P8.42-P8.44
 +            +------------------------------+------------------------------+------------------------------+
 |            | GPIO                         | GPIO                         | GPIO                         |
 +------------+------------------------------+------------------------------+------------------------------+
+| GPIOS      | core_gpio[11] @ 0x41100000   | core_gpio[12] @ 0x41100000   | core_gpio[13] @ 0x41100000   |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
 
 P8.45-P8.46
 ------------
@@ -267,6 +318,10 @@ P8.45-P8.46
 +            +-------------------------------+-------------------------------+
 |            | GPIO                          | GPIO                          |
 +------------+-------------------------------+-------------------------------+
+| GPIOS      | core_gpio[14] @ 0x41100000    | core_gpio[15] @ 0x41100000    |
++            +-------------------------------+-------------------------------+
+|            | GPIO                          | GPIO                          |
++------------+-------------------------------+-------------------------------+
 
 Connector P9
 ==============
@@ -323,62 +378,78 @@ P9.06-P9.10
 P9.11-P9.13
 -------------
 
-+------------+--------------------------+---------------------------------+--------------------------+
-| Pin        | P9.11                    | P9.12                           | P9.13                    |
-+============+==========================+=================================+==========================+
-| Name       | GPIO38NB1/DQS            | GPIO38PB1/DQS/CCC_SW_PLL1_OUT0  | GPIO2NB1/DQS             |
-+------------+--------------------------+---------------------------------+--------------------------+
-| BALL       | B5                       | C5                              | D19                      |
-+------------+--------------------------+---------------------------------+--------------------------+
-| DEFAULT    | MMUART4                  | core_gpio[1] @ 0x41200000       | MMUART4                  |
-+            +--------------------------+---------------------------------+--------------------------+
-|            | UART4 RX                 | GPIO                            | UART4 TX                 |
-+------------+--------------------------+---------------------------------+--------------------------+
++------------+------------------------------+---------------------------------+------------------------------+
+| Pin        | P9.11                        | P9.12                           | P9.13                        |
++============+==============================+=================================+==============================+
+| Name       | GPIO38NB1/DQS                | GPIO38PB1/DQS/CCC_SW_PLL1_OUT0  | GPIO2NB1/DQS                 |
++------------+------------------------------+---------------------------------+------------------------------+
+| BALL       | B5                           | C5                              | D19                          |
++------------+------------------------------+---------------------------------+------------------------------+
+| DEFAULT    | MMUART4                      | core_gpio[1] @ 0x41200000       | MMUART4                      |
++            +------------------------------+---------------------------------+------------------------------+
+|            | UART4 RX                     | GPIO                            | UART4 TX                     |
++------------+------------------------------+---------------------------------+------------------------------+
+| GPIOS      | core_gpio[0] @ 0x41200000    | core_gpio[1] @ 0x41200000       | core_gpio[2] @ 0x41200000    |
++            +------------------------------+---------------------------------+------------------------------+
+|            | GPIO                         | GPIO                            | GPIO                         |
++------------+------------------------------+---------------------------------+------------------------------+
 
 P9.14-P9.16
 -------------
 
-+------------+---------------------------------------------------------+--------------------------+------------------------------+
-| Pin        | P9.14                                                   | P9.15                    | P9.16                        |
-+============+=========================================================+==========================+==============================+
-| Name       | GPIO39PB1/CLKIN_S_2/CCC_SW_CLKIN_S_2/CCC_SW_PLL1_OUT0   | GPIO40NB1                | GPIO40PB1/CCC_SW_PLL1_OUT1   |
-+------------+---------------------------------------------------------+--------------------------+------------------------------+
-| BALL       | C6                                                      | A5                       | A6                           |
-+------------+---------------------------------------------------------+--------------------------+------------------------------+
-| DEFAULT    | core_pwm[0] @ 0x41400000                                | core_gpio[4] @ 0x41200000| core_pwm[1] @ 0x41400000     |
-+            +---------------------------------------------------------+--------------------------+------------------------------+
-|            | PWM_1:0                                                 | GPIO                     | PWM_1:1                      |
-+------------+---------------------------------------------------------+--------------------------+------------------------------+
++------------+---------------------------------------------------------+------------------------------+------------------------------+
+| Pin        | P9.14                                                   | P9.15                        | P9.16                        |
++============+=========================================================+==============================+==============================+
+| Name       | GPIO39PB1/CLKIN_S_2/CCC_SW_CLKIN_S_2/CCC_SW_PLL1_OUT0   | GPIO40NB1                    | GPIO40PB1/CCC_SW_PLL1_OUT1   |
++------------+---------------------------------------------------------+------------------------------+------------------------------+
+| BALL       | C6                                                      | A5                           | A6                           |
++------------+---------------------------------------------------------+------------------------------+------------------------------+
+| DEFAULT    | core_pwm[0] @ 0x41400000                                | core_gpio[4] @ 0x41200000    | core_pwm[1] @ 0x41400000     |
++            +---------------------------------------------------------+------------------------------+------------------------------+
+|            | PWM_1:0                                                 | GPIO                         | PWM_1:1                      |
++------------+---------------------------------------------------------+------------------------------+------------------------------+
+| GOIOS      | core_gpio[3] @ 0x41200000                               | core_gpio[4] @ 0x41200000    | core_gpio[5] @ 0x41200000    |
++            +---------------------------------------------------------+------------------------------+------------------------------+
+|            | GPIO                                                    | GPIO                         | GPIO                         |
++------------+---------------------------------------------------------+------------------------------+------------------------------+
 
 P9.17-P9.19
 -------------
 
-+------------+--------------------------+----------------------------------+------------------------------+
-| Pin        | P9.17                    | P9.18                            | P9.19                        |
-+============+==========================+==================================+==============================+
-| Name       | GPIO44NB1/DQS            | GPIO44PB1/DQS/CCC_SW_PLL0_OUT0   | GPIO45PB1/CCC_SW_PLL0_OUT0   |
-+------------+--------------------------+----------------------------------+------------------------------+
-| BALL       | C9                       | C10                              | A10                          |
-+------------+--------------------------+----------------------------------+------------------------------+
-| DEFAULT    | -                        | -                                | MSS I2C0                     |
-+            +--------------------------+----------------------------------+------------------------------+
-|            | -                        | -                                | I2C0 SCL                     |
-+------------+--------------------------+----------------------------------+------------------------------+
++------------+------------------------------+----------------------------------+----------------------------------+
+| Pin        | P9.17                        | P9.18                            | P9.19                            |
++============+==============================+==================================+==================================+
+| Name       | GPIO44NB1/DQS                | GPIO44PB1/DQS/CCC_SW_PLL0_OUT0   | GPIO45PB1/CCC_SW_PLL0_OUT0       |
++------------+------------------------------+----------------------------------+----------------------------------+
+| BALL       | C9                           | C10                              | A10                              |
++------------+------------------------------+----------------------------------+----------------------------------+
+| DEFAULT    | ~                            | ~                                | MSS I2C0                         |
++            +------------------------------+----------------------------------+----------------------------------+
+|            | ~                            | ~                                | I2C0 SCL                         |
++------------+------------------------------+----------------------------------+----------------------------------+
+| GPIOS      | core_gpio[6] @ 0x41200000    | core_gpio[7] @ 0x41200000        | MSS I2C0                         |
++            +------------------------------+----------------------------------+----------------------------------+
+|            | GPIO                         | GPIO                             | I2C0 SCL                         |
++------------+------------------------------+----------------------------------+----------------------------------+
 
 P9.20-P9.22
 ------------
 
-+------------+--------------------------+--------------------------+--------------------------+
-| Pin        | P9.20                    | P9.21                    | P9.22                    |
-+============+==========================+==========================+==========================+
-| Name       | GPIO45NB1                | GPIO43NB1                | GPIO43PB1                |
-+------------+--------------------------+--------------------------+--------------------------+
-| BALL       | A11                      | B8                       | A8                       |
-+------------+--------------------------+--------------------------+--------------------------+
-| DEFAULT    | MSS I2C0                 | -                        | -                        |
-+            +--------------------------+--------------------------+--------------------------+
-|            | I2C0 SDA                 | -                        | -                        |
-+------------+--------------------------+--------------------------+--------------------------+
++------------+------------------------------+------------------------------+------------------------------+
+| Pin        | P9.20                        | P9.21                        | P9.22                        |
++============+==============================+==============================+==============================+
+| Name       | GPIO45NB1                    | GPIO43NB1                    | GPIO43PB1                    |
++------------+------------------------------+------------------------------+------------------------------+
+| BALL       | A11                          | B8                           | A8                           |
++------------+------------------------------+------------------------------+------------------------------+
+| DEFAULT    | MSS I2C0                     | ~                            | ~                            |
++            +------------------------------+------------------------------+------------------------------+
+|            | I2C0 SDA                     | ~                            | ~                            |
++------------+------------------------------+------------------------------+------------------------------+
+| GPIOS      | MSS I2C0                     | core_gpio[8] @ 0x41200000    | core_gpio[8] @ 0x41200000    |
++            +------------------------------+------------------------------+------------------------------+
+|            | I2C0 SDA                     | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
 
 
 P9.23-P9.25
@@ -391,9 +462,13 @@ P9.23-P9.25
 +------------+------------------------------+------------------------------+------------------------------+
 | BALL       | C1                           | B12                          | B7                           |
 +------------+------------------------------+------------------------------+------------------------------+
-| DEFAULT    | core_gpio[10] @ 0x41200000   | -                            | core_gpio[12] @ 0x41200000   |
+| DEFAULT    | core_gpio[10] @ 0x41200000   | ~                            | core_gpio[12] @ 0x41200000   |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | ~                            | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
+| GPIOS      | core_gpio[10] @ 0x41200000   | core_gpio[11] @ 0x41200000   | core_gpio[12] @ 0x41200000   |
 +            +------------------------------+------------------------------+------------------------------+
-|            | GPIO                         | -                            | GPIO                         |
+|            | GPIO                         | GPIO                         | GPIO                         |
 +------------+------------------------------+------------------------------+------------------------------+
 
 P9.26-P9.28
@@ -406,9 +481,13 @@ P9.26-P9.28
 +------------+----------------------------------------+------------------------------+-------------------------------+
 | BALL       | A7                                     | D11                          | C11                           |
 +------------+----------------------------------------+------------------------------+-------------------------------+
-| DEFAULT    | -                                      | core_gpio[14] @ 0x41200000   | -                             |
+| DEFAULT    | ~                                      | core_gpio[14] @ 0x41200000   | ~                             |
 +            +----------------------------------------+------------------------------+-------------------------------+
-|            | -                                      | GPIO                         | -                             |
+|            | ~                                      | GPIO                         | ~                             |
++------------+----------------------------------------+------------------------------+-------------------------------+
+| GPIOS      | core_gpio[13] @ 0x41200000             | core_gpio[14] @ 0x41200000   | core_gpio[15] @ 0x41200000    |
++            +----------------------------------------+------------------------------+-------------------------------+
+|            | GPIO                                   | GPIO                         | GPIO                          |
 +------------+----------------------------------------+------------------------------+-------------------------------+
 
 
@@ -422,9 +501,13 @@ P9.29-P9.31
 +------------+--------------------------------------+------------------------------+------------------------------+
 | BALL       | F17                                  | F16                          | E18                          |
 +------------+--------------------------------------+------------------------------+------------------------------+
-| DEFAULT    | -                                    | core_gpio[17] @ 0x41200000   | -                            |
+| DEFAULT    | ~                                    | core_gpio[17] @ 0x41200000   | ~                            |
++            +--------------------------------------+------------------------------+------------------------------+
+|            | ~                                    | GPIO                         | ~                            |                              
++------------+--------------------------------------+------------------------------+------------------------------+
+| GPIOS      | core_gpio[16] @ 0x41200000           | core_gpio[17] @ 0x41200000   | core_gpio[18] @ 0x41200000   |
 +            +--------------------------------------+------------------------------+------------------------------+
-|            | -                                    | GPIO                         | -                            |                              
+|            | GPIO                                 | GPIO                         | GPIO                         |                              
 +------------+--------------------------------------+------------------------------+------------------------------+
 
 P9.32-P9.40
@@ -445,17 +528,21 @@ P9.32-P9.40
 P9.41-P9.42
 ------------
 
-+------------+---------------------------------------------------------+--------------------------+
-| Pin        | P9.41                                                   | P9.42                    |
-+============+=========================================================+==========================+
-| Name       | GPIO0PB1/CLKIN_S_8/CCC_SE_CLKIN_S_8/CCC_SE_PLL0_OUT0    | GPIO0NB1                 |
-+------------+---------------------------------------------------------+--------------------------+
-| BALL       | E15                                                     | E14                      |
-+------------+---------------------------------------------------------+--------------------------+
-| DEFAULT    | core_gpio[19] @ 0x41200000                              | core_pwm[0] @ 0x41000000 |
-+            +---------------------------------------------------------+--------------------------+
-|            | GPIO                                                    | PWM_0:0                  |
-+------------+---------------------------------------------------------+--------------------------+
++------------+---------------------------------------------------------+------------------------------+
+| Pin        | P9.41                                                   | P9.42                        |
++============+=========================================================+==============================+
+| Name       | GPIO0PB1/CLKIN_S_8/CCC_SE_CLKIN_S_8/CCC_SE_PLL0_OUT0    | GPIO0NB1                     |
++------------+---------------------------------------------------------+------------------------------+
+| BALL       | E15                                                     | E14                          |
++------------+---------------------------------------------------------+------------------------------+
+| DEFAULT    | core_gpio[19] @ 0x41200000                              | core_pwm[0] @ 0x41000000     |
++            +---------------------------------------------------------+------------------------------+
+|            | GPIO                                                    | PWM_0:0                      |
++------------+---------------------------------------------------------+------------------------------+
+| GPIOS      | core_gpio[19] @ 0x41200000                              | core_gpio[20] @ 0x41200000   |
++            +---------------------------------------------------------+------------------------------+
+|            | GPIO                                                    | GPIO                         |
++------------+---------------------------------------------------------+------------------------------+
 
 P9.43-P9.46
 -------------
-- 
GitLab