DTO语法

设备树源 (DTS) 格式是设备树的文本表示形式。设备树编译器 (DTC) 将此格式处理为二进制设备树，这是 Linux 内核所期望的形式。

使用参考文献

DTC （设备树编译器+覆盖补丁）项目在dtc-format.txt和manual.txt中描述了 DTS 格式。 DTO 格式和规则在dt-object-internal.txt中描述。这些文档描述了如何使用节点fragment@x和overlay DT中的语法__overlay__来更新主DT。例如：

/ {
  fragment@0 {
    target = <&some_node>;
      __overlay__ {
        some_prop = "okay";
        ...
      };
  };
};

但是，Google 强烈建议您不要使用fragment@x和语法__overlay__ ，而应使用引用语法。例如：

&some_node {
  some_prop = "okay";
  ...
};

dtc使用语法__overlay__将引用语法编译成与上面相同的对象。此语法不会强制您对片段进行编号，使您能够轻松读取和写入覆盖 DTS。如果您的dtc不支持此语法糖，请使用AOSP 中的 dtc 。

使用标签

要允许对编译时不存在的节点进行未定义引用，覆盖 DT .dts文件的标头中必须有一个标记/plugin/ 。例如：

/dts-v1/;
/plugin/;

从这里，您可以使用引用来定位要覆盖的节点，该引用是一个以与号 (&) 为前缀的绝对节点路径。例如，对于主设备标识符中的node@0 ：

在主设备标识符中定义标签... ...然后使用标签。
[my_main_dt.dts]

/dts-v1/;

/ {
  my_node: node@0 {
    status = "disabled";

    my_child: child@0 {
      value = <0xffffffff>;
    };
  };
};

[my_overlay_dt.dts]

/dts-v1/;
/plugin/;

&my_node {
  status = "okay";
};

&my_child {
  value = <0x1>;
};

压倒一切

如果引用目标属性存在于主DT中，则在DTO之后被覆盖；否则，将附加它。例如：

主文件覆盖.dts合并结果
[my_main_dt.dts]

/dts-v1/;

/ {
  compatible = "corp,foo";

  my_node: node@0 {
    status = "disabled";
  };
};

[my_overlay_dt.dts]

/dts-v1/;
/plugin/;

&my_node {
  status = "okay";
};

/dts-v1/;

/ {
  compatible = "corp,foo";

  ...

  node@0 {
    linux,phandle = <0x1>;
    phandle = <0x1>;
    status = "okay";
  };
};

追加

如果主DT中不存在引用目标属性，则将其附加在DTO之后。例如：

主文件覆盖.dts合并结果
[my_main_dt.dts]

/dts-v1/;

/ {
  compatible = "corp,foo";

  my_node: node@0 {
    status = "okay";
  };
};

[my_overlay_dt.dts]

/dts-v1/;
/plugin/;

&my_node {
  new_prop = "bar";
};

/dts-v1/;

/ {
  compatible = "corp,foo";

  ...

  node@0 {
    linux,phandle = <0x1>;
    phandle = <0x1>;
    status = "okay";
    new_prop = "bar";
  };
};

子节点

子节点语法示例：

主文件覆盖.dts合并结果
[my_main_dt.dts]

/dts-v1/;

/ {
  compatible = "corp,foo";

  my_nodes: nodes {
    compatible = "corp,bar";

    node@0 {
      status = "disabled";
    };
  };
};

[my_overlay_dt.dts]

/dts-v1/;
/plugin/;

&my_nodes {
  new_prop1 = "abc";

  node@0 {
    status = "okay";
    new_prop2 = "xyz";
  };
};

/dts-v1/;

/ {
  compatible = "corp,foo";

  ...

  nodes {
    linux,phandle = <0x1>;
    phandle = <0x1>;
    compatible = "corp,bar";
    new_prop1 = "abc";

    node@0 {
      linux,phandle = <0x2>;
      phandle = <0x2>;
      status = "okay";
      new_prop2 = "xyz";
    };
  };
};