学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--02-Device-Tree-Deep-Dive

01_Learning · 第 13 / 23 篇

第 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. 写一个板级属性的固定流程

  1. 在 rk3576.dtsi 找控制器 label 和现有资源,只读,不修改。
  2. 在 rk3576-pinctrl.dtsi 找候选引脚组,只读,并和原理图核对。
  3. 在实际驱动中搜索 device_property_read_*、devm_clk_*、reset_control_*,确认属性名和行为。
  4. 只在你的 rk3576-industrial-lab.dtsi 覆盖节点。
  5. 先做 git diff --check,再构建 DTB;启动后验证 probe、pinctrl、IRQ 和波形。

6. DTS 故障对照

现象首先检查不应立刻做的事
驱动没有 probecompatible、status、实际 DTB修改驱动日志或寄存器
probe 报缺 clock/reset属性名和 label、节点 include 顺序在驱动中忽略错误
接口存在但无引脚波形pinctrl-0、mode、收发器使能先改 CAN bit timing
IRQ 计数始终为零DTS IRQ、控制器 enable、事件来源盲目加轮询
DSMC 训练失败外接器件与时序、DQS、时钟提高频率或跳过训练
01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--01-Create-Your-Board-Config下一篇RK3576-Industrial-Bus-Driver-Course--03-Platform-Driver-From-Zero