class <RoutineInterface-Namespace>::<RoutineInterface>

Die Konstruktorfunktion [SWS_DM_00589] dient der Instanziierung einer Routine-Schnittstelle (DiagnosticRoutine) über einen Instanzbezeichner. Die Deklaration ist als noexcept spezifiziert und gilt als ausnahmesicher (exception safe) sowie threadsicher (thread-safe) SWS Diagnostics §8.30.2.2.1.8 „{<routine-interface-name-1>}“.

Parameter und Aufruf

• instanceSpec (ara::core::InstanceSpecifier): Bezeichner der spezifischen Service-Instanz, die an einen passenden Modell-Port gebunden ist.
• concurrencyType (ara::diag::ConcurrencyType): Legt fest, ob die Schnittstelle nebenläufig bzw. threadsicher ausgeführt wird (kConcurrent) oder nicht threadsicher ist (kNotConcurrent).

Laufzeit- und Modellprüfungen

Während der Konstruktion prüft das Framework die Modell- und Prozesskonfiguration. Bei fehlerhaften Zuordnungen oder Mehrfachverwendungen werden spezifische Verletzungen (Violations) ausgelöst [SWS_DM_00589]:

• InstanceSpecifierMappingIntegrityViolation: Der InstanceSpecifier lässt sich im Kontext des Executables nicht auflösen oder verweist nicht auf einen PortPrototype.
• PortInterfaceMappingViolation: Ein durch DiagnosticRoutineInterface typisierter PortPrototype wird nicht von einem DiagnosticServiceGenericMapping referenziert.
• ProcessMappingViolation: Zur vorhandenen Instanzreferenz existiert kein passender modellierter Prozess zur Laufzeit.
• InstanceSpecifierAlreadyInUseViolation: Der angegebene InstanceSpecifier wird innerhalb des aktuellen Prozesses bereits von einer bestehenden Instanz verwendet.

Verwendung und Semantik

Die Methode Offer schaltet das Diagnostic Management (DM) frei, um eingehende Diagnoseanfragen an den zugehörigen Routinen-Handler weiterzuleiten [SWS_DM_00594]. Der Aufruf erfolgt synchron und parameterlos über die typisierte Schnittstelle der Routine und wirft keine Ausnahmen (noexcept) [SWS_DM_00594]. Als Rückgabetyp dient ara::core::Result<void>, wodurch entweder der erfolgreiche Abschluss signalisiert oder im Fehlerfall ein Fehlercode zurückgegeben wird [SWS_DM_00594].

Fehlerbehandlung

Wird Offer für eine Routinen-Instanz aufgerufen, die dem DM bereits aktiv bereitgestellt wurde, schlägt die Registrierung fehl. In diesem Fall liefert die Methode den Fehlercode DiagOfferErrc::kAlreadyOffered mit Rollback-Semantik zurück [SWS_DM_00594] (definiert mit dem Wert 101 im allgemeinen Kontext der Diagnose-Fehlerdomäne [SWS_DM_00514]).

Nebenläufigkeit und Einschränkungen

Die Funktion ist zwar als ausnahmesicher (exception safe) spezifiziert, jedoch ausdrücklich als nicht threadsicher (not thread-safe) deklariert [SWS_DM_00594]. Mehrere Aufrufe auf derselben Instanz dürfen nicht ungeschützt nebenläufig ausgeführt werden. Da die Spezifikation keine nebenläufige Nutzung vorsieht, dürfte die Registrierung typischerweise synchron während der Initialisierungsphase der verarbeitenden Applikation erfolgen. Frage Q-6a0f15497f03ac09 (offen)

Zusammenspiel im Diagnosemodul

Das Bereitstellungsmuster über Offer ist im AUTOSAR-Diagnosemanagement über verschiedene Schnittstellentypen hinweg vereinheitlicht, beispielsweise bei generischen Routinen [SWS_DM_00557], Daten-Elementen [SWS_DM_00597], Data-Identifiern [SWS_DM_00599] sowie generischen UDS-Diensten [SWS_DM_00619]. Obwohl die Nomenklatur an ara::com angelehnt ist, handelt es sich um eine diagnostikspezifische Funktionalität, die nicht mit der allgemeinen Dienstvermittlung verwechselt werden darf AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 „Monitors“.

Verwendung

Die Schnittstellenmethode RequestResult dient der Bereitstellung der RoutineControl-Funktionalität zur Abfrage von Routine-Ergebnissen innerhalb einer typisierten Diagnoseschnittstelle [SWS_DM_00593]. Beim Aufruf zur Verarbeitung der UDS-Subfunktion requestRoutineResults (Service 0x31, vgl. [SWS_DM_00575]) werden die geordneten Eingabeargumente des zugehörigen ArgumentDataPrototype, Metainformationen über metaInfo sowie ein cancellationHandler übergeben AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 „RequestResult“.

Über das Objekt cancellationHandler kann die Implementierung über IsCanceled aktiv prüfen, ob die laufende Diagnosekonversation abgebrochen wurde, oder via SetNotifier eine Benachrichtigungsfunktion registrieren, die bei einem Abbruch aufgerufen wird [SWS_DM_00593]. Die Ausführung erfolgt asynchron und liefert ein ara::core::Future, das im Erfolgsfall das Ergebnisobjekt gemäß [SWS_DM_00583] enthält [SWS_DM_00593].

Fehlerbehandlung

Tritt bei der Verarbeitung ein Fehler auf, wird das ara::core::Future mit einem entsprechenden Fehler aufgelöst. Dies umfasst negative Response Codes (NRCs nach ISO 14229-1) über ara::diag::DiagUdsNrcErrc oder anwendungsspezifische Fehler über Ap ApplicationError [SWS_DM_00593].

Nebenläufigkeit und Einschränkungen

Die Methode ist als noexcept deklariert und gilt als ausnahmesicher (exception safe), ist jedoch ausdrücklich nicht threadsicher (not thread-safe) AUTOSAR_AP_SWS_Diagnostics §8.30.2.2.1.2 „RequestResult“. Aufgrund dieser Einstufung dürfte die aufrufende Komponente für eine geeignete Synchronisation bei parallelen Aufrufen an derselben Instanz verantwortlich sein. Frage Q-aa5788303ddff2bc (offen)

Die rein virtuelle Funktion Start im Klassenbereich <RoutineInterface-Namespace>::<RoutineInterface> dient der Bereitstellung einer RoutineControl-Operation in der Rolle Start für modellspezifische Diagnoseroutinen ([SWS_DM_00591]). Sie wird über den Header <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h deklariert ([SWS_DM_00591]). Der Aufruf übergibt die geordneten Eingangsargumente der jeweiligen Routine, Diagnosekontextinformationen über metaInfo sowie das Objekt cancellationHandler zur Steuerung von Konversationsabbrüchen ([SWS_DM_00591]).

Über den Parameter cancellationHandler kann die Implementierung mit cancellationHandler.IsCanceled prüfen, ob die zugehörige Konversation abgebrochen wurde, wobei im Fall eines Abbruchs TRUE und andernfalls FALSE zurückgegeben wird ([SWS_DM_00591]). Ergänzend lässt sich mit cancellationHandler.SetNotifier eine Benachrichtigungsfunktion registrieren, die im Abbruchfall ausgelöst wird ([SWS_DM_00591]). Die asynchrone Rückgabe erfolgt über ein ara::core::Future, das im Erfolgsfall das generierte Ergebnisobjekt StartOutput gemäß [SWS_DM_00581] bereitstellt ([SWS_DM_00591]).

Im Fehlerfall ist das ara::core::Future mit einem passenden Negative Response Code (NRC) aus ara::diag::DiagUdsNrcErrc gemäß ISO 14229-1 oder einem anwendungsspezifischen ApplicationError zu belegen ([SWS_DM_00591]). Die Methode ist als noexcept und exception safe spezifiziert, gilt jedoch als not thread-safe ([SWS_DM_00591]). Interpretation: Aus der Einstufung als not thread-safe dürfte folgen, dass nebenläufige Aufrufe derselben Instanz extern synchronisiert werden müssen. Frage Q-124d8076818ac2e1 (offen) Während diese Schnittstelle modellspezifisch generierte Routinen bedient, bietet GenericRoutine::Start das funktionale Pendant für generisch behandelte Diagnoseroutinen ([SWS_DM_00554]).

Die Methode Stop dient der Bereitstellung der RoutineControl-Funktionalität zum Anhalten einer Diagnoseroutine innerhalb einer typisierten Routinen-Schnittstelle ([SWS_DM_00592]). Ein Aufruf dürfte typischerweise durch den Diagnostic Management Daemon bei Empfang einer entsprechenden UDS-Diagnoseanforderung (Subfunktion 0x02) ausgelöst werden, analog zum generischen Gegenstück [SWS_DM_00555]. Frage Q-cd626f527c6dfe92 (offen)

Der Aufruf erfolgt asynchron und liefert ein ara::core::Future zurück ([SWS_DM_00592]):

• Parameter: Neben den modellspezifischen Eingangsargumenten {<routine-interface-stop-in-arg-symbol-0toN>} werden Metainformationen der Anfrage (metaInfo) sowie ein cancellationHandler übergeben ([SWS_DM_00592]). Über den cancellationHandler kann die Implementierung per IsCanceled aktiv einen Abbruch abfragen oder mit SetNotifier eine Benachrichtigung registrieren, falls die Diagnosekonversation abgebrochen wird.
• Rückgabewert: Bei erfolgreichem Stoppen stellt das Future ein typisiertes StopOutput-Objekt bereit ([SWS_DM_00582]).

Fehlerbehandlung: Schlägt das Stoppen fehl, enthält das zurückgegebene Future einen anwendbaren Negative Response Code (NRC) gemäß ISO 14229-1 via ara::diag::DiagUdsNrcErrc oder einen modellspezifischen Ap ApplicationError ([SWS_DM_00592]).

Nebenläufigkeit und Einschränkungen: Die Funktion ist als exception safe, aber explizit als not thread-safe spezifiziert ([SWS_DM_00592]). Mehrfache oder nebenläufige Aufrufe an derselben Schnittstelleninstanz müssen vom Aufrufer koordiniert werden, und die Routine muss etwaige Ressourcen freigeben bzw. auf Abbruchanforderungen des Handlers reagieren.

Die Methode StopOffer im Scope von <RoutineInterface> dient dazu, die Weiterleitung von Diagnoseanforderungsnachrichten aus dem Diagnostic Management (DM) an die Routine-Implementierung zu deaktivieren [SWS_DM_00595]. Die Funktion besitzt keine Übergabeparameter und gibt keinen Wert zurück [SWS_DM_00595].

• Verwendung und Aufrufkontext: Der Aufruf erfolgt synchron, um die Registrierung der Routine-Schnittstelle beim DM aufzuheben. Die Deklaration erfolgt in der Header-Datei <RoutineInterfaceDirectoryPath>/<RoutineInterfaceShortname>.h [SWS_DM_00595]. Obwohl die Namensgebung an die Service-Methoden von ara::com angelehnt ist, handelt es sich um eine diagnostikspezifische API des DM, die nicht mit der Kommunikationsverwaltung vermengt werden darf (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 „Monitors“).
• Fehlerbehandlung: Die Operation ist als noexcept deklariert und als ausnahmesicher (exception safe) klassifiziert [SWS_DM_00595]. Spezifische Fehlercodes oder Fehlermeldungen sind für diese Methode nicht definiert.
• Nebenläufigkeit und Einschränkungen: Die Funktion ist als nicht threadsicher (not thread-safe) spezifiziert [SWS_DM_00595]; Aufrufe auf derselben Instanz bedürfen daher einer externen Synchronisation. Interpretation: Aufrufer dürften laufende Routinenausführungen vor dem Aufruf geordnet beenden müssen, da der Standard lediglich die Deaktivierung des Weiterleitungsmechanismus beschreibt. Frage Q-b0f524c0f2d7af52 (offen)
• Zusammenspiel: Das Bereitstellungs- und Abmeldemuster entspricht dem standardisierten Ansatz im Diagnostic Management, wie er analog für generische Routinen [SWS_DM_00558], generische UDS-Dienste [SWS_DM_00620] und Data-Identifier [SWS_DM_00600] vorgegeben ist.