文章目錄

• 一.設備樹簡述
• 二.SylixOS中設備樹文件定義
• 三.SylixOS設備樹常用API
• 四.在BSP中的使用設備樹

一.設備樹簡述

ARM社區曾在Linux內核中加入了大量板級信息導致Linux內核有大量無用冗余的代碼，然后ARM社區就引入了描述板級硬件信息的設備樹文件解決這個問題，dts設備樹源文件（device tree source）。
一個SOC系統級芯片可以做出各種不同的板級，但是這些板級有著相同的部分，這些相同信息提取出來作為一個通用文件，dtsi設備樹頭文件（device tree source include）。
dts設備樹文件中可以包含dtsi頭文件，dts文件經過dtc（device tree compiler）設備樹編譯工具編譯成SylixOS內核可以解析的dtb（device tree bolb）文件。

二.SylixOS中設備樹文件定義

imx6的dtsi文件部分定義如下

#include <dt-bindings/gpio/gpio.h>/ {chosen {bootargs = "ncpus=1 kdlog=no kderror=yes kfpu=no heapchk=yes hz=1000 hhz=1000 rfsmap=/:/dev/ram";};aliases {gpio0 = &gpio1;gpio1 = &gpio2;i2c0 = &i2c1;i2c1 = &i2c2;i2c2 = &i2c3;serial0 = &uart1;serial1 = &uart2;};intc: interrupt-controller@a01000 {compatible = "arm,cortex-a7-gic";#interrupt-cells = <3>;#address-cells = <1>;#size-cells = <1>;interrupt-controller;reg = <0x00a01000 0x1000>,<0x00a00100 0x100>;};soc {#address-cells = <1>;#size-cells = <1>;compatible = "simple-bus";interrupt-parent = <&intc>;ranges;timer@a00600 {compatible = "arm,cortex-a7-twd-timer";reg = <0x00a00600 0x20>;interrupts = <1 13 0xf01>;};}; };

一個設備樹結構包含：一個根節點"/"，子節點"intc"“soc”，子節點的孩子節點"timer",節點屬性"interrupts""reg"等（注意：一個節點的孩子節點需要定義在屬性的下面）。
設備樹不僅可以包含設備樹頭文件，還可以包含C語言頭文件，使用C頭文件中的引腳寄存器定義等。

choosen節點為SylixOS設備樹中的一種特殊節點，主要為了定義bootargs，即內核啟動參數，在bspInit.c配合內核設備樹接口使用。
aliases節點中定義內容主要為設備樹節點起別名，通過&和節點名可以訪問該節點。（在設備樹高級初始化時，會解析設備樹生成aliases節點，實際上就是將aliases插入一個全局的鏈表中，該函數遍歷該鏈表，通過別名獲取到設備的ID）
compatible節點為匹配節點，用于驅動中匹配該設備然后讀取硬件信息。
reg節點表示物理地址和范圍。
interrupts節點表示中斷的信息等。

imx6ull板級的dts文件部分定義如下

#include "imx6.dtsi"&i2c1 {pinctrl-names = "default";pinctrl-0 = <&pinctrl_i2c1>;clock-frequency = <100000>;status = "okay";isl1208@6f {compatible = "rtc,isl1208";reg = <0x6f>;}; };&uart1 {pinctrl-names = "default";pinctrl-0 = <&pinctrl_uart1>;status = "okay"; };

status節點表示是否啟用這個設備，okay表示啟動，disable表示禁用。
可以在不同板級的dts文件中為節點增加屬性，且每個板級的dts中都包含dtsi公共硬件信息。
節點屬性定義格式：屬性名 = 屬性值;
字符串使用""，數字使用<>，多個數字之間可用空格隔開。

注意：如果修改了設備樹文件中的內容，需要rebuild重新編譯工程，因為構建不會重新編譯.dts文件。

三.SylixOS設備樹常用API

讀取并啟用內核參數(choose節點)調用的API

CHAR pcStartParam[200];/* 設備樹初級初始化 */API_DeviceTreeLowLevelInit((PVOID)BSP_CFG_DTB_BASE); /* 操作系統啟動參數獲取 */ API_DeviceTreeKernelStartParamGet(pcStartParam, sizeof(pcStartParam));/* 操作系統啟動參數設置 */ API_KernelStartParam(pcStartParam);

讀取中斷資源(interrupts節點)調用的API

LW_DEV_RESOURCE irqResource;INT iRet;INT iIrqNum;ULONG ulVector;/* 獲取中斷資源 */iRet = API_DeviceTreeIrqCountGet(pdevNode);if (iRet<=0) { /* 錯誤處理 */ }iIrqNum = iRet; // 返回值為中斷資源數量 /* 轉換中斷號 */iRet = API_DeviceTreeIrqToResouceTable(pdevNode, &irqResource, iIrqNum);if (iRet<=0) { /* 錯誤處理 */ } /* 獲取中斷號 */ulVector = irqResource.irq.DEVRES_ulIrq;

讀取物理地址(reg節點)調用的API

LW_DEV_RESOURCE devResource;ULONG ulRegBase;/* 獲取控制器資源 */iRet = API_DeviceTreeRegAddressGet(pdevNode, &devResource); if (ERROR_NONE != iRet) { /* 錯誤處理 */ }/* 獲取基地址 */ ulRegBase = devResource.iomem.DEVRES_ulStart

讀取UINT32類型節點調用的API

UINT uiChanNum;/* 獲取 I2C 通道號 */iRet = API_DeviceTreePropertyU32Read(pdevNode, "port_num", &uiChanNum);if (ERROR_NONE != iRet) { /* 錯誤處理 */ }

讀取string類型節點調用的API

CPCHAR phy_node;/* 獲取PHY節點 */iRet = API_DeviceTreePropertyStringRead(pdevNode, "phy-node", &phy_node);if (ERROR_NONE != iRet) { /* 錯誤處理 */ }

讀取孩子節點調用的API

/* 通過此函是可獲取傳入節點的孩子節點數量 */ static INT __ChildNumGet (PLW_DEVTREE_NODE pDevNode) {PLW_DEVTREE_NODE pdtnChild;INT iCount = 0;/* 遍歷該節點的宏 */_LIST_EACH_CHILD_OF_NODE(pDevNode, pdtnChild) {iCount++;}return (iCount); } PLW_DEVTREE_NODE pChildNode[iCount];//iCount為孩子節點數量/* 獲取當前節點的第一個孩子節點 */pChildNode[0] = API_DeviceTreeNextChildGet(pdevNode, LW_NULL);for (i = 1; i < iCount; ++i) {pChildNode[i] = API_DeviceTreeNextChildGet(pdevNode, pChildNode[i-1]);}/* 通過獲取到的孩子節點結構體再去獲取孩子節點屬性信息 */

四.在BSP中的使用設備樹

設備樹需要預留空間，預留的空間需要在text段和data段前面，在芯片定義的內存空間范圍內，長度1MB即可。text段起始位置就是ram加上設備樹長度以此類推。

#define BSP_CFG_DTB_BASE (BSP_CFG_RAM_BASE) #define BSP_CFG_DTB_SIZE (1 * LW_CFG_MB_SIZE)#define BSP_CFG_TEXT_BASE (BSP_CFG_DTB_BASE + BSP_CFG_DTB_SIZE) #define BSP_CFG_TEXT_SIZE (6 * LW_CFG_MB_SIZE)#define BSP_CFG_DATA_BASE (BSP_CFG_TEXT_BASE + BSP_CFG_TEXT_SIZE) #define BSP_CFG_DATA_SIZE (64 * LW_CFG_MB_SIZE)

編譯設備樹需要在config.mk中把啟用設備樹的變量改為yes

#********************************************************************************************************* # Dts Build options (yes or no) #********************************************************************************************************* BSP_IF_BUILD_DTS = yes

在Makefile中也有相關設備樹編譯內容

#********************************************************************************************************* # DTC build #********************************************************************************************************* ifeq ($(BSP_IF_BUILD_DTS), yes) ifeq ($(HOST_OS),windows) DTC_TOOLS_PATH := res/tools/dtc.exe else DTC_TOOLS_PATH := dtc endif DTC_TMP_FILE := res/dts/tmp/$(BSP_BASE_NAME)_$(BOARD).dtc.tmp DTC_CPP_FLAGS := -nostdinc -Ires/dts -undef -D__DTS__ DTS_FILE := res/dts/$(BOARD)_$(BSP_POST_NAME).dts DTB_FILE := ../$(OUTDIR)/strip/bsp$(BSP_BASE_NAME)_$(BOARD)_$(BSP_POST_NAME).dtb$(DTB_FILE): $(DTS_FILE)@mkdir -p res/dts/tmp;@mkdir -p ../$(OUTDIR)/strip;$(CPP) $(DTC_CPP_FLAGS) -x assembler-with-cpp -o $(DTC_TMP_FILE) $(DTS_FILE);$(DTC_TOOLS_PATH) -I dts -O dtb $(DTC_TMP_FILE) -o $(DTB_FILE)TARGETS := $(DTB_FILE) $(TARGETS) endif

在bspInit.c中的halBootThread函數中需要把這個接口（設備樹外設節點加載初始化入口）放在使用設備樹初始化函數的下面。

#if (LW_CFG_DEVTREE_EN > 0) && (BSP_CFG_USE_DEVTREE > 0)API_DeviceTreeDefaultPopulate(); #endif

需要用以下宏包含使用設備樹的部分，當開啟設備樹時編譯設備樹部分。

#if (LW_CFG_DEVTREE_EN > 0) && (BSP_CFG_USE_DEVTREE > 0) #endif

使用設備樹需要定義的頭部

#define __SYLIXOS_DEVTREE_DRV #include "devtree/devtree.h"

驅動中的設備框架

/*********************************************************************************************************設備樹相關定義 *********************************************************************************************************/ #if (LW_CFG_DEVTREE_EN > 0) && (BSP_CFG_USE_DEVTREE > 0) /********************************************************************************************************* ** 函數名稱: __imx6ullUartProbe ** 功能描述: UART 驅動加載函數 ** 輸　 入: pdtDev 設備樹節點 ** 輸　 出: ERROR_CODE ** 全局變量: ** 調用模塊: *********************************************************************************************************/ static INT __imx6ullUartProbe (PLW_DEV_INSTANCE pdtDev) {PLW_DEVTREE_NODE pdtnDev = pdtDev->DEVHD_pdtnDev;/* 獲取硬件信息并初始化UART驅動創建sio設備 */return (ERROR_NONE); } /*********************************************************************************************************匹配表 *********************************************************************************************************/ static LW_DEVTREE_TABLE _G_imx6ullUartMatch[] = {{.DTITEM_cCompatible = "fsl,imx6ull-uart",},LW_DEVTREE_TABLE_END }; /*********************************************************************************************************UART 驅動實例全局變量 *********************************************************************************************************/ static LW_DRV_INSTANCE _G_imx6ullUartDriver = {.DRVHD_pcName = "imx6ull-uart",.DRVHD_pMatchTable = _G_imx6ullUartMatch,.DRVHD_pfuncProbe = __imx6ullUartProbe, }; /********************************************************************************************************* ** 函數名稱: uartDriverInstall ** 功能描述: UART 控制器驅動安裝 ** 輸　入 : NONE ** 輸　出 : NONE ** 全局變量: ** 調用模塊: *********************************************************************************************************/ VOID uartDriverInstall (VOID) {API_PlatformDriverRegister(&_G_imx6ullUartDriver); } #endif /* LW_CFG_DEVTREE_EN */

匹配表中的DTITEM_cCompatible屬性就是需要與設備樹中設備節點的compatible屬性匹配即可使用該節點。
驅動提供uartDriverInstall()接口，調用此接口接口初始化串口驅動。

編譯完bsp后可以先把dtb文件加載到定義的設備樹起始位置，再把.bin文件加載到text起始位置，然后即可啟動；或者直接使用.elf文件，把elf文件加載到系統起始位置即可。

*設備樹反匯編
.dtb文件可以通過DTC反匯編為.dts文件，找到dtc.exe，將.dtb為文件放在該DTC目錄下，在bash中執行下面一段指令：

dtc.exe -I dtb -O dts xxx.dtb -o xxx.dts

總結

以上是生活随笔為你收集整理的SylixOS 设备树的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。