Table of Contents

VIM4 GPIO Header

Universal GPIO 40 pins board header, used for communication between board and different external devices.

Reference table

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

Linux

GPIO num Name Pin Pin Name GPIO num
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 492
490 PIN.Y6 16 36 PIN.T18 464
GND 17 37 PIN.T19 465
UART_RX / PIN.D1 18 38 PWR_EN1
UART_TX / PIN.D2 19 39 PIN.D5 417
3V3 20 40 GND

Android

GPIO num Name Pin Pin Name GPIO num
5V 1 21 GND
5V 2 22 I2CM_F_SCL
HUB_D4N 3 23 I2CM_F_SDA
HUB_D4P 4 24 GND
GND 5 25 I2CM_A_SCL
VCCMCU 6 26 I2CM_A_SDA
MCUBOOT0 7 27 3V3
MCUSWDIO 8 28 GND
GND 9 29 I2S_SCLK1 447
ADC_CH6 10 30 I2S_MCLK1 446
VDD1V8 11 31 I2S_SDO1 449
ADC_CH3 12 32 I2S_LRCLK1 448
420 SPDIFOUT 13 33 I2S_SDI1 450
GND 14 34 GND
491 UART_E_RX 15 35 PWM_F 492
490 UART_E_TX 16 36 PIN.T18 464
GND 17 37 PIN.T19 465
Linux_RX 18 38 PWR_EN1
Linux_TX 19 39 PIN.D5 417
3V3 20 40 GND

Get GPIO number

If the GPIO number above changed, you can also follow the documentation to get the gpio number.

GPIO usage examples

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

We can configure direction as 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.

$ echo 465 | sudo tee /sys/class/gpio/export 
tee: /sys/class/gpio/export: Invalid argument
2022/06/30 00:01 · nick