структура ara::diag::DoIPEntityIdentification::EntityId

Структура ara::diag::DoIPEntityIdentification::EntityId служит контейнером данных для шестибайтового идентификатора сущности (EID) экземпляра DoIP согласно ISO 13400-2 ([SWS_DM_01496]). При соответствующей конфигурации Diagnostic Manager запрашивает этот идентификатор у адаптивного приложения через метод ara::diag::DoIPEntityIdentification::GetEntityId, чтобы внедрить его в сообщения протокола DoIP, такие как оповещение о транспортном средстве ([SWS_DM_01361]). Если интерфейс еще не готов или запрос завершился неудачей, в качестве обязательного граничного условия срабатывает резервный механизм с использованием фиксированного значения-заменителя, состоящего исключительно из байтов со значением 0xFF ([SWS_DM_01528]).

больше ›

Контекст

Структура данных ara::diag::DoIPEntityIdentification::EntityId служит для представления стандартизированного идентификатора сущности (Entity Identification, EID) для диагностической связи по протоколу Интернета (DoIP) согласно ISO 13400-2 ([SWS_DM_01496], AUTOSAR_AP_SWS_Diagnostics §8.33 «Header: ara/diag/doip_entity_identification.h»). В рамках AUTOSAR Adaptive Platform она определена как открытый структурный тип внутри API-класса ara::diag::DoIPEntityIdentification ([SWS_DM_01362], [SWS_DM_01496]).

Ее основная обязанность заключается в инкапсуляции идентификационного значения сущности DoIP длиной ровно шесть байт ([SWS_DM_01496]). В архитектуре платформы при этом взаимодействуют три основных участника: во-первых, адаптивное приложение, которое управляет идентификатором сущности или считывает его из аппаратного обеспечения. Во-вторых, интерфейсный класс ara::diag::DoIPEntityIdentification, который предоставляет метод для выдачи идентификатора ([SWS_DM_01362]). В-третьих, Diagnostic Manager (DM), который запрашивает EID в рамках идентификации транспортного средства для исходящих сообщений DoIP ([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Контекстная диаграмма: интеграция EntityId между Diagnostic Manager, интерфейсным классом и адаптивным приложением. Источники: [SWS_DM_01361], [SWS_DM_01496].

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

Будучи структурой данных с единственным членом entityIdentification типа ara::core::Array<std::uint8_t, 6>, EntityId обладает свойствами легковесного объекта-значения C++ ([SWS_DM_01496]). Интерпретация: ввиду отсутствия динамического выделения ресурсов структура, вероятно, по умолчанию поддерживает стандартные операции копирования и перемещения и не подвержена сложным внутренним переходам состояний. Вопрос Q-4a6f7d6e7368b436 (открытый)

Инстанцирование EntityId выполняется адаптивным приложением, как только Diagnostic Manager запрашивает идентификационные данные через вызов ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]). Время жизни экземпляра обычно привязано к циклу возврата и обработки вызова метода. В то время как окружающий сервисный класс ara::diag::DoIPEntityIdentification имеет явные конструкторы ([SWS_DM_01364], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.2.1 «DoIPEntityIdentification») и деструкторы ([SWS_DM_01365], AUTOSAR_AP_SWS_Diagnostics §8.33.1.1.1.1 «Destructor»), объект-значение EntityId автоматически освобождается при выходе из области видимости после считывания данных полей модулем Diagnostic Manager.

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

Штатное использование EntityId следует определенной последовательности в рамках протокола диагностики:

• Проверка конфигурации: Diagnostic Manager проверяет атрибут DoIpNetworkConfiguration.eidRetrieval. Если там указано DoIpEidRetrievalEnum.eidUseApi, DM обязан запросить идентификатор через API ([SWS_DM_01361]).
• Запрос через API: Diagnostic Manager вызывает метод ara::diag::DoIPEntityIdentification::GetEntityId ([SWS_DM_01361]).
• Предоставление данных: приложение создает экземпляр EntityId, заполняет член entityIdentification 6-байтовым идентификатором согласно ISO 13400-2 ([SWS_DM_01496]) и передает структуру.
• Использование в протоколе: Diagnostic Manager извлекает идентификатор и подставляет его в сообщения DoIP, такие как оповещение о транспортном средстве (Vehicle Announcement Message) ([SWS_DM_01361], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Диаграмма последовательности: процесс запроса и дальнейшей обработки EntityId, включая аварийный переход при ошибке. Источники: [SWS_DM_01361], [SWS_DM_01496], [SWS_DM_01528].

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

Ключевой сценарий ошибки возникает, если интерфейс ara::diag::DoIPEntityIdentification к требуемому моменту опроса еще не предоставляется адаптивным приложением или запрос через GetEntityId завершается неудачей ([SWS_DM_01528], AUTOSAR_AP_SWS_Diagnostics §8.33 «Providing EID in DoIP protocol messages using Application Interface»).

Чтобы не блокировать отправку сообщений DoIP на длительное время, спецификация предписывает в этом случае обязательное поведение с использованием значения-заменителя: Diagnostic Manager должен передать вместо штатных данных приложения 6-байтовое поле EID с фиксированным значением 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF ([SWS_DM_01528]). На уровне типов фиксированный массив ara::core::Array<std::uint8_t, 6> исключает ошибки длины и переполнения буфера во время компиляции ([SWS_DM_01496]).