點擊藍字 關注我們
本文來自XILINX嵌入式產品應用工程師 Terry Ni
設備樹是 Petalinux kernel 的關鍵組件，接下來以 2020.1 版本為例，為大家介紹一下在Xilinx Petalinux 工程中的設備樹是如何產生，配置以及修改的。
Petalinux 工程中設備樹的位置
當我們創建了一個 petalinux 工程后（以zcu102為例），在編譯的時候，會自動生成對應的設備樹文件。這些設備樹的描述信息通常在以下2個工程路徑下。
第一個是在 components/plnx_workspace/device-tree/device-tree 路徑下，這個路徑下主要保存的都是基于你導入的hdf/xsa后，自動生成的設備樹信息。通常包括PS的設備樹，時鐘的設備樹，PL 部分 IP 的設備樹（Xilinx發布的包含驅動的IP），以及設備樹頭文件。
./components/plnx_workspace/device-tree/device-tree/zynqmp-clk-ccf.dtsi
./components/plnx_workspace/device-tree/device-tree/zcu102-revc.dtsi
./components/plnx_workspace/device-tree/device-tree/pl.dtsi
./components/plnx_workspace/device-tree/device-tree/system-top.dts
./components/plnx_workspace/device-tree/device-tree/zynqmp.dtsi
./components/plnx_workspace/device-tree/device-tree/system-conf.dtsi
./components/plnx_workspace/device-tree/device-tree/pcw.dtsi
另一個是在 project-spec/meta-user/recipes-bsp/device-tree/files路徑下，這個路徑下主要就是用戶基于自動生成的設備樹，自行添加和修改的部分。這部分可以查看 UG1144 第10章 Device Tree Configuration 節的內容。
./project-spec/meta-user/recipes-bsp/device-tree/files/openamp.dtsi
./project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi
./project-spec/meta-user/recipes-bsp/device-tree/files/pl-custom.dtsi
./project-spec/meta-user/recipes-bsp/device-tree/files/xen-qemu.dtsi
./project-spec/meta-user/recipes-bsp/device-tree/files/xen.dtsi
需要注意的是，如果 petalinux-config->DTGsettings->MACHINE_NAME 采用的是xilinx開發板預設的名稱的話（UG1144DTG Settings 章節中的 Machine name 的說明），那么會自動生成對應開發板相關的設備樹信息。
所以如果使用的是自己的硬件平臺，那么盡量不要使用預設的名稱，這樣可以避免導入多余的設備樹信息從而導致編譯失敗或者最終功能不正確。
如何修改設備樹
1. 基于自動生成的設備樹，添加和修改節點。
通過修改./project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi，來實現對之前已經定義的設備樹節點中的屬性進行變更，也可以添加沒有自動生成的設備樹節點。
/dts-v1/;
/include/ "system-conf.dtsi"
/ {
};
&gem0 {
phy-handle = <&phy0>;
ps7_ethernet_0_mdio: mdio {
phy0: phy@7 {
compatible = "marvell,88e1116r";
device_type = "ethernet-phy";
reg = <7>;
};
};
};
gpio-leds {
compatible = "gpio-leds";
led-ds23 {
label = "led-ds23";
gpios = <&ps7_gpio_0 10 0>;
default-state = "on";
linux,default-trigger = "heartbeat";
};
};
有時候為了方便設備樹的管理，可以定義多個設備樹文件，然后在 system-user.dtsi 中將這些設備樹文件都包含進去，如下所示。
/include/ "system-conf.dtsi"
/include/ "system-user-1.dtsi"
/include/ "system-user-2.dtsi"
/include/ "system-user-3.dtsi"
/ {
};
當添加了其他的dtsi文件后，還需要修改./project-spec/meta-user/recipes-bsp/device-tree/device-tree.bbappend 文件，將這些 dtsi 文件的路徑信息包含進去。如下所示。
SRC_URI += "file://system-user.dtsi"
SRC_URI += "file://system-user-1.dtsi"
SRC_URI += "file://system-user-2.dtsi"
SRC_URI += "file://system-user-3.dtsi"
2. 完全使用自己的設備樹
我們還可以更改 petalinux-config-> Auto Config Settings 中的配置，直接使用自己編寫好的設備樹。
取消 Devicetree autoconfig，使能 Specify a manual device tree include directory, 然后指定設備樹的路徑地址。
怎么描述設備樹
設備樹中描述的信息都是要與 kernel中設備的驅動互相對應的。如果驅動中需要某個參數，但是設備樹中并沒有包含，很可能就會編譯錯誤或者直接使用了默認值，從而導致工作異常。kernel 的設備驅動中，一般都會包含設備樹的描述說明來保證設備樹的正確。你可以在 git上的 kernel 源碼中找到響應的設備樹說明。以 GPIO 驅動為例。你可以找到相關的設備樹描述信息如下。
https://github.com/Xilinx/linux-xlnx/blob/xlnx_rebase_v5.4_2020.1/Documentation/devicetree/bindings/gpio/gpio-zynq.txt
Example:
gpio@e000a000 {
#gpio-cells = <2>;
compatible = "xlnx,zynq-gpio-1.0";
clocks = <&clkc 42>;
gpio-controller;
interrupt-parent = <&intc>;
interrupts = <0 20 4>;
interrupt-controller;
#interrupt-cells = <2>;
reg = <0xe000a000 0x1000>;
};
另外，你可以查看 xilinx wiki上 linux driver 的主題頁面來獲取所有 Xilinx 支持的設備驅動內容，其中包含有各個設備樹的例子以及相關配置等說明。
https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/18841873/Linux+Drivers
反編譯設備樹
為了最終確認設備樹是否正確，我們可以通過 dtc 這個小應用，將 dtb 文件反編譯成 dts 設備樹文件。這個設備樹文件，從 system-top.dts 這個 top 文件開始，把所有包含的設備樹內容都整合到了一個 dts 文件中，便于我們確認最終的設備樹是否正確。其命令格式如下
dtc-I dtb -O dts -o system.dts system.dtb
