Cette page a été traduite par l'API Cloud Translation.

Compiler et vérifier

Vous pouvez utiliser DTC (Device Tree Compiler) pour compiler les fichiers source de l'arborescence de périphériques (DTS). Toutefois, avant d'appliquer la superposition de l'arborescence de l'appareil (DT) sur la DT principale cible, vous devez également vérifier le résultat en simulant le comportement de la superposition de l'arborescence de l'appareil (DTO).

Compiler avec DTC

Lorsque vous utilisez dtc pour compiler .dts, vous devez ajouter l'option -@ pour ajouter un nœud __symbols__ dans le .dtbo généré. Le nœud __symbols__ contient une liste de tous les nœuds marqués d'une étiquette que la bibliothèque DTO peut utiliser pour les références.

Exemple de commande pour générer le DT principal .dts :

dtc -@ -O dtb -o my_main_dt.dtb my_main_dt.dts

Exemple de commande pour créer la superposition DT .dts:

dtc -@ -O dtb -o my_overlay_dt.dtbo my_overlay_dt.dts

Remarque:Si vous rencontrez l'erreur de génération DTC : invalid option --'@', vous devrez peut-être mettre à jour votre version de DTC. En amont d'AOSP, le DTC officiel prend en charge DTO à partir de la version 1.4.4 et la plupart des correctifs sont fusionnés après décembre 2016. Pour la prise en charge de DTO, nous vous recommandons d'utiliser


  external/dtc

dans AOSP, qui est synchronisé avec les derniers DTC (avec les correctifs DTO fusionnés si nécessaire).

Vérifier les résultats DTO sur l'hôte

La vérification peut vous aider à identifier les erreurs qui peuvent se produire lorsque vous placez la DT superposée sur la DT principale. Avant de mettre à jour la cible, vous pouvez vérifier le résultat de la superposition de DT sur l'hôte en simulant le comportement de DTO à l'aide de /include/ dans .dts.

Remarque:/include/ n'est PAS compatible avec l'utilisation de __overlay__ dans les sources de transfert de données en superposition.

Figure 1 : Utilisez la syntaxe /include/ pour simuler DTO sur l'hôte.

Créez une copie de l'.dts de superposition. Dans la copie, supprimez l'en-tête de la première ligne. Exemple :
```
/dts-v1/;
/plugin/;
```
Enregistrez le fichier sous le nom my_overlay_dt_wo_header.dts (ou tout autre nom de fichier de votre choix).
Créez une copie de l'.dts principal. Dans la copie, après la dernière ligne, ajoutez la syntaxe d'inclusion du fichier créé à l'étape 1. Par exemple :
```
/include/ "my_overlay_dt_wo_header.dts"
```
Enregistrez le fichier sous le nom my_main_dt_with_include.dts (ou le nom de fichier de votre choix).
Utilisez dtc pour compiler my_main_dt_with_include.dts afin d'obtenir le DT fusionné, qui devrait être le même résultat que DTO. Exemple :
```
dtc -@ -O dtb -o my_merged_dt.dtb my_main_dt_with_include.dts
```

Utilisez dtc pour vider my_merged_dt.dto.

dtc -O dts -o my_merged_dt.dts my_merged_dt.dtb

Vérifier DTO sous Android 9

Android 9 nécessite une partition DTBO (Device tree blob superposition). Pour ajouter des nœuds ou modifier les propriétés dans le DT SoC, le chargeur de démarrage doit superposer de manière dynamique un DT spécifique à un appareil sur le DT SoC.

Indique les superpositions appliquées

Pour permettre à la suite de tests de fournisseurs (VTS) d'évaluer le caractère correct de l'application de superposition, les fournisseurs doivent ajouter un nouveau paramètre de ligne de commande du noyau androidboot.dtbo_idx qui indique les superpositions sélectionnées dans la partition DTBO. Dans Android 12 avec la version du kernel 5.10 ou ultérieure, ce paramètre est transmis via bootconfig. Par exemple, le paramètre androidboot.dtbo_idx=x,y,z indique x, y et z comme index de base zéro des DTO de la partition DTBO appliquée (dans cet ordre) par le bootloader à la DT de base.

Les superpositions peuvent s'appliquer aux nœuds du transfert de données principal ou ajouter de nouveaux nœuds, mais ne peuvent pas faire référence à un nœud ajouté dans une superposition précédente. Cette restriction est nécessaire car l'application de superposition ne fusionne pas la table de symboles de superposition avec la table de symboles DT principale (cette fusion évite les conflits de noms de symboles et la complication des dépendances entre les superpositions).

Exemple: superpositions non valides

Dans cet exemple, overlay_2.dts fait référence au nœud e , qui a été ajouté par overlay_1.dts. Une fois que overlay_1 a été appliqué au DT principal, si vous tentez d'appliquer overlay_2 au DT résultant, l'application de superposition échouera avec une erreur indiquant que le symbole e n'est pas présent dans la table des symboles pour le DT de base.

main.dts	superposition_1.dts	superposition_2.dts
[main.dts] /dts-v1/; / { a: a {}; b: b {}; c: c {}; };	[overlay_1.dts] /dts-v1/; /plugin/; &b { ref1 = <&a>; e: e { prop = <0x0a>; phandle = <0x04>; }; };	[overlay_2.dts] /dts-v1/; /plugin/; /* invalid! */ &e { prop = <0x0b>; };

main.dts

superposition_1.dts

superposition_2.dts

[main.dts]

/dts-v1/;

/ {
  a: a {};
  b: b {};
  c: c {};
};

[overlay_1.dts]

/dts-v1/;
/plugin/;

&b { ref1 =  <&a>;
    e: e {
        prop = <0x0a>;
        phandle = <0x04>;
    };
};

[overlay_2.dts]

/dts-v1/;
/plugin/;

/* invalid! */
&e {
    prop = <0x0b>;
};

Exemple : superpositions valides

Dans cet exemple, overlay_2.dts ne fait référence qu'au nœud b du DTS principal. Lorsque overlay_1 est appliqué au DT de base, puis suivi par l'application de overlay_2, la valeur de la propriété prop dans le nœud e (définie par overlay_1.dts) est remplacée par la valeur définie par overlay_2.dts.

main.dts	superposition_1.dts	superposition_2.dts
[final.dts] /dts-v1/; / { a: a {}; b: b {}; c: c {}; };	[overlay_1.dts] /dts-v1/; /plugin/; &b { ref1 = <&a>; e { prop = <0x0c>; }; };	[overlay_2.dts] /dts-v1/; /plugin/; /* valid */ &b { ref1 = <&c>; e { prop = <0x0d>; }; };

main.dts

superposition_1.dts

superposition_2.dts

[final.dts]

/dts-v1/;

/ {
  a: a {};
  b: b {};
  c: c {};
};

[overlay_1.dts]

/dts-v1/;
/plugin/;


&b { ref1 =  <&a>;
     e {
          prop = <0x0c>;
      };
};

[overlay_2.dts]

/dts-v1/;
/plugin/;

/* valid */
&b { ref1 =  <&c>;
     e {
          prop = <0x0d>;
      };
};

Implémenter la partition DTBO

Pour implémenter la partition DTBO requise, assurez-vous que le bootloader peut effectuer les opérations suivantes:

Identifiez la carte sur laquelle il est exécuté et sélectionnez les superpositions correspondantes à appliquer.
Ajoutez le paramètre androidboot.dtbo_idx à la ligne de commande du noyau.
- Ce paramètre doit indiquer les indices de base zéro des DTO de l'image de partition DTBO appliquée à la DT de base (dans le même commande).
- Les index doivent faire référence à la position de la superposition dans la partition DTBO.

Pour en savoir plus sur la structure de la partition DTBO, consultez Superpositions d'arborescence de périphériques.

Valider la partition DTBO

Vous pouvez utiliser VTS pour vérifier les éléments suivants:

Existence du paramètre de ligne de commande du noyau androidboot.dtbo_idx (en vérifiant que Init a automatiquement configuré la propriété système ro.boot.dtbo_idx correspondante).
Validité de la propriété système ro.boot.dtbo_idx (en vérifiant que la propriété spécifie au moins un index d'image DTBO valide).
Validité de la partition DTBO (vérifie également les superpositions appliquées à la DT de base dans la partition DTBO).
Des nœuds supplémentaires ou des modifications de propriété dans le DT résultant sont présentés au noyau Linux.

Par exemple, dans les superpositions et le DT final suivants, l'ajout de androidboot.dtbo_idx=5,3 à la ligne de commande du noyau passe la validation, mais l'ajout de androidboot.dtbo_idx=3,5 à la ligne de commande du noyau ne passe pas la validation.

Superposition DT à l'index 3	Superposition DT à l'index 5
[overlay_1.dts] /dts-v1/; /plugin/; &c { prop = <0xfe>; };	[overlay_2.dts] /dts-v1/; /plugin/; &c { prop = <0xff>; };

DT finale
/dts-v1/; / { a { phandle = <0x1>; }; b { phandle = <0x2>; }; c { phandle = <0x3>; prop = <0xfe>; }; __symbols__ { a = "/a"; b = "/b"; c = "/c"; }; };