Crate can_decode

Crate can_decode 

Source
Expand description

§can_decode

Decode and encode CAN frames into messages/signals in a fast and easy way.

§Features

  • Parse DBC (CAN Database) files
  • Decode CAN messages into signals with physical values
  • Encode signal values back into raw CAN messages
  • Support for both standard and extended CAN IDs
  • Handle big-endian and little-endian byte ordering
  • Support for signed and unsigned signal values
  • Apply scaling factors and offsets (and inverse for encoding)

§Decoding Example

use can_decode::Parser;
use std::path::Path;

// Load a DBC file
let parser = Parser::from_dbc_file(Path::new("my_can_database.dbc"))?;

// Decode a CAN message
let msg_id = 0x123;
let data = [0x12, 0x34, 0x56, 0x78, 0x9A, 0xBC, 0xDE, 0xF0];

if let Some(decoded) = parser.decode_msg(msg_id, &data) {
    println!("Message: {}", decoded.name);
    for (signal_name, signal) in &decoded.signals {
        println!("  {}: {} {}", signal_name, signal.value, signal.unit);
    }
}

§Encoding Example

use can_decode::Parser;
use std::path::Path;
use std::collections::HashMap;

let parser = Parser::from_dbc_file(Path::new("my_can_database.dbc"))?;

// Encode a CAN message from signal values
let mut signal_values = HashMap::from([
    ("EngineSpeed".to_string(), 2500.0),
    ("ThrottlePosition".to_string(), 45.5),
]);

if let Some(data) = parser.encode_msg(0x123, &signal_values) {
    println!("Encoded CAN data: {:02X?}", data);
}

// Or encode by message name
if let Some((msg_id, data)) = parser.encode_msg_by_name("EngineData", &signal_values) {
    println!("Message ID: {:#X}, Data: {:02X?}", msg_id, data);
}

Structs§

DecodedMessage
A decoded CAN message containing signal values.
DecodedSignal
A decoded signal with its physical value.
Parser
A CAN message parser that uses DBC file definitions.

Enums§

ParseError