From f0a8b30a17de78866fe6500b7850a22157705698 Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Thu, 12 Oct 2023 12:32:57 +0530
Subject: [PATCH] Add DEFAULT gateware pin usage

---
 boards/beaglev/fire/04-expansion.rst | 195 ++++++++++++++++++---------
 1 file changed, 132 insertions(+), 63 deletions(-)

diff --git a/boards/beaglev/fire/04-expansion.rst b/boards/beaglev/fire/04-expansion.rst
index 02644e75..4439bcc7 100644
--- a/boards/beaglev/fire/04-expansion.rst
+++ b/boards/beaglev/fire/04-expansion.rst
@@ -67,6 +67,11 @@ P8.03-P8.05
 +------------+--------------------------+------------------------------+--------------------------+
 | BALL       | V22                      | W22                          | V19                      |
 +------------+--------------------------+------------------------------+--------------------------+
+| DEFAULT    | 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
 -------------
@@ -78,7 +83,10 @@ P8.06-P8.09
 +------------+----------------------------------------+--------------------------+---------------------------------------+--------------------------+
 | BALL       | V20                                    | V15                      | V14                                   | V21                      |
 +------------+----------------------------------------+--------------------------+---------------------------------------+--------------------------+
-
+| DEFAULT    | 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
 ------------
@@ -90,7 +98,10 @@ P8.10-P8.13
 +------------+-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
 | BALL       | W21                                             | Y21                      | Y20                         | B10                      |
 +------------+-------------------------------------------------+--------------------------+-----------------------------+--------------------------+
-
+| DEFAULT    | 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
 ------------
@@ -102,7 +113,10 @@ P8.14-P8.16
 +------------+--------------------------+--------------------------+-------------------------------+
 | BALL       | B9                       | T12                      | U12                           |
 +------------+--------------------------+--------------------------+-------------------------------+
-
+| DEFAULT    | MSS GPIO_2[11]           | MSS GPIO_2[12]           | MSS GPIO_2[13]                |
++            +--------------------------+--------------------------+-------------------------------+
+|            | User LED 11              | GPIO                     | GPIO                          |
++------------+--------------------------+--------------------------+-------------------------------+
 
 P8.17-P8.19
 -------------
@@ -114,7 +128,10 @@ P8.17-P8.19
 +------------+--------------------------+---------------------------------+--------------------------+
 | BALL       | W13                      | T16                             | W18                      |
 +------------+--------------------------+---------------------------------+--------------------------+
-
+| DEFAULT    | MSS GPIO_2[14]           | MSS GPIO_2[15]                  | core_pwm[0] @ 0x41500000 |
++            +--------------------------+---------------------------------+--------------------------+
+|            | GPIO                     | GPIO                            | PWM_2:0                  |
++------------+--------------------------+---------------------------------+--------------------------+
 
 P8.20-P8.22
 ------------
@@ -126,7 +143,10 @@ P8.20-P8.22
 +------------+--------------------------+--------------------------------+--------------------------+
 | BALL       | R16                      | AA21                           | AA22                     |
 +------------+--------------------------+--------------------------------+--------------------------+
-
+| DEFAULT    | MSS GPIO_2[17]           | MSS GPIO_2[18]                 | MSS GPIO_2[19]           |
++            +--------------------------+--------------------------------+--------------------------+
+|            | GPIO                     | GPIO                           | GPIO                     |
++------------+--------------------------+--------------------------------+--------------------------+
 
 P8.23-P8.26
 -------------
@@ -138,7 +158,10 @@ P8.23-P8.26
 +------------+--------------------------+--------------------------+--------------------------+--------------------------+
 | BALL       | AB18                     | AA18                     | V17                      | A12                      |
 +------------+--------------------------+--------------------------+--------------------------+--------------------------+
-
+| DEFAULT    | MSS GPIO_2[20]           | MSS GPIO_2[21]           | MSS GPIO_2[22]           | MSS GPIO_2[23]           |
++            +--------------------------+--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+--------------------------+
 
 P8.27-P8.29
 -------------
@@ -150,19 +173,25 @@ P8.27-P8.29
 +------------+--------------------------+--------------------------+--------------------------+
 | BALL       | A13                      | B14                      | B13                      |
 +------------+--------------------------+--------------------------+--------------------------+
-
+| DEFAULT    | MSS GPIO_2[24]           | MSS GPIO_2[25]           | MSS GPIO_2[26]           |
++            +--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+
 
 P8.30-P8.32
 -------------
 
-+------------+--------------------------+--------------------------+--------------------------+
-| Pin        | P8.30                    | P8.31                    | P8.32                    |
-+============+==========================+==========================+==========================+
-| Name       | GPIO50NB1/DQS            | GPIO50PB1/DQS            | GPIO53NB1                |
-+------------+--------------------------+--------------------------+--------------------------+
-| BALL       | D14                      | D13                      | B15                      |
-+------------+--------------------------+--------------------------+--------------------------+
-
++------------+--------------------------+------------------------------+------------------------------+
+| Pin        | P8.30                    | P8.31                        | P8.32                        |
++============+==========================+==============================+==============================+
+| Name       | GPIO50NB1/DQS            | GPIO50PB1/DQS                | GPIO53NB1                    |
++------------+--------------------------+------------------------------+------------------------------+
+| BALL       | D14                      | D13                          | B15                          |
++------------+--------------------------+------------------------------+------------------------------+
+| DEFAULT    | MSS GPIO_2[27]           | core_gpio[0] @ 0x41100000    | core_gpio[1] @ 0x41100000    |
++            +--------------------------+------------------------------+------------------------------+
+|            | GPIO                     | GPIO                         | GPIO                         |
++------------+--------------------------+------------------------------+------------------------------+
 
 P8.33-P8.35
 -------------
@@ -174,7 +203,10 @@ P8.33-P8.35
 +------------+--------------------------+--------------------------+--------------------------+
 | BALL       | A15                      | C15                      | C14                      |
 +------------+--------------------------+--------------------------+--------------------------+
-
+| DEFAULT    | core_gpio[2] @ 0x41100000| core_gpio[3] @ 0x41100000| core_gpio[4] @ 0x41100000|
++            +--------------------------+--------------------------+--------------------------+
+|            | GPIO                     | GPIO                     | GPIO                     |
++------------+--------------------------+--------------------------+--------------------------+
 
 P8.36-P8.38
 -------------
@@ -186,7 +218,10 @@ P8.36-P8.38
 +------------+--------------------------+------------------------------+------------------------------+
 | BALL       | B4                       | C4                           | C17                          |
 +------------+--------------------------+------------------------------+------------------------------+
-
+| DEFAULT    | core_gpio[5] @ 0x41100000| core_gpio[6] @ 0x41100000    | core_gpio[7] @ 0x41100000    |
++            +--------------------------+------------------------------+------------------------------+
+|            | GPIO                     | GPIO                         | GPIO                         |
++------------+--------------------------+------------------------------+------------------------------+
 
 P8.39-P8.41
 ------------
@@ -198,32 +233,41 @@ P8.39-P8.41
 +------------+-----------------------------------------------+--------------------------+------------------------------+
 | BALL       | B17                                           | B18                      | A18                          |
 +------------+-----------------------------------------------+--------------------------+------------------------------+
-
+| DEFAULT    | core_gpio[8] @ 0x41100000                     | core_gpio[9] @ 0x41100000| core_gpio[10] @ 0x41100000   |
++            +-----------------------------------------------+--------------------------+------------------------------+
+|            | GPIO                                          | GPIO                     | GPIO                         |
++------------+-----------------------------------------------+--------------------------+------------------------------+
 
 P8.42-P8.44
 ------------
 
-+------------+--------------------------+------------------------------+--------------------------+
-| Pin        | P8.42                    | P8.43                        | P8.44                    |
-+============+==========================+==============================+==========================+
-| Name       | GPIO36NB1                | GPIO36PB1/CCC_SW_CLKIN_S_0   | GPIO42NB1                |
-+------------+--------------------------+------------------------------+--------------------------+
-| BALL       | D6                       | D7                           | D8                       |
-+------------+--------------------------+------------------------------+--------------------------+
-
++------------+------------------------------+------------------------------+------------------------------+
+| Pin        | P8.42                        | P8.43                        | P8.44                        |
++============+==============================+==============================+==============================+
+| Name       | GPIO36NB1                    | GPIO36PB1/CCC_SW_CLKIN_S_0   | GPIO42NB1                    |
++------------+------------------------------+------------------------------+------------------------------+
+| BALL       | D6                           | D7                           | D8                           |
++------------+------------------------------+------------------------------+------------------------------+
+| DEFAULT    | core_gpio[11] @ 0x41100000   | core_gpio[12] @ 0x41100000   | core_gpio[13] @ 0x41100000   |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | GPIO                         | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
 
 P8.45-P8.46
 ------------
 
-+------------+--------------------------+------------------------------+
-| Pin        | P8.45                    | P8.46                        |
-+============+==========================+==============================+
-| Name       | GPIO42PB1                | GPIO4PB1/CCC_SE_PLL1_OUT1    |
-+------------+--------------------------+------------------------------+
-| BALL       | D9                       | D18                          |
-+------------+--------------------------+------------------------------+
++------------+-------------------------------+-------------------------------+
+| Pin        | P8.45                         | P8.46                         |
++============+===============================+===============================+
+| Name       | GPIO42PB1                     | GPIO4PB1/CCC_SE_PLL1_OUT1     |
++------------+-------------------------------+-------------------------------+
+| BALL       | D9                            | D18                           |
++------------+-------------------------------+-------------------------------+
+| DEFAULT    | core_gpio[14] @ 0x41100000    | core_gpio[15] @ 0x41100000    |
++            +-------------------------------+-------------------------------+
+|            | GPIO                          | GPIO                          |
++------------+-------------------------------+-------------------------------+
 
- 
 Connector P9
 ==============
 
@@ -286,7 +330,10 @@ P9.11-P9.13
 +------------+--------------------------+---------------------------------+--------------------------+
 | BALL       | B5                       | C5                              | D19                      |
 +------------+--------------------------+---------------------------------+--------------------------+
-
+| DEFAULT    | MMUART4                  | core_gpio[1] @ 0x41200000       | MMUART4                  |
++            +--------------------------+---------------------------------+--------------------------+
+|            | UART4 RX                 | GPIO                            | UART4 TX                 |
++------------+--------------------------+---------------------------------+--------------------------+
 
 P9.14-P9.16
 -------------
@@ -298,7 +345,10 @@ P9.14-P9.16
 +------------+---------------------------------------------------------+--------------------------+------------------------------+
 | BALL       | C6                                                      | A5                       | A6                           |
 +------------+---------------------------------------------------------+--------------------------+------------------------------+
-
+| DEFAULT    | core_pwm[0] @ 0x41400000                                | core_gpio[4] @ 0x41200000| core_pwm[1] @ 0x41400000     |
++            +---------------------------------------------------------+--------------------------+------------------------------+
+|            | PWM_1:0                                                 | GPIO                     | PWM_1:1                      |
++------------+---------------------------------------------------------+--------------------------+------------------------------+
 
 P9.17-P9.19
 -------------
@@ -310,8 +360,10 @@ P9.17-P9.19
 +------------+--------------------------+----------------------------------+------------------------------+
 | BALL       | C9                       | C10                              | A10                          |
 +------------+--------------------------+----------------------------------+------------------------------+
-
-
+| DEFAULT    | -                        | -                                | MSS I2C0                     |
++            +--------------------------+----------------------------------+------------------------------+
+|            | -                        | -                                | I2C0 SCL                     |
++------------+--------------------------+----------------------------------+------------------------------+
 
 P9.20-P9.22
 ------------
@@ -323,43 +375,57 @@ P9.20-P9.22
 +------------+--------------------------+--------------------------+--------------------------+
 | BALL       | A11                      | B8                       | A8                       |
 +------------+--------------------------+--------------------------+--------------------------+
-
+| DEFAULT    | MSS I2C0                 | -                        | -                        |
++            +--------------------------+--------------------------+--------------------------+
+|            | I2C0 SDA                 | -                        | -                        |
++------------+--------------------------+--------------------------+--------------------------+
 
 
 P9.23-P9.25
 ------------
 
-+------------+--------------------------+--------------------------+--------------------------+
-| Pin        | P9.23                    | P9.24                    | P9.25                    |
-+============+==========================+==========================+==========================+
-| Name       | GPIO48NB1                | GPIO48PB1/CLKIN_S_4      | GPIO41NB1                |
-+------------+--------------------------+--------------------------+--------------------------+
-| BALL       | C1                       | B12                      | B7                       |
-+------------+--------------------------+--------------------------+--------------------------+
-
++------------+------------------------------+------------------------------+------------------------------+
+| Pin        | P9.23                        | P9.24                        | P9.25                        |
++============+==============================+==============================+==============================+
+| Name       | GPIO48NB1                    | GPIO48PB1/CLKIN_S_4          | GPIO41NB1                    |
++------------+------------------------------+------------------------------+------------------------------+
+| BALL       | C1                           | B12                          | B7                           |
++------------+------------------------------+------------------------------+------------------------------+
+| DEFAULT    | core_gpio[10] @ 0x41200000   | -                            | core_gpio[12] @ 0x41200000   |
++            +------------------------------+------------------------------+------------------------------+
+|            | GPIO                         | -                            | GPIO                         |
++------------+------------------------------+------------------------------+------------------------------+
 
 P9.26-P9.28
 ------------
 
-+------------+----------------------------------------+--------------------------+-------------------------------+
-| Pin        | P9.26                                  | P9.27                    | P9.28                         |
-+============+========================================+==========================+===============================+
-| Name       | GPIO41PB1/CLKIN_S_3/CCC_SW_CLKIN_S_3   | GPIO46NB1                | GPIO46PB1/CCC_SW_PLL0_OUT1    |
-+------------+----------------------------------------+--------------------------+-------------------------------+
-| BALL       | A7                                     | D11                      | C11                           |
-+------------+----------------------------------------+--------------------------+-------------------------------+
++------------+----------------------------------------+------------------------------+-------------------------------+
+| Pin        | P9.26                                  | P9.27                        | P9.28                         |
++============+========================================+==============================+===============================+
+| Name       | GPIO41PB1/CLKIN_S_3/CCC_SW_CLKIN_S_3   | GPIO46NB1                    | GPIO46PB1/CCC_SW_PLL0_OUT1    |
++------------+----------------------------------------+------------------------------+-------------------------------+
+| BALL       | A7                                     | D11                          | C11                           |
++------------+----------------------------------------+------------------------------+-------------------------------+
+| DEFAULT    | -                                      | core_gpio[14] @ 0x41200000   | -                             |
++            +----------------------------------------+------------------------------+-------------------------------+
+|            | -                                      | GPIO                         | -                             |
++------------+----------------------------------------+------------------------------+-------------------------------+
+
 
 P9.29-P9.31
 ------------
 
-+------------+--------------------------------------+--------------------------+--------------------------+
-| Pin        | P9.29                                | P9.30                    | P9.31                    |
-+============+======================================+==========================+==========================+
-| Name       | GPIO1PB1/CLKIN_S_9/CCC_SE_CLKIN_S_9  | GPIO1NB1                 | GPIO4NB1                 |
-+------------+--------------------------------------+--------------------------+--------------------------+
-| BALL       | F17                                  | F16                      | E18                      |
-+------------+--------------------------------------+--------------------------+--------------------------+
-
++------------+--------------------------------------+------------------------------+------------------------------+
+| Pin        | P9.29                                | P9.30                        | P9.31                        |
++============+======================================+==============================+==============================+
+| Name       | GPIO1PB1/CLKIN_S_9/CCC_SE_CLKIN_S_9  | GPIO1NB1                     | GPIO4NB1                     |
++------------+--------------------------------------+------------------------------+------------------------------+
+| BALL       | F17                                  | F16                          | E18                          |
++------------+--------------------------------------+------------------------------+------------------------------+
+| DEFAULT    | -                                    | core_gpio[17] @ 0x41200000   | -                            |
++            +--------------------------------------+------------------------------+------------------------------+
+|            | -                                    | GPIO                         | -                            |                              
++------------+--------------------------------------+------------------------------+------------------------------+
 
 P9.32-P9.40
 -------------
@@ -386,7 +452,10 @@ P9.41-P9.42
 +------------+---------------------------------------------------------+--------------------------+
 | BALL       | E15                                                     | E14                      |
 +------------+---------------------------------------------------------+--------------------------+
-
+| DEFAULT    | core_gpio[19] @ 0x41200000                              | core_pwm[0] @ 0x41000000 |
++            +---------------------------------------------------------+--------------------------+
+|            | GPIO                                                    | PWM_0:0                  |
++------------+---------------------------------------------------------+--------------------------+
 
 P9.43-P9.46
 -------------
-- 
GitLab