AUTOSAR_SWS_PWMDriver 中文翻译

文档编号：077　|　状态：Final（正式发布）　|　发布于：AUTOSAR CP Release 4.4.0（2018-10-31）
所属标准：AUTOSAR Classic Platform 标准　|　文档责任方：AUTOSAR　|　保密等级：AUTOSAR CONFIDENTIAL

本翻译覆盖原文档 1-65 页正文，约 1.30 MB / 65 页。
原文为软件规范（SWS），定义脉宽调制（PWM）驱动模块的 API 与配置——含 14 个 API 函数（含 1 个通知回调模板 + 1 个电源状态转换管理器）+ 多个开发错误 + 多个 SWS_Pwm_NNNNN 规范项。
本翻译为"忠实精翻+结构化索引"型——保留全部章节、API 函数、错误分类、配置参数。

1 引言与功能概述

本规约规约 AUTOSAR 基础软件模块 PWM 驱动（Pulse Width Modulation Driver）的功能、API 与配置。PWM 驱动位于微控制器抽象层（MCAL），控制 PWM 信号的占空比、周期与极性。

2 缩略语与缩写

缩略语描述
PWMPulse Width Modulation（脉宽调制）
MCALMicrocontroller Abstraction Layer（微控制器抽象层）
Duty Cycle占空比（0-100%）
Period周期
Polarity极性（高/低有效）
Idle State空闲状态
Fixed / Variable Period固定 / 可变周期

3 相关文档

4 约束与假设

PWM 驱动为基于硬件的 MCAL 驱动。固定/可变周期模式、电源状态管理依赖硬件支持。

5 与其他模块的依赖

PWM 驱动依赖 Port（引脚配置）、DET、OS（多核分区）、EcuM（电源状态管理）。

6 需求可追溯性

PWM 驱动满足 SRS_Pwm_NNNNN 中的 15+ 条需求。SWS_Pwm_NNNNN 规范项 ID 约 200+ 条（编号范围 00001-91001）。

7 功能规范

7.1 预配置

PWM 驱动允许以下预配置：

7.2 通用行为

PWM 驱动提供：

7.3 错误分类

7.3.1 开发错误（Development Errors）

错误码含义
PWM_E_UNINITPWM 未初始化
PWM_E_ALREADY_INITIALIZED已初始化
PWM_E_PARAM_CHANNEL无效的通道
PWM_E_PARAM_VALUE无效的参数值
PWM_E_PERIOD_UNCHANGEABLE固定周期模式不允许修改周期
PWM_E_POWER_STATE_NOT_SUPPORTED电源状态不支持

7.3.2 运行时错误

无。

7.3.3 瞬态故障

无。

7.3.4 生产错误

无。

7.3.5 扩展生产错误

无。

8 API 规范

8.1 导入类型

8.2 类型定义

类型描述
Pwm_ConfigTypePWM 抽象配置类型
Pwm_ChannelType通道 ID（uint8/16）
Pwm_DutyCycleType占空比值（uint16，0x0000=0% / 0x8000=100%）
Pwm_PeriodType周期值（取决于硬件计时单位）
Pwm_OutputStateType输出状态枚举（PWM_HIGH / PWM_LOW）
Pwm_PowerStateType电源状态枚举（FULL / LOW）

8.3 函数定义

API功能
Pwm_Init初始化 PWM
Pwm_DeInit反初始化 PWM
Pwm_SetDutyCycle（draft/obsolete）设置占空比
Pwm_SetPeriodAndDuty（draft/obsolete）设置周期与占空比
Pwm_SetOutputToIdle（draft/obsolete）设置输出到空闲
Pwm_GetOutputState获取输出状态
Pwm_DisableNotification（draft/obsolete）禁用通知
Pwm_EnableNotification（draft/obsolete）启用通知
Pwm_SetPowerState设置电源状态
Pwm_GetCurrentPowerState获取当前电源状态
Pwm_GetTargetPowerState获取目标电源状态
Pwm_PreparePowerState准备电源状态转换
Pwm_GetVersionInfo获取版本信息
Pwm_Main_PowerTransitionManager电源状态转换管理器（调度函数）
Pwm_Notification_<#Channel>通知回调（应用实现）

共 14 个 API 函数 + 1 个通知回调模板 + 1 个电源状态转换管理器。

9 序列图

  1. 设置占空比：应用 → Pwm_SetDutyCycle(Channel, Duty) → PWM 输出新占空比；
  2. 设置周期与占空比：应用 → Pwm_SetPeriodAndDuty(Channel, Period, Duty)（仅可变周期模式）；
  3. 设置空闲：应用 → Pwm_SetOutputToIdle(Channel) → PWM 输出空闲电平；
  4. 周期结束通知：硬件达到周期 → 通知回调 Pwm_Notification_<#Channel>()；
  5. 电源状态切换：应用 → Pwm_PreparePowerState() → Pwm_Main_PowerTransitionManager() → Pwm_SetPowerState()。

10 配置规范

10.1 容器与配置参数

容器描述
Pwm根容器（开发错误检测、版本 API、固定/可变周期模式、电源状态支持）
PwmGeneral通用配置（通道数、周期类型、电源状态支持）
PwmChannel通道（周期、占空比、极性、空闲状态、通知回调、类/索引）
PwmPowerStateConfig电源状态配置
PwmPublishedInformation发布信息

共 5 个 ECUC 容器，含 20+ 配置参数。

10.2 发布信息

发布信息包括 PWM 模块版本、配置变体、通道数、周期类型等。

📋 校对记录

校对轮次：L1 自动校对（2026-06-13）