dbc-rs 0.5.0

Database CAN (DBC) parsing and editing library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

// ============================================================================
// no_std error messages (used in Error::Validation, Error::Decoding, and other errors)
// ============================================================================

// Error messages - improved for clarity
pub const EXPECTED_WHITESPACE: &str = "Expected space character";
pub const EXPECTED_PATTERN: &str = "Expected pattern not found";
pub const EXPECTED_KEYWORD: &str = "Expected DBC keyword";
pub const EXPECTED_NUMBER: &str = "Expected numeric value";
pub const EXPECTED_IDENTIFIER: &str =
    "Expected valid identifier (letter or underscore followed by alphanumerics)";
pub const INVALID_UTF8: &str = "Invalid UTF-8 encoding";
pub const INVALID_NUMBER_FORMAT: &str = "Invalid number format";
pub const PARSE_NUMBER_FAILED: &str = "Failed to parse number";
pub const UNEXPECTED_EOF: &str = "Unexpected end of file";
pub const INVALID_CHARACTER: &str = "Invalid character";
pub const STRING_LENGTH_EXCEEDS_MAX: &str = "String length exceeds maximum";
pub const DECODING_ERROR_PREFIX: &str = "Decoding error";
pub const VALIDATION_ERROR_PREFIX: &str = "Validation error";
pub const VERSION_ERROR_PREFIX: &str = "Version error";
pub const MESSAGE_ERROR_PREFIX: &str = "Message error";
pub const RECEIVERS_ERROR_PREFIX: &str = "Receivers error";
pub const NODES_ERROR_PREFIX: &str = "Nodes error";
pub const SIGNAL_ERROR_PREFIX: &str = "Signal error";

// Signal error messages - improved for clarity
pub const SIGNAL_PARSE_INVALID_START_BIT: &str = "Invalid start_bit value (must be 0-511)";
pub const SIGNAL_PARSE_INVALID_LENGTH: &str = "Invalid signal length";
pub const SIGNAL_PARSE_INVALID_FACTOR: &str = "Invalid factor value";
pub const SIGNAL_PARSE_INVALID_OFFSET: &str = "Invalid offset value";
pub const SIGNAL_PARSE_INVALID_MIN: &str = "Invalid minimum value";
pub const SIGNAL_PARSE_INVALID_MAX: &str = "Invalid maximum value";
pub const SIGNAL_PARSE_UNIT_TOO_LONG: &str = "Unit string exceeds maximum length of 256 characters";
pub const MAX_NAME_SIZE_EXCEEDED: &str = "Name exceeds maximum length";

// Validation and decoding errors (available in no_std)
pub const NODES_DUPLICATE_NAME: &str = "Duplicate node name";
pub const NODES_TOO_MANY: &str = "Too many nodes: maximum allowed is 256";
pub const DUPLICATE_MESSAGE_ID: &str = "Duplicate message ID";
pub const SENDER_NOT_IN_NODES: &str = "Message sender not defined in nodes list (BU_)";
pub const SIGNAL_EXTENDS_BEYOND_MESSAGE: &str = "Signal extends beyond message boundary";
pub const INVALID_RANGE: &str = "Invalid range: minimum value exceeds maximum";
pub const MESSAGE_TOO_MANY_SIGNALS: &str = "Too many signals: maximum allowed is 256 per message";
pub const SIGNAL_RECEIVERS_TOO_MANY: &str =
    "Too many receiver nodes: maximum allowed is 255 per signal";
pub const EXTENDED_MULTIPLEXING_TOO_MANY: &str =
    "Too many extended multiplexing entries: maximum allowed is 512 per DBC file";
pub const SIGNAL_NAME_EMPTY: &str = "Signal name cannot be empty";
pub const SIGNAL_LENGTH_TOO_SMALL: &str = "Signal length must be at least 1 bit";
pub const SIGNAL_LENGTH_TOO_LARGE: &str = "Signal length cannot exceed 512 bits (CAN FD maximum)";
pub const SIGNAL_OVERLAP: &str = "Signals overlap within message";
pub const SIGNAL_EXTENDS_BEYOND_DATA: &str = "Signal extends beyond message data length";
pub const MESSAGE_NAME_EMPTY: &str = "Message name cannot be empty";
pub const MESSAGE_SENDER_EMPTY: &str = "Message sender cannot be empty";
pub const MESSAGE_DLC_TOO_SMALL: &str = "Message DLC must be at least 0 bytes";
pub const MESSAGE_DLC_TOO_LARGE: &str = "Message DLC cannot exceed 64 bytes (CAN FD maximum)";
pub const MESSAGE_ID_OUT_OF_RANGE: &str = "Message ID out of valid CAN range";
pub const MESSAGE_INVALID_ID: &str = "Invalid message ID";
pub const MESSAGE_INVALID_DLC: &str = "Invalid DLC value";
pub const MESSAGE_NOT_FOUND: &str = "Message ID not found in database";
pub const PAYLOAD_LENGTH_MISMATCH: &str = "Payload too short to decode all signals";
pub const MULTIPLEXER_SWITCH_NEGATIVE: &str = "Multiplexer switch value cannot be negative";

// Value description error messages
pub const VALUE_DESCRIPTION_MESSAGE_NOT_FOUND: &str =
    "Value description references non-existent message";
pub const VALUE_DESCRIPTION_SIGNAL_NOT_FOUND: &str =
    "Value description references non-existent signal";
pub const VALUE_DESCRIPTIONS_TOO_MANY: &str = "Too many value descriptions: maximum allowed is 64";
pub const VALUE_DESCRIPTIONS_EMPTY: &str = "Value descriptions cannot be empty";

// Extended multiplexing error messages
pub const EXT_MUX_MESSAGE_NOT_FOUND: &str = "Extended multiplexing references non-existent message";
pub const EXT_MUX_SIGNAL_NOT_FOUND: &str = "Extended multiplexing references non-existent signal";
pub const EXT_MUX_SWITCH_NOT_FOUND: &str =
    "Extended multiplexing references non-existent multiplexer switch signal";
pub const EXT_MUX_INVALID_RANGE: &str = "Extended multiplexing has invalid value range (min > max)";

// Encoding error messages
pub const ENCODING_ERROR_PREFIX: &str = "Encoding error";
pub const ENCODING_SIGNAL_NOT_FOUND: &str = "Signal not found in message";
pub const ENCODING_VALUE_OUT_OF_RANGE: &str = "Physical value outside signal min/max range";
pub const ENCODING_VALUE_OVERFLOW: &str = "Encoded value exceeds signal bit length";

// Attribute error messages
pub const ATTRIBUTE_DEFINITIONS_TOO_MANY: &str =
    "Too many attribute definitions: maximum allowed is 256 per DBC file";
pub const ATTRIBUTE_VALUES_TOO_MANY: &str =
    "Too many attribute values: maximum allowed is 4096 per DBC file";
pub const ATTRIBUTE_ENUM_VALUES_TOO_MANY: &str =
    "Too many enum values in attribute definition: maximum allowed is 64";
pub const ATTRIBUTE_DEFINITION_NOT_FOUND: &str = "Attribute definition not found";
pub const ATTRIBUTE_VALUE_TYPE_MISMATCH: &str = "Attribute value type does not match definition";
pub const ATTRIBUTE_VALUE_OUT_OF_RANGE: &str = "Attribute value outside defined range";
pub const ATTRIBUTE_ENUM_VALUE_INVALID: &str = "Invalid enum value for attribute";