klasse ara::rds::IEEE1722Datagram61883_IIDC

De klasse ara::rds::IEEE1722Datagram61883_IIDC dient in de module rds als representatie van IEEE-1722-datagrammen voor IEC-61883- en IIDC-datastromen (AUTOSAR_AP_SWS_RawDataStream p. 1). Deze kapselt beveiligde protocolvelden in ara::core::Optional in en fungeert als basisklasse voor de laagsgewijze configuratie van streaming-pakketten. De vernietiging vindt exceptieveilig plaats via de virtuele destructor ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. Als wezenlijke randvoorwaarde vereist de onbeveiligde toegang tot instanties bij concurrency een externe synchronisatie.

meer ›

Context

De klasse ara::rds::IEEE1722Datagram61883_IIDC fungeert binnen de module rds (Raw Data Stream) van het AUTOSAR Adaptive Platform als gestructureerde representatie van IEEE-1722-datagrammen voor IEC-61883- en IIDC-datastromen (AUTOSAR_AP_SWS_RawDataStream p. 1). Deze beeldt de protocolvelden van de specificatie af en houdt deze in protected elementen. Alle datagramvelden – waaronder 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] evenals fdf_without_sph [SWS_RDS_90259] – zijn voorzien van het beschermingsniveau protected. Aangezien er geen publieke toegangsmethoden zijn gespecificeerd, dient de klasse vermoedelijk primair als basisklasse voor afgeleide protocolspecialisaties of decoders binnen het streaming-subsysteem (interpretatie: basisklasse in overervingshiërarchie). Vraag Q-e94037851fe92b8d (open) Het samenspel tussen datagram, specialisatie en streamverwerking wordt geïllustreerd in het volgende contextdiagram.

Contextdiagram: Positionering van de datagram-basisklasse tussen afleidende protocolspecialisaties en de RDS-streamverwerking. Bronnen: [SWS_RDS_90244], [SWS_RDS_90260], AUTOSAR_AP_SWS_RawDataStream p. 1

Levenscyclus

Instanties van ara::rds::IEEE1722Datagram61883_IIDC ontstaan typisch in het kader van gegevensoverdracht of bij de ontvangst van audio- en videostromen over het netwerk. De vernietiging en vrijgave van resources verloopt deterministisch via de virtuele destructor ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. De declaratie als virtuele destructor waarborgt dat afgeleide klassen bij verwijdering via basisklasse-pointers volledig worden opgeruimd, terwijl de aanduiding noexcept garandeert dat bij de vernietiging geen excepties mogen worden geworpen.

Wat betreft de interne toestand bezit de klasse geen complexe toestandsmachine, maar kapselt deze haar toestand in via afzonderlijke ara::core::Optional-velden. Elk veld, zoals de datablokteller dbc [SWS_RDS_90254] of het datablokgrootteveld dbs [SWS_RDS_90250], bevindt zich ofwel in niet-ingestelde toestand of bevat een geldige protocolwaarde. Wat betreft concurrency specificeert de standaard geen interne synchronisatiemechanismen; gelijktijdige lees- en schrijftoegang tot dezelfde instantie over meerdere threads heen is vermoedelijk dan ook niet thread-safe (interpretatie: ontbrekende synchronisatie) en vereist externe coördinatie. Vraag Q-e1381bdfdee717e9 (open)

Gebruikspad

Een typisch gebruikstraject voltrekt zich in afgeleide klassen of in het kader van streaming-pipelines voor het creëren of evalueren van datagrammen:

• Initialisatie: Een afgeleide klasse instantieert het datagram-object ter voorbereiding op een verzend- of ontvangstproces.
• Configuratie van de velden: De benodigde protocolheaders worden selectief ingesteld. Hierbij worden standaardparameters zoals tag [SWS_RDS_90244], channel [SWS_RDS_90245], fmt [SWS_RDS_90256] evenals tcode [SWS_RDS_90258] van waarden voorzien. De inkapseling in ara::core::Optional suggereert dat, afhankelijk van de verschijningsvorm van het IEEE-1722-subformaat, niet noodzakelijkerwijs elk veld hoeft te worden ingevuld (interpretatie: selectieve invulling). Vraag Q-925b6c1d9b5a8ce6 (open)
• Verwerking en doorzending: De samengestelde datagramgegevens worden overgedragen aan de achterliggende transportlaag van de RDS-module.
• Vrijgave: Na voltooiing van de overdracht of pakketverwerking wordt het object vernietigd, waarbij de virtuele destructor [SWS_RDS_90260] een nette polymorfe opruiming waarborgt.

Foutscenario's

Aangezien ara::rds::IEEE1722Datagram61883_IIDC als gegevensklasse is gedefinieerd, signaleren de methoden ervan geen expliciete AUTOSAR-foutcodes via ara::core::Result. Potentiële foutbronnen ontstaan vooral bij de onjuiste behandeling van de optionele dataleden. Toegang tot lege instanties van ara::core::Optional zonder voorafgaande validatie – bijvoorbeeld bij het uitlezen van sid [SWS_RDS_90252], fn [SWS_RDS_90251] of qpc [SWS_RDS_90249] – kan tot runtimefouten leiden. Als preconditie voor leestoegang moeten afgeleide componenten steeds controleren of het desbetreffende veld is geïnitialiseerd. Voorts moeten onderling afhankelijke of alternatieve velden, zoals fdf_with_sph [SWS_RDS_90257] en fdf_without_sph [SWS_RDS_90259], consistent ten opzichte van elkaar worden ingesteld.