RZ-G/RZG kernel: Difference between revisions

From Renesas.info
No edit summary
(update gpioset)
(8 intermediate revisions by 2 users not shown)
Line 142: Line 142:
Also, the kernel source code contains a GPIO utility for user space. Please see directory tools/gpio/ in the kernel source code.
Also, the kernel source code contains a GPIO utility for user space. Please see directory tools/gpio/ in the kernel source code.


== GPIO Programming ==
== Character Device (/dev) Interface ==
=== Character device – user API (linux/gpio.h) : ===
* Access to GPIO pins can be made using the /dev driver interfaces.
The linux kernel is distributed with three basic user-mode tools written for testing the GPIO interface. The source can be found in linux/tools/gpio/.
* Official kernel documentation on this interface can be found here: https://docs.kernel.org/driver-api/gpio/using-gpio.html
The three tools are: <br>
* The Linux kernel is distributed with three basic user-mode tools written for testing the GPIO interface. The source can be found in linux/tools/gpio/.
a) lsgpio – example on how to list the GPIO lines on a system<br>
* The three tools are:
b) gpio-event-mon – monitor GPIO line events from userspace<br>
: 1) lsgpio – example on how to list the GPIO lines on a system
c) gpio-hammer- example to shake GPIO lines on a system<br>
: 2) gpio-event-mon – monitor GPIO line events from userspace
*Note:These are useful for debugging GPIO lines, but none of these tools will allow the user to configure, set and clear GPIO lines.<br>
: 3) gpio-hammer - example to shake GPIO lines on a system
However, you can use user API (chip info, line info, line request for values, reading values, setting values, line request for events, polling for events annd reading events) from linux/gpio.h to program GPIO. <br>
* Note: These are useful for debugging GPIO lines, but none of these tools will allow the user to configure, set and clear GPIO lines.
GPIO pin number for RZ/G2M/H/N/E is determined by using lsgpio:
* However, you can use the user API (chip info, line info, line request for values, reading values, setting values, line request for events, polling for events and reading events) from linux/gpio.h to program GPIO.
 
'''RZ/G2M/H/N/E Numbering'''
* GPIO pin number for '''RZ/G2M/H/N/E''' is determined by using the command line tool '''lsgpio''':
* The RZ/G2M/H/N/E have multiple gpiochip interfaces.
<pre>
<pre>
* GPIO chip: gpiochip6, "e6055400.gpio", 18 GPIO lines
GPIO chip: gpiochip6, "e6055400.gpio", 18 GPIO lines
         line  0: unnamed unused
         line  0: unnamed unused
         ....
         ....
Line 189: Line 193:
         line 17: unnamed unused
         line 17: unnamed unused
</pre>
</pre>
To access LED0, which is defined as GPIO5-19, you will use gpiochip5 chip and line 19.<br>
 
* RZ/G2L: Check board schematic to know the index of a pin (example P0_0, P43_0, ...). Then you will know the index of GPIO under Px_y (x: port number, y: pin number) is (8*x + y). Example P0_0 is 0, P5_1 is 41(8*5+1).<br>
* For example, to access LED0, which is defined as GPIO5-19, you will use gpiochip5 chip and line 19.
 
'''RZ/G2L Numbering'''
* For RZ/G2L, the port numbering in the hardware manual and schematics are P0_0, P43_0, etc...
* This shows you the port number and the pin number as '''Px_y''' (x: port number, y: pin number)
* The equation to find the corresponding global port number is: '''(8*x + y)'''
* For examples, P0_0 is 0 (8*0+0), P5_1 is 41 (8*5+1).
* The RZ/G2L has only 1 gpiochip interface.
<pre>
<pre>
GPIO chip: gpiochip0, "11030000.pin-controller", 392 GPIO lines
GPIO chip: gpiochip0, "11030000.pin-controller", 392 GPIO lines
Line 201: Line 212:
* Example: To access, P43_1, you need to use, gpiochip0 and line 345 (43*8 + 1)<br>
* Example: To access, P43_1, you need to use, gpiochip0 and line 345 (43*8 + 1)<br>
* [[Media:gpio_led_linux.zip| Sample Code]] to blink LED0(GPIO5-19) RZG2E RevC using linux/gpio.h API
* [[Media:gpio_led_linux.zip| Sample Code]] to blink LED0(GPIO5-19) RZG2E RevC using linux/gpio.h API
Note: To run, download the yocto SDK for RZG2E Rev C<br>
* Note: To run, download the source code. You also need to install the yocto SDK for RZG2E Rev C<br>
<pre>
<pre>
$ source /opt/poky/2.4.3/environment-setup-aarch64-poky-linux
$ source /opt/poky/2.4.3/environment-setup-aarch64-poky-linux
$ make
$ make
</pre>
</pre>
=== Using libgpiod : ===
 
Currently, in RZ/G GPIO driver, pin names are not exported so finding pin ID for a specific port name using gpiofind is not possible.<br>
== libgpiod – C library & tools ==
Also currently, the line number outputed from gpioinfo does not work as global pin ID.
* libgpiod is a C library and tools for interacting the Linux GPIO character device.
=== Using sysfs interface : ===
* To use libgpiod with RZ-G, in yocto, add the recipe to image. This can be done  in local.conf with
GPIO pin number for RZ/G2M/H/N/E is determined by:
<pre>
* GPIO_ID = GPIO Bank Address + Pin Number  
IMAGE_INSTALL_append = “ libgpiod libgpiod-tools”
</pre>
 
'''Command Line Tools:'''
 
1) '''gpiodetect''': To find out which GPIO banks and how many GPIO lines are available on the hardware<br>
*Ex: for RZG2E:
<pre>
root@ek874:~# gpiodetect
gpiochip6 [e6055400.gpio] (18 lines)
gpiochip5 [e6055000.gpio] (20 lines)
gpiochip4 [e6054000.gpio] (11 lines)
gpiochip3 [e6053000.gpio] (16 lines)
gpiochip2 [e6052000.gpio] (26 lines)
gpiochip1 [e6051000.gpio] (23 lines)
gpiochip0 [e6050000.gpio] (18 lines)
</pre>
* In case of RZG2E, you have 7 char devices, seven GPIO banks
2) '''gpioinfo''': List all lines of specified gpiochips, their names, direction, active state and additional flags<br>
<pre>
gpiochip1 - 23 lines:
        line  0:      unnamed  "interrupt"  input  active-high [kernel]
        line  1:      unnamed  "interrupt"  input  active-high [kernel]
        ....
        .... 
        line  22:      unnamed      unused  input  active-high
gpiochip0 - 18 lines:
        line  0:      unnamed      unused  input  active-high
        line  1:      unnamed      unused  input  active-high
        ....
        ....
        line  17:      unnamed      unused  input  active-high
</pre>
3) '''gpiofind''': Find the gpiochip name and line offset given the line name. For RZ/G, we do not have pin name export in driver, so we can not use pin name to find the pin line.
<br> <br>
4) '''gpioset''': Set the values of specified GPIO lines. gpioset expects the bank, gpiochip, GPIO line and the value to be set, 1 for HIGH and 0 for LOW active-high standard<br>
* ⚠ Note: gpioset (and all libgpiod apps) will '''revert the state''' of a GPIO line back to its '''original value when it exits'''. For this reason if you want the state to persist you need to instruct gpioset to wait for a signal and optionally detach and run in the background.<br>
Examples:
<pre>
gpioset  gpiochip5 3=1                              ### To set the line 3 of gpiochip5 to 1 (but it will also immediately go back to 0)
gpioset --mode=signal --background gpiochip5 19=1  ### Set the pin to 1, but continue to running in the background so the pin will stay 1
gpioset --mode=time –-sec=1 gpiochip0 328=0        ### toggle the pin for 1 sec
gpioset --mode=wait gpiochip0 328=0                ### toggle the pin and wait the user to press ENTER
</pre>
 
5) '''gpioget''': Read values of specified GPIO lines<br>
*Ex: read line 10 of gpiochip6
<pre>root@ek874:~# gpioget gpiochip6 10</pre>
* [[Media:gpio_led_libgpiod_rzg2l.zip| Sample Code]] using PMOD Module(https://store.digilentinc.com/pmod-led-four-high-brightness-leds/) and RZG2L
* Note: To run, download the source code. You also need to install the yocto SDK for RZG2L <br>
* [[Media:gpio_led_libgpiod.zip| Sample Code]] to blink LED0(GPIO5-19) RZG2E RevC using libgpiod API
* Note: To run, download the source code. You also need to install the yocto SDK for RZG2E Rev C<br>
<pre>
$ source /opt/poky/2.4.3/environment-setup-aarch64-poky-linux
$ make
</pre>
 
== Using sysfs interface ==
* GPIO pins can be configured, monitored and controller on the command line using the system (/sys) interface
 
<br>
 
'''RZ/G2M/H/N/E Numbering for sysfs'''
 
* GPIO pin number for RZ/G2M/H/N/E is determined by: '''GPIO_ID = GPIO Bank Address + Pin Number'''
<pre>
<pre>
       RZ/G2E              RZ/G2M/N/H
       RZ/G2E              RZ/G2M/N/H
Line 224: Line 299:
                       GPIO 7      356
                       GPIO 7      356
</pre>
</pre>
Example:<br>
 
*For RZ/G2E, GPIO number of GP5_19 is 398 + 19 = 417
* For example, on RZ/G2E, GPIO number of GP5_19 is 398 + 19 = 417
*Example: Turn on/off LED0 GP5_19 => gpio417 on RZ/G2E (Rev C) board<br>
* On the RZ/G2E (Rev C) board, to turn on/off LED0 GP5_19 => gpio417
NOTE: GP5_19 is defined as a GPIO LED0 in Device Tree. So you
* NOTE: GP5_19 is defined as a GPIO LED0 in Device Tree. So you need to either remove that from the Device Tree and reprogram the board, or you can remove it from device tree in uboot using fdt command. Below is the example using fdt.
need to either remove that from the Device Tree and reprogram the board, or <br>
you can remove it from device tree in uboot using fdt command. Below is the example using fdt
<pre>
<pre>
=> setenv gpioLED_1=fatload mmc 0:1 0x48080000 Image-ek874.bin; fatload mmc 0:1 0x48000000 Image-r8a774c0-ek874-revc-mipi-2.1.dtb
=> setenv gpioLED_1=fatload mmc 0:1 0x48080000 Image-ek874.bin; fatload mmc 0:1 0x48000000 Image-r8a774c0-ek874-revc-mipi-2.1.dtb
Line 236: Line 309:
=> setenv gpioLED_boot=run gpioLED_1 gpioLED_2 gpioLED_3
=> setenv gpioLED_boot=run gpioLED_1 gpioLED_2 gpioLED_3
=> setenv
=> setenv
Then run the command to boot
** Then run the command to boot
=> run gpioLED_boot
=> run gpioLED_boot
</pre>
</pre>
Now, lets turn on/off switch using sysfs:
* Now, lets turn on/off switch using sysfs:
<pre>
<pre>
root@ek874:~# echo 417 > /sys/class/gpio/export # request gpio417
root@ek874:~# echo 417 > /sys/class/gpio/export # request gpio417
Line 250: Line 323:
0
0
</pre>
</pre>
RZ/G2L Pin Decode :
 
GPIO pin number is determined by formula:
'''RZ/G2L Pin Numbering for sysfs'''
* GPIO_ID = GPIO_port * 8 + GPIO_pin + 120
 
Example:
* GPIO pin number is determined by formula: '''GPIO_ID = GPIO_port * 8 + GPIO_pin + 120'''
P42_4 has its id 460 with above formula (42 * 8 + 4 + 120).
* Note that there is a 120 value offset when using the sysfs interface that is not there when using the /dev or libgpio interface
* Example GPIO input function by using PMOD slide switch https://digilent.com/shop/pmod-swt-4-user-slide-switches/
* Example: '''P42_4''' has its id '''460''' with above formula ('''42 * 8 + 4 + 120''')
* For example, on the RZ/G2L EVK, using a GPIO as input by using PMOD slide switch https://digilent.com/shop/pmod-swt-4-user-slide-switches/
<pre>
<pre>
root@smarc-rzg2l:~# echo 460 > /sys/class/gpio/export
root@smarc-rzg2l:~# echo 460 > /sys/class/gpio/export

Revision as of 17:07, 19 August 2022

RZ-G

CPU Hotplug

You can enable and disable CPU cores by writing to a sysfs value.
This is helpful for when you want to experiment with the performance of your application if you were to use a processor with less CPU cores.

For example, this command will disable the 2nd core.

$ echo 0 > /sys/devices/system/cpu/cpu1/online

More detailed information can be found here: https://www.cyberciti.biz/faq/debian-rhel-centos-redhat-suse-hotplug-cpu


Power Saving

  • In Linux, this is a mechanism that is generally supported by all kernels.(it may depend on the version)
  • The Renesas kernel has support them.

About power consumption in RZ/G2 series, we have some supported features to save power cost in default environment:

  • CPUHotplug: Turn on/off CPU in runtime.
  • CPUIdle: Support 2 modes to turn off clock or power domain of CPU when CPU is idle (nothing to do).
    • Sleep mode: put in sleep state.
    • Core standby mode: put in shutdown state. It is described in devicetree of each SoC => It has deeper state than sleep mode so that save more power.
  • CPUFreq: there are 6 governors to support "Dynamic Frequency Scaling":
    • Performance: The frequency is always set maximum => It is using as default in our current environment.
    • Powersave: The frequency is always set minimum.
    • Ondemand: If CPU load is bigger than 95%, the frequency is set max. If CPU load is equal to or less than 95%, the frequency is set based on CPU load.
    • Conservative: If CPU load is bigger than 80%, the frequency is set one level higher than current frequency. If CPU load is equal to or less than 20%, the frequency is set one level lower than current frequency.
    • Userspace: It sets frequency which is defined by user in runtime.
    • Schedutil: Schedutil governor is driven by scheduler. It uses scheduler-provided CPU utilization information as input for making its decisions by formula: freq_next= 1.25 * freq_max* util_of_CPU.
  • Power Domain: it is supported as default by Linux Power Management Framework. If a module is not use, system will disable its clock and power domain automatically.

Therefore, select proper method will be based on user's purpose. Here are my examples:

  • Want to use with best performance: disable CPUIdle + use performance frequency governor.
  • Want to use less power: enable CPUIdle + use powersave frequency governor.
  • Want to balance performance and power: we can use schedutil.
  • Want to modify frequency as user's purpose: use userspance frequency governor.
  • If user is running realtime environment, I suggest using performance governor to ensure the minimum latency.

Here are some commands to check frequency value and frequency governor in linux:

  • Check available CPU frequency:
cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_available_frequencies
  • Check available CPU frequency governor:
cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_available_governors
  • Change to other governor:
echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor (performance/userspace/schedutil/...)
  • Check current frequency:
cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq

PMIC Access from Linux

The easiest way to access the PMIC registers from command line would would be to use i2ctools. Add the following line to your local.conf.

IMAGE_INSTALL_append = " i2c-tools"

However the PMICs are connected to a I2C (IIC for PMIC or I2C_DVFS) that is not enabled in the default kernel device tree. For the HiHope boards, you can edit the file arch/arm64/boot/dts/renesas/hihope-common.dtsi and add the following lines at the very bottom of the file.

&i2c_dvfs {
	status = "okay";
};

Once booted in Linux, the corresponding device should be /dev/i2c-7

You can query the connected slaves by giving the following command:

i2cdetect -y -r 7 

that on the RZ/G2E board produces the output:

0 1 2 3 4 5 6 7 8 9 a b c d e f 
00: -- -- -- -- -- -- -- -- -- -- -- -- -- 
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- 1e 1f 
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
70: -- -- -- -- -- -- -- --  

So two slaves, at address 0x1e and 0x1f. Finally you can read registers by simply using the i2cget command, for example:

i2cget -y 7 0x1e 0x1 
0x02 
i2cget -y 7 0x1e 0x16 
0x00 
i2cget -y 7 0x1e 0x17 
0xc4 

If you don't want (or can't) update the device tree blob, you could use u-boot to do it temporarily. The procedure below is valid for RZ/G2M but it works also with RZ/G2E-N-H by simply modifying the device tree blob and/or kernel image names.

1) Interrupt the normal kernel boot

2) Once in u-boot, enter the follow commands (after each RESET)

=> fatload mmc 0:1 0x48080000 Image; fatload mmc 0:1 0x48000000 Image-r8a774a1-hihope-rzg2m-ex.dtb;  
=> fdt addr 0x48000000 
=> fdt set /soc/i2c@e60b0000 status "okay"

and finally boot the kernel:

=> booti 0x48080000 - 0x48000000 

Create a uImage

In the kernel, there is no make target to make a uImage for the 64-bit ARM architecture like there is for 32-bit ARM. However, you can manually make one from the file Image.gz that is created by the kernel build system by using the following command on your host machine.

$ cd arch/arm64/boot
$ mkimage -A arm64 -O linux -T kernel -C gzip -a 0x48080000 -e 0x48080000 -n "Linux Kernel Image" -d Image.gz uImage

Below is an example of booting this image on a RZ/G2 HiHiope board from u-boot.

=> fatload mmc 0:1 0x88000000 uImage
=> fatload mmc 0:1 0x48000000 Image-r8a774e1-hihope-rzg2h-ex.dtb
=> bootm 0x88000000 - 0x48000000

Building mainline / LTS Linux kernel for RZ/G2E-N-M-H

The Verified Linux Package (VLP) includes the CIP kernel (v4.19.x) and this is the only official way to build a kernel that has all the features in. However it is possible to build a working kernel directly from mainline. The kernel built in this way does not provide most of the multimedia functionalities (e.g. GPU, codec, etc).

A recent Linaro toolchain is needed to build the kernel. The instructions below are for v5.10.x, newer kernel versions can be built as well in a similar way.

git clone https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git/
git checkout tags/v5.10.42

or anyway the latest minor revision including bug fixes.

Copy Renesas default kernel build into .out/.config:

cp arch/arm64/configs/renesas_defconfig .out/.config

or, if not present, get from the repository:

wget -O .out/.config https://git.kernel.org/pub/scm/linux/kernel/git/geert/renesas-drivers.git/plain/arch/arm64/configs/renesas_defconfig

If you want to be able to build modules:

echo CONFIG_MODULES=y >> .out/.config
echo CONFIG_MODULE_UNLOAD=y >> .out/.config

Run kernel configuration:

make O=.out menuconfig

Exit and save. Then launch the build:

make O=.out all -j$(nproc)

Renesas RZ/G2 PCIe Endpoint Driver

GPIO Pin Usage

Since linux-4.8 the GPIO sysfs interface is deprecated. User space should use the character device instead. The libgpiod library encapsulates the ioctl calls and data structures behind a straightforward API.

Also, the kernel source code contains a GPIO utility for user space. Please see directory tools/gpio/ in the kernel source code.

Character Device (/dev) Interface

  • Access to GPIO pins can be made using the /dev driver interfaces.
  • Official kernel documentation on this interface can be found here: https://docs.kernel.org/driver-api/gpio/using-gpio.html
  • The Linux kernel is distributed with three basic user-mode tools written for testing the GPIO interface. The source can be found in linux/tools/gpio/.
  • The three tools are:
1) lsgpio – example on how to list the GPIO lines on a system
2) gpio-event-mon – monitor GPIO line events from userspace
3) gpio-hammer - example to shake GPIO lines on a system
  • Note: These are useful for debugging GPIO lines, but none of these tools will allow the user to configure, set and clear GPIO lines.
  • However, you can use the user API (chip info, line info, line request for values, reading values, setting values, line request for events, polling for events and reading events) from linux/gpio.h to program GPIO.

RZ/G2M/H/N/E Numbering

  • GPIO pin number for RZ/G2M/H/N/E is determined by using the command line tool lsgpio:
  • The RZ/G2M/H/N/E have multiple gpiochip interfaces.
GPIO chip: gpiochip6, "e6055400.gpio", 18 GPIO lines
        line  0: unnamed unused
        ....
	....
        line 17: unnamed unused
GPIO chip: gpiochip5, "e6055000.gpio", 20 GPIO lines
        line  0: unnamed unused
        ....
	....
        line 19: unnamed unused [output]
GPIO chip: gpiochip4, "e6054000.gpio", 11 GPIO lines
        line  0: unnamed unused
        ....
	....
        line 10: unnamed unused
GPIO chip: gpiochip3, "e6053000.gpio", 16 GPIO lines
        line  0: unnamed unused
        ....
	....
        line 15: unnamed unused
GPIO chip: gpiochip2, "e6052000.gpio", 26 GPIO lines
        line  0: unnamed unused
        ....
	....
        line 25: unnamed "wlan-en-regulator" [kernel output]
GPIO chip: gpiochip1, "e6051000.gpio", 23 GPIO lines
        line  0: unnamed "interrupt" [kernel]
        ....
	....
        line 22: unnamed unused
GPIO chip: gpiochip0, "e6050000.gpio", 18 GPIO lines
        line  0: unnamed unused
        ....
	....
        line 17: unnamed unused
  • For example, to access LED0, which is defined as GPIO5-19, you will use gpiochip5 chip and line 19.

RZ/G2L Numbering

  • For RZ/G2L, the port numbering in the hardware manual and schematics are P0_0, P43_0, etc...
  • This shows you the port number and the pin number as Px_y (x: port number, y: pin number)
  • The equation to find the corresponding global port number is: (8*x + y)
  • For examples, P0_0 is 0 (8*0+0), P5_1 is 41 (8*5+1).
  • The RZ/G2L has only 1 gpiochip interface.
GPIO chip: gpiochip0, "11030000.pin-controller", 392 GPIO lines
        line  0: unnamed unused
        ....
        ....
        line 390: unnamed unused
        line 391: unnamed unused
  • Example: To access, P43_1, you need to use, gpiochip0 and line 345 (43*8 + 1)
  • Sample Code to blink LED0(GPIO5-19) RZG2E RevC using linux/gpio.h API
  • Note: To run, download the source code. You also need to install the yocto SDK for RZG2E Rev C
$ source /opt/poky/2.4.3/environment-setup-aarch64-poky-linux
$ make

libgpiod – C library & tools

  • libgpiod is a C library and tools for interacting the Linux GPIO character device.
  • To use libgpiod with RZ-G, in yocto, add the recipe to image. This can be done in local.conf with
IMAGE_INSTALL_append = “ libgpiod libgpiod-tools”

Command Line Tools:

1) gpiodetect: To find out which GPIO banks and how many GPIO lines are available on the hardware

  • Ex: for RZG2E:
root@ek874:~# gpiodetect
gpiochip6 [e6055400.gpio] (18 lines)
gpiochip5 [e6055000.gpio] (20 lines)
gpiochip4 [e6054000.gpio] (11 lines)
gpiochip3 [e6053000.gpio] (16 lines)
gpiochip2 [e6052000.gpio] (26 lines)
gpiochip1 [e6051000.gpio] (23 lines)
gpiochip0 [e6050000.gpio] (18 lines)
  • In case of RZG2E, you have 7 char devices, seven GPIO banks

2) gpioinfo: List all lines of specified gpiochips, their names, direction, active state and additional flags

gpiochip1 - 23 lines:
        line   0:      unnamed  "interrupt"   input  active-high [kernel]
        line   1:      unnamed  "interrupt"   input  active-high [kernel]
        ....
        ....  
        line  22:      unnamed       unused   input  active-high 
gpiochip0 - 18 lines:
        line   0:      unnamed       unused   input  active-high 
        line   1:      unnamed       unused   input  active-high 
        ....
        ....
        line  17:      unnamed       unused   input  active-high

3) gpiofind: Find the gpiochip name and line offset given the line name. For RZ/G, we do not have pin name export in driver, so we can not use pin name to find the pin line.

4) gpioset: Set the values of specified GPIO lines. gpioset expects the bank, gpiochip, GPIO line and the value to be set, 1 for HIGH and 0 for LOW active-high standard

  • ⚠ Note: gpioset (and all libgpiod apps) will revert the state of a GPIO line back to its original value when it exits. For this reason if you want the state to persist you need to instruct gpioset to wait for a signal and optionally detach and run in the background.

Examples:

gpioset  gpiochip5 3=1                              ### To set the line 3 of gpiochip5 to 1 (but it will also immediately go back to 0)
gpioset --mode=signal --background gpiochip5 19=1   ### Set the pin to 1, but continue to running in the background so the pin will stay 1
gpioset --mode=time –-sec=1 gpiochip0 328=0         ### toggle the pin for 1 sec
gpioset --mode=wait gpiochip0 328=0                 ### toggle the pin and wait the user to press ENTER

5) gpioget: Read values of specified GPIO lines

  • Ex: read line 10 of gpiochip6
root@ek874:~# gpioget gpiochip6 10
$ source /opt/poky/2.4.3/environment-setup-aarch64-poky-linux
$ make

Using sysfs interface

  • GPIO pins can be configured, monitored and controller on the command line using the system (/sys) interface


RZ/G2M/H/N/E Numbering for sysfs

  • GPIO pin number for RZ/G2M/H/N/E is determined by: GPIO_ID = GPIO Bank Address + Pin Number
       RZ/G2E              RZ/G2M/N/H
GPIO Bank   Address    GPIO Bank   Address
GPIO 0       494       GPIO 0       496              
GPIO 1       471       GPIO 1       467
GPIO 2       445       GPIO 2       452 
GPIO 3       429       GPIO 3       436
GPIO 4       418       GPIO 4       418
GPIO 5       398       GPIO 5       392
GPIO 6       380       GPIO 6       360
                       GPIO 7       356
  • For example, on RZ/G2E, GPIO number of GP5_19 is 398 + 19 = 417
  • On the RZ/G2E (Rev C) board, to turn on/off LED0 GP5_19 => gpio417
  • NOTE: GP5_19 is defined as a GPIO LED0 in Device Tree. So you need to either remove that from the Device Tree and reprogram the board, or you can remove it from device tree in uboot using fdt command. Below is the example using fdt.
=> setenv gpioLED_1=fatload mmc 0:1 0x48080000 Image-ek874.bin; fatload mmc 0:1 0x48000000 Image-r8a774c0-ek874-revc-mipi-2.1.dtb
=> setenv gpioLED_2=fdt addr 0x48000000 ; fdt rm /leds
=> setenv gpioLED_3=booti 0x48080000 - 0x48000000
=> setenv gpioLED_boot=run gpioLED_1 gpioLED_2 gpioLED_3
=> setenv
** Then run the command to boot
=> run gpioLED_boot
  • Now, lets turn on/off switch using sysfs:
root@ek874:~# echo 417 > /sys/class/gpio/export # request gpio417
root@ek874:~# echo out > /sys/class/gpio/gpio417/direction # set gpio417 (GP5_19) output
root@ek874:~# echo 1 > /sys/class/gpio/gpio417/value # turn ON LED0
root@ek874:~# cat /sys/class/gpio/gpio417/value 
1
root@ek874:~# echo 0 > /sys/class/gpio/gpio417/value # turn OFF LED0
root@ek874:~# cat /sys/class/gpio/gpio417/value 
0

RZ/G2L Pin Numbering for sysfs

  • GPIO pin number is determined by formula: GPIO_ID = GPIO_port * 8 + GPIO_pin + 120
  • Note that there is a 120 value offset when using the sysfs interface that is not there when using the /dev or libgpio interface
  • Example: P42_4 has its id 460 with above formula (42 * 8 + 4 + 120)
  • For example, on the RZ/G2L EVK, using a GPIO as input by using PMOD slide switch https://digilent.com/shop/pmod-swt-4-user-slide-switches/
root@smarc-rzg2l:~# echo 460 > /sys/class/gpio/export
root@smarc-rzg2l:~# echo in > /sys/class/gpio/gpio460/direction 
root@smarc-rzg2l:~# cat /sys/class/gpio/gpio460/value 
1
root@smarc-rzg2l:~# cat /sys/class/gpio/gpio460/value # after switch off
0