klasse ara::tsync::ConsumerTimeBaseValidationNotification

De interface ara::tsync::ConsumerTimeBaseValidationNotification informeert consumer-applicaties over nieuw beschikbare meetdatablokken van een tijdbasis. Via de callback-methoden SetSlaveTimingData [SWS_TS_00420] en SetPdelayInitiatorData [SWS_TS_00422] draagt het systeem gedetailleerde timing- en validatiegegevens over voor de Time Slave en de pDelay-initiator. Applicatieontwikkelaars leiden af van de klasse, implementeren de gegevensverwerking en moeten waarborgen dat er geen uitzonderingen worden geworpen, aangezien alle methoden als noexcept en uitzonderingsveilig zijn gespecificeerd. Bovendien vereist de classificatie als non_threadsafe synchronisatie aan de applicatiezijde bij gelijktijdige toegangen.

meer ›

Context

De klasse ara::tsync::ConsumerTimeBaseValidationNotification vormt een callback-interface in de module tsync van het AUTOSAR Adaptive Platform. Het doel ervan is om een consumer-applicatie te informeren zodra er nieuwe geregistreerde datablokken beschikbaar zijn voor een bewaakte tijdbasis.

Bij deze interactie zijn in wezen drie componenten betrokken:

• Tijdbasis van de module tsync: registreert continu tijd- en synchronisatiemetingen in het communicatienetwerk.
• Interface ConsumerTimeBaseValidationNotification: definieert de overdrachtspunten voor geregistreerde meetdatablokken via de methoden SetSlaveTimingData [SWS_TS_00420] en SetPdelayInitiatorData [SWS_TS_00422].
• Consumer-applicatie: implementeert de callback-methoden, neemt de beschikbaar gestelde meetwaarden over en voert de functionele validatie van de tijdbasis uit.

Dankzij deze structuur wordt de applicatiespecifieke validatielogica netjes ontkoppeld van de platforminterne registratie van de tijdgegevens.

Levenscyclus

Als abstracte interfaceklasse met zuiver virtuele methoden kan ara::tsync::ConsumerTimeBaseValidationNotification niet direct worden geïnstantieerd. Een consumer-applicatie leidt een concrete klasse af en implementeert de vereiste methoden.

Het aanmaken en het eigenaarschap vallen volledig onder de verantwoordelijkheid van de consumer-applicatie. Vermoedelijk maakt de applicatie het callback-object aan tijdens haar initialisatiefase en koppelt zij dit aan de desbetreffende tijdbasis van de tsync-service. Vraag Q-a423ce4cbd4eeaaa (open)

Voor de vernietiging biedt de klasse een virtuele destructor: virtual ~ConsumerTimeBaseValidationNotification() noexcept = default; [SWS_TS_01300]. De declaratie als virtuele destructor waarborgt dat instanties van afgeleide klassen typeveilig en zonder resourcelekken kunnen worden vrijgegeven via basisklassepointers.

Wat betreft concurrency zijn de notificatiemethoden SetSlaveTimingData [SWS_TS_00420] en SetPdelayInitiatorData [SWS_TS_00422] gespecificeerd als non_threadsafe. Aangezien de aanroep door de platformservice vermoedelijk plaatsvindt in de context van een achtergrondthread, is de implementatie aan applicatiezijde er zelf verantwoordelijk voor om toegangen tot gedeelde applicatiebronnen te beveiligen. Vraag Q-1b857df043504eec (open)

Gebruikspad

Het typische verloop voor het gebruik van de validatienotificatie omvat de volgende stappen:

1. Implementatie: de consumer-applicatie implementeert een van ara::tsync::ConsumerTimeBaseValidationNotification afgeleide klasse.
2. Ontvangst van Time Slave-meetgegevens: zodra er voor de Time Slave van de tijdbasis een nieuw meetdatablok is geregistreerd, roept de tijdservice de methode SetSlaveTimingData aan [SWS_TS_00420] en draagt deze de gedetailleerde validatiegegevens over via de parameter measurementData van het type TimeSlaveMeasurementType.
3. Ontvangst van pDelay-initiator-meetgegevens: als er voor de pDelay-initiator nieuwe meetgegevens beschikbaar zijn, vindt de aanroep van SetPdelayInitiatorData [SWS_TS_00422] met de gedetailleerde timing-gegevens in PdelayInitiatorMeasurementType plaats.
4. Verwerking: de consumer-applicatie analyseert de overgedragen datablokken om synchronisatiefouten of looptijdafwijkingen te detecteren.
5. Objectvrijgave: bij beëindiging van de bewaking wordt de instantie ontmanteld via de virtuele destructor [SWS_TS_01300].

Sequentiediagram: overdracht van geregistreerde meetdatablokken voor Time Slave en pDelay-initiator aan de consumer-implementatie. Bronnen: [SWS_TS_00420], [SWS_TS_00422].

Foutscenario's

De interfacemethoden zijn ontworpen voor maximale robuustheid en deterministische aanroepen:

• Uitzonderingsveiligheid: alle lidfuncties – SetSlaveTimingData [SWS_TS_00420], SetPdelayInitiatorData [SWS_TS_00422] en de destructor [SWS_TS_01300] – zijn gedeclareerd met noexcept en gespecificeerd als uitzonderingsveilig (exception safe). De overschrijvende methoden in de consumer-applicatie mogen geen uitzonderingen naar buiten propageren, aangezien dit leidt tot onmiddellijke programmabeëindiging.
• Ontbrekende terugmeldkanalen: aangezien de callback-methoden het retourtype void hebben, kunnen verwerkingsfouten binnen de applicatielogica niet worden teruggemeld aan de tsync-module. De applicatie moet eventuele fouttoestanden zelfstandig intern afhandelen en loggen.
• Risico's van concurrency: vanwege de eigenschap non_threadsafe ([SWS_TS_00420], [SWS_TS_00422]) moet worden voorkomen dat meerdere datablokken parallel worden verwerkt zonder vergrendeling aan de applicatiezijde. Interpretatie: het callback-object moet bovendien gedurende de gehele registratieduur bij de tijdbasis geldig blijven om fatale toegangen tot reeds vrijgegeven geheugen te voorkomen. Vraag Q-934e451f6a0099c1 (open)