DTO 語法

裝置樹狀結構來源 (DTS) 格式是裝置樹狀結構 (DT) 的文字表示法。 裝置樹狀結構編譯器 (DTC) 會將這個格式處理為二進位 DT 這是 Linux 核心預期的格式

使用參照

DTC (裝置樹狀結構編譯器 + 重疊修補程式) 專案會說明 dtc-format.txtmanual.txt。 如要瞭解 DTO 格式和規則,請參閱 dt-object-internal.txt。 這些文件說明如何使用節點更新主要 DT 疊加層 DT 中的 fragment@x 和語法 __overlay__。例如:

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

但 Google 強烈建議您「不要」使用 fragment@x 和語法 __overlay__,然後改用 參照語法例如:

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

參照語法是由 dtc 編譯成與 以上就是使用語法 __overlay__這個語法不會強迫您 為片段加上編號,方便您讀取及寫入疊加層 DTS。如果您的 dtc 不支援這種語法糖,請改用 dtc 。

使用標籤

為了允許在編譯期間未定義的節點參照, 疊加層 DT .dts 檔案的內含標記 /plugin/ 標題。例如:

/dts-v1/;
/plugin/;

您可以在這裡使用參照,指定要重疊的節點, 前置字元為 & 符號的絕對節點路徑。舉例來說, 在主要 DT 中的 node@0

在主要 DT 中定義標籤 ... ...然後使用標籤。
[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 之後;否則會附加於結尾例如:

main.dts Overlay.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 後附加的 DTO 後方。例如:

main.dts Overlay.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";
  };
};

子節點

子節點語法範例如下:

main.dts Overlay.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";
    };
  };
};