Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


Sidebar

products:sbc:common:applications:gpio:40pin-header

This is an old revision of the document!


GPIO Header

Universal GPIO 40 pins board header, provided for wide range communication…

Boards reference table vendor kernel

Current GPIO numbers valid for vendor kernel only. Mainline linux kernel GPIO numbers will be different…

VIM1

GPIO Name Physical Physical Name GPIO
5V 1 21 GND
5V 2 22 PIN.DV25 474
HUB_DM1 3 23 PIN.DV24 473
HUB_DP1 4 24 GND
GND 5 25 PIN.DV27 476
5V 6 26 PIN.DV26 475
HUB_DM2 7 27 3.3V
HUB_DP2 8 28 GND
GND 9 29 PIN.H7 423
ADC.CH0 10 30 PIN.H6 422
GND 11 31 PIN.H9 425
ADC.CH2 12 32 PIN.H8 424
420 PIN.H4 13 33 PIN.AO6 507
GND 14 34 GND
506 PIN.AO5 15 35 PIN.AO3 504
505 PIN.AO4 16 36 RTC_CLK
GND 17 37 PIN.H5 421
PIN.AO1 18 38 PWR_EN
PIN.AO2 19 39 PWM_F
3.3V 20 40 GND

VIM2

GPIO Name Physical Physical Name GPIO
5V 1 21 GND
5v 2 22 PIN.DV25 474
USB_DM 3 23 PIN.DV24 473
USB_DP 4 24 GND
GND 5 25 PIN.DV27 476
470 PIN.DV21 6 26 PIN.DV26 475
471 PIN.DV22 7 27 3.3V
472 PIN.DV23 8 28 GND
GND 9 29 PIN.H7 423
ADC0 10 30 PIN.H6 422
1.8V 11 31 PIN.H9 425
ADC1 12 32 PIN.H8 424
420 PIN.H4 13 33 PIN.AO6 507
GND 14 34 GND
506 PIN.AO5 15 35 PIN.DV28 478
505 PIN.AO4 16 36 RTC_CLK
GND 17 37 PIN.H5 421
PIN.AO1 18 38 EXP_INT
PIN.AO0 19 39 PIN.DV13 462
3.3v 20 40 GND

VIM3 VIM3L

GPIO Name Physical Physical Name GPIO
5V 1 21 GND
5V 2 22 PIN.A15 475
USB_DM 3 23 PIN.A14 474
USB_DP 4 24 GND
GND 5 25 PIN.AO2 498
MCU3V3 6 26 PIN.AO3 499
MCUNRST 7 27 3V3
MCUSWIM 8 28 GND
GND 9 29 PIN.A1 461
ADC0 10 30 PIN.A0 460
1V8 11 31 PIN.A3 463
ADC1 12 32 PIN.A2 462
506 PIN.AO10 13 33 PIN.A4 464
GND3 14 34 GND
433 PIN.H6 15 35 PWM-F 432
434 PIN.H7 16 36 RTC
GND 17 37 PIN.H4 431
PIN.AO1 18 38 MCU-FA1
PIN.AO0 19 39 PIN.Z15 426
3V3 20 40 GND

VIM4

GPIO Name Physical Physical Name GPIO
5V 1 21 GND
5V 2 22 PIN.Y17 501
HUB_D4N 3 23 PIN.Y18 502
HUB_D4P 4 24 GND
GND 5 25 PIN.T20 466
VCCMCU 6 26 PIN.T21 467
MCUBOOT0 7 27 3V3
MCUSWDIO 8 28 GND
GND 9 29 PIN.T1 447
ADC_CH6 10 30 PIN.T0 446
VDD1V8 11 31 PIN.T3 449
ADC_CH3 12 32 PIN.T2 448
420 SPDIFOUT 13 33 PIN.T4 450
GND 14 34 GND
491 PIN.Y7 15 35 PIN.Y8 482
490 PIN.Y6 16 36 PIN.T18 464
GND 17 37 PIN.T19 465
PIN.D1 18 38 PWR_EN1
PIN.D2 19 39 PIN.D15 417
3V3 20 40 GND

VIM1S

GPIO Name Physical Physical Name GPIO
5V 1 21 GND
5V 2 22 PIN.D7 461
USB_DM 3 23 PIN.D6 460
USB_DP 4 24 GND
GND 5 25 PIN.Z11 509
VCCMCU 6 26 PIN.Z12 510
MCU_NRST 7 27 3V3
MCU_SWIM 8 28 GND
GND 9 29 PIN.Z1 499
ADC_CH0 10 30 PIN.Z6 504
VDD1V8 11 31 PIN.Z2 500
ADC_CH2 12 32 PIN.Z0 498
470 SPDIFOUT 13 33 PIN.Z3 501
GND 14 34 GND
457 PIN.D3 15 35 PIN.Z5 503
456 PIN.D2 16 36 PIN.Z8 506
GND 17 37 PIN.Z10 508
PIN.D1 18 38 PWR_EN1
PIN.D0 19 39 PIN.H9 475
3V3 20 40 GND

Edge-V

GPIO Name Physical Physical Name GPIO
5V 1 21 GND(0V)
5V 2 22 SPI3_RXD/I2C0_SCK/GPIO1_C0 48
HOST1_DM 3 23 SPI3_TXD/I2C0_SDA/GPIO1_B7 47
HOST1_DP 4 24 GND(0V)
GND(0V) 5 25 I2C2_SCL/GPIO2_A1 65
MCU_TX 6 26 I2C2_SDA/GPIO2_A0 64
MCU_NRST 7 27 3.3V
MCU_SWIM 8 28 GND(0V)
GND(0V) 9 29 I2S0_SCLK/GPIO3_D0 120
ADC_IN2 10 30 I2S_CLK/GPIO4_A0 128
1.8V 11 31 I2S0_SDO0/GPIO3_D7 127
ADC_IN3 12 32 2S0_LRCK_TX/GPIO3_D2 122
112 SPDIF/GPIO3_C0 13 33 I2S0_SDI0/GPIO3_D3 123
GND(0V 14 34 GND(0V)
50 SPI3_CS/GPIO1_C2 15 35 I2S0_SDI3SDO1/GPIO3_D6 126
49 SPI3_CLK/GPIO1_C1 16 36 2S0_SDI2SDO2/GPIO3_D5 125
GND(0V) 17 37 I2S0_SDI1SDO3/GPIO3_D4 124
UART_RX 18 38 I2S0_LRCK_RX/GPIO3_D1 121
UART_TX 19 39 MCU_PA1
3.3V 20 40 GND(0V)

Edge2

GPIO Name Physical Physical Name GPIO
GND(0V) 1 21 GND(0V)
SARADC_IN4 2 22 MCU_SWDIO
1.8V 3 23 MCU_SWCLK
112 SPI1_MOSI_M1/GPIO3_C0 4 24 VCC_MCU
111 SPI1_MISO_M1/GPIO3_B7 5 25
114 SPI1_CS_M1/GPIO3_C2 6 26
113 SPI1_CLK_M1/GPIO3_C1 7 27
I2C6_SCL_M0_3V3 8 28
I2C6_SDA_M0_3V 9 29
MCU_IR_IN 10 30
PWR_KEY_IN 11 31
SARADC_IN3 12 32
VCC_3V3_S3 13 33
DEBUG_TX_3V3 14 34
DEBUG_RX_3V3 15 35
GND(0V) 16 36
PWM3_IR_M3 17 37
GND(0V) 18 38
MCU_USART2_TX 19 39
MCU_USART2_RX 20 40

Control GPIO

Please make sure that the GPIOs you want to use are not configured as other functions, if they are, you can follow Device Tree Overlay to configure them as normal GPIOs.

When you get the GPIO number, you can follow the steps below to control it. Here we take GPIO number 465 as an example.

Export GPIO

$ echo 465 | sudo tee /sys/class/gpio/export

Set-up GPIO direction

You can set the direction input or output.

$ echo out | sudo tee /sys/class/gpio/gpio465/direction # Set GPIO output
$ echo in | sudo tee /sys/class/gpio/gpio465/direction # Set GPIO input

Set GPIO value

$ echo 1 | sudo tee /sys/class/gpio/gpio465/value # Set GPIO output high
$ echo 0 | sudo tee /sys/class/gpio/gpio465/value # Set GPIO output low

Get GPIO value

$ cat /sys/class/gpio/gpio465/value # Get GPIO input value

Unexport GPIO

$ echo 465 | sudo tee /sys/class/gpio/unexport

Troubleshooting

If you got the similar error below, it means that the PIN you try to export is used for another function, you need to edit Device Tree Overlay configuration file to set the PIN as normal GPIO.

khadas@Khadas:~$ echo 465 | sudo tee /sys/class/gpio/export 
tee: /sys/class/gpio/export: Invalid argument
Last modified: 2022/10/17 00:19 by hyphop