AUTOSAR_SWS_RAMTest 中文翻译

文档编号：092　|　状态：Final　|　发布于：AUTOSAR CP Release 4.4.0
所属标准：AUTOSAR Classic Platform　|　文档责任方：AUTOSAR

本翻译覆盖原文档 1-83 页正文（约 1.56 MB）。
原文为软件规范（SWS），定义 RAM 测试（RamTst）模块的 API 与配置——含 19 个 API 函数（含 2 个通知回调模板 + 1 个调度函数）+ 多个开发错误 + 多个 SWS_RamTst_NNNNN 规范项。

1 引言与功能概述

RamTst（RAM Test）位于 MCAL，提供对内部/外部 RAM 硬件的测试功能（背景与前台测试）。支持多种测试算法（March C-/C/X、Checkerboard、Walking 1s/0s 等）。

2 缩略语与缩写

RamTst / MCAL / DEM / DET / March Test / Checkerboard / Background / Foreground Test / Test Signature

3 相关文档

4 约束与假设

RamTst 测试算法依赖硬件实现。测试过程中可能破坏 RAM 内容（破坏性测试）。

5 与其他模块的依赖

RamTst 依赖 DET、DEM、EcuM（资源管理）。

6 需求可追溯性

SWS_RamTst_NNNNN 规范项 ID 约 100+ 条。

7 功能规范

7.1 预配置

测试块数、起始地址、测试算法、签名长度、测试模式（背景/前台）、可配置测试参数、通知回调。

7.2 通用行为

后台测试由 RamTst_MainFunction() 周期性调用；前台测试由用户调用 RamTst_RunFullTest/RunPartialTest 启动。测试完成或错误时调用通知回调。

7.3 错误分类

7.3.1 开发错误

错误码含义
RAMTST_E_UNINITRamTst 未初始化
RAMTST_E_ALREADY_INITIALIZED已初始化
RAMTST_E_BUSY测试忙
RAMTST_E_NOT_TESTED块未测试
RAMTST_E_PARAM_POINTER无效的指针
RAMTST_E_PARAM_VALUE无效的参数值
RAMTST_E_OUT_OF_RANGE地址越界

7.3.2 运行时错误

RAMTST_E_HARDWARE_ERROR（硬件错误）

7.3.3-7.3.5

无（瞬态/生产/扩展生产错误）。

8 API 规范

8.1 导入类型

Std_ReturnType、Std_VersionInfoType、Std_ConfigType。

8.2 类型定义

RamTst_ConfigType / RamTst_ExecutionStatusType（UNINIT/IDLE/RUNNING/SUSPENDED/...） / RamTst_TestResultType（OK/NOT_OK/UNDEFINED） / RamTst_AlgorithmType（March C-/C/X/Checkerboard/Walking 1s/Walking 0s） / RamTst_AlgParamsType

8.3 函数定义

API功能
RamTst_Init初始化 RamTst
RamTst_DeInit反初始化
RamTst_Stop停止测试
RamTst_Allow允许测试
RamTst_Suspend暂停测试
RamTst_Resume恢复测试
RamTst_GetExecutionStatus获取执行状态
RamTst_GetTestResult获取测试结果
RamTst_GetTestResultPerBlock按块获取测试结果
RamTst_GetVersionInfo获取版本信息
RamTst_GetAlgParams获取算法参数
RamTst_GetTestAlgorithm获取当前测试算法
RamTst_GetNumberOfTestedCells获取测试单元数
RamTst_SelectAlgParams选择算法参数
RamTst_ChangeNumberOfTestedCells修改测试单元数
RamTst_RunFullTest运行完整测试
RamTst_RunPartialTest运行部分测试
RamTst_MainFunction主函数（异步处理）
RamTst_TestCompletedNotification测试完成通知回调（应用实现）
RamTst_ErrorNotification测试错误通知回调（应用实现）

共 19 个 API 函数（含 2 个通知回调模板 + 1 个调度函数）。

9 序列图

  1. 后台测试：OS 周期 → RamTst_MainFunction() → 原子序列执行 → 测试完成 → 通知回调
  2. 前台完整测试：应用 → RamTst_RunFullTest() → 立即执行 → RamTst_GetTestResult() 读取
  3. 前台部分测试：应用 → RamTst_RunPartialTest(Params) → 测试指定单元 → 通知
  4. 暂停/恢复：应用 → RamTst_Suspend() → RamTst_Resume()
  5. 选择算法参数：应用 → RamTst_SelectAlgParams(Params) → 配置测试

10 配置规范

10.1 容器与配置参数

容器描述
RamTst根容器（开发错误检测、版本 API 等）
RamTstGeneral通用配置（测试块数、签名长度、回调、默认算法）
RamTstBlock测试块（起始地址、大小、默认算法）
RamTstConfigSet配置集
RamTstPublishedInformation发布信息

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

10.2 发布信息

发布信息包括 RamTst 模块版本、配置变体、测试块数、最大签名长度、支持的算法列表等。

校对记录

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