namespace <DataElement-Namespace>

De namespace <DataElement-Namespace> bundelt in de AUTOSAR Adaptive-module diag voor release R25-11 gegenereerde interfaces voor de gestructureerde koppeling van applicatiespecifieke diagnose-data-elementen aan het centrale diagnosesysteem. Via de interfaceklasse <DataElementInterface> implementeert de adaptieve applicatie concrete lees- en schrijfoperaties die door de diagnosestack worden uitgevoerd bij binnenkomende diagnoseverzoeken. Wat betreft de levenscyclus berust het aanmaken en registreren van de interface-instantie bij de applicatie, waarbij interpretatie: de instantie gedurende de gehele bedrijfsduur geldig en voor gelijktijdige aanroepen thread-safe moet worden gehouden.

meer ›

Context

In het kader van het AUTOSAR Adaptive Platform voor release R25-11 stelt het functionele cluster diag (Diagnostic Management) gestandaardiseerde mechanismen beschikbaar om voertuigdiagnosediensten conform UDS aan te bieden en aan voertuiginterne functies te koppelen. De namespace <DataElement-Namespace> vormt hierbij het logische kader voor interfaces voor het vastleggen en wijzigen van diagnose-data-elementen. De identifier <DataElement-Namespace> fungeert vermoedelijk als generieke tijdelijke aanduiding voor een modelspecifieke C++-namespace die tijdens de codegeneratie uit de formele ARXML-modelbeschrijvingen voor een concreet diagnose-data-element wordt geïnstantieerd. Vraag Q-2a710983ba4634ab (open)

Het centrale element binnen deze namespace is de klasse <DataElementInterface>, die als DiagnosticDataElementInterface is getypeerd. Deze interface vormt het formele contract tussen de adaptieve diagnosestack en de applicatiespecifieke softwarecomponent. De gedeclareerde interfaceklasse <DataElementInterface> dient voor de applicatiekoppeling, vermoedelijk om lees- en schrijfoperaties op diagnose-data-elementen zoals data-identifiers (DID's) typeveilig aan de adaptieve applicatie te delegeren. Vraag Q-5fbb9db6b949d851 (open) Op deze wijze wordt een duidelijke ontkoppeling tussen de generieke protocolafhandeling van de diagnosedienst en de interne databeschikbaarstelling van de regeleenheid gewaarborgd.

Levenscyclus

De levenscyclus van de in <DataElement-Namespace> gedefinieerde componenten is gekoppeld aan de uitvoeringsfasen van de adaptieve applicatie en de diagnosemanager. De instantiëring van een concrete implementatie van <DataElementInterface> vindt regulier plaats tijdens de initialisatie- en opstartfase van het desbetreffende applicatieproces. Wat betreft de eigendomsverhoudingen berust het aanmaken en vernietigen van de concrete implementatie van <DataElementInterface> bij de gebruikende applicatie, waarbij interpretatie: de instantie gedurende de gehele registratie- en bedrijfsfase in het diagnosesysteem geldig moet worden gehouden voordat deze bij de deïnitialisatie veilig mag worden vrijgegeven.

Tijdens de operationele fase verblijft de geregistreerde interface-instantie in de toestand van ontvangstgereedheid voor binnenkomende diagnoseverzoeken. Aangezien externe diagnoseverzoeken via de diagnosestack asynchroon binnenkomen en door worker-threads van het runtimesysteem kunnen worden verwerkt, moet de implementatie van de interfacemethoden thread-safe en herintredend zijn ontworpen. Vóór het afsluiten van het applicatieproces moet de binding met de diagnosemanager worden ontkoppeld om ongeldige pointertoegangen tot vernietigde interfaceobjecten te voorkomen.

Gebruikspad

Het typische gebruik van de interfaces uit <DataElement-Namespace> valt uiteen in implementatie, registratie, runtimebediening en opschoning. De applicatiesoftware leidt eerst een concrete klasse af van <DataElementInterface> en overschrijft de vereiste callback-methoden voor toegang tot de diagnosedata. Bij het opstarten instantieert de applicatie deze klasse en meldt deze bij de runtime-omgeving van module diag aan als dataprovider.

Ontvangt het diagnosecluster vervolgens een UDS-dienstverzoek (bijvoorbeeld voor het opvragen of programmeren van een DID), dan delegeert het de datatoegang direct naar de geregistreerde instantie van <DataElementInterface>. De applicatie leest of actualiseert de opgevraagde gegevens en retourneert het resultaat aan het diagnosesysteem, dat daaruit het diagnoseantwoord genereert. Bij het ordelijk beëindigen van de applicatie wordt de registratie van de instantie ongedaan gemaakt en het geheugen correct vrijgegeven.