您可以使用裝置樹編譯器(DTC)來編譯裝置樹原始檔。然而,在目標主DT上套用覆蓋DT之前,您也應該透過模擬DTO的行為來驗證結果。
使用 DTC 進行編譯
使用dtc
編譯.dts
時,必須新增選項-@
以在產生的.dtbo
中加入__symbols__
節點。 __symbols__
節點包含所有標有標籤的節點的列表,DTO 庫可以將其用作引用。
建構主 DT .dts
的範例指令:
dtc -@ -O dtb -o my_main_dt.dtb my_main_dt.dts
建構覆蓋 DT .dts
的範例命令:
dtc -@ -O dtb -o my_overlay_dt.dtbo my_overlay_dt.dts
驗證主機上的 DTO 結果
驗證可以幫助您識別將覆蓋裝置識別碼放置在主裝置識別碼上時可能發生的錯誤。在更新目標之前,您可以透過使用.dts
中的/include/
模擬 DTO 的行為來驗證在主機上覆蓋 DT 的結果。
/include/
在主機上模擬 DTO- 建立覆蓋
.dts
的副本。在副本中,刪除第一行標題。範例:/dts-v1/; /plugin/;
將檔案另存為my_overlay_dt_wo_header.dts
(或任何您想要的檔案名稱)。 - 建立主
.dts
的副本。在副本中的最後一行之後,附加您在步驟 1 中建立的檔案的包含語法。例如:/include/ "my_overlay_dt_wo_header.dts"
將檔案另存為my_main_dt_with_include.dts
(或您想要的任何檔案名稱)。 - 使用
dtc
編譯my_main_dt_with_include.dts
得到合併後的DT,應該與DTO的結果相同。例如:dtc -@ -O dtb -o my_merged_dt.dtb my_main_dt_with_include.dts
- 使用
dtc
轉儲my_merged_dt.dto
。dtc -O dts -o my_merged_dt.dts my_merged_dt.dtb
在 Android 9 中驗證 DTO
Android 9 需要裝置樹 Blob 覆蓋 (DTBO) 分區。若要新增節點或變更 SoC DT 中的屬性,引導程式必須在 SoC DT 上動態覆寫裝置特定的 DT。
指示應用的疊加
為了使供應商測試套件 (VTS)能夠評估覆蓋應用程式的正確性,供應商必須添加新的核心命令列參數androidboot.dtbo_idx
,該參數指示從 DTBO 分區中選擇的覆蓋。在使用核心版本 5.10 或更高版本的 Android 12 中,此參數透過 bootconfig 傳遞。例如,參數androidboot.dtbo_idx=x,y,z
將x
、 y
和z
報告為設備樹覆蓋 (DTO) 的從零開始的索引,該索引來自引導程式(按順序)應用於基礎的 DTBO 分區設備樹(DT)。
覆蓋可以應用於主設備樹中的節點或新增節點,但不能引用先前覆蓋中新增的節點。此限制是必要的,因為覆蓋應用程式不會將覆蓋符號表與主 DT 符號表合併(不合併可以避免符號名稱衝突以及覆蓋之間依賴關係的複雜化)。
範例:無效的疊加
在此範例中, overlay_2.dts
引用由overlay_1.dts
新增的節點e
。將overlay_1
套用到主DT 後,如果嘗試將overlay_2
套用到結果DT,則覆寫應用程式將會失敗,並顯示符號e
不存在於基本DT 的符號表中的錯誤。
主文件 | 覆蓋_1.dts | 覆蓋_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>; }; |
範例:有效疊加
在此範例中, overlay_2.dts
僅引用主 DTS 中的節點b
。當將overlay_1
套用於基礎DT,然後套用overlay_2
時,節點e
中的property prop
值(由overlay_1.dts
設定)將被overlay_2.dts
設定的值覆寫。
主文件 | 覆蓋_1.dts | 覆蓋_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>; }; }; |
實施DTBO分區
若要實現所需的 DTBO 分割區,請確保引導程式可以執行以下操作:
- 識別正在運行的板並選擇要套用的相應覆蓋層。
- 將
androidboot.dtbo_idx
參數附加到核心命令列。- 此參數必須指示應用於基礎 DT 的 DTBO 分割映像中的 DTO 從零開始的索引(以相同的順序)。
- 索引必須引用 DTBO 分區中覆蓋的位置。
有關 DTBO 分區結構的詳細信息,請參閱 source.android.com 上的設備樹覆蓋。
驗證 DTBO 分區
您可以使用 VTS 驗證以下內容:
- 核心命令列參數
androidboot.dtbo_idx
是否存在(透過檢查Init
是否已自動設定對應的ro.boot.dtbo_idx
系統屬性)。 -
ro.boot.dtbo_idx
系統屬性的有效性(透過檢查該屬性是否指定至少一個有效的 DTBO 映像索引)。 - DTBO 分區的有效性(也驗證 DTBO 分區中應用於基礎 DT 的覆蓋)。
- 產生的 DT 中的其他節點或屬性變更將提交給 Linux 核心。
例如,在以下覆蓋和最終 DT 中,將androidboot.dtbo_idx=5,3
新增至核心命令列會經過驗證,但將androidboot.dtbo_idx=3,5
新增至核心命令列不會經過驗證。
索引 3 處的疊加 DT | 索引 5 處的疊加 DT |
---|---|
[overlay_1.dts] /dts-v1/; /plugin/; &c { prop = <0xfe>; }; | [overlay_2.dts] /dts-v1/; /plugin/; &c { prop = <0xff>; }; |
最終DT |
---|
/dts-v1/; / { a { phandle = <0x1>; }; b { phandle = <0x2>; }; c { phandle = <0x3>; prop = <0xfe>; }; __symbols__ { a = "/a"; b = "/b"; c = "/c"; }; }; |
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2024-04-29 (世界標準時間)。