AUTOSAR图解==＞AUTOSAR_SRS_PWMDriver_autosar pwm-优快云博客

AUTOSAR PWM驱动模块详解

基于AUTOSAR 4.4.0 SRS 规范文档

1. PWM驱动概述

AUTOSAR PWM驱动是AUTOSAR基础软件中的一个重要组件，属于微控制器抽象层(MCAL)。它提供了对微控制器内部PWM单元的初始化和控制功能，支持产生可变脉宽的PWM信号。

PWM(脉宽调制)是一种通过调节脉冲占空比来传递信息或控制功率的技术。在汽车电子系统中，PWM信号被广泛应用于电机控制、LED调光、DC-DC转换器等多种场景。

PWM驱动模块的主要功能包括：

配置和初始化PWM通道
设置PWM信号的占空比和周期
管理PWM通道的输出状态
提供PWM边缘通知机制
支持电源管理功能

PWM模块支持多个PWM通道，每个通道都链接到微控制器的硬件PWM单元。PWM信号的类型（如中心对齐、左对齐等）由具体实现决定，不在规范中强制规定。

2. PWM驱动架构

PWM驱动作为AUTOSAR微控制器抽象层的一部分，与其他模块有着明确的层次关系和交互方式。以下架构图展示了PWM驱动在AUTOSAR软件架构中的位置及其与其他组件的关系：

在这里插入图片描述

2.1 架构层次分析

应用层
- 应用SW组件：使用PWM服务的应用软件，如电机控制、灯光控制等
- 复杂设备驱动(CDD)：可能直接使用PWM驱动的复杂设备驱动
RTE层
- 运行时环境：连接应用层和基础软件层，提供标准化的接口
基础软件层
- 服务层：包含ECU状态管理，负责控制PWM模块的电源状态
- ECU抽象层：包含I/O硬件抽象，可能会调用PWM驱动
- 微控制器抽象层：包含PWM驱动及相关的其他驱动（DIO、ADC等）
微控制器硬件
- PWM硬件单元：实际生成PWM信号的微控制器硬件模块

2.2 模块交互分析

应用层与RTE层交互
- 应用软件通过RTE调用PWM服务，无需关心底层实现细节
- 复杂设备驱动也可通过RTE使用PWM服务
RTE与PWM驱动交互
- RTE将应用层的请求转发给PWM驱动
- PWM驱动执行请求并返回结果给RTE
PWM驱动与其他模块交互
- ECU状态管理：控制PWM模块的电源状态
- I/O硬件抽象：可能通过PWM驱动控制硬件
- ADC驱动：可以通过PWM边缘通知机制触发ADC采样
PWM驱动与硬件交互
- PWM驱动直接控制微控制器PWM硬件单元
- 配置寄存器、控制输出状态等

架构设计遵循AUTOSAR的分层原则，实现了硬件与软件的解耦，提高了软件的可移植性和可维护性。

3. PWM驱动配置

PWM驱动模块支持丰富的配置选项，允许用户根据应用需求定制PWM功能。以下是PWM驱动的配置结构图：

在这里插入图片描述

3.1 配置结构分析

Pwm_ConfigType
- 全局PWM配置结构，包含所有通道的配置信息
- 包含通道配置指针和通道总数
Pwm_ChannelConfigType
- PWM通道配置结构，定义单个通道的属性
- 包含以下关键配置项：
  - ChannelId：通道ID
  - HwChannel：硬件通道映射
  - DefaultPeriod：默认周期值
  - DefaultDutyCycle：默认占空比值
  - Polarity：极性（高或低）
  - ChannelClass：通道类型
  - IdleState：空闲状态
  - Notification：通知类型
  - PhaseShiftReference：相位偏移参考
配置枚举类型
- Pwm_ChannelClassType：定义通道类型（可变周期、固定周期、带相移的固定周期）
- Pwm_OutputStateType：定义输出状态（高或低）
- Pwm_NotificationType：定义通知类型（上升沿、下降沿、双边沿、无通知）

3.2 配置特性分析

占空比配置
- 使用16位接口设置占空比
- 提供标准化的占空比比例：0表示0%，0x8000表示100%
- 占空比定义为信号的活动电平（高或低，取决于空闲电平配置）
通道类型配置
- 可变周期：周期可在运行时更改
- 固定周期：周期不可更改，仅在配置时设定
- 带相移的固定周期：支持相对于参考通道的相位偏移
通知机制配置
- 可以配置PWM信号边缘的通知功能
- 支持上升沿、下降沿或双边沿触发
- 通知可在运行时启用或禁用
特殊配置考虑
- 共享相同MCU定时器的PWM通道必须具有相同频率或独立频率
- 某些PWM通道的频率可能只允许静态配置，不支持运行时更改

通过这些丰富的配置选项，PWM驱动能够适应各种应用场景的需求，提供灵活且强大的PWM信号控制能力。

4. PWM驱动API接口

PWM驱动提供了一组标准化的API接口，用于初始化、控制PWM信号以及管理电源状态。以下图表展示了PWM驱动的主要API接口：

在这里插入图片描述

4.1 核心功能API

初始化与去初始化
- Pwm_Init(const Pwm_ConfigType* ConfigPtr)：初始化PWM模块，所有通道开始工作
- Pwm_DeInit(void)：去初始化PWM模块，停止所有通道
占空比控制
- Pwm_SetDutyCycle(Pwm_ChannelType ChannelNumber, uint16 DutyCycle)：设置指定通道的占空比
- Pwm_SetPeriodAndDuty(Pwm_ChannelType ChannelNumber, Pwm_PeriodType Period, uint16 DutyCycle)：设置通道的周期和占空比
通道状态控制
- Pwm_SetOutputToIdle(Pwm_ChannelType ChannelNumber)：将通道输出设置为空闲状态
- Pwm_GetOutputState(Pwm_ChannelType ChannelNumber)：获取通道的当前输出状态
通知管理
- Pwm_EnableNotification(Pwm_ChannelType ChannelNumber, Pwm_EdgeNotificationType Notification)：启用边缘通知
- Pwm_DisableNotification(Pwm_ChannelType ChannelNumber)：禁用边缘通知

4.2 电源管理API

电源状态查询
- Pwm_GetCurrentPowerState(void)：获取当前电源状态
- Pwm_GetTargetPowerState(void)：获取目标电源状态
电源状态转换
- Pwm_PreparePowerState(Pwm_PowerStateType PowerState)：准备电源状态转换
- Pwm_SetPowerState(Pwm_PowerStateType PowerState)：设置电源状态

4.3 API使用说明

占空比设置
- 占空比使用0至0x8000（0%至100%）的比例
- 占空比的更新可以配置为等待周期结束后再生效，避免不必要的波形干扰
周期设置
- 仅可变周期类型的通道支持运行时更改周期
- 更改周期时应同时指定占空比，以保持一致性
电源管理
- 电源状态转换分为准备和设置两个阶段
- 支持同步或异步电源状态转换过程
- 电源状态包括FULL_POWER、LOW_POWER和OFF_MODE

PWM驱动的API设计符合AUTOSAR标准，提供了良好的抽象和一致性，使应用软件能够轻松控制PWM信号而无需关心底层硬件细节。

5. PWM驱动状态管理

PWM驱动具有明确的状态转换机制，包括初始化状态、运行状态和电源管理状态。以下状态图展示了PWM驱动的状态转换：

在这里插入图片描述

5.1 主要状态分析

未初始化状态(UNINIT)
- PWM驱动的初始状态
- 未配置任何PWM通道
- 不能使用PWM功能
初始化状态(INIT)
- 通过调用Pwm_Init()进入
- 所有通道按照配置开始工作
- 包含两个子状态：
  - 正常运行状态：通道正常输出PWM信号
  - 空闲状态：通道输出设置为空闲电平
低功耗状态(LOW_POWER)
- 通过电源管理API进入
- PWM功能部分或全部不可用
- 用于降低功耗

5.2 状态转换分析

初始化相关转换
- UNINIT → INIT：调用Pwm_Init()初始化驱动
- INIT → UNINIT：调用Pwm_DeInit()去初始化驱动
通道状态转换
- 正常运行 → 空闲：调用Pwm_SetOutputToIdle()
- 空闲 → 正常运行：调用Pwm_SetDutyCycle()或Pwm_SetPeriodAndDuty()
电源管理相关转换
- INIT → LOW_POWER：调用Pwm_PreparePowerState()和Pwm_SetPowerState()进入低功耗状态
- LOW_POWER → INIT：调用电源管理API恢复正常功能状态

5.3 状态管理特性

初始化特性
- 初始化时所有通道自动启动
- 去初始化时所有通道停止，输出状态可配置
电源管理特性
- 电源状态转换分为准备和设置两个阶段
- 支持同步和异步电源状态转换
- 可以查询当前和目标电源状态
通道状态特性
- 支持单独控制每个通道的状态
- 可以读取通道的当前输出状态

PWM驱动的状态管理机制确保了模块在不同操作条件下的正确行为，为应用软件提供了可靠的PWM控制能力。

6. PWM驱动典型应用场景

PWM驱动在AUTOSAR系统中有多种应用场景。以下序列图展示了PWM驱动的典型操作流程：

在这里插入图片描述

6.1 基本操作流程

初始化阶段
- 应用通过IoHwAbs请求系统启动
- IoHwAbs调用Pwm_Init()初始化PWM驱动
- PWM驱动配置硬件，完成初始化
- 系统就绪，可以使用PWM功能
正常运行阶段
- 应用请求设置PWM输出（通道和占空比）
- IoHwAbs调用Pwm_SetDutyCycle()
- PWM驱动更新硬件寄存器
- 操作完成，返回结果
去初始化阶段
- 应用调用Pwm_DeInit()
- PWM驱动停止所有通道
- 去初始化完成

6.2 高级应用场景

边缘通知与ADC触发
- 应用启用PWM边缘通知
- PWM产生上升沿中断
- 通知回调函数被调用
- 回调函数触发ADC采样
- ADC完成采样，处理结果
电源管理
- 应用请求进入低功耗模式
- 调用Pwm_PreparePowerState()准备低功耗状态
- 调用Pwm_SetPowerState()完成状态转换
- 硬件进入低功耗模式
- 需要时，可以恢复正常功能状态