структура ara::diag::DoIPGroupIdentification::GidStatus

Структура ara::diag::DoIPGroupIdentification::GidStatus служит контейнером данных для положительных данных ответа при запросе идентификации группы DoIP [SWS_DM_00721]. Она предоставляется Adaptive Application, когда Diagnostic Management запрашивает идентификацию группы при нескомплектованной DoIpInstantiation.gid через интерфейс GetGidStatus [SWS_DM_00813]. Структура передает определенные значения GID напрямую в Diagnostic Manager для дальнейшей пересылки в протоколе DoIP. Она строго ограничена успешными ответами и не содержит механизмов для сценариев сбоев.

больше ›

Контекст

Структура данных ara::diag::DoIPGroupIdentification::GidStatus представляет положительные данные ответа для идентификации группы в подсистеме DoIP (Diagnostic over IP) в AUTOSAR Adaptive Platform [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 «Struct: GidStatus». Она служит стандартизированным контейнером результатов для данных идентификации группы (GID), когда внешние диагностические клиенты запрашивают информацию об идентификации транспортного средства или группы через DoIP. При этом в составе системы взаимодействуют три основных участника: внешний DoIP-клиент, AUTOSAR Diagnostic Management (DM), а также специализированное приложение Adaptive Application, предоставляющее интерфейс ara::diag::DoIPGroupIdentification. Если GID не задан статически через конфигурационный параметр DoIpInstantiation.gid, DM согласно спецификации обязан запросить GID через интерфейс приложения [SWS_DM_00813], AUTOSAR_AP_SWS_Diagnostics §8.34.1 «Providing the GID in DoIP protocol messages using application interface».

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

Являясь структурой данных C++ (struct), GidStatus не имеет самостоятельного жизненного цикла процесса или сервиса, а функционирует как чистый объект передачи данных [SWS_DM_00721]. Экземпляр GidStatus инстанцируется ответственным Adaptive Application и заполняется актуальными идентификационными данными, как только вызывается метод опроса GetGidStatus [SWS_DM_00724], AUTOSAR_AP_SWS_Diagnostics §8.34.1.1.3.1 «GetGidStatus». Интерпретация: структура, вероятно, обычно создается на стеке как временный объект-значение и передается в DM в составе возвращаемого значения по семантике копирования или перемещения, в связи с чем ее жизненный цикл завершается после обработки сообщения DoIP в DM. Вопрос Q-4974fdbc2c6accbb (открытый) Поскольку могут возникать несколько диагностических запросов или параллельная обработка сообщений DoIP, содержащиеся внутри структуры данные должны предоставляться потокобезопасно или создаваться изолированно для каждого контекста запроса.

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

Типичное применение GidStatus подразделяется на фиксированную последовательность взаимодействий между DoIP-клиентом, Diagnostic Management и Adaptive Application:

Диаграмма последовательности: процесс предоставления GidStatus через GetGidStatus при несконфигурированном GID. Источники: [SWS_DM_00721], [SWS_DM_00724], [SWS_DM_00813].

1. Внешний DoIP-клиент отправляет диагностический или идентификационный запрос через сеть DoIP на транспортное средство.
2. Diagnostic Management проверяет конфигурацию: если DoIpInstantiation.gid не сконфигурирован, DM запрашивает идентификацию группы через GetGidStatus у Adaptive Application [SWS_DM_00813], [SWS_DM_00724].
3. Adaptive Application определяет идентификационные признаки группы, создает экземпляр GidStatus с положительными данными ответа и возвращает его в DM [SWS_DM_00721].
4. DM извлекает данные из GidStatus и отправляет полное сообщение протокола DoIP внешнему DoIP-клиенту [SWS_DM_00813].

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

Спецификация явно определяет GidStatus как положительные данные ответа («Response data of positive response message») [SWS_DM_00721], AUTOSAR_AP_SWS_Diagnostics §8.34.2 «Struct: GidStatus». Интерпретация: если Adaptive Application не в состоянии предоставить идентификацию группы или при наличии внутренней ошибки, обычный экземпляр GidStatus, вероятно, не возвращается; вместо этого метод GetGidStatus, вероятно, сигнализирует DM об ошибке через стандартизированные механизмы обработки ошибок платформы (такие как коды ошибок в ara::core::Result). Вопрос Q-01181eb14d27eeb2 (открытый) Кроме того, контекст родственных DoIP-интерфейсов, таких как ara::diag::DoIPPowerMode [SWS_DM_00814], показывает, что DM использует определенные значения по умолчанию или резервные значения в случае еще не предложенных интерфейсов [SWS_DM_01525]; для идентификации группы отсутствие валидных данных ответа требует соответствующей негативной обработки в протоколе DoIP, поскольку без GID невозможно передать действительный положительный ответ [SWS_DM_00813].