第 2 章:设备树从语法到 RK3576 工业总线资源
设备树不是“让设备出现的开关”。它是内核驱动获得硬件资源的合同。本章将 RK3576 CAN、UART1 和 DSMC 节点拆开解释,并给出写新板级节点的固定方法。
1. 节点如何绑定驱动
RK3576 的 CAN0 节点在 rk3576.dtsi 中,核心内容如下:
can0: can@2ac00000 {
compatible = "rockchip,rk3576-can";
reg = <0x0 0x2ac00000 0x0 0x1000>;
interrupts = <GIC_SPI 121 IRQ_TYPE_LEVEL_HIGH>;
clocks = <&cru CLK_CAN0>, <&cru HCLK_CAN0>;
clock-names = "baudclk", "apb_pclk";
resets = <&cru SRST_CAN0>, <&cru SRST_H_CAN0>;
reset-names = "can", "can-apb";
status = "disabled";
};
compatible 与 rk3576_can.c 的 of_match_table 匹配,匹配成功后调用该驱动的 probe。reg 提供 MMIO 空间;interrupts 对应 platform_get_irq();时钟与复位由驱动获取;板级 DTS 再把 status 改为 okay 并选择实际引脚。
2. CAN 板级覆盖逐项解释
&can0 {
assigned-clocks = <&cru CLK_CAN0>;
assigned-clock-rates = <200000000>;
pinctrl-names = "default";
pinctrl-0 = <&can0m0_pins>;
status = "okay";
};
assigned-clocks 和 assigned-clock-rates 是板级对时钟父级/频率的要求。RK3576 CAN 驱动会读取 baudclk 的实际 rate,用它计算 bit timing;因此总线 bitrate 不对时,必须同时采集 ip -details link show can0 与实际 clock,而不是只改 ip link 参数。
can0m0_pins 是 SoC pinctrl 文件中定义的引脚组。选择错误 mode 可能导致驱动正常 probe、CAN 接口也能 up,但 TX 引脚没有波形。实际引脚还必须与原理图和收发器连接一致。
3. UART1 RS485 节点的真实含义
SoC 节点为 serial@27310000,兼容字符串包含 rockchip,rk3576-uart 与 snps,dw-apb-uart,并给出了两个 DMA 请求。Industry EVB 覆盖层选择:
&uart1 {
pinctrl-0 = <&uart1m0_xfer &uart1m0_rtsn>;
linux,rs485-enabled-at-boot-time;
status = "okay";
};
uart1m0_xfer 是 TX/RX,uart1m0_rtsn 是硬件方向控制相关的 RTS_N 引脚。linux,rs485-enabled-at-boot-time 让 serial core 在启动时把 RS485 配置交给 UART 驱动。它不保证板上 DE/RE 接线、收发器电源、极性或终端正确;这些只能靠原理图与波形确认。
4. DSMC 节点为何不能照抄启用
RK3576 DSMC 节点拥有两个 DMA 请求、四个时钟、两个复位、一个 GRF 句柄、一个 IRQ 和多个 child node。仅把 status 改为 okay 会让 dsmc-host.c 开始设置时钟、访问 IO mux GRF、执行 DLL training 并映射外部区域。如果实验板没有匹配的从设备与信号连接,可能导致持续超时或不可靠访问。
启用前必须补齐下列设计输入:从设备类型(PSRAM 或 LocalBus)、主从角色、CS、IO 位宽、region 地址范围、时钟模式、MTR timing、DQS/DLL 参数、外部电平和波形。第 6 章给出完整实现路径。
5. 写一个板级属性的固定流程
- 在
rk3576.dtsi找控制器 label 和现有资源,只读,不修改。 - 在
rk3576-pinctrl.dtsi找候选引脚组,只读,并和原理图核对。 - 在实际驱动中搜索
device_property_read_*、devm_clk_*、reset_control_*,确认属性名和行为。 - 只在你的
rk3576-industrial-lab.dtsi覆盖节点。 - 先做
git diff --check,再构建 DTB;启动后验证 probe、pinctrl、IRQ 和波形。
6. DTS 故障对照
| 现象 | 首先检查 | 不应立刻做的事 |
|---|---|---|
| 驱动没有 probe | compatible、status、实际 DTB | 修改驱动日志或寄存器 |
| probe 报缺 clock/reset | 属性名和 label、节点 include 顺序 | 在驱动中忽略错误 |
| 接口存在但无引脚波形 | pinctrl-0、mode、收发器使能 | 先改 CAN bit timing |
| IRQ 计数始终为零 | DTS IRQ、控制器 enable、事件来源 | 盲目加轮询 |
| DSMC 训练失败 | 外接器件与时序、DQS、时钟 | 提高频率或跳过训练 |