当前位置:首页 > EDA > 电子设计自动化
[导读]设备树本质是一份“硬件简历”,用树形节点告诉内核外设有哪些、寄存器在哪、中断几号、GPIO怎么连;驱动只按compatible去匹配,不把硬件地址写死在代码里。 芯片级通用描述放.dtsi,板级差异放.dts,板文件用&标签引用并覆盖属性即可。


设备树本质是一份“硬件简历”,用树形节点告诉内核外设有哪些、寄存器在哪、中断几号、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都能零基础补齐并快速定位不生效原因。



本站声明: 本文章由作者或相关机构授权发布,目的在于传递更多信息,并不代表本站赞同其观点,本站亦不保证或承诺内容真实性等。需要转载请联系该专栏作者,如若文章内容侵犯您的权益,请及时联系本站删除( 邮箱:macysun@21ic.com )。
关闭