classe <DataIdentifier-Namespace>::<DataIdentifierInterface>

Utilisation

La fonction constructeur <DataIdentifierInterface> sert à instancier un identificateur de données à partir d'un ara::core::InstanceSpecifier [SWS_DM_00585]. La déclaration s'effectue au sein de l'espace de noms <DataIdentifier-Namespace> via le fichier d'en-tête #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" [SWS_DM_00585]. L'appel synchrone est spécifié comme noexcept et possède les propriétés « exception safe » ainsi que « thread-safe » [SWS_DM_00585].

La fonction accepte les paramètres d'entrée suivants [SWS_DM_00585] :

• instanceSpec (ara::core::InstanceSpecifier) : identificateur de l'instance concrète d'un service [SWS_DM_00585].
• concurrencyType (ara::diag::ConcurrencyType) : définit si l'interface est exploitée de manière sûre du point de vue des threads avec kConcurrent ou non sûre du point de vue des threads avec kNotConcurrent [SWS_DM_00585].

Gestion des erreurs et règles de modélisation

La fonction ne renvoie aucune valeur et ne lève aucune exception. Des erreurs dans la configuration ou la modélisation entraînent à la place des violations définies [SWS_DM_00585] :

• InstanceSpecifierMappingIntegrityViolation : le instanceSpec ne peut pas être résolu dans le contexte de l'exécutable ou ne renvoie pas à un PortPrototype [SWS_DM_00585].
• PortInterfaceMappingViolation : un PortPrototype typé par DiagnosticDataIdentifierInterface n'est pas référencé par un DiagnosticDataPortMapping [SWS_DM_00585].
• ProcessMappingViolation : pour la référence d'instance, il n'existe aucun processus modélisé correspondant pour le processus d'exécution actuel [SWS_DM_00585].
• InstanceSpecifierAlreadyInUseViolation : le constructeur a été appelé avec un instanceSpec qui est déjà utilisé dans le processus actuel [SWS_DM_00585].

Interprétation : la fonction étant déclarée comme noexcept, les violations constatées devraient être traitées de manière interne au framework comme des erreurs critiques d'initialisation. Question Q-8616025446bf33f2 (ouverte)

concurrence

La fonction constructeur elle-même est exécutée de manière sûre du point de vue des threads [SWS_DM_00585]. L'argument concurrencyType permet de contrôler si des appels d'interface en aval de l'instance peuvent avoir lieu de manière concurrente [SWS_DM_00585].

Utilisation et contexte d'appel

La méthode synchrone Offer() permet au Diagnostic Management (DM) de transférer les requêtes de diagnostic entrantes à l'instance correspondante de <DataIdentifierInterface> ([SWS_DM_00599]). La fonction ne prend aucun paramètre d'entrée et est spécifiée comme noexcept ([SWS_DM_00599]). Interprétation : l'appel devrait typiquement avoir lieu pendant la phase d'initialisation de l'application, étant donné que le DM ne peut délivrer aucune requête avant la mise à disposition. Question Q-4ba81ff234a09f46 (ouverte)

Gestion des erreurs et valeurs de retour

ara::core::Result<void> sert de valeur de retour ([SWS_DM_00599]). Si l'enregistrement a réussi, le résultat ne contient aucune valeur. Si le gestionnaire a déjà été mis à disposition auparavant, l'appel échoue et renvoie le code d'erreur DiagOfferErrc::kAlreadyOffered avec une sémantique de retour arrière ([SWS_DM_00599] ; voir [SWS_DM_00514]).

Concurrence et restrictions

La fonction garantit la sécurité vis-à-vis des exceptions (exception safe), mais est expressément spécifiée comme non sûre pour les threads (not thread-safe) ([SWS_DM_00599]). Les appels parallèles sur la même instance doivent être synchronisés par l'application.

Interaction

Le patron de mise à disposition correspond à l'approche d'activation uniforme au sein du DM : des méthodes Offer() analogues existent pour les identifiants génériques ([SWS_DM_00638]), les éléments de données ([SWS_DM_00597]), les routines ([SWS_DM_00557], [SWS_DM_00594]) et les services DoIP ([SWS_DM_00725], [SWS_DM_00735]). Tant que Offer() n'a pas été exécuté, le DM ne transfère aucune requête au gestionnaire et répond avec des valeurs par défaut pour les services DoIP ([SWS_DM_01525], [SWS_DM_01527]).

Utilisation

La méthode Read sert à la fourniture de données d'un identifiant de données de diagnostic (DataIdentifier) dans le rôle de lecture d'un DiagnosticDataIdentifierInterface [SWS_DM_00640]. L'appel est effectué de manière asynchrone par le Diagnostic Manager (DM) lors de requêtes de diagnostic externes AUTOSAR_AP_SWS_Diagnostics p. 143 §7.3.2.6.1 « NRCs created by application ». Sont transmis comme paramètres metaInfo pour l'évaluation des propriétés de la requête ainsi qu'un cancellationHandler [SWS_DM_00640]. L'application de traitement peut interroger l'état d'annulation via cancellationHandler.IsCanceled() ou enregistrer, au moyen de cancellationHandler.SetNotifier(), un rappel pour le cas où la session serait prématurément interrompue [SWS_DM_00640]. Le résultat est renvoyé de manière asynchrone sous la forme d'un ara::core::Future contenant un objet ReadOutput [SWS_DM_00640], [SWS_DM_00579].

Gestion des erreurs

La fonction est spécifiée comme exception safe et ne doit propager aucune exception vers l'extérieur [SWS_DM_00640]. Si une erreur survient lors de la récupération des données, l'application renvoie dans le ara::core::Future une valeur de retour négative sous la forme d'un code d'erreur UDS approprié (NRC selon l'ISO 14229-1 via DiagUdsNrcErrc) ou d'un ApApplicationError [SWS_DM_00640], AUTOSAR_AP_SWS_Diagnostics p. 143 §7.3.2.6.1 « NRCs created by application ».

Concurrence et interaction

La fonction d'interface est not thread-safe par défaut [SWS_DM_00640]. Une exécution concurrente d'accès en lecture et en écriture par le Diagnostic Manager est régie par le type ara::diag::DataIdentifierConcurrencyType::readWrite, qui est préconfiguré par défaut sur kNotConcurrent [SWS_DM_00939]. Des opérations de lecture apparentées existent pour des éléments de données individuels via DiagnosticDataElementInterface [SWS_DM_00596] ainsi que pour des identifiants génériques [SWS_DM_00636].

La méthode StopOffer désinstalle le routage des requêtes de diagnostic entrantes du Diagnostic Management (DM) vers l'instance d'interface concrète [SWS_DM_00600]. Par cet appel, l'application adaptative signale qu'elle n'est temporairement ou définitivement plus prête à traiter des requêtes pour ce DataIdentifier.

Utilisation et sémantique

L'appel s'effectue de manière synchrone, est sans paramètre et ne renvoie aucune valeur de retour [SWS_DM_00600]. Le fichier d'interface généré #include "<DataIdentifierDirectoryPath>/<DataIdentifierShortname>.h" doit être inclus en tant qu'en-tête [SWS_DM_00600]. Le nommage suit le modèle connu de ara::com, mais constitue une interface autonome du domaine de diagnostic AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors ».

Gestion des erreurs et concurrence

• Sécurité vis-à-vis des exceptions : la fonction est déclarée avec noexcept et garantit une sécurité totale vis-à-vis des exceptions (exception safe) [SWS_DM_00600]. Aucune exception n'est levée.
• Sécurité des threads : l'opération est spécifiée comme not thread-safe [SWS_DM_00600]. L'appel doit s'effectuer de manière synchronisée afin qu'aucun accès parallèle à la même instance d'interface n'ait lieu.

Interaction

Le comportement correspond au modèle uniforme de désactivation du Diagnostic Management, tel qu'il est également défini de manière analogue pour des interfaces apparentées telles que les routines [SWS_DM_00558], les éléments de données génériques [SWS_DM_00639] ou les services de téléchargement [SWS_DM_00793]. Après une désactivation réussie, les requêtes entrantes du DM vers ce DataIdentifier ne sont plus transmises au gestionnaire d'application [SWS_DM_00600] ; le DM devrait ensuite générer des codes de réponse négatifs correspondants. Question Q-d301740d097f9946 (ouverte)

La fonction d'interface sert à la mise à disposition de type sûr d'un DataIdentifier (DID) en écriture dans le rôle Write [SWS_DM_00598]. Elle est appelée par l'instance du serveur de diagnostic lors de requêtes de diagnostic entrantes du service UDS 0x2E (WriteDataByIdentifier) [SWS_DM_00186], pour autant que le DID soit pris en charge dans le système et que les vérifications de la session de diagnostic active ainsi que du niveau de sécurité aient été passées avec succès [SWS_DM_00415] [SWS_DM_00416] [SWS_DM_00417]. À la différence de la variante générique avec un span d'octets bruts [SWS_DM_00637], la méthode lie des paramètres d'entrée typés spécifiques au modèle [SWS_DM_00598].

• Paramètres : en plus des arguments d'entrée générés, la méthode reçoit des méta-informations sur la requête via metaInfo ainsi qu'un cancellationHandler [SWS_DM_00598]. Via le gestionnaire d'annulation, l'application peut vérifier via IsCanceled si la conversation a été annulée ou enregistrer avec SetNotifier une notification pour le cas d'une annulation [SWS_DM_00598].
• Valeur de retour et traitement des erreurs : l'exécution s'effectue de manière asynchrone via ara::core::Future<void> [SWS_DM_00598]. En cas de succès, le futur fournit le type void. En cas d'erreur, un NRC UDS approprié selon l'ISO 14229-1 au moyen de ara::diag::DiagUdsNrcErrc ou un ApplicationError correspondant doit être renvoyé [SWS_DM_00598]. La fonction est déclarée comme sûre face aux exceptions (exception safe) [SWS_DM_00598].
• Concurrence : la méthode est classée comme non sûre pour les threads (not thread-safe) [SWS_DM_00598]. La possibilité ou non pour Diagnostic Management d'appeler en parallèle les accès en lecture et en écriture est contrôlée via l'élément de configuration readWrite dans DataIdentifierConcurrencyType [SWS_DM_00939].