classe ara::diag::SovdSwUpdate

La fonction purement virtuelle DeleteUpdatePackage de la classe ara::diag::SovdSwUpdate est appelée conformément à [SWS_DM_01803] par l’instance du Diagnostic Server lorsque la méthode SOVD « Delete Update Package from an SOVD Server » doit être exécutée ([SWS_DM_01922]). Elle déclenche la suppression côté serveur d’un paquet de mise à jour.

L’appel s’effectue de manière asynchrone et renvoie un ara::core::Future<void>, qui indique l’achèvement avec succès ou fournit un objet d’erreur [SWS_DM_01922]. La signature exige les paramètres d’entrée suivants :

• updatePackageId : désigne, en tant que ara::core::String, l’ID unique du paquet de mise à jour à supprimer.
• metaInfo : transmet, en tant que MetaInfo const&, des informations contextuelles supplémentaires de la requête.
• cancellationHandler : transmet un objet de type CancellationHandler qui informe si la conversation courante a été interrompue.

Si une erreur survient pendant le traitement, le Future est renseigné avec une erreur SOVD correspondante. La spécification impose à cet effet l’utilisation de codes d’erreur appropriés issus d’ASAM SOVD 1.1 ou d’ISO 17978-3 [SWS_DM_01922].

En ce qui concerne la concurrence, la méthode est définie comme conditionnellement thread-safe : le fait que l’implémentation doive être exécutée en mode thread-safe ou non-thread-safe est déterminé par le ConcurrencyType transmis dans le constructeur [SWS_DM_01922]. De plus, la fonction est déclarée comme noexcept et sans exception, raison pour laquelle aucune exception ne doit s’échapper.

Utilisation

La méthode pure virtual ExecuteUpdatePackage de l’interface ara::diag::SovdSwUpdate sert à exécuter la méthode SOVD « Execute Installation of an Update » [SWS_DM_01920]. La déclaration se trouve dans l’en-tête ara/diag/sovd_sw_update.h AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 « ExecuteUpdatePackage ». Comme paramètres d’entrée sont transmis l’identifiant du paquet de mise à jour (updatePackageId) ainsi que des données de requête (metaInfo) [SWS_DM_01920]. De plus, l’objet cancellationHandler signale si la conversation en cours a été interrompue [SWS_DM_01920]. L’appel s’effectue de manière asynchrone et renvoie un ara::core::Future<void>, qui fournit un résultat positif ou signale une erreur SOVD [SWS_DM_01920].

Gestion des erreurs

L’interface est spécifiée comme noexcept et sans émission d’exception (« exception safe ») [SWS_DM_01920]. Par conséquent, les erreurs survenant pendant l’exécution ne doivent pas être levées via des exceptions C++, mais doivent être renvoyées de manière asynchrone via le ara::core::Future avec des codes d’erreur applicables issus d’ASAM SOVD 1.1 ou d’ISO 17978-3 [SWS_DM_01920].

Concurrence et contraintes

Concernant la sécurité des threads, il existe une exigence conditionnelle (« conditional ») : le fait que la fonction doive être implémentée de manière thread-safe ou non-thread-safe est déterminé par le paramètre ConcurrencyType transmis au constructeur [SWS_DM_01920]. L’implémentation devrait devoir évaluer le cancellationHandler afin de terminer de façon ordonnée l’installation du paquet en cas d’interruption de la conversation [SWS_DM_01920]. Question Q-8fe6950e8f5a168c (ouverte)

La fonction membre ara::diag::SovdSwUpdate::Offer enregistre le gestionnaire de mises à jour logicielles SOVD auprès du Diagnostic Management (DM) afin de lui permettre de transférer les messages de requête entrants vers le gestionnaire [SWS_DM_01924]. L’appel s’effectue de manière synchrone et sans paramètre via l’en-tête ara/diag/sovd_sw_update.h et ne déclenche aucune exception C++ conformément à noexcept [SWS_DM_01924].

Le résultat de l’opération est renvoyé sous la forme d’un ara::core::Result<void> [SWS_DM_01924]. Si la mise à disposition échoue, la fonction renvoie une erreur avec une sémantique de rollback [SWS_DM_01924] :

• DiagOfferErrc::kAlreadyOffered : le service a déjà été proposé avec succès auparavant pour ce gestionnaire [SWS_DM_01924].
• DiagOfferErrc::kConfigurationMismatch : la configuration du moniteur ne correspond pas à la configuration DEXT [SWS_DM_01924].

En ce qui concerne la concurrence, la méthode est spécifiée comme exception safe, mais expressément comme non sécurisée pour les threads (not thread-safe) [SWS_DM_01924]. Interprétation : lors d’accès depuis plusieurs threads, une synchronisation externe côté application devrait donc être nécessaire. Question Q-4636ad27701d59df (ouverte) Le principe de mise à disposition via Offer correspond au schéma général des gestionnaires de diagnostic tels que [SWS_DM_00557] ou [SWS_DM_00735], pour lesquels le DM ne peut transférer de requêtes que dès lors que l’interface correspondante est activement proposée [SWS_DM_01525].

La méthode purement virtuelle PrepareUpdatePackage de l’interface ara::diag::SovdSwUpdate sert à préparer l’installation d’un paquet de mise à jour logicielle dans le cadre de la méthode SOVD « Prepare Installation of an Update » conformément à [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 « PrepareUpdatePackage »).

Appel et paramètres

La fonction est mise à disposition via l’en-tête ara/diag/sovd_sw_update.h et accepte les paramètres suivants :

• updatePackageId : identifiant (ara::core::String) du paquet de mise à jour à préparer.
• metaInfo : métadonnées (MetaInfo const&) relatives à la requête SOVD entrante.
• cancellationHandler : objet de surveillance (CancellationHandler) qui informe de l’interruption de la conversation courante.

L’appel est spécifié comme noexcept et adopte un comportement exception-safe. Le résultat asynchrone est fourni via un ara::core::Future<void>, qui signale soit l’achèvement avec succès, soit fournit une erreur [SWS_DM_01919].

Gestion des erreurs et concurrence

Si une erreur survient pendant la préparation, un code d’erreur approprié selon ASAM SOVD 1.1 ou ISO 17978-3 doit être renvoyé dans le Future [SWS_DM_01919]. En ce qui concerne la sécurité des threads, une exigence conditionnelle s’applique (conditional) : le fait que la fonction doive être implémentée de manière thread-safe est déterminé par le ConcurrencyType indiqué lors de l’instanciation dans le constructeur [SWS_DM_01919]. Via l’objet cancellationHandler, l’application devrait pouvoir interrompre les étapes de préparation prolongées si la requête se termine prématurément. Question Q-be4c53d9a0427ed5 (ouverte)

Utilisation

La méthode purement virtuelle PutUpdatePackageAutomated est appelée dans le contexte de la méthode SOVD « Automated Installation of an Update » [SWS_DM_01918]. Elle est déclarée dans l’en-tête ara/diag/sovd_sw_update.h au sein de la classe ara::diag::SovdSwUpdate AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 « PutUpdatePackageAutomated ». La fonction sert à installer de façon automatisée un paquet de mise à jour spécifié par son identifiant.

L’interface attend les paramètres d’entrée suivants :

• updatePackageId (ara::core::String) : identifiant du paquet de mise à jour à soumettre à l’installation automatisée [SWS_DM_01918].
• metaInfo (MetaInfo const &) : métadonnées de la demande de service entrante [SWS_DM_01918].
• cancellationHandler (CancellationHandler) : informe l’opération si la conversation en cours a été interrompue [SWS_DM_01918].

L’appel possède une sémantique asynchrone. La valeur de retour est un ara::core::Future<void> qui, après achèvement, indique soit une exécution réussie, soit un état d’erreur [SWS_DM_01918].

Gestion des erreurs et concurrence

En cas d’erreur, un code d’erreur applicable issu d’ASAM SOVD 1.1 ou d’ISO 17978-3 doit être renvoyé via le future [SWS_DM_01918]. La méthode est spécifiée comme sans émission d’exception (exception safe) et ne lève aucune exception C++ en tant que fonction noexcept AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 « PutUpdatePackageAutomated ».

La sécurité des threads de la méthode est conditionnelle (conditional) : le fait que l’implémentation doive être exécutée en mode thread-safe ou non-thread-safe est déterminé par le ConcurrencyType transmis lors de l’appel du constructeur [SWS_DM_01918].

La fonction purement virtuelle RequestUpdatePackageRegistration de la classe ara::diag::SovdSwUpdate prend en charge la méthode SOVD « Register an Update at the SOVD Server » [SWS_DM_01923]. Elle amorce l’enregistrement d’un paquet de mise à jour sur le serveur et initialise la session de transfert associée AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 « RequestUpdatePackageRegistration ».

L’appel s’effectue de manière asynchrone et renvoie un ara::core::Future qui, en cas de succès, contient un tuple composé d’une DataTransferWriteSession et d’une ara::core::String contenant l’ID du paquet de mise à jour [SWS_DM_01923]. Lors de l’appel, les paramètres suivants sont transmis :

• metaInfo : métadonnées de la requête entrante.
• expectedSize : taille totale attendue facultative du paquet (ara::core::Optional<uint64_t>), pour autant qu’elle soit déclarée dans la requête.
• cancellationHandler : signale si la conversation courante est interrompue.

La méthode est définie comme noexcept et sans émission d’exception [SWS_DM_01923]. Les erreurs ne sont donc pas signalées par des exceptions C++, mais sont mises à disposition de manière asynchrone via le future ; les codes d’erreur correspondants issus d’ASAM SOVD 1.1 ou d’ISO 17978-3 doivent être utilisés à cet effet [SWS_DM_01923].

La sécurité des threads est conditionnelle (« conditional ») : le fait que la méthode doive être implémentée de manière thread-safe est déterminé par le ConcurrencyType spécifié dans le constructeur [SWS_DM_01923]. Selon l’instanciation, l’implémentation concrète devrait donc nécessiter ses propres mécanismes de synchronisation. Question Q-7e80e557bdd7627a (ouverte)

Utilisation

La méthode ara::diag::SovdSwUpdate::StopOffer met fin à l’offre du service et désactive le transfert des messages de requête entrants du Diagnostic Management (DM) vers le composant de mise à jour logicielle [SWS_DM_01925]. L’appel s’effectue via l’interface de ara/diag/sovd_sw_update.h, ne prend aucun paramètre et ne renvoie aucune valeur [SWS_DM_01925]. L’arrêt de la mise à disposition du service s’effectue de manière synchrone et correspond à la désactivation conceptuelle des fonctionnalités de diagnostic dans AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors ».

Gestion des erreurs et concurrence

La fonction possède la spécification noexcept et est ainsi sans émission d’exception ; aucun état d’erreur sous forme d’exceptions ou de codes d’erreur n’est prévu [SWS_DM_01925]. Pour le contexte d’appel, la fonction est définie comme non sécurisée pour les threads (« not thread-safe ») [SWS_DM_01925]. Les appels parallèles sur la même instance doivent être synchronisés côté application. Interprétation : un appel répété de StopOffer dans un état déjà inactif devrait rester sans effet d’erreur, étant donné qu’aucun traitement d’erreur n’existe. Question Q-efaccde5507eb444 (ouverte)

Interaction

Dans le système global, la fonction s’intègre dans le schéma uniforme du cycle de vie des services du DM. Elle constitue le pendant fonctionnel de la mise à disposition du service et se comporte de manière analogue aux opérations de désactivation d’autres services de diagnostic tels que ara::diag::DownloadService [SWS_DM_00793], ara::diag::GenericUDSService [SWS_DM_00620] ainsi que ara::diag::EcuResetRequest [SWS_DM_01017].