4、设备树(DT)

一、概述

​ 在传统 Linux 内核中，ARM 架构的板极硬件细节过多地被硬编码在 arch/arm/plat-xxx 和arch/arm/mach-xxx，比如板上的 platform 设备、resource、i2c_board_info、spi_board_info 以及各种硬件的 platform_data，这些板级细节代码对内核来讲只不过是垃圾代码。而采用Device Tree 后，许多硬件的细节可以直接透过它传递给 Linux，而不再需要在 kernel 中进行大量的冗余编码。导致 ARM 的 merge 工作量较大。之后经过一些讨论，对 ARM 平台的相关 code 做出如下相关规范调整，这个也正是引入DTS 的原因。

1、ARM 的核心代码仍然保存在 arch/arm 目录下

2、ARM SoC core architecture code 保存在 arch/arm 目录下

3、ARM SOC 的周边外设模块的驱动保存在 drivers 目录下

4、ARM SOC 的特定代码在 arch/arm/mach-xxx 目录下

5、ARM SOC board specific 的代码被移除，由 DeviceTree 机制来负责传递硬件拓扑和硬件资源信息。

​ 本质上，Device Tree改变了原来用 code方式将硬件配置信息嵌入到内核代码的方法，改用 bootloader 传递一个 DB 的形式。对于嵌入式系统，在系统启动阶段，bootloader 会加载内核并将控制权转交给内核，此外，还需要把上述的三个参数信息传递给 kernel，以便 kernel可以有较大的灵活性。在linux kernel 中，Device Tree 的设计目标就是如此。

在 devie tree 中，可描述的信息包括：

1、CPU 的数量和类别

2、内存基地址和大小

3、总线和桥

4、外设连接

5、中断控制器和中断的使用情况

6、GPIO 控制器和 GPIO 使用情况

7、clock 控制器和 clock 使用情况

​ 它基本就是一棵电路板上的 CPU、总线、设备组成的树，Bootloader 会将这棵树传递给内核，然后内核来识别这棵树，并根据它展开出 Linux 内核中的 platform_device、i2c_client、spi_device 等设备，而这些设备用到的内存、IRQ 等资源，也被传递给内核，内核会将这些资源绑定给展开的相应设备。Linux 内核从 3.x开始引入设备树的概念，用于实现驱动代码与设备信息相分离。在设备树出现以前，所有关于设备的具体信息都要写在驱动里，一旦外围设备变化，驱动代码就要重写。引入了设备树之后，驱动代码只负责处理驱动的逻辑，而关于设备的具体信息存放到设备树文件中，这样，如果只是硬件接口信息的变化而没有驱动逻辑的变化，驱动开发者只需要修改设备树文件信息，不需要改写驱动代码。比如在ARM Linux内，一个.dts(device treesource)文件对应一个 ARM 的 machine，一般放置在内核的"arch/arm/boot/dts/“目录内，比如stmp1a-dk1 参考板的板级设备树文件就是"arch/arm/boot/dts/ stm32mp157a-dk1.dts”。这个文件可以通过 make dtbs 命令编译成二进制的.dtb 文件供内核驱动使用。基于同样的软件分层设计的思想，由于一个 SoC 可能对应多个 machine，如果每个 machine 的设备树都写成一个完全独立的.dts 文件，那么势必相当一些.dts 文件有重复的部分，为了解决这个问题，Linux 设备树目录把一个 SoC 公用的部分或者多个 machine 共同的部分提炼为相应的.dtsi文件。这样每个.dts就只有自己差异的部分，公有的部分只需要"include"相应的.dtsi 文件, 这样就是整个设备树的管理更加有序。我这里用 Linux4.19.94 源码自带的 goodixtouchscreen 触摸芯片为例来分析设备树的使用和移植。这个触摸芯片的设备树节点信息在"Documentation/devicetree/bindings/input/touchscreen/goodix.txt"有详细说明，其驱动源码是" drivers/input/touchscreen/goodix.c"。

二、基本知识

dts

硬件的相应信息都会写在.dts 为后缀的文件中，每一款硬件可以单独写一份例如stm32mp157a-dk1.dts，一般在 Linux 源码中存在大量的 dts 文件，对于 arm 架构可以在 arch/arm/boot/dts 找到相应的 dts，一个 dts 文件对应一个 ARM 的 machie。

dtsi

值得一提的是，对于一些相同的 dts配置可以抽象到 dtsi文件中，然后类似于 C语言的方式可以 include 到 dts 文件中，对于同一个节点的设置情况，dts 中的配置会覆盖dtsi 中的配置。

dtc

dtc 是编译 dts 的工具，可以在 Ubuntu 系统上通过指令 apt-get install device-tree-compiler 安装 dtc 工具，不过在内核源码 scripts/dtc 路径下已经包含了 dtc 工具；

dtb

dtb(Device Tree Blob)，dts 经过 dtc 编译之后会得到 dtb 文件，dtb 通过 Bootloader 引导程序加载到内核。所以 Bootloader 需要支持设备树才行；Kernel 也需要加入设备树的支持；

​ **那么 DTS 和 DTB 这两个文件是什么关系呢？ DTS 是设备树源码文件， DTB 是将DTS 编译以后得到的二进制文件。将.c 文件编为.o 需要用到 gcc 编译器，那么将.dts 编译为.dtb需要用到 DTC 工具！ DTC 工具源码在 Linux 内核的 scripts/dtc 目录下 **

scripts/dtc/Makefile 文件内容如下： (逐行解析)

# SPDX-License-Identifier: GPL-2.0
# scripts/dtc makefile
/*:= 与 = 的区别：:
	：=（立即展开/简单赋值）:
当你使用 := 进行赋值时，右边的值会立即计算并赋值给左边的变量。
换句话说，右边的表达式会在赋值时立即展开并计算，然后结果被固定下来，不会在后续引用时重新计算。
	=（延迟展开/递归赋值）:
当你使用 = 进行赋值时，右边的表达式不会立即计算，而是被存储为原始的字符串。当这个变量在以后被引用时，Makefile 会重新展开并计算其值。因此，= 赋值的变量在每次被使用时都可能获得不同的值，具体取决于其他变量或规则的变化。*/
hostprogs-$(CONFIG_DTC) := dtc    
/*根据 CONFIG_DTC 的值来决定是否编译 dtc 工具，如果 CONFIG_DTC 被设置为 y（启用），$(CONFIG_DTC) 会被替换为 y，因此表达式变为 hostprogs-y。hostprogs-y 是一个特殊的 Makefile 变量，表示构建过程中需要生成的主机程序（host programs）。通过 :=，dtc 被赋值给 hostprogs-y，即在编译时，dtc 将作为主机程序被生成*/
always		:= $(hostprogs-y)	
/*这行代码将 hostprogs-y 的值赋给 always 变量always 是一个自定义的变量名，在这里它被用来确保 hostprogs-y 中定义的程序（即 dtc）始终被编译。这意味着只要 hostprogs-y 中有内容（在本例中就是 dtc），always 变量就会包含这些内容。*/
dtc-objs	:= dtc.o flattree.o fstree.o data.o livetree.o treesource.o \
		   srcpos.o checks.o util.o
dtc-objs	+= dtc-lexer.lex.o dtc-parser.tab.o
/*可以看出， DTC 工具依赖于 dtc.c、 flattree.c、 fstree.c 等文件，最终编译并链接出 DTC 这个主机文件*/

​ 可以看出， DTC 工具依赖于 dtc.c、 flattree.c、 fstree.c 等文件，最终编译并链接出 DTC 这个主机文件。如果要编译 DTS 文件的话只需要进入到 Linux 源码根目录下，然后执行如下命令：
​ make all
或者：
​ make dtbs
​ “make all”命令是编译 Linux 源码中的所有东西，包括 uImage， .ko 驱动模块以及设备树，如果只是编译设备树的话建议使用“make dtbs”命令，“make dtbs”会编译选中的所有设备树文件。如果只要编译指定的某个设备树，比如 ST 官方编写的“stm32mp157d-ed1.dts”，
可以输入如下命令：
​ make stm32mp157d-ed1.dtb

​ 基于 ARM 架构的 SOC 有很多种，一种 SOC 又可以制作出很多款板子，每个板子都有一个对应的 DTS 文件，那么如何确定编译哪一个 DTS 文件呢？我们就以 STM32MP1 这款芯片对应的板子为例来看一下，打开 arch/arm/boot/dts/Makefile，有如下内容：

​ 可以看出，当选中 STM32MP1 这个 SOC 以后(CONFIG_ARCH_STM32=y)，所有使用到STM32MP1 这个 SOC 的板子对应的.dts 文件都会被编译为.dtb。如果我们使用 STM32MP1 新做了一个板子，只需要新建一个此板子对应的.dts 文件，然后将对应的.dtb 文件名添加到 dtb-$( CONFIG_ARCH_STM32)下，这样在编译设备树的时候就会将对应的.dts 编译为二进制的.dtb 文件。

1、dts结构

property 特性

/dts-v1/;  // /是根节点
 / {
     node1 {     // 子节点
         a-string-property = "A string";  // 节点属性
         a-string-list-property = "first string", "second string";
         // hex is implied in byte arrays. no '0x' prefix is required
         a-byte-data-property = [01 23 34 56];
         child-node1 {
             first-child-property;
             second-child-property = <1>;
             a-string-property = "Hello, world";
         };
         child-node2 {
             
         };
     };
     node2 {
         an-empty-property;
         a-cell-property = <1 2 3 4>; /* each number (cell) is a uint32 */
         child-node1 {
         };
     };
 };

​ device tree 的基本单元是 node。这些 node 被组织成树状结构，除了 root node，每个 node都只有一个 parent。一个 device tree 文件中只能有一个 root node。每个 node 中包含了若干的property/value 来描述该 node 的一些特性。每个 node 用节点名字（node name）标识，节点名字的格式是node-name@unit-address。如果该node没有reg属性（后面会描述这个property），那么该节点名字中必须不能包括@和 unit-address。unit-address 的具体格式是和设备挂在那个bus 上相关。例如对于 cpu，其 unit-address 就是从 0 开始编址，以此加一。而具体的设备，例如以太网控制器，其 unit-address 就是寄存器地址。root node 的 node name 是确定的，必须是“/”。也就是说设备树源文件的结构为:

• 1 个 root 节点”/”;
• root 节点下面含一系列子节点，“node1” and “node2”
• 节点 node1 和下又含有一系列子节点，“child-node1” and “child-node2”
• 各个节点都有一系列属性
• 这些属性可能为空，如 an-empty-property
• 可能为字符串，如 a-string-property
• 可能为字符串树组，如 a-string-list-property
• 可能为 Cells（由 u32 整数组成），如 second-child-property

2、dts语法

​ 在.dts 设备树文件中，可以通过“#include”来引用.h、 .dtsi 和.dts 文件。只是，我们在编写设备树头文件的时候最好选择.dtsi 后
缀 。

​ 在 linux kernel 中，扩展名是 dts 的文件就是描述硬件信息的 device tree source file，在dts 文件中，一个 node 被定义成如下格式：

 [label:] node-name[@unit-address] {
     [properties definitions]
     [child nodes]
 }

引入 label 的目的就是为了方便访问节点，可以直接通过&label 来访问这个节点，比如通过&cpu0 就可以访问“cpu@0”这个节点，而不需要输入完整的节点名字。再比如节点 “sram:sram@10000000”，节点 label 是 sram，而节点名字就很长了，为“sram@10000000”。很明显通
过&sram 来访问“sram@10000000”这个节点要方便很多！

gpu_reserved: 就是前面说的lable,方便其他位置引用。

设备树调用关系⬆

3、dts组成

compatible

每一个 dts 文件都是由一个 root 的根节点组成，内核通过根节点“/”的兼容性即可判断它启动的是什么设备，其代码结构如下:

/ {
     model = "HQYJ FS-MP1A Discovery Board";
     compatible = "st,stm32mp157a-dk1", "st,stm32mp157", "hqyj,fsmp1a";
    /*这样我们的设备就有三个属性值，这个设备首先使用第一个兼容值在 Linux 内核里面查找，看看能不能找到与之匹配的驱动文件，如果没有找到的话就使用第二个兼容值查，以此类推，直到查找完 compatible 属性中的所有值。*/
     aliases {
         ethernet0 = &ethernet0;
         serial0 = &uart4;
         serial5 = &usart3;
     };
    
     chosen {
         stdout-path = "serial0:115200n8";
     };
     ... ...
 };

​ model 属性值是，它指定制造商的设备型号。推荐的格式是：“manufacturer，model”，其中 manufacturer 是一个字符串描述制造商的名称，而型号指定型号。

​ compatible 属性值是,指定了系统的名称，是一个字符串列表，它包含了一个“<制造商>,<型号>”形式的字符串。重要的是要指定一个确切的设备，并且包括制造商的名字，以避免命名空间冲突。

​ chosen 节点不代表一个真正的设备，但功能与在固件和操作系统间传递数据的地点一样，如根参数，取代以前 bootloader 的启动参数，控制台的输入输出参数等。

#address-cells 和#size-cells

​ #address-cells = <1>: 基地址、片选号等绝对起始地址所占字长，单位 uint32。

​ #size-cells = <1>: 长度所占字长，单位 uint32。

/ {
    #address-cells = <0x1>; //在 root node下使用1个u32来代表address。
    #size-cells = <0x0>; // 在root node下使用0个u32来代表size。
    ...
    ...
    memory {        // memory device
        ...
        reg = <0x90000000>;
            // 0x90000000是存取memory的address
        ...
    };
    ...
    ...
}

/ {
    #address-cells = <0x1>; //在root node下使用1个u32来代表address。
    #size-cells = <0x1>; //在root node下使用1个u32来代表size。
    ...
    ...
    memory { // memory device
        ...
        reg = <0x90000000 0x800000>;
            // 0x90000000 是存取 memory 的 address
            // 0x800000 是 memory 的 size。
        ...
    };
    ...
    ...
}

/ {
    #address-cells = <0x2>; // 在root node下使用2个u32来代表address。
    #size-cells = <0x1>; // 在root node下使用1个u32来代表size。
    ...
    ...
    memory { // memory device
        ...
        reg = <0x90000000 00000000 0x800000>;
            // 0x90000000 00000000 是存取memory的address
            // 0x800000 是memory的size。
        ...
    };
    ...
    ...
}

/ {
    #address-cells = <0x2>; // 在root node下使用2个u32来代表address。
    #size-cells = <0x2>; // 在root node下使用2个u32来代表size。
    ...
    ...
    memory { // memory device
        ...
        reg = <0x90000000 00000000 0x800000 00000000>;
            // 0x90000000 00000000 是存取memory的address
            // 0x800000 00000000 是memory的size。
        ...
    };
    ...
    ...
}

reg

​ reg 属性前面已经提到过了， reg 属性的值一般是(address， length)对。 reg 属性一般用于描述设备地址空间资源信息或者设备地址信息，比如某个外设的寄存器地址范围信息，或者 IIC器件的设备地址等，比如在 stm32mp151.dtsi 中有如下内容：

uart5: serial@40011000 {
    compatible = "st,stm32h7-uart";
    reg = <0x40011000 0x400>;
	interrupts-extended = <&exti 31 IRQ_TYPE_LEVEL_HIGH>;
	clocks = <&rcc UART5_K>;
	resets = <&rcc UART5_R>;
	wakeup-source;
	power-domains = <&pd_core>;
	dmas = <&dmamux1 65 0x400 0x5>,
	<&dmamux1 66 0x400 0x1>;
    dma-names = "rx", "tx";
	status = "disabled";
};

​ uart5 节点描述了 stm32mp1 系列芯片的 UART5 相关信息，重点是第 578 行的 reg 属性。由于 uart5 的父节点“ soc”设置了#address-cells = <1>、 #size-cells = <1>，因此 reg 属性中address=0x40011000， length=0x400。查阅《STM32MP157 参考手册》可知， stm32mp157 芯片的UART5 寄存器首地址为 0x40011000，但是 UART5 的地址长度(范围)并没有 0x400 这么多，这里我们重点是获取 UART5 寄存器首地址 。

CPU addressing

​ 寻址时，CPU 节点代表了最简单的情况。 每个 CPU 都分配有一个唯一的 ID，并且没有与 CPU ID 相关联的大小。

cpus {
     #address-cells = <1>;
     #size-cells = <0>;

     cpu0: cpu@0 {
         compatible = "arm,cortex-a7";
         device_type = "cpu";
         reg = <0>;
         clocks = <&rcc CK_MPU>;
         clock-names = "cpu";
         operating-points-v2 = <&cpu0_opp_table>;
         nvmem-cells = <&part_number_otp>;
         nvmem-cell-names = "part_number";
     };

     cpu1: cpu@1 {
         compatible = "arm,cortex-a7";
         device_type = "cpu";
         reg = <1>;
         clocks = <&rcc CK_MPU>;
         clock-names = "cpu";
         operating-points-v2 = <&cpu0_opp_table>;
     };
 };

​ 在 cpus 节点，#address-cells 被设置成了 1，#size-cells 被设置成了 0。这是说子 reg 值是单独的 uint32，它用无大小字段表示地址。在此情况下，这两个 cpu 分配到的地址为 0和 1。cpu 节点的#size-cells 是 0 因为每个 cpu 只分配到了一个单独的地址。你仍然需要注意 reg 值需要与节点名的值相匹配。按照惯例，如果一个节点有一个 reg属性，那么这个节点名称必须包括 unit-address,这是 reg 属性的第一个 address 值。

Memory Mapped Devices

​ 与在 cpu节点中单独的 address 值不同，内存映射设备被分配了一系列将要响应的地址，因此不仅需要包含内存的基地址而且还需要映射地址的长度，因此需要使用#size-cells 用来表示在每个子 reg 元组中长度字段的大小。在以下示例中，每个 address 值为 1 cell(32 bits),每个长度值也是 1 cell,这在 32 bit 系统是比较典型的。64 bit 设备也许会为#address-cells 和#sizecells 使用数值 2，在 device tree 中获取 64 bit addressing。

注：寄存器地址表见 ./download/STM32MP157-datasheet.pdf

/dts-v1/;
 / {
     #address-cells = <1>;
     #size-cells = <1>;
     ...
     timers2: timer@40000000 { /*设备的地址或寄存器首地址*/
         compatible = "st,stm32-timers";
         reg = <0x40000000 0x400>;
     };
 
    timers3: timer@40001000 {
         compatible = "st,stm32-timers";
         reg = <0x40001000 0x400>;
     };

     spi2: spi@4000b000 {
         compatible = "st,stm32h7-spi";
         reg = <0x4000b000 0x400>;
     };

     uart7: serial@40018000 {
         compatible = "st,stm32h7-uart";
         reg = <0x40018000 0x400>;
     };

     sai1: sai@4400a000 {
         compatible = "st,stm32h7-sai";
         reg = <0x4400a000 0x4>;
     };
     ...    
 };

Non Memory Mapped Devices

​ 处理器总线的其它设备为非内存映射设备。他们有地址范围，但不能被 CPU 直接寻址。母设备的驱动程序将代替 CPU 进行间接访问。以 i2c 设备为例，每个设备都分配了一个地址，但没有长度或范围与之相匹配。这与 CPU 地址分配很相似。

etf: etf@50092000 {
     compatible = "arm,coresight-tmc", "arm,primecell";
     reg = <0x50092000 0x1000>;
     clocks = <&rcc CK_TRACE>;
     clock-names = "apb_pclk";

     ports {
         #address-cells = <1>;
         #size-cells = <0>;
        
         port@0 {
             reg = <0>;
             etf_in_port: endpoint {
                 slave-mode;
                 remote-endpoint = <&funnel_out_port0>;
             };
         };

         port@1 {
         	reg = <0>;
             etf_out_port: endpoint {
                 remote-endpoint = <&tpiu_in_port>;
             };
         };
     };
 };

​ 前面已经讨论过如何向设备分配地址，但此时这些地址只是本地设备节点，还没有说明如何从那些地址里映射到 cpu 可以使用的地址。根节点经常描述地址空间的 CPU 视图。根节点的子节点已经使用了 CPU 的 address domain，所以不需要任何明确的映射。例如，serial@101f0000 设备被直接分配了地址 0x101f0000。根节点的非直接子节点是无法使用 CPU 的 address domain 的。

ranges

为了在 deivce tree 获取内存映射地址必须指定如何从一个域名将地址转换到另一个。Ranges 属性就用于此目的。以下是添加了 ranges 属性的 device tree 示例。

m4_rproc: m4@0 {
    compatible = "st,stm32mp1-rproc";
    #address-cells = <1>;
    #size-cells = <1>;
    ranges = <0x00000000 0x38000000 0x10000>,
            <0x30000000 0x30000000 0x60000>,
            <0x10000000 0x10000000 0x60000>;
    resets = <&rcc MCU_R>;
    reset-names = "mcu_rst";
    st,syscfg-pdds = <&pwr 0x014 0x1>;
    st,syscfg-holdboot = <&rcc 0x10C 0x1>;
    st,syscfg-tz = <&rcc 0x000 0x1>;
    st,syscfg-rsc-tbl = <&tamp 0x144 0xFFFFFFFF>;
    status = "disabled";
    m4_system_resources {
        compatible = "rproc-srm-core";
        status = "disabled";
    };
};

ranges 是一个地址转换列表。每个输入 ranges 表格的是包含子地址的元组，母地址和子地址空间的范围大小。每个字段的大小都由获取的子地址的#address-cells 值，母地址的#address-cell 值和子地址的#size-cells 值而定。

child-bus-address：子总线地址空间的物理地址，由父节点的#address-cells 确定此物理地址所占用的字长。
parent-bus-address： 父总线地址空间的物理地址，同样由父节点的#address-cells 确定此物理地址所占用的字长。
length： 子地址空间的长度，由父节点的#size-cells 确定此地址长度所占用的字长。

以外部总线为例，子地址是 2 cells，母地址是 1 cell,大小也为 1 cell。

​ 如果 ranges 属性值为空值，说明子地址空间和父地址空间完全相同，不需要进行地址转换，对于我们所使用的 stm32mp157 来说，子地址空间和父地址空间完全相同，因此会在stm32mp151.dtsi 中找到大量的值为空的 ranges 属性，如下所示：

soc {
	compatible = "simple-bus";
	#address-cells = <1>;
	#size-cells = <1>;
	interrupt-parent = <&intc>;
	ranges;
......
};

ranges 属性不为空的示例代码如下所示

soc {
    compatible = "simple-bus";
    #address-cells = <1>;
    #size-cells = <1>;
    interrupt-parent = <&intc>;
    ranges = <0 0x10000000 0x100000>;
   
    sram: sram@10000000 {
        compatible = "mmio-sram";
        reg = <0x0 0x60000>;
        #address-cells = <1>;
        #size-cells = <1>;
        ranges = <0 0x10000000 0x60000>;
    };
    serial {
        device_type = "serial";
        compatible = "ns16550";
        reg = <0x4600 0x100>;
        clock-frequency = <0>;
        interrupts = <0xA 0x8>;
        interrupt-parent = <&ipic>;
    };
};

第 6 行，节点 soc 定义的 ranges 属性，值为<0 0x10000000 0x100000>，此属性值指定了一个 1024KB(0x100000)的地址范围，子地址空间的物理起始地址为 0，父地址空间的物理起始地址为 0x10000000

第 8 行， sram 是 STM32MP1 内部 RAM 节点， reg 属性定义了 sram 设备寄存器的起始地址为 0，寄存器长度为 0x60000。经过地址转换， sram 设备可以从 0x10000000 开始进行读写操作，0x10000000=0x0 + 0x10000000。

serial 是串口设备节点，reg 属性定义了 serial 设备寄存器的起始地址为 0x4600，寄存器长度为 0x100。经过地址转换， serial 设备可以从 0xe0004600 开始进行读写操作，0xe0004600=0x4600+0xe0000000。

status

​ device tree 中的 status 标识了设备的状态，使用 status 可以去禁止设备或者启用设备，看下设备树规范中的 status 可选值。

中断映射

​ 与遵循树的自然结构而进行的地址转换不同，机器上的任何设备都可以发起和终止中断信号。另外地址的编址也不同于中断信号，前者是设备树的自然表示，而后者者表现为独立于设备树结构的节点之间的链接。

下面显示了 ADC 控制器中断设备片段

adc: adc@48003000 {
     compatible = "st,stm32mp1-adc-core";
     reg = <0x48003000 0x400>;
     interrupts = <GIC_SPI 18 IRQ_TYPE_LEVEL_HIGH>,
     <GIC_SPI 90 IRQ_TYPE_LEVEL_HIGH>;
     clocks = <&rcc ADC12>, <&rcc ADC12_K>;
     clock-names = "bus", "adc";
     interrupt-controller;
     st,syscfg-vbooster = <&syscfg 0x4 0x100>;
     st,syscfg-vbooster-clr = <&syscfg 0x44 0x100>;
     st,syscfg-anaswvdd = <&syscfg 0x4 0x200>;
     st,syscfg-anaswvdd-clr = <&syscfg 0x44 0x200>;
     #interrupt-cells = <1>;
     #address-cells = <1>;
     #size-cells = <0>;
     status = "disabled";
    
     adc1: adc@0 {
         compatible = "st,stm32mp1-adc";
         #io-channel-cells = <1>;
         reg = <0x0>;
         interrupt-parent = <&adc>;
         interrupts = <0>;
         dmas = <&dmamux1 9 0x400 0x05>;
         dma-names = "rx";
         status = "disabled";
     };
    
     adc2: adc@100 {
         compatible = "st,stm32mp1-adc";
         #io-channel-cells = <1>;
         reg = <0x100>;
         interrupt-parent = <&adc>;
         interrupts = <1>;
         dmas = <&dmamux1 10 0x400 0x05>;
         dma-names = "rx";
         /* temperature sensor */
         st,adc-channels = <12>;
         st,min-sample-time-nsecs = <10000>;
         status = "disabled";
     };
    
     jadc1: jadc@0 {
         compatible = "st,stm32mp1-adc";
         st,injected;
         #io-channel-cells = <1>;
         reg = <0x0>;
         interrupt-parent = <&adc>;
         interrupts = <3>;
         status = "disabled";
     };
    
     jadc2: jadc@100 {
         compatible = "st,stm32mp1-adc";
         st,injected;
         #io-channel-cells = <1>;
         reg = <0x100>;
         interrupt-parent = <&adc>;
         interrupts = <4>;
         /* temperature sensor */
         st,adc-channels = <12>;
         st,min-sample-time-nsecs = <10000>;
         status = "disabled";
     };
    
     adc_temp: temp {
         compatible = "st,stm32mp1-adc-temp";
         io-channels = <&adc2 12>;
         nvmem-cells = <&ts_cal1>, <&ts_cal2>;
         nvmem-cell-names = "ts_cal1", "ts_cal2";
         #io-channel-cells = <0>;
         #thermal-sensor-cells = <0>;
         status = "disabled";
     };
};

下面显示了 ethernet 控制器中断设备片段

ethernet0: ethernet@5800a000 {
    compatible = "st,stm32mp1-dwmac", "snps,dwmac-4.20a";
    reg = <0x5800a000 0x2000>;
    reg-names = "stmmaceth";
    interrupts-extended = <&intc GIC_SPI 61 IRQ_TYPE_LEVEL_HIGH>,
                            <&intc GIC_SPI 62 IRQ_TYPE_LEVEL_HIGH>,
                            <&exti 70 1>;
    interrupt-names = "macirq",
                "eth_wake_irq",
                "stm32_pwr_wakeup";
    clock-names = "stmmaceth",
                "mac-clk-tx",
                "mac-clk-rx",
                "ethstp";
    clocks = <&rcc ETHMAC>,
            <&rcc ETHTX>,
            <&rcc ETHRX>,
            <&rcc ETHSTP>;
    st,syscon = <&syscfg 0x4>;
    snps,mixed-burst;
    snps,pbl = <2>;
    snps,en-tx-lpi-clockgating;
    snps,axi-config = <&stmmac_axi_config_0>;
    snps,tso;
    power-domains = <&pd_core>;
    status = "disabled";
};

特殊节点

​ aliases 节点为了解决节点路径名过长的问题，引入了节点别名的概念，可以引用到一个全路径的节点。如/external-bus/ethernet@0,0,但当用户想知道具体内容的时候显得太累赘。

aliases {
    ethernet0 = ðernet0;
    serial0 = &uart4;
    serial5 = &usart3;
}

当为设备分配一个标识符的时候，操作系统更倾向于使用 aliases。