struct <RoutineInterface-Namespace>::<RoutineInterface>::<RoutineInterface6>StartOutput

De structuur <RoutineInterface6>StartOutput uit de module diag van de AUTOSAR Adaptive Platform kapselt alle uitvoerargumenten in voor de startoperatie van een diagnoseroutine. Bij ontvangst van een startverzoek vult de applicatiespecifieke routine-implementatie de datavelden van de structuur met de resulterende waarden en draagt de instantie, vermoedelijk ingebed in een asynchroon retourobject, over aan het platform. Vraag (open) Fouttoestanden worden daarbij volgens interpretatie niet in de datastructuur zelf gesignaleerd, maar via afzonderlijke foutcodes, waardoor vóór de overdracht altijd alle vereiste uitvoerparameters volledig en consistent geïnitialiseerd moeten zijn.

meer ›

Context

De structuur <RoutineInterface6>StartOutput maakt deel uit van de module diag van de AUTOSAR Adaptive Platform in release R25-11. Binnen deze diagnosemodule dient het type als datacontainer die de uitgaande argumenten voor de operatie voor het starten van een diagnoseroutine samenvat. Bij het uitvoeren van diagnosefuncties via routinebesturing interageren typisch een applicatiespecifieke service-implementatie en de diagnose-infrastructuur van het platform met elkaar. De structuur fungeert hierbij op het grensvlak tussen de concrete routine-implementatie en de beheerlaag voor diagnoseverzoeken.

In dit verband neemt <RoutineInterface6>StartOutput de rol op zich om alle uitgangsdata die een applicatie genereert bij het uitvoeren van het startcommando, gebundeld beschikbaar te stellen. Interpretatie: De structuur dient vermoedelijk als zuiver gegevensoverdrachtsobject (Data Transfer Object, DTO) zonder eigen bedrijfslogica, waarvan de specifieke member-velden overeenkomen met de in het interfacemodel gedefinieerde uitgangsparameters van de routine. Vraag Q-99209f0267b43982 (open) Door deze inkapseling wordt gewaarborgd dat het aanroepende diagnosebeheer de retourwaarden als één geheel in ontvangst kan nemen en kan voorbereiden voor verdere verwerking of de terugkoppeling naar externe diagnosetesters.

Levenscyclus

De levenscyclus van <RoutineInterface6>StartOutput is nauw gekoppeld aan de uitvoeringscontext van de startoperatie van de diagnoseroutine. Een instantie van deze structuur wordt door de uitvoerende routine-implementatie van de applicatie geïnstantieerd zodra een verzoek tot het starten van de routine wordt verwerkt. Tijdens de verwerking kent de applicatie aan de afzonderlijke attributen van de structuur de resulterende data van het startproces toe.

Wat betreft de eigendomsverhoudingen ligt de zeggenschap over het object aanvankelijk lokaal bij de uitvoerende routine. Wanneer de overdracht aan het diagnosebeheer plaatsvindt, gebeurt dit typisch via doorgifte op waarde of move-semantiek, bijvoorbeeld in de context van asynchrone retourstructuren van het platform. Vraag (open) Na de overname door de platform-runtime-omgeving en het doorsturen van de data naar de diagnoseprotocollaag eindigt de levenscyclus van het object, waarna de structuur wordt vernietigd en het ingenomen geheugen wordt vrijgegeven. Aangezien de structuur als zuivere datacontainer is ontworpen, bezit ze geen eigen interne toestandsmachine; levensfasen beperken zich tot aanmaak, vulling, overdracht en vrijgave.

Gebruikspad

Het typische verloop voor het gebruik van <RoutineInterface6>StartOutput is onderverdeeld in een vaste reeks stappen binnen de routineverwerking:

• Initialisatie: Bij ontvangst van een startverzoek instantieert de aanbiedende applicatie een instantie van <RoutineInterface6>StartOutput op de stack of binnen de verantwoordelijke uitvoeringscontext.
• Vullen van de datavelden: De applicatie voert de inhoudelijke controles en acties voor het aanlopen van de routine uit. De daarbij bepaalde uitvoerdata worden aan de velden van de structuur toegewezen.
• Terugkoppeling: De volledig gevulde structuur wordt als functieresultaat geretourneerd aan het diagnosesysteem. Vermoedelijk vindt de teruggave plaats ingebed in een getypeerde container zoals ara::core::Result of ara::core::Future om te voldoen aan de asynchrone interfaceconventie van de Adaptive Platform. Vraag Q-08976b247fab2180 (open)
• Verwerking door het platform: Het platform leest de aanwezige waarden uit, zet deze om in het overeenkomstige diagnoseantwoordtelegram en sluit het verwerkingsproces af.

Voor ontwikkelaars van diagnose-applicaties bestaat de hoofdtaak erin om de correcte en volledige toewijzing van alle vereiste uitgangswaarden vóór het verlaten van de methode te waarborgen.

Foutscenario's

Aangezien <RoutineInterface6>StartOutput als datastructuur voor reguliere uitvoerparameters is gedefinieerd, kapselt deze zelf geen foutcodes of uitzonderingsafhandelingen in. Foutscenario's treden vooral op wanneer de routine niet correct kan worden gestart of wanneer er ongeldige uitgangswaarden worden gegenereerd.

Interpretatie: Mislukt de uitvoering van de startoperatie, dan worden de resulterende diagnosefouten vermoedelijk niet via velden van deze structuur getransporteerd, maar via het foutmodel van het platform, bijvoorbeeld door middel van gestandaardiseerde foutcodes in ara::core::ErrorCode. Vraag Q-fe76c79ba073f321 (open) Een preconditie voor het succesvolle gebruik van de structuur is dat de initiërende startactie toegestaan was en dat aan de vereiste voorwaarden voor routine-uitvoering is voldaan. Als postconditie geldt dat alle in de interface gedeclareerde uitvoerparameters van de structuur in een geldige en consistente toestand worden achtergelaten voordat de overdracht aan het diagnosesysteem plaatsvindt.