Expand description
Writer/Reader state machines, RTPS submessages, fragmentation.
Crate zerodds-rtps. Safety classification: SAFE.
See docs/architecture/02_architecture.md §3 and
docs/architecture/04_safety_by_architecture.md §2.
RTPS wire types + header (W1). Submessages
(DATA/HEARTBEAT/ACKNACK/GAP) follow in W2; transport trait + UDP
impl in W3; best-effort writer + E2E in W4. See
.planning/wp-0.5-rtps-prototyp/PLAN.md.
Re-exports§
pub use error::WireError;pub use header::RTPS_MAGIC;pub use header::RtpsHeader;pub use submessage_header::FLAG_E_LITTLE_ENDIAN;pub use submessage_header::SubmessageHeader;pub use submessage_header::SubmessageId;pub use wire_types::EntityId;pub use wire_types::EntityKind;pub use wire_types::Guid;pub use wire_types::GuidPrefix;pub use wire_types::Locator;pub use wire_types::LocatorKind;pub use wire_types::ProtocolVersion;pub use wire_types::SequenceNumber;pub use wire_types::VendorId;
Modules§
- datagram
- Datagram encoder/decoder: combines the RTPS header and submessages into a finished wire datagram (W4).
- endpoint_
security_ info - Endpoint security info wire format for
PID_ENDPOINT_SECURITY_INFO(0x1004, DDS-Security 1.1 §7.4.1.5). - error
- RTPS wire-format errors.
- fragment_
assembler - Fragment reassembly for DDSI-RTPS 2.5 §8.4.14 on the reader side.
- group_
digest GroupDigest_t— DDSI-RTPS 2.5 §8.3.5.10 (16-byte CDR-encoded 128-bit digest for group membership). Carried in heartbeats with the GroupInfo flag (HeartbeatSubmessage.writer_set/secure_writer_set), to prove to readers the consistency of the shared writer/reader group per tick.- header
- RTPS-Header (DDSI-RTPS 2.5 §8.3.3).
- header_
extension - HeaderExtension Submessage (DDSI-RTPS 2.5 §8.3.3.2 / §9.4.5.2 / §9.4.2.15).
- history_
cache HistoryCache— ordered sample storage for reliable writer/reader.- inline_
qos - Inline-QoS helpers for DDS-RPC and SEDP (DDS-RPC 1.0 §7.8.2).
- message_
builder - MessageBuilder — submessage aggregation into a UDP datagram.
- metrics
- Hot-path hook points for
zerodds-monitor(zerodds-monitor-1.1 §2.2). - parameter_
list - ParameterList (DDSI-RTPS 2.5 §9.4.2.11).
- participant_
data - ParticipantBuiltinTopicData (DDSI-RTPS 2.5 §8.5.4.2).
- participant_
message_ data ParticipantMessageDataWire-Encoding (DDSI-RTPS 2.5 §9.6.3.1).- participant_
security_ info - Participant security info wire format for
PID_PARTICIPANT_SECURITY_INFO(0x1005, DDS-Security 1.2 §7.4.1.6). - property_
list - PropertyList wire format for
PID_PROPERTY_LIST(0x0059). - publication_
data - PublicationBuiltinTopicData (DDSI-RTPS 2.5 §8.5.4.2, §9.6.2.2.3).
- qos_
bridge - Bridge from SEDP BuiltinTopicData (wire) to zerodds-qos policies.
- reader
- Best-effort stateless RTPS reader (W4).
- reader_
proxy ReaderProxy— writer-side state over one remote reader.- receiver_
state - Receiver state (DDSI-RTPS 2.5 §8.3.4 + §8.3.7.4).
- reliable_
reader - Reliable RTPS reader (1:N writer proxies) — DDSI-RTPS 2.5 §8.4.10.
- reliable_
stateless_ writer ReliableStatelessWriter— DDSI-RTPS 2.5 §8.4.8.2 (Reliable StatelessWriter, T1-T12).- reliable_
writer - Reliable RTPS writer (1:N reader proxies) — DDSI-RTPS 2.5 §8.4.9.
- security_
algo_ info - DDS-Security 1.2 §7.3.11-§7.3.15 — Algorithm-Info-Strukturen + PIDs 0x1010-0x1013 (C3.5-Rest).
- submessage_
header - Submessage-Header (DDSI-RTPS 2.5 §8.3.4).
- submessages
- RTPS submessages — DDSI-RTPS 2.5 §8.3.7.
- subscription_
data - SubscriptionBuiltinTopicData (DDSI-RTPS 2.5 §8.5.4.3, §9.6.2.2.4).
- wire_
types - RTPS wire base types (DDSI-RTPS 2.5 §8.3.5, §8.3.5.1).
- writer
- Best-Effort Stateless RTPS-Writer (W4).
- writer_
proxy WriterProxy— reader-side state over one remote writer.