5 unstable releases
0.9.1 | Jul 17, 2024 |
---|---|
0.9.0 | Jul 17, 2024 |
0.2.0 | Jun 26, 2024 |
0.1.1 | Jun 23, 2024 |
0.1.0 | Jun 23, 2024 |
#82 in No standard library
253 downloads per month
87KB
1.5K
SLoC
A rust crate for encoding or decoding various Controller Area Network (CAN) data types, including the SAE J1939 standard.
Supported CAN Protocols
This crate provides decoding capabilities for Controller Area Network (CAN) protocols utilizing both 11-bit and 29-bit identifiers.
- CAN 2.0 (Classical CAN): Commonly used in automotive applications and industrial automation.
- SAE J1939: Commonly used in heavy-duty trucks and buses.
no_std
Support
This crate supports no_std
, meaning it can be used in resource-constrained environments like embedded systems and IoT
devices, allowing for minimal memory usage without compromising functionality.
To enable no_std
, use the --no-default-features
flag:
$ cargo add can_types --no-default-features
no_std
limitations:
- This mode does not support generating
String
or string slice hexadecimal representations of the provided data structures.
Examples
Hex to J1939 Identifier
let id_a = IdJ1939::try_from_hex("0CF00400")?;
assert_eq!(3, id_a.priority());
assert_eq!(SourceAddr::Some(0), id_a.source_address());
assert_eq!(Some(Addr::PrimaryEngineController), id_a.source_address().lookup());
Decode J1939 PGN
let id_a = IdJ1939::try_from_hex("18FEF200")?;
assert_eq!(CommunicationMode::Broadcast, id_a.pgn().communication_mode());
assert_eq!(GroupExtension::Some(242), id_a.pgn().group_extension());
let id_b = IdJ1939::try_from_hex("0C00290B")?;
// SA 11 = Brakes
assert_eq!(SourceAddr::Some(11), id_b.source_address());
assert_eq!(Some(Addr::Brakes), id_b.source_address().lookup());
assert_eq!(PduFormat::Pdu1(0), id_b.pgn().pdu_format());
assert_eq!(CommunicationMode::P2P, id_b.pgn().communication_mode());
assert_eq!(GroupExtension::None, id_b.pgn().group_extension());
// DA 41 = Retarder, Exhaust, Engine
assert_eq!(DestinationAddr::Some(41), id_b.pgn().destination_address());
assert_eq!(Some(Addr::RetarderExhaustEngine1), id_b.pgn().destination_address().lookup());
Dependencies
~0.4–0.8MB
~19K SLoC