AUTOSAR_SWS_ADCDriver 中文翻译

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

本翻译覆盖原文档 1-129 页正文，约 2.17 MB / 129 页。
原文为软件规范（SWS），定义模数转换器（ADC）驱动模块的 API 与配置——含 18 个 API 函数（含启用/禁用硬件触发、启用/禁用组通知、设置/获取电源状态、电源状态转换管理器等）+ 多个开发错误 + 多个 SWS_Adc_NNNNN 规范项。
本翻译为"忠实精翻+结构化索引"型——保留全部章节、API 函数、错误分类、配置参数。

1 引言与功能概述（Introduction and functional overview）

本规约规约 AUTOSAR 基础软件模块 ADC 驱动（Analog-to-Digital Converter Driver, ADC）的功能、API 与配置。ADC 驱动位于微控制器抽象层（MCAL），初始化并控制内部 ADC 硬件单元。

ADC 驱动提供以下服务：

• 启动/停止通道组转换（One-Shot / Continuous 模式）；
• 读取最新转换结果（线性访问 / 流访问）；
• 启用/禁用硬件触发；
• 启用/禁用通道组通知；
• 查询通道组状态；
• 电源状态管理（Set/Get PowerState + PreparePowerState + PowerTransitionManager）；
• 多核分区支持。

2 缩略语与缩写（Acronyms and abbreviations）

3 相关文档（Related documentation）

• AUTOSAR_EXP_LayeredSoftwareArchitecture — 分层软件架构
• AUTOSAR_SRS_BSWGeneral — 基础软件通用需求
• AUTOSAR_SWS_BSWGeneral — 基础软件通用规范
• AUTOSAR_SRS_ADCDriver — ADC 驱动需求
• AUTOSAR_SRS_SPALGeneral — SPAL 通用需求

4 约束与假设（Constraints and assumptions）

ADC 驱动为基于硬件的 MCAL 驱动。硬件触发、电源状态管理、流访问等可选功能依赖硬件支持。

5 与其他模块的依赖（Dependencies to other modules）

ADC 驱动依赖 EcuM（资源管理）、DEM（错误报告）、DET（开发错误追踪）、OS（中断管理）、Port（引脚配置）。

6 需求可追溯性（Requirements traceability）

ADC 驱动满足 SRS_Adc_NNNNN 中的 20+ 条需求以及 RS_BRF_NNNNN 顶层需求。ADC 自身的 SWS_Adc_NNNNN 规范项 ID 约 300+ 条（详细列表见原文第 6/7/8/10 章；编号范围 00061-91001）。

7 功能规范（Functional specification）

7.1 预配置（Pre-Configuration）

ADC 驱动允许以下预配置：

• ADC HW 单元数；
• 每单元的通道数；
• 通道组（每个组的通道列表、转换模式、触发源、通知回调）；
• 每通道的采样时间、分辨率、参考电压；
• 流访问的缓冲区大小。

7.2 通用行为（General Behavior）

ADC 驱动正常操作流程：

1. Adc_Init() 初始化 ADC 驱动；
2. （可选）Adc_SetupResultBuffer() 设置流访问的结果缓冲区；
3. Adc_StartGroupConversion(Group) 启动通道组转换；
4. （硬件触发或软件触发）转换开始；
5. 转换完成时调用通道组通知回调（如果已启用）；
6. Adc_ReadGroup(Group, DataPtr) 读取最新转换结果；
7. Adc_StopGroupConversion(Group) 停止通道组转换；
8. Adc_DeInit() 反初始化。

7.3 错误分类（Error classification）

7.3.1 开发错误（Development Errors）

7.3.2 运行时错误（Runtime Errors）

无（ADC 不直接产生运行时错误）。

7.3.3 瞬态故障（Transient Faults）

无。

7.3.4 生产错误（Production Errors）

无（ADC 不直接产生生产错误）。

7.3.5 扩展生产错误（Extended Production Errors）

无。

8 API 规范（API specification）

8.1 导入类型（Imported types）

• Std_ReturnType、Std_VersionInfoType、Std_ConfigType

8.2 类型定义（Type Definitions）

8.3 函数定义（Function definitions）

共 18 个 API 函数。

8.4 调度函数（Scheduled functions）

8.5 预期接口（Expected Interfaces）

• Det_ReportError()（强制）
• Dem_SetEventStatus()（可选）

9 序列图（Sequence diagrams）

1. 软件触发转换：应用 → Adc_StartGroupConversion() → ADC 转换 → Adc_ReadGroup() 读取；
2. 硬件触发转换：硬件事件 → ADC 自动启动 → 转换完成 → 通知回调；
3. 流访问：应用 → Adc_SetupResultBuffer() → Adc_StartGroupConversion() → 持续写入缓冲区 → Adc_GetStreamLastPointer()；
4. 电源状态切换：应用 → Adc_PreparePowerState() → Adc_Main_PowerTransitionManager() → Adc_SetPowerState()。

10 配置规范（Configuration specification）

10.1 容器与配置参数（Containers and configuration parameters）

共 8 个 ECUC 容器（加 2 个发布容器），含 40+ 配置参数。

10.2 发布信息（Published Information）

发布信息包括 ADC 模块版本、配置变体、HW 单元数、通道数、组数等。