Zero/hardware/gpio

2022-10-17T15:04:35Z

Athena-metis:

{{Zero_header}}

{{Languages|zero/hardware/gpio}}

[[Zero | Radxa Zero]] > [[zero/hardware | Hardware]] > [[zero/hardware/gpio | GPIO]]

== <span id="gpio">General purpose input-output (GPIO) connector</span> ==

Radxa Zero has a 40-pin expansion header. Each pin is distinguished by color.

{| class="wikitable" style="vertical-align:middle; background-color:#F9F9F9;"
|- style="font-weight:bold; text-align:center; background-color:#F2F2F2;"
! GPIO number
! Function4
! Function3
! Function2
! Function1
! Pin#
!
! Pin#
! Function1
! Function2
! Function3
! Function4
! GPIO number
|-
|
|
|
|
| +3.3V
| style="background-color:#FF0;" | 1
|
| style="background-color:#F00;" | 2
| +5.0V
|
|
|
|
|-
| 490
|
|
| I2C_EE_M3_SDA
| GPIOA_14 (*)
| style="background-color:#008000; color:#FFF;" | 3
|
| style="background-color:#F00;" | 4
| +5.0V
|
|
|
|
|-
| 491
|
|
| I2C_EE_M3_SCL
| GPIOA_15 (*)
| style="background-color:#008000; color:#FFF;" | 5
|
| style="background-color:#000; color:#FFF" | 6
| GND
|
|
|
|
|-
| 415
| I2C_AO_S0_SDA
| UART_AO_B_RX
| I2C_AO_M0_SDA
| GPIOAO_3
| style="background-color:#008000; color:#FFF;" | 7
|
| style="background-color:#008000; color:#FFF;" | 8
| GPIOAO_0
| style="background-color:#FFA500;" | UART_AO_A_TXD
|
|
| 412
|-
|
|
|
|
| GND
| style="background-color:#000; color:#FFF" | 9
|
| style="background-color:#008000; color:#FFF;" | 10
| GPIOAO_1
| style="background-color:#FFA500;" | UART_AO_A_RXD
|
|
| 413
|-
| 414
| I2C_AO_S0_SCL
| UART_AO_B_TX
| I2C_AO_M0_SCL
| GPIOAO_2
| style="background-color:#008000; color:#FFF;" | 11
|
| style="background-color:#008000; color:#FFF;" | 12
| GPIOX_9
| SPI_A_MISO
| TDMA_D0
|
| 501
|-
| 503
| TDMA_SCLK
| I2C_EE_M1_SCL
| SPI_A_SCLK
| GPIOX_11
| style="background-color:#008000; color:#FFF;" | 13
|
| style="background-color:#000; color:#FFF" | 14
| GND
|
|
|
|
|-
|
|
|
|
| SARADC_CH1
| style="background-color:#008000; color:#FFF;" | 15
|
| style="background-color:#008000; color:#FFF;" | 16
| GPIOX_10
| SPI_A_SS0
| I2C_EE_M1_SDA
| TDMA_FS
| 502
|-
|
|
|
|
| +3.3V
| style="background-color:#FF0;" | 17
|
| style="background-color:#008000; color:#FFF;" | 18
| GPIOX_8
| SPI_A_MOSI
| PWM_C
| TDMA_D1
| 500
|-
| 447
|
| SPI_B_MOSI
| UART_EE_C_RTS
| GPIOH_4
| style="background-color:#008000; color:#FFF;" | 19
|
| style="background-color:#000; color:#FFF" | 20
| GND
|
|
|
|
|-
| 448
| PWM_F
| SPI_B_MISO
| UART_EE_C_CTS
| GPIOH_5
| style="background-color:#008000; color:#FFF;" | 21
|
| style="background-color:#008000; color:#FFF;" | 22
| GPIOC_7
| -
|
|
| 475
|-
| 450
| I2C_EE_M1_SCL
| SPI_B_SCLK
| UART_EE_C_TX
| GPIOH_7
| style="background-color:#008000; color:#FFF;" | 23
|
| style="background-color:#008000; color:#FFF;" | 24
| GPIOH_6
| UART_EE_C_RX
| SPI_B_SS0
| I2C_EE_M1_SDA
| 449
|-
|
|
|
|
| GND
| style="background-color:#000; color:#FFF" | 25
|
| style="background-color:#008000; color:#FFF;" | 26
| SARADC_CH2
|
|
|
|
|-
| 415
| I2C_AO_S0_SDA
| UART_AO_B_RX
| I2C_AO_M0_SDA
| GPIOAO_3
| style="background-color:#00F; color:#FFF;" | 27
|
| style="background-color:#00F; color:#FFF;" | 28
| GPIOAO_2
| I2C_AO_M0_SCL
| UART_AO_B_TX
| I2C_AO_S0_SCL
| 414
|-
|
|
|
|
| NC
| style="background-color:#008000; color:#FFF;" | 29
|
| style="background-color:#000; color:#FFF" | 30
| GND
|
|
|
|
|-
|
|
|
|
| NC
| style="background-color:#008000; color:#FFF;" | 31
|
| style="background-color:#008000; color:#FFF;" | 32
| GPIOAO_4
| PWMAO_C
|
|
| 416
|-
|
|
|
|
| NC
| style="background-color:#008000; color:#FFF;" | 33
|
| style="background-color:#000; color:#FFF" | 34
| GND
|
|
|
|
|-
| 420
|
|
| UART_AO_B_TX
| GPIOAO_8
| style="background-color:#008000; color:#FFF;" | 35
|
| style="background-color:#008000; color:#FFF;" | 36
| GPIOH_8
| -
|
|
| 451
|-
| 421
|
|
| UART_AO_B_RX
| GPIOAO_9
| style="background-color:#008000; color:#FFF;" | 37
|
| style="background-color:#008000; color:#FFF;" | 38
| GPIOAO_10
| PWMAO_D
|
|
| 422
|-
|
|
|
|
| GND
| style="background-color:#000; color:#FFF" | 39
|
| style="background-color:#008000; color:#FFF;" | 40
| GPIOAO_11
| PWMAO_A
|
|
| 423
|}

=== More details about 40-pin Header ===
* Pins marked with orange color are designed for debug console.
* I2C: x3; I2C_EE_M1 (/dev/i2c-1), I2C_EE_M3 (/dev/i2c-3), I2C_AO_M0 (/dev/i2c-4)
* (*) I2C_EE_M3 / GPIOA_14 & GPIOA_15 are connected to pull up resistors and the USB-C controller so cannot be used for general GPIO
* PWM: x3; PWMAO_A, PWM_C
* SPI: x2; SPI_A (/dev/spi0.0), SPI_B(/dev/spi1.0)
* UART: x3; UART_AO_A (/dev/ttyAML0), UART_AO_B (/dev/ttyAML1), UART_EE_C (/dev/ttyAML4)
* Pin#22 (GPIOC_7) and Pin#36 (GPIOH_8) are open drain pins. This means for input they need to connected to either GND or VCC (floating state is undefined), for output they will need external pull up. Additionally GPIOH_8 runs on 5V logic.

=== GPIO number ===
* GPIOs are grouped in two banks, GPIO AO domain and GPIO EE domain
** AO domain: GPIOAO_0 - GPIOAO_11
** EE domain: GPIOA_14 - GPIOA_15 | GPIOH_0 - GPIOH_8 | GPIOX_0 - GPIOX_19
* UARTs
** AO domain: UARTAO_A | UARTAO_B
** EE domain: UART_A | UART_B | UART_C

{| class="wikitable"
|-
! GPIO Chip<br />
! GPIO Name<br />
! Base
! Offset
! Formula
|-
| First
| GPIOAO_x
| 412
| 0-11
| Base + Offset
|-
| First
| GPIOE_x
| 424
| 0-2
| Base + Offset
|-
| Second
| GPIOZ_x
| 427
| 0-15
| Base + Offset
|-
| Second
| GPIOH_x
| 443
| 0-8
| Base + Offset
|-
| Second
| BOOT_x
| 452
| 0-15
| Base + Offset
|-
| Second
| GPIOC_x
| 468
| 0-7
| Base + Offset
|-
| Second
| GPIOA_x
| 476
| 0-15
| Base + Offset
|-
| Second
| GPIOX_x
| 492
| 0-19
| Base + Offset
|}

Take GPIOX_10 as an example.

The base is 492 and the offset is 10. So the GPIOX_10's GPIO number is 492+10=502.

Radxa Wiki - User contributions [en]

Zero/hardware/gpio