Skip to main content

Module builtin_topics

Module builtin_topics 

Source
Expand description

C3.4-b — API-Bridge fuer die DDS-Security 1.2 §7.5.3/§7.5.4 Builtin- Topics (DCPSParticipantStatelessMessage + DCPSParticipantVolatileMessage- Secure). Wraps das Spec-Datenmodell aus zerodds_security::generic_message in eine DCPS-fertige Form:

  • 4-byte PL_CDR-Encapsulation-Header (Spec RTPS 2.5 §10) vor den Bytes — gleiche Hülle wie ParticipantBuiltinTopicData-DATA- Submessages.
  • QoS-Defaults pro Topic (Spec §7.5.3 BestEffort, §7.5.4 Reliable + VOLATILE + KEEP_ALL).

Was hier nicht passiert (C3.4-c): Tatsaechliche DataWriter/ DataReader-Erzeugung im DCPS-Runtime. Der Caller nutzt diese Helpers, um die Wire-Bytes ueber einen Standard-RawBytes-DataWriter mit den passenden EntityIds (siehe zerodds_rtps::wire_types::EntityId:: BUILTIN_PARTICIPANT_STATELESS_MESSAGE_* aus C3.8) zu pushen.

Structs§

BuiltinTopicQos
Schicht-neutraler QoS-Trio fuer die zwei Builtin-Topics. Caller im DCPS-Layer mappt diese auf seine DataWriterQos/DataReaderQos- Aggregat-Typen.

Constants§

ENCAPSULATION_CDR_LE
CDR-LE Encapsulation-Kind (Spec RTPS 2.5 §10.2). Gleiche 4-Byte-Hülle wie ParticipantBuiltinTopicData (CDR_LE statt PL_CDR_LE — die ParticipantGenericMessage ist eine strukturierte CDR, nicht ParameterList).
ENCAPSULATION_HEADER_LEN
Encapsulation-Header-Laenge (Spec §10.1: 2 byte kind + 2 byte options).

Functions§

decode_generic_message
Decoded eine ParticipantGenericMessage aus serialized_payload-Bytes (mit 4-byte Encapsulation-Header).
encode_generic_message
Encoded eine ParticipantGenericMessage als serialized_payload-Bytes fuer eine DATA-Submessage (mit 4-byte CDR-LE-Encapsulation-Header + XCDR1-Body).
stateless_message_qos
Spec §7.5.3 — BestEffort-Reliability fuer DCPSParticipantStateless- Message-Topic. Stateless = kein Sequence-Tracking, jede DATA- Submessage ist standalone.
volatile_secure_qos
Spec §7.5.4 Tab.19/20 — Reliable + VOLATILE + KEEP_ALL fuer DCPSParticipantVolatileMessageSecure-Topic.