класс ara::diag::DoIPTriggerVehicleAnnouncement

Класс [SWS_DM_00820] служит для того, чтобы Adaptive Applications могли явно инициировать в Diagnostic Management отправку сообщений с оповещениями транспортного средства DoIP согласно ISO 13400-2 на определенном сетевом интерфейсе. Доступ осуществляется не через собственное создание экземпляра, а статически через предоставленную системой ссылку на объект ([SWS_DM_00821]). Для интерфейсов с управлением, зависящим от линии активации, явный вызов недопустим, так как отправка там выполняется полностью автоматически ([SWS_DM_00822]).

больше ›

Контекст

Класс ara::diag::DoIPTriggerVehicleAnnouncement ([SWS_DM_00820]) предоставляет в заголовке ara/diag/doip_trigger_vehicle_announcement.h (AUTOSAR_AP_SWS_Diagnostics §8.36.1 «Class: DoIPTriggerVehicleAnnouncement») API, с помощью которого Adaptive Application может инициировать целевую отправку оповещений транспортного средства DoIP («Vehicle Announcement Messages») ([SWS_DM_00815], [SWS_DM_00822]).

В DoIP-коммуникации согласно ISO 13400-2 отправка оповещений транспортного средства является преимущественно внутренней задачей Diagnostic Management (DM) (AUTOSAR_AP_SWS_Diagnostics §«About DiagnosticDoIPTriggerVehicleAnnouncementInterface»). По умолчанию DM рассылает эти сообщения при запуске сети в виде широковещательной рассылки другим IP-блокам управления и шлюзам, а также при обнаружении подключения внешнего диагностического тестера (AUTOSAR_AP_SWS_Diagnostics §«About DiagnosticDoIPTriggerVehicleAnnouncementInterface»). Через ara::diag::DoIPTriggerVehicleAnnouncement приложениям тем не менее предоставляется возможность явно инициировать эту отправку для определенного сетевого интерфейса ([SWS_DM_00815], [SWS_DM_00820]).

Контекстная диаграмма: партнеры по взаимодействию при инициировании DoIP-оповещений транспортного средства через Diagnostic Manager. Источники: [SWS_DM_00815], [SWS_DM_00820], AUTOSAR_AP_SWS_Diagnostics §«About DiagnosticDoIPTriggerVehicleAnnouncementInterface».

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

Создание и уничтожение экземпляров класса DoIPTriggerVehicleAnnouncement подчиняются строгим правилам: как конструктор по умолчанию ([SWS_DM_02100]), так и деструктор ([SWS_DM_02101]) объявлены как delete, являются закрытыми и в своей конкретной реализации зависят от производителя. Таким образом, приложения не могут напрямую создавать или уничтожать объекты этого класса.

Доступ к интерфейсу осуществляется статически через функцию GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]). Она возвращает ara::core::Result<std::reference_wrapper<DoIPTriggerVehicleAnnouncement>>, благодаря чему вызывающая сторона получает ссылку на объект службы, предоставленный DM. Интерпретация: из-за закрытых удаленных конструкторов и возврата ссылки на объект класс, вероятно, управляется внутри DM как долгоживущий синглтон. Вопрос Q-cecb961746b3ad13 (открытый)

Что касается параллелизма, ни запрос интерфейса GetDoIPTriggerVehicleAnnouncement(), ни вызов метода TriggerVehicleAnnouncement() не специфицированы как потокобезопасные («not thread-safe») ([SWS_DM_00821], [SWS_DM_00822]). Поэтому одновременный доступ из нескольких потоков требует внешней синхронизации. Оба метода специфицированы как безопасные относительно исключений («exception safe») ([SWS_DM_00821], [SWS_DM_00822]).

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

Типичный процесс запроса DoIP-оповещения транспортного средства состоит из следующих шагов:

1. Получение экземпляра: приложение статически вызывает ara::diag::DoIPTriggerVehicleAnnouncement::GetDoIPTriggerVehicleAnnouncement() ([SWS_DM_00821]).
2. Оценка результата: результирующий ara::core::Result проверяется на наличие ошибок; в случае успеха ссылка извлекается.
3. Запрос оповещения: через метод TriggerVehicleAnnouncement(networkInterfaceId) инициируется отправка на требуемом сетевом интерфейсе ([SWS_DM_00822]).
4. Отправка сообщений со стороны DM: DM обрабатывает запрос и отправляет сообщения с оповещениями транспортного средства согласно ISO 13400-2 на интерфейсе, идентифицированном с помощью networkInterfaceId ([SWS_DM_00815]).

Диаграмма последовательности: порядок вызовов для инициирования DoIP-оповещений транспортного средства. Источники: [SWS_DM_00815], [SWS_DM_00821], [SWS_DM_00822].

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

Центральный сценарий ошибки при использовании TriggerVehicleAnnouncement касается сетевых интерфейсов, зависящих от линии активации: если переданный networkInterfaceId относится к конфигурации интерфейса (DoIPNetworkConfiguration), в которой установлено свойство isActivationLineDependent = TRUE, вызов приводит к ошибке ([SWS_DM_00822]). На таких интерфейсах отправка сообщений с оповещениями уже автоматически инициируется DM, как только линия активации активна и назначен IP-адрес ([SWS_DM_00816], [SWS_DM_00822]).

Для функций GetDoIPTriggerVehicleAnnouncement() и TriggerVehicleAnnouncement() стандартизированные коды ошибок не специфицированы ([SWS_DM_00821], [SWS_DM_00822]). Возможные ошибки времени выполнения или специфичные для производителя состояния ошибок передаются в возвращаемом ara::core::Result и должны проверяться вызывающим приложением.