RZ-G/RZG kernel: Difference between revisions

From Renesas.info
No edit summary
Line 206: Line 206:
$ make
$ make
</pre>
</pre>
=== Using libgpiod : ===
=== libgpiod – C library & tools for GPIO chardev : ===
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>
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>
Also currently, the line number outputed from gpioinfo does not work as global pin ID.
Also currently, the line number outputed from gpioinfo does not work as global pin ID.
=== Using sysfs interface : ===
=== Using sysfs interface : ===
GPIO pin number for RZ/G2M/H/N/E is determined by:
GPIO pin number for RZ/G2M/H/N/E is determined by:

Revision as of 20:17, 3 February 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.

GPIO Programming

Character device – user API (linux/gpio.h) :

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:
a) lsgpio – example on how to list the GPIO lines on a system
b) gpio-event-mon – monitor GPIO line events from userspace
c) 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 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.

  • GPIO pin number for RZ/G2M/H/N/E is determined by using lsgpio:
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

To access LED0, which is defined as GPIO5-19, you will use gpiochip5 chip and line 19.

  • 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).
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 for GPIO chardev :

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.
Also currently, the line number outputed from gpioinfo does not work as global pin ID.

Using sysfs interface :

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

Example:

  • For 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

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 Decode : GPIO pin number is determined by formula:

  • GPIO_ID = GPIO_port * 8 + GPIO_pin + 120

Example: P42_4 has its id 460 with above formula (42 * 8 + 4 + 120).

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