класс ara::rds::IEEE1722Datagram61883_IIDC

Класс ara::rds::IEEE1722Datagram61883_IIDC служит в модуле rds представлением датаграмм IEEE 1722 для потоков данных IEC 61883 и IIDC (AUTOSAR_AP_SWS_RawDataStream с. 1). Он инкапсулирует защищенные поля протокола в ara::core::Optional и выступает в качестве базового класса для послойной конфигурации пакетов потоковой передачи. Уничтожение выполняется исключение-безопасно через виртуальный деструктор ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. В качестве существенного граничного условия незащищенный доступ к экземплярам при параллелизме требует внешней синхронизации.

больше ›

Контекст

Класс ara::rds::IEEE1722Datagram61883_IIDC функционирует внутри модуля rds (Raw Data Stream) платформы AUTOSAR Adaptive Platform как структурированное представление датаграмм IEEE 1722 для потоков данных IEC 61883 и IIDC (AUTOSAR_AP_SWS_RawDataStream с. 1). Он отображает поля протокола спецификации и хранит их в защищенных элементах. Все поля датаграммы — среди них tag [SWS_RDS_90244], channel [SWS_RDS_90245], syt [SWS_RDS_90246], sph [SWS_RDS_90247], qi_2 [SWS_RDS_90248], qpc [SWS_RDS_90249], dbs [SWS_RDS_90250], fn [SWS_RDS_90251], sid [SWS_RDS_90252], sy [SWS_RDS_90253], dbc [SWS_RDS_90254], qi_1 [SWS_RDS_90255], fmt [SWS_RDS_90256], fdf_with_sph [SWS_RDS_90257], tcode [SWS_RDS_90258], а также fdf_without_sph [SWS_RDS_90259] — имеют уровень защиты protected. Поскольку открытые методы доступа не специфицированы, класс, вероятно, служит главным образом базовым классом для производных специализаций протокола или декодеров внутри подсистемы потоковой передачи (интерпретация: базовый класс в иерархии наследования). Вопрос Q-e94037851fe92b8d (открытый) Взаимодействие между датаграммой, специализацией и обработкой потока иллюстрирует следующая контекстная диаграмма.

Контекстная диаграмма: позиционирование базового класса датаграммы между производными специализациями протокола и обработкой потока RDS. Источники: [SWS_RDS_90244], [SWS_RDS_90260], AUTOSAR_AP_SWS_RawDataStream с. 1

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

Экземпляры ara::rds::IEEE1722Datagram61883_IIDC обычно возникают в процессе передачи данных или при приеме аудио- и видеопотоков по сети. Уничтожение и освобождение ресурсов происходят детерминированно через виртуальный деструктор ~IEEE1722Datagram61883_IIDC() noexcept [SWS_RDS_90260]. Объявление в качестве виртуального деструктора гарантирует, что производные классы полностью очищаются при удалении через указатели на базовый класс, тогда как спецификатор noexcept гарантирует, что при уничтожении не могут генерироваться исключения.

Что касается внутреннего состояния, класс не имеет сложного конечного автомата, а инкапсулирует свое состояние через отдельные поля ara::core::Optional. Каждое поле, такое как счетчик блоков данных dbc [SWS_RDS_90254] или поле размера блока данных dbs [SWS_RDS_90250], либо находится в неустановленном состоянии, либо содержит допустимое значение протокола. Относительно параллелизма стандарт не специфицирует внутренних механизмов синхронизации; одновременный доступ на чтение и запись к одному и тому же экземпляру из нескольких потоков, по всей видимости, не является потокобезопасным (интерпретация: отсутствие синхронизации) и требует внешней координации. Вопрос Q-e1381bdfdee717e9 (открытый)

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

Типичный сценарий использования реализуется в производных классах или в рамках конвейеров потоковой передачи для создания либо анализа датаграмм:

• Инициализация: производный класс создает экземпляр объекта датаграммы для подготовки операции отправки или приема.
• Конфигурация полей: требуемые заголовки протокола устанавливаются выборочно. При этом значениями заполняются стандартные параметры, такие как tag [SWS_RDS_90244], channel [SWS_RDS_90245], fmt [SWS_RDS_90256], а также tcode [SWS_RDS_90258]. Инкапсуляция в ara::core::Optional указывает на то, что в зависимости от разновидности подформата IEEE 1722 не каждое поле обязательно должно быть заполнено (интерпретация: выборочное заполнение). Вопрос Q-925b6c1d9b5a8ce6 (открытый)
• Обработка и пересылка: скомпонованные данные датаграммы передаются на нижележащий транспортный уровень модуля RDS.
• Освобождение: после завершения передачи или обработки пакета объект уничтожается, при этом виртуальный деструктор [SWS_RDS_90260] обеспечивает корректную полиморфную очистку.

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

Поскольку ara::rds::IEEE1722Datagram61883_IIDC определен как класс данных, его методы не сигнализируют о явных кодах ошибок AUTOSAR через ara::core::Result. Потенциальные источники ошибок возникают прежде всего при некорректной обработке опциональных членов данных. Доступ к пустым экземплярам ara::core::Optional без предварительной проверки — например, при считывании sid [SWS_RDS_90252], fn [SWS_RDS_90251] или qpc [SWS_RDS_90249] — может привести к ошибкам времени выполнения. В качестве предусловия для доступа на чтение производные компоненты всегда должны проверять, инициализировано ли соответствующее поле. Кроме того, взаимозависимые или альтернативные поля, такие как fdf_with_sph [SWS_RDS_90257] и fdf_without_sph [SWS_RDS_90259], должны устанавливаться согласованно друг с другом.