Sert de classe de base abstraite pour les plugins de transport UDS pour la transmission et le routage de messages de diagnostic.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 8b34a053e223ProvenanceQuestions ouvertes (2)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
Sert de classe de base abstraite pour les plugins de transport UDS pour la transmission et le routage de messages de diagnostic.
La classe abstraite sert d’interface de base pour les plugins de transport UDS pour le raccordement standardisé au Diagnostic Management adaptatif (AUTOSAR_AP_SWS_Diagnostics §7.1.1 « Support of UDS Transport Layer »). Une implémentation dérivée transmet les messages de diagnostic reçus au gestionnaire de protocole et envoie les messages de réponse générés au testeur de diagnostic via des canaux spécifiques au réseau. Le cycle de vie est soumis à un enchaînement strict comprenant création, initialisation séparée, démarrage asynchrone et arrêt ordonné ([SWS_DM_00329]). Après l’instanciation, les appels de méthodes opérationnels ne sont pas thread-safe et nécessitent un pilotage coordonné par le cœur de diagnostic.
Contexte
La classe apext::diag::uds_transport::UdsTransportProtocolHandler est une classe de base abstraite au sein du module diag de l’AUTOSAR Adaptive Platform. Elle définit l’interface standardisée par laquelle les plugins de transport UDS propriétaires ou spécifiques à un protocole sont raccordés au Diagnostic Management (DM) adaptatif (AUTOSAR_AP_SWS_Diagnostics §7.1.1 « Support of UDS Transport Layer », [SWS_DM_00315]). Chaque protocole de transport concret – par exemple pour le diagnostic sur des supports réseau automobiles – implémente cette interface en tant que sous-classe dérivée. Le DM devrait posséder et gérer de manière exclusive l’instance de gestionnaire respective sur l’ensemble de son cycle de vie opérationnel. L’interaction entre le cœur de diagnostic et le plugin s’effectue via la référence transportprotocolManager du type UdsTransportProtocolMgr&, transmise au constructeur et stockée de manière protégée ([SWS_DM_09015], [SWS_DM_09025]). Chaque gestionnaire est identifié par un UdsTransportProtocolHandlerID numérique qui peut être interrogé via GetHandlerID() ([SWS_DM_00325]). Question Q-ef308265bfdf6cec (ouverte)
Cycle de vie
Le cycle de vie d’un gestionnaire de protocole de transport UDS est piloté de manière strictement séquentielle par le DM ([SWS_DM_00329]). Après l’instanciation via le constructeur UdsTransportProtocolHandler ([SWS_DM_09015]), la méthode Initialize() sépare l’initialisation proprement dite du protocole de la création de l’objet ([SWS_DM_00319]). À l’exception d’une interrogation optionnelle via GetPeriodicHandler(), le DM ne doit appeler aucune méthode sur le gestionnaire avant le retour réussi de InitializationResult::kInitializeOk ([SWS_DM_01746], [SWS_DM_09017]). Après une initialisation réussie, l’appel de Start() fait passer le gestionnaire à l’état de traitement actif ([SWS_DM_00322]). Afin de minimiser le temps de démarrage, Start() est conçu comme une opération asynchrone ; le DM devrait coordonner en interne le démarrage parallèle de plusieurs gestionnaires. Question Q-66e5a53d55e6d812 (ouverte) Si le DM passe à l’état ApplicationState.kTerminating lors de l’arrêt, il ordonne au gestionnaire de se terminer via Stop() ([SWS_DM_00323], [SWS_DM_00333]). Le DM attend l’achèvement, que le gestionnaire confirme par l’appel de UdsTransportProtocolMgr::HandlerStopped() ([SWS_DM_00340]). Après le retour de Stop(), tout appel de méthode du plugin vers le gestionnaire autre que HandlerStopped() est interdit ([SWS_DM_01741]). La libération des ressources s’effectue enfin via le destructeur virtuel ([SWS_DM_09016]). Alors que le constructeur est thread-safe, les méthodes d’interface opérationnelles sont déclarées non thread-safe.
En fonctionnement de diagnostic régulier, le gestionnaire traite les messages entrants et transmet les réponses. Dès que l’interface réseau dispose au minimum de l’adresse source, de l’adresse de destination, du type d’adresse (physique ou fonctionnel), de la longueur totale du message et, pour les données utiles de plusieurs octets, des deux premiers octets (payloadInfo), l’implémentation signale la requête au gestionnaire via UdsTransportProtocolMgr::IndicateMessage() ([SWS_DM_00342], AUTOSAR_AP_SWS_Diagnostics §7.1.1.3 « UDS message transmission on a UDS TransportLayer »). Chaque requête est affectée à un canal unique (AUTOSAR_AP_SWS_Diagnostics §7.1.1.4 « Channel Notifications »). Pour répondre, le DM transmet la réponse de diagnostic au même gestionnaire et canal au moyen de Transmit(message, channelId) ([SWS_DM_00327], [SWS_DM_00348]). Après la transmission physique, le gestionnaire restitue l’objet de message transmis au gestionnaire via UdsTransportProtocolMgr::TransmitConfirmation() ([SWS_DM_00327], [SWS_DM_00351]). Un chemin d’utilisation spécialisé concerne les réinitialisations de calculateurs (service UDS 0x11) avec réponse positive après le redémarrage : ici, le DM demande avant la réinitialisation, via NotifyReestablishment(channelId), que le gestionnaire sauvegarde les informations de connexion de manière non volatile ; après le redémarrage et un nouveau Start(), le gestionnaire signale le rétablissement du même canal via ChannelReestablished() ([SWS_DM_00326], [SWS_DM_01744]).
Si l’initialisation de la couche de transport échoue et que Initialize() renvoie l’état InitializationResult::kInitializeFailed, le DM interrompt immédiatement le processus de démarrage de ce protocole et n’appelle plus aucune méthode sur cette instance ([SWS_DM_01745], [SWS_DM_09017]). Si les transmissions périodiques ne sont pas prises en charge sur le protocole de transport, l’appel de GetPeriodicHandler() fournit un ara::core::Result avec le code d’erreur kConfigurationMismatch ([SWS_DM_01068]). Si un rétablissement de canal demandé pour une réinitialisation de calculateur (ECU) ne peut pas être garanti, NotifyReestablishment() échoue et le signale par la valeur de retour false ([SWS_DM_00326]). Si enfin l’opération d’émission d’une réponse de diagnostic échoue sur la couche réseau, le gestionnaire doit l’indiquer lors de la confirmation au gestionnaire en positionnant l’argument result dans TransmitConfirmation() sur kTransmitFailed ([SWS_DM_00351]).
Ce guide a été généré automatiquement sur la base de la spécification AUTOSAR R25-11.
Initializes UDS Transport Protocol handler. This methods needs to be called before a call of Start(). It is meant to separate the actual initialization of the UDS Transport Protocol handler from the constructor.
Tells the UdsTransportProtocolHandler, to notify the DM core via UdsTransportProtocol Mgr::ChannelReestablished() if the given channel has been re-established after next Uds TransportProtocolHandler::Start(). The main purpose of this method is to allow the DM to provide an ECU-Reset (0x11 service), with configuration option "positive response AFTER reset". In this scenario, the request for 0x11 will be received on a certain channel (GlobalChannel Identifier), then the ECU-Reset takes place and after ECU-Restart, all UdsProtocol Handlers/-plugins get restarted via call to UdsTransportProtocolHandler::Start().
Start processing the UDS Transport Protocol. Within the implementation there might be some stack specific implementation. The method is asynchronous to allow the DM to start multiple UdsTransportProtocolHandler in parallel to reduce startup time.
Method to indicate that this UdsTransportProtocolHandler should terminate. If UdsTransportProtocolHandler has stopped, it shall call UdsTransportProtocolMgr:: HandlerStopped(UdsTransportProtocolHandlerID).
If periodic transmissions are supported on this transport protocol, a reference to UdsTransportProtocolPeriodicHandler is returned, and if not supported, an error (kConfigurationMismatch).
Fehler
Fehlercode
Beschreibung
kConfigurationMismatch
Request a governed re-review of this record. The record is not changed immediately.
Initializes UDS Transport Protocol handler. This methods needs to be called before a call of Start(). It is meant to separate the actual initialization of the UDS Transport Protocol handler from the constructor.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 2d1a514affd8ProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
La méthode purement virtuelle Initialize sert à l'initialisation explicite d'une instance de apext::diag::uds_transport::UdsTransportProtocolHandler et sépare formellement cette opération de la construction de l'objet [SWS_DM_00319]. Elle est appelée de manière synchrone et sans paramètre par le Diagnostic Manager (DM), ne lève aucune exception (noexcept) et renvoie un InitializationResult[SWS_DM_00319][SWS_DM_09017].
La méthode signale le résultat via l'énumérateur InitializationResult::kInitializeOk ou InitializationResult::kInitializeFailed[SWS_DM_09017]. Le comportement ultérieur du DM dépend directement de la valeur de retour :
En cas de retour réussi avec kInitializeOk, le DM est autorisé à appeler les méthodes suivantes du handler ; avant cette valeur de retour réussie, aucun autre appel de méthode n'est permis, à l'exception de GetPeriodicHandler[SWS_DM_01746].
Si le handler renvoie kInitializeFailed, le DM interrompt complètement le processus d'initialisation de ce protocole de transport et n'appelle plus aucune autre méthode sur l'instance concernée [SWS_DM_01745].
Ce texte a été généré par une IA sur la base d'AUTOSAR R25-11.
Tells the UdsTransportProtocolHandler, to notify the DM core via UdsTransportProtocol Mgr::ChannelReestablished() if the given channel has been re-established after next Uds TransportProtocolHandler::Start(). The main purpose of this method is to allow the DM to provide an ECU-Reset (0x11 service), with configuration option "positive response AFTER reset". In this scenario, the request for 0x11 will be received on a certain channel (GlobalChannel Identifier), then the ECU-Reset takes place and after ECU-Restart, all UdsProtocol Handlers/-plugins get restarted via call to UdsTransportProtocolHandler::Start().
Now there are two expectations, when this method has been called before and returned "TRUE": If the same remote client connects to the UdsProtocolHandler, it shall get a channel identification with the same identifying as the last time. It consecutively calls UdsTransportProtocolMgr::ChannelReestablished(Global ChannelIdentifier).
The detection/decision, whether the "same" client reconnects as before is an UdsProtocol Handler implementation specific decision.
The general expectation is:
If the channel is set up from exactly the same remote network-endpoint, it typically gets the same ChannelID. To support this functionality, the implementation at least has to store non-volatile, that this notification has to be done. Further it might be needed to store some additional connection specific info non-volatile to make sure, that the same ChannelID can be reassigned. This is the case if the mapping of protocol specific channel info -> channelID isn’t a
stable bijective mapping!
Small example:
The underlying network protocol, which UdsProtocolHandler implements is based on TCP. At the point in time, where the 0x11 Service Identifier request is received on channel identified by the DM calls UdsTransportProtocolHandler::NotifyReestablishment() on this ChannelID.
Now the implementation of UdsProtocolHandler stores non-volatile in the context of this call:
• NetworkEndpoint (IP-address and port number) of the channel. • NetworkEndpoint (IP-address and port number) of the local port (because in this example, the UdsTransportProtocolHandler listens on/supports different ports). • ChannelID it has currently assigned. After restart this ChannelID is only reused for a channel with exactly the same Network Endpoint addresses as stored non-volatile.
If this ChannelID then gets reassigned, then UdsTransportProtocolMgr::Channel Reestablished() has to be called.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 677bdfc28d3dProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
La méthode NotifyReestablishment est appelée de manière synchrone par le Diagnostic Manager (DM) lorsqu'une réponse positive ne doit être envoyée qu'après un redémarrage effectué dans le cadre d'un redémarrage de calculateur (service UDS 0x11) ([SWS_DM_00326], [SWS_DM_00360]). Le canal de transport à surveiller est transmis via le paramètre channelId ([SWS_DM_00326]).
L'appel donne l'instruction à l'implémentation du protocole de transport de sauvegarder la demande de surveillance de manière persistante ([SWS_DM_00359]). Après le redémarrage du système et le relancement des gestionnaires, le gestionnaire de protocole signale au DM la nouvelle disponibilité du canal de manière asynchrone au moyen de [SWS_DM_00313] ([SWS_DM_00358]). La valeur de retour booléenne indique avec true que la demande de notification a été acceptée et peut être satisfaite ; dans le cas contraire, false est renvoyé ([SWS_DM_00326]).
En matière de concurrence et de traitement des erreurs :
La fonction est spécifiée comme not thread-safe ; les appels parallèles doivent être synchronisés par l'appelant ([SWS_DM_00326]).
Afin de pouvoir identifier le même canal après le redémarrage, des données de point de terminaison spécifiques à la connexion doivent être sauvegardées, à moins qu'un mappage bijectif stable n'existe ([SWS_DM_00326]).
Cette note d'utilisation a été générée par une IA sur la base de la spécification.
The channelID, whose re-establishment shall be notified to Uds TransportProtocolMgr
Rückgabewert
Typ
Beschreibung
bool
TRUE, if notification request is accepted and can be fulfilled, else FALSE
Hinweise: The UdsTransportProtocolHandler will call UdsTransportProtocolMgr::Channel Reestablished() after UdsTransportProtocolHandler::Start() is called and as soon as it detects that the remote client/tester is reachable again.
Request a governed re-review of this record. The record is not changed immediately.
Start processing the UDS Transport Protocol. Within the implementation there might be some stack specific implementation. The method is asynchronous to allow the DM to start multiple UdsTransportProtocolHandler in parallel to reduce startup time.
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : b5781ddbed6cProvenanceQuestions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
La méthode Start de l'interface apext::diag::uds_transport::UdsTransportProtocolHandler démarre le traitement de protocole d'un plugin de transport UDS dans le Diagnostic Management (DM) conformément à [SWS_DM_00322]. Elle ne prend aucun paramètre et ne fournit aucune valeur de retour. L'exécution est conçue pour être asynchrone afin que le DM puisse démarrer plusieurs instances en parallèle et réduire ainsi le temps de démarrage du système global ([SWS_DM_00322]). Comme la signature déclare void, le traitement asynchrone devrait être pris en charge de manière spécifique à la pile via des mécanismes internes en arrière-plan. Question Q-d1023a05a1f3e2ab (ouverte)
Préconditions : avant l'appel, l'initialisation via Initialize ([SWS_DM_00319]) doit impérativement avoir été achevée avec le résultat kInitializeOk ([SWS_DM_01746]). Si l'initialisation fournit en revanche kInitializeFailed, le DM interrompt l'opération et ne doit pas appeler Start ([SWS_DM_01745]).
Postconditions : ce n'est qu'après l'appel réussi de Start que le DM est autorisé à déclencher des fonctions en aval telles que Transmit ou Stop sur le gestionnaire ([SWS_DM_01743]). De plus, le DM traite les notifications relatives à ChannelReestablished ([SWS_DM_00313]) exclusivement si Start a été exécuté auparavant ([SWS_DM_01744]), ce qui est essentiel, entre autres, pour les scénarios de réinitialisation d'ECU avec reconnexion ([SWS_DM_00326]).
La méthode est déclarée comme noexcept et est donc sûre du point de vue des exceptions, mais elle est explicitement spécifiée comme non sûre pour les threads (not thread-safe) ([SWS_DM_00322]). Les appelants doivent par conséquent s'assurer que les appels d'instance sont synchronisés.
Cette note d'utilisation a été générée automatiquement sur la base des données de spécification.
Method to indicate that this UdsTransportProtocolHandler should terminate. If UdsTransportProtocolHandler has stopped, it shall call UdsTransportProtocolMgr:: HandlerStopped(UdsTransportProtocolHandlerID).
After return from Stop(), the handler-plugin shall NOT call to UdsTransportProtocolMgr with any other method but UdsTransportProtocolMgr::HandlerStopped().
GÉNÉRÉ PAR IAnon vérifiéModèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : e507b828b86bProvenance
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand
La méthode Stop de l'interface apext::diag::uds_transport::UdsTransportProtocolHandler signale à une instance de protocole de transport UDS qu'elle doit se terminer [SWS_DM_00323]. L'appel est déclenché par le Diagnostic Management (DM) dès que celui-ci passe à l'état ApplicationState.kTerminating[SWS_DM_00333]. La fonction est sans paramètre, ne possède aucune valeur de retour, est déclarée comme noexcept et spécifiée comme sûre face aux exceptions (exception safe) [SWS_DM_00323].
Les conditions suivantes s'appliquent au contexte d'appel et à la concurrence :
Concurrence : L'opération est spécifiée comme non thread-safe (not thread-safe) [SWS_DM_00323].
Restriction d'appel : Après le retour de Stop, le plugin du handler ne doit appeler aucune autre méthode sur apext::diag::uds_transport::UdsTransportProtocolMgr, à la seule exception de l'acquittement HandlerStopped[SWS_DM_01741][SWS_DM_00323].
L'interaction avec le DM s'effectue de manière asynchrone : une fois que le handler a fermé ses connexions réseau et libéré ses ressources, il doit en informer le DM via apext::diag::uds_transport::UdsTransportProtocolMgr::HandlerStopped en lui transmettant son handlerId[SWS_DM_00314]. Après l'appel de Stop, le DM attend impérativement ce rappel de confirmation avant d'arrêter définitivement le processus [SWS_DM_00340].
Ce texte a été généré automatiquement sur la base de la spécification AUTOSAR Adaptive R25-11.
En matière d'ordonnancement et de cycle de vie, le Diagnostic Manager n'est autorisé à appeler Transmit qu'une fois l'initialisation du gestionnaire terminée avec kInitializeOk ([SWS_DM_01746]) et la méthode Start appelée ([SWS_DM_01743]). Comme l'opération est spécifiée comme not thread-safe et exception safe ([SWS_DM_00327]), la coordination des requêtes d'émission parallèles devrait, selon l'interprétation, devoir s'effectuer côté appelant dans le Diagnostic Manager. Question Q-6edd917928b60e55 (ouverte)
La fonction ne fournit de manière synchrone aucune valeur de retour. Le gestionnaire de transport est tenu de restituer de façon asynchrone le pointeur de message au Diagnostic Manager via apext::diag::uds_transport::UdsTransportProtocolMgr::TransmitConfirmation après la transmission ([SWS_DM_00327], [SWS_DM_00312]). En cas d'envoi réussi au niveau du réseau, le résultat kTransmitOk est signalé, sinon kTransmitFailed ([SWS_DM_00351]).
Cette note d'utilisation est basée sur la spécification AUTOSAR Adaptive R25-11.
The message to be transmitted as a UdsMessage::Ptr (unique_ptr style). UdsTransportProtocolHandler has to give back this Uds Message::Ptr via UdsTransportProtocolMgr::Transmit Confirmation() to signal, that it is done with this message.
channelId
Identification of channel on which to transmit.
Rückgabewert
Typ
Beschreibung
None
Hinweise: This transmit API covers T_Data.req of ISO 14229-2[25] Figure 2.
Request a governed re-review of this record. The record is not changed immediately.
The handler ID used by DM to identify this handler. This is just a number/identification given by the DM core, when instantiating a UdsTransportProtocolHandler instance, to be able to distinguish it from other handler-plugins or built-in UdsTransportProtocolHandler implementation(s).
transportProtocolMgr
Reference to UdsTransportProtocolMgr owned by this DM, with which UdsTransportProtocolHandler instance shall interact.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · Original allemand