класс ara::shwa::Device

Служит для абстрагирования и управления аппаратными ускорителями внутри Adaptive Platform AUTOSAR_AP_SWS_SafeHardwareAcceleration с. 12. Экземпляры создаются исключительно через фабричные методы, такие как Create(), и предоставляют операции для проверки типа устройства, а также для считывания специфических характеристик [AP_SWS_SHWA_00308], [AP_SWS_SHWA_00313]. Поскольку операции не являются потокобезопасными, использование в многопоточных средах требует внешней синхронизации.

больше ›

Контекст

Класс ara::shwa::Device служит в модуле безопасного аппаратного ускорения (Safe Hardware Acceleration) основной абстракцией для физических вычислительных блоков AUTOSAR_AP_SWS_SafeHardwareAcceleration с. 12. Внутри Adaptive Platform он обеспечивает Adaptive Applications и другим функциональным кластерам доступ к ресурсам ускорителей и управление ими. Типичная общая система комбинирует экземпляры Device с очередями выполнения (Queues) и буферами памяти (Buffers), чтобы структурированно делегировать ресурсоёмкие вычислительные задачи аппаратному обеспечению ускорителей SWS_SafeHardwareAcceleration с. 22.

Контекстная диаграмма: встраивание ara::shwa::Device во взаимодействии с приложением, очередями и аппаратным обеспечением. Источники: AUTOSAR_AP_SWS_SafeHardwareAcceleration с. 12, SWS_SafeHardwareAcceleration с. 22

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

Создание объектов ara::shwa::Device строго контролируется: конструктор по умолчанию явно удалён [AP_SWS_SHWA_00302]. Экземпляры могут создаваться исключительно через статические фабричные методы Create(): либо без параметров для стандартного устройства [AP_SWS_SHWA_00308], либо параметризованно через объект-селектор с помощью Create(const DeviceSelector&) [AP_SWS_SHWA_00309]. Оба метода возвращают ara::core::Result<Device>.

С точки зрения владения ресурсами класс обладает регулярной семантикой копирования и перемещения: как конструктор копирования [AP_SWS_SHWA_00303] и оператор присваивания копированием [AP_SWS_SHWA_00304], так и конструктор перемещения [AP_SWS_SHWA_00305] и оператор присваивания перемещением [AP_SWS_SHWA_00306] объявлены как noexcept=default. Интерпретация: по-видимому, объект внутри спроектирован как легковесный дескриптор реального аппаратного ресурса, благодаря чему копирование возможно с минимальными затратами и с гарантией безысключительности. Вопрос Q-a6ff4d89f19b0f36 (открытый) Время жизни физического аппаратного интерфейса привязано к времени выполнения лежащего в его основе драйвера или подсистемы, тогда как экземпляр на уровне приложения может передаваться подобно обычному типу значения. Все вызовы фабрик и методы класса специфицированы как непотокобезопасные.

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

Типичный путь использования начинается с инстанцирования через один из фабричных методов. После успешного возврата экземпляр инспектируется для определения типа вычислительного блока и запроса параметров конкретного устройства. Затем устройство обычно назначается очередям и буферам для выполнения задач обработки.

1. Инстанцирование: вызов Create() или Create(deviceSelector) для предоставления устройства [AP_SWS_SHWA_00308], [AP_SWS_SHWA_00309].
2. Проверка типа: валидация категории аппаратного обеспечения через предикаты IsCpu() [AP_SWS_SHWA_00310], IsGpu() [AP_SWS_SHWA_00311] или IsAccelerator() [AP_SWS_SHWA_00312].
3. Запрос конфигурации: считывание детальной информации об устройстве через шаблонный метод GetInfo<InfoType>() [AP_SWS_SHWA_00313].

Диаграмма последовательности: типичная последовательность инициализации, проверки типа и запроса информации. Источники: [AP_SWS_SHWA_00309], [AP_SWS_SHWA_00311], [AP_SWS_SHWA_00313]

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

Методы ara::shwa::Device детерминированно передают состояния ошибок через тип ошибки ara::core::Result. Специфицированы следующие случаи ошибок:

• ShwaErrorCode::kResourceBusy: возникает, если ресурс занят в момент запроса. Это может произойти как во время создания экземпляра [AP_SWS_SHWA_00308], [AP_SWS_SHWA_00309], так и при операциях проверки, таких как IsCpu() [AP_SWS_SHWA_00310], IsGpu() [AP_SWS_SHWA_00311] или IsAccelerator() [AP_SWS_SHWA_00312].
• ShwaErrorCode::kFeatureNotSupported: возвращается, если запрошенное свойство или конфигурация устройства не поддерживаются системой. Это относится к методам создания [AP_SWS_SHWA_00308], [AP_SWS_SHWA_00309], а также к запросу структур характеристик через GetInfo<InfoType>() [AP_SWS_SHWA_00313].

В отношении безопасности исключений все операции считаются exception safe или аннотированы с noexcept. Поскольку операции не являются потокобезопасными, параллельные вызовы на одном и том же экземпляре или разделяемых аппаратных ресурсах должны синхронизироваться прикладным уровнем.