Add AUTOSAR v4.4 translation pilot: terminology, progress tracker, SRS_BSWGeneral sample
This commit is contained in:
@@ -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)<br>• 新增模块初始化错误相关需求(SRS_BSW_00487)<br>• 头文件清理<br>• 移除过时引用<br>• 编辑性修订 |
|
||||
| 2017-12-08 | 4.3.1 | AUTOSAR Release Management | • 头文件生命周期变更<br>• 更新相关标准和规范<br>• 编辑性修订 |
|
||||
| 2016-11-30 | 4.3.0 | AUTOSAR Release Management | • 新增 C90 接口支持<br>• 更新 MISRA 2012 支持<br>• 移除过时引用<br>• 编辑性修订 |
|
||||
| 2015-07-31 | 4.2.2 | AUTOSAR Release Management | • 引入新需求 SRS_BSW_00403<br>• 引入新需求 SRS_BSW_00351<br>• 修改需求 SRS_BSW_00406 和 SRS_BSW_00450<br>• 调试支持标记为过时 |
|
||||
| 2014-10-31 | 4.2.1 | AUTOSAR Release Management | • 后构建配置与 SWS_BSWGeneral 对齐<br>• 运行时错误定义的重新表述<br>• 引入 SupportForPBLAndPBSECUConfiguration 概念<br>• 编辑性修订 |
|
||||
| 2014-03-31 | 4.1.3 | AUTOSAR Release Management | • 移除/修改关于标准头文件的需求,提供更抽象的视图<br>• 改进运行时错误的定义<br>• 编辑性修订 |
|
||||
| 2013-10-31 | 4.1.2 | AUTOSAR Release Management | • 修订接口管理及其类型到模块的独立头文件中<br>• 删除冗余需求<br>• 编辑性修订 |
|
||||
| 2013-03-15 | 4.1.1 | AUTOSAR Administration | • BSW 模块到 DEM 的接口和 DEM 去抖<br>• BSW 模块中断例程的声明和实现需求<br>• AUTOSAR 服务的函数原型和回调函数改进<br>• 安全性和完整性改进 |
|
||||
| 2011-12-22 | 4.0.3 | AUTOSAR Administration | • 安全性和完整性改进:<br> • 限制 Init 和确定函数的调用方<br> • 可重入处理<br> • BSW 模块中断例程的新实现需求<br> • 适配 BSW 模块的包含结构(如 RTE 头文件处理)<br> • 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 校对** 试点版本
|
||||
- 标记 `<!-- TODO: 校对 -->` 的段落表示尚未校对的英文原版
|
||||
- 建议校对时优先检查:表格内容、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.*
|
||||
Reference in New Issue
Block a user