PWM Driver (Pwm)

La función síncrona Pwm_Init sirve como servicio central para la inicialización de todo el controlador PWM ([SWS_Pwm_00095]). Se proporciona a través del archivo de cabecera Pwm.h y tiene el Service-ID hexadecimal 0x00 ([SWS_Pwm_00095]). Como único parámetro de entrada se transfiere ConfigPtr, que actúa como puntero al conjunto de configuración específico del controlador de tipo Pwm_ConfigType ([SWS_Pwm_00095]). La interfaz no tiene valor de retorno y no utiliza parámetros de salida ni parámetros de entrada/salida ([SWS_Pwm_00095]).

En lo relativo al comportamiento en tiempo de ejecución, Pwm_Init es síncrona y está especificada como no reentrante (Non Reentrant) ([SWS_Pwm_00095]). Por lo tanto, una invocación simultánea o interruptiva de esta función desde varios subprocesos, tareas o rutinas de interrupción es estrictamente inadmisible. Es de prever que la ejecución se realice típicamente una sola vez durante el arranque del sistema, en la fase de inicialización de la ECU, antes del uso posterior de los canales PWM. Pregunta Q-ff3f1cf769dfed70 (abierta)

Para asegurar el orden de invocación admisible, el módulo supervisa su estado: si se invoca el servicio Pwm_Init cuando el controlador PWM ya está inicializado, el módulo notifica el error de desarrollo PWM_E_ALREADY_INITIALIZED con el identificador 0x14 ([SWS_Pwm_50002]). Por consiguiente, una inicialización reiterada se considera un error.

Uso y signatura

La función Pwm_DeInit sirve como servicio para la desinicialización del controlador de PWM ([SWS_Pwm_00096]). Se proporciona a través del archivo de cabecera Pwm.h y lleva el ID de servicio 0x01 ([SWS_Pwm_00096]). La interfaz posee la firma void Pwm_DeInit(void), no recibe parámetros de entrada ni de salida y no devuelve ningún valor al llamador ([SWS_Pwm_00096]).

La llamada a Pwm_DeInit se ejecuta de forma síncrona ([SWS_Pwm_00096]). Por lo tanto, el flujo de control llamador permanece en la función hasta que concluyen los pasos de desinicialización del módulo PWM.

Concurrencia y restricciones

Para la ejecución se aplican las siguientes condiciones marco relativas a la concurrencia:

• No reentrante: El servicio está especificado como no reentrante ([SWS_Pwm_00096]). No está permitida una llamada simultánea o con interrupción desde múltiples hilos, tareas o ISR.
• Contexto de llamada: Debido a la semántica síncrona y a la falta de reentrancia, la llamada debería realizarse típicamente en el marco de una fase de parada controlada a nivel de tarea. Pregunta Q-f1afc58637cba5cf (abierta)

Manejo de errores

En la especificación de Pwm_DeInit no se definen valores de retorno ni códigos de error específicos ([SWS_Pwm_00096]). Cualquier posible error de tiempo de ejecución o de estado probablemente se registre o intercepte a través de mecanismos de monitorización internos del módulo, como la interfaz de desarrollo (DET), ya que no está prevista una notificación de errores directa a través de la interfaz de la función. Pregunta (abierta)

La función Pwm_DisableNotification sirve para desactivar la notificación de flancos (Signal Edge Notification) de un canal PWM determinado [SWS_Pwm_91003]. La declaración de la función y las definiciones de tipos asociadas se ponen a disposición a través del archivo de cabecera Pwm.h [SWS_Pwm_91003].

Parámetros y valor de retorno

La interfaz posee el Service-ID 0x06 y presenta las siguientes características de firma [SWS_Pwm_91003]:

• ChannelNumber (in): Identificador numérico del canal PWM a configurar del tipo Pwm_ChannelType [SWS_Pwm_91003].

No existen parámetros de entrada/salida (inout) ni parámetros de solo salida (out) [SWS_Pwm_91003]. La función no devuelve ningún valor de retorno (void) al llamador [SWS_Pwm_91003].

Comportamiento de sincronización y concurrencia

La llamada a Pwm_DisableNotification opera de forma asíncrona [SWS_Pwm_91003]. En lo relativo al comportamiento multihilo, el servicio es reentrante siempre que se direccionen números de canal diferentes [SWS_Pwm_91003].

Interpretación: Dado que la reentrancia está limitada explícitamente a diferentes canales, la función probablemente no sea reentrante para el mismo canal PWM [SWS_Pwm_91003]. Pregunta Q-005e97fd25679da7 (abierta) Por lo tanto, es probable que las llamadas simultáneas para el canal idéntico deban sincronizarse entre sí por parte del llamador.

usar

La función Pwm_EnableNotification sirve para activar notificaciones de flanco de señal para un canal PWM determinado de acuerdo con el parámetro de notificación transferido [SWS_Pwm_91004]. El servicio se proporciona a través del archivo de cabecera Pwm.h, posee el Service-ID 0x07 y no devuelve ningún valor de retorno (void) al llamador [SWS_Pwm_91004].

Al llamar a la interfaz deben transferirse dos parámetros de entrada obligatorios [SWS_Pwm_91004]:

• ChannelNumber (de tipo Pwm_ChannelType): identificador numérico del canal PWM que se va a direccionar [SWS_Pwm_91004].
• Notification (de tipo Pwm_EdgeNotificationType): define el tipo de notificación de flanco con los valores admisibles PWM_RISING_EDGE, PWM_FALLING_EDGE o PWM_BOTH_EDGES [SWS_Pwm_91004].

Semántica y concurrencia

La ejecución del servicio está especificada como asíncrona [SWS_Pwm_91004]. En cuanto a la concurrencia, Pwm_EnableNotification está diseñado como reentrante para números de canal distintos [SWS_Pwm_91004]. En caso de acceso simultáneo o interruptivo al mismo canal PWM, se presume que el servicio no es reentrante; por lo tanto, dicho acceso debe asegurarse del lado del llamador. Pregunta Q-73309ed8589161a3 (abierta)

Tratamiento de errores y condiciones límite

El extracto de la especificación no define para esta función valores de retorno específicos ni mensajes de error para el Development Error Tracer (DET) o el Diagnostic Event Manager (DEM) [SWS_Pwm_91004]. Asimismo, faltan directrices sobre contextos de llamada admisibles o secuencias relativas a tareas. Dado que no se indican condiciones previas, la llamada a la función probablemente solo sea admisible tras una inicialización correcta del controlador PWM. Pregunta Q-7f428f59a20175c2 (abierta)

La función síncrona Pwm_SetPowerState pone el módulo PWM en un estado previamente preparado a partir de una selección preconfigurada de Power-States [SWS_Pwm_00166]. La declaración está disponible a través de la cabecera Pwm.h [SWS_Pwm_00166].

Uso y valores de retorno

La función no recibe parámetros de entrada y transfiere el resultado detallado a través del parámetro de puntero Result de tipo Pwm_PowerStateRequestResultType* [SWS_Pwm_00166]:

• Si el modo se pudo cambiar correctamente, la función devuelve E_OK y establece Result en PWM_SERVICE_ACCEPTED [SWS_Pwm_00166].
• Si la solicitud es rechazada, la llamada devuelve E_NOT_OK [SWS_Pwm_00166].

Manejo de errores

En caso de error (valor de retorno E_NOT_OK), Result especifica la causa del fallo [SWS_Pwm_00166]:

• PWM_NOT_INIT: el módulo PWM no está inicializado [SWS_Pwm_00166].
• PWM_SEQUENCE_ERROR: existe una secuencia de llamada a la API no admisible [SWS_Pwm_00166].
• PWM_HW_FAILURE: un error en el módulo de hardware impide la entrada en el Power-State solicitado [SWS_Pwm_00166].

Concurrencia y condiciones de contorno

Pwm_SetPowerState no es reentrante (Non Reentrant) y, para evitar un error de secuencia, requiere que el estado de destino se haya preparado antes de la llamada [SWS_Pwm_00166].

usar

La función síncrona Pwm_PreparePowerState inicia el proceso de preparación necesario para que el módulo de hardware PWM pueda cambiar a un estado de energía solicitado [SWS_Pwm_00183]. El estado de destino deseado se transfiere a través del parámetro PowerState, mientras que el resultado detallado se proporciona a través del puntero de salida Result [SWS_Pwm_00183]. Si la preparación se inició con éxito, la función devuelve E_OK y establece Result en PWM_SERVICE_ACCEPTED [SWS_Pwm_00183].

Manejo de errores

Si se rechaza el servicio, la función devuelve E_NOT_OK y notifica la causa específica a través de Result [SWS_Pwm_00183]:

• PWM_NOT_INIT: el módulo PWM no está inicializado [SWS_Pwm_00183].
• PWM_SEQUENCE_ERROR: secuencia de llamada no admisible, ya que el estado de energía actual ya coincide con el estado de destino [SWS_Pwm_00183].
• PWM_POWER_STATE_NOT_SUPP: el módulo no admite el estado de energía solicitado [SWS_Pwm_00183].
• PWM_TRANS_NOT_POSSIBLE: No es posible una transición directa o el periférico de hardware todavía está ocupado [SWS_Pwm_00183].

Concurrencia e interacción

La función no es reentrante (Non Reentrant) y, por tanto, no debe llamarse de forma concurrente para el mismo módulo [SWS_Pwm_00183]. Tras una preparación correcta mediante Pwm_PreparePowerState, deben ejecutarse acciones posteriores que no surten efecto de forma inmediata para concluir definitivamente la transición del estado de energía [SWS_Pwm_00190].

La interfaz Pwm_Main_PowerTransitionManager sirve para la supervisión cíclica de transiciones de estado de energía (Power State Transitions) del controlador PWM según [SWS_Pwm_00189]. Posee el Service-ID 0x0d, no recibe parámetros de transferencia y no devuelve ningún valor de retorno (firma void Pwm_Main_PowerTransitionManager(void)).

En el marco de su ejecución cíclica, la función comprueba la disponibilidad operativa del módulo para el estado de energía respectivo. Tan pronto como exista la disponibilidad, desencadena los callbacks de notificación IoHwAb_Pwm_NotifyReadyForPowerState<Mode> que se referencian mediante el parámetro de configuración PwmPowerStateReadyCbkRef [SWS_Pwm_00189].

La función está prevista para un contexto de llamada cíclico y se proporciona a través del archivo de cabecera SchM_Pwm.h. En consecuencia, es de prever que la llamada periódica tenga lugar típicamente en el contexto del planificador de BSW (Schedule Manager) [SWS_Pwm_00189]. En la especificación del módulo no se definen para este servicio códigos de error específicos, mecanismos para el tratamiento de errores mediante DET o DEM, ni condiciones especiales de reentrancia. Pregunta Q-b9b0431e7ccbca88 (abierta)

El módulo PWM llama de forma síncrona a la función de notificación relativa al canal Pwm_Notification_<#Channel> en cuanto se produce el evento de flanco configurado para el canal respectivo [SWS_Pwm_00105]. La función tiene la firma void Pwm_Notification_<#Channel>(void), no recibe parámetros de transferencia y no devuelve ningún valor [SWS_Pwm_00105]. Está declarada en el archivo Pwm_Externals.h y debe ser proporcionada por el usuario [SWS_Pwm_00105].

La llamada se realiza en función de la última llamada a Pwm_EnableNotification para el canal en cuestión [SWS_Pwm_00105]. Los eventos desencadenantes se orientan a los valores de Pwm_EdgeNotificationType, que distingue flancos de señal ascendentes (PWM_RISING_EDGE), descendentes (PWM_FALLING_EDGE) o ambos flancos (PWM_BOTH_EDGES) [SWS_Pwm_00109]. Antes de la generación de la señal y de la notificación de eventos, el módulo PWM debe haberse inicializado a través de Pwm_Init con una estructura Pwm_ConfigType dependiente del hardware [SWS_Pwm_00095], [SWS_Pwm_00111].

En relación con la concurrencia, la reentrancia de la función de callback está definida explícitamente como dependiente del usuario (PWM user implementation dependant) [SWS_Pwm_00105]. El contexto de ejecución exacto (por ejemplo, si la llamada se realiza directamente en una rutina de servicio de interrupción o en el contexto de tarea) dependerá probablemente de la implementación subyacente del controlador (interpretación). Pregunta Q-327872e0e8fecb37 (abierta) No existen códigos de error específicos, valores de retorno ni mensajes DET o DEM estandarizados para esta interfaz de notificación [SWS_Pwm_00105].

La función IoHwAb_Pwm_NotifyReadyForPower (declarada en la sintaxis como IoHwAb_Pwm_NotifyReadyForPowerState<#Mode>) se proporciona a través de la cabecera IoHwAb_Pwm.h y sirve como interfaz de callback en la gestión de energía de AUTOSAR [SWS_Pwm_00198].

En lo que respecta al uso, las propiedades de la interfaz y la interacción del sistema, se aplican los siguientes requisitos vinculantes:

• Uso y contexto de llamada: La interfaz posee el Service-ID 0x60 y se ejecuta de forma síncrona [SWS_Pwm_00198]. El controlador PWM debe llamarla obligatoriamente tan pronto como la preparación por parte del dispositivo para un estado de energía (Power State) solicitado de un modo haya concluido con éxito [SWS_Pwm_00198].
• Parámetros y valores de retorno: La firma de la función no define parámetros de entrada, entrada/salida ni salida, y no posee ningún valor de retorno (void) [SWS_Pwm_00198]. Interpretación: Es probable que la asignación al modo de energía correspondiente se derive directamente del nombre de función específico del modo en el código fuente. Pregunta Q-ab761160ed91de78 (abierta)
• Concurrencia y restricciones: La función está especificada como no reentrante (Non Reentrant) [SWS_Pwm_00198]. Por consiguiente, las llamadas no deben realizarse de forma paralela ni anidada dentro del mismo contexto de controlador.
• Interacción: En el flujo entre módulos, la llamada a la abstracción de hardware de E/S de nivel superior señaliza que la etapa del controlador está lista para la transición al estado operativo deseado [SWS_Pwm_00198].

En las fuentes de la especificación no se prevén para esta función códigos de error específicos ni mensajes a DET o DEM [SWS_Pwm_00198].

El tipo de enumeración Pwm_OutputStateType define el estado de salida de un canal PWM dentro del controlador de Classic AUTOSAR Pwm [SWS_Pwm_00108]. La definición de tipo se proporciona a través del archivo de cabecera Pwm.h para unidades de software llamadoras y aplicaciones de controladores [SWS_Pwm_00108].

El rango de valores de esta enumeración distingue dos estados unívocamente definidos del canal [SWS_Pwm_00108]:

• PWM_HIGH (valor numérico 0x00): indica que el canal PWM en cuestión se encuentra en estado High [SWS_Pwm_00108].
• PWM_LOW (valor numérico 0x01): indica que el canal PWM en cuestión se encuentra en estado Low [SWS_Pwm_00108].

En relación con el contexto de llamada y la finalidad de uso, el elemento en sí, como tipo, no define funciones de interfaz [SWS_Pwm_00108]. Interpretación: es de prever que los valores sirvan típicamente como parámetros o valores de retorno en funciones de API del módulo para señalizar el estado de nivel lógico actual o deseado de un canal. Pregunta Q-9c142d658ab7fcfd (abierta)

Dado que se trata de una definición de tipo elemental, no existen tratamientos de error específicos relativos a DET o DEM, ni tampoco requisitos de reentrancia o ejecución síncrona en el alcance de la especificación [SWS_Pwm_00108].

El tipo de enumeración Pwm_PowerStateRequestResultType proporciona el resultado de solicitudes de cambio de estado del modo de gestión de energía (Power State Transitions) en el controlador PWM según [SWS_Pwm_00165]. La definición de tipo está disponible a través de la cabecera Pwm.h [SWS_Pwm_00165].

El tipo representa tanto la transición correcta como condiciones de error específicas [SWS_Pwm_00165]:

• PWM_SERVICE_ACCEPTED (0x00): el cambio solicitado de Power-State se ejecutó correctamente [SWS_Pwm_00165].
• PWM_NOT_INIT (0x01): el módulo PWM todavía no está inicializado [SWS_Pwm_00165].
• PWM_SEQUENCE_ERROR (0x02): la secuencia de llamada de la API no es admisible [SWS_Pwm_00165].
• PWM_HW_FAILURE (0x03): un fallo de hardware impide adoptar el estado de energía requerido [SWS_Pwm_00165].
• PWM_POWER_STATE_NOT_SUPP (0x04): el estado solicitado no es compatible con el módulo [SWS_Pwm_00165].
• PWM_TRANS_NOT_POSSIBLE (0x05): no es posible una transición de estado directa o el periférico de hardware todavía está ocupado [SWS_Pwm_00165].

Los llamadores deben evaluar el resultado para determinar si un cambio de estado surtió efecto de forma inmediata. Interpretación: es de prever que el tipo actúe típicamente como valor de retorno o parámetro de salida de las correspondientes funciones de gestión de energía para informar a los módulos de nivel superior sobre conflictos de transición o bloqueos de hardware. Pregunta Q-fd06829e5c030906 (abierta)

El tipo de enumeración Pwm_PowerStateType sirve en el módulo PWM para describir estados de energía [SWS_Pwm_00197]. Representa o bien el estado operativo actualmente activo o bien un nuevo estado de potencia predeterminado como destino del controlador [SWS_Pwm_00197]. Este tipo de datos se proporciona a través del archivo de cabecera Pwm.h [SWS_Pwm_00197].

La especificación define para la enumeración los siguientes valores y rangos de valores [SWS_Pwm_00197]:

• PWM_FULL_POWER (valor 0x00): identifica el estado de máxima potencia («Full Power») [SWS_Pwm_00197].
• Rango de valores 1..255: define modos de potencia escalonados con consumo de energía decreciente gradualmente («power modes with decreasing power consumptions») [SWS_Pwm_00197].

En cuanto al contexto de uso, es de prever que el tipo funcione como parámetro de transferencia al solicitar un modo de bajo consumo, así como valor de retorno en consultas de estado, dado que el tipo representa tanto estados activos como de destino [SWS_Pwm_00197]. Pregunta Q-f0423f8b958d7e91 (abierta) En el presente extracto de la especificación no se incluyen funciones concretas de API, tratamientos de error (DET/DEM) ni restricciones de concurrencia para este tipo de datos, por lo que se omiten [SWS_Pwm_00197].