设备节点:用树状结构精准描述硬件
设备树以树状结构记录板子上的设备信息,每个设备对应一个设备节点,节点通过键-值对属性来展现设备详情。下面结合核心内容,用通俗方式讲清设备节点的关键逻辑:
一、节点结构:根节点、子节点与命名规则
根节点唯一:设备树文件以“/”作为根节点,且一个设备树只有一个根节点。比如imx6ull.dtsi和imx6ull-alientek-emmc.dts都有“/”根节点,实际使用时这两个根节点的内容会合并,不会冲突。
子节点命名:根节点下会挂载子节点,像aliases、CPUs、intc都是常见的子节点。节点命名通常遵循“node-name@unit-address”的格式,node-name是能体现设备功能的名字,比如uartl对应UART1外设;unit-address一般是设备的地址或寄存器首地址,没有地址的节点可以省略这部分,像cpu@0、interrupt-controller@00a01000。
标签让访问更便捷:实际命名中常出现“label:node-name@unit-address”的格式,比如cpu0:cpu@0、intc:interrupt-controller@00a01000。这里的label是节点标签,核心作用是简化节点访问,直接用“&label”就能定位节点,比如通过&cpu0就能访问cpu@0,比输入长名字方便得多。
节点层级关系:节点可以嵌套,比如cpu0是cpus的子节点,形成树状层级,清晰体现设备的从属关系。
二、属性的常见数据形式
每个节点都靠属性描述信息,属性是键-值对,值可以是空字节流,常见的数据形式有三种:
字符串:比如compatible属性的值是"arm,cortex-a7",直接用字符串明确设备属性。
32位无符号整数:像reg属性可以设为单个值0,也能设成一组值,灵活适配地址、长度等数值类信息。
字符串列表:多个字符串用逗号分隔,比如compatible属性能同时设为"fsl, imx6ull-gpmi-nand", "fsl, imx6ul-gpmi-nand",通过多个字符串适配不同的驱动匹配场景。
标准属性:设备与驱动绑定的核心桥梁
节点属性分自定义和标准两类,标准属性是Linux外设驱动的通用“通行证”,核心标准属性如下:
1. compatible属性:驱动匹配的关键
这是最重要的属性,值是字符串列表,核心作用是把设备和驱动绑定。格式为“厂商, 模块驱动名”,比如sound节点的compatible属性是"fsl, imx6ul-evk-wm8960", "fsl, imx-audio-wm8960",其中fsl是厂商,后面的字符串是驱动名。
设备会按列表顺序查找匹配的驱动:先看第一个字符串,若内核中找不到对应驱动,再用第二个查找。而驱动文件会自带OF匹配表,比如imx-wm8960.c的匹配表里存了"fsl,imx-audio-wm8960",只要设备节点的compatible属性和匹配表里的值一致,设备就会用这个驱动,实现精准绑定。
2. model属性:描述设备模块信息
值是字符串,一般用来记录设备的名字或模块信息,比如model="wm8960-audio",简单直观地说明设备身份。
3. status属性:掌控设备状态
值是字符串,直接反映设备是否可操作,常用状态有:
"okay":设备可正常操作;
"disabled":设备当前不可操作,但后续可能恢复,比如热插拔设备插入后就能启用;
"fail":设备不可操作,且检测到错误,很难恢复;
"fail-xxx":和"fail"含义相同,xxx标注具体检测到的错误内容。
4. #address-cells和#size-cells属性:规划子节点地址
这两个属性的值是32位无符号整数,用在有子节点的设备上,专门描述子节点的地址信息:
#address-cells:决定子节点reg属性中“起始地址”占用的字长;
#size-cells:决定子节点reg属性中“地址长度”占用的字长。
reg属性的格式是(起始地址,地址长度),父节点的这两个属性,决定了子节点reg该怎么写。比如父节点设#address-cells=、#size-cells=,子节点reg就对应(0,0x4000),明确起始地址和长度。
5. reg属性:记录设备地址资源
reg属性的值是(起始地址,地址长度)对,用来描述设备的寄存器地址范围。比如uart1节点的reg属性,结合父节点的#address-cells和#size-cells设置,就能确定UART1的寄存器首地址,是硬件寻址的核心依据。
6. ranges属性:地址映射转换表
值可以是空,也可以是(子总线地址,父总线地址,地址长度)的格式,作用是实现地址映射。如果ranges为空,说明子地址空间和父地址空间完全一致,不需要转换;若非空,则按映射表完成地址转换,让设备能正确访问父总线资源。
7. name属性:已弃用的节点名记录
值是字符串,曾用于记录节点名字,但现在已被弃用,老设备树文件可能还会见到。
8. device_type属性:仅用于CPU和内存节点
值是字符串,原本用于IEEE 1275标准描述设备FCode,现在已被弃用,仅能在CPU节点或memory节点中使用,比如imx6ull.dtsi的cpu0节点就用了这个属性。
根节点compatible属性:内核识别设备的关键
根节点“/”也有compatible属性,它的核心作用是让内核识别当前使用的硬件设备,判断是否支持,进而决定能否启动内核。
1. 无设备树时的匹配逻辑
早期没有设备树,U-Boot会向Linux内核传递machine id(设备ID),内核通过MACHINE_START和MACHINE_END宏定义machine_desc结构体,描述支持的设备。内核会对比machine id和预定义的MACH_TYPE_XXX宏,若匹配成功,就说明支持该设备,允许启动内核,否则无法启动。
2. 引入设备树后的匹配逻辑
有了设备树后,匹配方式彻底改变:内核改用DT_MACHINE_START定义machine_desc,其中新增dt_compat成员,存设备的兼容值。内核启动时,会读取设备树根节点的compatible属性,和machine_desc的dt_compat列表逐一对比,只要有一个值匹配,就说明内核支持该设备,能正常启动。
比如imx6ull-alientek-emmc.dts根节点的compatible属性是"fsl, imx6ull-14x14-evk", "fsl, imx6ull",内核的imx6ul_dt_compat列表里有"fsl, imx6ull",两者匹配,开发板就能正常启动内核。若修改根节点compatible属性为不匹配的值,内核找不到对应设备,启动时会卡在“Starting kernel...”,再无后续输出,直接启动失败。
3. 内核匹配的核心流程
内核启动时,start_kernel函数会调用setup_arch函数,进一步调用setup_machine_fdt,最终通过of_flat_dt_match_machine函数,用根节点的compatible属性和内核中所有machine_desc的dt_compat列表比对,找到最匹配的machine_desc,完成设备识别,为后续内核初始化铺路。
节点追加:定制化设备树的安全方法
实际开发中,需要给已有节点添加子节点或修改属性,但不能影响其他板子,这就需要用“&label”的方式实现安全追加。
1. 直接修改的问题
比如imx6ull.dtsi里的i2c1节点,是所有用IMX6ULL的板子共用的。若直接在i2c1节点下添加fxls8471子节点,所有板子都会多出这个设备,而其他板子根本不需要,会引发冲突。
2. 安全的追加方式
正确做法是在板级专属的设备树文件(如imx6ull-alientek-emmc.dts)中,用“&节点标签”的方式操作:
通过&i2c1定位到imx6ull.dtsi中的i2c1节点;
在花括号内添加新属性、新子节点,或修改原有属性。
比如在i2c1节点中,可新增clock-frequency属性,把status从"disabled"改成"okay",还能按需添加fxls8471子节点。这些修改仅影响当前板级设备树,不会波及其他板子,完美实现硬件定制与通用描述的分离,是设备树定制化的核心技巧。