can-hal-rs 0.4.1

can-hal-rs defines the interface. Backend crates implement it. Application code is portable across CAN hardware.

no_std support

This crate is no_std-compatible (requires Rust 1.81+). The std feature is enabled by default. To use in embedded / no_std contexts:

[dependencies]
can-hal-rs = { version = "0.3", default-features = false }

Traits

Async variants (AsyncTransmit, AsyncReceive, etc.) are available behind the async feature flag.

There is no shared Driver or ChannelBuilder trait - each backend exposes its own concrete driver and a typestate-driven builder where invalid combinations are compile errors. See the backend crates for details.

Usage

use can_hal::{CanId, CanFrame, Transmit, Receive};

fn echo<T: Transmit<Error = E> + Receive<Error = E>, E: can_hal::CanError>(
    channel: &mut T,
) -> Result<(), E> {
    let msg = channel.receive()?;
    channel.transmit(msg.frame())?;
    Ok(())
}

Backend crates

• can-hal-socketcan - Linux SocketCAN
• can-hal-pcan - PEAK PCAN-Basic (Windows and Linux)
• can-hal-kvaser - KVASER CANlib (Windows and Linux)

License

Licensed under either of Apache License, Version 2.0 or MIT License at your option.