Struct Message 

pub struct Message<'a> { /* private fields */ }

Represents a CAN message in a DBC file.

A Message contains:

• A unique ID (CAN identifier)
• A name
• A DLC (Data Length Code) specifying the message size in bytes
• A sender node (ECU that transmits this message)
• A collection of signals

Examples

use dbc_rs::Dbc;

let dbc_content = r#"VERSION "1.0"

BU_: ECM

BO_ 256 EngineData : 8 ECM
 SG_ RPM : 0|16@0+ (0.25,0) [0|8000] "rpm" *
"#;

let dbc = Dbc::parse(dbc_content)?;
let message = dbc.messages().at(0).unwrap();
println!("Message: {} (ID: {})", message.name(), message.id());

Implementations

impl<'a> Message<'a>

pub fn id(&self) -> u32

Returns the CAN message ID.

Examples

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION "1.0"\n\nBU_: ECM\n\nBO_ 256 EngineData : 8 ECM"#)?;
let message = dbc.messages().at(0).unwrap();
assert_eq!(message.id(), 256);

pub fn name(&self) -> &'a str

Returns the message name.

Examples

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION "1.0"\n\nBU_: ECM\n\nBO_ 256 EngineData : 8 ECM"#)?;
let message = dbc.messages().at(0).unwrap();
assert_eq!(message.name(), "EngineData");

pub fn dlc(&self) -> u8

Returns the Data Length Code (DLC) in bytes.

DLC specifies the size of the message payload. For classic CAN, this is 1-8 bytes. For CAN FD, this can be up to 64 bytes.

Examples

use dbc_rs::Dbc;

let dbc = Dbc::parse(r#"VERSION "1.0"\n\nBU_: ECM\n\nBO_ 256 EngineData : 8 ECM"#)?;
let message = dbc.messages().at(0).unwrap();
assert_eq!(message.dlc(), 8);

pub fn sender(&self) -> &'a str

pub fn signals(&self) -> &Signals<'a>

Get a reference to the signals collection

pub fn to_dbc_string(&self) -> String

pub fn to_dbc_string_with_signals(&self) -> String

Trait Implementations

impl<'a> Clone for Message<'a>

fn clone(&self) -> Message<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Message<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Display for Message<'a>

Available on crate feature alloc only.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Hash for Message<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for Message<'a>

fn eq(&self, other: &Message<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for Message<'a>

impl<'a> StructuralPartialEq for Message<'a>