clase ara::sm::s2r::S2RSatellite

usar

El método de fábrica estático ara::sm::s2r::S2RSatellite::Create sirve para la instanciación síncrona de un satélite para la conexión directa con el S2RHub dentro de la misma máquina ([SWS_SM_81014]). La llamada no acepta parámetros y devuelve un ara::core::Result<S2RSatellite>, el cual proporciona el objeto de satélite creado en caso de éxito ([SWS_SM_81014]).

Manejo de errores

Si en la configuración el interruptor «Force IAM switch» está establecido en true, la llamada falla y devuelve el código de error ara::sm::SmErrc::kAuthenticationRequired ([SWS_SM_00716]). En este caso, debe utilizarse obligatoriamente en su lugar el constructor ara::sm::s2r::S2RSatellite::S2RSatellite ([SWS_SM_81014]). Además, se desencadena una AraNotInitialized-Violation si el entorno de ejecución ARA no está inicializado en el momento de la llamada ([SWS_SM_81014]).

Concurrencia y condiciones de contorno

La función está especificada como segura para subprocesos y segura frente a excepciones, y está declarada con noexcept ([SWS_SM_81014]). Por lo tanto, puede invocarse de forma segura desde contextos de aplicación concurrentes.

Interacción

Las instancias de S2RSatellite se emplean en aplicaciones con capacidad S2R para procesar notificaciones antes y después del modo de suspensión (SWS StateManagement §7.5.2 «S2R Satellite»). Tras una instanciación exitosa, la aplicación se registra en el concentrador mediante Offer ([SWS_SM_00710]). Antes de destruir el objeto, debe invocarse la desregistración mediante StopOffer ([SWS_SM_00713]). Interpretación: el método Create probablemente esté previsto principalmente para escenarios de aplicación en los que no se fuerce la autenticación IAM para el satélite. Pregunta Q-fc41980edcb3f61a (abierta)

El método de callback virtual puro EnterSuspendMode de la clase ara::sm::s2r::S2RSatellite [SWS_SM_81010] solicita a una instancia satélite la entrada en el modo de suspensión [SWS_SM_00711]. La llamada se inicia cuando S2R Hub, a través de RequestToEnterSuspendMode, ordena a todos los satélites registrados activamente cambiar al estado de suspensión [SWS_SM_00701]. Es requisito para la recepción de esta llamada que la instancia satélite se haya registrado previamente con éxito en el hub mediante Offer [SWS_SM_81010] [SWS_SM_00710].

ara::core::Future<void> sirve como valor de retorno [SWS_SM_81010]. Si la aplicación puede adoptar con éxito el modo de suspensión, el future se completa con void [SWS_SM_81010]. Si se produce un error, el future debe finalizarse con el código de error SmErrc::kRejected [SWS_SM_81010]. Si al menos un satélite reporta kRejected, la solicitud del hub devuelve el resultado global kAtLeastOneRejected [SWS_SM_00702]. Si un satélite no responde a tiempo dentro del tiempo de espera, la comunicación se cancela con el error kCommunicationTimeout AUTOSAR_AP_SWS_StateManagement p. 36.

En cuanto a la concurrencia, la interfaz está definida como no segura para subprocesos (not-threadsafe) y no segura frente a excepciones (not exception safe) [SWS_SM_81010]. Antes de la destrucción del objeto satélite debe llamarse a StopOffer; esta llamada anula el registro del satélite y se bloquea hasta que hayan finalizado las ejecuciones de callbacks en curso [SWS_SM_00713]. Dado que el método está declarado como virtual puro, es de suponer que la implementación concreta se realice en una clase de aplicación derivada para persistir los estados locales antes del Suspend-to-RAM. Pregunta Q-628b88828075652c (abierta)

El método virtual puro LeaveSuspendMode sirve para que las aplicaciones compatibles con S2R (S2R-Aware applications) abandonen el modo de suspensión y reanuden el funcionamiento regular [SWS_SM_81011], SWS StateManagement §7.5.2 «S2R Satellite». En este contexto, cabe interpretar que la lógica de reanudación específica de la aplicación se implementa en una clase derivada de ara::sm::s2r::S2RSatellite. Pregunta Q-c8e12bf51d76935c (abierta)

Uso y contexto de llamada

La llamada se realiza de forma asíncrona y es provocada por la recepción de un activador de reanudación en el satélite [SWS_SM_00711]. Este activador procede de ara::sm::s2r::S2RHub::RequestToLeaveSuspendMode, el cual envía un mensaje a todas las instancias satélite registradas activamente [SWS_SM_00703]. El método no espera parámetros y devuelve un ara::core::Future<void> [SWS_SM_81011]. En caso de éxito, el future se completa con void en cuanto se haya abandonado con éxito el modo de suspensión [SWS_SM_81011].

Manejo de errores

Si surgen problemas al despertar, el future falla con el código de error SmErrc::kRejected (semántica de reversión) [SWS_SM_81011]. Esto hace que el hub S2R emita kAtLeastOneHadIssuesToLeave como resultado global [SWS_SM_00707]. Si un satélite no reacciona dentro del plazo establecido, el hub se interrumpe con kCommunicationTimeout [SWS_SM_00707].

Concurrencia y precondiciones

• Registro: La activación del manejador presupone que previamente se haya llamado a Offer [SWS_SM_81011], con lo cual el satélite queda registrado activamente [SWS_SM_00710].
• Seguridad: La operación está especificada como not-threadsafe y not exception safe [SWS_SM_81011].
• Ciclo de vida: Antes de la destrucción del satélite debe llamarse a StopOffer; la llamada se bloquea hasta que se hayan completado los callbacks en ejecución [SWS_SM_00713].

La función miembro síncrona ara::sm::s2r::S2RSatellite::Offer registra una instancia de satélite en el concentrador central S2R [SWS_SM_00710]. La llamada sin parámetros activa la recepción de notificaciones, de modo que se puedan invocar las devoluciones de llamada del lado de la aplicación para la transición al modo de suspensión y para la reactivación [SWS_SM_81012], [SWS_SM_81010], [SWS_SM_81011]. El método devuelve un ara::core::Result<void> y está declarado como seguro frente a excepciones (noexcept) [SWS_SM_81012].

En el caso de éxito regular, el Result devuelto está vacío [SWS_SM_81012]. Si el servicio no puede proporcionarse debido a un fallo en la comunicación con el demonio de State Management, la llamada falla con el código de error SmErrc::kOfferFailed [SWS_SM_81012]. Además, el contexto de proceso del satélite debe cumplir con las especificaciones de IAM para la aplicación registrada, ya que las instancias no autorizadas son rechazadas [SWS_SM_00715]. Interpretación: si el registro falla, es probable que la instancia permanezca sin registrar en el concentrador. Pregunta Q-1b445bcf1aecef2d (abierta)

En cuanto a la concurrencia, Offer está especificado como no seguro para subprocesos (not thread-safe) [SWS_SM_81012]; por lo tanto, las llamadas paralelas sobre la misma instancia requieren sincronización externa. Tras ofrecerse con éxito, el satélite permanece registrado activamente hasta que la aplicación llame explícitamente a ara::sm::s2r::S2RSatellite::StopOffer [SWS_SM_00710]. La desregistración a través de StopOffer debe tener lugar antes de la destrucción del satélite y se bloquea hasta que las devoluciones de llamada en curso hayan concluido [SWS_SM_00713].

Uso y semántica

El método StopOffer() desregistra una instancia de ara::sm::s2r::S2RSatellite en el S2R Hub y desactiva futuras invocaciones de devoluciones de llamada ([SWS_SM_81013], [SWS_SM_00710]). La llamada se realiza de forma síncrona y se bloquea hasta que todas las ejecuciones activas de devoluciones de llamada hayan finalizado por completo ([SWS_SM_00713]). La función no acepta parámetros y no tiene valor de retorno.

Ciclo de vida y tratamiento de errores

La interfaz está declarada como noexcept y no lanza excepciones; no existen códigos de error específicos ([SWS_SM_81013]). Según la especificación, StopOffer() no es seguro para subprocesos (not thread-safe). La aplicación debe asegurarse de que StopOffer() se llame explícitamente antes de la destrucción del objeto S2RSatellite o, interpretación: presumiblemente, se ejecute dentro del destructor de la clase de usuario encapsuladora (SWS StateManagement §7.5.2 «Deregistration of S2R Satellites at S2R Hub»). Pregunta Q-79aa369fb23871ed (abierta)

Interacción en el flujo de Suspend-to-RAM

Si el S2R Hub se encuentra en la ejecución de RequestToEnterSuspendMode o RequestToLeaveSuspendMode, este espera a todos los satélites direccionados. Si un satélite se da de baja durante esta fase mediante StopOffer(), el concentrador lo interpreta como una confirmación positiva y evita que falle la transición de estado ([SWS_SM_00702], [SWS_SM_00707]).