diff --git a/BSWGeneral/AUTOSAR_SRS_BSWGeneral.md b/BSWGeneral/AUTOSAR_SRS_BSWGeneral.md new file mode 100644 index 0000000..20a59bd --- /dev/null +++ b/BSWGeneral/AUTOSAR_SRS_BSWGeneral.md @@ -0,0 +1,328 @@ +# 基础软件模块通用需求 + +> **AUTOSAR CP Release 4.4.0** +> +> 原文：*General Requirements on Basic Software Modules*（文档 ID 043） +> +> 翻译状态：**试点译文 v1**（已校对样章；其余待批量翻译） +> +> 对应原文 PDF：`BSWGeneral/AUTOSAR_SRS_BSWGeneral.pdf` +> +> 翻译日期：2024 年 Step 2 试点 + +--- + +## 文档标识 + +| 字段 | 值 | +|------|-----| +| 文档标题（Document Title） | 基础软件模块通用需求（General Requirements on Basic Software Modules） | +| 文档所有者（Document Owner） | AUTOSAR | +| 文档责任人（Document Responsibility） | AUTOSAR | +| 文档标识号（Document Identification No） | 043 | +| 文档状态（Document Status） | 正式版（Final） | +| 所属 AUTOSAR 标准 | Classic Platform（经典平台） | +| 所属标准版本 | 4.4.0 | + +> 原文版权：© AUTOSAR — 机密文件 +> 本中文译文仅供学习参考。 + +--- + +## 文档变更历史（Document Change History） + +| 日期 | 版本 | 变更人 | 变更说明 | +|------|------|--------|----------| +| 2018-10-31 | 4.4.0 | AUTOSAR Release Management | • 新增安全事件分类需求（SRS_BSW_00488）
• 新增模块初始化错误相关需求（SRS_BSW_00487）
• 头文件清理
• 移除过时引用
• 编辑性修订 | +| 2017-12-08 | 4.3.1 | AUTOSAR Release Management | • 头文件生命周期变更
• 更新相关标准和规范
• 编辑性修订 | +| 2016-11-30 | 4.3.0 | AUTOSAR Release Management | • 新增 C90 接口支持
• 更新 MISRA 2012 支持
• 移除过时引用
• 编辑性修订 | +| 2015-07-31 | 4.2.2 | AUTOSAR Release Management | • 引入新需求 SRS_BSW_00403
• 引入新需求 SRS_BSW_00351
• 修改需求 SRS_BSW_00406 和 SRS_BSW_00450
• 调试支持标记为过时 | +| 2014-10-31 | 4.2.1 | AUTOSAR Release Management | • 后构建配置与 SWS_BSWGeneral 对齐
• 运行时错误定义的重新表述
• 引入 SupportForPBLAndPBSECUConfiguration 概念
• 编辑性修订 | +| 2014-03-31 | 4.1.3 | AUTOSAR Release Management | • 移除/修改关于标准头文件的需求，提供更抽象的视图
• 改进运行时错误的定义
• 编辑性修订 | +| 2013-10-31 | 4.1.2 | AUTOSAR Release Management | • 修订接口管理及其类型到模块的独立头文件中
• 删除冗余需求
• 编辑性修订 | +| 2013-03-15 | 4.1.1 | AUTOSAR Administration | • BSW 模块到 DEM 的接口和 DEM 去抖
• BSW 模块中断例程的声明和实现需求
• AUTOSAR 服务的函数原型和回调函数改进
• 安全性和完整性改进 | +| 2011-12-22 | 4.0.3 | AUTOSAR Administration | • 安全性和完整性改进：
  • 限制 Init 和确定函数的调用方
  • 可重入处理
  • BSW 模块中断例程的新实现需求
  • 适配 BSW 模块的包含结构（如 RTE 头文件处理）
  • VENDOR_ID 格式调整，便于验证 | + +> *注：以上变更历史为节选；完整记录请参见英文原版 PDF 第 1-7 页。* + +--- + +## 目录（Table of Contents） + +1. [本文件范围（Scope of this document）](#1-本文件范围scope-of-this-document) + - 1.1 [约束（Constraints）](#11-约束constraints) +2. [如何阅读本文档（How to read this document）](#2-如何阅读本文档how-to-read-this-document) + - 2.1 [使用的约定（Conventions used）](#21-使用的约定conventions-used) + - 2.2 [需求结构（Requirements structure）](#22-需求结构requirements-structure) + - 2.3 [到 AUTOSAR 版本的映射（Mapping to AUTOSAR releases）](#23-到-autosar-版本的映射mapping-to-autosar-releases) +3. [缩略语与简称（Acronyms and abbreviations）](#3-缩略语与简称acronyms-and-abbreviations) +4. [需求追踪（Requirements Tracing）](#4-需求追踪requirements-tracing) +5. [基础软件通用需求（General Requirements on Basic Software）](#5-基础软件通用需求general-requirements-on-basic-software) + - 5.1 [功能需求（Functional Requirements）](#51-功能需求functional-requirements) + - 5.2 [非功能需求（Non-functional Requirements）](#52-非功能需求non-functional-requirements) +6. [参考文献（References）](#6-参考文献references) + +> *注：以上为节选目录。完整目录见英文原版 PDF 第 8 页。* + +--- + +## 1 本文件范围（Scope of this document） + +AUTOSAR WP Architecture 工作组及本文档的目标是，定义一套适用于 AUTOSAR 基础软件所有 SW 模块的基础通用需求。这些需求应被负责基础软件模块规范的工作包所采纳并细化。 + +本文档中定义的功能需求应在 AUTOSAR 基础软件的每一份软件规范（SWS）文档中被引用。 + +### 1.1 约束（Constraints） + +基础软件模块需求规范的首要范围是**非安全相关**的系统。因此，安全需求被赋予中等优先级。 + +--- + +## 2 如何阅读本文档（How to read this document） + +每个需求都有以 "BSW"（Basic Software，基础软件）为前缀的唯一标识符。任何评审注释、意见或问题，请引用此唯一 ID，而不是章节或页码！ + +### 2.1 使用的约定（Conventions used） + +- AUTOSAR 文档中需求的表示遵循 [TPS_STDT_00078] 中规定的表格。 +- 在需求中，应使用以下具有特定语义的关键词（基于 IETF 互联网工程任务组的约定）。 + +本文档中关键词 "MUST"、"MUST NOT"、"SHALL"、"SHALL NOT"、"SHOULD"、"SHOULD NOT"、"MAY" 和 "OPTIONAL" 的解释如下： + +| 关键词 | 中文 | 含义 | +|--------|------|------| +| **SHALL** | 应 | 表示该定义是规范的**绝对要求**。 | +| **SHALL NOT** | 不应 | 表示该定义是规范的**绝对禁止**。 | +| **MUST** | 必须 | 表示该定义是规范中**出于法律原因**的绝对要求。 | +| **MUST NOT** | 不可 | 表示该定义是规范中**出于法律约束**的绝对禁止。 | +| **SHOULD** | 宜 | 表示在特定情况下忽略某项可能存在合理理由，但在选择不同方案之前**必须**充分理解并仔细权衡全部影响。 | +| **SHOULD NOT** | 不宜 | 表示在特定情况下接受或使用特定行为可能是可接受的或有用的，但在实现此标签描述的任何行为之前**应**理解全部影响并仔细权衡。 | +| **MAY** | 可 | 表示该项是**真正可选**的。某供应商可能因为特定市场需要而包含该项，或因认为该项能增强产品而包含；另一供应商可能省略同一项。**不**包含某选项的实现**必须**准备好与**包含**该选项的另一实现互操作（功能可能有所缩减）。反之亦然——**包含**某选项的实现**必须**准备好与**不包含**该选项的实现互操作（该选项提供的特性除外）。 | + +所有需求表格均符合模板 TPS_StdT_00077。 + +### 2.2 需求结构（Requirements structure） + +每个模块专属章节包含对基础软件模块的简短功能描述。同一类型的需求在每个章节中按以下标题分组（适用时）： + +**功能需求（Functional Requirements）**： +- Configuration（配置）—— 指出模块中哪些元素需要可配置 +- Initialization（初始化） +- Normal Operation（正常运行） +- Shutdown Operation（关闭操作） +- Fault Operation（故障处理） +- …… + +**非功能需求（Non-Functional Requirements）**： +- Timing Requirements（时序需求） +- Resource Usage（资源占用） +- Usability（可用性） +- Output for other WPs（向其他工作组的输出，例如描述模板、工具链等） +- …… + +### 2.3 到 AUTOSAR 版本的映射（Mapping to AUTOSAR releases） + +对于本文档 "基础软件模块通用需求" 中定义的每条需求，应包含对适用 AUTOSAR 版本的引用。这通过需求描述表中的 "AUTOSAR release" 行实现。 + +本需求规范包含适用于 AUTOSAR 基础软件中所有 SW 模块的通用需求。 + +每条需求的强制性部分在每条需求的描述中陈述。 + +--- + +## 3 缩略语与简称（Acronyms and abbreviations） + +### 缩略语（Acronyms） + +| 缩略语 | 描述 | +|--------|------| +| Interrupt frame | **中断帧**：由编译器或汇编器为中断例程的前缀和后缀生成的代码。此代码与具体微控制器相关。 | +| ISR | **Interrupt Service Routine**，中断服务例程。在 C 语言中，也作为宏用于声明 Category 2 中断服务例程。 | + +### 简称（Abbreviations） + +| 简称 | 描述 | +|------|------| +| Cat2 | **Category 2**。Cat2 中断由 OS 支持，可以调用 OS 服务。 | +| Cat1 | **Category 1**。Cat1 中断不被 OS 支持，仅可调用一小组 OS 服务（全局中断使能与禁用）。 | + +--- + +## 4 需求追踪（Requirements Tracing） + +> *本节建立通用需求与其他 AUTOSAR 文档的追踪关系。完整内容请参见英文原版 PDF 第 13-16 页。* +> +> 试点译文仅提供章节占位；批量翻译阶段将补全所有需求追踪条目。 + +--- + +## 5 基础软件通用需求（General Requirements on Basic Software） + +基础软件需求涵盖以下领域（domain）： + +- Body（车身） +- Powertrain（动力总成） +- Chassis（底盘） +- Safety（功能安全）—— 假设：由于硬件和系统基础设施与上述领域相似，已覆盖 + +ECU 应用经验取自以下具体应用： + +- 天窗和电动车窗 ECU +- 柴油发动机 ECU +- ESP（电子稳定程序）ECU +- BMW、DC 和 VW 标准软件包（'Standard Core'、'Standard Software Platform'、'Standard Software Core'），包括 ISO 17356-3 操作系统、通信模块、引导加载程序、所列领域的基础诊断功能 +- 信息娱乐主控 ECU + +### 5.1 功能需求（Functional Requirements） + +#### 5.1.1 配置（Configuration） + +##### 5.1.1.1 [SRS_BSW_00344] BSW 模块应支持链接时配置 + +``` +Type: Valid +Description: Link-time configuration phase shall be supported. + Link-time parameters are optional. + 应支持链接时配置阶段。链接时参数是可选的。 +Rationale: Allow configurable functionality of modules that are + deployed as object code. Usually those modules are drivers. + 允许以目标码形式部署的模块具备可配置功能。这些模块通常是驱动。 +Use Case: -- +Dependencies: [SRS_BSW_00342] Usage of source code and object code +Supporting Material: -- +``` + +##### 5.1.1.2 [SRS_BSW_00404] BSW 模块应支持后构建配置 + +``` +Type: Draft +Description: Post-build configuration phase shall be supported. + Post-build parameters are optional. + 应支持后构建配置阶段。后构建参数是可选的。 +Rationale: Change ECU configuration after ECU production without + an update of the whole application. + 在不更新整个应用的前提下，在 ECU 生产后修改 ECU 配置。 +Use Case: type declaration of the Config Type + typedef struct ComM_ConfigType_Tag { + ... + } ComM_ConfigType; (in ComM.h) + as a forward declaration use: + typedef struct ComM_ConfigType_Tag ComM_ConfigType; + extern void ComM(ComM_ConfigType * ComMConfigPtr); + (in ComM.h) + Config Type 的类型声明（同上） +Dependencies: [SRS_BSW_00342] Usage of source code and object code +Supporting Material: -- +``` + +##### 5.1.1.3 [SRS_BSW_00405] BSW 模块应支持多配置集 + +``` +Type: Valid +Description: Modules of the AUTOSAR Basic Software shall be able to + operate with more than one configuration set, selectable + at start-up time. + AUTOSAR 基础软件的模块应能够在启动时选择使用多套配置 + 集中的任意一套运行。 +Rationale: Application of the same software to different cars. + 将同一软件应用于不同的车辆。 +Use Case: -- +Dependencies: [SRS_BSW_00342] Usage of source code and object code +Supporting Material: -- +``` + +##### 5.1.1.4 [SRS_BSW_00345] BSW 模块应支持预编译配置 + +``` +Type: Valid +Description: (原文未提供 Description 字段内容) +Rationale: Static configuration is decoupled from implementation. + Separation of configuration dependent data at compile + time furthermore enhances flexibility, readability and + reduces version management as no source code is affected. + 静态配置与实现解耦。在编译时分离配置相关数据进一步 + 增强了灵活性、可读性，并减少了版本管理工作量 + （不涉及源代码修改）。 +Use Case: (原文未提供 Use Case 字段内容) +Dependencies: (原文未提供 Dependencies 字段内容) +Supporting Material: -- +``` + +##### 5.1.1.5 [SRS_BSW_00159] AUTOSAR 基础软件的所有模块应支持基于工具的配置 + +``` +Type: Valid +Description: All modules of the AUTOSAR Basic Software shall support + a tool based configuration. + AUTOSAR 基础软件的所有模块应支持基于工具的配置。 +Rationale: Integration into AUTOSAR methodology + 集成到 AUTOSAR 方法论中。 +Use Case: The NVRAM manager can be automatically configured + depending on the NV ... + NvRAM 管理器可以根据 NV（block）信息自动配置… + *（完整 Use Case 见英文原版）* +Dependencies: -- +Supporting Material: -- +``` + +> **⚠️ 待翻译（TODO）** +> +> 以下章节尚未翻译（占位标记），将在 Step 3（批量翻译 P0）阶段完成： +> +> - 5.1.2 Wake-Up（唤醒）—— 第 26 页 +> - 5.1.3 Initialization（初始化）—— 第 26 页 +> - 5.1.4 Normal Operation（正常运行）—— 第 28 页 +> - 5.1.5 Shutdown Operation（关闭操作）—— 第 34 页 +> - 5.1.6 Fault Operation and Error Detection（故障处理与错误检测）—— 第 34 页 +> - 5.2 Non-functional Requirements（非功能需求）—— 第 43 页 +> - 5.2.1 Software Architecture Requirements +> - 5.2.2 Software Integration Requirements +> - 5.2.3 Software Module Design Requirements +> - 5.2.4 Software Documentation Requirements +> +> 预计条目总数：~150 条 SRS_BSW_xxxxx 需求。 + +--- + +## 6 参考文献（References） + +### 6.1 AUTOSAR 交付物（Deliverables of AUTOSAR） + +参见 AUTOSAR 标准发布中列出的文档。 + +### 6.2 相关标准与规范（Related standards and norms） + +#### 6.2.1 ISO 17356 + +> *本节列出 ISO 17356 系列标准的引用。完整内容见英文原版 PDF 第 80 页。* + +#### 6.2.2 AUTOSAR 供应商 ID 列表（AUTOSAR Vendor ID List） + +> *本节列出已注册的 AUTOSAR 供应商 ID 列表。* + +--- + +## 翻译说明 + +### 翻译策略 + +- **API 标识符、模块缩写、协议名** 保持英文不译（如 `SRS_BSW_00344`、`BSW`、`RTE`、`NvM`、`ComM`） +- **shall/must/should/may** 严格按 IETF 规范的中文译法 +- **专有名词**（AUTOSAR、ECU、ISO）保留英文 +- 文档内首次出现的英文术语后附中文译名，后续以中文为主 + +### 与术语表的关系 + +本文档严格遵循 [`../翻译术语表.md`](../翻译术语表.md) v1。后续若发现新术语，会回填到术语表。 + +### 校对工作流 + +- 本译文为 **LLM 机翻 + 人工/AI 校对** 试点版本 +- 标记 `` 的段落表示尚未校对的英文原版 +- 建议校对时优先检查：表格内容、API 名、需求 ID 引用、版本号 + +--- + +*试点译文结束。* +*Pilot translation produced at Step 2 of the translation plan.* +*Translator note: This is a sample output to validate format; bulk translation follows in Step 3.* diff --git a/翻译术语表.md b/翻译术语表.md new file mode 100644 index 0000000..23cde62 --- /dev/null +++ b/翻译术语表.md @@ -0,0 +1,255 @@ +# AUTOSAR 翻译术语表 v1 + +> 本表用于 AUTOSAR v4.4 标准规范中文翻译过程中保持术语一致性。 +> 在 LLM 翻译时，应严格遵守本表，**API 标识符、模块缩写、协议名保持英文**。 + +--- + +## 一、总体架构（Architecture） + +| 英文 | 中文 | 说明 | +|------|------|------| +| AUTOSAR | AUTOSAR | Automotive Open System Architecture（专有名词不译） | +| ECU | ECU | Electronic Control Unit（电子控制单元） | +| Vehicle | 车辆 | | +| Platform | 平台 | | +| Layered Software Architecture | 分层软件架构 | | +| Basic Software (BSW) | 基础软件 (BSW) | | +| Application Layer | 应用层 | | +| Runtime Environment (RTE) | 运行时环境 (RTE) | | +| Software Component (SWC) | 软件组件 (SWC) | | +| Virtual Functional Bus (VFB) | 虚拟功能总线 (VFB) | | +| AUTOSAR Interface | AUTOSAR 接口 | | +| Standardized Interface | 标准化接口 | | +| Standardized AUTOSAR Interface | 标准化 AUTOSAR 接口 | | +| Communication | 通信 | | +| Service | 服务 | | +| ECU Abstraction Layer | ECU 抽象层 | | +| Microcontroller Abstraction Layer (MCAL) | 微控制器抽象层 (MCAL) | | +| Complex Driver (CDD) | 复杂驱动 (CDD) | | +| Memory Stack | 内存栈 | | +| Communication Stack | 通信栈 | | + +## 二、模块/规范类型 + +| 英文 | 中文 | 说明 | +|------|------|------| +| EXP | 说明文档 | Explanatory Document | +| SRS | 软件需求规范 | Software Requirement Specification | +| SWS | 软件规范 | Software Specification | +| RS | 需求规范 | Requirement Specification | +| TR | 技术报告 | Technical Report | +| ASWS | 高级软件规范 | AUTOSAR Software Specification | +| MOD | 模型 | Model | +| TPS | 模板规范 | Template Specification | + +## 三、操作系统与调度 + +| 英文 | 中文 | +|------|------| +| Operating System (OS) | 操作系统 (OS) | +| Task | 任务 | +| Schedule Table | 调度表 | +| Interrupt | 中断 | +| Resource | 资源 | +| Counter | 计数器 | +| Alarm | 闹钟 | +| Event | 事件 | +| Spinlock | 自旋锁 | +| Multi-core | 多核 | +| Timing Protection | 时间保护 | +| Stack Monitoring | 栈监控 | + +## 四、通信模块 + +| 英文 | 中文 | 说明 | +|------|------|------| +| CAN | CAN | Controller Area Network | +| LIN | LIN | Local Interconnect Network | +| FlexRay | FlexRay | | +| Ethernet | 以太网 | | +| TTCAN | TTCAN | Time-Triggered CAN | +| PDU | PDU | Protocol Data Unit（协议数据单元） | +| Signal | 信号 | | +| Signal Group | 信号组 | | +| Frame | 帧 | | +| Network Management (NM) | 网络管理 (NM) | | +| Bus Mirroring | 总线镜像 | | +| SOME/IP | SOME/IP | Scalable service-Oriented MiddlewarE over IP | +| Transformer | 转换器 | | +| COM | COM | 通信模块 | +| PduR | PduR | PDU Router（PDU 路由器） | +| CanIf | CanIf | CAN Interface（CAN 接口） | +| CanTp | CanTp | CAN Transport Layer（CAN 传输层） | +| CanNm | CanNm | CAN Network Management | +| CanSm | CanSm | CAN State Manager | +| LinIf | LinIf | LIN Interface | +| LinTp | LinTp | LIN Transport Layer | +| FrIf | FrIf | FlexRay Interface | +| FrTp | FrTp | FlexRay Transport Layer | +| Nm | Nm | Network Management | +| NmIf | NmIf | Network Management Interface | +| E2E | E2E | End-to-End（端到端保护） | +| SecOC | SecOC | Secure Onboard Communication（车载安全通信） | +| IpduM | IpduM | I-PDU Multiplexer | +| V2X | V2X | Vehicle-to-Everything | +| SAE J1939 | SAE J1939 | | +| Gateway | 网关 | | +| SPI Handler | SPI 处理 | | +| Bus Tracer | 总线跟踪 | | +| Bus Mirroring | 总线镜像 | | + +## 五、诊断 + +| 英文 | 中文 | +|------|------| +| Diagnostics | 诊断 | +| Diagnostic Communication Manager (DCM) | 诊断通信管理器 (DCM) | +| Diagnostic Event Manager (DEM) | 诊断事件管理器 (DEM) | +| Diagnostic Log and Trace (DLT) | 诊断日志与跟踪 (DLT) | +| DTC | DTC（诊断故障码） | +| UDS | UDS（统一诊断服务） | +| OBD | OBD（车载诊断） | +| FIM | FIM（功能抑制管理器） | + +## 六、内存管理 + +| 英文 | 中文 | +|------|------| +| Non-Volatile Memory (NvM) | 非易失性存储管理器 (NvM) | +| Flash / EEPROM Emulation (Fee/Ea) | Flash/EEPROM 仿真 (Fee/Ea) | +| Memory Interface (MemIf) | 内存接口 (MemIf) | + +## 七、模式与状态管理 + +| 英文 | 中文 | +|------|------| +| ECU State Manager (EcuM) | ECU 状态管理器 (EcuM) | +| BSW Mode Manager (BswM) | BSW 模式管理器 (BswM) | +| Communication Manager (ComM) | 通信管理器 (ComM) | +| Network State | 网络状态 | +| Sleep / Shutdown / Wake-up | 休眠 / 关闭 / 唤醒 | + +## 八、安全与加密 + +| 英文 | 中文 | +|------|------| +| Safety | 功能安全 | +| ASIL | ASIL（汽车安全完整性等级） | +| Crypto Stack | 加密栈 | +| Key Management | 密钥管理 | +| Crypto Interface (CryIf) | 加密接口 (CryIf) | +| Crypto Service Manager (Csm) | 加密服务管理器 (Csm) | +| Crypto Driver (Crypto) | 加密驱动 (Crypto) | +| SHE | SHE（安全硬件扩展） | +| HSM | HSM（硬件安全模块） | +| TEE | TEE（可信执行环境） | + +## 九、MCAL 驱动 + +| 英文 | 中文 | +|------|------| +| MCU Driver (Mcu) | MCU 驱动 (Mcu) | +| General Purpose Timer (Gpt) | 通用定时器 (Gpt) | +| Port Driver (Port) | 端口驱动 (Port) | +| Dio Driver (Dio) | 数字 I/O 驱动 (Dio) | +| ADC Driver (Adc) | ADC 驱动（模数转换） | +| PWM Driver (Pwm) | PWM 驱动（脉宽调制） | +| ICU Driver (Icu) | ICU 驱动（输入捕获） | +| Watchdog (Wdg) | 看门狗 (Wdg) | +| SPI | SPI（串行外设接口） | +| I2C | I2C | +| WdgIf | 看门狗接口 | +| WdgM | 看门狗管理器 | + +## 十、配置与元模型 + +| 英文 | 中文 | +|------|------| +| ARXML | ARXML（AUTOSAR XML 配置格式） | +| ECU Extract | ECU 提取 | +| System Extract | 系统提取 | +| Meta Model | 元模型 | +| Class | 类 | +| Reference | 引用 | +| Aggregation | 聚合 | +| Composition | 组合 | +| Primitive | 基本类型 | +| Data Type | 数据类型 | +| Implementation Data Type | 实现数据类型 | +| Application Data Type | 应用数据类型 | +| Sender-Receiver | 发送者-接收者 | +| Client-Server | 客户端-服务器 | +| Inter-Runnable Variable | 可运行实体间变量 | +| Mode Declaration | 模式声明 | +| Mode Switch | 模式切换 | +| Mode Group | 模式组 | + +## 十一、测试与标定 + +| 英文 | 中文 | +|------|------| +| XCP | XCP（通用测量与标定协议） | +| A2L | A2L（标定描述文件） | +| Calibration | 标定 | +| Measurement | 测量 | +| RTE | 运行时环境 | + +## 十二、常见动词/短语 + +| 英文 | 中文 | +|------|------| +| shall | 应 | (需求条目强制词) | +| should | 宜 | (建议) | +| may | 可 | (允许) | +| must | 必须 | | +| shall not | 不应 | | +| Note: | 注： | | +| Rationale: | 原理： | | +| Use Case | 用例 | | +| Constraint | 约束 | | +| Requirement | 需求 | | +| Specification | 规范 | | +| Implementation | 实现 | | +| Configuration | 配置 | | +| Behavior | 行为 | | +| Sequence | 顺序/时序 | | +| State Machine | 状态机 | | +| Function | 功能 | | +| Service | 服务 | | +| Operation | 操作 | | +| Callback | 回调 | | +| Notification | 通知 | | +| Parameter | 参数 | | +| Argument | 形参 | | +| Return value | 返回值 | | +| Precondition | 前置条件 | | +| Postcondition | 后置条件 | | +| Error | 错误 | | +| Error Code | 错误码 | | +| Default | 默认 | | +| Supported | 支持 | | +| Not supported | 不支持 | | + +## 十三、文档元数据 + +| 英文 | 中文 | +|------|------| +| Document Owner | 文档所有者 | +| Document Responsibility | 文档责任人 | +| Document Status | 文档状态 | +| Document Identification No | 文档标识号 | +| Final | 正式版 | +| Draft | 草稿 | +| Published | 已发布 | +| Change History | 变更历史 | +| Disclaimer | 免责声明 | +| Copyright | 版权 | + +--- + +**维护说明：** +- 新术语请追加到对应分类 +- 同一概念出现多种译法时，以本表为准 +- API 标识符、模块名、协议名（CAN/LIN/FlexRay/SOME/IP 等）保持英文不译 +- v1 创建于 Step 1；后续翻译过程中持续扩充 diff --git a/翻译进度.md b/翻译进度.md new file mode 100644 index 0000000..3c2a249 --- /dev/null +++ b/翻译进度.md @@ -0,0 +1,127 @@ +# AUTOSAR v4.4 翻译进度跟踪 + +> 跟踪 216 个 PDF 的翻译状态。 +> 状态说明：⬜ 未开始 | 🟡 进行中 | ✅ 已完成 | ⚠️ 部分完成（仅章节）| ❌ 跳过 + +--- + +## 总体进度 + +| 项 | 数量 | 百分比 | +|---|---|---| +| 总 PDF 数 | 216 | 100% | +| 已完成 | 1 | 0.5% | +| 进行中 | 0 | 0% | +| 未开始 | 215 | 99.5% | +| 跳过 | 0 | 0% | + +--- + +## 试点已完成（Step 2） + +| 模块 | PDF | 状态 | 译文文件 | 备注 | +|------|------|------|----------|------| +| BSWGeneral | AUTOSAR_SRS_BSWGeneral.pdf | ⚠️ 部分完成 | `BSWGeneral/AUTOSAR_SRS_BSWGeneral.md` | 封面+TOC+Ch 1-3 完整翻译；Ch 4-6 占位；Ch 5 仅 5 条需求作为样例。~150 条需求待补。 | + +--- + +## 阶段计划 + +### 🟢 P0 - 基础与架构（Step 3） + +#### General（11 PDF） +- [ ] AUTOSAR_EXP_AIUserGuide.pdf +- [ ] AUTOSAR_EXP_LayeredSoftwareArchitecture.pdf +- [ ] AUTOSAR_EXP_VFB.pdf +- [ ] AUTOSAR_RS_Features.pdf +- [ ] AUTOSAR_RS_SWCModeling.pdf +- [ ] AUTOSAR_TR_AIDesignPatternsCatalogue.pdf +- [ ] AUTOSAR_TR_AIMeasurementCalibrationDiagnostics.pdf +- [ ] AUTOSAR_TR_PredefinedNames.pdf +- [ ] AUTOSAR_TR_SWCModelingGuide.pdf +- [ ] (其他 2 个 General 模块文档) + +#### BSWGeneral（13 PDF） +- [ ] AUTOSAR_EXP_ApplicationLevelErrorHandling.pdf +- [ ] AUTOSAR_EXP_BSWDistributionGuide.pdf +- [ ] AUTOSAR_EXP_CDDDesignAndIntegrationGuideline.pdf +- [ ] AUTOSAR_EXP_ErrorDescription.pdf +- [ ] AUTOSAR_EXP_InterruptHandlingExplanation.pdf +- [ ] AUTOSAR_SRS_BSWGeneral.pdf — ⚠️ **试点**（部分完成） +- [ ] AUTOSAR_SWS_BSWGeneral.pdf +- [ ] AUTOSAR_SWS_CommunicationStackTypes.pdf +- [ ] AUTOSAR_SWS_CompilerAbstraction.pdf +- [ ] AUTOSAR_SWS_PlatformTypes.pdf +- [ ] AUTOSAR_SWS_StandardTypes.pdf +- [ ] AUTOSAR_TR_BSWModuleList.pdf +- [ ] AUTOSAR_TR_BSWUMLModelModelingGuide.pdf + +#### MethodologyAndTemplates（36 PDF 中的核心） +- [ ] （详见 `MethodologyAndTemplates/` 目录） + +--- + +### 🟡 P1 - 核心 BSW（Step 4） +- Communication（71） +- Diagnostics（3） +- SystemServices（13） +- MCAL（7） + +### 🟠 P2 - 扩展 BSW（Step 5） +- Memory（16） +- Safety（9） +- Crypto（6） +- ModeManagement（4） +- IO（14） + +### 🔵 P3 - 高级主题（Step 6） +- RTE（2） +- Libraries（10） +- GlobalTime（4） +- HMI（1） +- Chassis（1） +- Powertrain（1） +- Tools（4） +- ReleaseDocumentation（2） + +--- + +## 已交付文件清单 + +### Step 1-2 产出 +- ✅ `翻译术语表.md`（v1，~250 条术语） +- ✅ `翻译进度.md`（本文件） +- ✅ `BSWGeneral/AUTOSAR_SRS_BSWGeneral.md`（试点译文） + +### 工作目录（不在仓库内） +- `/tmp/opencode/translate_workdir/extracted/` —— PDF 提取的原始文本 + - `LayeredSoftwareArchitecture.txt`（442KB） + - `SRS_BSWGeneral.txt`（220KB） + - `SWS_COM.txt`（544KB） +- `/tmp/opencode/translate_workdir/pdf_inventory.txt` —— 完整 PDF 清单 + +--- + +## 试点经验总结 + +### 验证通过 +1. `pdftotext -layout` 可正确提取 AUTOSAR PDF 文本，保留版面结构 +2. 三个试点 PDF（EXP/SRS/SWS 三种类型）均为文本型，无需 OCR +3. 翻译模板（封面 + TOC + 章节 + 需求）格式清晰、可复用 + +### 试点发现 +- PDF 提取后 `⌈⌋` 是 AUTOSAR 需求表格的方框符号，需保留为表格代码块 +- 章节编号（5.1.1.1）在 PDF 中可能有空行间隔，但章节顺序稳定 +- 需求条目 ID（如 `SRS_BSW_00344`）必须**逐字保留** + +### 风险 +- 长文档（如 SWS_COM 185 页 / 10K 行）单次 LLM 翻译可能超上下文 → 需按章节分片 +- 表格翻译：复杂表格（如 Traceability Matrix）需保持原结构，文字部分用中文替换 +- 校对工作量：每篇文档翻译后建议人工抽检关键章节 + +--- + +## 下一步 + +按计划进入 **Step 3：批量翻译 P0**。 +预计产出：~50 个 P0 文档的中文 Markdown。