Device Tree and Device Drivers
This page contains helpful notes about Device Tree configurations and Device Driver details.
Table of Contents
- 1 BSP Manual Set
- 2 RZ Evaluation Board Device Tree Files
- 3 SoC IDs
- 4 Device Tree Learning Resources
- 5 Print a Compiled DTB Output File
- 6 Use DTC to modify a Device Tree Source without Yocto
- 7 Top Level (root node)
- 8 Clocks and Resets (CPG)
- 9 Pin Control (pin mux)
- 10 GPIO Examples
- 11 IRQ0-7
- 12 Display
- 13 Audio
- 14 Camera
- 15 Ethernet
- 16 PCIe
- 17 USB
- 18 SD Card
- 19 eMMC
- 20 DMA
- 21 I2C
- 22 SPI
- 23 QSPI Flash
- 24 UART (SCIF)
- 25 UART (SCI)
- 26 CAN
- 27 ADC
- 28 Watchdog Timer(WDT)
- 29 PWM
- 30 Timer
- 31 Thermal
- 32 PMIC RAA215300
BSP Manual Set
Documentation for the Linux Device Drivers contained in the Renesas BSP releases are released in a package called the "BSP Manual Set".
Use the links below for the SoC that you are using.
RZ/G2L, RZ/V2L, RZ/Five : https://www.renesas.com/document/oth/rzg2l-group-bsp-manual-set
RZ/G2H, RZ/G2M, RZ/G2N, RZ/G2E : https://www.renesas.com/en/document/mas/rzg2-group-bsp-manual-set-rtk0ef0045z9002azj-v302zip
RZ/G3S : https://www.renesas.com/en/document/mas/rzg3s-group-bsp-manual-set-rtk0ef0045z96001zjv301zip
RZ/V2H, RZ/V2N : https://www.renesas.com/en/document/mas/rzv2h-and-rzv2n-bsp-manual-set-rtk0ef0045z94001azj-v103zip
RZ Evaluation Board Device Tree Files
Device Tree files for Renesas SoC and evaluation boards are under the directory arch/arm64/boot/dts/renesas/
Below is the list of Device Tree files used for the Renesas Evaluation boards.
Because the evaluation kits share common boards, and have many different test/demo configurations, there are many include files (.dtsi) for any single device tree (.dts) build. For your custom board, you might only need your Device Tree for your board (my_board.dst) and that will only #include one other file which will be the base SoC file (RZ/G2H for example will #include "r8a774e1.dtsi").
RZ board names that end in "-dev" are internal Renesas boards. While their Device Trees files appear in the BSP, they are not mainlined.
If you want to see a list of which peripheral nodes are set in each dtsi file, you can use this "dts_parser" tool below. For example, you want to find all the the .dtsi files that configure the i2c channels because you are looking for examples.
RZ/G3 Series
RZ/G2 Series
RZ/V2 Series
SoC IDs
File in mainline that defines Renesas SoC IDs
Device Tree Documentation: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/devicetree/bindings/soc/renesas/renesas.yaml
Compatible lookup: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/drivers/soc/renesas/renesas-soc.c
Example of tables below:
SoC | CONFIG | .compatible = | pfc | Device Tree | Misc |
|---|---|---|---|---|---|
RZ/G2H | CONFIG_ARCH_R8A774E1 | "renesas,r8a774e1" | pfc-r8a7795.c | r8a774a1.dtsi |
|
.
.