klasse ara::diag::Indicator

De interface dient voor het gestructureerd opvragen en bewaken van voertuigdiagnose-indicatoren binnen het AUTOSAR Adaptive Platform. Applicaties instantiëren het object via een gemodelleerde identifier en kunnen de actuele status via een asynchrone opvraagmethode ophalen [SWS_DM_00744]. Daarnaast kan een door de gebruiker gedefinieerde callback-functie worden geregistreerd, die statusupdates rechtstreeks bij wijzigingen ontvangt [SWS_DM_00745]. Als essentiële randvoorwaarde is de instantie strikt aan een poort gebonden, noch kopieerbaar noch verplaatsbaar en vereist deze bij registratie en vernietiging synchronisatie tegen gelijktijdige aanroepen.

meer ›

Context

De klasse ara::diag::Indicator fungeert in de Adaptive Platform-module diag als centrale representatie van het DiagnosticIndicatorInterface [SWS_DM_00742]. Haar kerntaak bestaat erin applicaties toegang te bieden tot diagnose-indicatoren zoals waarschuwingslampjes of functieweergaven (bijvoorbeeld een Malfunction Indicator Light, MIL).

Bij de interactie zijn in hoofdzaak drie componenten betrokken: een gebruikende adaptieve applicatie (zoals een instrumentenpaneel of een HMI-dienst), de instantie van ara::diag::Indicator als lokaal interface-eindpunt en de Diagnostic Management Daemon (DM). Deze laatste verwerkt de voertuigbrede diagnosegebeurtenissen en UDS-DTC-statussen en levert de onderliggende diagnosefunctionaliteit [SWS_DM_00744].

Contextdiagram: interactiepartners van de interface ara::diag::Indicator tussen applicatielogica en Diagnostic Management Daemon. Bronnen: [SWS_DM_00742], [SWS_DM_00744].

Levenscyclus

De creatie van een ara::diag::Indicator-object vindt expliciet plaats door doorgifte van een ara::core::InstanceSpecifier aan de constructor [SWS_DM_00742]. Deze identifier bindt het object aan een in het ontwerpmodel gedefinieerde PortPrototype, die dwingend als DiagnosticIndicatorInterface getypeerd moet zijn [SWS_DM_00742].

Wat betreft eigendomsverhoudingen en objectsemantiek is ara::diag::Indicator ontworpen als een strikte enkele instantie: noch kopiëren noch verplaatsen is toegestaan. Dienovereenkomstig zijn de copy-constructor [SWS_DM_01629], de move-constructor [SWS_DM_01630], de copy-toewijzingsoperator [SWS_DM_01627] en de move-toewijzingsoperator [SWS_DM_01628] als verwijderd (=delete) gedeclareerd.

De levenscyclus eindigt met de aanroep van de destructor ~Indicator() [SWS_DM_00743]. Terwijl constructor en statusopvraag als thread-safe zijn gespecificeerd [SWS_DM_00742], [SWS_DM_00744], is de destructor niet thread-safe [SWS_DM_00743]. De aanroepende applicatie moet daarom waarborgen dat er tijdens de vernietiging geen gelijktijdige methode-aanroepen of notifier-uitvoeringen meer plaatsvinden.

Gebruikspad

Na succesvolle initialisatie ondersteunt de klasse twee complementaire gebruiksmodellen voor het bepalen van de indicatortoestand:

• Gebeurtenisgestuurde notificatie: via SetNotifier() kan een callback-functie van het type IndicatorStatusTypeNotifier worden geregistreerd [SWS_DM_00745], [SWS_DM_02129]. Zodra de status van de indicator verandert, roept de runtime-omgeving deze notifier aan. Een opeenvolgende aanroep van SetNotifier() overschrijft de eerder geregistreerde handler [SWS_DM_00745]. Omdat SetNotifier() niet thread-safe is, moet de registratie extern worden gesynchroniseerd [SWS_DM_00745]. Vermoedelijk wordt de notifier uitgevoerd in de context van een achtergrondthread van Diagnostic Management, waardoor hierin geen tijdsintensieve blokkades mogen plaatsvinden. Vraag Q-c27898ecefb8006f (open)
• Gerichte opvraag: via GetIndicatorState() kan de actuele toestand op elk willekeurig moment actief worden opgevraagd [SWS_DM_00744]. De methode is thread-safe en levert een ara::core::Future<IndicatorStatusType> op [SWS_DM_00744]. Interpretatie: de asynchrone beschikbaarstelling via een future wijst erop dat de opvraag intern via interprocescommunicatie (IPC) wordt gedelegeerd aan de centrale Diagnostic Management Daemon. Vraag Q-61a650bd8ab7fc04 (open)

Sequentiediagram: typisch verloop van instantiëring, notifier-registratie, toestandopvraag en objectvernietiging. Bronnen: [SWS_DM_00742], [SWS_DM_00744], [SWS_DM_00745], [SWS_DM_00743].

Foutscenario's

Foutcondities kunnen zowel in de initialisatiefase als tijdens runtime optreden:

• Configuratieschendingen bij de constructie: de constructor meldt modelleringsinconsistenties in de vorm van gedefinieerde violations [SWS_DM_00742]. Hiertoe behoren InstanceSpecifierMappingIntegrityViolation (de identifier kan niet worden herleid of verwijst niet naar een poort), PortInterfaceMappingViolation (de gereferentieerde poort is niet getypeerd door een DiagnosticIndicatorInterface), ProcessMappingViolation (geen passend gemodelleerd proces voor de runtime-instantie aanwezig) en InstanceSpecifierAlreadyInUseViolation (de identifier wordt in het proces al door een andere instantie gebruikt) [SWS_DM_00742].
• Uitval van diagnosefuncties: als de uitvoering van GetIndicatorState() mislukt, wordt via de geretourneerde future de foutcode DiagErrc::kServiceNotAvailable getransporteerd [SWS_DM_00744]. Dit gebeurt wanneer essentiële functies van Diagnostic Management op het moment van aanroepen niet beschikbaar zijn [SWS_DM_00744].
• Gelijktijdige toegangen: aangezien SetNotifier() [SWS_DM_00745] en de destructor [SWS_DM_00743] niet thread-safe zijn, leidt onbeschermde gelijktijdige toegang tot ongedefinieerd runtimegedrag.