struct ara::diag::DoIPGroupIdentification::GidStatus

De structuur ara::diag::DoIPGroupIdentification::GidStatus dient als datacontainer voor de positieve antwoordgegevens bij het opvragen van de DoIP-groepsidentificatie [SWS_DM_00721]. Deze wordt door een Adaptive Application beschikbaar gesteld wanneer Diagnostic Management de groepsidentificatie bij niet-geconfigureerde DoIpInstantiation.gid via de interface GetGidStatus opvraagt [SWS_DM_00813]. De structuur transporteert de vastgestelde GID-waarden rechtstreeks naar de Diagnostic Manager voor het doorsturen in het DoIP-protocol. Deze is strikt beperkt tot succesvolle antwoorden en bevat geen mechanismen voor foutscenario’s.

meer ›

Context

De datastructuur ara::diag::DoIPGroupIdentification::GidStatus representeert de positieve antwoordgegevens voor de groepsidentificatie in het DoIP-subsysteem (Diagnostic over IP) van het AUTOSAR Adaptive Platform [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 “Struct: GidStatus”. Deze dient als gestandaardiseerde resultaatcontainer voor groepsidentificatiegegevens (GID) wanneer externe diagnoseclients informatie over de voertuig- of groepsidentificatie via DoIP opvragen. Binnen het systeemsamenwerkingsverband interageren daarbij drie hoofdpartners: de externe DoIP-client, het AUTOSAR Diagnostic Management (DM) evenals de applicatiespecifieke Adaptive Application die de interface ara::diag::DoIPGroupIdentification aanbiedt. Voor zover de GID niet statisch via de configuratieparameter DoIpInstantiation.gid is vastgelegd, is het DM conform specificatie verplicht om de GID via de applicatie-interface op te halen [SWS_DM_00813], AUTOSAR_AP_SWS_Diagnostics §8.34.1 “Providing the GID in DoIP protocol messages using application interface”.

Levenscyclus

Als C++-datastructuur (struct) bezit GidStatus geen zelfstandige proces- of servicelevenscyclus, maar fungeert als puur dataoverdrachtsobject [SWS_DM_00721]. Een instantie van GidStatus wordt door de verantwoordelijke Adaptive Application geïnstantieerd en met de actuele identificatiegegevens gevuld zodra de opvraagmethode GetGidStatus wordt aangeroepen [SWS_DM_00724], AUTOSAR_AP_SWS_Diagnostics §8.34.1.1.3.1 “GetGidStatus”. Interpretatie: De structuur wordt vermoedelijk typisch als tijdelijk waarde-object op de stack aangemaakt en als onderdeel van de retourwaarde via kopie- of move-semantiek aan het DM overgedragen, waarmee de levenscyclus ervan na de verwerking van het DoIP-bericht in het DM eindigt. Vraag Q-4974fdbc2c6accbb (open) Aangezien er meerdere diagnoseaanvragen of parallelle DoIP-berichtverwerkingen kunnen optreden, moeten de binnen de structuur gehouden gegevens thread-veilig beschikbaar worden gesteld of voor elke opvraagcontext geïsoleerd worden gegenereerd.

Gebruikspad

Het typische gebruik van GidStatus is onderverdeeld in een vaste interactievolgorde tussen de DoIP-client, Diagnostic Management en de Adaptive Application:

Sequentiediagram: Verloop van het beschikbaar stellen van GidStatus via GetGidStatus bij niet-geconfigureerde GID. Bronnen: [SWS_DM_00721], [SWS_DM_00724], [SWS_DM_00813].

1. Een externe DoIP-client verzendt een diagnose- of identificatieaanvraag via het DoIP-netwerk naar het voertuig.
2. Diagnostic Management controleert de configuratie: is DoIpInstantiation.gid niet geconfigureerd, dan vraagt het DM de groepsidentificatie via GetGidStatus op bij de Adaptive Application [SWS_DM_00813], [SWS_DM_00724].
3. De Adaptive Application bepaalt de groepsidentificatiekenmerken, maakt een instantie van GidStatus met de positieve antwoordgegevens aan en retourneert deze aan het DM [SWS_DM_00721].
4. Het DM haalt de gegevens uit GidStatus en verzendt het volledige DoIP-protocolbericht naar de externe DoIP-client [SWS_DM_00813].

Foutscenario's

De specificatie definieert GidStatus uitdrukkelijk als positieve antwoordgegevens (“Response data of positive response message”) [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 “Struct: GidStatus”. Interpretatie: Indien de Adaptive Application niet in staat is om de groepsidentificatie beschikbaar te stellen, of indien er een interne fout optreedt, wordt er vermoedelijk geen reguliere GidStatus-instantie geretourneerd; in plaats daarvan signaleert de methode GetGidStatus vermoedelijk via gestandaardiseerde foutmechanismen van het platform (zoals foutcodes in ara::core::Result) een fout aan het DM. Vraag Q-01181eb14d27eeb2 (open) Bovendien verduidelijkt de context van verwante DoIP-interfaces zoals ara::diag::DoIPPowerMode [SWS_DM_00814] dat het DM bij nog niet aangeboden interfaces gedefinieerde standaard- of vervangende waarden gebruikt [SWS_DM_01525]; voor de groepsidentificatie vereist het uitblijven van geldige antwoordgegevens een overeenkomstige negatieve afhandeling in het DoIP-protocol, aangezien zonder GID geen geldig positief antwoord kan worden verzonden [SWS_DM_00813].