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 expliquent 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 la table de données principale, elle est ajoutée après la 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"; }; }; }; |