1. 课程导入

在嵌入式 Linux 系统中，设备树（Device Tree，简称 DT）承担着“把硬件描述从内核代码中剥离出来”的关键角色。它用一棵可读的树形数据结构，向内核说明板子上有哪些设备、这些设备挂在哪条总线上、使用哪些寄存器地址、中断号、时钟、GPIO 和电源资源。正因如此，设备树一旦写错，问题往往不会以“编译失败”的形式暴露，而是表现为驱动不探测、设备节点缺失、时钟未使能、中断收不到、系统启动卡死等隐蔽故障。本课程的目标，就是帮助你把设备树从“看得懂”推进到“改得对、查得快、定位准”。

一、学习目标：从读懂到定位

本课程围绕三条能力主线展开。第一条是结构理解能力：能读懂 .dts、.dtsi、.dtb 之间的关系，理解节点、属性、compatible、reg、interrupts、clocks、status 等核心属性的语义。第二条是调试观测能力：熟练使用 /proc/device-tree、/sys/firmware/devicetree、of_node、debugfs、dmesg 等入口观察运行时设备树状态。第三条是故障定位能力：面对“驱动不加载”“probe 失败”“资源冲突”“启动挂起”等典型问题，能沿着设备树—驱动—资源—硬件的链路逐层缩小范围。

二、核心概念：设备树不是配置文件，而是硬件契约

很多初学者把设备树当成“内核配置文件”，这是最常见的认知误区。设备树本质上是硬件与驱动之间的匹配契约。驱动通过 of_match_table 中的 compatible 字符串去匹配设备树节点；匹配成功后，驱动再从节点中解析 reg、interrupts、clocks 等资源。因此，设备树写错一个属性名、拼错一个 compatible、漏掉一个 status = "okay"，都可能导致驱动“静默地不工作”。

需要重点建立的概念包括：compatible 是匹配键；reg 描述地址与长度；interrupt-parent 与 interrupts 描述中断路由；clocks 与 clock-names 描述时钟资源；pinctrl 描述引脚复用；status 控制节点使能。理解这些概念，是后续所有调试动作的基础。

三、整体知识框架与实战路线图

本课程的知识框架可以概括为“一条主线、四个层次、三类工具”。一条主线是“设备树生命周期”：源码编写 → 编译打包 → 内核解析 → 驱动匹配 → 资源申请 → 运行时观测。四个层次分别是语法层、编译层、内核解析层和驱动匹配层。三类工具是静态检查工具（dtc、dt-validate）、运行时观测工具（procfs、sysfs、debugfs）和日志分析工具（dmesg、dynamic debug）。

四、典型场景与误区复盘

先看一个真实场景：某板卡上的 I2C 触摸屏无法工作。工程师首先怀疑驱动，但实际排查发现，设备树中触摸屏节点的 status 被写成了 "disabled"，导致内核根本没有创建对应设备。把 status 改为 "okay" 后，驱动立即 probe 成功。这个案例说明：设备树问题经常伪装成驱动问题。

# 查看运行时设备树中触摸屏节点是否存在
ls /proc/device-tree/soc/i2c@13860000/
# 查看 status 属性内容
cat /proc/device-tree/soc/i2c@13860000/touchscreen@38/status
# 查看内核日志中的匹配与 probe 信息
dmesg | grep -i -E "i2c|touch|probe"

常见误区主要有四类。第一，把 compatible 写成驱动不认识的字符串，导致匹配失败。第二，reg 地址与硬件手册不一致，驱动读写错误寄存器。第三，中断属性缺失或 interrupt-parent 指向错误，导致中断无法注册。第四，忽略 pinctrl 与 clocks，设备虽然匹配成功，但引脚未复用或时钟未使能，最终 probe 返回 -EPROBE_DEFER 或超时。

本课程的实战路线图是：先掌握设备树语法与编译流程，再理解内核如何解析设备树并生成平台设备，然后学习驱动匹配与资源申请机制，最后通过真实故障案例训练定位能力。每一章都会围绕“现象—检查—判断—修复—验证”的闭环展开，让你在动手过程中形成稳定的调试直觉。