RK3576 INDUSTRY EVB 工业总线驱动从零到 SDK 级实战
本课程的最终目标不是“会改几个 DTS 属性”,而是让你能够在 RK3576 Industry EVB V10 的 SDK 中独立完成一个工业总线功能:分析硬件,创建自己的板级配置,写或修改驱动,构建镜像,在真实总线上验证,并定位复杂故障。
[toc]
课程使用的实际目标
本课程已根据本机 SDK 的实际内容编写,而非套用其他 Rockchip 型号的示例。目标与入口如下。
| 项目 | 实际值 |
|---|---|
| SDK 根目录 | /home/user/workspace/RK3588 |
| 内核目录 | kernel-6.1 |
| 板级 DTS | arch/arm64/boot/dts/rockchip/rk3576-industry-evb-v10.dts |
| 默认板级 include | rk3576-industry-evb.dtsi 与 rk3576-industry.dtsi |
| SDK defconfig | device/rockchip/.chips/rk3576/rockchip_rk3576_industry_evb_v10_defconfig |
| 默认 DTB 名称 | rk3576-industry-evb-v10.dtb |
| CAN 驱动 | drivers/net/can/rockchip/rk3576_can.c |
| UART/RS485 驱动 | drivers/tty/serial/8250/8250_dw.c、8250_dwlib.c |
| DSMC 主驱动 | drivers/memory/rockchip/dsmc-host.c |
RK3576_industrial 板级配置已启用 can0、can1 和带 linux,rs485-enabled-at-boot-time 的 uart1,它们是第一批真实硬件实验。DSMC 实验固定使用 RK3576_TEST1:其 rk3576-test1.dtsi 已启用 DSMC LocalBus 配置。两块板的 DTS、构建目标和验证步骤必须分开,不能把 TEST1 的 DSMC 属性直接复制到 Industry EVB。
先理解三个边界
板级配置不是 SoC 配置
rk3576.dtsi 描述 SoC:控制器寄存器地址、IRQ、时钟、reset 和所有可选 pin group。它是共享芯片文件,不能为了单块实验板而修改。你自己的板级 DTS/DTSI 只做覆盖:选择哪一个控制器、哪一组 pinmux、哪一种外接收发器和哪些板级 GPIO。
CAN、RS485 与 DSMC 不属于同一类驱动
CAN 是网络设备,必须接入 SocketCAN;RS485 是 UART 加差分收发器和方向控制,必须复用 serial core;DSMC 是内存/本地总线控制器,当前 SDK 有自己的 host、local-bus 和 slave 组件。不要把这三者都实现成同一种字符设备。
“代码能编译”不是完成
真正完成要同时满足:DTS 资源与原理图一致、probe 成功、寄存器状态正确、IRQ/DMA 能推进、用户态得到预期数据、总线波形正确、异常可解释且可恢复。
学习顺序
- 第 1 章:创建自己的板级 DTS 与 defconfig
- 第 2 章:设备树从语法到 RK3576 资源
- 第 3 章:内核驱动模型与完整最小驱动
- 第 4 章:RK3576 CAN 驱动完整阅读与开发
- 第 5 章:RK3576 UART RS485 驱动与完整测试代码
- 第 6 章:RK3576 DSMC 架构、源码与实现路径
- 第 7 章:中断、NAPI、DMA、并发与错误恢复
- 第 8 章:完整 Debug 手册与毕业项目
每次实验的强制记录
在开始改动前记录 SDK 提交、板号、原理图版本、DTS 文件、测试对端、线缆、波特率/时钟和串口日志位置。每次只验证一个假设,保留以下证据:DTS diff、构建命令、启动日志、关键寄存器、IRQ 计数、用户态输出和波形或抓包。
安全要求
不要在未知接线下启用 DSMC 或提高其频率;不要对客户设备刷写镜像;不要通过 /dev/mem 随机写控制器寄存器;不要因为 CAN 没有收包就同时改 pinmux、bitrate 和驱动。先保存现象,再沿本课程的分层路径定位。