Vous pouvez utiliser Device Tree Compiler (DTC) pour compiler les fichiers source de l'arborescence des périphériques. Cependant, avant d'appliquer la DT superposée sur la DT principale cible, vous devez également vérifier le résultat en simulant le comportement du DTO.
Compilation avec DTC
Lorsque vous utilisez dtc
pour compiler .dts
, vous devez ajouter l'option -@
pour ajouter un nœud __symbols__
dans le .dtbo
résultant. Le nœud __symbols__
contient une liste de tous les nœuds marqués d'une étiquette, que la bibliothèque DTO peut utiliser comme références.
Exemple de commande pour construire le DT principal .dts
:
dtc -@ -O dtb -o my_main_dt.dtb my_main_dt.dts
Exemple de commande pour construire la superposition DT .dts
:
dtc -@ -O dtb -o my_overlay_dt.dtbo my_overlay_dt.dts
Vérifier les résultats DTO sur l'hôte
La vérification peut vous aider à identifier les erreurs qui pourraient survenir lors du placement de 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
.
/include/
pour simuler DTO sur l'hôte- Créez une copie de la superposition
.dts
. Dans la copie, supprimez l'en-tête de la première ligne. Exemple :/dts-v1/; /plugin/;
Enregistrez le fichier sousmy_overlay_dt_wo_header.dts
(ou tout autre nom de fichier de votre choix). - Créez une copie du
.dts
principal. Dans la copie, après la dernière ligne, ajoutez la syntaxe d'inclusion du fichier que vous avez créé à l'étape 1. Par exemple :/include/ "my_overlay_dt_wo_header.dts"
Enregistrez le fichier sousmy_main_dt_with_include.dts
(ou tout autre nom de fichier de votre choix). - Utilisez
dtc
pour compilermy_main_dt_with_include.dts
afin d'obtenir le DT fusionné, qui devrait être le même résultat que DTO. Par exemple :dtc -@ -O dtb -o my_merged_dt.dtb my_main_dt_with_include.dts
- Utilisez
dtc
pour vidermy_merged_dt.dto
.dtc -O dts -o my_merged_dt.dts my_merged_dt.dtb
Vérification de DTO dans Android 9
Android 9 nécessite une partition Device Tree Blob Overlay (DTBO). Pour ajouter des nœuds ou apporter des modifications aux propriétés dans le SoC DT, le chargeur de démarrage doit superposer dynamiquement une DT spécifique à l'appareil sur le SoC DT.
Indiquer les superpositions appliquées
Pour permettre à Vendor Test Suite (VTS) d'évaluer l'exactitude 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. Sous Android 12 utilisant la version 5.10 ou ultérieure du noyau, ce paramètre passe par bootconfig. Par exemple, le paramètre androidboot.dtbo_idx=x,y,z
rapporte x
, y
et z
comme indices de base zéro des superpositions d'arborescence de périphériques (DTO) de la partition DTBO appliquées (dans cet ordre) par le chargeur de démarrage à la base. Arborescence des périphériques (DT).
Les superpositions peuvent s'appliquer aux nœuds de l'arborescence principale des périphériques 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 des symboles de superposition avec la table des symboles DT principale (ne pas fusionner évite les conflits dans les 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 overlay_1
appliqué à la DT principale, si une tentative est faite pour appliquer overlay_2
à la DT résultante, l'application de superposition échouera avec une erreur indiquant que le symbole e
n'est pas présent dans la table des symboles de la 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>; }; |
Exemple : superpositions valides
Dans cet exemple, overlay_2.dts
fait uniquement référence au nœud b
du DTS principal. Lorsque overlay_1
est appliqué au DT de base, puis suivi de l'application de overlay_2
, la valeur de la propriété prop
dans le nœud e
(définie par overlay_1.dts
) est écrasé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>; }; }; |
Implémentation de la partition DTBO
Pour implémenter la partition DTBO requise, assurez-vous que le chargeur de démarrage peut effectuer les opérations suivantes :
- Identifiez la carte sur laquelle il s'exécute et sélectionnez la ou les superpositions correspondantes à appliquer.
- Ajoutez le paramètre
androidboot.dtbo_idx
à la ligne de commande du noyau.- Le paramètre doit indiquer les indices de base zéro des DTO de l'image de partition DTBO qu'il a appliqué au DT de base (dans le même ordre).
- Les indices doivent faire référence à la position de l'overlay dans la partition DTBO.
Pour plus de détails sur la structure de la partition DTBO, reportez-vous à Superpositions de l'arborescence des périphériques sur source.android.com.
Validation de 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érifiantInit
a automatiquement configuré la propriété systèmero.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 dans la partition DTBO appliquées à la DT de base).
- Des nœuds supplémentaires ou des modifications de propriétés dans la DT résultante sont présentés au noyau Linux.
Par exemple, dans les superpositions suivantes et le DT final, l'ajout de androidboot.dtbo_idx=5,3
à la ligne de commande du noyau réussit la validation, mais l'ajout androidboot.dtbo_idx=3,5
à la ligne de commande du noyau ne réussit 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 final |
---|
/dts-v1/; / { a { phandle = <0x1>; }; b { phandle = <0x2>; }; c { phandle = <0x3>; prop = <0xfe>; }; __symbols__ { a = "/a"; b = "/b"; c = "/c"; }; }; |
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/04/29 (UTC).