Files
autosar_standard_spec_v4.4/BSWGeneral/AUTOSAR_SRS_BSWGeneral.md
T

329 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 基础软件模块通用需求
> **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>&nbsp;&nbsp;• 限制 Init 和确定函数的调用方<br>&nbsp;&nbsp;• 可重入处理<br>&nbsp;&nbsp;• BSW 模块中断例程的新实现需求<br>&nbsp;&nbsp;• 适配 BSW 模块的包含结构(如 RTE 头文件处理)<br>&nbsp;&nbsp;• 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.*