ไวยากรณ์ DTO

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

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

โปรเจ็กต์ DTC (คอมไพเลอร์แผนผังอุปกรณ์ + แพตช์การวางซ้อน) อธิบายรูปแบบ 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

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

หากต้องการอนุญาตการอ้างอิงโหนดที่ไม่ได้กำหนดไว้ซึ่งไม่มีอยู่ ณ เวลาคอมไพล์ ไฟล์ .dts ของ DT การวางซ้อนต้องมีแท็ก /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";
    };
  };
};