struct ara::diag::GenericRoutine::OperationOutput

De structuur ara::diag::GenericRoutine::OperationOutput dient als returnstructuur voor positieve antwoordberichten van generieke routine-services in AUTOSAR Adaptive [SWS_DM_00633]. Na succesvolle uitvoering van een routine instantieert de applicatie de structuur en vult zij het lid responseData met de payload van het resultaat SWS Diagnostics p. 80. Een essentiële randvoorwaarde is dat de vector responseData uitsluitend de zuivere resultaatgegevens bevat en dat de RoutineIdentifier expliciet niet opgenomen mag zijn [SWS_DM_00633].

meer ›

Context

De structuur ara::diag::GenericRoutine::OperationOutput dient in de diagnosemodule van AUTOSAR Adaptive als toegewijde datacontainer voor positieve antwoordberichten van generieke routine-services [SWS_DM_00633]. Zij is beschikbaar via de header ara/diag/generic_routine.h [SWS_DM_00633] en kapselt de payload in die een adaptieve diagnosetoepassing na de succesvolle afhandeling van een routine teruglevert aan het diagnosebeheer (ara::diag). Bij de interactie zijn primair drie instanties betrokken: de externe diagnosetester als afzender van routineverzoeken, het platformframework ara::diag voor protocolafhandeling en de applicatiespecifieke implementatie van GenericRoutine, die de functionele logica uitvoert en het resultaat beschikbaar stelt SWS Diagnostics p. 80. De kerntaak van OperationOutput bestaat erin de zuivere uitvoergegevens van de routine gestructureerd beschikbaar te stellen, waarbij de RoutineIdentifier uitdrukkelijk geen deel uitmaakt van deze datastructuur [SWS_DM_00633].

Levenscyclus

Als lichtgewicht datastructuur (struct) bezit OperationOutput een eenvoudige waarde-levenscyclus. De instantiatie vindt vraaggestuurd plaats door de adaptieve diagnosetoepassing, zodra een aan de routine gericht commando (bijvoorbeeld start, stop of resultaatopvraag) positief kon worden afgerond. Het enige data-element is responseData van het type ara::core::Vector<std::uint8_t> [SWS_DM_00633]. De applicatie alloceert de vector, vult deze met de applicatiespecifieke retourgegevens en draagt de voltooide structuur over aan het diagnosesubsysteem. De teruggave aan het diagnoseframework verloopt vermoedelijk typisch asynchroon via Result- of Future-typen van ara::core (interpretatie: asynchrone interfaceconventie van het Adaptive Platform). Vraag Q-e672dfb8b9ff416a (open) Na de overdracht gaat de verantwoordelijkheid voor de serialisatie over op ara::diag. Zodra de gegevens zijn overgedragen of in interne buffers zijn opgenomen, wordt de structuur bij het verlaten van de desbetreffende scope weer vernietigd. Met betrekking tot gelijktijdigheid dient te worden opgemerkt dat OperationOutput wordt aangemaakt voor de context van een individuele operatie-uitvoering; gedeelde, onbeschermde toegang over meerdere threads heen vindt regulier niet plaats.

Gebruikspad

Het reguliere verloop voor het gebruik van OperationOutput omvat meerdere opeenvolgende fasen:

• Verzoekontvangst: een diagnoseclient verzendt een UDS-RoutineControl-verzoek, dat door de diagnoselaag wordt doorgestuurd naar de bevoegde GenericRoutine-instantie SWS Diagnostics p. 84.
• Uitvoering: de adaptieve applicatie voert de aangevraagde routine uit en verwerkt de invoerparameters.
• Resultaatgeneratie: na succesvolle uitvoering genereert de applicatie een exemplaar van OperationOutput en vult responseData met de resulterende bytewaarden [SWS_DM_00633].
• Antwoordoverdracht: de structuur wordt als positief bewerkingsresultaat teruggegeven aan ara::diag.
• Antwoordverzending: Diagnostic Management verzorgt vermoedelijk de automatische voorvoeging van de RoutineIdentifier vóór het responseData-veld bij het samenstellen van het UDS-antwoord (interpretatie: toevoeging van de protocolheader door de daemon) en verzendt het totale pakket naar de client [SWS_DM_00633]. Vraag Q-ccdd2867b87d00d1 (open)

Sequentiediagram: typisch verloop van de databeschikbaarstelling via OperationOutput bij succesvolle routine-uitvoering. Bronnen: [SWS_DM_00633], SWS Diagnostics p. 80.

Foutscenario's

Als tijdens de afhandeling van de routine een fout optreedt of als de meegegeven invoergegevens ongeldig zijn, wordt het gebruikspad van OperationOutput afgebroken. In geval van een fout verzendt de applicatie vermoedelijk in plaats van OperationOutput een foutcode naar het diagnosebeheer, waardoor een negatief UDS-antwoord wordt geactiveerd (interpretatie: foutpad via Result/Error-Domain). Vraag (open) Als essentiële voorwaarde voor het gebruik van OperationOutput geldt zodoende dat de routinebewerking volledig en foutloos is voltooid. Als naconventie garandeert de applicatie dat responseData uitsluitend de zuivere payload van het positieve antwoordbericht bevat en dat er geen protocolvoorvoegsels zoals de RoutineIdentifier in zijn opgenomen [SWS_DM_00633]. Mocht een routine weliswaar succesvol zijn beëindigd, maar geen aanvullende retourgegevens genereren, dan blijft de vector responseData leeg SWS Diagnostics p. 70.