класс ara::shwa::AcceleratorSelector

Класс ara::shwa::AcceleratorSelector служит в модуле Hardware Acceleration для оценки и выбора подходящих устройств-ускорителей в соответствии со стратегией селектора ([AP_SWS_SHWA_00413]). Через SelectDevice() можно напрямую выбрать подходящее Device, в то время как operator() позволяет выполнять индивидуальную числовую оценку отдельных устройств ([AP_SWS_SHWA_00412]). Поскольку обе операции специфицированы как непотокобезопасные, их параллельное использование требует внешней синхронизации. Возможные ошибки, такие как занятость ресурсов или неподдерживаемые функции, возвращаются без отката через ara::core::Result.

больше ›

Контекст

Класс ara::shwa::AcceleratorSelector функционирует в модуле shwa (Hardware Acceleration) платформы AUTOSAR Adaptive Platform как специализированный селектор для аппаратных устройств-ускорителей. Согласно синтаксису класса, он открыто наследует базовый интерфейс DeviceSelector (class AcceleratorSelector : public DeviceSelector). Его центральная задача состоит в оценке физических или логических устройств-ускорителей (Device) в соответствии с определенной стратегией селектора либо в выборе подходящего устройства ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).

К партнерам по взаимодействию относятся вышестоящая прикладная логика, запрашивающая ресурсы ускорителя для вычислительно сложных задач, базовый класс DeviceSelector, от которого производится наследование, а также анализируемые или возвращаемые селектором экземпляры Device. Критерии выбора сами по себе инкапсулированы в конкретной реализации стратегии селектора ([AP_SWS_SHWA_00413]).

Контекстная диаграмма: позиционирование AcceleratorSelector во взаимодействии с приложением, DeviceSelector и Device. Источники: [AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]

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

Инстанцирование AcceleratorSelector, как правило, должно выполняться с привязкой к конкретному приложению или через соответствующие фабричные механизмы до первого запроса устройства. Вопрос Q-933e42753f63687c (открытый) Уничтожение происходит, как только логика выбора больше не требуется соответствующему прикладному компоненту; спецификация не предписывает специальных промежуточных состояний или фаз жизненного цикла.

Что касается параллелизма, обе предоставляемые операции — SelectDevice() и operator() — явно специфицированы как непотокобезопасные («not thread-safe») ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). Хотя оба метода объявлены как const, параллельные вызовы через один и тот же экземпляр или к тем же лежащим в основе аппаратным ресурсам должны внешне синхронизироваться вызывающей стороной.

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

Взаимодействие с AcceleratorSelector осуществляется по двум альтернативным путям использования: прямой автоматический выбор и индивидуальная оценка кандидатов. Через виртуальный метод SelectDevice() приложение напрямую запрашивает выбор подходящего устройства в соответствии с реализованной стратегией ([AP_SWS_SHWA_00413]). В случае успеха вызов возвращает экземпляр Device, инкапсулированный в ara::core::Result.

В качестве альтернативы перегруженный оператор вызова operator() позволяет выполнять пошаговую оценку отдельных известных устройств ([AP_SWS_SHWA_00412]). Целочисленное значение (int), возвращаемое operator(), предположительно представляет собой относительную оценку пригодности (score), на основе которой приложение может самостоятельно выполнить ранжирование или фильтрацию. Интерпретация: SelectDevice() автономно инкапсулирует полную стратегию выбора, в то время как operator() обеспечивает возможность детального сравнения отдельных устройств. Вопрос Q-e2de44ef0c9e936d (открытый)

Диаграмма последовательности: последовательность вызовов при оценке устройств и выборе устройств. Источники: [AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]

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

Обе операции объявлены как noexcept и гарантируют безопасность исключений ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). Ошибки передаются исключительно через возвращаемый тип ara::core::Result. Специфицированы следующие коды ошибок из области ShwaErrorCode:

• ShwaErrorCode::kResourceBusy: операцию не удалось выполнить, так как соответствующий ресурс в данный момент перегружен или занят ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).
• ShwaErrorCode::kFeatureNotSupported: свойство, запрошенное для выбора или оценки, не поддерживается платформой или устройством ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).

Для обеих функций установлено отсутствие семантики отката (no_rollback_semantics) ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). При возникновении ошибки предшествующее состояние системы или оборудования автоматически не восстанавливается. Вызывающие стороны должны проверять код ошибки объекта Result и при необходимости инициировать повторные попытки или альтернативные пути выбора.