第 4 章:RK3576 CAN 驱动——按调用链阅读和修改
本章的源码对象是 kernel-6.1/drivers/net/can/rockchip/rk3576_can.c。不要先复制驱动写一个私有 /dev/can0;RK3576 的正确路径是驱动注册 SocketCAN 网络设备,应用通过 CAN raw socket 或 can-utils 访问它。
1. 先建立真实映射
| 层级 | RK3576 中的对象 |
|---|---|
| DTS 节点 | can0: can@2ac00000、can1: can@2ac10000 |
| 匹配字符串 | rockchip,rk3576-can |
| Kconfig | CONFIG_CAN_RK3576 |
| 驱动文件 | drivers/net/can/rockchip/rk3576_can.c |
| 用户接口 | can0/can1 网络设备与 PF_CAN socket |
先在源码中定位全部入口:
cd /home/user/workspace/RK3588/kernel-6.1
rg -n 'rk3576_can_(probe|open|start_xmit|interrupt|rx_poll|err|remove)' \
drivers/net/can/rockchip/rk3576_can.c
2. 私有结构:驱动要长期保存什么
源码约在 330 行定义 struct rk3576_can。重点不是逐字背诵,而是把字段按生命周期分组:
struct rk3576_can {
struct can_priv can; /* SocketCAN 状态、时序、ctrlmode */
struct napi_struct napi; /* 接收下半部 */
struct clk_bulk_data *clks;
struct reset_control *reset;
void __iomem *base; /* MMIO 基地址 */
struct dma_chan *rxchan;
u32 *rxbuf;
dma_addr_t rx_dma_dst_addr;
bool use_dma;
};
can_priv 必须嵌入私有结构,CAN 核心会使用它。base 只在时钟和 reset 已准备好后访问。DMA 的 CPU 虚拟地址 rxbuf 与 DMA 地址 rx_dma_dst_addr 不能混用:CPU 通过前者读取,DMA 引擎使用后者。
3. probe:从 DTS 到网络接口
rk3576_can_probe() 在约 1148 行。按下列小段读。
3.1 取得 IRQ 与寄存器
irq = platform_get_irq(pdev, 0);
if (irq < 0)
return -ENODEV;
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
addr = devm_ioremap_resource(&pdev->dev, res);
if (IS_ERR(addr))
return -EBUSY;
这两个动作对应 DTS 的 interrupts 和 reg。devm_ioremap_resource() 还会检查地址范围冲突。若此处失败,先看运行时 DTB 和 SoC 节点,绝不先改 CAN 寄存器。
3.2 分配 CAN 设备并取得 clock/reset
ndev = alloc_candev(sizeof(struct rk3576_can), 1);
rcan = netdev_priv(ndev);
rcan->reset = devm_reset_control_array_get(&pdev->dev, false, false);
rcan->num_clks = devm_clk_bulk_get_all(&pdev->dev, &rcan->clks);
rcan->can.clock.freq = clk_get_rate(rcan->clks[0].clk);
alloc_candev(..., 1) 的第二个参数表示 echo skb 槽位数量;发送后,skb 必须保存到 echo 槽,直到 TX 完成 IRQ 才回收。clock rate 是 SocketCAN 计算 bit timing 的输入,所以 DTS 中 CAN clock 的实际频率不能错。
3.3 告诉 CAN 核心驱动能力
rcan->can.bittiming_const = &rk3576_can_bittiming_const;
rcan->can.do_set_mode = rk3576_can_set_mode;
rcan->can.do_get_berr_counter = rk3576_can_get_berr_counter;
rcan->can.do_set_bittiming = rk3576_can_set_bittiming;
rcan->can.ctrlmode_supported = CAN_CTRLMODE_LOOPBACK |
CAN_CTRLMODE_LISTENONLY;
这里是“硬件能力到 SocketCAN”的边界。若你增加一个新模式,不能只加寄存器位:还要确认 CAN 核心 ctrlmode、ip link 语义、停止/启动路径和错误恢复是否匹配。
3.4 注册顺序
驱动在 register_candev() 前先开启 runtime PM、初始化 NAPI;注册后再申请 IRQ。阅读错误标签时检查反向顺序:注册失败必须删除 NAPI、释放 coherent DMA buffer、释放 DMA channel、关闭 PM 并 free_candev()。这正是 SDK 级驱动审查的重点。
4. 接口启动:为什么先 reset 再配寄存器
调用链是:ip link set can0 up → ndo_open → rk3576_can_open → rk3576_can_start。
rk3576_can_start() 的关键顺序如下:
set_reset_mode(ndev);
rk3576_can_write(rcan, CAN_INT_MASK, INT_ENABLE);
rk3576_can_atf_config(ndev, CAN_ATF_MASK_MODE);
/* 配置 storage、loopback/listen-only、retry、DMA */
rk3576_can_set_bittiming(ndev);
set_normal_mode(ndev);
bit timing 必须在 reset mode 配置。set_reset_mode() 还通过 reset controller assert/deassert 让硬件回到已知状态;不应把它替换成“只写 MODE=0”,否则硬件残留状态可能导致偶发故障。
位时序编码的核心在 rk3576_can_set_bittiming():
brp = (bt->brp >> 1) - 1;
sjw = bt->sjw - 1;
tseg1 = bt->prop_seg + bt->phase_seg1 - 1;
tseg2 = bt->phase_seg2 - 1;
reg_btp = (brp << NBTP_NBRP_SHIFT) | (sjw << NBTP_NSJW_SHIFT) |
(tseg1 << NBTP_NTSEG1_SHIFT) | (tseg2 << NBTP_NTSEG2_SHIFT);
rk3576_can_write(rcan, CAN_NBTP, reg_btp);
这解释了为什么 ip link 的 bitrate、sample point 与实际输入 clock 都重要。不要自行改变右移、减一或字段位宽;它们来自硬件寄存器的编码规则。
5. 发送路径:skb 到 CAN mailbox
应用写 socket 后,CAN 核心调用 rk3576_can_start_xmit()。函数先拒绝不合法 skb,再停止队列防止继续占用同一个发送资源:
if (can_dropped_invalid_skb(ndev, skb))
return NETDEV_TX_OK;
netif_stop_queue(ndev);
随后将 SocketCAN 的 can_id、EFF/RTR flag 和 DLC 翻译为硬件字段,并逐 word 写 TX 数据寄存器。最后两句是发送正确性的关键:
can_put_echo_skb(skb, ndev, 0, 0);
rk3576_can_write(rcan, CAN_CMD, cmd);
先保存 echo skb,再下发命令。TX 完成中断中以 can_get_echo_skb() 回收它、累计字节数并 netif_wake_queue()。如果你在发送函数里提前 dev_kfree_skb(),TX 完成路径就会 double free 或统计错误。
6. 接收、NAPI 与中断
硬 IRQ rk3576_can_interrupt() 不应循环读取所有帧。它发现 RX timeout/watermark/full 后屏蔽相应 RX 中断,并调度 NAPI:
rk3576_can_write(rcan, CAN_INT_MASK,
ISM_WTM_INT | RX_STR_TIMEOUT_INT | RX_FINISH_INT);
napi_schedule(&rcan->napi);
rk3576_can_rx_poll() 在软中断上下文批量读 FIFO,调用 rk3576_can_rx()。该函数用 alloc_can_skb() 得到 CAN 核心拥有的 skb,把硬件 DLC/ID/RTR 格式转换回来,再 netif_rx(skb) 上送。NAPI 完成时重新打开中断;这避免高收包率下每一帧都触发硬 IRQ。
7. 错误与 bus-off
rk3576_can_err() 读取 CAN_RXERRORCNT、CAN_TXERRORCNT 与 CAN_STATE,分配 error skb,再上送 CAN_ERR_BUSOFF 或控制错误。错误帧同样是 SocketCAN 数据,不应只打印日志。面对 bus-off,先采集:
ip -details -statistics link show can0
dmesg | tail -n 200
cat /proc/interrupts | grep -i can
无 ACK、波特率不一致、CANH/CANL 接反、终端电阻错误和收发器 standby 都会使错误计数增长。先判断 TX 引脚、收发器输出和总线差分信号分别是否存在,再怀疑 rk3576_can_err()。
8. 最小验证顺序
ip link set can0 down
ip link set can0 type can bitrate 500000
ip link set can0 up
ip -details -statistics link show can0
再使用可靠对端运行 candump can0 和 cansend can0 123#11223344。单节点测试不能证明 ACK;只有本机 loopback 也不能证明 CAN 收发器、线缆和终端正确。
9. 第一个可交付改动
建议第一个 CAN 任务只做板级改动,例如为已确认的收发器 enable/standby GPIO 增加 regulator 或 GPIO 描述,并完成双节点收发、断线、无 ACK、重启接口四种测试。不要把“重写 CAN 驱动”当作入门任务。