Служит абстрактным базовым классом для плагинов транспорта UDS, предназначенных для передачи и пересылки диагностических сообщений.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 8b34a053e223ПроисхождениеОткрытые вопросы (2)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Служит абстрактным базовым классом для плагинов транспорта UDS, предназначенных для передачи и пересылки диагностических сообщений.
Абстрактный класс служит плагинам транспорта UDS базовым интерфейсом для стандартизированного подключения к адаптивному управлению диагностикой (AUTOSAR_AP_SWS_Diagnostics §7.1.1 «Support of UDS Transport Layer»). Производная реализация пересылает принятые диагностические сообщения менеджеру протокола и передает сгенерированные ответные сообщения диагностическому тестеру по сетевым каналам. Жизненный цикл подчиняется строгой последовательности из создания, отдельной инициализации, асинхронного запуска и упорядоченной остановки ([SWS_DM_00329]). После инстанцирования эксплуатационные вызовы методов не являются потокобезопасными (not thread-safe) и требуют скоординированного управления со стороны ядра диагностики.
Контекст
Класс apext::diag::uds_transport::UdsTransportProtocolHandler представляет собой абстрактный базовый класс в модуле diag AUTOSAR Adaptive Platform. Он определяет стандартизированный интерфейс, через который проприетарные или специфичные для протокола плагины транспорта UDS подключаются к адаптивному управлению диагностикой (DM) (AUTOSAR_AP_SWS_Diagnostics §7.1.1 «Support of UDS Transport Layer», [SWS_DM_00315]). Каждый конкретный транспортный протокол — например, для диагностики по автомобильным сетевым средам — реализует этот интерфейс в виде производного подкласса. DM, вероятно, монопольно владеет соответствующим экземпляром обработчика и управляет им на протяжении всего его эксплуатационного жизненного цикла. Вопрос Q-ef308265bfdf6cec (открытый) Взаимодействие между ядром диагностики и плагином осуществляется через ссылку transportprotocolManager типа UdsTransportProtocolMgr&, которая передается в конструкторе и сохраняется в защищенном виде ([SWS_DM_09015], [SWS_DM_09025]). Каждый обработчик идентифицируется числовым UdsTransportProtocolHandlerID, который можно запросить через GetHandlerID() ([SWS_DM_00325]).
Жизненный цикл
Жизненный цикл обработчика транспортного протокола UDS строго последовательно управляется со стороны DM ([SWS_DM_00329]). После инстанцирования через конструктор UdsTransportProtocolHandler ([SWS_DM_09015]) метод Initialize() отделяет фактическую инициализацию протокола от создания объекта ([SWS_DM_00319]). За исключением опционального запроса через GetPeriodicHandler(), DM не имеет права вызывать методы обработчика до успешного возврата из InitializationResult::kInitializeOk ([SWS_DM_01746], [SWS_DM_09017]). После успешной инициализации вызов Start() переводит обработчик в активное состояние обработки ([SWS_DM_00322]). Чтобы минимизировать время запуска, Start() спроектирован как асинхронная операция; DM, вероятно, внутренне координирует параллельный запуск нескольких обработчиков. Вопрос Q-66e5a53d55e6d812 (открытый) Если DM при завершении работы переходит в состояние ApplicationState.kTerminating, он дает обработчику указание на завершение через Stop() ([SWS_DM_00323], [SWS_DM_00333]). DM ожидает завершения, которое обработчик подтверждает вызовом UdsTransportProtocolMgr::HandlerStopped() ([SWS_DM_00340]). После возврата из Stop() плагину запрещен любой вызов методов менеджера, кроме HandlerStopped() ([SWS_DM_01741]). Освобождение ресурсов в конечном итоге происходит через виртуальный деструктор ([SWS_DM_09016]). В то время как конструктор потокобезопасен, методы рабочего интерфейса объявлены как непотокобезопасные.
В штатном режиме диагностики обработчик обрабатывает входящие сообщения и передает ответы. Как только на сетевом интерфейсе присутствуют как минимум адрес источника, адрес назначения, тип адресации (физический или функциональный), общая длина сообщения, а для многобайтовых полезных данных — первые два байта (payloadInfo), реализация сообщает о запросе менеджеру через UdsTransportProtocolMgr::IndicateMessage() ([SWS_DM_00342], AUTOSAR_AP_SWS_Diagnostics §7.1.1.3 «UDS message transmission on a UDS TransportLayer»). Каждый запрос привязан к уникальному каналу (AUTOSAR_AP_SWS_Diagnostics §7.1.1.4 «Channel Notifications»). Для ответа DM передает диагностический ответ тому же обработчику и каналу с помощью Transmit(message, channelId) ([SWS_DM_00327], [SWS_DM_00348]). После физической передачи обработчик возвращает переданный объект сообщения менеджеру через UdsTransportProtocolMgr::TransmitConfirmation() ([SWS_DM_00327], [SWS_DM_00351]). Специализированный сценарий использования касается перезагрузок блока управления (ECU) (служба UDS 0x11) с положительным ответом после перезапуска: здесь DM перед перезагрузкой запрашивает через NotifyReestablishment(channelId) энергонезависимое сохранение информации о соединении обработчиком; после перезапуска и повторного Start() обработчик сообщает о восстановлении того же канала через ChannelReestablished() ([SWS_DM_00326], [SWS_DM_01744]).
Если инициализация транспортного уровня завершается сбоем и Initialize() возвращает статус InitializationResult::kInitializeFailed, DM немедленно прерывает процесс запуска этого протокола и больше не вызывает никаких методов на данном экземпляре ([SWS_DM_01745], [SWS_DM_09017]). Если периодические передачи не поддерживаются транспортным протоколом, вызов GetPeriodicHandler() возвращает ara::core::Result с кодом ошибки kConfigurationMismatch ([SWS_DM_01068]). Если запрошенное восстановление канала для сброса ECU не может быть гарантировано, NotifyReestablishment() завершается сбоем и сигнализирует об этом возвращаемым значением false ([SWS_DM_00326]). Наконец, если операция отправки диагностического ответа на сетевом уровне завершается неудачно, обработчик должен уведомить об этом менеджера при подтверждении, установив аргумент result в TransmitConfirmation() в значение kTransmitFailed ([SWS_DM_00351]).
Настоящее руководство было автоматически сгенерировано на основе спецификации 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.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 2d1a514affd8ПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Чисто виртуальный метод Initialize служит для явной инициализации экземпляра apext::diag::uds_transport::UdsTransportProtocolHandler и формально отделяет этот процесс от конструирования объекта [SWS_DM_00319]. Он вызывается модулем Diagnostic Manager (DM) синхронно и без параметров, не генерирует исключений (noexcept) и возвращает InitializationResult[SWS_DM_00319][SWS_DM_09017].
Метод сигнализирует о результате через перечислитель InitializationResult::kInitializeOk или InitializationResult::kInitializeFailed[SWS_DM_09017]. Дальнейшее поведение DM напрямую зависит от возвращаемого значения:
В случае успешного возврата со значением kInitializeOk DM разрешено вызывать последующие методы обработчика; до получения этого успешного возвращаемого значения, за исключением GetPeriodicHandler, никакой другой вызов метода не допускается [SWS_DM_01746].
Если обработчик возвращает kInitializeFailed, DM полностью прерывает процесс инициализации этого транспортного протокола и больше не вызывает никаких методов у затронутого экземпляра [SWS_DM_01745].
Этот текст был сгенерирован ИИ на основе AUTOSAR R25-11.
Руководство разработчика реализации в подготовке (сложность I1)
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.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 677bdfc28d3dПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Метод NotifyReestablishment вызывается синхронно Diagnostic Manager (DM), если в рамках перезапуска ECU (UDS-служба 0x11) положительный ответ должен быть отправлен только после состоявшегося перезапуска ([SWS_DM_00326], [SWS_DM_00360]). Через параметр channelId передается отслеживаемый транспортный канал ([SWS_DM_00326]).
С этим вызовом реализации транспортного протокола предписывается персистентно сохранить запрос на отслеживание ([SWS_DM_00359]). После повторного запуска системы и повторного старта обработчиков обработчик протокола асинхронно сообщает о повторной доступности канала с помощью [SWS_DM_00313] в DM ([SWS_DM_00358]). Булево возвращаемое значение сигнализирует с помощью true о том, что запрос на уведомление принят и может быть выполнен; в противном случае возвращается false ([SWS_DM_00326]).
В отношении параллелизма и обработки ошибок действует следующее:
Функция специфицирована как not thread-safe; параллельные вызовы должны синхронизироваться на стороне вызывающего ([SWS_DM_00326]).
Чтобы после перезапуска можно было идентифицировать тот же канал, необходимо сохранить специфичные для соединения данные конечных точек, если не существует стабильного взаимно-однозначного отображения ([SWS_DM_00326]).
Этот использование указание было создано ИИ на основе спецификации.
Руководство разработчика реализации в подготовке (сложность I2)
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.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: b5781ddbed6cПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Метод Start интерфейса apext::diag::uds_transport::UdsTransportProtocolHandler запускает обработку протокола плагина UDS-транспорта в Diagnostic Management (DM) согласно [SWS_DM_00322]. Он не принимает параметров и не возвращает значения. Выполнение спроектировано как асинхронное, чтобы DM мог параллельно запускать несколько экземпляров и тем самым сокращать время запуска всей системы ([SWS_DM_00322]). Поскольку сигнатура объявляет void, асинхронная обработка, вероятно, реализуется специфично для стека с помощью внутренних фоновых механизмов. Вопрос Q-d1023a05a1f3e2ab (открытый)
Предусловия: перед вызовом инициализация через Initialize ([SWS_DM_00319]) обязательно должна быть завершена с результатом kInitializeOk ([SWS_DM_01746]). Если же инициализация возвращает kInitializeFailed, DM прерывает процесс и не должен вызывать Start ([SWS_DM_01745]).
Постусловия: только после состоявшегося вызова Start DM разрешено инициировать последующие функции, такие как Transmit или Stop, на обработчике ([SWS_DM_01743]). Кроме того, DM обрабатывает уведомления о ChannelReestablished ([SWS_DM_00313]) исключительно в том случае, если перед этим был выполнен Start ([SWS_DM_01744]), что имеет существенное значение, в частности, для сценариев ECU-Reset с повторным подключением ([SWS_DM_00326]).
Метод объявлен как noexcept и, следовательно, является бессбойным, однако явно специфицирован как непотокобезопасный (not thread-safe) ([SWS_DM_00322]). Поэтому вызывающие стороны должны гарантировать, что вызовы экземпляра осуществляются синхронизированно.
Данное указание по использованию было сгенерировано автоматически на основе данных спецификации.
Руководство разработчика реализации в подготовке (сложность I2)
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().
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: e507b828b86bПроисхождение
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
Метод Stop интерфейса apext::diag::uds_transport::UdsTransportProtocolHandler сигнализирует экземпляру транспортного протокола UDS о необходимости завершения работы [SWS_DM_00323]. Вызов инициируется Diagnostic Management (DM), как только он переходит в состояние ApplicationState.kTerminating[SWS_DM_00333]. Функция не принимает параметров, не имеет возвращаемого значения, объявлена как noexcept и специфицирована как исключениебезопасная (exception safe) [SWS_DM_00323].
Для контекста вызова и конкурентности действуют следующие условия:
Конкурентность: Операция специфицирована как непотокобезопасная (not thread-safe) [SWS_DM_00323].
Ограничение вызовов: После возврата из Stop плагину обработчика запрещено вызывать дальнейшие методы у apext::diag::uds_transport::UdsTransportProtocolMgr, за единственным исключением подтверждения HandlerStopped[SWS_DM_01741][SWS_DM_00323].
Взаимодействие с DM осуществляется асинхронно: после того как обработчик разорвал свои сетевые соединения и освободил ресурсы, он должен уведомить DM через apext::diag::uds_transport::UdsTransportProtocolMgr::HandlerStopped с передачей своего handlerId[SWS_DM_00314]. После вызова Stop DM обязательно ожидает этот callback подтверждения, прежде чем окончательно завершить процесс [SWS_DM_00340].
Этот текст был автоматически сгенерирован на основе спецификации AUTOSAR Adaptive R25-11.
Руководство разработчика реализации в подготовке (сложность I1)
Transmit a UDS message via the underlying UDS Transport Protocol channel.
СОЗДАНО ИИне провереноМодель: gemini-3.8-flash-medium · Усилие: medium · Температура: не регулируется · Промпт: 5022cdfe42a5ПроисхождениеОткрытые вопросы (1)
переведено с немецкого руководстваgemini-3.8-flash-low · 2026-10-13 · Немецкий оригинал
В отношении последовательности и жизненного цикла Diagnostic Manager имеет право вызывать Transmit только после того, как инициализация обработчика с помощью kInitializeOk была завершена ([SWS_DM_01746]) и был вызван метод Start ([SWS_DM_01743]). Поскольку операция специфицирована как not thread-safe и exception safe ([SWS_DM_00327]), координация параллельных задач отправки согласно интерпретации, вероятно, должна выполняться на стороне вызывающей стороны в Diagnostic Manager. Вопрос Q-6edd917928b60e55 (открытый)
Функция синхронно не возвращает значения. Обработчик транспорта обязан асинхронно возвратить указатель сообщения в Diagnostic Manager после передачи через apext::diag::uds_transport::UdsTransportProtocolMgr::TransmitConfirmation ([SWS_DM_00327], [SWS_DM_00312]). При успешной отправке на сетевом уровне возвращается результат kTransmitOk, в противном случае — kTransmitFailed ([SWS_DM_00351]).
Это указание по использованию основано на спецификации AUTOSAR Adaptive R25-11.
Руководство разработчика реализации в подготовке (сложность I1)
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 · Немецкий оригинал