Overview
The aim of this document is to explain how to setup pins of SP7350 in device-tree source. SP7350 has 106 general purpose IO (GPIO) pins which are multiplexed with other special functions, like eMMC device, SPI-NOR flash, SPI-NAND flash, Ethernet PHY (RGMII or RMII interface), UART, I2C pins, and etc.
...
We define a bunch of functions as listed in appendix function_table Function-group Table below.
Pins
SP7350 has 106 GPIO pins. ID is from 0 to 105. Name is in form of GPIO(id), like GPIO0, GPIO1, GPIO2, GPIO99, GPIO105, and etc. There are two kinds of GPIO pins. One is 1.8V GPIO pins, and the other is 1.8V/3.0V Dual Voltage IO (DVIO) pins. Beside configure 1.8V or 3.0V power to power supply to a DVIO group in your circuit boards (hardware), you need to setup MS control in device-tree source. Refer to groups of GPIO and DVIO in appendix gpio_table GPIO Table below for details.
Groups
We define a bunch of groups as listed in appendix Function-group _tableTable below.
Generic helper bindings
...
| Code Block | ||
|---|---|---|
| ||
uart7_pins: pinmux_uart7-pins {
function = "UART7";
groups = "UART7";
drive-strength-microamp = <SPPCTRL_GPIO_DRV_IOH_6600_IOL_6600UA>;
}; |
Appendix
...
GPIO Table
GPIO # | Pin type | Pin name | Power-supply | Power domain |
0 - 19 | 1.8V GPIO | G_MX0 - G_MX19 | VDDPST18_GPIO | Main |
20 | 1.8V/3.0V DVIO | G_MX20 | VDDPST3018_DVIO_2 | |
21 - 27 | G_MX21 - G_MX27 | VDDPST3018_DVIO_1 | ||
28 - 37 | G_MX28 - G_MX37 | VDDPST3018_DVIO_2 | ||
38 - 43 | G_MX38 - G_MX43 | AVDDIO_3018_SD | ||
44 - 49 | G_MX44 - G_MX49 | AVDDIO_3018_SDIO | ||
50 - 59 | AO_MX0 - AO_MX9 | VDDPST3018_DVIO_AO_1 | CM4 (AO) | |
60 - 69 | AO_MX10 - AO_MX19 | VDDPST3018_DVIO_AO_2 | ||
70 - 79 | AO_MX20 - AO_MX29 | VDDPST3018_DVIO_AO_3 | ||
80 - 98 | 1.8V GPIO | AO_MX30 - AO_MX48 | VDDPST18_GPIO_AO | |
99 - 105 | IV_MX0 - IV_MX6 |
...
Driving-strength Table of GPIO and DVIO
Source current (mA) for GPIO | |||
Min Value | Typical Value | Max Value | MACRO |
0.8 | 1.1 | 1.5 | SPPCTRL_GPIO_DRV_IOH_1100_IOL_1100UA |
1.1 | 1.6 | 2.2 | SPPCTRL_GPIO_DRV_IOH_1600_IOL_1700UA |
2.3 | 3.3 | 4.3 | SPPCTRL_GPIO_DRV_IOH_3300_IOL_3300UA |
3.4 | 4.9 | 6.5 | SPPCTRL_GPIO_DRV_IOH_4900_IOL_5000UA |
4.5 | 6.6 | 8.6 | SPPCTRL_GPIO_DRV_IOH_6600_IOL_6600UA |
5.7 | 8.2 | 10.8 | SPPCTRL_GPIO_DRV_IOH_8200_IOL_8300UA |
6.8 | 9.9 | 13.0 | SPPCTRL_GPIO_DRV_IOH_9900_IOL_9900UA |
7.9 | 11.5 | 15.1 | SPPCTRL_GPIO_DRV_IOH_11500_IOL_11600UA |
9.0 | 13.1 | 17.2 | SPPCTRL_GPIO_DRV_IOH_13100_IOL_13200UA |
10.2 | 14.8 | 19.4 | SPPCTRL_GPIO_DRV_IOH_14800_IOL_14800UA |
11.3 | 16.4 | 21.6 | SPPCTRL_GPIO_DRV_IOH_16400_IOL_16500UA |
12.4 | 18.1 | 23.7 | SPPCTRL_GPIO_DRV_IOH_18100_IOL_18100UA |
13.5 | 19.6 | 25.8 | SPPCTRL_GPIO_DRV_IOH_19600_IOL_19700UA |
14.7 | 21.3 | 28.0 | SPPCTRL_GPIO_DRV_IOH_21300_IOL_21400UA |
15.8 | 22.9 | 30.1 | SPPCTRL_GPIO_DRV_IOH_22900_IOL_23000UA |
16.9 | 24.6 | 32.3 | SPPCTRL_GPIO_DRV_IOH_24600_IOL_24600UA |
...
Sink current （mA）for DVIO | |||
Min Value | Typical Value | Max Value | MACRO |
4.0 | 6.2 | 8.6 | SPPCTRL_DVIO_DRV_IOH_5100_IOL_6200UA |
6.0 | 9.3 | 12.9 | SPPCTRL_DVIO_DRV_IOH_7600_IOL_9300UA |
8.1 | 12.5 | 17.1 | SPPCTRL_DVIO_DRV_IOH_10100_IOL_12500UA |
10.1 | 15.6 | 21.4 | SPPCTRL_DVIO_DRV_IOH_12600_IOL_15600UA |
12.1 | 18.7 | 25.7 | SPPCTRL_DVIO_DRV_IOH_15200_IOL_18700UA |
14.1 | 21.8 | 29.9 | SPPCTRL_DVIO_DRV_IOH_17700_IOL_21800UA |
16.1 | 24.9 | 34.2 | SPPCTRL_DVIO_DRV_IOH_20200_IOL_24900UA |
18.1 | 27.9 | 38.4 | SPPCTRL_DVIO_DRV_IOH_22700_IOL_27900UA |
20.1 | 31.0 | 42.7 | SPPCTRL_DVIO_DRV_IOH_25200_IOL_31000UA |
22.1 | 34.1 | 46.9 | SPPCTRL_DVIO_DRV_IOH_27700_IOL_34100UA |
24.1 | 37.2 | 51.1 | SPPCTRL_DVIO_DRV_IOH_30300_IOL_37200UA |
26.1 | 40.3 | 55.3 | SPPCTRL_DVIO_DRV_IOH_32800_IOL_40300UA |
28.1 | 43.4 | 59.5 | SPPCTRL_DVIO_DRV_IOH_35300_IOL_43400UA |
30.1 | 46.4 | 63.8 | SPPCTRL_DVIO_DRV_IOH_37800_IOL_46400UA |
32.1 | 49.5 | 67.9 | SPPCTRL_DVIO_DRV_IOH_40300_IOL_49500UA |
34.1 | 52.6 | 72.1 | SPPCTRL_DVIO_DRV_IOH_42700_IOL_52600UA |
...
Function-group Table
function name | group name | binding pins id | |
SPI_FLASH | SPI_FLASH | 21, 22, 23, 24, 25, 26 | |
EMMC | EMMC | 20, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37 | |
SPI_NAND | SPI_NAND_X1 | 30, 31, 32, 33, 34, 35 | |
SPI_NAND_X2 | 21, 22, 23, 24, 25, 26 | ||
SD_CARD | SD_CARD | 38, 39, 40, 41, 42, 43 | |
SDIO | SDIO | 44, 45, 46, 47, 48, 49 | |
PARA_NAND | PARA_NAND | 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36 | |
USB_OTG | USB_OTG | 18, 19 | |
GMAC | GMAC_RGMII | 3, 4, 5, 6, 13, 14, 10, 11, 7, 8, 15, 16, 9, 12 | |
GMAC_RMII | 4, 5, 6, 7, 8, 9, 10, 11, 12 | ||
PWM0 | PWM0_X1 | 78 | |
PWM0_X2 | 58 | ||
PWM1 | PWM1_X1 | 79 | |
PWM1_X2 | 59 | ||
PWM2 | PWM2_X1 | 60 | |
PWM2_X2 | 92 | ||
PWM3 | PWM3_X1 | 61 | |
PWM3_X2 | 93 | ||
UART0_X1 | UART0_X1 | 50, 51 | |
UART0_X2 | UART0_X2 | 68, 69 | |
UART1_X1 | UART1_X1 | 52, 53 | |
UART1_X2 | UART1_X2 | 64, 65 | |
UART1_FC_X1 | UART1_FC_X1 | 54, 55 | |
UART1_FC_X2 | UART1_FC_X2 | 66, 67 | |
UART2_X1 | UART2_X1 | 56, 57 | |
UART2_X2 | UART2_X2 | 76, 77 | |
UART2_FC_X1 | 58UART2_FC_X1 | 58, 59 | |
UART2_FC_X2 | UART2_FC_X2 | 78, 79 | |
UART3_X1 | UART3_X1 | 62, 63 | |
UART3_X2 | UART3_X2 | 7, 8 | |
UADBG | UADBG | 13, 14 | |
UART6_X1 | UART6_X1 | 80, 81 | |
UART6_X2 | UART6_X2 | 48, 49 | |
UART7 | UART7 | 82, 83 | |
I2C_COMBO0_X1 | I2C_COMBO0_X1 | 68, 69 | |
I2C_COMBO0_X2 | I2C_COMBO0_X2 | 54, 55 | |
I2C_COMBO1 | I2C_COMBO1 | 70, 71 | |
I2C_COMBO2_X1 | I2C_COMBO2_X1 | 76, 77 | |
I2C_COMBO2_X2 | I2C_COMBO2_X2 | 56, 57 | |
I2C_COMBO3 | I2C_COMBO3 | 88, 89 | |
I2C_COMBO4 | I2C_COMBO4 | 90, 91 | |
I2C_COMBO5 | I2C_COMBO5 | 92, 93 | |
I2C_COMBO6_X1 | I2C_COMBO6_X1 | 84, 85 | |
I2C_COMBO6_X2 | I2C_COMBO6_X2 | 1, 2 | |
I2C_COMBO7_X1 | I2C_COMBO7_X1 | 86, 87 | |
I2C_COMBO7_X2 | I2C_COMBO7_X2 | 3, 4 | |
I2C_COMBO8_X1 | I2C_COMBO8_X1 | 95, 96 | |
I2C_COMBO8_X2 | I2C_COMBO8_X2 | 9, 10 | |
I2C_COMBO9_X1 | I2C_COMBO9_X1 | 97, 98 | |
I2C_COMBO9_X2 | I2C_COMBO9_X2 | 11, 12 | |
SPI_MASTER0_X1 | SPI_MASTER0_X1 | 64, 65, 66, 67 | |
SPI_MASTER0_X2 | SPI_MASTER0_X2 | 9, 10, 11, 12 | |
SPI_MASTER1_X1 | SPI_MASTER1_X1 | 80, 81, 82, 83 | |
SPI_MASTER1_X2 | SPI_MASTER1_X2 | 14, 15, 16, 17 | |
SPI_MASTER2 | SPI_MASTER2 | 88, 89, 90, 91 | |
SPI_MASTER3_X1 | SPI_MASTER3_X1 | 44, 45, 46, 47 | |
SPI_MASTER3_X2 | SPI_MASTER3_X2 | 52, 53, 54, 55 | |
SPI_MASTER4 | SPI_MASTER4 | 72, 73, 74, 75 | |
SPI_SLAVE0_X1 | SPI_SLAVE0_X1 | 94, 95, 96, 97 | |
SPI_SLAVE0_X2 | SPI_SLAVE0_X2 | 72, 73, 74, 75 | |
AUD_TDMTX_XCK | AUD_TDMTX_XCK | 93 | |
AUD_DAC_XCK1 | AUD_DAC_XCK1 | 71 | |
AUD_DAC_XCK | AUD_DAC_XCK | 83 | |
AUD_AU2_DATA0 | AUD_AU2_DATA0 | 82 | |
AUD_AU1_DATA0 | AUD_AU1_DATA0 | 58 | |
AUD_AU2_CK | AUD_AU2_CK | 80, 81 | |
AUD_AU1_CK | AUD_AU1_CK | 56, 57 | |
AUD_AU_ADC_DATA0_X1 | AUD_AU_ADC_DATA0_X1 | 94, 95, 96, 97 | |
AUD_AU_ADC_DATA0_X2 | AUD_AU_ADC_DATA0_X2 | 72, 73, 74, 75 | |
AUD_ADC2_DATA0 | 82 | AUD_ADC2_DATA0 | 82 |
AUD_ADC1_DATA0 | AUD_ADC1_DATA0 | 58 | |
AUD_TDM | AUD_TDM | 94, 95, 96, 97 | |
SPDIF_IN_X1 | SPDIF_IN_X1 | 91 | |
SPDIF_IN_X2 | SPDIF_IN_X2 | 53 | |
SPDIF_IN_X3 | SPDIF_IN_X3 | 54 | |
SPDIF_IN_X4 | SPDIF_IN_X4 | 55 | |
SPDIF_IN_X5 | SPDIF_IN_X5 | 62 | |
SPDIF_IN_X6 | SPDIF_IN_X6 | 52 | |
SPDIF_OUT_X1 | SPDIF_OUT_X1 | 91 | |
SPDIF_OUT_X2 | SPDIF_OUT_X2 | 53 | |
SPDIF_OUT_X3 | SPDIF_OUT_X3 | 54 | |
SPDIF_OUT_X4 | SPDIF_OUT_X4 | 55 | |
SPDIF_OUT_X5 | SPDIF_OUT_X5 | 62 | |
SPDIF_OUT_X6 | SPDIF_OUT_X6 | 52 | |
INT0_X1 | INT0_X1 | 1 | |
INT0_X2 | INT0_X2 | 2 | |
INT0_X3 | INT0_X3 | 3 | |
INT0_X4 | INT0_X4 | 4 | |
INT0_X5 | INT0_X5 | 5 | |
INT0_X6 | INT0_X6 | 6 | |
INT0_X7 | INT0_X7 | 13 | |
INT0_X8 | INT0_X8 | 14 | |
INT0_X9 | INT0_X9 | 15 | |
INT1_X1 | INT1_X1 | 1 | |
INT1_X2 | INT1_X2 | 2 | |
INT1_X3 | INT1_X3 | 3 | |
INT1_X4 | INT1_X4 | 4 | |
INT1_X5 | INT1_X5 | 5 | |
INT1_X6 | INT1_X6 | 6 | |
INT1_X7 | INT1_X7 | 13 | |
INT1_X8 | INT1_X8 | 14 | |
INT1_X9 | INT1_X9 | 15 | |
INT2_X1 | INT2_X1 | 5 | |
INT2_X2 | INT2_X2 | 6 | |
INT2_X3 | INT2_X3 | 7 | |
INT2_X4 | INT2_X4 | 8 | |
INT2_X5 | INT2_X5 | 9 | |
INT2_X6 | INT2_X6 | 10 | |
INT2_X7 | INT2_X7 | 11 | |
INT2_X8 | INT2_X8 | 16 | |
INT2_X9 | INT2_X9 | 17 | |
INT3_X1 | INT3_X1 | 5 | |
INT3_X2 | INT3_X2 | 6 | |
INT3_X3 | INT3_X3 | 7 | |
INT3_X4 | INT3_X4 | 8 | |
INT3_X5 | INT3_X5 | 9 | |
INT3_X6 | INT3_X6 | 10 | |
INT3_X7 | INT3_X711 | 11 | |
INT3_X8 | INT3_X8 | 16 | |
INT3_X9 | INT3_X9 | 17 | |
INT4_X1 | INT4_X1 | 7 | |
INT4_X2 | INT4_X2 | 8 | |
INT4_X3 | INT4_X3 | 9 | |
INT4_X4 | INT4_X4 | 10 | |
INT4_X5 | INT4_X5 | 11 | |
INT4_X6 | INT4_X6 | 12 | |
INT4_X7 | INT4_X7 | 13 | |
INT4_X8 | INT4_X8 | 18 | |
INT4_X9 | INT4_X9 | 19 | |
INT5_X1 | INT5_X1 | 7 | |
INT5_X2 | INT5_X2 | 8 | |
INT5_X3 | INT5_X3 | 9 | |
INT5_X4 | INT5_X4 | 10 | |
INT5_X5 | INT5_X5 | 11 | |
INT5_X6 | INT5_X6 | 12 | |
INT5_X7 | INT5_X7 | 13 | |
INT5_X8 | INT5_X8 | 18 | |
INT5_X9 | INT5_X9 | 19 | |
INT6_X1 | INT6_X1 | 9 | |
INT6_X2 | INT6_X2 | 10 | |
INT6_X3 | INT6_X3 | 11 | |
INT6_X4 | INT6_X4 | 12 | |
INT6_X5 | INT6_X5 | 13 | |
INT6_X6 | INT6_X6 | 14 | |
INT6_X7 | INT6_X7 | 15 | |
INT6_X8 | INT6_X8 | 16 | |
INT6_X917 | INT6_X9 | 17 | |
INT6_X10 | INT6_X10 | 18 | |
INT6_X11 | INT6_X11 | 19 | |
INT7_X1 | INT7_X1 | 9 | |
INT7_X2 | INT7_X2 | 10 | |
INT7_X3 | INT7_X3 | 11 | |
INT7_X4 | INT7_X4 | 12 | |
INT7_X5 | INT7_X5 | 13 | |
INT7_X6 | INT7_X6 | 14 | |
INT7_X7 | INT7_X7 | 15 | |
INT7_X8 | INT7_X8 | 16 | |
INT7_X9 | INT7_X9 | 17 | |
INT7_X10 | INT7_X10 | 18 | |
INT7_X11 | INT7_X11 | 19 | |
GPIO_AO_INT0_X1 | GPIO_AO_INT0_X1 | 52, 53, 54, 55, 56, 57, 58, 59 | |
GPIO_AO_INT0_X2 | GPIO_AO_INT0_X2 | 68, 69, 70, 71, 72, 73, 74, 75 | |
GPIO_AO_INT1_X1 | GPIO_AO_INT1_X1 | 60, 61, 62, 63, 64, 65, 66, 67 | |
GPIO_AO_INT1_X2 | GPIO_AO_INT1_X2 | 76, 77, 78, 79, 80, 81, 82, 83 | |
GPIO_AO_INT2_X1 | GPIO_AO_INT2_X1 | 68, 69, 70, 71, 72, 73, 74, 75 | |
GPIO_AO_INT2_X2 | GPIO_AO_INT2_X2 | 84, 85, 86, 87, 88, 89, 90, 91 | |
GPIO_AO_INT3_X1 | GPIO_AO_INT3_X1 | 76, 77, 78, 79, 80, 81, 82, 83 | |
GPIO_AO_INT3_X2 | GPIO_AO_INT3_X2 | 91, 92, 93, 94, 95, 96, 97, 98 |
...
Function Table
function name | binding group name |
GPIO | all groups and all pins |
SPI_FLASH | SPI_FLASH |
EMMC | EMMC |
SPI_NAND | SPI_NAND_X1, SPI_NAND_X2 |
SD_CARD | SD_CARD |
SDIO | SDIO |
PARA_NAND | PARA_NAND |
USB_OTG | USB_OTG |
GMAC | GMAC_RGMII, GMAC_RMII |
PWM0 | PWM0_X1, PWM0_X2 |
PWM1 | PWM1_X1, PWM1_X2 |
PWM2 | PWM2_X1, PWM2_X2 |
PWM3 | PWM3_X1, PWM3_X2 |
UART0 | UART0_X1, UART0_X2 |
UART1 | UART1_X1, UART1_X2 |
UART1_FC | UART1_FC_X1, UART1_FC_X2 |
UART2 | UART2_X1, UART2_X2 |
UART2_FC | UART2_FC_X1, UART2_FC_X2 |
UART3 | UART3_X1, UART3_X2 |
UADBG | UADBG |
UART6 | UART6_X1, UART6_X2 |
UART7 | UART7 |
I2C_COMBO0 | I2C_COMBO0_X1, I2C_COMBO0_X2 |
I2C_COMBO1 | I2C_COMBO1 |
I2C_COMBO2 | I2C_COMBO2_X1, I2C_COMBO2_X2 |
I2C_COMBO3 | I2C_COMBO3 |
I2C_COMBO4 | I2C_COMBO4 |
I2C_COMBO5 | I2C_COMBO5 |
I2C_COMBO6 | I2C_COMBO6_X1, I2C_COMBO6_X2 |
I2C_COMBO7 | I2C_COMBO7_X1, I2C_COMBO7_X2 |
I2C_COMBO8 | I2C_COMBO8_X1, I2C_COMBO8_X2 |
I2C_COMBO9 | I2C_COMBO9_X1, I2C_COMBO9_X2 |
SPI_MASTER0 | SPI_MASTER0_X1, SPI_MASTER0_X2 |
SPI_MASTER1 | SPI_MASTER1_X1, SPI_MASTER1_X2 |
SPI_MASTER2 | SPI_MASTER2 |
SPI_MASTER3 | SPI_MASTER3_X1, SPI_MASTER3_X2 |
SPI_MASTER4 | SPI_MASTER4 |
SPI_SLAVE0 | SPI_SLAVE0_X1, SPI_SLAVE0_X2 |
AUD_TDMTX_XCK | AUD_TDMTX_XCK |
AUD_DAC_XCK1 | AUD_DAC_XCK1 |
AUD_DAC_XCK | AUD_DAC_XCK |
AUD_AU2_DATA0 | AUD_AU2_DATA0 |
AUD_AU1_DATA0 | AUD_AU1_DATA0 |
AUD_AU2_CK | AUD_AU2_CK |
AUD_AU1_CK | AUD_AU1_CK |
AUD_AU_ADC_DATA0 | AUD_AU_ADC_DATA0_X1, AUD_AU_ADC_DATA0_X2 |
AUD_ADC2_DATA0 | AUD_ADC2_DATA0 |
AUD_ADC1_DATA0 | AUD_ADC1_DATA0 |
AUD_TDM | AUD_TDM |
SPDIF_IN | SPDIF_IN_X1 ~ SPDIF_IN_X6 |
SPDIF_OUT | SPDIF_OUT_X1 ~ SPDIF_OUT_X6 |
INT0 | INT0_X1 ~ INT0_X9 |
INT1 | INT1_X1 ~ INT1_X9 |
INT2 | INT2_X1 ~ INT2_X9 |
INT3 | INT3_X1 ~ INT3_X9 |
INT4 | INT4_X1 ~ INT4_X9 |
INT5 | INT5_X1 ~ INT5_X9 |
INT6 | INT6_X1 ~ INT6_X11 |
INT7 | INT7_X1 ~ INT7_X11 |
GPIO_AO_INT0 | GPIO_AO_INT0_X1， GPIO_AO_INT0_X2 |
GPIO_AO_INT1 | GPIO_AO_INT1_X1， GPIO_AO_INT1_X2 |
GPIO_AO_INT2 | GPIO_AO_INT2_X1， GPIO_AO_INT2_X2 |
GPIO_AO_INT3 | GPIO_AO_INT3_X1， GPIO_AO_INT3_X2 |