Devicetree 源 (DTS) 编码风格¶

编写 Devicetree 源 (DTS) 时，请遵守以下准则。它们应被视为对 Devicetree 规范和 dtc 编译器（包括 W=1 和 W=2 构建）中已表达的任何规则的补充。

各个架构和子架构可以定义附加规则，使编码风格更严格。

命名和有效字符¶

Devicetree 规范允许节点和属性名称中使用广泛的字符，但此编码风格将范围缩小以实现更好的代码可读性。

节点和属性名称只能使用以下字符：
- 小写字符：[a-z]
- 数字：[0-9]
- 破折号：-
标签只能使用以下字符：
- 小写字符：[a-z]
- 数字：[0-9]
- 下划线：_
除非总线另有定义，否则单元地址应使用小写十六进制数字，不带前导零（填充）。
属性中的十六进制值，例如“reg”，应使用小写十六进制。地址部分可以用前导零填充。

示例

gpi_dma2: dma-controller@a00000 {
        compatible = "qcom,sm8550-gpi-dma", "qcom,sm6350-gpi-dma";
        reg = <0x0 0x00a00000 0x0 0x60000>;
}

节点顺序¶

任何总线上的节点，因此使用单元地址作为子节点，应按单元地址升序排列。或者对于某些子架构，相同类型的节点可以分组在一起，例如所有 I2C 控制器一个接一个，即使这破坏了单元地址排序。
没有单元地址的节点应按节点名称按字母数字顺序排列。对于少数节点类型，它们可以按主要属性排序，例如按“pins”属性的值排序引脚配置状态。
通过 &label 在板级 DTS 中扩展节点时，条目应按字母数字顺序排列，或保持 DTSI 中的顺序，选择取决于子架构。

上述排序规则在审查过程中易于执行，减少了同时向文件添加新节点时发生冲突的机会，并有助于在 DTS 源中导航。

示例

/* SoC DTSI */

/ {
        cpus {
                /* ... */
        };

        psci {
                /* ... */
        };

        soc@0 {
                dma: dma-controller@10000 {
                        /* ... */
                };

                clk: clock-controller@80000 {
                        /* ... */
                };
        };
};

/* Board DTS - alphabetical order */

&clk {
        /* ... */
};

&dma {
        /* ... */
};

/* Board DTS - alternative order, keep as DTSI */

&dma {
        /* ... */
};

&clk {
        /* ... */
};

设备节点中属性的顺序¶

设备节点中属性的以下顺序是首选：

“compatible”
“reg”
“ranges”
标准/通用属性（由通用绑定定义，例如不带供应商前缀）
供应商特定属性
“status”（如果适用）
子节点，每个节点前面都有一空行

“status”属性默认为“okay”，因此可以省略。

上述排序遵循以下方法：

最重要的属性开始节点：“compatible”，然后是总线寻址以匹配单元地址。
每个节点将在类似位置拥有通用属性。
Status 是最后的信息，用于注释设备节点是否已完成（需要板级资源）。

每个组内的各个属性应按属性名称使用自然排序顺序。

示例

/* SoC DTSI */

device_node: device-class@6789abc {
        compatible = "vendor,device";
        reg = <0x0 0x06789abc 0x0 0xa123>;
        ranges = <0x0 0x0 0x06789abc 0x1000>;
        #dma-cells = <1>;
        clocks = <&clock_controller 0>, <&clock_controller 1>;
        clock-names = "bus", "host";
        #address-cells = <1>;
        #size-cells = <1>;
        vendor,custom-property = <2>;
        status = "disabled";

        child_node: child-class@100 {
                reg = <0x100 0x200>;
                /* ... */
        };
};

/* Board DTS */

&device_node {
        vdd-0v9-supply = <&board_vreg1>;
        vdd-1v8-supply = <&board_vreg4>;
        vdd-3v3-supply = <&board_vreg2>;
        vdd-12v-supply = <&board_vreg3>;
        status = "okay";
}

缩进和换行¶

按照Linux 内核编码风格使用缩进和换行。
数组中包含多个单元的每个条目，例如包含两个 IO 地址的“reg”，应使用 <> 括起来。
对于跨行的数组，最好在项目边界处分割，并使连续的条目与第一行开头的 < 对齐。通常避免分割单个项目，除非它们显著超过行宽限制。

示例

thermal-sensor@c271000 {
        compatible = "qcom,sm8550-tsens", "qcom,tsens-v2";
        reg = <0x0 0x0c271000 0x0 0x1000>,
              <0x0 0x0c222000 0x0 0x1000>;
        /* Lines exceeding coding style line wrap limit: */
        interconnects = <&aggre1_noc MASTER_USB3_0 0 &mc_virt SLAVE_EBI1 0>,
                        <&gem_noc MASTER_APPSS_PROC 0 &config_noc SLAVE_USB3_0 0>;
};

组织 DTSI 和 DTS¶

DTSI 和 DTS 文件应以表示硬件的通用、可重用部分的方式组织。通常，这意味着将 DTSI 和 DTS 文件组织成以下几个文件：

包含整个 SoC 内容的 DTSI，不包含 SoC 上不存在的硬件节点。
如果适用：包含硬件通用或可重用部分的 DTSI，例如整个系统级模块 (SoM)。
代表板的 DTS。

板上存在的硬件组件应放置在板级 DTS 中，而不是 SoC 或 SoM DTSI 中。一个部分例外是常见的外部参考 SoC 输入时钟，它可以作为固定时钟编码在 SoC DTSI 中，其频率由每个板级 DTS 提供。

Linux 内核

目录

本页