класс ara::diag::MultipleMonitor

Использование

Метод ara::diag::MultipleMonitor::ConfigureMonitor инициализирует диагностический монитор для внутримониторного устранения дребезга [SWS_DM_01696]. Через параметр monitorHandle адресуется настраиваемый монитор, в то время как с помощью initMonitor регистрируется callback-функция уведомления для реинициализаций, а с помощью getFaultDetectionCounter — функция для опроса текущего значения счетчика сбоев (FDC) [SWS_DM_01696]. Выполнение происходит синхронно и возвращает ara::core::Result<void> AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 «ConfigureMonitor».

Обработка ошибок и параллелизм

В случае ошибки возвращается ошибочный результат DiagErrc::kInvalidArgument [SWS_DM_01696]. Предположительно, это происходит в частности тогда, когда передаются недопустимые указатели на функции или присутствуют несовместимые состояния при внутреннем устранении дребезга (интерпретация). Вопрос Q-3de0f2b0cc427ef3 (открытый) Операция специфицирована как noexcept, а также как исключениебезопасная (exception safe), однако прямо обозначена как непотокобезопасная (not thread-safe) [SWS_DM_01696]. Поэтому вызовы на одном и том же экземпляре монитора должны синхронизироваться со стороны приложения.

Порядок и взаимодействие

Каждая перегрузка ConfigureMonitor может вызываться для монитора строго один раз; монитор готов к работе только после этого шага инициализации [SWS_DM_01696]. При внутримониторном устранении дребезга приложение диагностического монитора обрабатывает логику устранения дребезга самостоятельно и передает в Diagnostic Management только окончательные результаты AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 «Monitor-internal debouncing». Для других механизмов устранения дребезга предусмотрены альтернативные перегрузки для мониторинга на основе времени [SWS_DM_01697], на основе счетчика [SWS_DM_01702] или без устранения дребезга [SWS_DM_01973].

Использование

Синхронная функция-член ara::diag::MultipleMonitor::ConfigureMonitor из заголовочного файла ara/diag/multiple_monitor.h конфигурирует диагностический монитор с устранением дребезга на основе времени ([SWS_DM_01697], SWS Diagnostics §8.44.2.1.3.2 «ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased)»). При вызове передаются дескриптор monitorHandle для идентификации монитора, callback-функция initMonitor типа InitMonitorNotifier, а также параметры устранения дребезга defaultValues типа TimeBased ([SWS_DM_01697]). В качестве возвращаемого значения служит ara::core::Result<void>, а сигнатура функции объявлена как noexcept ([SWS_DM_01697]).

Условия вызова и параллелизм

Монитор может использоваться только после завершения этого шага инициализации ([SWS_DM_01697]). Каждый перегруженный вариант ConfigureMonitor может быть вызван для одного экземпляра монитора строго один раз ([SWS_DM_01697]). Интерфейс хотя и является исключениебезопасным (exception safe), но не потокобезопасен (not thread-safe), поэтому параллельные вызовы на одном и том же экземпляре должны синхронизироваться со стороны пользователя ([SWS_DM_01697]).

Обработка ошибок

Если конфигурация завершается неудачно, вызов возвращает объект ошибки внутри ara::core::Result, в частности код ошибки DiagErrc::kInvalidArgument ([SWS_DM_01697]).

Взаимодействие

Метод дополняет альтернативные функции инициализации для устранения дребезга на основе счетчика ([SWS_DM_01702]), внутримониторного устранения дребезга ([SWS_DM_01696]), а также мониторов без устранения дребезга ([SWS_DM_01973]). Для событий с устранением дребезга на основе времени Diagnostic Manager дополнительно поддерживает выборочную заморозку таймера устранения дребезга ([SWS_DM_00880]) и его последующее возобновление с замороженного состояния ([SWS_DM_00038]).

Синхронный метод ConfigureMonitor класса ara::diag::MultipleMonitor служит для инициализации диагностического монитора с устранением дребезга на основе счетчика ([SWS_DM_01702], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 «ConfigureMonitor»). Объявление предоставляется через заголовочный файл ara/diag/multiple_monitor.h ([SWS_DM_01702]).

Использование и параметры

Функция принимает следующие входные параметры ([SWS_DM_01702]):

• monitorHandle (MonitorHandleType): идентифицирует настраиваемый диагностический монитор.
• initMonitor (InitMonitorNotifier): регистрирует callback-функцию оповещения для инициализации монитора.
• defaultValues (CounterBased): передает стандартные конфигурационные значения для устранения дребезга на основе счетчика.

В качестве возвращаемого значения операция возвращает ara::core::Result<void>, который сообщает об успехе или ошибке ([SWS_DM_01702]).

Обработка ошибок

Если конфигурация завершается неудачно, в возвращаемом значении сообщается об ошибке. При недопустимых аргументах возвращается код ошибки DiagErrc::kInvalidArgument ([SWS_DM_01702]). Функция объявлена как noexcept и гарантирует безопасность исключений (exception safe) ([SWS_DM_01702]).

Параллелизм и ограничения

Каждую перегрузку ConfigureMonitor для конкретного монитора обязательно разрешается вызывать ровно один раз; монитор можно использовать только после этого шага инициализации ([SWS_DM_01702]). Поскольку операция классифицирована как непотокобезопасная (not thread-safe) ([SWS_DM_01702]), при вызовах через границы потоков, вероятно, потребуется внешняя синхронизация (интерпретация). Вопрос Q-fcb809ccb021dd6d (открытый)

Взаимодействие

Метод является частью интерфейса конфигурации в MultipleMonitor. Он дополняет родственные перегрузки для подавления дребезга по времени с TimeBased ([SWS_DM_01697]), для подавления дребезга внутри монитора с функцией считывания ([SWS_DM_01696]), а также для мониторов вовсе без механизма подавления дребезга ([SWS_DM_01973]).

Синхронный метод ConfigureMonitor служит для инициализации диагностического монитора без подавления дребезга внутри ara::diag::MultipleMonitor ([SWS_DM_01973], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 «ConfigureMonitor(MonitorHandleType, InitMonitorNotifier)»). В качестве входных параметров он принимает дескриптор монитора (monitorHandle), а также функцию обратного вызова (initMonitor) для регистрации уведомления InitMonitorNotifier ([SWS_DM_01973]). Данный монитор можно активно использовать только после этого обязательного шага инициализации ([SWS_DM_01973]).

В отношении контекста вызова и параллелизма действуют следующие граничные условия:

• Каждую перегрузку ConfigureMonitor для каждого отдельного монитора разрешается вызывать ровно один раз ([SWS_DM_01973]).
• Метод специфицирован как exception safe, однако классифицирован как not thread-safe ([SWS_DM_01973]). Поэтому параллельный доступ к одному и тому же монитору, вероятно, потребует внешней синхронизации со стороны приложения. Вопрос Q-2272f26f380a5a11 (открытый)

Функция возвращает в качестве результата ara::core::Result<void> ([SWS_DM_01973]). Если конфигурация завершается неудачно, возвращается ошибка, например DiagErrc::kInvalidArgument ([SWS_DM_01973]). Если для диагностического монитора требуется метод подавления дребезга, вместо этого доступны перегруженные варианты для внутреннего подавления дребезга монитора ([SWS_DM_01696]), подавления дребезга по времени ([SWS_DM_01697]) или на основе счетчика ([SWS_DM_01702]).

Функция Offer активирует пересылку входящих диагностических запросов управляющей программой (демоном) Diagnostic Management (DM) соответствующему обработчику [SWS_DM_01699]. Синхронный вызов не принимает параметров и специфицирован как noexcept с безопасностью относительно исключений (exception safe) [SWS_DM_01699].

В случае успеха функция возвращает пустой ara::core::Result<void> [SWS_DM_01699]. Если регистрация для обработчика уже была успешно выполнена ранее, вызов завершается с ошибкой и возвращает код ошибки DiagOfferErrc::kAlreadyOffered с семантикой отката (rollback) [SWS_DM_01699]; это состояние ошибки закреплено в диагностическом домене ошибок [SWS_DM_00514].

В отношении конкурентности метод объявлен как not thread-safe [SWS_DM_01699]. Интерпретация: вызовы на одном и том же экземпляре обработчика, по-видимому, не должны выполняться без защиты из различных потоков, чтобы избежать несогласованности в состоянии регистрации. Вопрос Q-95f2e0895004c73b (открытый)

Паттерн метода Offer соответствует единому механизму предоставления для диагностических обработчиков в AUTOSAR Adaptive, аналогично тому, как он используется, например, для общих процедур [SWS_DM_00557] или служб UDS [SWS_DM_00619]. Хотя именование опирается на предоставление служб в ara::com, речь идет о самостоятельной диагностической реализации AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

Функция [SWS_DM_01698] служит в ara::diag::MultipleMonitor для сообщения информации о состоянии и команд дебаунсинга для конкретного диагностического монитора в Diagnostic Manager (DM). Через параметр monitorHandle адресуется целевой монитор, в то время как action передаёт (не)квалифицированный результат теста или команды для дебаунсинга и предварительного сохранения.

Что касается поведения при ошибках, вызовы с недействительным monitorHandle игнорируются DM [SWS_DM_01698]. Если передаётся действие, которое не поддерживается сконфигурированным методом дебаунсинга, DM генерирует нарушение (violation) [SWS_DM_01988]. Кроме того, невыполненные условия разрешения (enable conditions) могут приводить к отклонению сообщений (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 «EnableConditions»), что соответствует внутренним кодам ошибок [SWS_DM_00514].

Относительно параллелизма и выполнения:

• Метод объявлен как noexcept и, следовательно, является исключениебезопасным [SWS_DM_01698].
• Потокобезопасность является условной: то, должны ли вызовы быть потокобезопасными, определяется через ConcurrencyType, переданный в конструкторе [SWS_DM_01698].
• Во взаимодействии с дебаунсингом на основе счётчика, например, сообщение kPrefailed приводит к инкрементированию внутреннего счётчика [SWS_DM_00875]. Интерпретация: механизмы дебаунсинга и условия разрешения, определённые для отдельных мониторов, вероятно, идентично действуют и для управляемого через дескрипторы мультиэкземпляра. Вопрос Q-ff29529143d35ca2 (открытый)

Метод StopOffer класса ara::diag::MultipleMonitor служит для того, чтобы деактивировать пересылку сообщений-запросов из Diagnostic Management (DM) обработчику [SWS_DM_01700]. Он образует функциональный эквивалент прекращения предложения интерфейса и позволяет приложению целенаправленно прекратить обработку входящих диагностических запросов.

Использование регулируется следующими характеристиками и граничными условиями:

• Сигнатура и контекст вызова: функция объявлена в заголовочном файле ara/diag/multiple_monitor.h и имеет сигнатуру void StopOffer() noexcept; [SWS_DM_01700]. Она не принимает параметров и не возвращает значения. Вызов выполняется синхронно.
• Обработка ошибок: метод специфицирован как noexcept и безопасный относительно исключений (exception safe) [SWS_DM_01700]. Он не генерирует исключений и не предусматривает специальных кодов ошибок или сообщений об ошибках.
• Конкурентность: элемент явно классифицирован как непотокобезопасный (not thread-safe) [SWS_DM_01700]. Конкурентный вызов на одном и том же экземпляре, вероятно, должен синхронизироваться приложением извне. Вопрос Q-b73ead392f8b95b2 (открытый)

Семантика StopOffer следует единому шаблону проектирования для диагностических обработчиков в AUTOSAR Adaptive, при котором службы управляются через Offer и StopOffer AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors». Тот же принцип деактивации пересылки запросов встречается у родственных портов, таких как ara::diag::Monitor::StopOffer [SWS_DM_01089], а также у общих процедур [SWS_DM_00558] и служб UDS [SWS_DM_00620].