ไวยากรณ์ DTO

รูปแบบแหล่งที่มาของแผนผังอุปกรณ์ (DTS) คือการแสดงข้อความของแผนผังอุปกรณ์ (DT) คอมไพเลอร์ Device Tree (DTC) จะประมวลผลรูปแบบนี้เป็น DT แบบไบนารี ซึ่งเป็นรูปแบบที่เคอร์เนล Linux คาดหวัง

ใช้การอ้างอิง

โปรเจ็กต์ DTC (ตัวคอมไพล์ Device Tree + แพตช์การวางซ้อน) อธิบายรูปแบบ DTS ใน dtc-format.txt และ manual.txt รูปแบบและกฎ DTO อธิบายไว้ใน dt-object-internal.txt เอกสารเหล่านี้อธิบายวิธีอัปเดต DT หลักโดยใช้โหนด fragment@xและไวยากรณ์ __overlay__ ใน DT แบบซ้อนทับ เช่น

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

อย่างไรก็ตาม Google ขอแนะนำไม่ให้ใช้ fragment@x และไวยากรณ์ __overlay__ แต่ให้ใช้ไวยากรณ์อ้างอิงแทน เช่น

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

dtc จะรวบรวมไวยากรณ์อ้างอิงไว้ในออบเจ็กต์เดียวกันกับด้านบนโดยใช้ไวยากรณ์ __overlay__ ไวยากรณ์นี้ไม่ได้บังคับให้คุณ ระบุหมายเลขของส่วนย่อย ซึ่งช่วยให้คุณอ่านและเขียน DTS แบบซ้อนทับได้อย่างง่ายดาย หาก dtcไม่รองรับไวยากรณ์ที่กระชับนี้ ให้ใช้ dtc ใน AOSP

ใช้ป้ายกำกับ

หากต้องการอนุญาตการอ้างอิงที่ไม่ได้กำหนดไปยังโหนดที่ไม่ได้อยู่ในเวลาคอมไพล์ ไฟล์ DT .dts ของการซ้อนทับต้องมีแท็ก /plugin/ ในส่วน ส่วนหัว เช่น

/dts-v1/;
/plugin/;

จากที่นี่ คุณสามารถกำหนดเป้าหมายโหนดที่จะซ้อนทับได้โดยใช้การอ้างอิง ซึ่งเป็น เส้นทางโหนดแบบสัมบูรณ์ที่มีเครื่องหมายแอมเพอร์แซนด์ (&) นำหน้า เช่น สำหรับ 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 มิฉะนั้นจะต่อท้าย เช่น

[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 เช่น

[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";
  };
};

โหนดย่อย

ตัวอย่างไวยากรณ์ของโหนดย่อย

[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";
    };
  };
};