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/ 下提供一个示例项目:
-
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,请参见上文工作模式一节。