学习 / TSENGCHEN BLOG

RK3576-Industrial-Bus-Driver-Course--07-Kernel-Mechanisms-for-Bus-Drivers

01_Learning · 第 18 / 23 篇

第 7 章:工业总线驱动必须掌握的内核机制

这一章解释 CAN、RS485 和 DSMC 源码反复出现的内核机制。目标是你看到某一行代码时能判断它运行在哪个上下文、能否睡眠、谁拥有资源,以及失败时应该怎么撤销。

1. 上下文决定 API 是否能用

上下文能否睡眠典型代码适合做什么
probe/remove可以devm_clk_get、dma_request_chan资源取得和初始化
进程上下文可以read、ioctl、netdev open用户请求、配置
硬 IRQ不可以CAN rk3576_can_interrupt读状态、确认、调度下半部
NAPI/软中断不应阻塞CAN rk3576_can_rx_poll批量收包
DMA callback不能假设可睡眠CAN RX callback最小处理、调度 NAPI

在 IRQ 中不能拿 mutex、不能 msleep()、不能执行可能等待硬件的长循环。DSMC 中短暂 udelay() 必须严格有上限并符合硬件序列;它不是替代完成中断的通用办法。

2. MMIO:读写不等于普通内存

控制器寄存器通过 readl()/writel() 访问。它们表达了 I/O 访问语义和必要的顺序要求;不要将 base + offset 强转为普通指针后解引用。读取状态寄存器、写一清中断、写命令触发传输三种操作的副作用不同,必须以 TRM 为准。

以 CAN 为例:IRQ 中先读取 CAN_INT,根据不同位执行处理,最后写回 CAN_INT。最后一步是硬件定义的 pending confirm;若遗漏,同一 IRQ 会不断触发;若过早清除,又可能丢失诊断信息。

3. 锁:先画共享数据,再选锁

锁不是越多越安全。先列出每个状态由谁访问:CAN 的发送队列由网络栈与 TX IRQ 协作,NAPI 与 IRQ 通过“屏蔽 RX 中断 → NAPI 完成后重开”协调;教学字符设备中的 last_value 被 IRQ 写、read() 取,因此使用 spinlock。

若一份数据只在 process context 使用,可以用 mutex;若硬 IRQ 会访问,使用 spinlock 或无锁原子方案。锁保护的是一致性边界,不是每个寄存器读写。不要持自旋锁调用会睡眠的 DMA 或 clock API。

4. NAPI:CAN 为什么不在 IRQ 内读完 FIFO

高负载 CAN 每帧进入硬 IRQ 会造成 IRQ 风暴。RK3576 驱动在 RX 事件时暂时屏蔽相关 RX 中断,调用 napi_schedule();rk3576_can_rx_poll() 按 quota 批量从 FIFO 或 DMA buffer 取帧,完成后 napi_complete_done() 并恢复中断。

写新接收路径时必须保证三件事:quota 有上限;每帧只上送一次;NAPI 完成前不会漏掉新事件。最常见错误是完成 NAPI 却忘记恢复 IRQ,造成“只收到第一批帧”。

5. DMA:四个地址与一个所有权

DMA 代码至少涉及:CPU 虚拟地址、物理地址、DMA 地址、设备地址。它们在有 IOMMU 或 cache 时不必相同。应通过 DMA API 获得并传递 DMA 地址,不要把 virt_to_phys() 当作通用做法。

RK3576 CAN 使用 dma_alloc_coherent() 分配 RX buffer,它对 CPU 与设备保持一致性;之后用 dmaengine_prep_slave_single() 建立设备到内存传输。DSMC 现有测试中会验证 DDR 与 DSMC 区域之间的 DMA,但只有在 region 映射和 cache 属性已正确时才有意义。

DMA 生命周期:分配 buffer → 配置 channel → 准备 descriptor → submit → issue pending → callback/timeout → 停止/terminate(需要时)→ 释放 channel 与 buffer。任何 probe 错误、close、suspend、remove 都必须覆盖这条反向路径。

6. runtime PM 与 suspend

CAN 驱动在 open 时 pm_runtime_get_sync(),在 close 时 pm_runtime_put()。其目的是接口未运行时允许硬件低功耗,运行时确保 clock/power 可用。新增寄存器访问不能绕过这一约束;否则设备 suspend 后可能在关钟状态访问 MMIO。

系统 suspend 更复杂:停止网络队列,禁止 NAPI/IRQ,保存必要状态,恢复后重新初始化并重新接入网络栈。第一次做驱动功能时先不扩展 PM;但必须确认新资源在现有 suspend/remove 中不会泄漏。

7. 错误路径的审查方法

每获得一项资源,就在纸上写它的释放动作。例:alloc_candev 对应 free_candev;DMA coherent buffer 对应 dma_free_coherent;DMA channel 对应 dma_release_channel;netif_napi_add 对应 netif_napi_del;register candev 对应 unregister。然后沿每个 goto 检查是否只释放已经取得的资源,且顺序反向。

SDK 驱动能否交付,常常取决于这部分,而不是正常收发的十几行代码。

01_Learning · 文档目录
上一篇RK3576-Industrial-Bus-Driver-Course--06-RK3576-DSMC-Driver下一篇RK3576-Industrial-Bus-Driver-Course--08-Debugging-and-Capstone