CAN

概述

RTL8721F 提供 CAN 接口,是一种支持标准或扩展帧标识符的多主实时控制网络串行总线。Rust 驱动 ameba_hal::can 直接封装 PAC 寄存器块,不涉及裸位操作或 C FFI 调用。

功能特性

  • 两个外设实例 CAN0_PTR 和 CAN1_PTR,均通过 Can::steal 访问

  • 标准 11 位或扩展 29 位帧标识符,通过 IdType::Standard / IdType::Extended 设置,数据帧或远程帧通过 FrameType::Data / FrameType::Remote 设置

  • 四种总线测试模式,通过 WorkMode::Normal / Silence / ExternalLoopback / InternalLoopback 设置,其中 InternalLoopback 可以在不接任何物理总线的情况下完成一帧的发送与接收

  • 可通过 BitTiming 手动配置位时序,也可通过 Can::calc_bit_timing 针对目标速率自动计算

  • 16 个 RAM 消息缓冲区,每个可独立配置为 TX 或 RX,并设置各自的 ID 过滤器和掩码,通过 write_msg / set_rx_msg_buf 操作,此外还有一个专用的 Rx FIFO 虚拟缓冲区,通过 read_rx_from_fifo 读取

  • 支持自动应答:缓冲区收到匹配的远程帧后可自动发送数据,通过 tx_auto_reply / rx_auto_reply 设置

  • 可为单个缓冲区配置 RX DMA,通过 msgbuf_ctrl_config 设置,并通过 rx_dma_dest_base_addr 将收到的帧直接写入 RAM

  • 通过 bus_status、err_cnt_status 以及独立的 TX/RX 错误计数器监控 bus-off 和 error-passive 状态

  • 通过 IntFlags 及各缓冲区独立的 TX/RX 中断使能位进行裸中断标志控制,需要轮询或由用户注册的 NVIC 处理函数处理,驱动本身不提供托管回调

备注

驱动提供的是 64 位数据字段的 CAN 2.0 消息缓冲区,由于 embedded-hal 尚未定义稳定的 CAN trait,该驱动未实现 embedded-hal CAN trait。

工作模式

CAN 只提供一种 Blocking 模式:所有传输都通过直接的、轮询驱动的寄存器访问完成。

Blocking 模式

CPU 通过 write_msg 写入消息缓冲区,并通过 msgbuf_tx_done 或裸中断标志检查完成情况,通过 read_msg 或 read_rx_from_fifo 读取收到的帧。驱动没有异步或 DMA 传输 API,RX DMA 仅用于将收到的帧直接拷贝进 RAM,并不负责 CPU 侧的发起和完成检查。

use ameba_hal::{
    can::{CAN0_PTR, Can, CanConfig, FrameType, IdType, TxMsg},
    pinmux::{self, Pin, PinFunction, Pull},
    println,
};
...
pinmux::set(Pin::PA25, PinFunction::CAN0_TX);
pinmux::set(Pin::PA26, PinFunction::CAN0_RX);
// Pull STB pin low so an attached transceiver is put into normal mode.
pinmux::set_pull(Pin::PA3, Pull::Down);

let can = unsafe { Can::steal(CAN0_PTR) };
can.init(&CanConfig::default());
can.enable();
can.bus_on();
...
let mut data = [0u32; 16];
data[0] = u32::from_le_bytes([0x01, 0x02, 0x03, 0x04]);
data[1] = u32::from_le_bytes([0x05, 0x06, 0x07, 0x08]);

let msg = TxMsg {
    buf_idx: 0,
    frame_type: FrameType::Data,
    id_type: IdType::Standard,
    std_id: 0x123,
    ext_id: 0,
    dlc: 8,
    data,
};
can.write_msg(&msg);

完整示例见 examples/can/src/main.rs。该示例仅演示了 TX。read_msg / read_rx_from_fifo 是驱动 API 中的方法说明,并非来自该示例。

应用示例

Rust SDK 在 examples/can/ 下提供一个示例项目:

  • can

    CAN0,初始化总线并发送一帧 Standard ID 0x123、8 字节负载的数据帧。

    接线:CAN0 —— TX = PA25,RX = PA26。无需外接总线——示例只发送一帧且不等待 ACK,即使没有接任何设备也能完成。

    [CAN] start
    [CAN] Sending frame id=0x123
    [PASS] CAN TX: done
    

备注

编译示例:cargo xtask build example --name can。

API 参考

快速用法

use ameba_hal::can::{CAN0_PTR, Can, CanConfig, FrameType, IdType, TxMsg};

let can = unsafe { Can::steal(CAN0_PTR) };
can.init(&CanConfig::default());
can.enable();
can.bus_on();

let mut data = [0u32; 16];
data[0] = u32::from_le_bytes([0x01, 0x02, 0x03, 0x04]);

let tx = TxMsg {
    buf_idx: 0,
    frame_type: FrameType::Data,
    id_type: IdType::Standard,
    std_id: 0x123,
    ext_id: 0,
    dlc: 4,
    data,
};
can.write_msg(&tx);

Can 还提供 set_rx_msg_buf / read_msg / read_rx_from_fifo 用于接收帧,以及 calc_bit_timing 用于根据目标速率计算 BitTiming,请参见上文工作模式一节。