嵌入式Linux设备树实战:零基础完成自定义外设节点的添加与调试
设备树本质是一份“硬件简历”,用树形节点告诉内核外设有哪些、寄存器在哪、中断几号、GPIO怎么连;驱动只按compatible去匹配,不把硬件地址写死在代码里。 芯片级通用描述放.dtsi,板级差异放.dts,板文件用&标签引用并覆盖属性即可。
一、最小自定义节点怎么写
假设SoC公共dtsi已定义soc、中断控制器intc、时钟clk_peri、GPIO控制器gpio0,且各自带label。板级dts添加一颗自定义控制外设:
/dts-v1/;
#include "soc-base.dtsi"
/ {
model = "myboard,ctrl-v1";
compatible = "myboard,ctrl";
soc {
#address-cells = <1>;
#size-cells = <1>;
ranges;
myctrl: myctrl@40000000 {
compatible = "mycorp,my-ctrl";
reg = <0x40000000 0x1000>;
interrupts = <0 32 4>; /* 按GIC/SoC手册改:类型/硬件号/触发 */
interrupt-parent = <&intc>;
clocks = <&clk_peri>;
rst-gpios = <&gpio0 12 0>; /* 可选复位脚,0按绑定解释 */
mycorp,mode = "industrial";
status = "okay";
};
};
};
要点:compatible用“厂商,型号”,驱动of_match要严格一致; reg格式由父节点#address-cells/#size-cells决定,上面1/1表示“地址 长度”各一个32位单元; interrupts含义看中断控制器#interrupt-cells,GIC常用“类型/SPI号/触发”,GPIO中断则看gpio节点的#interrupt-cells;status必须是okay,很多dtsi默认disabled,板级不打开就不会probe。
二、配套platform驱动取资源
#include <linux/platform_device.h>
#include <linux/of.h>
#include <linux/io.h>
static int myctrl_probe(struct platform_device *pdev)
{
struct resource *res;
void __iomem *base;
int irq;
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
if (!res) return -EINVAL;
base = devm_ioremap_resource(&pdev->dev, res);
irq = platform_get_irq(pdev, 0);
if (irq < 0) return irq;
dev_info(&pdev->dev, "probe ok, reg=%pr irq=%d\n", res, irq);
return 0;
}
static const struct of_device_id myctrl_of[] = {
{ .compatible = "mycorp,my-ctrl" },
{ }
};
MODULE_DEVICE_TABLE(of, myctrl_of);
static struct platform_driver myctrl_drv = {
.probe = myctrl_probe,
.driver = { .name = "my-ctrl", .of_match_table = myctrl_of },
};
module_platform_driver(myctrl_drv);
compatible字符串、dts节点、of_device_id三者必须完全一致,否则内核不会绑定。
三、编译与单文件校验
内核树内改完执行:
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- dtbs
单文件单独编:
dtc -W all -I dts -O dtb -o myboard.dtb myboard.dts
-W all把单位地址/reg不匹配、缺少属性等警告打开;dtc只查语法和部分语义,不会验证“硬件值对不对”。 绑定规范可跑:
make dtbs_check DT_SCHEMA_FILES=Documentation/devicetree/bindings/xxx.yaml
自写新compatible时,最好在Documentation/devicetree/bindings建YAML,规定reg、interrupts、clocks是否必填。
四、上板调试四步
1)确认dtb真的加载:看/boot或U-Boot启动参数,别改了源码却烧旧dtb; 运行期反查:
dtc -I fs -O dts /sys/firmware/devicetree/base > running.dts
cat /sys/firmware/devicetree/base/soc/myctrl@40000000/compatible
cat /sys/firmware/devicetree/base/soc/myctrl@40000000/status
2)看驱动绑定与probe:
dmesg | grep -E "my-ctrl|of_|platform_probe|deferred"
ls /sys/bus/platform/drivers/my-ctrl/
有节点不probe,优先查compatible拼写、status、驱动是否编进内核/加载模块。
3)资源问题分别查:
cat /proc/iomem | grep 40000000
cat /proc/interrupts | grep my-ctrl
cat /sys/kernel/debug/gpio
cat /sys/kernel/debug/pinctrl/*/pinmux-pins
reg访问oops多半是地址/长度或#address-cells不对;中断不来查interrupt-parent、硬件号、触发边沿;引脚不通查pinctrl-0是否引用、是否与别的外设复用同一脚。
4)EPROBE_DEFER别急着当错误:常是时钟、 regulator、GPIO控制器还没就绪;若一直defer再查对应phandle是否存在、状态是否okay。
五、新手避坑
改dtsi要谨慎,板级尽量只改.dts,用&label覆盖,避免破坏其他板子;
I2C子节点#size-cells通常0,reg只写从地址;平台内存总线才写“地址 长度”;
自定义属性用厂商前缀,如mycorp,mode,别和标准属性重名;
中断触发类型用DT头宏(IRQ_TYPE_EDGE_FALLING等)对应数值,写错会误触发或不触发;
overlay改外设要先给基础dtb加-@编译符号,U-Boot或configfs加载,缺符号会引用不到&label。
按“dtsi定底座—dts加节点—compatible对齐驱动—dtc/dtbs_check校验—上板看sysfs+dmesg”走,自定义UART、GPIO扩展、工业控制IP都能零基础补齐并快速定位不生效原因。





