Define interfaces para la gestión de valores de frescura y el tratamiento de errores en canales de comunicación protegidos.
GENERADO POR IAno revisadoModelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: 05efd4a1afb9ProcedenciaPreguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán
Define interfaces para la gestión de valores de frescura y el tratamiento de errores en canales de comunicación protegidos.
El espacio de nombres define la interfaz específica del fabricante para gestionar valores de frescura en el marco de Secure Onboard Communication (SecOC) para el Communication Management de AUTOSAR Adaptive Platform (SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h»). El ciclo de vida y la inicialización del Freshness Value Manager están completamente controlados por la gestión de comunicación, la cual consulta valores de frescura a través de la interfaz durante los procesos de transmisión configurados ([SWS_CM_11272]). En caso de no disponibilidad temporal de valores de frescura, se realizan reintentos controlados hasta alcanzar un valor de umbral definido antes de descartar los mensajes erróneos. De forma complementaria, el espacio de nombres proporciona un dominio de error propio y códigos de error estandarizados para el diagnóstico y el tratamiento de excepciones.
Contexto
El espacio de nombres apext::com::secoc define interfaces normativas para extensiones de plataforma (Platform Extension Interfaces) dentro del clúster funcional Communication Management (ara::com) de la AUTOSAR Adaptive Platform (SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h»). El objetivo de estas interfaces de extensión es permitir a los OEM y a los fabricantes de pilas proporcionar un Freshness Value Manager (FVM) a medida que genere, gestione y verifique los valores de frescura requeridos para la protección contra ataques de repetición en Secure Onboard Communication (SecOC).
El espacio de nombres interactúa esencialmente con tres roles: la gestión de comunicación (ara::com), la definición de interfaz estandarizada (FVM) junto con contenedores de datos como FVContainer ([SWS_CM_11286], [SWS_CM_11344]), así como la implementación concreta del FVM del fabricante del vehículo o del proveedor de la pila. Interpretación: Se asume que la biblioteca de FVM específica del fabricante se vincula durante la integración del sistema como biblioteca estática o dinámica, dado que la especificación define la interfaz funcional, pero deja abierta la modalidad de integración de forma específica para cada pila. Pregunta Q-256aef3d6698cc3f (abierta)
La gestión del ciclo de vida de una realización del FVM está completamente controlada por la gestión de comunicación ara::com ([SWS_CM_11272]). Las aplicaciones y las instancias de servicio no crean ni gestionan el componente FVM directamente.
La puesta en servicio se realiza de forma determinista durante la inicialización de la pila de comunicación mediante la llamada a la API de biblioteca apext::com::secoc::FVM::Initialize ([SWS_CM_11273]). Si la inicialización no puede completarse correctamente por parte del fabricante, la capa del FVM señaliza este estado de error mediante el código de error definido kFVInitializeFailed ([SWS_CM_11342]). Tras una llamada de inicialización exitosa, el Freshness Value Manager permanece en estado operativo activo y responde a solicitudes síncronas de valores de frescura de transmisión y recepción.
Ruta de uso
La ruta de uso habitual se subdivide en la protección de transmisión y la verificación de recepción de mensajes:
Mensajes de transmisión: Si un mensaje está configurado para el envío mediante SecOC, se trata como un mensaje auténtico ([SWS_CM_11274]). La protección se lleva a cabo en un orden fijo tras concluir todos los cálculos de protección E2E ([SWS_CM_11274]). Si la configuración de la interfaz de servicio posee un atributo freshnessValueId, la gestión de comunicación invoca apext::com::secoc::FVM::GetTxFreshness ([SWS_CM_11274], [SWS_CM_11275]). El valor de frescura se suministra en una estructura FVContainer que almacena la longitud en bits en el atributo length y el valor en sí ([SWS_CM_11286], [SWS_CM_11344]).
Mecanismo de reintento de transmisión: Para cada mensaje protegido, el sistema mantiene un Authentication Build Counter ([SWS_CM_11275]). Tras una generación correcta, el contador se restablece a 0. Si GetTxFreshness devuelve el error recuperable kFVNotAvailable o si falla el cálculo del autenticador, se incrementa el contador y se repite la construcción ([SWS_CM_11275]). Si el contador alcanza el valor de umbral SecOCAuthenticationBuildAttempts, el mensaje se descarta ([SWS_CM_11275]).
Mensajes de recepción: En los mensajes SecOC entrantes con verificación activa (atributo securedRxVerification verdadero o no configurado), se extrae el autenticador y se verifica el mensaje antes de las comprobaciones E2E recalculando el MAC ([SWS_CM_11276], SWS Communication Management §8.1 «SecOC secure channel reception»). Por el contrario, si securedRxVerification se establece en falso, la verificación se elude (bypass) y el mensaje se procesa sin comprobación ([SWS_CM_11372]).
Diagrama de secuencia: Flujo de invocación y reintentos al proteger un mensaje de transmisión mediante FVM. Fuentes: [SWS_CM_11274], [SWS_CM_11275].
Escenarios de error
Las situaciones de error dentro de la interfaz del FVM se gestionan mediante el dominio de error con seguridad de tipos ComSecOcFvmErrorDomain, cuya instancia puede obtenerse a través de GetComSecOcFvmErrorDomain ([SWS_CM_12521]). Los códigos de error están definidos en el tipo de enumeración ComSecOcFvmErrc ([SWS_CM_11342]):
kFVNotAvailable (Código 1): El valor de frescura requerido no está disponible temporalmente. Esto señaliza a Communication Management un error recuperable que desencadena reintentos según el protocolo de transmisión ([SWS_CM_11275], [SWS_CM_11342]).
kFVInitializeFailed (Código 2): Falló la inicialización del Freshness Value Manager ([SWS_CM_11342]).
A través de la función auxiliar MakeErrorCode ([SWS_CM_12522]) es posible encapsular códigos de error junto con datos adicionales específicos del fabricante (SupportDataType) en objetos ara::core::ErrorCode convencionales. Para llamadas síncronas fallidas en entornos basados en excepciones se dispone de la clase de excepción ComSecOcFvmException.
Esta guía se basa en la especificación AUTOSAR Adaptive Platform R25-11 (Communication Management). Todas las afirmaciones se fundamentan exclusivamente en las referencias de especificación y documentación indicadas.
Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.
GENERADO POR IAno revisadoModelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: 8b6808ee1e7cProcedenciaPreguntas abiertas (2)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán
usar
La función no miembro GetComSecOcFvmErrorDomain sirve para obtener una referencia al objeto de dominio de error del Freshness Value Management (FVM) para SecOC según [SWS_CM_12521]. La función está definida en el espacio de nombres apext::com::secoc y debe incluirse mediante el archivo de cabecera apext/com/secoc/fvm_error_domain.h (AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.1 «GetComSecOcFvmErrorDomain»). No recibe parámetros y devuelve de forma síncrona una referencia constante de tipo const ara::core::ErrorDomain & al objeto singleton apext::com::secoc::ComSecOcFvmErrorDomain.
Manejo de errores
La función está declarada como noexcept y especificada como completamente segura frente a excepciones (exception safe) [SWS_CM_12521]. Al invocarla no se producen errores en tiempo de ejecución, y no se lanzan excepciones ni se generan códigos de error. El dominio de error devuelto sirve a los desarrolladores más bien como referencia para cotejar de manera unívoca códigos de error específicos de FVM dentro del tratamiento de errores de SecOC.
Concurrencia y restricciones
Como función constexpr sin estado y sin efectos secundarios, la llamada probablemente sea sin restricciones concurrente y reentrante. Pregunta Q-16d96e7f64bca93f (abierta) Conforme a la especificación, no existen condiciones de orden secuencial ni restricciones en cuanto al contexto de invocación [SWS_CM_12521].
Interacción
La definición se basa en los requisitos RS_AP_00120 así como RS_AP_00130 [SWS_CM_12521]. Si bien la especificación contempla de forma primaria el espacio de nombres apext::com::secoc, en otro punto se encuentra también la indicación ara::com::secoc::GetComSecOcFvmErrorDomain (AUTOSAR_AP_SWS_CommunicationManagement p. 598); esto representa presumiblemente una variante editorial en el marco de las extensiones de Adaptive. Pregunta Q-b49307e7cc69a94b (abierta)
Esta nota de uso fue creada por una IA y se basa en el estado de especificación de AUTOSAR Adaptive R25-11.
GENERADO POR IAno revisadoModelo: gemini-3.8-flash-medium · Esfuerzo: medium · Temperatura: no controlable · Prompt: c91e64600342ProcedenciaPreguntas abiertas (1)
traducido de la guía alemanagemini-3.8-flash-low · 2026-10-13 · Original en alemán
usar
La función apext::com::secoc::MakeErrorCode sirve para crear una instancia de ara::core::ErrorCode para el dominio de error del Freshness Value Management (SecOC) según [SWS_CM_12522] (AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.2 «MakeErrorCode»). La llamada se realiza de forma síncrona. Como parámetros, la función requiere un código de error errorCode de tipo apext::com::secoc::ComSecOcFvmErrc así como datos adicionales específicos del fabricante data de tipo ara::core::ErrorDomain::SupportDataType[SWS_CM_12522]. Devuelve el objeto ara::core::ErrorCode completamente inicializado [SWS_CM_12522].
Tratamiento de errores y concurrencia
La función está especificada como noexcept y exception safe, de modo que se garantiza que la llamada no lance excepciones [SWS_CM_12522]. No se definen mensajes de error de tiempo de ejecución específicos como DET o DEM para esta función de construcción [SWS_CM_12522]. Debido a la cualificación constexpr, es de suponer que la creación del código de error pueda realizarse ya en tiempo de compilación al pasar expresiones constantes. Pregunta Q-a96337508ba6ecdd (abierta)
Interacción
La función se proporciona a través del encabezado apext/com/secoc/fvm_error_domain.h en el espacio de nombres apext::com::secoc[SWS_CM_12522]. En su estructura corresponde a fábricas de códigos de error afines de la gestión de comunicación:
gemini-3.8-flash-low· 2026-10-13 · Original en alemán