class ara::rds::IEEE1722Datagram61883_IIDC

Die Klasse ara::rds::IEEE1722Datagram61883_IIDC dient im Modul rds als Repräsentation von IEEE-1722-Datagrammen für IEC-61883- und IIDC-Datenströme (AUTOSAR_AP_SWS_RawDataStream S. 1). Sie kapselt geschützte Protokollfelder in ara::core::Optional und fungiert als Basisklasse zur schichtweisen Konfiguration von Streaming-Paketen. Die Zerstörung erfolgt ausnahmesicher über den virtuellen Destruktor ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. Als wesentliche Randbedingung erfordert der ungesicherte Zugriff auf Instanzen bei Nebenläufigkeit eine externe Synchronisation.

mehr ›

Kontext

Die Klasse ara::rds::IEEE1722Datagram61883_IIDC fungiert innerhalb des Moduls rds (Raw Data Stream) der AUTOSAR Adaptive Platform als strukturierte Repräsentation von IEEE-1722-Datagrammen für IEC-61883- und IIDC-Datenströme (AUTOSAR_AP_SWS_RawDataStream S. 1). Sie bildet die Protokollfelder der Spezifikation ab und hält diese in geschützten Elementen. Sämtliche Datagrammfelder – darunter tag [SWS_RDS_90244], channel [SWS_RDS_90245], syt [SWS_RDS_90246], sph [SWS_RDS_90247], qi_2 [SWS_RDS_90248], qpc [SWS_RDS_90249], dbs [SWS_RDS_90250], fn [SWS_RDS_90251], sid [SWS_RDS_90252], sy [SWS_RDS_90253], dbc [SWS_RDS_90254], qi_1 [SWS_RDS_90255], fmt [SWS_RDS_90256], fdf_with_sph [SWS_RDS_90257], tcode [SWS_RDS_90258] sowie fdf_without_sph [SWS_RDS_90259] – sind mit dem Schutzgrad protected versehen. Da keine öffentlichen Zugriffsmethoden spezifiziert sind, dürfte die Klasse primär als Basisklasse für abgeleitete Protokollspezialisierungen oder Decoder innerhalb des Streaming-Subsystems dienen (Interpretation: Basisklasse in Vererbungshierarchie). Frage Q-e94037851fe92b8d (offen) Das Zusammenspiel zwischen Datagramm, Spezialisierung und Stream-Verarbeitung veranschaulicht das folgende Kontextdiagramm.

Kontextdiagramm: Einordnung der Datagramm-Basisklasse zwischen ableitenden Protokollspezialisierungen und der RDS-Streamverarbeitung. Quellen: [SWS_RDS_90244], [SWS_RDS_90260], AUTOSAR_AP_SWS_RawDataStream S. 1

Lebenszyklus

Instanzen von ara::rds::IEEE1722Datagram61883_IIDC entstehen typischerweise im Zuge der Datenübertragung oder beim Empfang von Audio- und Videoströmen über das Netzwerk. Die Zerstörung und Ressourcenfreigabe erfolgt deterministisch über den virtuellen Destruktor ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. Die Deklaration als virtueller Destruktor stellt sicher, dass abgeleitete Klassen beim Löschen über Basisklassenzeiger vollständig bereinigt werden, während der Bezeichner noexcept garantiert, dass bei der Zerstörung keine Ausnahmen geworfen werden dürfen.

Hinsichtlich des internen Zustands besitzt die Klasse keine komplexe Zustandsmaschine, sondern kapselt ihren Zustand über separate ara::core::Optional-Felder. Jedes Feld, etwa der Datenblockzähler dbc [SWS_RDS_90254] oder das Datenblockgrößenfeld dbs [SWS_RDS_90250], befindet sich entweder im ungesetzten Zustand oder enthält einen gültigen Protokollwert. Bezüglich der Nebenläufigkeit spezifiziert der Standard keine internen Synchronisationsmechanismen; ein gleichzeitiger lesender und schreibender Zugriff auf dieselbe Instanz über mehrere Threads hinweg dürfte daher nicht thread-sicher sein (Interpretation: fehlende Synchronisation) und erfordert eine externe Koordination. Frage Q-e1381bdfdee717e9 (offen)

Nutzungspfad

Ein typischer Nutzungspfad vollzieht sich in abgeleiteten Klassen oder im Rahmen von Streaming-Pipelines zur Erstellung oder Auswertung von Datagrammen:

• Initialisierung: Eine abgeleitete Klasse instanziiert das Datagramm-Objekt zur Vorbereitung eines Sende- oder Empfangsvorgangs.
• Konfiguration der Felder: Die benötigten Protokollheader werden selektiv gesetzt. Hierbei werden Standardparameter wie tag [SWS_RDS_90244], channel [SWS_RDS_90245], fmt [SWS_RDS_90256] sowie tcode [SWS_RDS_90258] mit Werten belegt. Die Kapselung in ara::core::Optional legt nahe, dass je nach Ausprägung des IEEE-1722-Subformats nicht zwingend jedes Feld belegt werden muss (Interpretation: selektive Belegung). Frage Q-925b6c1d9b5a8ce6 (offen)
• Verarbeitung und Weiterleitung: Die zusammengestellten Datagrammdaten werden an die nachgelagerte Transportschicht des RDS-Moduls übergeben.
• Freigabe: Nach Abschluss der Übertragung oder Paketverarbeitung wird das Objekt zerstört, wobei der virtuelle Destruktor [SWS_RDS_90260] eine saubere polymorphe Bereinigung gewährleistet.

Fehlerszenarien

Da ara::rds::IEEE1722Datagram61883_IIDC als Datenklasse definiert ist, signalisieren ihre Methoden keine expliziten AUTOSAR-Fehlercodes über ara::core::Result. Potenzielle Fehlerquellen entstehen vor allem bei der fehlerhaften Handhabung der optionalen Datenmitglieder. Ein Zugriff auf leere Instanzen von ara::core::Optional ohne vorherige Validierung – beispielsweise beim Auslesen von sid [SWS_RDS_90252], fn [SWS_RDS_90251] oder qpc [SWS_RDS_90249] – kann zu Laufzeitfehlern führen. Als Vorbedingung für den lesenden Zugriff müssen abgeleitete Komponenten stets prüfen, ob das jeweilige Feld initialisiert ist. Weiterhin müssen gegenseitig abhängige oder alternative Felder, wie fdf_with_sph [SWS_RDS_90257] und fdf_without_sph [SWS_RDS_90259], konsistent zueinander gesetzt werden.