classe ara::diag::SovdConfiguration

Utilisation

La méthode Offer de la classe ara::diag::SovdConfiguration sert à activer le transfert des requêtes de diagnostic par le Diagnostic Management (DM) vers le gestionnaire configuré [SWS_DM_01872]. L’appel s’effectue de manière synchrone, ne prend aucun paramètre et renvoie le résultat via ara::core::Result<void> [SWS_DM_01872]. Tant qu’un gestionnaire n’a pas été mis à disposition via Offer, le DM ne transfère aucune requête entrante, ce qui correspond au schéma fondamental de mise à disposition des interfaces de diagnostic (cf. [SWS_DM_01525], [SWS_DM_00809]).

Gestion des erreurs

En cas d’erreur, un ara::core::Result avec un code d’erreur de l’énumération DiagOfferErrc est renvoyé, avec application d’une sémantique de rollback [SWS_DM_01872] :

• DiagOfferErrc::kAlreadyOffered : signalé lorsque le service a déjà été proposé précédemment [SWS_DM_01872].
• DiagOfferErrc::kConfigurationMismatch : survient lorsque la configuration ne correspond pas aux données de description DEXT [SWS_DM_01872].

Concurrence et restrictions

L’opération est déclarée comme noexcept et sans émission d’exception (exception safe), mais elle est spécifiée comme non sécurisée pour les threads (not thread-safe) [SWS_DM_01872]. Les appels simultanés de la même instance depuis plusieurs threads doivent être évités par l’application appelante. Un nouvel appel après une mise à disposition déjà effectuée devrait probablement être acquitté par une erreur, sans changement d’état. Question Q-f9b1a995dbb002ef (ouverte)

Utilisation

La méthode virtuelle pure RequestGetConfiguration de la classe ara::diag::SovdConfiguration est appelée par la Diagnostic Server Instance lorsque la méthode SOVD « Read Configuration » est exécutée pour une configuration SOVD explicitement modélisée ([SWS_DM_01787], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 « Configuration – Explicit Configurations »). Sont passés comme paramètres l'ID de configuration de l'instance à lire (configurationId), les métadonnées de la requête (metaInfo) ainsi qu'un cancellationHandler qui informe d'une éventuelle interruption de la conversation en cours ([SWS_DM_01870]).

La fonction fonctionne de manière asynchrone et renvoie un ara::core::Future qui met à disposition un tuple constitué d'une session de lecture de fichiers (DataTransferReadSession) et de métadonnées de configuration associées (SovdConfigurationMetaInfo) ([SWS_DM_01870]). L'interface est déclarée comme noexcept et spécifiée comme sûre face aux exceptions ([SWS_DM_01870]).

Gestion des erreurs et concurrence

Si une erreur survient lors du traitement, aucune erreur C++ n'est levée, mais un code d'erreur SOVD pertinent selon ISO 17978-3 ou ASAM SOVD 1.1 est renvoyé via le Future ([SWS_DM_01870]).

En ce qui concerne la sécurité vis-à-vis des threads, la spécification « conditional » s'applique : le fait que l'implémentation concrète de la fonction doive être conçue pour être thread-safe ou non thread-safe est décidé par le ConcurrencyType transmis au constructeur ([SWS_DM_01870]).

La méthode d'API ara::diag::SovdConfiguration::RequestPutConfiguration est appelée par le Diagnostic Server lorsque la méthode « Write Configuration » doit être exécutée via l'interface SOVD pour une configuration explicitement modélisée [SWS_DM_01788], [SWS_DM_01871].

Appel et paramètres

La déclaration se trouve dans l’en-tête ara/diag/sovd_configuration.h. L’appel transmet les paramètres d’entrée suivants [SWS_DM_01871] :

• configurationId : ID de l’instance de configuration à écrire sous forme de ara::core::String.
• metaInfo : métadonnées relatives à la requête entrante (MetaInfo const &).
• cancellationHandler : surveille l’opération en cours et signale si la communication a été interrompue.

La méthode possède une sémantique asynchrone et renvoie un ara::core::Future qui, en cas de succès, met à disposition un tuple constitué d’une session d’écriture (DataTransferWriteSession) ainsi que des métadonnées associées (SovdConfigurationMetaInfo) [SWS_DM_01871].

Gestion des erreurs et concurrence

En cas d’erreur, le Future est résolu avec un code d’erreur SOVD approprié selon ISO 17978-3 ou ASAM SOVD 1.1 [SWS_DM_01871]. La fonction est déclarée comme noexcept et sans émission d’exception (exception safe). La sécurité des threads est conditionnelle (conditional) : le fait que l’implémentation concrète doive ou non être conçue de manière thread-safe est déterminé par le ConcurrencyType spécifié dans le constructeur [SWS_DM_01871].

Interaction

La fonction constitue le pendant en écriture de RequestGetConfiguration, qui est utilisée pour la méthode SOVD « Read Configuration » [SWS_DM_01787] (AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 « Configuration – Explicit Configurations »).

La méthode StopOffer() de la classe ara::diag::SovdConfiguration sert à désactiver le transfert des requêtes (Request Messages) vers l'instance de service par le démon Diagnostic Management (DM) [SWS_DM_01930]. Elle constitue le pendant de la mise à disposition du service et suit le modèle de cycle de vie uniforme des interfaces de diagnostic dans AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors ».

Utilisation et signature : L'appel s'effectue sans paramètre et de manière synchrone via l'en-tête ara/diag/sovd_configuration.h [SWS_DM_01930]. Comme la méthode ne renvoie aucune valeur de retour (void) et qu'elle est déclarée comme noexcept, elle est considérée comme sûre du point de vue des exceptions (exception safe) [SWS_DM_01930]. Ni codes d'erreur ni exceptions ne sont transmis à l'appelant.

Concurrence et restrictions : La fonction est explicitement spécifiée comme non sûre pour les threads (not thread-safe) [SWS_DM_01930]. Si des instances de ara::diag::SovdConfiguration sont utilisées dans des environnements multithreads, les accès simultanés ou les changements de l'état de mise à disposition doivent être synchronisés par l'Adaptive Application.

Interaction : Le comportement correspond à la sémantique de désactivation d'autres services DM tels que ara::diag::CommunicationControl [SWS_DM_00810] ou ara::diag::GenericRoutine [SWS_DM_00558]. Interprétation : après l'appel de StopOffer(), les requêtes de diagnostic reçues par le DM devraient être rejetées ou recevoir une réponse négative, jusqu'à ce que la configuration soit à nouveau activée via une méthode d'offre correspondante. Question Q-4c6212980015c119 (ouverte)