学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--08-Debugging-and-Capstone

01_Learning · 第 19 / 23 篇

第 8 章:完整 Debug 手册与毕业项目

调试的目标不是尽快“改到能跑”,而是用最少的实验确定故障层级。下面的流程适用于 CAN、RS485 和 DSMC;不要跳过前一层直接在后一层加日志。

1. 固定的八层排查模型

1. 外部电气:供电、地、收发器、终端、线缆、波形
2. 引脚:pinctrl、复用 mode、引脚冲突、电压域
3. 时钟/复位/电源域:控制器是否具备运行条件
4. 设备树与绑定:实际 DTB、compatible、资源名、status
5. probe:资源申请、初始化、错误返回、动态日志
6. 硬件数据路径:寄存器、FIFO、IRQ、DMA、错误计数
7. 内核子系统:SocketCAN、TTY/serial core、DSMC region
8. 用户态协议:参数、帧格式、并发、对端行为

任何“收不到数据”至少可能是八层中任意一层。上层接口存在不证明下层正确:CAN 网络设备存在不证明收发器已上电;tty 节点存在不证明 DE 时序正确;DSMC probe 成功不证明高频 DMA 稳定。

2. 通用证据包

每个问题修改前采集以下内容:

目标板和硬件版本:
SDK 和内核提交:
实际使用的 defconfig 与 DTB:
完整 DTS 节点及其 include 链:
启动到故障的原始 dmesg:
关键 IRQ 计数与寄存器:
测试命令、对端、线缆和参数:
波形/抓包:
正常对象的对比:

不要只贴截取后的最后一行错误。比如 -EPROBE_DEFER 与 -ENODEV 的处理方向完全不同;CAN 的 TX error count 与 RX error count 指向的物理问题也不同。

3. CAN 专用 Debug 路线

  1. ip link show can0 不存在:检查运行 DTB、CONFIG_CAN_RK3576、probe 日志。
  2. can0 up 后无 TX 引脚波形:检查 pinmux、clock、reset、CAN mode 和收发器 enable。
  3. TX 有波形而对端无数据:检查 CANH/CANL、共地、终端、收发器 standby、bitrate。
  4. TX error 增长:优先怀疑 ACK/物理总线;单节点无 ACK 是正常现象。
  5. RX IRQ 增长但应用无帧:检查 NAPI、FIFO/DMA、netif_rx() 和 socket filter。
  6. bus-off:保留 ip -details -statistics link show、错误帧、IRQ 和波形,确认恢复策略而不是反复 down/up 掩盖故障。

4. RS485 专用 Debug 路线

  1. 先记录 stty -F <tty> -a 或应用实际 termios,而非口头描述“115200”。
  2. 用逻辑分析仪同时观察 TX 与 DE/RTS;用示波器观察 A/B 差分。
  3. 无发送:检查 RTS pinmux、DE 极性和收发器使能。
  4. 丢首字节:看 DE 是否晚于 TX 起始位。
  5. 丢尾字节:看 DE 是否早于最后 stop bit 完成。
  6. 乱码:在检查 driver 前先确认共地、终端/偏置、波特率、校验位和对端协议。

5. DSMC TEST1 专用 Debug 路线

  1. 确认使用 rk3576-test1-v10-linux,并确认 CONFIG_ROCKCHIP_DSMC=y。
  2. 将频率固定为当前 25 MHz,禁止先提高频率。
  3. 按 dsmc-host.c 的 probe 顺序确定首个失败点:DT parse、GRF、clock/reset、DMA、controller init、memory remap、DLL training、status check。
  4. 对应测量 CLK、CS、DQS、DQ、RDYN/INT,确认主从角色和方向。
  5. PIO 固定 pattern 和地址 pattern 通过后,才用 DMA 测试;DMA 失败要单独检查 cache 与映射属性。

6. 动态日志、trace 与寄存器

优先使用已有 dev_dbg/netdev_dbg 的动态调试能力,不要永久增加 printk。ftrace 可用于确认函数是否进入、IRQ 是否调度 NAPI;寄存器 dump 仅在已知寄存器语义下采集。不要向未知寄存器写值来“试试看”。

将每一个测试设计为判别实验:例如 TX 有无波形可区分“pinmux/控制器未启动”与“总线无 ACK”;DE 与 TX 时序可区分“驱动方向控制”与“协议帧解析”;DLL training failure 则不能用用户态 mmap 来绕过。

7. 三个毕业项目

项目一:RK3576_industrial 自建板级配置

按第 1 章创建独立 DTS 与 SDK defconfig,构建并启动。验收:/proc/device-tree/model 显示新 model;CAN0、CAN1、UART1 行为与基线一致;提交不修改 SoC .dtsi。

项目二:CAN 或 RS485 板级功能

选择一项真实硬件需求:CAN 收发器 enable/standby、CAN pin group 切换、UART1 RS485 极性确认或方向控制验证。验收:提供 DTS diff、双节点收发、至少一种故障注入、波形和回归结果。

项目三:RK3576 TEST1 DSMC LocalBus

在不提高 25 MHz 的前提下,验证一个原理图确认的 region:probe 成功、固定/地址 pattern、region 映射边界和 DMA。验收:说明 region 属性、cache 约束、异常路径和不能做的操作。

8. SDK 级交付检查表

  • 新板级改动只在 board DTS/DTSI,不改 SoC 公共文件。
  • Kconfig、DTS compatible、Makefile 和 defconfig 均已核对。
  • 正常路径和每个失败路径都已审查资源释放。
  • 已用真实硬件验证,而非只看 insmod 或 probe 成功。
  • 有电气/波形或可靠对端的证据。
  • 有反复启停、重启和至少一种异常测试。
  • 提交说明包含硬件条件、构建步骤、测试命令、结果、限制与回滚方式。
01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--07-Kernel-Mechanisms-for-Bus-Drivers下一篇Linux-Factory-Test--01-Linux-Factory-Test-C-Tutorial