clase ara::diag::MultipleMonitor

usar

El método ara::diag::MultipleMonitor::ConfigureMonitor inicializa un monitor de diagnóstico para el antirrebote interno del monitor [SWS_DM_01696]. Mediante el parámetro monitorHandle se direcciona el monitor que se va a configurar, mientras que con initMonitor se registra una callback de notificación para reinicializaciones y con getFaultDetectionCounter una función para consultar el valor actual del contador de fallos (FDC) [SWS_DM_01696]. La ejecución se realiza de forma síncrona y devuelve un ara::core::Result<void> AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.4 «ConfigureMonitor».

Tratamiento de errores y concurrencia

En caso de error se devuelve el resultado de error DiagErrc::kInvalidArgument [SWS_DM_01696]. Es probable que esto ocurra especialmente si se pasan punteros a función no válidos o si se dan estados incompatibles en el antirrebote interno (interpretación). Pregunta Q-3de0f2b0cc427ef3 (abierta) La operación está especificada como noexcept y segura frente a excepciones (exception safe), pero expresamente identificada como no segura para subprocesos (not thread-safe) [SWS_DM_01696]. Por lo tanto, las llamadas sobre la misma instancia del monitor deben sincronizarse en la aplicación.

Secuencia e interacción

Cada sobrecarga de ConfigureMonitor solo puede llamarse exactamente una vez para un monitor; el monitor solo está listo para funcionar tras este paso de inicialización [SWS_DM_01696]. Con el antirrebote interno del monitor, la aplicación del monitor de diagnóstico procesa la lógica de antirrebote de forma autónoma y se limita a transmitir los resultados finales al Diagnostic Management AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.5.3 «Monitor-internal debouncing». Para otros mecanismos de antirrebote se dispone de sobrecargas alternativas para supervisiones basadas en tiempo [SWS_DM_01697], basadas en contador [SWS_DM_01702] o sin antirrebote [SWS_DM_01973].

usar

La función miembro síncrona ara::diag::MultipleMonitor::ConfigureMonitor del archivo de cabecera ara/diag/multiple_monitor.h configura un monitor de diagnóstico con antirrebote basado en tiempo ([SWS_DM_01697], SWS Diagnostics §8.44.2.1.3.2 «ConfigureMonitor(MonitorHandleType, InitMonitorNotifier, TimeBased)»). Al realizar la llamada se pasan el manejador monitorHandle para la identificación del monitor, la función de callback initMonitor de tipo InitMonitorNotifier, así como los parámetros de antirrebote defaultValues de tipo TimeBased ([SWS_DM_01697]). Como valor de retorno sirve ara::core::Result<void>, y la firma de la función está declarada como noexcept ([SWS_DM_01697]).

Condiciones de llamada y concurrencia

Un monitor solo puede utilizarse tras finalizar este paso de inicialización ([SWS_DM_01697]). Cada variante sobrecargada de ConfigureMonitor solo puede llamarse exactamente una vez por instancia de monitor ([SWS_DM_01697]). Si bien la interfaz es segura frente a excepciones (exception safe), no es segura para subprocesos (not thread-safe), por lo que las llamadas paralelas en la misma instancia deben sincronizarse por parte del usuario ([SWS_DM_01697]).

Manejo de errores

Si la configuración falla, la llamada devuelve un objeto de error dentro de ara::core::Result, en particular el código de error DiagErrc::kInvalidArgument ([SWS_DM_01697]).

Interacción

El método complementa las funciones de inicialización alternativas para la eliminación de rebotes basada en contadores ([SWS_DM_01702]), la eliminación de rebotes interna del monitor ([SWS_DM_01696]), así como monitores sin eliminación de rebotes ([SWS_DM_01973]). Para eventos con eliminación de rebotes basada en tiempo, el Diagnostic Manager también admite la congelación selectiva del temporizador de eliminación de rebotes ([SWS_DM_00880]) y su posterior reanudación a partir del estado congelado ([SWS_DM_00038]).

El método síncrono ConfigureMonitor de la clase ara::diag::MultipleMonitor sirve para inicializar un monitor de diagnóstico con eliminación de rebotes basada en contadores ([SWS_DM_01702], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.1 «ConfigureMonitor»). La declaración se proporciona mediante el archivo de cabecera ara/diag/multiple_monitor.h ([SWS_DM_01702]).

Uso y parámetros

La función acepta los siguientes parámetros de transferencia ([SWS_DM_01702]):

• monitorHandle (MonitorHandleType): Identifica el monitor de diagnóstico que se va a configurar.
• initMonitor (InitMonitorNotifier): Registra una función callback de notificación para la inicialización del monitor.
• defaultValues (CounterBased): Pasa valores de configuración predeterminados para la eliminación de rebotes basada en contadores.

Como valor de retorno, la operación devuelve un ara::core::Result<void> que informa sobre el éxito o el error ([SWS_DM_01702]).

Manejo de errores

Si la configuración falla, se notifica un error en el valor de retorno. En caso de argumentos no válidos, se devuelve el código de error DiagErrc::kInvalidArgument ([SWS_DM_01702]). La función está declarada como noexcept y garantiza seguridad frente a excepciones (exception safe) ([SWS_DM_01702]).

Concurrencia y restricciones

Cada sobrecarga de ConfigureMonitor debe llamarse obligatoriamente exactamente una sola vez para un monitor; el monitor solo se puede utilizar después de este paso de inicialización ([SWS_DM_01702]). Dado que la operación está clasificada como no segura para subprocesos (not thread-safe) ([SWS_DM_01702]), es probable que se requiera sincronización externa si las llamadas se realizan a través de los límites de subprocesos (interpretación). Pregunta Q-fcb809ccb021dd6d (abierta)

Interacción

El método forma parte de la interfaz de configuración en MultipleMonitor. Complementa las sobrecargas relacionadas para la eliminación de rebotes basada en tiempo con TimeBased ([SWS_DM_01697]), para la eliminación de rebotes interna del monitor con función de lectura ([SWS_DM_01696]), así como para monitores sin ningún mecanismo de eliminación de rebotes ([SWS_DM_01973]).

El método síncrono ConfigureMonitor sirve para inicializar un monitor de diagnóstico sin eliminación de rebotes dentro de ara::diag::MultipleMonitor ([SWS_DM_01973], AUTOSAR_AP_SWS_Diagnostics §8.44.2.1.3.3 «ConfigureMonitor(MonitorHandleType, InitMonitorNotifier)»). Acepta como parámetros de entrada el handle del monitor (monitorHandle), así como una función callback (initMonitor) para registrar una notificación de InitMonitorNotifier ([SWS_DM_01973]). Solo después de este paso obligatorio de inicialización se puede utilizar activamente el monitor en cuestión ([SWS_DM_01973]).

Con respecto al contexto de llamada y a la concurrencia, se aplican las siguientes condiciones límite:

• Cada sobrecarga de ConfigureMonitor debe llamarse exactamente una vez para cada monitor individual ([SWS_DM_01973]).
• El método está especificado como exception safe, pero clasificado como not thread-safe ([SWS_DM_01973]). Por lo tanto, un acceso concurrente al mismo monitor probablemente requeriría una sincronización externa por parte de la aplicación. Pregunta Q-2272f26f380a5a11 (abierta)

La función devuelve como resultado un ara::core::Result<void> ([SWS_DM_01973]). Si la configuración falla, se devuelve un error, por ejemplo DiagErrc::kInvalidArgument ([SWS_DM_01973]). Si se requiere un procedimiento de eliminación de rebotes para el monitor de diagnóstico, están disponibles en su lugar las variantes sobrecargadas para debouncing interno del monitor ([SWS_DM_01696]), debouncing basado en tiempo ([SWS_DM_01697]) o debouncing basado en contadores ([SWS_DM_01702]).

La función Offer activa el reenvío de solicitudes de diagnóstico entrantes por parte del demonio de Diagnostic Management (DM) al manejador correspondiente [SWS_DM_01699]. La llamada síncrona no tiene parámetros y está especificada como noexcept con seguridad frente a excepciones (exception safe) [SWS_DM_01699].

En caso de éxito, la función devuelve un ara::core::Result<void> vacío [SWS_DM_01699]. Si el registro para el manejador ya se había ejecutado previamente con éxito, la llamada falla y devuelve el código de error DiagOfferErrc::kAlreadyOffered con semántica de reversión (rollback) [SWS_DM_01699]; este estado de error está anclado en el dominio de errores de diagnóstico [SWS_DM_00514].

En cuanto a la concurrencia, el método está declarado como not thread-safe [SWS_DM_01699]. Interpretación: es probable que las llamadas sobre la misma instancia de manejador no deban realizarse sin protección desde diferentes hilos, a fin de evitar inconsistencias en el estado de registro. Pregunta Q-95f2e0895004c73b (abierta)

El patrón del método Offer se corresponde con el mecanismo uniforme de provisión para manejadores de diagnóstico en AUTOSAR Adaptive, tal como se utiliza de forma análoga, por ejemplo, para rutinas genéricas [SWS_DM_00557] o servicios UDS [SWS_DM_00619]. Aunque el nombre se basa en la provisión de servicios en ara::com, se trata de una implementación independiente y específica de diagnóstico AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

La función [SWS_DM_01698] sirve en ara::diag::MultipleMonitor para notificar información de estado y comandos de eliminación de rebote para un monitor de diagnóstico específico al Diagnostic Manager (DM). A través del parámetro monitorHandle se direcciona el monitor de destino, mientras que action transfiere el resultado de prueba (no) cualificado o comandos para la eliminación de rebote y el prealmacenamiento.

En lo que respecta al comportamiento ante errores, el DM ignora las llamadas con un monitorHandle no válido [SWS_DM_01698]. Si se transfiere una acción no admitida por el método de eliminación de rebote configurado, el DM desencadena una infracción (violation) [SWS_DM_01988]. Además, unas condiciones de habilitación no cumplidas pueden provocar que las notificaciones se descarten (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.4 «EnableConditions»), lo que se corresponde con códigos de error internos [SWS_DM_00514].

Respecto a la concurrencia y la ejecución:

• El método está declarado como noexcept y, por tanto, es seguro frente a excepciones [SWS_DM_01698].
• La seguridad para subprocesos es condicional: que las llamadas deban ser seguras para subprocesos se determina mediante el ConcurrencyType transferido en el constructor [SWS_DM_01698].
• En combinación con la eliminación de rebote basada en contador, por ejemplo, la notificación kPrefailed conduce al incremento del contador interno [SWS_DM_00875]. Interpretación: es de suponer que los mecanismos de eliminación de rebote y las condiciones de habilitación definidos para monitores individuales se aplican de forma idéntica para la instancia múltiple controlada mediante handles. Pregunta Q-ff29529143d35ca2 (abierta)

El método StopOffer de la clase ara::diag::MultipleMonitor sirve para desactivar el reenvío de mensajes de solicitud desde Diagnostic Management (DM) al manejador [SWS_DM_01700]. Constituye la contraparte funcional del ofrecimiento de la interfaz y permite a la aplicación suspender de forma selectiva el procesamiento de las solicitudes de diagnóstico entrantes.

El uso está sujeto a las siguientes características y condiciones límite:

• Firma y contexto de llamada: la función está declarada mediante el encabezado ara/diag/multiple_monitor.h y cuenta con la firma void StopOffer() noexcept; [SWS_DM_01700]. No recibe parámetros y no devuelve ningún valor. La llamada se ejecuta de forma síncrona.
• Tratamiento de errores: el método está especificado como noexcept y seguro frente a excepciones (exception safe) [SWS_DM_01700]. No lanza excepciones ni contempla códigos de error o mensajes de error específicos.
• Concurrencia: el elemento está clasificado explícitamente como no seguro para hilos (not thread-safe) [SWS_DM_01700]. Es probable que una llamada concurrente en la misma instancia deba ser sincronizada externamente por la aplicación. Pregunta Q-b73ead392f8b95b2 (abierta)

La semántica de StopOffer sigue el patrón de diseño uniforme para manejadores de diagnóstico en AUTOSAR Adaptive, en el que los servicios se controlan mediante Offer y StopOffer AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors». El mismo principio de desactivación del reenvío de solicitudes se encuentra en puertos relacionados como ara::diag::Monitor::StopOffer [SWS_DM_01089], así como en rutinas genéricas [SWS_DM_00558] y servicios UDS [SWS_DM_00620].