gpio-and-adc - Revision history

Admin: /* GPIO */

2026-04-26T11:48:42Z

GPIO

← Older revision		Revision as of 11:48, 26 April 2026
Line 15:		Line 15:

	<pic src="images/1/16/The_40-pin_header_on_Vivid_Unit.png" width="100%" align="text" caption=""></pic>		<pic src="images/1/16/The_40-pin_header_on_Vivid_Unit.png" width="100%" align="text" caption=""></pic>

			'''Remarks:''' in Vivid Unit OS, the SDMMC host is disabled in device tree by default, and hence GPIO4_B0~B5 are initialized as normal GPIO pins.

	The GPIOs are named like these:		The GPIOs are named like these:

Admin at 08:34, 28 March 2026

2026-03-28T08:34:56Z

← Older revision		Revision as of 08:34, 28 March 2026
Line 136:		Line 136:

	=== '''VGP in GUI (Graphical User Interface)''' ===		=== '''VGP in GUI (Graphical User Interface)''' ===
	You ~~can click this icon in the task bar to~~ run the GUI version of VGP.		You may run the GUI version of VGP via the "System" category in Applications Menu.

	[[File:~~Vgpw~~.~~png~~]]		[[File:run-vgpw.jpg]]

	~~Alternatively you can find the item “VGPW” in the “System” category in application menu.~~ You may also run “vgpw” in command line terminal to launch the application.		You may also run “vgpw” in command line terminal to launch the same GUI application.

	You will see the interface that represents the 40-pin header:		You will see the interface that represents the 40-pin header:

	<pic src="images/f/f8/~~Vgp~~-~~1024x391~~.png" width="100%" align="text" caption=""></pic>		<pic src="images/a/ad/vgpw-202-1.png" width="100%" align="text" caption=""></pic>

	The value of three ADC channels are also listed at the bottom, including the raw values (0~1023) and the voltage values. These values refresh for every second.		The value of three ADC channels are also listed at the bottom, including the raw values (0~1023) and the voltage values. These values refresh for every second.

Admin: /* Get Pin Alternative Function */

2026-01-07T14:36:48Z

Get Pin Alternative Function

← Older revision		Revision as of 14:36, 7 January 2026
Line 88:		Line 88:
	==== '''Get Pin Alternative Function''' ====		==== '''Get Pin Alternative Function''' ====
	The same physical pin can be configured to different alternative function. A pin can have up to 4 alternative functions (ALT0 ~ ALT3), and ALT0 is the default one. You can get the current alternative function for specific pin with:<blockquote>		The same physical pin can be configured to different alternative function. A pin can have up to 4 alternative functions (ALT0 ~ ALT3), and ALT0 is the default one. You can get the current alternative function for specific pin with:<blockquote>
	gp alt [pin]		vgp alt [pin]
	</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number.		</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number.

Admin: /* GPIO */

2024-11-14T10:21:02Z

GPIO

← Older revision		Revision as of 10:21, 14 November 2024
Line 14:		Line 14:
	The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.		The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.

	~~[[File:The 40-pin header on Vivid Unit.png]]~~		<pic src="images/1/16/The_40-pin_header_on_Vivid_Unit.png" width="100%" align="text" caption=""></pic>

	<pic src="images/5/55/~~Gpio_header~~-~~1024x138~~.png" width="100%" align="text" caption=""></pic>

	The GPIOs are named like these:		The GPIOs are named like these:

Admin: /* GPIO */ update 40-pin header drawing

2024-11-14T10:19:56Z

GPIO: update 40-pin header drawing

← Older revision		Revision as of 10:19, 14 November 2024
Line 13:		Line 13:

	The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.		The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.

			[[File:The 40-pin header on Vivid Unit.png]]

	<pic src="images/5/55/Gpio_header-1024x138.png" width="100%" align="text" caption=""></pic>		<pic src="images/5/55/Gpio_header-1024x138.png" width="100%" align="text" caption=""></pic>

Admin: /* VGP in GUI (Graphical User Interface) */

2024-05-04T10:28:09Z

VGP in GUI (Graphical User Interface)

← Older revision		Revision as of 10:28, 4 May 2024
Line 144:		Line 144:
	You will see the interface that represents the 40-pin header:		You will see the interface that represents the 40-pin header:

	~~[[File:~~Vgp-1024x391.png]]		<pic src="images/f/f8/Vgp-1024x391.png" width="100%" align="text" caption=""></pic>

	The value of three ADC channels are also listed at the bottom, including the raw values (0~1023) and the voltage values. These values refresh for every second.		The value of three ADC channels are also listed at the bottom, including the raw values (0~1023) and the voltage values. These values refresh for every second.

Admin: /* GPIO and ADC on Vivid Unit */

2024-05-04T10:26:18Z

GPIO and ADC on Vivid Unit

← Older revision		Revision as of 10:26, 4 May 2024
Line 14:		Line 14:
	The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.		The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.

	~~[[File:Gpio header~~-1024x138.png]]		<pic src="images/5/55/Gpio_header-1024x138.png" width="100%" align="text" caption=""></pic>

	The GPIOs are named like these:		The GPIOs are named like these:
Line 34:		Line 34:

	[https://www.instructables.com/Measure-Low-Higher-and-Negative-Voltages-With-Vivi This tutorial] covers how to measure higher or negative voltage with Vivid Unit.		[https://www.instructables.com/Measure-Low-Higher-and-Negative-Voltages-With-Vivi This tutorial] covers how to measure higher or negative voltage with Vivid Unit.


	== '''VGP Utility''' ==		== '''VGP Utility''' ==

Admin: Fix GPIO naming picture

2024-05-04T10:24:09Z

Fix GPIO naming picture

← Older revision		Revision as of 10:24, 4 May 2024
Line 18:		Line 18:
	The GPIOs are named like these:		The GPIOs are named like these:

	~~[[File:GPIO naming-768x283~~.png]]		<pic src="images/b/be/vivid_unit_gpio_naming.png" width="100%" align="text" caption=""></pic>

	For the simplicity we use a short GPIO name for each GPIO pin. We put the bank number, the group name and the pin number in group together, to make the GPIO name.		For the simplicity we use a short GPIO name for each GPIO pin. We put the bank number, the group name and the pin number in group together, to make the GPIO name.

Admin: /* ADC */ add link to voltage measurement tutorial.

2024-03-07T20:11:42Z

ADC: add link to voltage measurement tutorial.

← Older revision		Revision as of 20:11, 7 March 2024
Line 32:		Line 32:

	It is safe to connect A0, A3 or A4 channel to any pin in the 40-pin GPIO header, because they can measure voltage up to 5V. If you want to measure voltage higher than 5V, you will need to implement an additional voltage divider.		It is safe to connect A0, A3 or A4 channel to any pin in the 40-pin GPIO header, because they can measure voltage up to 5V. If you want to measure voltage higher than 5V, you will need to implement an additional voltage divider.

			[https://www.instructables.com/Measure-Low-Higher-and-Negative-Voltages-With-Vivi This tutorial] covers how to measure higher or negative voltage with Vivid Unit.

	== '''VGP Utility''' ==		== '''VGP Utility''' ==

Admin: Created page with "= '''GPIO and ADC''' = == '''What is GPIO?''' == GPIO stands for Gerneral Purpose Input/Ouput. It usually refers to a set of pins on your computer’s mainboard or add-on boards. These pins are not designed for any specific purpose, and they can send or receive electrical signals. == '''What is ADC?''' == ADC stands for analog-to-digital converter. It is a system that converts an analog signal into a digital signal. It can be used to measure voltage and give the number..."

2024-01-12T09:47:14Z

Created page with "= '''GPIO and ADC''' = == '''What is GPIO?''' == GPIO stands for Gerneral Purpose Input/Ouput. It usually refers to a set of pins on your computer’s mainboard or add-on boards. These pins are not designed for any specific purpose, and they can send or receive electrical signals. == '''What is ADC?''' == ADC stands for analog-to-digital converter. It is a system that converts an analog signal into a digital signal. It can be used to measure voltage and give the number..."

New page

= '''GPIO and ADC''' =

== '''What is GPIO?''' ==
GPIO stands for Gerneral Purpose Input/Ouput. It usually refers to a set of pins on your computer’s mainboard or add-on boards. These pins are not designed for any specific purpose, and they can send or receive electrical signals.

== '''What is ADC?''' ==
ADC stands for analog-to-digital converter. It is a system that converts an analog signal into a digital signal. It can be used to measure voltage and give the numberic result.

== '''GPIO and ADC on Vivid Unit''' ==

=== '''GPIO''' ===
Vivid Unit comes with a 40-pin GPIO header, whose pinout is compatible with Raspberry Pi. There are two 5V power pins, two 3.3V power pins and 8 ground pins. The rest are I/O pins and they are all at 3.3V level.

The GPIOs are provided by RK3399, which has 5 banks (GPIO0 to GPIO4). Each bank has 4 groups (A, B, C and D) and each group has 8 pins (number 0~7). That makes 160 GPIOs in total, but only partial of them are routed to the 40-pin GPIO header.

[[File:Gpio header-1024x138.png]]

The GPIOs are named like these:

[[File:GPIO naming-768x283.png]]

For the simplicity we use a short GPIO name for each GPIO pin. We put the bank number, the group name and the pin number in group together, to make the GPIO name.

[[File:Gpio short name.png]]

For example, 2B5 is for GPIO2_B5, and 3C6 is for GPIO3_C6.

=== '''ADC''' ===
Vivid Unit also provides three 10-bit ADC channels (A0, A3 and A4). RK3399 provides ADC with 1.8V full-scale voltage, and Vivid Unit adds voltage divider and protection circuit (as shown below), to increase the full-scale voltage to 5V. The final resolution is 4.88mV.

[[File:Adc.png]]

It is safe to connect A0, A3 or A4 channel to any pin in the 40-pin GPIO header, because they can measure voltage up to 5V. If you want to measure voltage higher than 5V, you will need to implement an additional voltage divider.

== '''VGP Utility''' ==
VGP is an open-sourced application to control or monitor GPIOs and ADC channels on Vivid Unit. It contains two executables, one for command line interface (vgp) and the other for GUI enviroment (vgpw).

VGP is by default installed into the system. If it is not, you can always install it with:<blockquote>
sudo apt update

sudo apt install vgp
</blockquote>

=== '''VGP in CLI (Command Line Interface)''' ===

==== '''Overview of 40-Pin''' ====
If you want to get an overview of the GPIOs in the 40-pin header, you can run:<blockquote>
vgp list
</blockquote>It will list the GPIO information in a format that similar to the wiringPi:

[[File:Gpio list-600x523.png]]

The value and voltage of all ADC channels are also printed at the bottom.

==== '''List All GPIOs''' ====
If you want to list all GPIOs, even including those pins that are not brought out to the 40-pin header. You can run:<blockquote>
vgp all
</blockquote>It will list the name, alternate function, value and mode for all GPIO pins:

[[File:Gpio all-259x300.jpg]]

==== '''Get Pin Mode''' ====
If you want to get the current mode of a specifi pin, you can use:<blockquote>
vgp mode [pin]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number.

The result could be “IN” or “OUT”.

==== '''Set Pin Mode''' ====
If you want to set the mode of a specific pin, you can use:<blockquote>
vgp mode [pin] [mode]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number, and [mode] should be one of these value:

* IN
* in
* INPUT
* input
* OUT
* out
* OUTPUT
* output

The “IN”, “in”, “INPUT” and “input” are the same, while the “OUT”, “out”, “OUTPUT” and “output” are the same.

==== '''Get Pin Alternative Function''' ====
The same physical pin can be configured to different alternative function. A pin can have up to 4 alternative functions (ALT0 ~ ALT3), and ALT0 is the default one. You can get the current alternative function for specific pin with:<blockquote>
gp alt [pin]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number.

The result can be 0, 1, 2 or 3, which means ALT0, ALT1, ALT2, ALT3 accordingly.

==== '''Set Pin Alternative Function''' ====
You can also set alternative function for specific pin with:<blockquote>
vgp alt [pin] [alt]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number, and [alt] should be replaced with the alternative function (0, 1, 2 or 3).

==== '''Get Pin Value''' ====
To get value for given pin, you can use:<blockquote>
vgp get [pin]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number.

The result could be 1 (high) or 0 (low).

==== '''Set Pin Value''' ====
To set value for given pin, you may use:<blockquote>
vgp set [pin] [value]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number, and [value] should be 1 or 0.

==== '''Wait for Interrupt''' ====
If you wish to monitor the state of given pin, you may use:<blockquote>
vpg wfi [pin] [edge]
</blockquote>Here [pin] should be replaced with the GPIO name or physical pin number, and [edge] should be rising, falling or both.

This command will block until the state of the pin changes.

==== '''ADC''' ====
You can read the ADC result at specific chanel with:<blockquote>
vpg adc [channel]
</blockquote>Here [channel] should be 0 (for A0), 3 (for A3) or 4 (for A4). The result is a number (0~1023).

If you want to get voltage value, you may use:<blockquote>
vpg adc [channel] v
</blockquote>By adding a lower case letter v as the last argument, this command prints out the voltage value (for example 4.21).

If you want to print out the voltage value with the unit (V) together, you may use:<blockquote>
vgp adc [channel] V
</blockquote>By adding an upper case letter V as the last argument, this command prints out the voltage value with unit (for example 4.21V).

==== '''Get Help Information''' ====
If you need help during usage, you can run this command to get help information:<blockquote>
vgp --help
</blockquote>

=== '''VGP in GUI (Graphical User Interface)''' ===
You can click this icon in the task bar to run the GUI version of VGP.

[[File:Vgpw.png]]

Alternatively you can find the item “VGPW” in the “System” category in application menu. You may also run “vgpw” in command line terminal to launch the application.

You will see the interface that represents the 40-pin header:

[[File:Vgp-1024x391.png]]

The value of three ADC channels are also listed at the bottom, including the raw values (0~1023) and the voltage values. These values refresh for every second.

There is a “Flip” button at the bottom right corner, and you can click it to flip the view.

You can click the mode button for each pin to change its mode or alternative function. The possilbe mode/funtion could be IN, OUT, ALT1, ALT2 or ALT3.

When the mode is set to OUT, you may click the value button to toggle the pin’s value.

When the mode is set to IN, its value will get updated automatically when the pin is pulled up or down.