跳至主要內容

5.16 CAN设备

学习阁2026/7/20大约 31 分钟设备驱动驱动CAN总线车联网

5.16 CAN设备

📚 本节导读

学习时长: 约 40 分钟
难度级别: ⭐⭐⭐⭐☆
前置知识: C 语言基础、CAN 总线协议基础、5.1 设备驱动框架

🎯 学习目标

  • 理解 OneOS CAN 设备驱动框架的分层设计
  • 掌握 CAN 消息的发送与接收（阻塞/非阻塞）
  • 掌握 CAN 过滤器（Filter）的配置与使用
  • 理解 CAN 波特率、工作模式（Normal/Loopback/Listen）的配置
  • 了解 CAN 状态监控与总线错误处理
  • 掌握 CAN 中断 ISR 处理（os_hw_can_isr_rxdone / os_hw_can_isr_txdone）

一、概述

CAN（Controller Area Network）是一种广泛应用于汽车电子、工业控制等领域的现场总线协议。OneOS 将 CAN 控制器抽象为设备，提供统一的收发、配置、控制接口。CAN 设备驱动位于 drivers/can/ 目录下，核心头文件为 can.h，实现文件为 can.c。

CAN 设备框架的特点：

  • 统一抽象：将不同 MCU 平台的 CAN 控制器统一封装为 os_can_device_t
  • 消息邮箱机制：内置 RX/TX FIFO 消息队列，支持配置邮箱大小
  • 过滤器支持：支持标准帧/扩展帧/远程帧的硬件过滤器配置，可选 OS_CAN_USING_HDR 回调模式
  • 状态监控：支持总线错误计数、收发统计、状态变化通知
  • 多模式支持：Normal（正常）、Loopback（回环）、Listen（监听）、Loopback+Listen 四种模式

1.1 使用场景

一句话核心：CAN 用于多节点、抗干扰、实时性好的现场总线通信。OneOS CAN 框架负责"统一抽象收发 + 过滤 + 状态监控"，让应用专注于业务报文，不必关心底层寄存器。

与 UART（串口）总线对比：

维度CANUART
多节点支持（总线式，地址在帧里）一般点对点
传输距离远（1Mbps 可达 40m，速率降距离增）较短
抗干扰强（差分信号 + 位填充 + CRC）较弱
多主竞争支持（仲裁机制）不支持
错误处理内置错误检测/重发/离线简单
典型场景汽车 ECU、工业总线简单设备间通信

结论：多节点、远距离、强实时、抗干扰场景用 CAN（汽车/工业）；简单点对点短距用 UART。

典型应用场景：

场景谁在用实际工作情况
汽车车身网络ECU 之间每个 ECU 用过滤只收自己关心的 ID，其余报文硬件过滤丢弃，减轻 CPU 负载
工业设备控制PLC/传感器现场总线多节点，周期交换状态报文，靠滤波/状态监控保证实时性与可靠性
机器人关节驱动器/主控高频发送控制指令、接收位置反馈，Loopback 模式可先自发自收调试
车载诊断诊断仪/ECU标准帧 + 远程帧请求数据，听模式（Listen）可抓总线报文分析

选型边界表（何时不该用 CAN）：

场景该用什么为什么
点对点短距离低速UART/I2C/SPICAN 协议开销大，简单场景过重
高速大数据量（如视频）Ethernet/USBCAN 2.0 最高 1Mbps，带宽有限（CAN-FD 才更高）
极低成本LIN/单线CAN 需要收发器，成本高

结合源码的使用注意点：

  • 波特率必须一致：总线上所有节点波特率必须相同，否则收不到/误码；用 OS_CAN_CMD_SET_BAUD 配置；
  • 过滤器谨慎配置：过滤不当会漏收关键报文（ID 不匹配）或收太多（掩码太宽）；
  • 邮箱大小权衡：RX 邮箱（rx_msgbox_size）太小在突发报文时溢出（dropedrcvpkg 增长）；
  • 收发 FIFO 并发安全：框架用 gs_device_lock 自旋锁 + can->lock 互斥锁保护，应用侧 os_can_read/write 是线程安全的。

二、核心数据结构

2.1 CAN 消息结构体 struct os_can_msg

来源：drivers/can/can.h

字段详解（源码注释为英文原版，下表补充说明，不属于源码）：

字段位宽含义
id29 bitCAN 消息 ID：标准帧 11bit（0x000~0x7FF），扩展帧 29bit
ide1 bit扩展帧标识：OS_CAN_STDID(0)=标准帧，OS_CAN_EXTID(1)=扩展帧
rtr1 bit远程帧标识：OS_CAN_DTR(0)=数据帧，OS_CAN_RTR(1)=远程帧
rsv1 bit保留位
len8 bit数据长度，CAN 2.0 支持 0~8 字节
priv8 bit消息发送优先级（启用 privmode 时生效）
hdr8 bit（有符号）硬件过滤器表编号（OS_CAN_USING_HDR 模式），-1 表示未绑定
reserved8 bit保留位
data[8]——数据段，最多 8 字节

位域布局演算 —— os_can_msg 按位打包：

os_can_msg 把多个标志用位域压缩进 32 位内存，紧接 8 字节数据：

32 位（bit31 .. bit0）位域打包：
┌───────────────────────────┬────┬────┬────┬────────────────────────────────────┐
│   id(29 bit)              │ide │rtr │rsv │  len(8)  │ priv(8) │ hdr(8) │res(8)│
│  bit28..bit0              │bit29│bit30│bit31│ (紧接下一字节起)                    │
└───────────────────────────┴────┴────┴────┴────────────────────────────────────┘
数据区：data[0..7]（8 字节）
位域位范围最大取值典型含义
idbit0~bit280x1FFFFFFF（29bit）标准帧只用低 11bit
idebit290/10=标准，1=扩展
rtrbit300/10=数据，1=远程
rsvbit310保留

关键理解：os_can_msg 是一个位打包紧凑结构，id 占 29 bit、ide/rtr/rsv 各占 1 bit，正好凑满 4 字节的头部（占 32 bit），后面跟着 8 字节数据。发送/接收时把该结构按内存布局交给硬件，硬件能直接读出 ID、帧类型、长度。标准帧的 id 只用到低 11 bit（0x7FF），扩展帧用满 29 bit。

2.2 CAN 设备结构体 struct os_can_device

来源：drivers/can/can.h

字段详解（源码无注释，下表补充说明，不属于源码）：

字段含义
parent首成员继承 os_device，使 CAN 设备可作普通设备注册/读/写
opsCAN 操作函数表（configure/control/start_send/start_recv 等，见 2.6）
configCAN 配置参数（波特率、邮箱大小、模式、优先级等）
status状态统计（收发计数、错误计数等，见 2.5）
status_indicate状态变化回调（ind 函数指针 + args）
hdrHDR 过滤器控制块数组（OS_CAN_USING_HDR 时存在）
bus_hook总线错误钩子（OS_CAN_USING_BUS_HOOK 时存在）
lock互斥锁，保护设备并发访问（发送/收发队列）
can_rx接收 FIFO（os_can_rx_fifo，含 freelist/datalist 两条链表）
can_tx发送 FIFO（os_can_tx_fifo）

关键理解 —— parent 首成员继承：parent 是第一个成员，&can->parent 与 &can 地址数值相等。os_hw_can_register 里 device = &(can->parent)，把 can_device_ops 挂到 parent.ops，并 os_device_register(device, name)——因此 CAN 设备通过 os_device_find 找到后，强转回 os_can_device* 即可访问 config/status/can_rx 等。

2.3 CAN 配置结构体 struct can_configure

来源：drivers/can/can.h

字段详解（源码无注释，下表补充说明，不属于源码）：

字段含义
baud_rate波特率（bit/s），用波特率枚举值，如 CAN500kBaud=500000
rx_msgbox_size接收邮箱数（默认 OS_CAN_RX_MSGBOX_SZ=16）
tx_msgbox_size发送邮箱数（默认 OS_CAN_TX_MSGBOX_SZ=1）
mode工作模式（NORMAL/LISEN/LOOPBACK/LOOPBACKANLISEN）
privmode优先级模式（OS_CAN_MODE_PRIV/NOPRIV）
reserved保留
ticks超时 tick 数
maxhdr最大 HDR 过滤器数（OS_CAN_USING_HDR 时存在）

波特率枚举（drivers/can/can.h，与项目逐字一致，含 CAN800kBaud）：

枚举值宏展开值（bit/s）实际波特率
CAN1MBaud1000 * 10001 Mbps
CAN800kBaud1000 * 800800 kbps
CAN500kBaud1000 * 500500 kbps
CAN250kBaud1000 * 250250 kbps
CAN125kBaud1000 * 125125 kbps
CAN100kBaud1000 * 100100 kbps
CAN50kBaud1000 * 5050 kbps
CAN20kBaud1000 * 2020 kbps
CAN10kBaud1000 * 1010 kbps

关键理解：枚举值直接用实际波特率数值（bit/s），如 CAN500kBaud == 500000。所以配置 config.baud_rate = CAN500kBaud 就是设置 500kbps，不需要再换算。默认配置宏 CANDEFAULTCONFIG 把波特率设为 CAN1MBaud、RX=16、TX=1、mode=OS_CAN_MODE_NORMAL。

工作模式：

宏定义值说明
OS_CAN_MODE_NORMAL0正常收发模式
OS_CAN_MODE_LISEN1只听模式（不发送 ACK，用于总线监听）
OS_CAN_MODE_LOOPBACK2回环模式（自发自收，用于测试）
OS_CAN_MODE_LOOPBACKANLISEN3回环+监听模式

2.4 CAN 过滤器结构体 struct os_can_filter_item

来源：drivers/can/can.h

字段详解（源码注释为英文原版，下表补充说明，不属于源码）：

字段含义
id要过滤的 CAN ID
ide帧类型：0=标准帧，1=扩展帧
rtr帧类型：0=数据帧，1=远程帧
mode过滤模式：0 = ID 列表模式（精确匹配单个 ID），1 = ID 掩码模式
maskID 掩码，1 表示对应位必须匹配、0 表示不关心
hdr对应的过滤器控制块编号（硬件过滤器表槽位）
ind过滤器命中回调（OS_CAN_USING_HDR 时存在）
args回调参数

过滤器初始化宏（drivers/can/can.h，与项目逐字一致）：

#define OS_CAN_FILTER_STD_INIT(id, ind, args)          OS_CAN_FILTER_ITEM_INIT(id, 0, 0, 0, 0xFFFFFFFF, ind, args)
#define OS_CAN_FILTER_EXT_INIT(id, ind, args)          OS_CAN_FILTER_ITEM_INIT(id, 1, 0, 0, 0xFFFFFFFF, ind, args)
#define OS_CAN_STD_RMT_FILTER_INIT(id, ind, args)      OS_CAN_FILTER_ITEM_INIT(id, 0, 1, 0, 0xFFFFFFFF, ind, args)
#define OS_CAN_EXT_RMT_FILTER_INIT(id, ind, args)      OS_CAN_FILTER_ITEM_INIT(id, 1, 1, 0, 0xFFFFFFFF, ind, args)
#define OS_CAN_STD_RMT_DATA_FILTER_INIT(id, ind, args) OS_CAN_FILTER_ITEM_INIT(id, 0, 0, 1, 0xFFFFFFFF, ind, args)
#define OS_CAN_EXT_RMT_DATA_FILTER_INIT(id, ind, args) OS_CAN_FILTER_ITEM_INIT(id, 1, 0, 1, 0xFFFFFFFF, ind, args)

说明：以上宏展开为 OS_CAN_FILTER_ITEM_INIT，其参数顺序为 (id, ide, rtr, mode, mask, ind, args)，mask=0xFFFFFFFF 表示 ID 完全匹配（掩码全 1）。不同宏仅 ide/rtr/mode 组合不同：

宏idertrmode过滤语义
OS_CAN_FILTER_STD_INIT000标准数据帧，ID 精确匹配
OS_CAN_FILTER_EXT_INIT100扩展数据帧，ID 精确匹配
OS_CAN_STD_RMT_FILTER_INIT010标准远程帧
OS_CAN_EXT_RMT_FILTER_INIT110扩展远程帧
OS_CAN_STD_RMT_DATA_FILTER_INIT001标准数据帧，掩码模式
OS_CAN_EXT_RMT_DATA_FILTER_INIT101扩展数据帧，掩码模式

关键理解 —— 过滤如何匹配：mask 中为 1 的位，要求收到帧的 ID 与 id 对应位相同；mask 中为 0 的位不关心。mask = 0xFFFFFFFF 表示所有位都必须匹配（即 ID 完全相等）。若想过滤"某段 ID 区间"，可把 mask 中不关心的位清 0。

过滤匹配数值演算（标准帧 11bit ID）：

配置收帧 ID是否命中说明
id=0x123、mask=0x7FF0x123✅ 命中全 1 掩码，完全相等
id=0x123、mask=0x7FF0x120❌ 不命中bit1 不同，掩码要求匹配
id=0x120、mask=0x7E0（bit0~4 置 0）0x121✅ 命中bit0~4 不关心，高位相同
id=0x120、mask=0x7E00x100❌ 不命中bit6 不同，掩码要求匹配

2.5 CAN 操作函数表 struct os_can_ops

函数指针说明
configure配置 CAN 控制器（波特率、模式等）
control控制命令（设置过滤器、获取状态等）
start_send启动硬件发送一帧 CAN 消息
stop_send停止硬件发送
start_recv启动硬件接收（提供缓冲区）
stop_recv停止硬件接收
recv_state获取接收状态

2.6 CAN 状态结构体 struct os_can_status

来源：drivers/can/can.h

字段详解（源码无注释，下表补充说明，不属于源码）：

字段含义
rcverrcnt接收错误计数
snderrcnt发送错误计数
errcode错误码
rcvpkg接收成功包数
dropedrcvpkg接收丢弃包数
sndpkg发送成功包数
dropedsndpkg发送丢弃包数
bitpaderrcnt位填充错误计数
formaterrcnt格式错误计数
ackerrcntACK 错误计数
biterrcnt位错误计数
crcerrcntCRC 错误计数
rcvchange接收状态变化标记（收到新帧置 1）
sndchange发送状态变化标记（发出新帧置 1）
lasterrtype最后错误类型

总线错误类型（drivers/can/can.h，与项目逐字一致）：

枚举值含义
OS_CAN_BUS_NO_ERR无错误
OS_CAN_BUS_BIT_PAD_ERR位填充错误（违反填充规则）
OS_CAN_BUS_FORMAT_ERR格式错误（帧字段不符合协议）
OS_CAN_BUS_ACK_ERRACK 错误（无节点应答）
OS_CAN_BUS_IMPLICIT_BIT_ERR隐位错误（应发隐性却读到显性）
OS_CAN_BUS_EXPLICIT_BIT_ERR显位错误（应发显性却读到隐性）
OS_CAN_BUS_CRC_ERRCRC 错误（校验不通过）

关键理解 —— 状态如何产生：rcvpkg/sndpkg 在 ISR 中累加（见 5.4/5.5），rcvchange/sndchange 标记"有变化"供应用轮询。这些计数用于监控总线健康：例如 dropedrcvpkg 持续增长说明 RX 邮箱溢出，ackerrcnt 增长说明总线上没有其他节点应答。

三、设备操作接口

CAN 设备继承自 os_device_t，通过设备框架的标准接口进行访问：

接口实现函数说明
initos_can_init初始化 CAN 设备：分配 RX/TX FIFO，配置硬件
deinitos_can_deinit去初始化：停止收发，释放 FIFO 内存
reados_can_read → _can_int_rx从 RX FIFO 读取 CAN 消息
writeos_can_write → _can_int_tx向 TX FIFO 写入 CAN 消息
controlos_can_control控制命令分发（过滤器/波特率/模式/状态）

四、关键 API

4.1 设备注册

os_err_t os_hw_can_register(struct os_can_device *can,
                             const char           *name,
                             const struct os_can_ops *ops,
                             void                 *data);
  • can: CAN 设备控制块指针
  • name: 设备名称（如 "can0"、"can1"）
  • ops: CAN 操作函数表，由 HAL 层实现
  • data: 用户私有数据
  • 返回: OS_SUCCESS 注册成功

注册后设备类型为 OS_DEVICE_TYPE_CAN，可通过 os_device_open("can0") 打开使用。

4.2 中断 ISR 处理函数

函数签名（drivers/can/can.c，与项目逐字一致）：

void os_hw_can_isr_rxdone(struct os_can_device *can);
void os_hw_can_isr_txdone(struct os_can_device *can, int event);
函数触发时机职责
os_hw_can_isr_rxdone(can)HAL 层在 CAN RX 中断中调用从 freelist 取一个空闲缓冲区加入 datalist，rx_count++，os_device_recv_notify 唤醒读取任务，用下一个空闲缓冲区重启接收
os_hw_can_isr_txdone(can, event)HAL 层在 CAN TX 中断中调用按 event 更新发送结果（OK/ERR），归还缓冲区，os_device_send_notify 唤醒等待任务，若还有排队消息则继续发送

这两个函数是框架层回调，由各厂商 CAN 驱动的中断服务函数调用（详见 5.4 与第八章适配）。

事件类型：

宏定义值说明
OS_CAN_EVENT_RX_IND0x01接收指示
OS_CAN_EVENT_TX_DONE0x02发送完成
OS_CAN_EVENT_TX_FAIL0x03发送失败
OS_CAN_EVENT_RX_TIMEOUT0x05接收超时
OS_CAN_EVENT_RXOF_IND0x06接收溢出

4.3 控制命令

通过 os_device_control() 发送 CAN 专用控制命令：

命令说明
OS_CAN_CMD_SET_FILTER设置硬件过滤器
OS_CAN_CMD_SET_BAUD设置波特率
OS_CAN_CMD_SET_MODE设置工作模式
OS_CAN_CMD_SET_PRIV设置优先级模式
OS_CAN_CMD_GET_STATUS获取 CAN 总线状态
OS_CAN_CMD_SET_STATUS_IND设置状态变化回调
OS_CAN_CMD_SET_BUS_HOOK设置总线错误钩子

五、核心源码详解

说明：以下源码均取自 drivers/can/can.c，与项目源码逐字一致（含原始英文注释）。

5.1 _can_int_rx —— 从 RX FIFO 读取消息

一句话定位：从接收 FIFO 的 datalist 取出一条或多条已接收消息给应用，并把用过的缓冲区归还到 freelist。

完整源码（drivers/can/can.c，与项目一致）：

分步详解：

第 1 步：循环读取，直到 msgs 条取完或无数据（条件 size < msgs）

    for (size = 0; size < msgs; size += sizeof(struct os_can_msg))
    {
        os_spin_lock_irqsave(&gs_device_lock, &level);
        if (os_list_empty(&rx_fifo->datalist))
        {
            os_spin_unlock_irqrestore(&gs_device_lock, level);
            break;
        }

详细解释：msgs 是应用请求的字节数（应为 sizeof(os_can_msg) 的整数倍）。每次锁住 gs_device_lock（防止与中断竞争），若 datalist 为空（没有已接收消息），解锁并 break。加锁是关键——os_hw_can_isr_rxdone 在中断里也操作 datalist，必须用自旋锁保护。

第 2 步：取队首消息并归还缓冲区（无条件执行）

详细解释：从 datalist 取出队首消息，rx_count--，解锁后把数据拷给应用。然后再次加锁，把这块缓冲区归还到 freelist。关键点：若 freelist 此前为空（说明硬件接收缓冲区耗尽），调用 can->ops->start_recv 重新启动一个接收缓冲区，保证硬件持续能收。

_can_int_rx() 条件走向总结：

5.2 _can_int_tx —— 向 TX FIFO 写入消息

一句话定位：从 TX freelist 取缓冲区填入待发消息，若发送队列空则立即启动硬件发送。

完整源码（drivers/can/can.c，与项目一致）：

分步详解：

第 1 步：取一个空闲发送缓冲区（条件 freelist 为空则退出）

详细解释：从 freelist 取一个空闲缓冲区 tx_tosnd（并用 OS_ASSERT 确保非空），tx_count++ 表示进入发送流程，把消息数据填入。freelist 空说明发送缓冲区都占用了（上一次还没发完），直接 break。

第 2 步：发送队列空则立即启动硬件（条件 datalist 为空）

详细解释：关键点：若 datalist 为空（当前没有正在发送的消息），调用 ops->start_send 立即启动硬件发送；若 start_send 失败（返回非 0），回滚 tx_count 并把缓冲区归还 freelist。然后把该消息加入 datalist（排队）。为什么 datalist 非空就不启动：说明硬件正在发送前一条，等 TX 中断（os_hw_can_isr_txdone）完成后会取下一条继续发。

_can_int_tx() 条件走向总结：

5.3 os_can_init —— 初始化设备

一句话定位：应用 configure 配置硬件，分配并初始化 RX/TX FIFO（缓冲区 + 双链表）。

完整源码（drivers/can/can.c，与项目一致）：

分步详解：

第 1 步：应用硬件配置（条件 ops->configure 存在）

    /* apply configuration */
    if (can->ops->configure)
        can->ops->configure(can, &can->config);

详细解释：把设备配置 config（波特率/模式/邮箱大小）下发给 HAL 层 configure，配置硬件 CAN 控制器。

第 2 步：分配并初始化 RX FIFO（无条件执行）

详细解释：os_calloc 一次性申请 rx_msgbox_size 个消息缓冲区（rx_fifo + 1 指向紧跟在结构体后的缓冲区数组首元素），OS_ASSERT 确保分配成功。把所有缓冲区都挂到 freelist（空闲链表），os_list_init 初始化两条链表。can->can_rx = rx_fifo 绑定接收队列，start_recv 用第一个缓冲区启动硬件接收。

第 3 步：分配并初始化 TX FIFO（无条件执行）

详细解释：TX FIFO 结构与 RX 对称，同样一次性分配 tx_msgbox_size 个缓冲区、初始化 freelist/datalist，且把每个缓冲区的 result 初始化为 OS_CAN_SND_RESULT_OK（发送结果默认成功）。最后 can->can_tx = tx_fifo 绑定发送队列，CAN_UNLOCK 释放互斥锁，返回 OS_SUCCESS。

os_can_init() 条件走向总结：

5.4 中断 ISR os_hw_can_isr_rxdone / os_hw_can_isr_txdone

一句话定位：由 HAL 层在 CAN 中断中调用，完成消息从硬件到 FIFO 的搬运和唤醒。

完整源码（drivers/can/can.c，与项目一致）：

分步详解：

第 1 步：统计并取一个空闲缓冲区（无条件执行）

详细解释：接收包数 +1，置接收变化标记。从 freelist 取一个空闲缓冲区（收到一帧），移到 datalist（可读队列），rx_count++，并 os_device_recv_notify 唤醒等待 read 的任务。

第 2 步：用下一个空闲缓冲区重新启动接收（条件 还有空闲缓冲区）

    listmsg = os_list_first_entry_or_null(&rx_fifo->freelist, struct os_can_msg_list, list);
    if (listmsg != OS_NULL)
        can->ops->start_recv(can, &listmsg->data);
}

详细解释：关键点：用 freelist 里下一个空闲缓冲区调用 start_recv 重新启动硬件接收，让 CAN 控制器能继续收下一帧（循环利用缓冲区）。

os_hw_can_isr_txdone（发送完成中断，处理对称）：

分步详解：

第 1 步：按事件记录结果（条件 event == TX_DONE）

详细解释：event 是发送结果。TX_DONE（0x02）表示发送成功，记录成功包数；否则记录失败（dropedsndpkg++）。

第 2 步：归还缓冲区并发送下一条（无条件执行）

详细解释：把发完的缓冲区归还 freelist，tx_count--，通知等待发送的任务。关键点：若 datalist 还有排队消息（下一条），调用 start_send 继续发送，形成"发送流水线"。

os_hw_can_isr_rxdone() 条件走向总结：

os_hw_can_isr_txdone() 条件走向总结：

六、使用示例

6.1 CAN 发送示例

6.2 CAN 接收示例（阻塞等待）

6.3 CAN 过滤器配置示例

说明：过滤器 mode=0 是列表模式（ID 精确匹配）、mode=1 是掩码模式（mask 中 1 的位必须匹配）。actived=1 表示激活这些过滤项，0 表示停用。

6.4 CAN 状态监控示例

6.5 HAL 层注册示例

七、内部实现机制

7.1 RX FIFO 机制

CAN 框架使用 RX FIFO 管理接收消息，核心是两个链表：

  freelist（空闲缓冲区）          datalist（已接收数据）
  ┌──────┐  ┌──────┐           ┌──────┐  ┌──────┐
  │ buf0 │→│ buf1 │→...       │ buf2 │→│ buf3 │→...
  └──────┘  └──────┘           └──────┘  └──────┘
       ↑ ISR 取走                     │ os_device_read() 取走
       │                              ↓
       └────────── 归还 ──────────────┘

接收流程：

  1. HAL 层 CAN RX 中断触发 → 调用 os_hw_can_isr_rxdone()
  2. 从 rx_fifo->freelist 取一个空闲缓冲区
  3. 填充数据后加入 rx_fifo->datalist
  4. can->parent.rx_count++，调用 os_device_recv_notify() 唤醒等待读取的任务
  5. 应用层调用 os_device_read() 时从 datalist 取出数据，归还到 freelist

7.2 TX FIFO 机制

  freelist（空闲缓冲区）          datalist（排队发送）
  ┌──────┐  ┌──────┐           ┌──────┐  ┌──────┐
  │ buf0 │→│ buf1 │→...       │ buf2 │→│ buf3 │→...
  └──────┘  └──────┘           └──────┘  └──────┘
       ↑ os_device_write() 取走        │ ISR 发送完成
       │                               ↓
       └────────── 归还 ──────────────┘

发送流程：

  1. 应用层调用 os_device_write() → _can_int_tx()
  2. 从 tx_fifo->freelist 取一个空闲缓冲区，填入数据
  3. 加入 tx_fifo->datalist，如果 datalist 之前为空，立即调用 ops->start_send() 启动硬件发送
  4. HAL 层 CAN TX 中断触发 → 调用 os_hw_can_isr_txdone()
  5. 更新发送结果（OK/ERR），归还缓冲区，检查 datalist 中是否还有排队消息，有则继续发送

7.3 并发保护

  • 设备级互斥锁: can->lock 互斥量，在 os_can_init/os_can_deinit 中使用
  • 中断安全锁: gs_device_lock 自旋锁，在 RX/TX FIFO 操作中使用，保护中断上下文与任务上下文之间的并发访问

八、CAN 的适配（接入新 MCU 的 CAN 控制器）

8.1 先认识适配层：CAN 框架是怎么"长"到芯片上的

drivers/can/can.c 是跨平台统一的框架层（FIFO 队列、中断 ISR 搬运、设备注册、并发保护），不碰具体寄存器。真正操作 CAN 控制器的是各厂商 HAL 驱动，例如 ST 的 drivers/hal/st/drivers/drv_can.c。换 MCU 就是换这份 drv_can.c。

适配全景图：

适配的关键洞察：接入新 CAN 控制器要做两件事：① 实现 struct os_can_ops 全部回调（configure/control/start_send/start_recv 等）；② 在厂商中断回调里调用 os_hw_can_isr_rxdone/os_hw_can_isr_txdone，把硬件事件通知给框架。框架层不用改。

8.2 以 ST 为例，看一整套适配代码

以 drivers/hal/st/drivers/drv_can.c 为例（与项目逐字一致，去除无关部分展示关键结构）：

① 实现 os_can_ops —— 全部回调：

static const struct os_can_ops stm32_can_ops = {
    .configure  = stm32_can_config,
    .control    = stm32_can_control,
    .start_send = stm32_can_start_send,
    .stop_send  = stm32_can_stop_send,
    .start_recv = stm32_can_start_recv,
    .stop_recv  = stm32_can_stop_recv,
    .recv_state = stm32_can_recv_state,
};

要点：configure 里把框架的 can_configure（波特率/模式）换算成 HAL 的 Prescaler/TimeSeg 并 HAL_CAN_Init；control 分发过滤/模式/波特率/状态命令；start_send/start_recv 使能对应中断。

② 实现厂商中断回调 → 调框架 ISR（收发完成/失败通知框架）：

要点：收到帧时，先 stm32_can_recvmsg 把 HAL 的 CAN_RxHeaderTypeDef 转成框架的 os_can_msg（填 id/ide/rtr/len/data），再 os_hw_can_isr_rxdone 通知框架入 FIFO。发送完成/失败分别传 OS_CAN_EVENT_TX_DONE/OS_CAN_EVENT_TX_FAIL。

③ 通过驱动框架注册设备（OS_DRIVER_INFO + probe）：

要点：OS_DRIVER_INFO 用 "CAN_HandleTypeDef" 匹配板级配置表里的 HAL 句柄，probe 里 dev->info 取到 hcan，初始化 config 后用 os_hw_can_register 注册。用 OS_INIT_LEVEL_PRE_DEVICE 在设备层前初始化。

8.3 接口契约：接入 CAN 需要实现什么

层接口/回调职责对应 8.2 ST 代码
驱动注册os_hw_can_register把 CAN 设备挂进框架stm32_can_probe
操作回调os_can_ops.configure波特率/模式 → HAL 初始化stm32_can_config
操作回调os_can_ops.control过滤/模式/波特率/状态控制stm32_can_control
操作回调os_can_ops.start_send/start_recv使能收发中断stm32_can_start_send/recv
中断通知os_hw_can_isr_rxdone收帧入 FIFO + 唤醒HAL_CAN_RxFifo*Callback
中断通知os_hw_can_isr_txdone发完成/失败通知框架HAL_CAN_TxMailbox*Callback
初始化时机OS_DRIVER_DEFINE设备层前注册OS_INIT_LEVEL_PRE_DEVICE

8.4 适配新 MCU 的标准流程

第 1 步：确认 CAN 外设能力——查手册确认控制器类型（经典 CAN/CAN-FD）、邮箱数量、滤波器支持情况。

第 2 步：新建厂商 drv_can.c——在厂商 HAL 目录新建，定义厂商私有结构（含 struct os_can_device can 首成员继承，实现 os_can_ops 全部回调）。

第 3 步：实现收发底层——start_send 调 HAL 发送并登记 rx_msg；实现厂商中断回调，把 HAL 句柄转成 os_can_msg 后调 os_hw_can_isr_*。

第 4 步：注册设备——写 probe（dev->info 取 HAL 句柄、初始化 config、os_hw_can_register），配 OS_DRIVER_INFO/OS_DRIVER_DEFINE。

第 5 步：板级配置——在 board/peripherals.c 用 OS_HAL_DEVICE_DEFINE("CAN_HandleTypeDef", "can0", hcan) 之类把 HAL 句柄实例化，probe 才能匹配到。

第 6 步：测试——先用 Loopback 模式自发自收验证收发链路，再上真实总线验证波特率和过滤。

8.5 适配检查清单（快速自查）

检查项说明
os_can_ops 全部回调都实现？漏一个则 start_send/start_recv 等被空调用，收不到/发不出
厂商私有结构首成员是 os_can_device？probe 里 &st_can->can 才能传给框架
收到帧后调了 os_hw_can_isr_rxdone？否则数据停在 HAL，进不了 FIFO，应用读不到
发送完成/失败调了 os_hw_can_isr_txdone？否则 tx_count 不减、等待发送的任务永久挂起
板级 OS_HAL_DEVICE_DEFINE 名字匹配 OS_DRIVER_INFO.name？不匹配则 probe 不触发，设备注册不上
波特率换算正确？波特率算错则总线上节点收不到数据

九、注意事项

  1. 中断上下文: os_hw_can_isr_rxdone 和 os_hw_can_isr_txdone 在 ISR 上下文中调用，内部操作应尽量简短
  2. 邮箱大小: rx_msgbox_size 决定了接收缓冲区数量，过小可能导致丢包；tx_msgbox_size 决定了发送缓冲区数量，影响发送吞吐量
  3. 过滤器配置: 过滤器配置通过 OS_CAN_CMD_SET_FILTER 控制命令下发到 HAL 层，硬件支持情况因 MCU 而异
  4. HDR 模式: 启用 OS_CAN_USING_HDR 后，每个过滤器条目可绑定回调函数，匹配的消息直接通过回调处理，不经过 FIFO
  5. 总线错误处理: 启用 OS_CAN_USING_BUS_HOOK 后，可注册 bus_hook 回调处理总线错误事件（Bus-Off 恢复等）
  6. 波特率必须一致: 总线上所有节点波特率必须相同，否则收不到/误码；用 OS_CAN_CMD_SET_BAUD 配置

十、驱动文件位置

文件路径说明
can.hdrivers/can/can.hCAN 框架头文件，数据结构定义、API 声明
can.cdrivers/can/can.cCAN 框架实现，设备注册、中断处理、FIFO 管理
Kconfigdrivers/can/Kconfig编译配置选项
drv_can.c（示例）drivers/hal/st/drivers/drv_can.cST 厂商 CAN 适配层，实现 os_can_ops + 中断回调

📝 本节小结

核心要点回顾

本节围绕 CAN 设备展开，核心要点如下：

  1. 统一抽象：将不同 MCU 的 CAN 控制器封装为 os_can_device_t，HAL 层实现 os_can_ops，框架层在 drivers/can/、厂商适配在 drivers/hal/*/drivers/drv_can.c。
  2. 位打包消息：os_can_msg 用位域把 id(29bit)/ide/rtr/rsv 打包进 32 位头部，紧跟 8 字节数据，直接按内存布局交给硬件。
  3. 消息邮箱：内置 RX/TX FIFO（freelist + datalist 双链表），支持配置邮箱大小；_can_int_rx/_can_int_tx 负责应用与 FIFO 之间的搬运。
  4. 中断 ISR：os_hw_can_isr_rxdone（收帧入队 + 重新启动接收）、os_hw_can_isr_txdone（记结果 + 发送下一条），由厂商中断回调调用。
  5. 过滤器：支持标准/扩展/远程帧的硬件过滤器（列表/掩码模式），mask 全 1 = 完全匹配，可选 HDR 回调模式。
  6. 多模式：Normal / Loopback / Listen / Loopback+Listen 四种工作模式。
  7. 并发保护：can->lock 互斥量（设备级）+ gs_device_lock 自旋锁（FIFO 操作）。
  8. 硬件适配：接入新 CAN = 实现 os_can_ops 全部回调 + 厂商中断回调调 os_hw_can_isr_* + OS_DRIVER_INFO/probe 注册。

关键易错点速查

易错点正确做法
read/write 的 size 不是 sizeof(msg) 的整数倍一次读写按 sizeof(struct os_can_msg) 的倍数进行，否则 _can_int_rx/tx 循环步进错乱
邮箱过小导致丢包/发送阻塞rx_msgbox_size/tx_msgbox_size 决定缓冲区数，按消息速率合理配置
在 ISR 里做耗时操作os_hw_can_isr_rxdone/txdone 在中断上下文执行，应保持简短
过滤器 mask 理解错误mask=1 表示该位必须匹配，mask=0 不关心；列表模式全部匹配、掩码模式按掩码过滤
忽略 HDR/总线钩子的条件编译HDR（OS_CAN_USING_HDR）和总线钩子（OS_CAN_USING_BUS_HOOK）需对应 Kconfig 开启才生效
未调用 start_recv 循环续收收帧后若 freelist 非空会用新缓冲区重启接收；freelist 耗尽时 _can_int_rx 归还时会重启，不要漏
总线波特率不一致总线上所有节点波特率必须相同，否则收不到/误码；用 OS_CAN_CMD_SET_BAUD 配置
把 os_can_msg 当普通结构按字节赋值id/ide/rtr 是位域，应按字段赋值；不要用 memcpy 从网络字节序直接填
适配漏调 os_hw_can_isr_rxdone/txdone收帧/发完不通知框架，数据进不了 FIFO、发送任务永久挂起

下一步

掌握了 CAN 总线设备后，接下来学习 FAL Flash 抽象层：

  • 5.17 FAL设备：了解 OneOS 的分区表定义、FAL 分区读写擦与 Flash 设备抽象。
OneOS-Lite 文档 | 学习阁
Copyright © 2026 学习阁