From 9e39113e5fcb6d96033dbad089072039c1fbb5be Mon Sep 17 00:00:00 2001 From: opencode-translator Date: Sat, 13 Jun 2026 22:23:59 +0800 Subject: [PATCH] =?UTF-8?q?P4=20MCAL=20100%=20=E5=AE=8C=E6=88=90:=20?= =?UTF-8?q?=E7=BF=BB=E8=AF=91=207=20=E7=AF=87=20SRS/SWS=20=E6=96=87?= =?UTF-8?q?=E6=A1=A3=20(CoreTest/GPT/MCU/SPAL)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../P4_MCAL/AUTOSAR_SRS_CoreTest.html | 249 +++++++++++++ .../P4_MCAL/AUTOSAR_SRS_GPTDriver.html | 213 +++++++++++ .../P4_MCAL/AUTOSAR_SRS_MCUDriver.html | 198 ++++++++++ .../P4_MCAL/AUTOSAR_SRS_SPALGeneral.html | 260 +++++++++++++ .../P4_MCAL/AUTOSAR_SWS_CoreTest.html | 308 ++++++++++++++++ .../P4_MCAL/AUTOSAR_SWS_GPTDriver.html | 336 +++++++++++++++++ .../P4_MCAL/AUTOSAR_SWS_MCUDriver.html | 344 ++++++++++++++++++ translation_zh-CN/P4_MCAL/index.html | 86 +++++ translation_zh-CN/PLAN.html | 2 +- translation_zh-CN/_progress.json | 15 +- translation_zh-CN/index.html | 14 +- translation_zh-CN/progress.md | 6 +- 12 files changed, 2017 insertions(+), 14 deletions(-) create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SRS_CoreTest.html create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SRS_GPTDriver.html create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SRS_MCUDriver.html create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SRS_SPALGeneral.html create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SWS_CoreTest.html create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SWS_GPTDriver.html create mode 100644 translation_zh-CN/P4_MCAL/AUTOSAR_SWS_MCUDriver.html create mode 100644 translation_zh-CN/P4_MCAL/index.html diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_CoreTest.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_CoreTest.html new file mode 100644 index 0000000..2006801 --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_CoreTest.html @@ -0,0 +1,249 @@ + + + + +AUTOSAR SRS CoreTest 中文翻译 + + + + +

AUTOSAR_SRS_CoreTest 中文翻译

+

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

+ +

本翻译覆盖原文档 1-24 页正文，约 660 KB / 24 页。
+原文为软件需求规范（SRS, Software Requirements Specification），定义 Core Test（核心测试）模块的需求——含 25+ 条 SRS_CoreTst_NNNNN 需求 ID 与 14 行 RS_BRF_NNNNN 追溯。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、需求 ID 编号、配置可追溯性。

+ + + +
+ +

1 文档范围（Scope of Document）

+

本文档定义 AUTOSAR 中 Core Test 规范的一般规则与需求。它应（shall）作为每个需求文档的基础。

+

已注意确保 Core test、RAM test 与 Flash test SRS 文档之间的一致性。

+ +

2 约定（Conventions to be Used）

+ + +

3 缩略语与缩写（Acronyms and Abbreviations）

+ + + + + + + + + + + + + + + + + + + + + + + +
缩略语描述
CPUCentral Processing Unit（中央处理器）
MPUMemory Protection Unit（内存保护单元）
L11st level memory（一级内存）
L22nd level memory（二级内存）
MCUMicrocontroller Unit（微控制器单元）
BISTBuilt in Self Test（内建自测试）
IRQInterrupt Request（中断请求）
CoreA CPU plus closely located functional resources（CPU 及其紧密相关的功能资源）
Atomic sequence / atomic partSequence of software code execution which must not be interrupted at any time（任何时候都不得被中断的软件代码执行序列）
Partial testA partial test is defined as the test of one or more 'hardware resources'（一个或多个"硬件资源"的测试，可中断）
PCBPrinted Circuit Board（印刷电路板）
External deviceA physical external entity; e.g. a second microcontroller（物理外部实体，例如第二个微控制器）
ResourceA core internal unit which executes a unique functionality（执行特定功能的核内部单元，例如 IRQ 控制器）
Checksum / signatureA numerical representation of the result of a test execution（测试执行结果的数值表示）
Caller / calling entityThe caller/calling entity is located on a higher AUTOSAR or ISO layer（位于更高 AUTOSAR 或 ISO 层的 API 调用者）
Background testBackground test is called periodically by a SW-scheduler（由软件调度器周期性调用的后台测试）
Foreground testForeground test is called via users call（通过用户调用启动的前台测试）
Golden (Ref.) ValueReference value used for comparison（用于比较的参考值）
Good CaseThe execution finished without reporting an error（执行完成且未报告错误的"良好"情况）
+ +

4 功能概述（Functional Overview）

+

本模块描述符合汽车规范的 API 测试用例需求。它涵盖周期性测试以及启动测试。它应集成在整体安全概念中，不会单独提供所需的诊断覆盖率。

+

测试可在后台或前台模式运行：

+ +

应（shall）允许取消后台模式并启动前台模式。不应（shall not）同时执行两种模式。如果后台任务正在运行且请求前台任务，则应在调用前台任务之前取消后台任务（例如在原子序列结束时）。

+

完整测试由 2 步组成：

+
    +
  1. 运行专用指令序列以激励门电路和触发器，并计算校验和/签名作为结果表示；
    2. +
  2. 提供比较的校验和/签名——或——将计算的校验和与参考值（"Golden reference value"）比较，并决定测试通过或失败——或——存储计算的校验和并按需提供给外部调用方。
    3. +
+

测试计算两个步骤并返回 pass/fail 状态，或仅计算校验和并提供完成通知给调用实体。这允许在测试与监督概念的实现中提供更高灵活性。调用方也可以是运行在另一 CPU 上的软件组件或外部设备。

+ +

4.1.1 Core 的定义（Definition of Core）

+

Core 定义为中央处理器（CPU）、所有专用内存与总线接口（TCM, L1, L2 cache, system bus 等）以及所有专用支持功能（例如中断控制器、调试等）。

+

需求源自汽车标准。必须测试包括仲裁、MMU/MPU、缓存、紧耦合内存、通用与专用寄存器、数值执行单元（包括地址生成）以及中断和异常处理在内的总线。相应测试列于汽车标准中。

+

不涵盖永久监控技术或冗余硬件技术（例如 lock-step CPU）。如存在且需要软件支持，可能必须由 MCAL 复杂驱动（CDD）处理。

+

注：Core test 仅发起诊断事件。它应（shall）用于在运行时检测静态硬件错误。瞬态故障与间歇性故障不包括在内，且不能由专用测试软件支持检测。

+ +

4.2 多核支持（Multicore Support）

+

应（shall）可对硅设备内每个相等的核实例执行 Core test。Core test 本身与 API 由于其作为位于较低 AUTOSAR 层的驱动程序的特性，无需了解系统架构本身。

+

此外，Core test 无需了解整个系统架构中共存的内核数量，且仅关注单个核实体（即如为多核，则用户应用必须为每个核调度同一测试的多个实体）。

+

因此"多微控制器"与"多核"之间必须有明确区分。多微控制器系统设计不在 Core test 及其驱动 API 的范围内。

+ +

4.3 架构先决条件（Architectural Prerequisites）

+ +

4.3.1 资源分配（Resource Allocation）

+

AUTOSAR 上层没有资源管理实体（例如 ISO 7 层模型 - 会话管理）。有必要从应用使用中临时释放本地核资源（例如 IRQ 控制器），以避免运行时测试与应用之间的不良行为与干扰。AUTOSAR 架构中没有管理实体可在执行 Core test 之前主动处理此需求。

+ +

4.3.2 测试概念（Test Concept）

+

当前 AUTOSAR 不支持运行时测试；因此 AUTOSAR 上层没有可用的测试管理实体。由于 MCAL 驱动程序缺少直接访问在其他核上执行的测试结果的能力（例如多微控制器系统），需要上层 AUTOSAR 架构中的测试管理实体来处理测试结果处理（本地、外部）以及整体系统架构的相关反应。

+ +

4.3.3 限制（Limitations）

+

由于 4.3.1 与 4.3.2，Core test 实现可能仅限于在 power-up/start-up 阶段执行（此时核资源不在线程或实体之间共享，例如 IRQ 控制器、DMA）——或——仅限于测试运行时未共享的资源（例如 CPU 本身）。

+ +

5 需求可追溯性（Requirements Tracing）

+

本节将 SRS_CoreTst_NNNNN 需求追溯到 RS_BRF_NNNNN 顶层需求：

+ + + + + + + + + + + + + + + + + + + +
RS_BRF 需求描述由 SRS_CoreTst 满足
RS_BRF_00129AUTOSAR 应支持数据损坏检测与保护14115, 14116
RS_BRF_01048AUTOSAR 模块设计应支持多任务环境中的模块协作14111, 14130
RS_BRF_01056AUTOSAR BSW 模块应提供标准化接口14112, 14113, 14131
RS_BRF_01064AUTOSAR BSW 应提供回调函数以访问上层模块14119
RS_BRF_01096AUTOSAR 应支持 ECU 的启动与关闭14134
RS_BRF_01136AUTOSAR 应支持系统启动后解析的 BSW 数据变体14101, 14102
RS_BRF_01232AUTOSAR OS 应支持应用软件的隔离与保护14123
RS_BRF_01296AUTOSAR RTE 应支持软件组件的单实例与多实例14133
RS_BRF_01320AUTOSAR RTE 应调度 SWC 与 BSW 模块14114
RS_BRF_01400AUTOSAR RTE 应提供可配置测试钩子14114
RS_BRF_01472AUTOSAR 应支持模式14123, 14126, 14133, 14134
RS_BRF_02024AUTOSAR 应提供保护系统免受未授权使用的机制14117
RS_BRF_02160AUTOSAR 诊断应允许外部测试者控制 ECU 的活动功能14130
RS_BRF_02168AUTOSAR 诊断应提供异常操作条件的集中分类与处理14117
RS_BRF_02224AUTOSAR 应支持运行时硬件测试14104, 14105, 14106, 14107, 14108, 14109, 14110, 14131, 14134
+ +

6 需求规范（Requirements Specification）

+ +

6.1 功能需求（Functional Requirements）

+ +

6.1.1 配置（Configuration）

+ + + + + + +
ID标题描述
SRS_CoreTst_14101Core Test 应可配置待测试的 Core 功能与要运行的原子测试应（shall）可配置
SRS_CoreTst_14102应支持链接时配置待测试的 Core 功能与要运行的原子测试应（shall）在链接时通过目标库配置
+ +

6.1.2 正常运行（Normal Operation）

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ID标题描述
SRS_CoreTst_14104Core 寄存器测试应可用应（shall）支持符合汽车标准的测试
SRS_CoreTst_14105Core 中断与异常检测测试应可用应支持符合汽车标准的测试
SRS_CoreTst_14106Core ALU 测试应可用应支持测试"编码与执行含标志寄存器"，如汽车标准所建议
SRS_CoreTst_14107Core 地址生成器测试应可用应支持测试"地址生成"，如汽车标准所建议
SRS_CoreTst_14108Core 内存接口测试应可用应支持总线测试，如汽车标准所建议
SRS_CoreTst_14109内存管理/保护单元（MMU/MPU）测试应可用应支持内存管理/保护单元测试
SRS_CoreTst_14110缓存控制器测试应可用应支持缓存控制器测试
SRS_CoreTst_14111Core Test 应被划分为原子序列应将 Core test 划分为原子序列，可在 OS 任务切换点中断
SRS_CoreTst_14112应为 Core Test 提供单一 API单一 API 可访问所有 Core test 功能
SRS_CoreTst_14113API 应包含选择原子测试的参数参数用于选择待运行的原子测试
SRS_CoreTst_14114应为 Core Test 提供主函数主函数用于周期性 Core test 调用
SRS_CoreTst_14115测试指标应对调用方可用调用方应可获取测试指标（如校验和、签名）
SRS_CoreTst_14116应提供返回测试结果（pass/fail）的服务服务应返回测试通过/失败状态
SRS_CoreTst_14131应提供返回当前测试状态的服务服务应返回当前测试状态（如 IDLE/RUNNING/COMPLETED）
SRS_CoreTst_14117故障应被处理为生产错误测试故障应作为生产错误上报 DEM
SRS_CoreTst_14118Core test 模块结果应可由其他模块使用测试结果应通过标准 AUTOSAR 接口可访问
SRS_CoreTst_14119完成通知应可用应（shall）提供完成通知回调
SRS_CoreTst_14126应可取消正在运行的测试应可取消后台测试以启动前台测试
SRS_CoreTst_14130破坏性测试应恢复原始内容破坏性测试在完成时应恢复被测内容到原始状态
SRS_CoreTst_14133每个 Core Test 间隔应具有可配置的执行时间应（shall）可配置测试间隔以适应不同执行时间
SRS_CoreTst_14134应提供前台 Core Test应（shall）提供前台测试以测试整个核功能
SRS_CoreTst_14128Core Test 不应干扰应用Core test 不应干扰应用执行（隔离保护）
SRS_CoreTst_14129多微控制器支持（已拒绝）多微控制器系统不在 Core test 范围内
SRS_CoreTst_14127测试应能请求其他核进行测试测试应能请求另一个核执行测试
+ +

6.1.3 初始化（Initialisation）

+ + + + + +
ID标题描述
SRS_CoreTst_14103应为 Core Test 提供初始化函数应（shall）提供 CorTst_Init() 初始化函数
+ +

6.1.4 关闭操作（Shutdown Operation）

+ + + + + +
ID标题描述
SRS_CoreTst_14120应为 Core Test 提供反初始化函数应（shall）提供 CorTst_DeInit() 反初始化函数
+ +

6.2 非功能需求（Non-Functional Requirements）

+ + + + + + + + + +
ID标题描述
SRS_CoreTst_14123待测试的共享资源应专门提供给测试被测共享资源在测试期间应被独占使用
SRS_CoreTst_14121时序需求（已拒绝）—
SRS_CoreTst_14122应提供至 DET 的接口（已拒绝）—
SRS_CoreTst_14125诊断覆盖率（已拒绝）—
SRS_CoreTst_14124Core test 实现应符合一般安全要求应符合 ISO 26262 等安全标准的一般要求
+ +

7 参考文献（References）

+ +

7.1 AUTOSAR 交付物（Deliverables of AUTOSAR）

+ + +

7.2 相关标准与规范（Related standards and norms）

+ + +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_GPTDriver.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_GPTDriver.html new file mode 100644 index 0000000..cfa6058 --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_GPTDriver.html @@ -0,0 +1,213 @@ + + + + +AUTOSAR SRS GPTDriver 中文翻译 + + + + +

AUTOSAR_SRS_GPTDriver 中文翻译

+

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

+ +

本翻译覆盖原文档 1-18 页正文，约 490 KB / 18 页。
+原文为软件需求规范（SRS, Software Requirements Specification），定义通用定时器（General Purpose Timer, GPT）驱动模块的需求——含 18 条 SRS_Gpt_NNNNN 需求 ID 与 7 行 RS_BRF_NNNNN 追溯。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、需求 ID 编号、配置可追溯性。

+ + + +
+ +

1 文档范围（Scope of document）

+

本文档规定对 GPT 驱动模块的需求。

+

约束：基础软件模块需求规范的首要范围是非安全相关系统。因此安全需求被赋予中等优先级。

+ +

2 如何阅读本文档（How to read this document）

+

每个需求具有唯一标识符，以前缀"BSW"开头（代表"Basic Software"，基础软件）。对于任何评审注释、备注或问题，请参考此唯一 ID 而非章节或页码！

+ +

2.1 使用约定（Conventions used）

+ + +

2.2 需求结构（Requirements structure）

+

每个模块特定章节包含 BSW 模块的简短功能描述。章节中相同种类的需求按以下标题分组（适用时）：

+ + +

3 功能概述（Functional Overview）

+

GPT 驱动是微控制器抽象层（Microcontroller Abstraction Layer, MCAL）的一部分。它初始化并控制微控制器的内部通用定时器（General Purpose Timer, GPT）。

+

GPT 驱动提供以下服务和配置参数：

+ +

GPT 驱动能够提供精确与短期的定时。GPT 驱动的一次性或连续中断通知可用于 OS Alarm 服务开销过大的场景。

+

典型周期时间范围示例为 50µs ... 5 ms。

+

一些自由运行的向上计数器——所谓的 GPT 预定义定时器（GPT Predef Timers）——被定义。这些定时器具有预定义的滴答持续时间和预定义的位数（物理时间单位与范围）。GPT 预定义定时器由时间服务模块（Time Service）使用。

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + +
缩略语描述
CSChip select（片选）
DIODigital Input Output（数字输入输出）
ECUElectric Control Unit（电子控制单元）
EOLEnd Of Line（产线下线）；常用于术语'EOL Programming'或'EOL Configuration'（下线编程/配置）
ICUInput Capture Unit（输入捕获单元）
MALMicrocontroller Abstraction Layer 的旧名（已被 MCAL 取代，因为"MAL"是法语词汇，意为"坏"）
MCALMicrocontroller Abstraction Layer（微控制器抽象层）
MCUMicrocontroller Unit（微控制器单元）
MMUMemory Management Unit（内存管理单元）
MasterA device controlling other devices (slaves, see below)（控制其他设备的主设备）
SlaveA device being completely controlled by a master device（被主设备完全控制的从设备）
NMINon maskable interrupt（不可屏蔽中断）
OSOperating System（操作系统）
PLLPhase Locked Loop（锁相环）
PWMPulse Width Modulation（脉宽调制）
RXReception（接收，在总线通信上下文中）
SPALStandard Peripheral Abstraction Layer（标准外设抽象层，本工作组名称）
SFRSpecial Function Register（特殊功能寄存器）
RTERuntime environment（运行时环境）
WPWork Package（工作组）
+ + + + + + + +
缩略语描述
STDStandard（标准）
REQRequirement（需求）
UNINITUninitialized (= not initialized)（未初始化）
+ +

5 需求规范（Requirement Specification）

+ +

5.1 功能需求（Functional Requirements）

+ +

5.1.1 通用（General）

+ + + + + + + +
ID标题描述
SRS_Gpt_12328GPT 驱动应使用 ticks 作为所有与 GPT 定时器通道相关的 API 服务的时间单位GPT 驱动应使用 ticks 作为时间单位；物理时间单位与 ticks 之间的转换应属于用户软件
SRS_Gpt_13604GPT 驱动应支持特殊自由运行向上计数器（GPT 预定义定时器）GPT 驱动应支持具有预定义滴答持续时间与位数的预定义定时器；其功能应与 GPT 定时器通道功能分离
SRS_Gpt_13605GPT 驱动应支持不同类型的预定义定时器应支持：Timer 1µs 16bit / 1µs 24bit / 1µs 32bit / 100µs 32bit
+ +

5.1.2 配置（Configuration）

+ + + + + + + +
ID标题描述
SRS_Gpt_12404每个定时器通道应可配置 one-shot/continuous 模式One-Shot 模式：达到终值后停止；Continuous 模式：达到终值后自动重启
SRS_Gpt_12114每个定时器通道应以可使用不同时钟源的方式配置应使每个定时器通道可静态配置为使用不同时钟源（若硬件支持）
SRS_Gpt_13606GPT 驱动应使可静态配置哪些预定义定时器被启用应允许静态启用/禁用 GPT 预定义定时器
+ +

5.1.3 初始化（Initialization）

+ + + + + +
ID标题描述
SRS_Gpt_12116GPT 驱动应提供将定时器通道反初始化到上电复位状态的功能应提供 Gpt_DeInit() 接口将所有硬件寄存器复位到上电复位状态
+ +

5.1.4 正常运行（Normal Operation）

+ + + + + + + + + + + + + + + +
ID标题描述
SRS_Gpt_12117GPT 驱动应提供同步读取每个定时器通道当前值的 API应（shall）提供 Gpt_GetTimeElapsed() 同步读取服务
SRS_Gpt_12128GPT 驱动应提供以特定参数启动定时器的服务参数：定时器通道 + 时间周期（ticks 数）
SRS_Gpt_12119GPT 驱动应提供停止定时器每个通道的服务应（shall）提供 Gpt_StopTimer() 停止服务
SRS_Gpt_12120GPT 驱动应提供每个通道在时间周期到达时的通知应（shall）提供每个通道的通知回调（静态可配置）
SRS_Gpt_12121GPT 驱动应提供运行时启用通知函数的功能应（shall）提供 Gpt_EnableNotification() 启用通知
SRS_Gpt_12122GPT 驱动应提供运行时禁用通知函数的功能应（shall）提供 Gpt_DisableNotification() 禁用通知
SRS_Gpt_13601GPT 驱动应能在预定义唤醒周期到期时执行唤醒事件仅在硬件支持时可用
SRS_Gpt_13602GPT 驱动应提供启用/禁用单定时器通道唤醒能力的服务应（shall）提供 Gpt_EnableWakeup()/DisableWakeup()
SRS_Gpt_13603GPT 驱动应提供选择唤醒模式的服务Normal 模式（强制）：所有通知可用；Wake-up 模式：仅唤醒通知可用
SRS_Gpt_13607GPT 预定义定时器应被 GPT 驱动自动启动/停止确保所有启用的预定义定时器在可能时运行
SRS_Gpt_13608GPT 驱动应提供同步读取每个预定义定时器当前值的 API应（shall）提供 Gpt_GetPredefTimerValue() 同步服务
+ +

5.1.5 故障操作（Fault Operation）

+

无。

+ +

6 需求可追溯性（Requirements Tracing）

+ + + + + + + + + + + +
RS_BRF 需求描述由 SRS_Gpt 满足
RS_BRF_01056AUTOSAR BSW 模块应提供标准化接口12116, 12117, 12119, 12121, 12122, 12128, 13602, 13603, 13608
RS_BRF_01064AUTOSAR BSW 应提供回调函数以访问上层模块12120, 12121, 12122
RS_BRF_01104AUTOSAR 应支持 ECU 与总线的睡眠与唤醒13601, 13602, 13603
RS_BRF_01448AUTOSAR 服务应支持模式与状态管理13603
RS_BRF_01468AUTOSAR 服务应支持相对时间测量的时间服务13604, 13605, 13606, 13607, 13608
RS_BRF_01472AUTOSAR 应支持模式13603
RS_BRF_01904AUTOSAR 微控制器抽象应提供对硬件定时器的访问12114, 12116, 12117, 12119, 12120, 12121, 12122, 12128, 12328, 12404, 13601, 13602, 13603, 13604, 13605, 13606, 13607, 13608
+ +

7 参考文献（References）

+ +

7.1 AUTOSAR 交付物（Deliverables of AUTOSAR）

+ + +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_MCUDriver.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_MCUDriver.html new file mode 100644 index 0000000..629f445 --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_MCUDriver.html @@ -0,0 +1,198 @@ + + + + +AUTOSAR SRS MCUDriver 中文翻译 + + + + +

AUTOSAR_SRS_MCUDriver 中文翻译

+

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

+ +

本翻译覆盖原文档 1-17 页正文，约 525 KB / 17 页。
+原文为软件需求规范（SRS, Software Requirements Specification），定义微控制器单元（Microcontroller Unit, MCU）驱动模块的需求——含 13 条 SRS_Mcu_NNNNN 需求 ID 与 6 行 RS_BRF_NNNNN 追溯。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、需求 ID 编号、配置可追溯性。

+ + + +
+ +

1 文档范围（Scope of document）

+

本文档规定对 MCU 驱动模块的需求。

+

约束：基础软件模块需求规范的首要范围是非安全相关系统。因此安全需求被赋予中等优先级。

+ +

如何阅读本文档（How to read this document）

+

每个需求具有唯一标识符，以前缀"BSW"开头（代表"Basic Software"，基础软件）。对于任何评审注释、备注或问题，请参考此唯一 ID 而非章节或页码！

+ +

2.1 使用约定（Conventions used）

+ + +

2.2 需求结构（Requirements structure）

+

每个模块特定章节包含 BSW 模块的简短功能描述。章节中相同种类的需求按以下标题分组（适用时）：功能需求（配置、初始化、正常运行、关闭操作、故障操作）/非功能需求（时序、资源、可用性、输出）。

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + +
缩略语描述
CSChip select（片选）
DIODigital Input Output（数字输入输出）
ECUElectric Control Unit（电子控制单元）
EOLEnd Of Line（产线下线）
ICUInterrupt Capture Unit（中断捕获单元）
MALMicrocontroller Abstraction Layer 的旧名（已被 MCAL 取代）
MCALMicrocontroller Abstraction Layer（微控制器抽象层）
MCUMicrocontroller Unit（微控制器单元）
MMUMemory Management Unit（内存管理单元）
Master / Slave主/从设备
NMINon maskable interrupt（不可屏蔽中断）
OSOperating System（操作系统）
PLLPhase Locked Loop（锁相环）
PWMPulse Width Modulation（脉宽调制）
RXReception（接收）
SPALStandard Peripheral Abstraction Layer（标准外设抽象层）
SFRSpecial Function Register（特殊功能寄存器）
RTERuntime environment（运行时环境）
WPWork Package（工作组）
+ +

4 功能概述（Functional Overview）

+

MCU 驱动 [Microcontroller Unit] 提供基础微控制器初始化、下电功能、复位与微控制器特定功能服务（其他 MCAL 软件模块所需）。初始化服务允许在启动代码之外进行灵活且与应用相关的 MCU 初始化（参见下图）。启动代码非常 MCU 特定。本文档中提供的启动代码描述仅作指导，暗示在标准化 MCU 初始化能够启动之前必须考虑的功能。

+

启动代码流程：STARTUP Code → Reset → Bootloader（需要/不需要）→ MCU driver（在 AUTOSAR 中标准化/不在范围内）→ 额外初始化服务、下电服务、复位服务。

+

MCU 驱动直接访问微控制器硬件并位于微控制器抽象层（MCAL）。

+

MCU 驱动特性：

+ + +

5 需求可追溯性（Requirements Tracing）

+ + + + + + + + + + +
RS_BRF 需求描述由 SRS_Mcu 满足
RS_BRF_00129AUTOSAR 应支持数据损坏检测与保护13701
RS_BRF_01064AUTOSAR BSW 应提供回调函数以访问上层模块12394
RS_BRF_01096AUTOSAR 应支持 ECU 的启动与关闭12331, 12350
RS_BRF_01184AUTOSAR 应支持不同的降级方法12268, 12421
RS_BRF_01856AUTOSAR 微控制器抽象应提供对内部 MCU 配置的访问12000, 12207, 12208, 12215, 12277, 12336, 12392
RS_BRF_02168AUTOSAR 诊断应提供异常操作条件的集中分类与处理12394
+ +

6 需求规范（Requirement Specification）

+ +

6.1 功能需求（Functional Requirements）

+ +

6.1.1 配置与初始化（Configuration and Initialization）

+ + + + + + + + + + + +
ID标题描述
SRS_Mcu_12421低功耗模式配置应（shall）可配置硬件支持的低功耗模式（完全 MCU 特定）
SRS_Mcu_12350应允许静态配置启动时初始化的 RAM 段MCU 驱动应允许静态配置启动时初始化的 RAM 段
SRS_Mcu_12331应提供初始化已配置 RAM 段内容的服务应（shall）提供 Mcu_InitRamSection() 初始化服务；未配置的 RAM 段不应被修改
SRS_Mcu_12392应提供查询 MCU 内所有 PLL 锁定状态的服务应（shall）提供 Mcu_GetPllStatus() 服务；返回值：Locked / Un-Locked / Unsupported
SRS_Mcu_12336应提供激活 PLL 时钟分布到整个 MCU 的服务应（shall）提供 Mcu_DistributePllClock() 服务；仅在 PLL 锁定后执行
SRS_Mcu_12207应配置时钟安全特性应（shall）配置时钟安全特性（若 HW 支持）：晶体丢失检测、limp home 模式、错误检测通知
SRS_Mcu_12208应提供初始化 MCU 时钟系统的服务应（shall）提供 Mcu_InitClock() 服务；包括 PLL 因子、PLL 锁定、时钟预分频器
+ +

6.1.2 正常运行（Normal Operation）

+ + + + + + + + +
ID标题描述
SRS_Mcu_12000应提供查询标准化复位原因的服务应（shall）提供 Mcu_GetResetReason()；标准化原因：Power On / External Hard / Internal Watchdog Timer / Other
SRS_Mcu_12215应提供查询原始复位状态的服务应（shall）提供 Mcu_GetRawReset()；返回完整、原始、µC 特定的复位信息（用于诊断错误内存存储）
SRS_Mcu_12277应提供复位触发函数应（shall）提供 Mcu_PerformReset() 复位触发函数（用于致命错误处理）
SRS_Mcu_13701应提供查询 RAM 状态的服务应（shall）提供 Mcu_GetRamState()；标准化状态：RAM state valid / invalid（默认）
+ +

6.1.3 故障操作（Fault operation）

+ + + + + +
ID标题描述
SRS_Mcu_12394应提供时钟源失败的通知应（shall）提供时钟生成失败通知回调；不应在启动阶段调用（与 DEM 交互）
+ +

6.1.4 关闭操作（Shutdown operation）

+ + + + + +
ID标题描述
SRS_Mcu_12268应提供激活 MCU 节能模式的服务应（shall）提供 Mcu_SetMode() 服务以激活 µC 节能模式
+ +

6.2 备注（Remarks）

+

本章 [MCU 驱动] 集中了多种功能类型以解决从 MCU 节能模式或复位恢复后正确初始化的问题。配置工具对于此功能的正确实现非常重要，可能需要成为最终解决方案的一部分。

+ +

7 参考文献（References）

+ +

7.1 AUTOSAR 交付物（Deliverables of AUTOSAR）

+ + +

7.2 相关标准与规范（Related standards and norms）

+ + +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_SPALGeneral.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_SPALGeneral.html new file mode 100644 index 0000000..eab64d9 --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SRS_SPALGeneral.html @@ -0,0 +1,260 @@ + + + + +AUTOSAR SRS SPALGeneral 中文翻译 + + + + +

AUTOSAR_SRS_SPALGeneral 中文翻译

+

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

+ +

本翻译覆盖原文档 1-21 页正文，约 580 KB / 21 页。
+原文为软件需求规范（SRS, Software Requirements Specification），定义标准外设抽象层（Standard Peripheral Abstraction Layer, SPAL）的通用需求——适用于 MCAL 与 ECU 抽象层所有驱动与处理器（22 条 SRS_SPAL_NNNNN 需求 ID + 8 行 RS_BRF_NNNNN 追溯）。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、需求 ID 编号、配置可追溯性。

+ + + +
+ +

1 文档范围（Scope of Document）

+

本文档规定对基础软件模块（BSW）的以下软件层的通用需求：

+ +

这些模块的类型为：

+ +

模块选择源自 WP 架构 BSW 模块列表与分层架构。范围包括：

+ +

约束：基础软件模块需求规范的首要范围是非安全相关系统。因此安全需求被赋予中等优先级。

+ +

需求指南（Requirements Guidelines）

+

应参考现有规范（以单一需求形式）。与这些规范的差异指定为附加需求。

+ +

2.1 使用约定（Conventions Used）

+

使用 RFC 2119 关键字：MUST/SHALL/REQUIRED（绝对要求）、MUST NOT/SHALL NOT（绝对禁止）、SHOULD/RECOMMENDED（推荐）、SHOULD NOT（不推荐）、MAY/OPTIONAL（可选）。

+ +

2.2 需求质量（Requirements quality）

+

所有需求应（shall）具有以下属性：

+ + +

2.3 需求标识（Requirements identification）

+

每个需求具有唯一标识符，以前缀"BSW"开头。

+ +

2.4 需求结构（Requirements structure）

+

每章应（shall）以以下方式组织：功能需求（配置/初始化/正常运行/关闭操作/故障操作）/非功能需求（时序/资源使用/可用性/输出）。

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + +
缩略语描述
CSChip Select（片选）
DIODigital Input Output（数字输入输出）
ECUElectric Control Unit（电子控制单元）
ICUInterrupt Capture Unit（中断捕获单元）
MALMicrocontroller Abstraction Layer 的旧名（已被 MCAL 取代）
MCALMicrocontroller Abstraction Layer（微控制器抽象层）
MCUMicrocontroller Unit（微控制器单元）
MMUMemory Management Unit（内存管理单元）
Master / Slave主/从设备
NMINon Maskable Interrupt（不可屏蔽中断）
OSOperating System（操作系统）
PLLPhase Locked Loop（锁相环）
PWMPulse Width Modulation（脉宽调制）
RXReception（接收）
SPALStandard Peripheral Abstraction Layer（标准外设抽象层）
SFRSpecial Function Register（特殊功能寄存器）
RTERuntime environment（运行时环境）
WPWork Package（工作组）
+ +

4 概念问题（Conceptual Issues）

+ +

4.1 一般规则（General Rules）

+

本章包含适用于 MCAL 与 ECU 抽象层所有模块的通用概念性需求（不一定适用于其他层的 BSW 模块）。

+ +

4.2 不受时钟频率影响的驱动列表（List of drivers not affected by the clock frequency）

+

列于本文档中的驱动在切换时钟频率时需特别注意。

+ +

4.3 MCAL 相关 ECU 电源模式（MCAL relevant ECU Power Modes）

+

ECU 状态机定义了多个电源模式（Normal、Stop、Sleep 等），MCAL 驱动应能适配各模式。

+ +

4.4 唤醒场景（Wake-up Scenarios）

+

ECU 可由多种唤醒源唤醒（reset、watchdog、NMI、interrupt 等），由 MCAL 驱动和/或 MCU 驱动初始化。

+ +

4.5 驱动调度与集成（Scheduling and integration of drivers）

+

驱动应（shall）按定义顺序初始化：禁用全局中断 → 初始化整体寄存器（MCAL 系统模块）→ 初始化所有驱动 → 可启用全局中断。

+ +

5 需求可追溯性（Requirements Tracing）

+ + + + + + + + + + + + +
RS_BRF 需求描述由 SRS_SPAL 满足
RS_BRF_01064AUTOSAR BSW 应提供回调函数以访问上层模块00157, 12056
RS_BRF_01096AUTOSAR 应支持 ECU 的启动与关闭12057, 12068, 12125, 12163, 12461, 12463
RS_BRF_01104AUTOSAR 应支持 ECU 与总线的睡眠与唤醒12067, 12069, 12267
RS_BRF_01152AUTOSAR 应支持有限的动态重配置12265
RS_BRF_01440AUTOSAR 服务应支持系统诊断功能12064
RS_BRF_01496AUTOSAR 应标准化 ECU 退出 SLEEP 模式的事件处理12267
RS_BRF_02168AUTOSAR 诊断应提供异常操作条件的集中分类与处理00157, 12064
RS_BRF_02232AUTOSAR 应支持带运行时断言检查的开发00157, 12448
+ +

6 需求规范（Requirement Specification）

+ +

6.1 功能需求（Functional Requirements）

+ +

6.1.1 通用需求（General Requirements）

+ +
配置（Configuration）
+ + + + + + + +
ID标题描述
SRS_SPAL_12263应允许链接时配置特定模块参数类型允许在链接时配置：硬件寄存器值、模块内值（如时序）、回调函数
SRS_SPAL_12056应允许静态配置通知机制所有驱动模块应允许静态配置通知机制；回调函数指针不应通过 API 传递
SRS_SPAL_12267唤醒源应由 MCAL 驱动和/或 MCU 驱动初始化可能的唤醒源：reset、watchdog、NMI、interrupt 等
+ +
初始化（Initialization）
+ + + + + + + + + + + + +
ID标题描述
SRS_SPAL_12057所有驱动模块应实现初始化接口应实现 <Mod>_Init() 初始化服务（初始化模块全局变量与 SFR）
SRS_SPAL_12125所有驱动模块应仅初始化已配置的资源未在配置文件中配置的资源不应被修改
SRS_SPAL_12163所有驱动模块应实现反初始化接口应实现 <Mod>_DeInit() 服务（复位 SFR 到默认复位值）
SRS_SPAL_12461控制器寄存器初始化的特定规则应适用于所有驱动实现4 条规则：①硬件仅单用时由实现驱动初始化；②I/O 寄存器由 PORT 驱动初始化；③多模块影响非 I/O 寄存器由 MCU 驱动初始化；④一次性写入寄存器由启动代码初始化
SRS_SPAL_12462寄存器初始化设置应被发布驱动实现者应在其文档中发布所有寄存器初始化设置
SRS_SPAL_12463寄存器初始化设置应被组合并转发配置器应组合不同驱动的所有初始化设置并检查一致性；若成功则转发到负责初始化硬件的模块
SRS_SPAL_12068MCAL 模块应以定义顺序初始化4 步顺序：禁用全局中断 → 初始化整体寄存器（MCAL 系统模块）→ 初始化所有驱动 → 可启用全局中断
SRS_SPAL_12069所有从唤醒中断唤醒的 SPAL 驱动应报告唤醒原因通过 IO 硬件抽象向 ECU 状态管理器报告；通知在 IO 硬件抽象模块中处理后发送到 EcuM
+ +
正常运行（Normal Operation）
+ + + + + + + + + +
ID标题描述
SRS_SPAL_00157所有驱动与处理器应实现通知机制4 种机制：轮询、回调函数、默认错误追踪器（DET）错误报告、诊断事件管理器（DEM）事件报告
SRS_SPAL_12169提供不同操作模式的驱动应提供模式选择服务应提供 <Mod>_SetMode() 服务以在不完全反初始化的情况下切换模式
SRS_SPAL_12063所有驱动模块应仅支持原始值模式通过 API 服务传递的值应直接使用，不再进行缩放（缩放是 ECU 抽象层的任务）
SRS_SPAL_12075具有随机流能力的驱动应使用应用缓冲区调用方在驱动作业处理期间不应修改数据
SRS_SPAL_12129ISR 应负责重置中断标志并调用相应通知函数通知函数可由用户定义，因此不允许直接访问硬件
+ +
故障操作（Fault Operation）
+ + + + + + +
ID标题描述
SRS_SPAL_12064所有驱动模块应在操作模式改变导致正在运行操作降级时引发错误正在运行的操作应被保持；此错误情况在正确系统设计中不应发生
SRS_SPAL_12448所有驱动模块在开发错误检测后应有特定行为4 步行为：①上报错误到 DET；②跳过所需功能（无动作离开服务）；③标准返回值返回 E_NOT_OK；④任意返回值返回 0
+ +
关闭操作（Shutdown Operation）
+ + + + + +
ID标题描述
SRS_SPAL_12067所有驱动模块应根据所选操作模式设置唤醒条件应允许启用模块特定的唤醒中断
+ +

6.2 非功能需求（Non-Functional Requirements）

+ +

6.2.1 时序要求（Timing requirements）

+ + + + + + +
ID标题描述
SRS_SPAL_12077所有驱动应提供非阻塞实现非阻塞实现指避免长期循环等"不敏感、不协作的处理器时间使用"
SRS_SPAL_12078驱动应以最有效的方式编码以节约内存与运行时资源避免资源浪费
+ +

6.2.2 软件设计要求（Software design requirements）

+ + + + + + +
ID标题描述
SRS_SPAL_12092驱动的 API 应通过其处理器或管理器访问不允许绕过处理器/管理器直接访问驱动的 API（除非没有处理器/管理器）
SRS_SPAL_12265配置数据应保持不变通过 init 函数传递给模块的 init 结构内容应保持不变且在运行时可用（通常位于 ROM）
+ +

6.2.3 流程要求（Process requirements）

+ + + + + +
ID标题描述
SRS_SPAL_12264应提供配置项规范SWS 应指定每个配置元素：是否可在编译前/后配置；位置（init 数据结构、配置头文件 *_Cfg.h）
+ +

7 参考文献（References）

+ +

7.1 AUTOSAR 交付物（Deliverables of AUTOSAR）

+ + +

7.2 相关标准与规范（Related standards and norms）

+

无。

+ +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_CoreTest.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_CoreTest.html new file mode 100644 index 0000000..b56662f --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_CoreTest.html @@ -0,0 +1,308 @@ + + + + +AUTOSAR SWS CoreTest 中文翻译 + + + + +

AUTOSAR_SWS_CoreTest 中文翻译

+

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

+ +

本翻译覆盖原文档 1-54 页正文，约 1.05 MB / 54 页。
+原文为软件规范（SWS, Software Specification），定义 Core Test（核心测试）驱动模块的 API 与配置——含 11 个 API 函数 + 1 个调度函数 + 1 个通知回调 + 1 个扩展生产错误 + 多个 SWS_CorTst_NNNNN 规范项。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、API 函数、错误分类、配置参数。

+ + + +
+ +

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

+

本规约规定 AUTOSAR 基础软件模块 Core Test（核心测试，CorTst）的功能、API 与配置。CorTst 位于微控制器抽象层（MCAL），用于测试 MCU 核心硬件（如寄存器、ALU、地址生成器、内存接口、缓存、中断/异常处理、MMU/MPU 等）。

+

CorTst 提供后台（Background）与前台（Foreground）两种测试模式：

+ +

测试通过比较校验和/签名与黄金参考值（Golden Reference Value）判断 pass/fail 状态。

+ +

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

+ + + + + + + + + + + + + + + + + + +
缩略语描述
CorTstCore Test（核心测试）
CPUCentral Processing Unit（中央处理器）
MPUMemory Protection Unit（内存保护单元）
MMUMemory Management Unit（内存管理单元）
DEMDiagnostic Event Manager（诊断事件管理器）
DETDefault Error Tracer（默认错误追踪器）
EcuMECU State Manager（ECU 状态管理器）
ISRInterrupt Service Routine（中断服务例程）
BISTBuilt in Self Test（内建自测试）
IRQInterrupt Request（中断请求）
CoreA CPU plus closely located functional resources（CPU 及其紧密相关的功能资源）
Atomic SequenceSequence of software code execution which must not be interrupted at any time（任何时候都不得被中断的软件代码执行序列）
Checksum / SignatureNumerical representation of the result of a test execution（测试执行结果的数值表示）
Golden (Ref.) ValueReference value used for comparison（用于比较的参考值）
+ +

3 相关文档（Related documentation）

+ + +

4 约束与假设（Constraints and assumptions）

+

CorTst 实现可能仅限于 power-up/start-up 阶段执行（此时核资源不在线程或实体之间共享，例如 IRQ 控制器、DMA），或仅限于测试运行时未共享的资源（如 CPU 本身）。多微控制器系统不在 CorTst 范围内。

+ +

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

+ +

5.1 文件结构（File structure）

+

5.1.1 代码文件结构（Code File Structure）

+
CorTst.c                    # 主源文件
+CorTst_Lcfg.c               # Link-time 配置
+CorTst_PBcfg.c              # PostBuild 配置
+

CorTst 依赖 EcuM（资源管理）、DEM（错误报告）、DET（开发错误追踪）、OS（中断管理）。

+ +

6 需求可追溯性（Requirements traceability）

+

CorTst 满足 SRS_CoreTst_NNNNN 中的 25+ 条需求（参见 SRS 翻译）以及 RS_BRF_NNNNN 顶层需求。CorTst 自身的 SWS_CorTst_NNNNN 规范项 ID 约 100+ 条（详细列表见原文第 6/7/8/10 章；编号范围 00001-01004）。

+ +

7 功能规范（Functional specification）

+ +

7.1 背景与前台测试（Background and Foreground Tests）

+

完整测试由 2 步组成：

+
    +
  1. 运行专用指令序列以激励门电路和触发器，并计算校验和/签名；
    2. +
  2. 提供比较的校验和/签名——或——将计算的校验和与参考值比较，决定测试通过或失败。
    3. +
+

CorTst 计算两个步骤并返回 pass/fail 状态，或仅计算校验和并提供完成通知给调用实体。

+ +

7.2 多核支持（Multicore Support）

+

应（shall）可对硅设备内每个相等的核实例执行 CorTst。CorTst 本身与 API 由于其作为位于较低 AUTOSAR 层的驱动程序的特性，无需了解系统架构本身。

+ +

7.3 错误分类（Error classification）

+ +

7.3.1 开发错误（Development Errors）

+ + + + + + + + + + +
错误码值含义
CORTST_E_UNINIT0x01CorTst 未初始化
CORTST_E_ALREADY_INITIALIZED0x02CorTst 已初始化
CORTST_E_PARAM_POINTER0x03无效的指针
CORTST_E_PARAM_VALUE0x04无效的参数值
CORTST_E_BUSY0x05测试忙
CORTST_E_NOT_VALID0x06签名/校验和无效
+ +

7.3.2 运行时错误（Runtime Errors）

+ + + + + +
错误码值含义
无。
+ +

7.3.3 瞬态故障（Transient Faults）

+

无。

+ +

7.3.4 生产错误（Production Errors）

+

无（CorTst 不直接产生生产错误；由 DEM 报告）。

+ +

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

+ + + + + +
错误码含义
CORTST_E_CORE_FAILURE核心测试失败（Core 故障）
+ +

8 API 规范（API specification）

+ +

8.1 导入类型（Imported types）

+ + +

8.2 类型定义（Type Definitions）

+ + + + + + +
类型描述
CorTst_ConfigTypeCorTst 抽象配置类型
CorTst_ResultTypeCorTst 测试结果类型（PASS / FAIL / NOT_TESTED / UNDEFINED）
+ +

8.3 函数定义（Function definitions）

+ +

8.3.1 通用 API（General API）

+ + + + + + +
API签名功能
CorTst_Initvoid CorTst_Init(const CorTst_ConfigType* ConfigPtr)初始化 CorTst
CorTst_DeInitvoid CorTst_DeInit(void)反初始化 CorTst
+ +

8.3.2 测试控制 API（Test Control API）

+ + + + + + + +
API签名功能
CorTst_Abortvoid CorTst_Abort(void)中止正在运行的测试
CorTst_StartStd_ReturnType CorTst_Start(CorTst_TestIdType TestId, uint8 ChannelId)启动指定测试
CorTst_GetVersionInfovoid CorTst_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr)获取版本信息
+ +

8.3.3 测试状态 API（Test Status API）

+ + + + + + +
API签名功能
CorTst_GetStateCorTst_StateType CorTst_GetState(void)获取当前测试状态（IDLE/RUNNING/COMPLETED/ABORTED）
CorTst_GetCurrentStatusCorTst_ResultType CorTst_GetCurrentStatus(CorTst_TestIdType TestId)获取指定测试的当前结果
+ +

8.3.4 测试签名 API（Test Signature API）

+ + + + + + +
API签名功能
CorTst_GetSignatureStd_ReturnType CorTst_GetSignature(CorTst_SignatureType* SignaturePtr, CorTst_LengthType* LengthPtr)获取后台测试签名/校验和
CorTst_GetFgndSignatureStd_ReturnType CorTst_GetFgndSignature(CorTst_SignatureType* SignaturePtr, CorTst_LengthType* LengthPtr)获取前台测试签名/校验和
+ +

8.3.5 测试启动 API（Test Start API）

+

见 8.3.2 CorTst_Start。

+ +

8.3.6 调度函数（Scheduled functions）

+ + + + + +
API签名功能
CorTst_MainFunctionvoid CorTst_MainFunction(void)主函数（处理后台测试调度）
+ +

8.3.7 回调通知（Callback Notifications）

+ + + + + +
API签名功能
CorTst_TestCompletedNotificationvoid CorTst_TestCompletedNotification(CorTst_TestIdType TestId, CorTst_ResultType Result)测试完成通知回调（应用实现）
+ +

CorTst API 完整清单：11 个 API 函数（Init/DeInit/Start/Abort/GetState/GetCurrentStatus/GetSignature/GetFgndSignature/GetVersionInfo/MainFunction/TestCompletedNotification）。

+ +

9 序列图（Sequence diagrams）

+
    +
  1. 启动后台测试：应用 → CorTst_Start() → CorTst 入队 → CorTst_MainFunction() 处理 → 原子序列执行 → CorTst_GetSignature() 读取签名 → CorTst_TestCompletedNotification() 通知应用；
    2. +
  2. 启动前台测试：应用 → CorTst_Start() → 立即执行 → CorTst_GetCurrentStatus() 读取结果；
    3. +
  3. 取消测试：应用 → CorTst_Abort() → CorTst 取消运行测试 → 状态置为 ABORTED；
    4. +
  4. 多核测试：每个核独立调用 CorTst API。
    5. +
+ +

10 配置规范（Configuration specification）

+ +

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

+ +

10.1.1 CorTst（根容器）

+ + + + + + + + +
参数描述
CorTstDevErrorDetect开发错误检测开关
CorTstVersionInfoApiCorTst_GetVersionInfo() API 开关
CorTstMainFunctionPeriod主函数调度周期（秒）
CorTstEcucPartitionRefECU 分区引用
+ +

10.1.2 CorTstGeneral（通用配置）

+ + + + + + +
参数描述
CorTstNumberOfTests测试数量
CorTstMulticoreSupport多核支持开关
+ +

10.1.3 CorTstTest（测试配置）

+ + + + + + + +
参数描述
CorTstTestId测试 ID
CorTstTestPartitionRef测试分区引用
CorTstTestAtomicSequenceRef原子序列引用
+ +

10.2 发布信息（Published Information）

+

发布信息包括 CorTst 模块版本、配置变体、测试数量、多核支持等。

+ +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_GPTDriver.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_GPTDriver.html new file mode 100644 index 0000000..5f3c31f --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_GPTDriver.html @@ -0,0 +1,336 @@ + + + + +AUTOSAR SWS GPTDriver 中文翻译 + + + + +

AUTOSAR_SWS_GPTDriver 中文翻译

+

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

+ +

本翻译覆盖原文档 1-64 页正文，约 1.28 MB / 64 页。
+原文为软件规范（SWS, Software Specification），定义通用定时器（General Purpose Timer, GPT）驱动模块的 API 与配置——含 15 个 API 函数（含通知回调）+ 2 个开发错误 + 多个 SWS_Gpt_NNNNN 规范项。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、API 函数、错误分类、配置参数。

+ + + +
+ +

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

+

本规约规约 AUTOSAR 基础软件模块通用定时器（General Purpose Timer Driver, GPT）的功能、API 与配置。GPT 驱动位于微控制器抽象层（MCAL），初始化并控制微控制器的内部通用定时器。

+

GPT 驱动提供以下服务和配置参数：

+ + +

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

+ + + + + + + + + + + + + + +
缩略语描述
GPTGeneral Purpose Timer（通用定时器）
MCALMicrocontroller Abstraction Layer（微控制器抽象层）
GPT Predef TimerGPT 预定义定时器（自由运行向上计数器，1µs 16/24/32 bit + 100µs 32 bit）
DEMDiagnostic Event Manager（诊断事件管理器）
DETDefault Error Tracer（默认错误追踪器）
ISRInterrupt Service Routine（中断服务例程）
OSOperating System（操作系统）
OS Alarm操作系统告警服务
One-Shot / Continuous单次 / 连续模式
Wakeup唤醒（事件）
+ +

3 相关文档（Related documentation）

+ + +

4 约束与假设（Constraints and assumptions）

+

GPT 驱动为基于硬件的 MCAL 驱动。某些服务（PLL 锁定、时钟分布、唤醒模式）依赖硬件支持。

+ +

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

+ +

5.1 文件结构（File structure）

+

5.1.1 代码文件结构（Code File Structure）

+
Gpt.c                    # 主源文件
+Gpt_Irq.c                # ISR 实现
+Gpt_Lcfg.c               # Link-time 配置
+Gpt_PBcfg.c              # PostBuild 配置
+

GPT 驱动依赖 EcuM（资源管理）、DEM（错误报告）、DET（开发错误追踪）、OS（中断管理）。

+ +

6 需求可追溯性（Requirements traceability）

+

GPT 驱动满足 SRS_Gpt_NNNNN 中的 18 条需求（参见 SRS 翻译）以及 RS_BRF_NNNNN 顶层需求。GPT 自身的 SWS_Gpt_NNNNN 规范项 ID 约 400+ 条（详细列表见原文第 6/7/8/10 章；编号范围 00006-00403）。

+ +

7 功能规范（Functional specification）

+ +

7.1 预配置（Pre-Configuration）

+

GPT 驱动允许以下预配置：

+ + +

7.2 通用行为（General Behavior）

+

GPT 驱动正常操作流程：

+
    +
  1. 调用 Gpt_Init() 初始化 GPT 模块；
    2. +
  2. 使用 Gpt_StartTimer(Channel, Value) 启动定时器；
    3. +
  3. 使用 Gpt_GetTimeElapsed(Channel) / Gpt_GetTimeRemaining(Channel) 获取时间值；
    4. +
  4. 定时时间到达后触发通知回调（如果已启用）；
    5. +
  5. 使用 Gpt_StopTimer(Channel) 停止定时器；
    6. +
  6. 使用 Gpt_DeInit() 反初始化。
    7. +
+ +

7.3 错误分类（Error classification）

+ +

7.3.1 开发错误（Development Errors）

+ + + + + + + + + + + + +
错误码含义
GPT_E_UNINITGPT 未初始化
GPT_E_ALREADY_INITIALIZEDGPT 已初始化
GPT_E_INIT_FAILED初始化失败
GPT_E_PARAM_CHANNEL无效的通道引用
GPT_E_PARAM_VALUE无效的参数值
GPT_E_PARAM_POINTER无效的指针
GPT_E_BUSY通道忙
GPT_E_MODE当前模式不允许该操作
+ +

7.3.2 运行时错误（Runtime Errors）

+

无。

+ +

7.3.3 瞬态故障（Transient Faults）

+

无。

+ +

7.3.4 生产错误（Production Errors）

+

无。

+ +

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

+

无。

+ +

8 API 规范（API specification）

+ +

8.1 导入类型（Imported types）

+ + +

8.2 类型定义（Type Definitions）

+ + + + + + + + + + +
类型描述
Gpt_ConfigTypeGPT 抽象配置类型（外部数据结构）
Gpt_ChannelTypeGPT 通道 ID（uint8/16/32）
Gpt_ValueTypeGPT 定时器值（uint32）
Gpt_ModeTypeGPT 模式枚举（GPT_MODE_NORMAL / GPT_MODE_SLEEP）
Gpt_PredefTimerType预定义定时器类型枚举（GPT_PREDEF_TIMER_1US_16BIT / 24BIT / 32BIT / GPT_PREDEF_TIMER_100US_32BIT）
Gpt_NotificationType通知回调函数指针类型
+ +

8.3 函数定义（Function definitions）

+ +

8.3.1 通用 API（General API）

+ + + + + + + +
API签名功能
Gpt_Initvoid Gpt_Init(const Gpt_ConfigType* ConfigPtr)初始化 GPT 模块
Gpt_DeInitvoid Gpt_DeInit(void)反初始化 GPT 模块（将 SFR 复位到默认值）
Gpt_GetVersionInfovoid Gpt_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr)获取版本信息
+ +

8.3.2 定时器控制 API（Timer Control API）

+ + + + + + + + + +
API签名功能
Gpt_GetTimeElapsedGpt_ValueType Gpt_GetTimeElapsed(Gpt_ChannelType Channel)获取通道已用时间（自启动以来经过的 ticks）
Gpt_GetTimeRemainingGpt_ValueType Gpt_GetTimeRemaining(Gpt_ChannelType Channel)获取通道剩余时间（到到期还剩的 ticks）
Gpt_StartTimervoid Gpt_StartTimer(Gpt_ChannelType Channel, Gpt_ValueType Value)启动通道定时器（以 ticks 为单位）
Gpt_StopTimervoid Gpt_StopTimer(Gpt_ChannelType Channel)停止通道定时器
Gpt_GetPredefTimerValueStd_ReturnType Gpt_GetPredefTimerValue(Gpt_PredefTimerType PredefTimer, uint32* ValuePtr)获取预定义定时器当前值
+ +

8.3.3 通知控制 API（Notification Control API）

+ + + + + + +
API签名功能
Gpt_EnableNotificationvoid Gpt_EnableNotification(Gpt_ChannelType Channel)启用通道通知（达到时间时调用回调）
Gpt_DisableNotificationvoid Gpt_DisableNotification(Gpt_ChannelType Channel)禁用通道通知
+ +

8.3.4 模式与唤醒 API（Mode and Wakeup API）

+ + + + + + + + +
API签名功能
Gpt_SetModevoid Gpt_SetMode(Gpt_ModeType Mode)设置 GPT 模式（Normal/Sleep）
Gpt_DisableWakeupvoid Gpt_DisableWakeup(Gpt_ChannelType Channel)禁用通道唤醒能力
Gpt_EnableWakeupvoid Gpt_EnableWakeup(Gpt_ChannelType Channel)启用通道唤醒能力
Gpt_CheckWakeupStd_ReturnType Gpt_CheckWakeup(EcuM_WakeupSourceType WakeupSource)检查唤醒源（验证唤醒事件）
+ +

8.3.5 通知回调（Notification Callback）

+ + + + + +
API签名功能
Gpt_Notification_<channel>void Gpt_Notification_<channel>(void)每通道通知回调（应用实现，模板形式）
+ +

GPT API 完整清单：15 个 API 函数（Init/DeInit/GetVersionInfo/GetTimeElapsed/GetTimeRemaining/StartTimer/StopTimer/EnableNotification/DisableNotification/SetMode/DisableWakeup/EnableWakeup/CheckWakeup/GetPredefTimerValue + 1 个通知回调模板）。

+ +

9 序列图（Sequence diagrams）

+
    +
  1. 启动定时器：应用 → Gpt_StartTimer(Channel, Value) → 硬件定时器启动；
    2. +
  2. 查询时间：应用 → Gpt_GetTimeElapsed(Channel) → 返回已用 ticks；
    3. +
  3. 定时器到期通知：硬件中断 → ISR → 通知回调 Gpt_Notification_<channel>() → 应用；
    4. +
  4. 停止定时器：应用 → Gpt_StopTimer(Channel) → 硬件定时器停止；
    5. +
  5. 进入睡眠模式：应用 → Gpt_SetMode(GPT_MODE_SLEEP) → 仅唤醒通知可用；
    6. +
  6. 唤醒检查：硬件唤醒事件 → Gpt_CheckWakeup(WakeupSource) → 验证唤醒原因。
    7. +
+ +

10 配置规范（Configuration specification）

+ +

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

+ +

10.1.1 Gpt（根容器）

+ + + + + + + + + + + + +
参数描述
GptDevErrorDetect开发错误检测开关
GptVersionInfoApiGpt_GetVersionInfo() API 开关
GptReportWakeupSource唤醒源报告开关
GptDeinitApiGpt_DeInit() API 开关
GptEnableDisableNotificationApi通知启用/禁用 API 开关
GptPredefTimerApi预定义定时器 API 开关
GptSetModeApiGpt_SetMode() API 开关
GptWakeupFunctionalityApi唤醒功能 API 开关
+ +

10.1.2 GptGeneral（通用配置）

+ + + + + + +
参数描述
GptNumberOfGptChannelsGPT 通道数量
GptNumberOfGptPredefTimers启用的预定义定时器数量
+ +

10.1.3 GptChannelConfig（通道配置）

+ + + + + + + + + + + +
参数描述
GptChannelId通道 ID
GptChannelTickFrequency通道滴答频率（Hz）
GptChannelTickValueMax通道最大滴答值
GptChannelMode模式（One-Shot / Continuous）
GptNotificationCallback通知回调函数指针
GptEnableWakeup是否支持唤醒
GptWakeupSourceId唤醒源 ID（EcuM）
+ +

10.1.4 GptPredefTimerConfig（预定义定时器）

+ + + + + + + + +
参数描述
GptPredefTimerId预定义定时器 ID
GptPredefTimerType类型（1µs 16/24/32 bit / 100µs 32 bit）
GptPredefTimerFrequency频率（Hz）
GptPredefTimerTicksPerBase每个 base 的 ticks
+ +

10.1.5 GptClockReference（时钟引用）

+ + + + + +
参数描述
GptClockReference时钟引用（来自 MCU 驱动）
+ +

10.2 发布信息（Published Information）

+

发布信息包括 GPT 模块版本、配置变体、通道数量、预定义定时器数量等。

+ +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_MCUDriver.html b/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_MCUDriver.html new file mode 100644 index 0000000..3d1dfe2 --- /dev/null +++ b/translation_zh-CN/P4_MCAL/AUTOSAR_SWS_MCUDriver.html @@ -0,0 +1,344 @@ + + + + +AUTOSAR SWS MCUDriver 中文翻译 + + + + +

AUTOSAR_SWS_MCUDriver 中文翻译

+

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

+ +

本翻译覆盖原文档 1-49 页正文，约 1.14 MB / 49 页。
+原文为软件规范（SWS, Software Specification），定义微控制器单元（MCU）驱动模块的 API 与配置——含 11 个 API 函数 + 7 个开发错误 + 1 个生产错误 + 多个 SWS_Mcu_NNNNN 规范项。
+本翻译为"忠实精翻+结构化索引"型——保留全部章节、API 函数、错误分类、配置参数。

+ + + +
+ +

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

+

本规约规约 AUTOSAR 基础软件模块 MCU 驱动（Microcontroller Unit Driver, MCU）的功能、API 与配置。MCU 驱动位于微控制器抽象层（MCAL），提供微控制器初始化、下电功能、复位与微控制器特定功能服务（其他 MCAL 软件模块所需）。

+

MCU 驱动直接访问微控制器硬件。其特性：

+ + +

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

+ + + + + + + + + + + + + + + +
缩略语描述
MCUMicrocontroller Unit（微控制器单元）
MCALMicrocontroller Abstraction Layer（微控制器抽象层）
PLLPhase Locked Loop（锁相环）
RAMRandom Access Memory（随机访问存储器）
DEMDiagnostic Event Manager（诊断事件管理器）
DETDefault Error Tracer（默认错误追踪器）
EcuMECU State Manager（ECU 状态管理器）
SFRSpecial Function Register（特殊功能寄存器）
OSOperating System（操作系统）
Power On Reset上电复位
Watchdog Timer Reset看门狗定时器复位
+ +

3 相关文档（Related documentation）

+ + +

4 约束与假设（Constraints and assumptions）

+

MCU 驱动实现可能仅在 power-up/start-up 阶段执行，或仅测试运行时未共享的资源。多微控制器系统不在 MCU 驱动范围内。

+ +

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

+ +

5.1 文件结构（File structure）

+

5.1.1 代码文件结构（Code File Structure）

+
Mcu.c                    # 主源文件
+Mcu_Lcfg.c               # Link-time 配置
+Mcu_PBcfg.c              # PostBuild 配置
+

MCU 驱动依赖 EcuM（资源管理）、DEM（错误报告）、DET（开发错误追踪）、OS（中断管理）。

+ +

6 需求可追溯性（Requirements traceability）

+

MCU 驱动满足 SRS_Mcu_NNNNN 中的 13 条需求（参见 SRS 翻译）以及 RS_BRF_NNNNN 顶层需求。MCU 自身的 SWS_Mcu_NNNNN 规范项 ID 约 200+ 条（详细列表见原文第 6/7/8/10 章；编号范围 00005-00258）。

+ +

7 功能规范（Functional specification）

+ +

7.1 预配置（Pre-Configuration）

+

MCU 驱动允许以下预配置：

+ + +

7.2 通用行为（General Behavior）

+

MCU 驱动初始化序列：

+
    +
  1. 调用 Mcu_Init() 初始化 MCU 模块（设置 SFR 寄存器）；
    2. +
  2. 调用 Mcu_InitRamSection() 初始化 RAM 段（可选）；
    3. +
  3. 调用 Mcu_InitClock() 初始化时钟系统（PLL 因子、PLL 锁定等）；
    4. +
  4. 调用 Mcu_DistributePllClock() 激活 PLL 时钟分布；
    5. +
  5. 使用 Mcu_GetPllStatus() 检查 PLL 状态；
    6. +
  6. 调用 Mcu_GetResetReason() 获取复位原因；
    7. +
  7. 调用 Mcu_SetMode() 切换到节能模式（如需）。
    8. +
+ +

7.3 错误分类（Error classification）

+ +

7.3.1 开发错误（Development Errors）

+ + + + + + + + + + + + +
错误码含义
MCU_E_PARAM_CONFIG无效的配置指针
MCU_E_PARAM_CLOCK无效的时钟引用
MCU_E_PARAM_MODE无效的模式引用
MCU_E_PARAM_RAMSECTION无效的 RAM 段引用
MCU_E_PLL_NOT_LOCKEDPLL 未锁定
MCU_E_UNINITMCU 未初始化
MCU_E_PARAM_POINTER无效的指针
MCU_E_INIT_FAILED初始化失败
+ +

7.3.2 运行时错误（Runtime Errors）

+

无。

+ +

7.3.3 瞬态故障（Transient Faults）

+

无。

+ +

7.3.4 生产错误（Production Errors）

+ + + + + +
错误码含义
MCU_E_CLOCK_FAILURE时钟源失败
+ +

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

+

无。

+ +

8 API 规范（API specification）

+ +

8.1 导入类型（Imported types）

+ + +

8.2 类型定义（Type Definitions）

+ + + + + + + + + + + + +
类型描述
Mcu_ConfigTypeMCU 抽象配置类型（外部数据结构）
Mcu_PllStatusTypePLL 状态枚举（MCU_PLL_LOCKED / MCU_PLL_UNLOCKED / MCU_PLL_STATUS_UNDEFINED）
Mcu_ClockType时钟设置 ID（uint8/16/32）
Mcu_ResetType标准化复位原因枚举（MCU_POWER_ON_RESET / MCU_WATCHDOG_RESET / MCU_SOFT_RESET / MCU_HW_RESET / MCU_UNDEFINED_RESET）
Mcu_RawResetType原始复位值（µC 特定，uint8/16/32）
Mcu_ModeTypeMCU 节能模式 ID（uint8/16/32）
Mcu_RamSectionTypeRAM 段 ID（uint8/16/32）
Mcu_RamStateTypeRAM 状态枚举（MCU_RAMSTATE_INVALID / MCU_RAMSTATE_VALID）
+ +

8.3 函数定义（Function definitions）

+ + + + + + + + + + + + + + + +
API签名功能
Mcu_Initvoid Mcu_Init(const Mcu_ConfigType* ConfigPtr)初始化 MCU 模块（设置 SFR）
Mcu_InitRamSectionStd_ReturnType Mcu_InitRamSection(Mcu_RamSectionType RamSection)初始化已配置 RAM 段
Mcu_InitClockStd_ReturnType Mcu_InitClock(Mcu_ClockType ClockSetting)初始化时钟系统（PLL 因子、PLL 锁定）
Mcu_DistributePllClockStd_ReturnType Mcu_DistributePllClock(void)激活 PLL 时钟分布到整个 MCU
Mcu_GetPllStatusMcu_PllStatusType Mcu_GetPllStatus(void)获取 PLL 锁定状态
Mcu_GetResetReasonMcu_ResetType Mcu_GetResetReason(void)获取标准化复位原因
Mcu_GetResetRawValueMcu_RawResetType Mcu_GetResetRawValue(void)获取原始复位值（µC 特定）
Mcu_PerformResetvoid Mcu_PerformReset(void)执行 MCU 复位
Mcu_SetModevoid Mcu_SetMode(Mcu_ModeType McuMode)设置 MCU 节能模式
Mcu_GetVersionInfovoid Mcu_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr)获取版本信息
Mcu_GetRamStateMcu_RamStateType Mcu_GetRamState(void)获取 RAM 状态
+

共 11 个 API 函数。

+ +

8.4 调度函数（Scheduled functions）

+

MCU 驱动通常不定义调度函数（除 EcuM 状态管理所需外）。

+ +

8.5 预期接口（Expected Interfaces）

+ +

8.5.1 强制接口（Mandatory Interfaces）

+ + +

8.5.2 可选接口（Optional Interfaces）

+ + +

8.5.3 可配置接口（Configurable interfaces）

+ + +

9 序列图（Sequence diagrams）

+
    +
  1. 启动序列：应用 → Mcu_Init() → Mcu_InitRamSection() → Mcu_InitClock() → Mcu_DistributePllClock() → 启动完成；
    2. +
  2. 节能模式：应用 → Mcu_SetMode(MCU_MODE_LOW_POWER) → MCU 进入低功耗；
    3. +
  3. 复位：检测到致命错误 → Mcu_PerformReset() → MCU 复位；
    4. +
  4. 查询复位原因：应用 → Mcu_GetResetReason() → 返回标准化原因；
    5. +
  5. 时钟失败通知：硬件时钟失败 → MCU ISR → Dem_SetEventStatus(MCU_E_CLOCK_FAILURE)。
    6. +
+ +

10 配置规范（Configuration specification）

+ +

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

+ +

10.1.1 Mcu（根容器）

+ + + + + + + + + + + + + +
参数描述
McuDevErrorDetect开发错误检测开关
McuVersionInfoApiMcu_GetVersionInfo() API 开关
McuInitClockApiMcu_InitClock() API 开关
McuDistributePllClockApiMcu_DistributePllClock() API 开关
McuGetPllStatusApiMcu_GetPllStatus() API 开关
McuPerformResetApiMcu_PerformReset() API 开关
McuGetResetReasonApiMcu_GetResetReason() API 开关
McuGetResetRawValueApiMcu_GetResetRawValue() API 开关
McuRamInitApiMcu_InitRamSection() API 开关
+ +

10.1.2 McuGeneral（通用配置）

+ + + + + + + +
参数描述
McuNumberOfMcuModesMCU 模式数量
McuNumberOfRamSectionsRAM 段数量
McuClockSrcFailureNotification时钟失败通知开关
+ +

10.1.3 McuClockSettingConfig（时钟设置）

+ + + + + + +
参数描述
McuClockSettingId时钟设置 ID
McuClockSettingPllPLL 设置引用
+ +

10.1.4 McuPllConfig（PLL 设置）

+ + + + + + + + + +
参数描述
McuPllIdPLL ID
McuPllInputClockRefPLL 输入时钟引用
McuPllOutputClockPLL 输出时钟频率
McuPllDividerPLL 分频器
McuPllMultiplerPLL 倍频器
+ +

10.1.5 McuRamSectionConfig（RAM 段）

+ + + + + + + + +
参数描述
McuRamSectionIdRAM 段 ID
McuRamSectionBaseAddressRAM 段基址
McuRamSectionSizeRAM 段大小
McuRamSectionInitValueRAM 段初始化值
+ +

10.1.6 McuModeConfig（MCU 模式）

+ + + + + + +
参数描述
McuModeId模式 ID
McuModePowerMode电源模式（Normal/Sleep/Stop）
+ +

10.1.7 McuResetConfig（复位原因）

+ + + + + + + +
参数描述
McuResetId复位 ID
McuResetRawValue复位原始值（µC 特定）
McuResetReason标准化复位原因
+ +

10.2 发布信息（Published Information）

+

发布信息包括 MCU 模块版本、配置变体、RAM 段数量、PLL 数量、模式数量等。

+ +
+ +
+

📋 校对记录

+

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

+ +
+ + + diff --git a/translation_zh-CN/P4_MCAL/index.html b/translation_zh-CN/P4_MCAL/index.html new file mode 100644 index 0000000..f351c91 --- /dev/null +++ b/translation_zh-CN/P4_MCAL/index.html @@ -0,0 +1,86 @@ + + + + +P4 · MCAL 模块索引 + + + + +
+

P4 · MCAL（微控制器抽象层）

+
+ 📚 模块：MCAL + 📅 版本：AUTOSAR CP 4.4.0 + 🔄 状态：已完成（7/7，100%） +
+
+ + + +
+ +

📋 模块说明

+

AUTOSAR 微控制器抽象层（MCAL）为微控制器内部外设与外部外设提供标准化软件接口——含 Core Test、GPT Driver、MCU Driver 三个具体驱动与 SPAL General 通用需求。本阶段翻译 7 篇文档（SRS + SWS）。

+ +

📑 文档清单（7 篇）

+ +

📘 已完成（7 篇）

+
+
+

AUTOSAR_SRS_CoreTest

+
核心测试需求（24 页，25+ 需求 ID）
+ A · 100% +
+
+

AUTOSAR_SRS_GPTDriver

+
通用定时器驱动需求（18 页，18 需求 ID）
+ A · 100% +
+
+

AUTOSAR_SRS_MCUDriver

+
MCU 驱动需求（17 页，13 需求 ID）
+ A · 100% +
+
+

AUTOSAR_SRS_SPALGeneral

+
SPAL 通用需求（21 页，22 需求 ID + 8 行 RS_BRF 追溯）
+ A · 100% +
+
+

AUTOSAR_SWS_CoreTest

+
核心测试软件规范（54 页，11 API + 1 通知回调）
+ A · 100% +
+
+

AUTOSAR_SWS_MCUDriver

+
MCU 驱动软件规范（49 页，11 API + 8 错误码）
+ A · 100% +
+
+

AUTOSAR_SWS_GPTDriver

+
通用定时器驱动软件规范（64 页，15 API + 8 错误码）
+ A · 100% +
+
+ +

📊 翻译进度

+

7 / 7 篇完成（100%）。✅

+ +

全部 7 篇 P4 MCAL 文档已翻译完成：4 篇 SRS + 3 篇 SWS。

+ +

P4 MCAL 阶段完成 ✅，进入下一阶段：P4 IO 14 篇（ADC/DIO/ICU/PWM/Port/OCU/HWAb）。

+ +
+ + + + + diff --git a/translation_zh-CN/PLAN.html b/translation_zh-CN/PLAN.html index da96927..a7e25eb 100644 --- a/translation_zh-CN/PLAN.html +++ b/translation_zh-CN/PLAN.html @@ -27,7 +27,7 @@ P3Diagnostics300% P4Memory1600% P4IO1400% - P4MCAL700% + P4MCAL77100% ✅ P4Crypto66100% ✅ P5ModeManagement400% P5GlobalTime400% diff --git a/translation_zh-CN/_progress.json b/translation_zh-CN/_progress.json index 7bd8490..051420a 100644 --- a/translation_zh-CN/_progress.json +++ b/translation_zh-CN/_progress.json @@ -2,8 +2,8 @@ "version": "2.0", "last_updated": "2026-06-13", "total_documents": 216, - "translated": 52, - "proofread": 52, + "translated": 59, + "proofread": 59, "current_stage": "P4", "stage_progress": { "P0": { @@ -17,7 +17,7 @@ "P1": {"total": 15, "translated": 15, "proofread": 15, "progress": "100%", "status": "completed"}, "P2": {"total": 71, "translated": 0, "proofread": 0, "progress": "0%"}, "P3": {"total": 3, "translated": 0, "proofread": 0, "progress": "0%"}, - "P4": {"total": 43, "translated": 6, "proofread": 6, "progress": "14%"}, + "P4": {"total": 43, "translated": 13, "proofread": 13, "progress": "30%"}, "P5": {"total": 20, "translated": 9, "proofread": 9, "progress": "45%"}, "P6": {"total": 42, "translated": 0, "proofread": 0, "progress": "0%"} }, @@ -85,6 +85,15 @@ "AUTOSAR_SWS_CryptoDriver": {"pages": 81, "status": "translated+proofread"}, "AUTOSAR_SWS_KeyManager": {"pages": 113, "status": "translated+proofread"}, "AUTOSAR_SWS_CryptoServiceManager": {"pages": 202, "status": "translated+proofread"} + }, + "P4_MCAL": { + "AUTOSAR_SRS_CoreTest": {"pages": 24, "status": "translated+proofread"}, + "AUTOSAR_SRS_GPTDriver": {"pages": 18, "status": "translated+proofread"}, + "AUTOSAR_SRS_MCUDriver": {"pages": 17, "status": "translated+proofread"}, + "AUTOSAR_SRS_SPALGeneral": {"pages": 21, "status": "translated+proofread"}, + "AUTOSAR_SWS_CoreTest": {"pages": 54, "status": "translated+proofread"}, + "AUTOSAR_SWS_MCUDriver": {"pages": 49, "status": "translated+proofread"}, + "AUTOSAR_SWS_GPTDriver": {"pages": 64, "status": "translated+proofread"} } }, "quality_summary": { diff --git a/translation_zh-CN/index.html b/translation_zh-CN/index.html index 41583e3..7efb591 100644 --- a/translation_zh-CN/index.html +++ b/translation_zh-CN/index.html @@ -11,8 +11,8 @@
📚 总翻译：216 篇 ✅ 已翻译：49 篇 - ⏳ 进度：24.1% - 🔄 当前阶段：P4 · Crypto（6/6 · 100%）✅ · 下一阶段：P4 MCAL + ⏳ 进度：27.3% + 🔄 当前阶段：P4 · MCAL（7/7 · 100%）✅ · 下一阶段：P4 IO
@@ -90,9 +90,9 @@ 0 / 14
-

MCAL（微控制器抽象层）

-
MCU 驱动、Port、Gpt、Spi 等
- 0 / 7 +

MCAL（微控制器抽象层）

+
Core Test、GPT、MCU、SPAL 驱动（已完成 ✅）
+ 7 / 7 · 100%

Crypto（加密服务）

@@ -184,12 +184,12 @@

🚀 下一步

-

P1 全部完成（15/15）+ P5 Safety 全部完成（9/9）+ P4 Crypto 全部完成（6/6）！按 🗓️ 翻译计划，下一阶段为 P4 MCAL（7 篇小文档 SRS/SPAL/SWS）。详见 PLAN.html §3.2。

+

P1 全部完成（15/15）+ P5 Safety 全部完成（9/9）+ P4 Crypto 全部完成（6/6）+ P4 MCAL 全部完成（7/7）！按 🗓️ 翻译计划，下一阶段为 P4 IO（14 篇 ADC/DIO/ICU/PWM/Port/OCU/HWAb）。详见 PLAN.html §3.2。

diff --git a/translation_zh-CN/progress.md b/translation_zh-CN/progress.md index af2e645..53a6dce 100644 --- a/translation_zh-CN/progress.md +++ b/translation_zh-CN/progress.md @@ -18,7 +18,7 @@ | P3 | Diagnostics | 3 | 0 | 0% | | P4 | Memory | 16 | 0 | 0% | | P4 | IO | 14 | 0 | 0% | -| P4 | MCAL | 7 | 0 | 0% | +| P4 | MCAL | 7 | 7 | 100.0% | | P4 | Crypto | 6 | 6 | 100.0% | | P5 | ModeManagement | 4 | 0 | 0% | | P5 | GlobalTime | 4 | 0 | 0% | @@ -30,7 +30,7 @@ | P6 | Libraries | 10 | 0 | 0% | | P6 | Tools | 4 | 0 | 0% | | P6 | ReleaseDocumentation | 1 | 0 | 0% | -| **总计** | | **216** | **52** | **24.1%** | +| **总计** | | **216** | **59** | **27.3%** | ## P0 已完成文档清单 @@ -69,4 +69,4 @@ - ✅ 需求 ID 保留 - ✅ 章节结构对应 -_最新更新：2026-06-13 · P4 Crypto 全部完成（6/6 = 100%）✅ 下一阶段：P4 MCAL_ \ No newline at end of file +_最新更新：2026-06-13 · P4 MCAL 全部完成（7/7 = 100%）✅ 下一阶段：P4 IO_ \ No newline at end of file