namespace ara::rds

Der Namespace stellt funktionale Schnittstellen für das Senden und Empfangen binärer Rohdatenströme über Netzwerkverbindungen sowie für zeitkritische AVTP-Audiovideoströme bereit AUTOSAR_AP_SWS_RawDataStream §1. Anwendungen etablieren über Client- und Server-Klassen Punkt-zu-Punkt-Verbindungen oder nutzen dedizierte Producer- und Consumer-Klassen zur Übertragung typisierter Datagramme. Leseoperationen stellen die empfangenen Rohdaten strukturiert in Ergebnisobjekten zur Verfügung. Fehlerhafte Zustände während der Übertragung werden über eine modulspezifische Fehlerdomäne und standardisierte Fehlercodes signalisiert [SWS_RDS_12367].

mehr ›

Kontext

Der Namespace ara::rds stellt innerhalb der AUTOSAR Adaptive Platform funktionale Schnittstellen für das Übertragen binärer Rohdatenströme (Raw Data Streams) über Netzwerkverbindungen bereit AUTOSAR_AP_SWS_RawDataStream §1. Die Architektur bedient zwei komplementäre Kommunikationsmuster: die generische Punkt-zu-Punkt-Übertragung unstrukturierter Byteströme sowie das zeitkritische Streaming typisierter Datagramme nach dem Standard IEEE 1722 (Audio Video Transport Protocol, AVTP).

Für die Bytestrom-Übertragung bilden RawDataStreamClient und RawDataStreamServer die zentralen Komponenten. Der RawDataStreamClient initiiert eine Netzwerkverbindung und wickelt nachfolgende Lese- und Schreiboperationen ab, während der RawDataStreamServer eingehende Verbindungsanfragen entgegennimmt und verwaltet. Ergebnisse von Leseoperationen werden in Instanzen der Klasse ReadDataResult gekapselt, um empfangene Datenblöcke strukturiert an die Anwendungslogik zu übergeben.

Für zeitkritische Audio-, Video- und Steuerungsströme definiert ara::rds ein typisiertes Streaming-Modell: IEEE1722RawDataStreamProducer dient als Quelle zur Erzeugung und Aussendung von IEEE-1722-Datagrammen, während IEEE1722RawDataStreamConsumer als Senke für deren Empfang fungiert. Die Nutzlasten und Protokollheader werden über spezialisierte Datagrammtypen wie IEEE1722DatagramAAF (Audio), IEEE1722DatagramRVF (Video), IEEE1722DatagramCRF (Clock Reference) sowie Steuerdatagramme (IEEE1722Datagram61883_IIDC, IEEE1722DatagramNTSCF, IEEE1722DatagramTSCF und das Basisdatagramm IEEE1722Datagram) abgebildet. Gemeinsame Header-Felder kapseln IEEE1722DatagramAVTPDUCommonHeaderFields und IEEE1722DatagramAVTPDUCommonStreamHeaderFields.

Kontextdiagramm: Zusammenspiel der Client-/Server-Streaming-Klassen und IEEE-1722-Streaming-Komponenten mit der Fehlerdomäne in ara::rds. Quellen: [SWS_RDS_11298], [SWS_RDS_11299], [SWS_RDS_12367], AUTOSAR_AP_SWS_RawDataStream §1.

Nutzungspfad

Im regulären Betriebsablauf einer Bytestrom-Kommunikation instanziiert ein Server-Prozess zunächst RawDataStreamServer, um am Netzwerk auf eingehende Verbindungen zu warten. Ein Client-Prozess erzeugt ein Exemplar von RawDataStreamClient und baut die Netzwerkverbindung zum Server auf. Sobald die Verbindung steht, führen die Kommunikationspartner Lese- oder Schreibaufrufe aus. Jeder Leseaufruf liefert ein ReadDataResult, das die gelesenen Binärdaten für die weitere Verarbeitung bereitstellt.

Im AVTP-Szenario instanziiert ein Datenproduzent einen IEEE1722RawDataStreamProducer und konfiguriert die gewünschten Protokoll- und Stream-Header über IEEE1722DatagramAVTPDUCommonStreamHeaderFields. Die Nutzdaten werden in domänenspezifische Datagramme wie IEEE1722DatagramAAF oder IEEE1722DatagramRVF verpackt. Interpretation: Die Übertragung an den IEEE1722RawDataStreamConsumer dürfte typischerweise über ein AVB/TSN-Netzwerk erfolgen, woraufhin der Consumer die typisierten Datagramme empfängt und dekodiert. Frage Q-3502e4b3d8365e69 (offen)

Fehlerszenarien

Die Fehlerbehandlung in ara::rds fügt sich nahtlos in das Modell der Adaptive Platform ein und stützt sich auf Fehlerdomänen und Fehlercodes AUTOSAR_AP_SWS_RawDataStream §1. Das Modul definiert die Fehlerdomäne RdsErrorDomain, deren Instanz über die Funktion GetRdsErrorDomain() abgerufen werden kann [SWS_RDS_11298].

Konkrete Fehlersituationen, wie Übertragungsabbrüche oder Verbindungskonflikte, werden über die Aufzählung RdsErrc abgebildet [SWS_RDS_12367]. Zur Erzeugung modulspezifischer Fehlerobjekte stellt der Namespace die Hilfsfunktion MakeErrorCode(RdsErrc code, ara::core::ErrorDomain::SupportDataType data) bereit [SWS_RDS_11299]. Interpretation: Fehlgeschlagene I/O-Operationen der Streaming-Klassen dürften einen entsprechenden ara::core::ErrorCode zurückgeben. Frage Q-16627290fe526e68 (offen) Für Ausnahme-basierte Ausführungspfade existiert zudem der spezialisierte Typ RdsException.