класс apext::diag::uds_transport::UdsTransportProtocolPeriodicHandler

Класс apext::diag::uds_transport::UdsTransportProtocolPeriodicHandler предоставляет чисто виртуальный интерфейс для обработки периодического сервиса UDS 0x2A через транспортозависимые диагностические каналы ([SWS_DM_01064]). Он позволяет управлению диагностикой определять специфичные для канала ограничения полезной нагрузки и объема, а также осуществлять упорядоченную передачу нескольких UDS-сообщений с помощью PeriodicTransmit ([SWS_DM_01067]). В случае сбоя отправки сообщения операция прерывается, а состояние сообщается через функцию подтверждения. Поскольку все методы специфицированы как потоконебезопасные, параллельные обращения должны синхронизироваться вызывающей стороной.

больше ›

Контекст

Чисто виртуальный класс apext::diag::uds_transport::UdsTransportProtocolPeriodicHandler представляет собой стандартизированный интерфейс для поддержки периодического считывания диагностических данных в соответствии с сервисом UDS 0x2A ([SWS_DM_01064], AUTOSAR_AP_SWS_Diagnostics §C.3.1 «Class: UdsTransportProtocolPeriodicHandler»). В диагностической системе AUTOSAR Adaptive Platform он отделяет вышестоящее управление диагностикой от конкретной реализации сетевого и транспортного протоколов. В то время как управление диагностикой анализирует входящие запросы на периодические передачи и формирует соответствующие пакеты данных, обработчик берет на себя непосредственную передачу этих периодических сообщений через конкретное соединение ([SWS_DM_01067]). В качестве партнеров по взаимодействию выступают управление диагностикой на стороне вызывающего объекта, а также соответствующий коммуникационный канал, идентифицируемый через уникальный ChannelID ([SWS_DM_01065], [SWS_DM_01066]).

Контекстная диаграмма: встраивание UdsTransportProtocolPeriodicHandler между сервером диагностики и транспортным уровнем. Источники: [SWS_DM_01064], [SWS_DM_01067], AUTOSAR_AP_SWS_Diagnostics §C.3.1 «Class: UdsTransportProtocolPeriodicHandler».

Жизненный цикл

Поскольку UdsTransportProtocolPeriodicHandler определен как абстрактный базовый интерфейс с чисто виртуальными методами, его экземпляр не может быть создан напрямую ([SWS_DM_01064]). Создание конкретных экземпляров обработчика осуществляется, предположительно, компонентами драйверов конкретных транспортов (например, для протоколов на базе DoIP или CAN). Вопрос Q-d0b3bf3b0c14dcf6 (открытый) Жизненный цикл экземпляра обычно привязан к доступности стека соответствующего транспортного протокола. Для корректного полиморфного уничтожения при завершении работы стека коммуникации класс предоставляет виртуальный деструктор ~UdsTransportProtocolPeriodicHandler() ([SWS_DM_02089], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.1.1 «Destructor»).

Что касается параллелизма, все функции-члены класса явно обозначены как потоконебезопасные (not thread-safe) ([SWS_DM_01065], [SWS_DM_01066], [SWS_DM_01067], [SWS_DM_02089]). При параллельном доступе из нескольких потоков или одновременных запросах через один и тот же ChannelID вызывающие стороны должны самостоятельно синхронизировать обращения.

Путь использования

Типичный порядок действий для выполнения периодических передач сообщений для сервиса 0x2A подразделяется на следующие шаги:

• Определение максимальной длины полезной нагрузки: управление диагностикой вызывает GetMaxPayloadLength(channelId), чтобы проверить максимально поддерживаемую длину полезной нагрузки для отдельной периодической передачи на указанном соединении ([SWS_DM_01066], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.2.1 «GetMaxPayloadLength»).
• Запрос емкости сообщений: через GetNumberOfPeriodicMessages(channelId) запрашивается зависящее от транспортного протокола и соединения количество возможных периодических сообщений ([SWS_DM_01065], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.2.2 «GetNumberOfPeriodicMessages»).
• Выполнение периодической передачи: управление диагностикой передает упорядоченный список сообщений в ara::core::Vector<UdsMessageConstPtr> методу PeriodicTransmit(channelId, messages) ([SWS_DM_01067], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.2.3 «PeriodicTransmit»). Обработчик передает содержащиеся сообщения в заданном порядке.
• Подтверждение: транспортный уровень сигнализирует о результате процесса отправки через вызов PeriodicTransmit Confirmation, который возвращает количество успешно переданных сообщений и исходный вектор ([SWS_DM_01067]).

Диаграмма последовательности: типичный процесс запроса емкости, периодической отправки и подтверждения. Источники: [SWS_DM_01065], [SWS_DM_01066], [SWS_DM_01067].

Сценарии ошибок

Во время выполнения PeriodicTransmit все сообщения списка отправляются по порядку. В случае сбоя передачи одного сообщения весь процесс отправки немедленно прерывается ([SWS_DM_01067]). Последующие сообщения списка в этом случае больше не отправляются. Тем не менее, для диагностики ошибок и информирования управления диагностикой инициируется вызов подтверждения PeriodicTransmit Confirmation. Он содержит количество успешно переданных до момента прерывания сообщений, а также исходный неизмененный полный вектор с UDS-сообщениями ([SWS_DM_01067]). Благодаря этому управление диагностикой может точно проследить, какое сообщение вызвало ошибку.

Все методы интерфейса специфицированы как noexcept и безопасные по отношению к исключениям (exception safe) ([SWS_DM_01065], [SWS_DM_01066], [SWS_DM_01067], [SWS_DM_02089]). Состояния ошибок при передаче не приводят к C++-исключениям, а детерминированно сообщаются через предусмотренный механизм подтверждения.