dlt_parse
A zero allocation rust library for basic parsing & writing DLT (Diagnostic Log and Trace) packets. Currently only the parsing and writing of the header is supported (excluding the verbose packet definitions).
Usage:
First, add the following to your Cargo.toml:
[dependencies]
dlt_parse = "0.2.1"
Next, add this to your crate:
use dlt_parse;
What is dlt_parse?
dlt_parse is a library that aims to provide serialisation & deserialisation funtions for DLT (Diagnostic Log and Trace) packets. It should make it possible to anlyse recordings of DLT packets as fast as possible, as well as writing servers that send DLT packets to the network.
Some key points are:
- It is completly written in Rust and thoroughly tested.
- Special attention has been paid to not use allocations or syscalls.
- The package is still in development and can & will still change.
- Methods for parsing verbose DLT packets are still missing (but maybe will be implemented in future versions).
Example: Serializing & Slicing/Deserializing DLT Packets
In this example a non verbose DLT packet is serialized and deserialized again. Specificly the serialized packet is converted into a DltPacketSlice. This has the advantage, that not all fields have to be deserialied to access the payload or specific fields in the header. Note that it is also possible to completely deserialize DLT headers with the DltHeader::read function. This can make sense, if most fields of the header are used anyways.
use self::dlt_parse::{DltHeader, DltLogLevel, DltExtendedHeader, SliceIterator};
let header = {
let mut header = DltHeader {
is_big_endian: true, //payload & message id are encoded with big endian
version: 0,
message_counter: 0,
length: 0,
ecu_id: None,
session_id: None,
timestamp: None,
extended_header: Some(DltExtendedHeader::new_non_verbose_log(
DltLogLevel::Debug,
123,//application id
1,//context id
))
};
header.length = header.header_len() + 4 + 4; //header + message id + payload
header
};
//buffer to store serialized header & payload
let mut buffer = Vec::<u8>::with_capacity(usize::from(header.length));
header.write(&mut buffer).unwrap();
//write payload (message id 1234 & non verbose payload)
{
//for write_all
use std::io::Write;
//byteorder crate is used for writing the message id with the correct endianess
use byteorder::{BigEndian, WriteBytesExt};
//write the message id & payload
buffer.write_u32::<BigEndian>(1234).unwrap(); //message id
buffer.write_all(&[1,2,3,4]); //payload
}
//packets can contain multiple dlt messages, iterate through them
for dlt_message in SliceIterator::new(&buffer) {
match dlt_message {
Ok(dlt_slice) => {
//check if the message is verbose or non verbose (non verbose messages have message ids)
if let Some(message_id) = dlt_slice.message_id() {
println!("non verbose message {:x}", message_id);
println!(" with payload {:?}", dlt_slice.non_verbose_payload());
} else {
println!("verbose message (parsing not yet supported)");
}
},
Err(err) => {
//error parsing the dlt packet
println!("ERROR: {:?}", err);
}
}
}
An complete example which includes the parsing of the ethernet & udp headers can be found in examples/print_messages_ids.rs
References
License
Licensed under the BSD 3-Clause license. Please see the LICENSE file for more information.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed as above, without any additional terms or conditions.
77 Dec 5, 2022
7 Nov 15, 2022
21 Nov 20, 2022
1.2k Jan 1, 2023
29 Mar 11, 2024
4 Aug 17, 2022
1 Mar 9, 2022
40 Aug 24, 2022
117 Dec 14, 2022
5 Jul 19, 2022
24 Sep 13, 2022
7 Jan 4, 2023
1 Nov 4, 2022
16 Nov 20, 2022
715 Jan 1, 2023
20 Dec 16, 2022
2 Jul 21, 2022
5 Oct 28, 2022
61 Dec 30, 2022
14 Nov 9, 2022
3 Dec 11, 2023
3 Dec 23, 2022
6 Jan 25, 2023
8 Jun 24, 2023
20 Oct 5, 2022
6 Jun 15, 2023
914 Dec 30, 2022