Syntaxe DTO

Le format DTS (Device Tree Source) est une représentation textuelle d'une arborescence de périphériques (DT). Le compilateur de l'arborescence des périphériques (DTC) convertit ce format en DT binaire, qui est la forme attendue par le noyau Linux.

Utiliser des références

Le projet DTC (Device Tree Compiler + Overlay Patches) décrit le format DTS dans les fichiers dtc-format.txt et manual.txt. Le format et les règles des DTO sont décrits dans dt-object-internal.txt. Ces documents décrivent comment mettre à jour la table de données principale à l'aide du nœud fragment@x et de la syntaxe __overlay__ dans la table de données en superposition. Exemple :

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

Toutefois, Google vous recommande vivement de ne pas utiliser fragment@x et la syntaxe __overlay__, et d'utiliser plutôt la syntaxe de référence. Exemple :

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

La syntaxe de référence est compilée par dtc dans le même objet que celui ci-dessus à l'aide de la syntaxe __overlay__. Cette syntaxe ne vous oblige pas à numéroter les fragments, ce qui vous permet de lire et d'écrire facilement des fichiers DTS superposés. Si votre dtc n'est pas compatible avec ce sucre syntaxique, utilisez le dtc dans AOSP.

Utiliser des libellés

Pour autoriser les références non définies à des nœuds non présents au moment de la compilation, le fichier .dts du DT de superposition doit comporter une balise /plugin/ dans son en-tête. Exemple :

/dts-v1/;
/plugin/;

Vous pouvez ensuite cibler les nœuds à superposer à l'aide d'une référence, qui est un chemin d'accès de nœud absolu précédé d'un esperluette (&). Par exemple, pour node@0 dans la table de données principale:

Définir des libellés dans le DT principal ... ... puis utilisez les libellés. 
[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>;
};

Ignorer

Si la propriété cible de référence existe dans le DT principal, elle est remplacée après la DTO. Sinon, elle est ajoutée. Exemple :

main.dts overlay.dts Résultat de la fusion 
[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";
  };
};

Ajouter

Si la propriété cible de référence n'existe pas dans le DT principal, elle est ajoutée après DTO. Exemple :

main.dts overlay.dts Résultat de la fusion 
[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";
  };
};

Nœuds enfants

Exemples de syntaxe de nœud enfant:

main.dts overlay.dts Résultat de la fusion 
[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";
    };
  };
};