DTO 문법

기기 트리 소스(DTS) 형식에는 기기 트리가 텍스트 형식으로 표현되어 있습니다. 기기 트리 컴파일러(DTC)는 이러한 형식을 Linux 커널에서 기대하는 형식인 바이너리 기기 트리로 처리합니다.

참조 사용

DTC(기기 트리 컴파일러 + 오버레이 패치) 프로젝트는 dtc-format.txt 및 manual.txt에서 DTS 형식을 설명합니다. DTO 형식과 규칙은 dt-object-internal.txt에 설명되어 있습니다. 이러한 문서에서는 오버레이 DT에서 노드 fragment@x 및 구문 __overlay__를 사용하여 기본 DT를 업데이트하는 방법을 설명합니다. 예:

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

그러나 fragment@x 및 구문 __overlay__를 사용하지 않는 것이 좋습니다. 대신 참조 구문을 사용하세요. 예:

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

참조 문법은 문법 __overlay__를 사용하여 위와 동일한 객체로 dtc에서 컴파일됩니다. 이 구문은 프래그먼트에 번호를 지정하도록 강제하지 않으므로 오버레이 DTS를 쉽게 읽고 쓸 수 있습니다. dtc에서 이 구문 코드를 지원하지 않으면 AOSP의 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 이후에 추가됩니다. 예:

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