zerodds-transport 1.0.0-rc.1

Transport-Trait + Locator-Re-Export + abstrakte send/receive-Schnittstelle für RTPS-State-Machines. Pure-Rust no_std + alloc.
Documentation
  • Coverage
  • 100%
    22 out of 22 items documented0 out of 7 items with examples
  • Size
  • Source code size: 13.79 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 551.05 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 8s Average build duration of successful builds.
  • all releases: 8s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • zero-objects/zero-dds
    2 1 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • SandraK82

zerodds-transport

docs.rs crates.io

Transport-Trait + Locator-Re-Export für ZeroDDS. Layer 2 (Wire-Trait-Crate).

Pure-Rust no_std + alloc, forbid(unsafe_code), Safety-Klasse SAFE.

Was liefert dieses Crate

  • Transport — Trait für send/receive-Operationen mit Locator-Adressierung
  • SendError / RecvError — typisierte Fehler
  • ReceivedDatagram — Empfangenes Datagramm + Source-Locator
  • Locator — re-exportiert aus zerodds-rtps::wire_types (DDSI-RTPS 2.5 §8.3.2)

Spec

  • DDSI-RTPS 2.5 §8.3.2 — Locator-Definition
  • Transport-Trait ist ZeroDDS-eigene Abstraktion über RTPS-Wire-Protokollen

Konkrete Implementations

  • zerodds-transport-udp — UDPv4/UDPv6 Datagram-Sockets
  • zerodds-transport-tcp — TCP-Stream + Length-Prefix-Framing
  • zerodds-transport-shm — POSIX Shared-Memory-Ringbuffer
  • zerodds-transport-uds — Unix Domain Sockets
  • zerodds-transport-tsn — TSN/IEEE 802.1Qbv Time-Aware Shaper

Architektur-Hinweis: transport → rtps Crate-Dep

Locator lebt bewusst in zerodds-rtps, nicht in zerodds-transport:

  • DDSI-RTPS-Spec definiert das Wire-Format des Locators in §8.3.2 — das ist RTPS-Domäne, nicht Transport-Domäne.
  • zerodds-transport re-exportiert ihn nur, damit Konsumenten eine Transport-zentrische Import-Pfad-Option haben.
  • Es gibt keinen Cycle: zerodds-rtps hängt nicht von zerodds-transport ab.

Tests

cargo test -p zerodds-transport
cargo build -p zerodds-transport --no-default-features
cargo build -p zerodds-transport --no-default-features --features alloc

Lizenz

Apache-2.0 OR MIT — siehe Workspace-Root.