学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--04-RK3576-CAN-Driver

01_Learning · 第 15 / 23 篇

第 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
KconfigCONFIG_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 驱动”当作入门任务。

01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--03-Platform-Driver-From-Zero下一篇RK3576-Industrial-Bus-Driver-Course--05-RK3576-RS485-Driver