Permet la lecture de fichiers complets ou de répertoires via des zones de mémoire partagée lors de requêtes de diagnostic.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 4c654c39d186ProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
Permet la lecture de fichiers complets ou de répertoires via des zones de mémoire partagée lors de requêtes de diagnostic.
La classe ara::diag::DataTransferReadSharedDataHandler sert au traitement des transferts de données de diagnostic en lecture pour des contenus de fichiers et de répertoires via la mémoire partagée ([SWS_DM_01497]). Après le démarrage de la session, l'implémentation applicative met l'ensemble des données à disposition sous la forme d'une vue de données partagées (Shared Data View) via Read() et maintient le tampon alloué jusqu'à la notification de libération par le ReleaseHandler ([SWS_DM_01504]). Avant la destruction de l'objet propre au handler, la session de transfert doit obligatoirement être close via ExitRead(). L'objet est exclusivement destiné à une seule session de transfert et peut donc être déplacé, mais non copié.
Contexte
La classe ara::diag::DataTransferReadSharedDataHandler appartient au domaine du diagnostic d'AUTOSAR Adaptive Platform dans le module diag (AUTOSAR_AP_SWS_Diagnostics §8.10.5 « Class: DataTransferReadSharedDataHandler »). Sa tâche principale consiste en l'exécution de transferts de données pour des contenus de fichiers et de répertoires déclenchés par des requêtes UDS telles que RequestReadFile ou RequestReadDirectory ([SWS_DM_01497]). Au lieu d'étapes de copie distinctes pour chaque bloc de transfert, ce handler permet à l'implémentation spécifique de l'application de fournir l'ensemble des données sous la forme d'une zone de mémoire partagée contiguë.
Dans le déroulement global du système, trois acteurs principaux coopèrent : le client UDS externe envoie la requête de lecture au calculateur. L'environnement d'exécution de diagnostic AraDiag reçoit la requête et transmet l'exécution à l'implémentation concrète de DataTransferReadSharedDataHandler ([SWS_DM_01497], [SWS_DM_01504]). Un troisième partenaire, le ReleaseHandler, signale à l'application dès que les ressources de mémoire partagée ne sont plus requises par la plateforme et peuvent être libérées ([SWS_DM_01504]).
Diagramme de contexte : interaction entre le client UDS, l'environnement d'exécution AraDiag et l'implémentation du handler côté application. Sources : [SWS_DM_01497], [SWS_DM_01504], [SWS_DM_01505]
Il existe une précondition stricte pour la destruction de l'objet : une instance de cette classe ne doit en aucun cas être détruite avant que la session de transfert n'ait été formellement terminée par l'appel de ExitRead() ([SWS_DM_01499], AUTOSAR_AP_SWS_Diagnostics §8.10.5.1.1.3 « Destructor »). Ce n'est qu'après l'accomplissement de ce traitement de clôture que le destructeur virtuel a le droit de s'exécuter ([SWS_DM_01499]).
En matière de concurrence, les méthodes centrales Read() et ExitRead() sont désignées comme non thread-safe (not thread-safe), tandis que l'ensemble des fonctions de l'interface garantissent la sécurité vis-à-vis des exceptions (exception safe) ([SWS_DM_01498], [SWS_DM_01504], [SWS_DM_01505]).
Parcours d'utilisation
La séquence d'appels typique d'un transfert de données avec des zones de mémoire partagée comprend plusieurs étapes :
Mise à disposition des données partagées (Shared Data) :AraDiag appelle la méthode purement virtuelle Read() et transmet un ReleaseHandler, MetaInfo ainsi qu'un CancellationHandler ([SWS_DM_01504]). L'application alloue l'intégralité du contenu du fichier ou du répertoire et renvoie la vue partagée correspondante en tant que ara::core::Span<ara::core::Byte> via un ara::core::Future à AraDiag ([SWS_DM_01504]).
Maintien en mémoire et libération : l'application doit impérativement conserver la mémoire allouée intacte jusqu'à ce que le ReleaseHandler signale que la zone de mémoire peut être libérée en toute sécurité ([SWS_DM_01504]). Pour ce faire, l'application peut enregistrer une fonction de notification (notifier) auprès du ReleaseHandler ou interroger activement son état ([SWS_DM_01504]). Interprétation : la signalisation via le ReleaseHandler intervient vraisemblablement de façon asynchrone par AraDiag dès que les blocs de données ont été transmis avec succès au client UDS. Question Q-0fbc1c5e667c9a68 (ouverte)
Clôture de session : pour terminer le transfert, AraDiag appelle la méthode ExitRead() ([SWS_DM_01505], AUTOSAR_AP_SWS_Diagnostics §8.10.5.1.3.1 « ExitRead »). Outre le motif de fin (DataTransferExitType), des paramètres de requête spécifiques au constructeur du véhicule sont transmis, leur durée de vie étant garantie jusqu'à la résolution de la promesse de résultat ([SWS_DM_01505]). L'application renvoie les données de réponse via un ara::core::Future<ara::core::Vector<ara::core::Byte>> ([SWS_DM_01505]).
Destruction de l'objet : après l'appel réussi de ExitRead(), l'instance de handler peut être libérée et détruite ([SWS_DM_01499]).
Diagramme de séquence : séquence des étapes, de la mise à disposition des données via Read() en passant par la libération de la mémoire jusqu'à la clôture via ExitRead(). Sources : [SWS_DM_01499], [SWS_DM_01504], [SWS_DM_01505]
Scénarios d'erreur
Si des erreurs se produisent lors de la mise à disposition des données ou lors de la fin du transfert, elles sont signalées via le ara::core::Future respectif avec un ara::core::ErrorCode issu du domaine DiagUdsNrcErrc conformément à l'ISO 14229-1 ([SWS_DM_01504], [SWS_DM_01505]).
L'interruption d'une conversation de diagnostic en cours constitue un autre scénario. Les deux méthodes reçoivent un CancellationHandler ([SWS_DM_01504], [SWS_DM_01505]). L'application peut vérifier de manière synchrone l'état d'annulation via cancellation_handler.IsCanceled() ou définir une fonction de notification via cancellation_handler.SetNotifier() afin de réagir immédiatement en cas d'interruption prématurée ([SWS_DM_01504], [SWS_DM_01505]).
Une violation de la précondition relative au destructeur – si l'objet est détruit avant que ExitRead() n'ait été appelé – contredit l'exigence [SWS_DM_01499] et conduit à des états de programme défectueux.
Ce guide de classe est basé sur la spécification AUTOSAR Adaptive Platform Release R25-11.
Provides the whole data to be read out from the application in form of a shared data view. The whole file/directory info content to be sent back to the UDS client will be allocated by the application and its shared ownership (view over the memory location) is passed as a result to AraDiag. The allocated memory must be kept until the ReleaseHandler’s notifier is invoked or the status polled, signalling that the memory, addressed by the Span now can safely be released.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 8bcba929adb6Provenance
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
L'interface ExitRead de la classe ara::diag::DataTransferReadSharedDataHandler ([SWS_DM_01505] ; en-tête ara/diag/data_transfer.h) met fin à une session de transfert de données en cours.
exit_type (DataTransferExitType) : spécifie le motif de l'interruption de la session.
transfer_request_parameter_record (ara::core::Span<const ara::core::Byte>) : contient des paramètres spécifiques au constructeur pour assister le transfert. Les données restent valides jusqu'à ce que la promise associée soit satisfaite ou que le traitement soit interrompu.
meta_info (MetaInfo const&) : contient des métadonnées supplémentaires de la requête de diagnostic.
cancellation_handler (CancellationHandler) : permet la vérification de l'état d'annulation au moyen de cancellation_handler.IsCanceled() ainsi que l'enregistrement d'une fonction de notification via cancellation_handler.SetNotifier(), qui est appelée en cas d'annulation de la conversation.
Gestion des erreurs et valeurs de retour
En cas de conclusion avec succès, le Future fournit les données de sortie (transferResponseParameterRecord), lesquelles sont placées derrière le SID dans la réponse positive [SWS_DM_01505]. En cas d'erreur, le Future est satisfait avec un code d'erreur issu de DiagUdsNrcErrc (NRC applicable selon l'ISO 14229-1) [SWS_DM_01505].
Concurrence et cycle de vie
La méthode est déclarée comme noexcept (exception safe), mais explicitement spécifiée comme not thread-safe[SWS_DM_01505]. Concernant le cycle de vie de l'objet, la règle stipule qu'une instance de DataTransferReadSharedDataHandler ne doit en aucun cas être détruite avant que ExitRead() n'ait été appelée ([SWS_DM_01499]). Des fonctions de terminaison et des exigences de destructeur analogues existent pour les classes apparentées DataTransferReadByPullHandler ([SWS_DM_01514]) et DataTransferReadByPushHandler ([SWS_DM_01523]).
Cette note d'utilisation a été rédigée par une IA et se fonde sur les spécifications de l'AUTOSAR Adaptive Platform.
This parameter record contains parameter(s), which are required
parameter_record
by the server to support the transfer of data. Format and length of this parameter(s) are vehicle manufacturer specific. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
meta_info
contains additional meta information of the request.
cancellation_handler
This parameter is used to • Query the current cancellation status by calling cancellation_ handler.IsCanceled(). Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellation_handler.Set Notifier(). The registered notifier is called if the current conversation is cancelled.
Returns a Future, which either gets readied to OperationOutput (transferResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message). Data in OperationOutput.response_data will be placed after SID as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
Provides the whole data to be read out from the application in form of a shared data view. The whole file/directory info content to be sent back to the UDS client will be allocated by the application and its shared ownership (view over the memory location) is passed as a result to AraDiag. The allocated memory must be kept until the ReleaseHandler’s notifier is invoked or the status polled, signalling that the memory, addressed by the Span now can safely be released.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : cba844c9db1eProvenance
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
La méthode Read de l'interface ara::diag::DataTransferReadSharedDataHandler met à disposition du client UDS des données de fichier ou de répertoire à lire via une vue de mémoire partagée ([SWS_DM_01504]). L'appel s'effectue de manière asynchrone et renvoie un ara::core::Future avec un ara::core::Span<ara::core::Byte> ([SWS_DM_01504]).
Utilisation et cycle de vie
L'application d'implémentation alloue elle-même la totalité du contenu et transmet la vue à AraDiag. La zone mémoire sous-jacente doit obligatoirement être conservée inchangée jusqu'à ce que la libération via le ReleaseHandler transmis ait été signalée par son notificateur ou interrogée par contrôle d'état ([SWS_DM_01504]). Le ReleaseHandler doit être enregistré pour le même client UDS à l'aide du MetaInfo ([SWS_DM_01504]). Via le CancellationHandler, un transfert en cours peut être surveillé par IsCanceled() ou un notificateur d'interruption peut être enregistré par SetNotifier() ([SWS_DM_01504]).
Gestion des erreurs et concurrence
En cas de succès, les données sont envoyées sous forme de transferResponseParameterRecord après le blockSequenceCounter ([SWS_DM_01504]). Si la lecture échoue, le Future doit être complété avec un code d'erreur approprié issu de DiagUdsNrcErrc conformément à l'ISO 14229-1 ([SWS_DM_01504]). Si l'interface de l'application n'a pas encore été mise à disposition ou ne l'est plus via offer(), le serveur signale le NRC 0x94 (ResourceTemporarilyNotAvailable) ([SWS_DM_01257]). La fonction est spécifiée comme noexcept et sûre vis-à-vis des exceptions, mais elle est considérée comme non sûre pour les threads (not thread-safe) ([SWS_DM_01504]).
Délimitation
Contrairement à DataTransferReadByPullHandler::Read, où des blocs de données sont copiés dans un tampon prédéfini ([SWS_DM_01513]), ou à DataTransferReadByPushHandler::Read, qui fournit des vecteurs par transfert de propriété ([SWS_DM_01522]), ce gestionnaire transmet l'intégralité du contenu sans copie de tampon via de la mémoire partagée ([SWS_DM_01504]).
Cette note d'utilisation a été générée automatiquement sur la base du standard AUTOSAR.
The release shared resource handler to be stored and used by the application until a new one is passed for the same meta_info (UDS client).
meta_info
Contains additional meta information.
cancellation_handler
This parameter is used to • Query the current cancellation status by calling cancellation_ handler.IsCanceled(). Returns true in case, the current conversation has been cancelled and false otherwise. • Register a notifier function by calling cancellation_handler.Set Notifier(). The registered notifier is called if the current conversation is cancelled.
Returns a Future, which either gets readied to ReadSharedOutput (transferResponseParameterRecord for a positive response message) or readied with ErrorCode from DiagUdsNrcErrc (for an negative response message). Data in ReleaseSharedHandler.responseData will be placed after the blockSequenceCounter as transferResponseParameterRecord in the positive response.
Fehler
Fehlercode
Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · Original allemand