#data-encoding #dds #protocols #data-transfer #deserialize #networking #rtps

cdr-encoding

Serde implementation of OMG Common Data Representation (CDR) encoding

3 releases

0.10.2 Sep 24, 2024
0.10.1 Apr 24, 2024
0.10.0 Apr 23, 2024

#1531 in Encoding

Download history 7/week @ 2024-07-16 11/week @ 2024-07-23 373/week @ 2024-07-30 603/week @ 2024-08-06 765/week @ 2024-08-13 862/week @ 2024-08-20 986/week @ 2024-08-27 666/week @ 2024-09-03 733/week @ 2024-09-10 653/week @ 2024-09-17 1019/week @ 2024-09-24 1085/week @ 2024-10-01 812/week @ 2024-10-08 280/week @ 2024-10-15 392/week @ 2024-10-22 443/week @ 2024-10-29

2,616 downloads per month
Used in 2 crates (via rustdds)

Apache-2.0

61KB
1.5K SLoC

OMG Common Data Representation (CDR) serialization with Serde

Used by RustDDS and ros2-client.

See Wikipedia or specification in Section "9.3 CDR Transfer Syntax".

This is also a part of the full XTYPES specification. XTYPES specifies several encodings, of which this implemention is only for "plain" CDR.


lib.rs:

OMG Common Data Representation (CDR) serialization with Serde See Wikipedia or specification in Section "9.3 CDR Transfer Syntax".

Full XTYPES specification, which covers a lot more. This implemention is only for "plain" CDR.

Example

 use cdr_encoding::*;
 use serde::{Serialize, Deserialize};
 use byteorder::LittleEndian;

 // This example is originally from https://www.omg.org/spec/DDSI-RTPS/2.3/PDF
 // 10.7 Example for User-defined Topic Data
 #[derive(Serialize, Deserialize, Debug, PartialEq, Eq)]
 struct ShapeType {
   color: String,
   x: i32,
   y: i32,
   size: i32,
 }

 let message = ShapeType {
   color: "BLUE".to_string(),
   x: 34,
   y: 100,
   size: 24,
 };

 let expected_serialized_result: Vec<u8> = vec![
   0x05, 0x00, 0x00, 0x00, 0x42, 0x4c, 0x55, 0x45, 0x00, 0x00, 0x00, 0x00, 0x22, 0x00, 0x00,
   0x00, 0x64, 0x00, 0x00, 0x00, 0x18, 0x00, 0x00, 0x00,
 ];

 let serialized = to_vec::<ShapeType, LittleEndian>(&message).unwrap();
 assert_eq!(serialized, expected_serialized_result);

 let (deserialized_message, _consumed_byte_count)
   = from_bytes::<ShapeType, LittleEndian>(&serialized).unwrap();
 assert_eq!(deserialized_message, message);

Dependencies

~0.5–1.2MB
~25K SLoC