1 文档范围(Scope of Document)
本文档定义 AUTOSAR 内需求规范的一般规则和格式。它应作为每个需求文档的基础。
1.1 术语(Terminology)
| 术语 | 说明 |
|---|---|
| Identifiable(可标识元素) | 任何可以具有属性集的模型元素。请参阅 AUTOSAR 元模型以获取该术语的进一步详细解释("该类的实例可以通过其标识符引用(同时遵守命名空间边界)")。除非需求适用于特定元模型可标识元素(如 Port、Data Type 等),否则应使用此术语,而不是"element"、"data name"等。 |
| ARElement | AUTOSAR 元模型中的定义:"可以独立定义的元素,即不属于另一个元素(除了包之外)。与包相反,元素是封闭集合,即在基于文件的描述中,一个 ARElement 需要被完整描述,不能被另一个文件扩展或补充。" |
| ARPackage | AUTOSAR 元模型中的定义:"AUTOSAR 包,允许创建顶层包以组织所包含的 ARElement。ARPackage 是开放集合,这意味着在基于文件的描述系统中,可以使用多个文件来部分描述包的内容。这是 MSR 的 SW-SYSTEM 的扩展版本。" |
2 约定(Conventions to be used)
本文档中的需求使用以下结构:
- 每个需求以
[RS_SWMG_NNNNN]形式标识; - 描述以半角括号
⌈ ... ⌋标记; - 支持的 SRS 引用列在括号中(若适用)。
3 缩略语与缩写(Acronyms and Abbreviations)
| 缩略语 | 说明 |
|---|---|
| AR | AUTOSAR |
| SW-C | Software Component(软件组件) |
| SWMG | Software Modeling Group(软件建模工作组) |
| ISO | International Organization for Standardization(国际标准化组织) |
4 命名约定需求(Naming Convention Requirements)
4.1 [RS_SWMG_00001] 区分标准化与非标准化的 ARElement
[RS_SWMG_00001]
AUTOSAR 模型应当区分标准化的 ARElement(如标准化的 Port、Data Type 等)和非标准化的 ARElement。
4.2 [RS_SWMG_00002] 名称应反映模型元素的用途
[RS_SWMG_00002]
模型元素的名称应当反映该元素的用途。
4.3 [RS_SWMG_00005] 易于创建名称
[RS_SWMG_00005]
模型元素的名称应当易于创建(无需手动拼接大量随机字符串)。
4.4 [RS_SWMG_00006] 名称应自解释
[RS_SWMG_00006]
模型元素的名称应当自解释(self-explanatory)。
4.5 [RS_SWMG_00007] 区分不同提供方的模型元素
[RS_SWMG_00007]
AUTOSAR 模型应当能够区分不同提供方(supplier)的模型元素。
4.6 [RS_SWMG_00010] 名称应遵循语义规则
[RS_SWMG_00010]
模型元素名称应当遵循语义规则。
4.7 [RS_SWMG_00011] 通过排列标准化关键字构造名称
[RS_SWMG_00011]
模型元素名称应当通过排列标准化关键字构造。
4.8 [RS_SWMG_00012] 名称应支持可变数量的关键字
[RS_SWMG_00012]
模型元素名称的语义应当允许使用可变数量的关键字。
4.9 [RS_SWMG_00014] Identifiable 短名称长度限制
[RS_SWMG_00014]
Identifiable 的短名称(short name)长度应当限制为 128 个字符。
4.10 [RS_SWMG_00016] 名称应区分测量值与条件值
[RS_SWMG_00016]
名称应当能够指示其值是直接测量值还是条件值。
4.11 [RS_SWMG_00017] 名称应遵循 ISO 8855 英语命名
[RS_SWMG_00017]
名称应当遵循 ISO 8855 标准进行英语命名。
4.12 [RS_SWMG_00030] 使用英语作为标准命名语言
[RS_SWMG_00030]
应当使用英语作为标准命名语言。
4.13 [RS_SWMG_00031] 名称中不包含架构信息
[RS_SWMG_00031]
名称应当不包含架构信息(如层级、归属等),以保证跨 ECU 复用。
4.14 [RS_SWMG_00034] 使用唯一关键字
[RS_SWMG_00034]
应当使用唯一的标准化关键字集,避免一词多义。
4.15 [RS_SWMG_00039] 避免尾部下划线
[RS_SWMG_00039]
应当避免在名称中使用尾部下划线。
4.16 [RS_SWMG_00040] 避免连续下划线
[RS_SWMG_00040]
应当避免在名称中出现连续的下划线字符序列。
4.17 [RS_SWMG_00041] 不要仅依赖大小写差异
[RS_SWMG_00041]
名称不应仅通过大小写差异区分两个不同的元素。
4.18 [RS_SWMG_00048] 数据库名称易于查找
[RS_SWMG_00048]
命名约定应当支持在数据库中易于查找名称。
4.19 [RS_SWMG_00049] 支持已有的 Identifiable
[RS_SWMG_00049]
命名约定应当支持主表(MasterTable)中已存在的 Identifiable。
4.20 [RS_SWMG_00054] 提供名称冲突解决指南
[RS_SWMG_00054]
应当提供关于如何解决名称冲突的指南。
4.21 [RS_SWMG_00059] 单一关键字集
[RS_SWMG_00059]
应当存在单一的标准化关键字集。
4.22 [RS_SWMG_00060] 命名约定的适用范围
[RS_SWMG_00060]
命名约定的适用范围应当明确定义。
4.23 [RS_SWMG_00061] 命名约定应唯一
[RS_SWMG_00061]
命名约定应当具有唯一性,同一元素不应有多种命名方式。
4.24 [RS_SWMG_00062] 命名约定应规范短名称与长名称构造
[RS_SWMG_00062]
命名约定应当规范短名称(Short Names)与长名称(Long Names)的构造方式。
5 建模需求(Modeling Requirements)
5.1 [RS_SWMG_00052] 包结构的定义
[RS_SWMG_00052]
AUTOSAR 模型应当明确定义包结构(package structure)。
5.2 [RS_SWMG_00053] 模型应符合元模型
[RS_SWMG_00053]
模型应当符合 AUTOSAR 元模型(Meta Model)。
5.3 [RS_SWMG_00055] 连续数据类型解析应为 2 的幂
[RS_SWMG_00055]
连续数据类型(continuous data type)的解析度(resolution)应当是 2 的幂。
5.4 [RS_SWMG_00056] 标准化模型元素不应包含非标准化元素
[RS_SWMG_00056]
标准化的模型元素不应包含非标准化的元素。
5.5 [RS_SWMG_00057] 建模指南应支持 AUTOSAR 方法论
[RS_SWMG_00057]
建模指南应当支持 AUTOSAR 方法论。
6 参考资料(References)
6.1 AUTOSAR 交付物
- AUTOSAR Generic Structure Template
- AUTOSAR Meta Model
- AUTOSAR Layered Software Architecture
- AUTOSAR Software Component Template