BSW Mode Manager (BswM)

La función BswM_BswMPartitionRestarted sirve para notificar al módulo BswM sobre el reinicio de la partición en la que se ejecuta el BswM [SWS_BswM_00193].

Uso y semántica

La llamada la realiza de forma síncrona la tarea de reinicio del sistema operativo tan pronto como la partición se ha restablecido tras un reinicio [SWS_BswM_00193]. La función posee el Service-ID 0x1e y está declarada a través del archivo de cabecera BswM.h [SWS_BswM_00193]. No acepta parámetros de transferencia (ni parámetros de entrada ni de salida) y no posee valor de retorno (void) [SWS_BswM_00193].

Concurrencia y ejecución

Según la especificación, BswM_BswMPartitionRestarted está clasificada como reentrante [SWS_BswM_00193]. Esto permite la llamada en el contexto de la tarea de reinicio, debiendo el llamador garantizar que el reinicio de la partición en cuestión se haya iniciado debidamente antes de la llamada.

Tratamiento de errores e interacción

La especificación no define para este servicio valores de retorno específicos ni códigos de error de DET/DEM [SWS_BswM_00193]. La interacción se limita a la tarea de reinicio del OS, que desencadena esta notificación para que el BswM pueda reaccionar a la partición recién iniciada [SWS_BswM_00193].

Uso y signatura

La función BswM_CanSM_CurrentState es invocada por el CAN State Manager (CanSM) para notificar al BSW Mode Manager (BswM) el estado actual de un canal CAN [SWS_BswM_00049]. Posee el ID de servicio 0x05 y se proporciona a través del archivo de encabezado BswM_CanSM.h [SWS_BswM_00049].

La invocación se realiza de forma síncrona y no devuelve ningún valor de retorno (void) [SWS_BswM_00049]. La interfaz procesa dos parámetros de entrada [SWS_BswM_00049]:

• Network (tipo NetworkHandleType): Designa el canal CAN afectado al que se refiere el cambio de estado notificado [SWS_BswM_00049].
• CurrentState (tipo CanSM_BswMCurrentStateType): Transfiere el nuevo estado adoptado del canal CAN respectivo [SWS_BswM_00049].

Para esta función de servicio no se contemplan parámetros de salida ni de entrada/salida [SWS_BswM_00049].

Concurrencia y restricciones

La especificación señala a BswM_CanSM_CurrentState como reentrante [SWS_BswM_00049]. Por lo tanto, puede invocarse de forma concurrente ante eventos paralelos de múltiples canales de red. Dado que la llamada se realiza de forma síncrona y no se predeterminan restricciones de tarea específicas, es de prever que el contexto de llamada se corresponda con el contexto de ejecución del CanSM invocador [SWS_BswM_00049]. Pregunta Q-0edc8b6c1cb10f6d (abierta)

Tratamiento de errores e interacción

En la especificación no se documentan códigos de error específicos, valores de retorno ni notificaciones a DET o DEM para esta llamada a función [SWS_BswM_00049]. La función actúa como una interfaz de notificación definida en la interacción entre CanSM y BswM, a través de la cual el estado actual del canal se integra en la gestión de modos del BswM [SWS_BswM_00049].

La función BswM_ComM_CurrentMode sirve en el módulo AUTOSAR Classic BswM (Basic Software Mode Manager) como interfaz de notificación estandarizada para el Communication Manager (ComM) [SWS_BswM_00047]. Es invocada por el ComM para indicar al BswM el modo de comunicación actual de un canal de comunicación determinado [SWS_BswM_00047]. La declaración de esta interfaz se proporciona a través del archivo de encabezado BswM_ComM.h, y al servicio se le asigna el ID de servicio hexadecimal 0x0e [SWS_BswM_00047].

La firma de la función es void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode) y requiere dos parámetros de entrada invariables [SWS_BswM_00047]:

• Network (tipo de datos NetworkHandleType): Designa el canal de comunicación ComM concreto para el cual se indica el estado y al que corresponde dicho estado [SWS_BswM_00047].
• RequestedMode (tipo de datos ComM_ModeType): Transmite el estado o modo actual del canal de comunicación ComM indicado al módulo BswM [SWS_BswM_00047].

La interfaz no posee ningún valor de retorno (void); asimismo, en la especificación no se definen parámetros de salida (out) ni parámetros combinados de entrada/salida (inout) [SWS_BswM_00047]. El comportamiento de ejecución de la función se establece como síncrono (Synchronous) [SWS_BswM_00047]. Con respecto a la concurrencia y al contexto de llamadas simultáneas, BswM_ComM_CurrentMode está clasificada como reentrante (Reentrant) [SWS_BswM_00047].

En lo relativo al tratamiento de errores, para esta función no se contemplan en la especificación del elemento códigos de error específicos, valores de retorno ni mensajes de error a DET o DEM [SWS_BswM_00047]. Tampoco se recogen condiciones de orden de ejecución adicionales ni dependencias con requisitos afines [SWS_BswM_00047].

La función BswM_ComM_CurrentPNCMode sirve como interfaz de notificación entre el Communication Manager y el BSW Mode Manager. De acuerdo con [SWS_BswM_00148], el ComM la invoca para transmitir el modo actual de un Partial Network Cluster (PNC) al BswM.

Uso y contexto de llamada

La interfaz está disponible a través del archivo de cabecera BswM_ComM.h y posee el Service-ID 0x15 ([SWS_BswM_00148]). La llamada se ejecuta de forma síncrona y no devuelve ningún valor de retorno (void). Solo se transfieren dos parámetros de entrada:

• PNC (tipo PNCHandleType): El handle del Partial Network Cluster afectado cuyo estado se notifica.
• CurrentPncMode (tipo ComM_PncModeType): El modo adoptado actualmente por el PNC indicado.

Según [SWS_BswM_00148], no se contemplan parámetros de entrada o de salida adicionales.

Concurrencia y restricciones

En lo relativo a la concurrencia, BswM_ComM_CurrentPNCMode está especificada según [SWS_BswM_00148] como reentrante, por lo que se permiten llamadas simultáneas desde el ComM. En el payload no se definen códigos de error específicos ni mecanismos de tratamiento de errores a través de DET o DEM. Es probable que los estados transmitidos sirvan internamente en el BswM como desencadenantes para evaluaciones de reglas y acciones (interpretación: el payload documenta la indicación de modo, pero no especifica acciones internas del BswM). Pregunta Q-2527fc2eda881b62 (abierta)

La función BswM_ComM_InitiateReset es llamada por el Communication Manager (ComM) para señalizar un shutdown pendiente al BswM [SWS_BswM_00217].

Interfaz y semántica de llamada

La interfaz posee la signatura void BswM_ComM_InitiateReset(void) y está declarada a través del archivo de cabecera BswM_ComM.h [SWS_BswM_00217]. No procesa parámetros de entrada, de salida ni de entrada/salida, y no tiene valor de retorno [SWS_BswM_00217]. La llamada se procesa de forma síncrona y está especificada con el Service-ID 0x22 [SWS_BswM_00217].

Concurrencia y restricciones

La función está definida como no reentrante (Non Reentrant) [SWS_BswM_00217]. Por tanto, el llamador debe garantizar que las llamadas se realicen de forma secuencial y que no tengan lugar ejecuciones paralelas o solapadas. Dado que el procesamiento se realiza de forma síncrona, la llamada bloquea el contexto de ejecución hasta que concluye el procesamiento en el BswM.

Tratamiento de errores e interacción

En las especificaciones no se prevén códigos de error específicos, valores de retorno ni mensajes de error a DET o DEM para este servicio [SWS_BswM_00217]. Según la especificación, la interacción se limita a recibir la señalización de shutdown del ComM [SWS_BswM_00217]; interpretación: el mensaje probablemente sirva en el BswM como detonante para acciones configuradas orientadas a llevar a cabo la desconexión o el reset. Pregunta Q-adf160d8d0fe2c97 (abierta)

Uso y contexto de llamada

De acuerdo con [SWS_BswM_00158], el Diagnostic Communication Manager (DCM) llama a la función BswM_Dcm_ApplicationUpdated para notificar al BswM la actualización correcta de una aplicación. El servicio está declarado en el archivo de cabecera BswM_Dcm.h y posee el Service-ID 0x14. La interfaz no espera parámetros de transferencia (void) y no devuelve ningún valor a quien la invoca.

Sincronía y concurrencia

Según [SWS_BswM_00158], la función está especificada como síncrona y reentrante. Por tanto, quien realiza la llamada permanece en el contexto de ejecución del DCM hasta que concluye el procesamiento inmediato de la llamada dentro del BswM. La propiedad declarada de reentrancia permite, en principio, acceder a la interfaz de forma concurrente desde diferentes contextos de tarea.

Tratamiento de errores e interacción

Para BswM_Dcm_ApplicationUpdated no se contemplan en [SWS_BswM_00158] códigos de error específicos ni notificaciones a DET o DEM. La llamada sirve meramente para notificar el estado a la gestión de modos de BSW. Es de prever que la notificación sirva en el BswM como indicador y disparador para la reevaluación de reglas internas, así como de cambios de modo posteriores, con el fin de adaptar el sistema global al software de aplicación modificado. Pregunta Q-119282a4a72622b5 (abierta)

usar

La función BswM_Dcm_CommunicationMode_CurrentState es llamada por el módulo Diagnostic Communication Manager (DCM) para poner en conocimiento del Basic Software Mode Manager (BswM) el estado actual del modo de comunicación [SWS_BswM_00048]. La declaración de esta interfaz se proporciona a través del archivo de cabecera BswM_Dcm.h [SWS_BswM_00048].

La sintaxis en C de la función es void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode) [SWS_BswM_00048]. Al ser llamada por el DCM, se transmiten dos parámetros de entrada [SWS_BswM_00048]:

• Network (tipo NetworkHandleType): designa el canal de comunicación al que hace referencia el modo de diagnóstico [SWS_BswM_00048].
• RequestedMode (tipo Dcm_CommunicationModeType): transmite el modo de comunicación de diagnóstico solicitado al BswM [SWS_BswM_00048].

La interfaz no posee ningún valor de retorno (tipo de retorno void) y no utiliza parámetros modificadores de entrada/salida (Inout) ni parámetros de salida (Out) [SWS_BswM_00048].

Concurrencia y propiedades

La llamada a la función se ejecuta de forma síncrona y está especificada como reentrante [SWS_BswM_00048]. El nombre del servicio se define como BswM_Dcm_CommunicationMode_CurrentState y posee el ID de servicio 0x06 en representación hexadecimal [SWS_BswM_00048].

Interacción

Interpretación: el BswM probablemente utilice el estado transmitido del modo de comunicación como criterio para la evaluación de reglas de modo, con el fin de activar acciones posteriores en el BswM [SWS_BswM_00048]. Pregunta Q-1031b1a7ae000c2a (abierta)

Uso y semántica

La función BswM_Deinit sirve para desinicializar el BSW Mode Manager ([SWS_BswM_00119]). La ejecución se realiza de forma síncrona sin parámetros de transferencia y sin valor de retorno con el Service-ID 0x04 ([SWS_BswM_00119]). La declaración está disponible a través del archivo de cabecera BswM.h ([SWS_BswM_00119]).

Concurrencia y restricciones

La interfaz está especificada como no reentrante (Non Reentrant) ([SWS_BswM_00119]). Por lo tanto, no se permite una llamada concurrente o de interrupción desde múltiples contextos de tareas. Interpretación: Es de prever que la desinicialización se realice típicamente de forma secuencial durante la fase de apagado de la ECU mediante una gestión de estado de nivel superior, como el ECU State Manager. Pregunta Q-0a5d218bfe9fed04 (abierta)

Interacción y comportamiento tras la desinicialización

Tras la llamada a BswM_Deinit, el módulo BswM ya no realiza ningún tipo de procesamiento de modo ([SWS_BswM_00120]). Esta supresión continúa aplicándose incluso si se presentan solicitudes de modo externas o internas al módulo o si la función principal cíclica del BswM se sigue ejecutando o llamando ([SWS_BswM_00120]).

La función de servicio síncrona BswM_EcuM_CurrentState es llamada por el módulo EcuM para indicar al BswM el modo de funcionamiento actual de la ECU [SWS_BswM_91003]. La interfaz posee el ID de servicio 0x28 y se pone a disposición a través del archivo de cabecera BswM_EcuM.h [SWS_BswM_91003].

usar

Al llamar a la función se comunica de forma síncrona al BswM el estado solicitado de la ECU [SWS_BswM_91003]. La transferencia se realiza a través de un único parámetro de entrada:

• Current State (in): transfiere el modo de funcionamiento solicitado de la ECU utilizando el tipo de datos EcuM_StateType [SWS_BswM_91003].

La función no define parámetros de entrada/salida (inout) ni parámetros de salida (out) y no posee ningún valor de retorno (void) [SWS_BswM_91003].

Concurrencia y restricciones

En cuanto al comportamiento frente a la concurrencia, BswM_EcuM_CurrentState se especifica como reentrante [SWS_BswM_91003]. Por lo tanto, las llamadas pueden realizarse concurrentemente sin restricciones, por ejemplo, cuando están activos distintos flujos de ejecución de la entidad invocadora [SWS_BswM_91003].

En el alcance de la especificación no se indican códigos de error específicos, notificaciones al módulo DET o DEM ni mecanismos especiales de tratamiento de errores para este servicio [SWS_BswM_91003].

La función BswM_EcuM_CurrentWakeup sirve como interfaz del BswM a la que llama el módulo EcuM para notificar el estado actual de una o varias fuentes de despertar [SWS_BswM_00131]. La declaración está disponible a través del archivo de cabecera BswM_EcuM.h [SWS_BswM_00131].

Al llamar a la función se transmiten los siguientes parámetros de transferencia [SWS_BswM_00131]:

• source (tipo EcuM_WakeupSourceType): designa la fuente o fuentes de despertar cuyo estado ha cambiado [SWS_BswM_00131].
• state (tipo EcuM_WakeupStatusType): indica el nuevo estado de la(s) fuente(s) de despertar afectada(s) [SWS_BswM_00131].

La función no posee ningún valor de retorno (void) y no contiene parámetros de entrada/salida ni exclusivamente de salida [SWS_BswM_00131]. El ID de servicio correspondiente es 0x10 [SWS_BswM_00131].

En cuanto al comportamiento de ejecución, la llamada a la función se especifica como síncrona [SWS_BswM_00131]. Además, la función está clasificada como reentrante, por lo que, en caso necesario, puede ser llamada de forma concurrente desde diferentes contextos [SWS_BswM_00131].

Uso y semántica

La función BswM_EcuM_RequestedState sirve como interfaz de notificación a la que llama el gestor de estados de la unidad de control (EcuM) para informar al módulo BswM sobre el estado actual del Run Request Protocol [SWS_BswM_91004]. La llamada se realiza de forma síncrona y está especificada como reentrante, de modo que la función puede ejecutarse en contextos concurrentes [SWS_BswM_91004]. La declaración se proporciona a través del archivo de cabecera BswM_EcuM.h con el ID de servicio 0x29 [SWS_BswM_91004].

Parámetros y valor de retorno

La interfaz no posee ningún valor de retorno (tipo de retorno void) y espera dos parámetros de entrada pura [SWS_BswM_91004]:

• State (tipo EcuM_StateType): indica el estado solicitado por el EcuM [SWS_BswM_91004].
• CurrentState (tipo EcuM_RunStatusType): transmite el resultado o el estado actual del Run Request Protocol [SWS_BswM_91004].

No se contemplan parámetros de entrada/salida ni parámetros de salida para esta función [SWS_BswM_91004].

Interacción e integración

La función es llamada exclusivamente por el EcuM. Interpretación: los estados transmitidos probablemente sirvan en el BswM para la evaluación interna de reglas y el control de modos, con el fin de desencadenar acciones de nivel superior del software básico [SWS_BswM_91004]. Pregunta Q-6cd81e44c9e2920a (abierta) Para este servicio no se han definido en la especificación códigos de error específicos para DET o DEM [SWS_BswM_91004].

usar

La función BswM_EthIf_PortGroupLinkStateChg es llamada conforme a [SWS_BswM_91001] por el módulo EthIf para indicar al BswM un cambio en el estado de conexión (Link State) de un grupo de puertos del conmutador Ethernet. La interfaz posee el Service-ID 0x26 y se proporciona a través del archivo de cabecera BswM_EthIf.h [SWS_BswM_91001].

La llamada transfiere dos parámetros de entrada:

• PortGroupIdx: designa el índice del grupo de puertos afectado en el contexto de la Ethernet Interface [SWS_BswM_91001].
• PortGroupState: indica el estado del grupo de puertos, el cual se deriva del enlace físico del transceptor Ethernet. Los estados válidos son ETHTRCV_LINK_STATE_DOWN para un enlace desconectado y ETHTRCV_LINK_STATE_ACTIVE para un enlace activo [SWS_BswM_91001].

La función no posee parámetros de entrada/salida ni parámetros de salida, y no devuelve ningún valor (void) [SWS_BswM_91001].

Concurrencia y restricciones

La ejecución se realiza de forma síncrona y está especificada como reentrante [SWS_BswM_91001]. Para esta interfaz no se han definido valores de retorno específicos, códigos de error ni mensajes de error (DET/DEM) [SWS_BswM_91001].

Interacción

Interpretación: el BswM probablemente utilice el estado de enlace transmitido como magnitud de entrada para evaluar reglas dependientes del estado y desencadenar acciones posteriores o cambios de modo dentro de la BSW. Pregunta Q-14285579acb760d5 (abierta)

La función BswM_EthSM_CurrentState sirve como interfaz de retrollamada y de notificación del BSW Mode Manager. De conformidad con [SWS_BswM_00050], es invocada por el Ethernet State Manager (EthSM) para transmitir el estado actual de un canal de comunicación al BswM. La declaración de la interfaz se proporciona mediante el encabezado BswM_EthSM.h y posee el ID de servicio 0x0d.

Para el uso y la llamada se aplican, según [SWS_BswM_00050], las siguientes especificaciones:

• Semántica de llamada: La ejecución se realiza de forma síncrona. Por consiguiente, la entidad invocadora espera hasta que la función haya concluido el procesamiento de la notificación de estado.
• Concurrencia: El servicio está especificado como reentrante [SWS_BswM_00050]. Por tanto, las llamadas pueden realizarse para distintas instancias de red o de manera concurrente desde el contexto del módulo EthSM.
• Parámetros de transferencia: Se transfieren la red Ethernet afectada como Network de tipo NetworkHandleType, así como el estado notificado como CurrentState de tipo EthSM_NetworkModeStateType. No se contemplan parámetros de entrada y salida (inout/out); el valor de retorno es void.

En la especificación de elementos [SWS_BswM_00050] no se definen valores de retorno específicos ni mensajes de error para DET o DEM. Interpretación: es de prever que el módulo BswM almacene internamente el estado de red notificado y lo utilice como condición para la evaluación de reglas configuradas, así como para la iniciación de cambios de modo. Pregunta Q-407156ff74cbab6f (abierta)

Uso y contexto de llamada

La función BswM_FrSM_CurrentState sirve como interfaz de retrollamada o notificación del BswM que es invocada por el FlexRay State Manager (FrSM) para notificar el estado actual de un clúster FlexRay [SWS_BswM_00051]. La declaración de la función se proporciona a través del archivo de encabezado BswM_FrSM.h [SWS_BswM_00051]. La llamada se realiza de forma síncrona y no devuelve ningún valor de retorno (void) [SWS_BswM_00051].

La interfaz define dos parámetros de entrada [SWS_BswM_00051]:

• Network (tipo NetworkHandleType): Indica el clúster FlexRay respectivo al que se refiere la notificación de estado [SWS_BswM_00051].
• CurrentState (tipo FrSM_BswM_StateType): Transmite el estado actual del clúster FlexRay en cuestión al BswM [SWS_BswM_00051].

No existen parámetros de salida (out) ni de entrada/salida (inout) para esta función [SWS_BswM_00051].

Concurrencia y tratamiento de errores

La función está especificada con el ID de servicio 0x0c y caracterizada como reentrante [SWS_BswM_00051]. En la especificación para este servicio no se indican códigos de error específicos, comportamientos en caso de error ni notificaciones a la gestión de errores de desarrollo (DET) o a la gestión de eventos de diagnóstico (DEM) [SWS_BswM_00051].

La función síncrona BswM_Init sirve para la inicialización del Basic Software Mode Manager (BswM) según la especificación [SWS_BswM_00002]. Se declara a través del archivo de cabecera BswM.h y posee el ID de servicio 0x00 [SWS_BswM_00002].

Parámetros y valores de retorno

A la función se le pasa mediante el único parámetro de entrada ConfigPtr un puntero a los datos de configuración post-build de tipo BswM_ConfigType [SWS_BswM_00002]. No existen parámetros de salida ni de entrada/salida, y no se devuelve ningún valor de retorno [SWS_BswM_00002].

Concurrencia y contexto de ejecución

La ejecución es síncrona. El comportamiento del módulo respecto a la reentrancia se especifica como condicionalmente reentrante (Conditionally Reentrant) [SWS_BswM_00002]. Como interpretación, esto probablemente signifique que las llamadas simultáneas solo están permitidas bajo condiciones especiales del sistema, como áreas de datos separadas. Pregunta Q-c0063b2a12eb4f41 (abierta) Además, la llamada probablemente se realice en el marco de la inicialización del sistema, antes de que se ejecuten otras operaciones del BswM.

La función de servicio síncrona BswM_J1939DcmBroadcastStatus (Service-ID 0x1b) transmite al BSW Mode Manager el estado de comunicación deseado de las redes disponibles [SWS_BswM_00165]. El estado notificado se hace efectivo en el sistema típicamente mediante la conmutación de grupos de COM-I-PDU (COM I-PDU group switches) [SWS_BswM_00165]. La interfaz se proporciona a través de la cabecera BswM_J1939Dcm.h [SWS_BswM_00165].

Los parámetros y la semántica están especificados de la siguiente manera [SWS_BswM_00165]:

• Parámetros de transferencia: A través del parámetro NetworkMask se transfiere una máscara de bits que incluye un bit por cada red disponible. La posición de cada bit corresponde al identificador de canal de comunicación ComMChannel.ComMChannelId, de modo que el ID de canal 0 se asigna al bit 0.
• Significado de los bits: El valor 1 señala que la red está habilitada (Network enabled), mientras que 0 indica una red deshabilitada (Network disabled).
• Valor de retorno: La función no posee valor de retorno (void).

Concurrencia y restricciones: La llamada está diseñada como reentrante y opera de forma síncrona [SWS_BswM_00165]. Puesto que el parámetro NetworkMask está definido como un valor de 16 bits, por diseño solo se pueden direccionar a través de esta API los primeros 16 IDs de canal de comunicación [SWS_BswM_00165]. No se han especificado códigos de error específicos ni notificaciones de DET o DEM para esta función [SWS_BswM_00165].

usar

La función BswM_J1939Nm_StateChangeNotification sirve para la notificación síncrona al BSW Mode Manager sobre el estado actual de un nodo de red J1939 tras producirse un cambio de estado [SWS_BswM_00194]. La declaración está disponible a través del archivo de cabecera BswM_J1939Nm.h y se gestiona con el Service-ID 0x18 [SWS_BswM_00194].

La interfaz espera tres parámetros de entrada y no devuelve ningún valor de retorno (void) [SWS_BswM_00194]:

• Network (NetworkHandleType): Identifica el canal J1939 afectado [SWS_BswM_00194].
• Node (uint8): Identificación numérica del nodo J1939 en cuestión [SWS_BswM_00194].
• NmState (Nm_StateType): Representa el estado actual o recién adoptado del nodo [SWS_BswM_00194].

Concurrencia y contexto de llamada

El procesamiento se realiza de forma síncrona y está especificado como reentrante [SWS_BswM_00194]. Por lo tanto, en sistemas con varios nodos o canales, la notificación también puede realizarse de forma concurrente. Es de prever que quien realiza la llamada sea el módulo J1939Nm, el cual informa al BswM sobre el nuevo estado tras transiciones de estado internas. Pregunta Q-9c0e521db5e51713 (abierta)

Manejo de errores

La especificación no define para este servicio códigos de error específicos ni notificaciones a DET o DEM [SWS_BswM_00194]. Además, no existen parámetros de salida ni parámetros de entrada/salida para la indicación de errores [SWS_BswM_00194].

La función BswM_LinSM_CurrentSchedule sirve como interfaz de notificación invocada por el LIN State Manager (Lin SM) para indicar al BswM la Schedule Table actualmente activa para un determinado canal LIN ([SWS_BswM_00058]). El servicio está disponible a través del encabezado BswM_LinSM.h y posee el ID de servicio 0x0a ([SWS_BswM_00058]).

En la llamada se transfieren dos parámetros de entrada ([SWS_BswM_00058]):

• Network (tipo NetworkHandleType): Designa el canal LIN concreto en el que ha tenido lugar el cambio de la Schedule Table ([SWS_BswM_00058]).
• Current Schedule (tipo LinIf_SchHandleType): Transfiere el identificador de la Schedule Table que ahora está activa en dicho canal LIN ([SWS_BswM_00058]).

La interfaz no posee parámetros de entrada/salida ni de salida, y no devuelve ningún valor de retorno (void) ([SWS_BswM_00058]). El comportamiento de ejecución está definido como síncrono (Synchronous), y la función está especificada como reentrante (Reentrant) ([SWS_BswM_00058]).

En la especificación no se indican códigos de error específicos, respuestas ante fallos ni notificaciones a DET o DEM para este servicio ([SWS_BswM_00058]). Interpretación: es de prever que la llamada se produzca típicamente de forma inmediata tras un cambio de tabla completado en el Lin SM, para informar de manera síncrona sobre el cambio a la evaluación de estados en el BswM. Pregunta Q-302196d84e739258 (abierta)

Uso y contexto de llamada

La función síncrona BswM_LinSM_CurrentState es invocada por el LIN State Manager (LinSM) para comunicar al BswM un cambio de estado de un canal LIN [SWS_BswM_00052]. Está definida en el módulo BswM, posee el ID de servicio 0x09 y se declara a través del archivo de encabezado BswM_LinSM.h para el LinSM [SWS_BswM_00052].

Parámetros y valores de retorno

La interfaz no posee ningún valor de retorno (void) ni tampoco parámetros de entrada/salida o de salida [SWS_BswM_00052]. Para la señalización se transfieren dos parámetros de entrada:

• Network (tipo NetworkHandleType): Indica el canal LIN al que se refiere la indicación de estado notificada [SWS_BswM_00052].
• CurrentState (tipo LinSM_ModeType): Contiene el estado adoptado actualmente del canal LIN indicado [SWS_BswM_00052].

Concurrencia e integración de módulos

Según la especificación, la función está implementada como reentrante [SWS_BswM_00052]. Esto permite la invocación paralela para diferentes redes LIN sin bloqueo mutuo. Interpretación: el estado de canal transmitido probablemente se utilice en el BswM como variable de entrada para evaluaciones de reglas y listas de acciones, con el fin de controlar las transiciones de modo basadas en ello en toda la ECU. Pregunta Q-ca113e4b71e4ab75 (abierta)

Uso y contexto de llamada

El Lin TP invoca la función síncrona BswM_LinTp_RequestMode para solicitar un cambio de modo para un canal LIN determinado [SWS_BswM_00156]. La declaración se realiza a través de la cabecera BswM_LinTp.h con el Service-ID 0x0b [SWS_BswM_00156]. Se transfieren como parámetros de entrada:

• Network (tipo NetworkHandleType): Designa el canal LIN afectado al que se refiere la solicitud de modo [SWS_BswM_00156].
• LinTp_Mode (transferido como LinTp_Mode Lin Tp RequestedMode): Determina el modo TP solicitado, el cual se correlaciona directamente con la tabla de planificación LIN que debe utilizarse [SWS_BswM_00156].

La función no posee valor de retorno (void) [SWS_BswM_00156]. En la definición de la función no se contemplan códigos de error específicos, valores de retorno para el tratamiento de errores ni notificaciones de DET [SWS_BswM_00156].

Concurrencia y gestión de modos

La interfaz está especificada como reentrante [SWS_BswM_00156]. Esto permite una llamada paralela desde diferentes contextos o para canales LIN independientes. Dado que el modo solicitado influye en la selección de la tabla de planificación, la función sirve como interfaz específica de modo entre Lin TP y el BSW Mode Manager [SWS_BswM_00156]. Interpretación: Sobre la base de la solicitud, es probable que el BswM realice evaluaciones internas para iniciar el cambio de la tabla de planificación LIN. Pregunta Q-544460b6b32b6ac2 (abierta)

Uso y contexto de llamada

La función BswM_Nm_CarWakeUpIndication sirve como interfaz de callback del Basic Software Mode Manager (BswM) y es llamada por el Network Management (Nm) para indicar un evento de Car-Wakeup relativo a un canal [SWS_BswM_00235]. La llamada se realiza de forma síncrona y transfiere, mediante el parámetro de entrada Network de tipo NetworkHandleType, la identificación del canal de Nm afectado [SWS_BswM_00235]. La interfaz no declara ningún valor de retorno (void) y no proporciona parámetros de salida [SWS_BswM_00235]. El servicio está definido con el Service-ID 0x24 en el archivo de cabecera BswM_Nm.h [SWS_BswM_00235].

Concurrencia y tratamiento de errores

La interfaz está especificada como reentrante, por lo que se permiten llamadas paralelas [SWS_BswM_00235]. En la especificación del elemento no se indican códigos de error específicos, notificaciones al DET o DEM ni mecanismos especiales de tratamiento de errores [SWS_BswM_00235].

Interacción

Como punto de integración entre el Nm y el BswM, la función reenvía la señal de reactivación directamente al procesamiento del BswM [SWS_BswM_00235]. Interpretación: la llamada probablemente se evalúe dentro del BswM como indicador para verificaciones de reglas o cambios de modo en el marco del arranque de la red. Pregunta Q-e56d5cfb6345f1ba (abierta)

Uso y contexto de llamada

La función BswM_Nm_StateChangeNotification sirve como interfaz de notificación para transmitir al BswM el estado actual de un canal de Network Management tras producirse cambios de estado [SWS_BswM_91002]. Está declarada en el archivo de cabecera BswM_Nm.h y definida bajo el Service-ID 0x27 [SWS_BswM_91002]. La ejecución se realiza de forma síncrona y la función no tiene valor de retorno (void) [SWS_BswM_91002].

La transferencia de los datos de estado se realiza a través de dos parámetros de entrada puros; no existen parámetros de entrada/salida ni de salida [SWS_BswM_91002]:

• Network (tipo: NetworkHandleType): designa el canal de Nm afectado para la identificación de la red [SWS_BswM_91002].
• currentState (tipo: Nm_StateType): señaliza el estado actual o nuevo del canal de Nm indicado [SWS_BswM_91002].

Concurrencia y comportamiento

La interfaz está clasificada como reentrante [SWS_BswM_91002]. Con ello, la función puede llamarse de forma concurrente, lo cual resulta relevante en particular ante transiciones de estado simultáneas en diferentes canales de red. Puesto que la llamada está especificada como síncrona, la función no regresa al llamador hasta después de la recepción interna del cambio de estado [SWS_BswM_91002]. Por lo general, la llamada probablemente la efectúe el Network Management en cuanto un canal haya adoptado un nuevo estado [SWS_BswM_91002]. Pregunta Q-8645d9511a825fed (abierta)

usar

El NVRAM Manager (NvM) llama a la función BswM_NvM_CurrentBlockMode para indicar al Basic Software Mode Manager (BswM) el modo de bloque actual de un bloque NVRAM [SWS_BswM_00104]. La declaración de la función está disponible a través del archivo de cabecera BswM_NvM.h y está asignada en la especificación al Service-ID 0x16 [SWS_BswM_00104].

Parámetros y valores de retorno

La función no devuelve ningún valor de retorno (void) a quien la invoca y procesa dos parámetros de entrada [SWS_BswM_00104]:

• Block (tipo NvM_BlockIdType): Transfiere el identificador de bloque del bloque NVRAM al que se refiere la nueva información de modo [SWS_BswM_00104].
• CurrentBlockMode (tipo NvM_RequestResultType): Transmite el modo de bloque actual o el resultado de la petición del bloque NvM [SWS_BswM_00104].

Para esta interfaz no se han definido parámetros de salida ni parámetros combinados de entrada/salida [SWS_BswM_00104].

Concurrencia y restricciones

La llamada a la función BswM_NvM_CurrentBlockMode se ejecuta de forma síncrona y está especificada como reentrante [SWS_BswM_00104]. Por lo tanto, la interfaz está diseñada para un uso reentrante en contextos de ejecución concurrentes [SWS_BswM_00104].

Manejo de errores

En los requisitos de la especificación para esta interfaz no se indican códigos de error específicos ni requisitos para notificaciones de error a través del Default Error Tracer (DET) o del módulo Diagnostic Event Manager (DEM) [SWS_BswM_00104].

Uso y signatura

El NVRAM Manager (NvM) invoca la función BswM_NvM_CurrentJobMode para informar al BSW Mode Manager (BswM) sobre el estado actual de un trabajo multibloque [SWS_BswM_00152]. La interfaz está declarada en la cabecera BswM_NvM.h y posee el Service-ID 0x17 [SWS_BswM_00152]. Recibe dos parámetros de entrada:

• MultiBlockRequest (tipo NvM_MultiBlockRequestType): Indica a qué trabajo multibloque concreto se refiere este callback [SWS_BswM_00152].
• CurrentJobMode (tipo NvM_RequestResultType): Indica el estado actual o el resultado del trabajo multibloque correspondiente [SWS_BswM_00152].

La función no devuelve ningún valor (tipo de retorno void) y no dispone de parámetros de entrada/salida ni de salida [SWS_BswM_00152].

Concurrencia y tratamiento de errores

La especificación define BswM_NvM_CurrentJobMode como síncrona y reentrante [SWS_BswM_00152]. La llamada se produce directamente desde el contexto de ejecución del módulo NvM. Como interpretación, es de prever que esta llamada se desencadene típicamente en el transcurso de operaciones colectivas, como procesos de lectura o escritura, tan pronto como haya un cambio de estado. Pregunta Q-25514d3dbf1d8c5c (abierta)

Para esta función no se recogen en la especificación valores de retorno ni códigos de error específicos para errores de desarrollo (DET) o de producción; el comportamiento en caso de error no se indica de forma separada [SWS_BswM_00152].

La función BswM_RequestMode proporciona una llamada a función genérica para la solicitud de modos en el Basic Software Mode Manager (BswM) [SWS_BswM_00046]. Está declarada a través del archivo de encabezado BswM.h y posee el ID de servicio 0x02 [SWS_BswM_00046].

Uso y restricciones

El uso está estrictamente reglamentado: la función solo puede ser invocada por otros módulos BSW que no dispongan de una interfaz propia y específica de módulo para la solicitud de modos [SWS_BswM_00046]. Por consiguiente, los módulos BSW con interfaces dedicadas no deben utilizar este servicio genérico.

Parámetros y semántica

La firma de la función es void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode) [SWS_BswM_00046]. Se transfieren dos parámetros de entrada:

• requesting_user: Identifica al usuario solicitante o al módulo de software solicitante [SWS_BswM_00046].
• requested_mode: Transfiere el estado o modo solicitado de forma concreta [SWS_BswM_00046].

No existen parámetros de entrada/salida ni de salida, y la función no posee ningún valor de retorno (void) [SWS_BswM_00046].

concurrencia

La llamada se procesa de forma síncrona y está especificada como reentrante [SWS_BswM_00046]. Por tanto, la función es apta para llamadas concurrentes desde múltiples contextos de BSW.

Uso y contexto de llamada

La función BswM_Sd_ClientServiceCurrentState es llamada por Service Discovery (SD) para informar de forma síncrona al BswM sobre el estado actual de un servicio cliente [SWS_BswM_00204]. A través de esta interfaz se señala si el servicio correspondiente está operativo (available) o no disponible (down) [SWS_BswM_00204]. La declaración de la función C se proporciona mediante la cabecera BswM_Sd.h [SWS_BswM_00204].

Parámetros y signatura de la interfaz

La interfaz posee el Service-ID 0x1f y espera dos parámetros de entrada [SWS_BswM_00204]:

• SdClientServiceHandleId (tipo uint16): Handle ID unívoco para la identificación del servicio cliente [SWS_BswM_00204].
• CurrentClientState (tipo Sd_ClientServiceCurrentStateType): Estado de disponibilidad actual del servicio [SWS_BswM_00204].

La función no devuelve ningún valor de retorno (void) y no define parámetros de entrada/salida ni de salida [SWS_BswM_00204].

Concurrencia e interacción

La ejecución de BswM_Sd_ClientServiceCurrentState es síncrona y reentrante [SWS_BswM_00204]. Por lo tanto, los llamadores no necesitan forzar una serialización secuencial, sino que pueden notificar cambios de estado de forma concurrente. En la interacción global, es de suponer que la notificación de estado se utilice probablemente para la evaluación interna de reglas y la iniciación de cambios de modo configurados dentro del BswM. Pregunta Q-0490a3902ca9e78d (abierta)

La función BswM_Sd_ConsumedEventGroupCurrentState sirve como interfaz de callback invocada por Service Discovery para indicar al Basic Software Mode Manager (BswM) el estado actual de un grupo de eventos consumido [SWS_BswM_00207]. Informa al BswM sobre si el grupo de eventos correspondiente está disponible (available) o caído (down) en la red [SWS_BswM_00207].

Uso y signatura

La interfaz posee el Service-ID 0x21 y se proporciona a través del archivo de cabecera BswM_Sd.h [SWS_BswM_00207]. La llamada se procesa de forma síncrona y no posee valor de retorno (void) [SWS_BswM_00207]. En la llamada a la función, Service Discovery transfiere dos parámetros de entrada, mientras que no se definen parámetros de entrada/salida ni exclusivamente de salida [SWS_BswM_00207]:

• Sd Consumed Event Group Handle Id (tipo de datos uint16): Handle ID unívoco para la identificación del respectivo grupo de eventos consumido [SWS_BswM_00207].
• Consumed Event Group State (tipo de datos Sd_Consumed Event Group Current State Type): Estado actual del grupo de eventos consumido para indicar la disponibilidad [SWS_BswM_00207].

Concurrencia y tratamiento de errores

De acuerdo con la especificación, la función está marcada como reentrante y, por tanto, puede llamarse de forma concurrente si es necesario [SWS_BswM_00207]. Para este servicio no se indican en la especificación códigos de error específicos, excepciones o notificaciones al rastreo de errores de desarrollo (DET) o a la gestión de eventos de diagnóstico (DEM) [SWS_BswM_00207].

Uso y contexto de llamada

La función síncrona BswM_Sd_EventHandlerCurrentState sirve como interfaz que Service Discovery invoca para comunicar al BSW Mode Manager (BswM) el estado actual de un Event Handler [SWS_BswM_00210]. Los estados típicos del Event Handler comprenden la información de si este ha sido solicitado o liberado [SWS_BswM_00210]. La declaración de la función se proporciona a través del archivo de cabecera BswM_Sd.h [SWS_BswM_00210].

Parámetros y propiedades de la signatura

La función no devuelve ningún valor de retorno (void) y espera dos parámetros de entrada al ser llamada [SWS_BswM_00210]:

• SdEventHandlerHandleId: Identificador de tipo uint16 que direcciona unívocamente el Event Handler correspondiente [SWS_BswM_00210].
• EventHandlerStatus: Información de estado de tipo Sd_EventHandlerCurrentStateType que representa el estado actual del Event Handler [SWS_BswM_00210].

Concurrencia y tratamiento de errores

La función se gestiona bajo el Service-ID 0x20 y, según la especificación, está implementada como reentrante [SWS_BswM_00210]. Para esta interfaz no se han definido códigos de error específicos, parámetros de entrada/salida ni notificaciones de error explícitas a través de DET o DEM [SWS_BswM_00210].

El Watchdog Manager (WdgM) invoca la función BswM_WdgM_RequestPartitionReset para solicitar al Basic Software Mode Manager (BswM) el restablecimiento de una partición determinada [SWS_BswM_00157]. La declaración de esta interfaz se pone a disposición a través de la cabecera BswM_WdgM.h y está asignada al Service-ID 0x11 [SWS_BswM_00157].

Para el uso y el contexto de llamada se aplican las siguientes determinaciones de la especificación:

• Parámetros: Como parámetro de entrada se transfiere Application de tipo ApplicationType, el cual representa el identificador unívoco de la OS-Application correspondiente [SWS_BswM_00157]. No existen más parámetros de entrada o de salida para esta llamada [SWS_BswM_00157].
• Valor de retorno: La función no posee valor de retorno (tipo de retorno void) [SWS_BswM_00157].
• Sincronicidad y concurrencia: La ejecución de la función se realiza de forma síncrona y está especificada como reentrante, por lo que se permiten llamadas paralelas [SWS_BswM_00157].
• Tratamiento de errores: En la especificación de este elemento no están documentados códigos de error específicos, reacciones ante errores ni notificaciones a DET o DEM [SWS_BswM_00157].

En la interacción de los módulos de software básico, la función constituye la interfaz de notificación directa a través de la cual el WdgM informa de forma síncrona al BswM sobre un reinicio de partición requerido para la OS-Application transferida [SWS_BswM_00157].

La función BswM_MainFunction constituye la función principal periódica central del gestor de modos del BSW (BswM) ([SWS_BswM_00053]). Posee el ID de servicio 0x03, no recibe parámetros de transferencia y no devuelve ningún valor de retorno (signatura: void BswM_MainFunction(void)). Su declaración se proporciona a través del archivo de cabecera SchM_BswM.h ([SWS_BswM_00053]). Debido a su suministro a través de SchM_BswM.h, la llamada en la ECU probablemente se realice de forma cíclica mediante el Schedule Manager (SchM) en el contexto de una tarea periódica del sistema operativo. Pregunta Q-fdb948e42c35d9fb (abierta)

En cuanto a la interacción y a la lógica de procesamiento, BswM_MainFunction es responsable de evaluar las peticiones de modo diferidas: la función debe evaluar obligatoriamente todas las reglas que utilicen como entrada al menos una petición de modo (Mode Request) con el parámetro de configuración BswMRequestProcessing establecido en el valor BSWM_DEFERRED ([SWS_BswM_00075]).

Para la incorporación e integración práctica en el sistema de Basic Software se derivan de ello las siguientes condiciones de contorno:

• Contexto de llamada y planificación (scheduling): la función no posee parámetros ni valores de retorno ([SWS_BswM_00053]); está prevista para su integración recurrente en el plan de ejecución cíclico del planificador de Basic Software.
• Procesamiento de reglas: las peticiones de modo que no se procesan inmediatamente, sino que están configuradas en BSWM_DEFERRED, se desacoplan temporalmente y solo se procesan conjuntamente en el ciclo de ejecución de esta función principal ([SWS_BswM_00075]).

usar

La función callout definida por el usuario es llamada por el BSW Mode Manager en cuanto se ejecuta una acción BswMUserCallout correspondiente [SWS_BswM_00270]. El nombre de función concreto, así como todos los parámetros de transferencia, se determinan a través del parámetro de configuración BswMUserCalloutFunction [SWS_BswM_00270]. La sintaxis está definida de forma genérica como void <BswMUserCalloutFunction>(implementation_specific), ignorando el BswM por completo cualquier posible valor de retorno [SWS_BswM_00270].

Concurrencia y restricciones

Tanto el comportamiento de ejecución (síncrono o asíncrono) como la reentrancia de la función callout están especificados como dependientes de la configuración [SWS_BswM_00270]. El contexto de llamada real depende probablemente del evento desencadenante de BswM o de la tarea en la que se procese la acción de BswM. Pregunta Q-2f3e2cdbb9de1794 (abierta) Por lo tanto, los desarrolladores deben asegurarse de que la implementación cumpla con los requisitos del contexto de ejecución elegido en lo que respecta a la seguridad de hilos (thread safety) y al comportamiento de bloqueo.

Tratamiento de errores y configuración

La especificación no define mensajes de error específicos de DET o DEM para este servicio (Service-ID 0x25) [SWS_BswM_00270]. Puesto que el BswM ignora eventuales valores de retorno, la función no puede notificar errores al BswM mediante valores de retorno estandarizados. La disponibilidad y vinculación de la función se realiza a través de la configuración del módulo (referencia ECUC_BswM_00954) [SWS_BswM_00270].

Uso y definición de tipo

El tipo de datos BswM_ModeType sirve en el módulo BswM para la identificación unívoca de aquellos modos que pueden ser solicitados por los usuarios de BswM (BswM Users) [SWS_BswM_00214]. Según la especificación, el tipo se deriva del tipo primitivo básico uint16 y abarca un rango de valores de 0 a 65535 [SWS_BswM_00214]. Se declara y proporciona a través del archivo de cabecera BswM.h, el cual debe ser incluido por los componentes solicitantes para su uso [SWS_BswM_00214].

Restricciones y suposiciones

Las entidades de software invocadoras transfieren valores de modo como enteros de 16 bits dentro de los límites de 0 a 65535 [SWS_BswM_00214]. Dado que la especificación no enumera constantes simbólicas fijas, la asignación concreta de valores enteros individuales a modos específicos de la aplicación probablemente se defina en el marco de la configuración del módulo BswM. Pregunta Q-94530792144d42ea (abierta) Para un uso sin errores, se debe garantizar que los solicitantes utilicen exclusivamente valores dentro del rango de valores definido [SWS_BswM_00214].

Integración en el stack BSW

Las interfaces que reenvían solicitudes de modo de usuarios al BswM utilizan BswM_ModeType para la transferencia tipada de los identificadores de modo [SWS_BswM_00214]. La provisión a través de BswM.h garantiza además un tipado uniforme a través de diferentes límites de módulos BSW [SWS_BswM_00214].

Uso y definición de tipo

El tipo de datos BswM_UserType se proporciona a través del archivo de cabecera BswM.h y sirve para la identificación unívoca de un usuario de BswM que dirige solicitudes de modo al Basic Software Mode Manager [SWS_BswM_00216]. El tipo se deriva del tipo entero básico uint16 y abarca un rango de valores de 0 a 65535 [SWS_BswM_00216].

Interacción e integración

En la arquitectura de software, este tipo probablemente funcione de forma primaria como parámetro de transferencia en interfaces de solicitud de modo, con el fin de que el BswM pueda asignar la solicitud entrante a la fuente respectiva. Pregunta Q-83bb1af3fb090e7e (abierta) Gracias a su ancho de 16 bits, la definición de tipo ofrece espacio para hasta 65536 identificadores de usuario diferentes en el sistema [SWS_BswM_00216]. Los valores de instancia concretos de los usuarios probablemente se generen de manera específica para la configuración en el marco de la generación de la BSW.

Restricciones y tratamiento de errores

Al tratarse de una definición de tipo elemental, en el alcance de la especificación no se han definido códigos de error específicos, mensajes DET ni mecanismos de concurrencia para este tipo. Los módulos de software solicitantes deben garantizar que en las llamadas se transfieran exclusivamente valores dentro del rango admisible de 0 a 65535 [SWS_BswM_00216].