测量、标定与诊断的唯一名称（Unique Names for Documentation, Measurement and Calibration: Modeling and Naming Aspects including Automatic Generation）

1 参考资料（References）

• [1] SW-C and System Modeling Guide（AUTOSAR_TR_SWCModelingGuide.pdf）
• [2] Table of Application Interfaces（AUTOSAR_MOD_AITable.zip）
• [3] XML Specification of Application Interfaces（AUTOSAR_MOD_AISpecification.zip）
• [4] System Template（AUTOSAR_TPS_SystemTemplate.pdf）

2 范围（Scope）

本文档定义了 AUTOSAR 应用接口（AI）的唯一名称（Unique Names）机制，用于：

• 测量（Measurement）；
• 标定（Calibration）；
• 诊断（Diagnostics）；
• 文档（Documentation）。

这些名称在标定工具（如 INCA、CANape）中必须唯一标识每个测量/标定点。

3 如何阅读本文档（How to read this document）

3.1 约定（Conventions used）

本文档使用编号的规则（Rules）描述命名约定，每条规则以 [TPS_MCD_NNNN] 标识。

3.2 规则编号（Numbering of Rules）

规则按主题分组编号：

• TPS_MCD_0001–TPS_MCD_0099：通用名称规则；
• TPS_MCD_0100–TPS_MCD_0199：测量名称；
• 等等。

3.3 缩略语与缩写（Acronyms and Abbreviations）

4 需求（Requirements）

本文档不直接定义独立的需求，但每条规则隐含了对应用接口建模的需求。详见原文 12–13 页的需求表格。

5 需求追溯（Requirements Traceability）

本文档的规则与 AUTOSAR_RS_Features 中的需求追溯关系见原文 14–15 页。

6 方法论背景（Methodological Background）

6.1 SwCalibrationAccess

SwCalibrationAccess 元模型元素用于标识 SW-C 的标定访问点。它具有：

• shortLabel：短标签（用于显示）；
• symbol：符号名称（用于唯一标识）。

每个 SwCalibrationAccess 实例应当具有唯一的符号名称。

6.2 测量与标定数据的 FlatMap

FlatMap 是 AUTOSAR 提供的机制，将分层的 ECU 数据模型扁平化为唯一名称列表。

图：FlatMap 概念

SwComponentType
   └── SwComponentPrototype (instance)
         └── Port
               └── DataElement (测量/标定点)
                     └── FlatMap → "ECU1.EngN.RpmMeas"
  

FlatMap 生成的名称格式：

<ECU>.<SwcType>.<SwcInstance>.<Port>.<DataElement>

示例（EngN 发动机转速测量）：

Eng.Powertrain.EngN.EngSpd_RpmMeas

6.3 显示名称的 AliasNameSet

AliasNameSet 用于为测量/标定点提供显示名称，可针对不同的标定工具生成不同的名称。

图：AliasNameAssignment

[MeasurementDataPoint]
   ├── shortLabel: "EngN_RpmMeas"
   ├── symbol: "Eng.Powertrain.EngN.RpmMeas"
   └── AliasNameSet
         ├── displayName: "Engine RPM"
         └── toolName (for INCA): "ENG_RPM"
  

6.4 SW-C 类型等的唯一符号名称

每个 SW-C 类型（SwComponentType）应当具有唯一的符号名称。符号名称应当遵循命名约定（详见第 7 章）。

6.5 SW-C 原型唯一名称的 FlatMap

类似测量数据，SW-C 原型也可通过 FlatMap 生成唯一名称。

6.6 虚拟命名空间

虚拟命名空间（Virtual Name Spaces）用于在 FlatMap 中分隔不同的 ECU 或项目，避免名称冲突。

6.7 文档中的引用

标定工具使用唯一名称引用测量/标定点。文档中应当使用符号名称（symbol）进行引用。

6.8 实例 cp- 与 pb- 路径

AUTOSAR 提供两种唯一标识实例的路径：

• cp-path：构建路径（compile-time path）；
• pb-path：构建后路径（post-build path）。

两者用于不同的配置阶段。

7 总体建模与生成规则（Overall Modeling and Generation Rules）

7.1 名称部分长度（Name Part Length）

名称各部分的最大长度由规则规定（如 TPS_MCD_0001）。具体数值详见原文。

8 数据原型（Data Prototypes）

数据原型（DataPrototype）是 SW-C 之间传递的数据元素定义。它分为：

• VariableDataPrototype：变量数据；
• ParameterDataPrototype：参数数据；
• ApplicationDataPrototype：操作参数。

9 数据接口中的数据原型（Data Prototypes in DataInterfaces）

9.1 提高显示名称的可读性

显示名称（Display Name）应当遵循人类可读约定：

• 使用有意义的单词；
• 避免无意义的缩写；
• 使用 CamelCase 风格。

9.2 SenderReceiver 接口中的 VariableDataPrototype

在 SenderReceiverInterface 中，VariableDataPrototype 表示发送/接收的数据元素。每个元素具有：

• 类型（Type）；
• 单位（Unit）；
• 计算方法（Computation Method）；
• 短标签与符号名称。

9.3 ParameterInterface 中的 ParameterDataPrototype

在 ParameterInterface 中，ParameterDataPrototype 表示标定参数。这些参数可通过标定工具修改。

10 ClientServer 接口中的数据原型（Data Prototypes in ClientServerInterfaces）

10.1 内部行为中的数据原型（Data Prototypes within InternalBehavior）

ClientServerInterface 的操作（Operation）可具有参数（ApplicationDataPrototype）：

• 输入参数（Direction = IN）；
• 输出参数（Direction = OUT）；
• 输入输出参数（Direction = INOUT）。

每个参数应当具有唯一名称以支持调用追踪。

11 命名空间（Name Space）

AUTOSAR 使用命名空间机制管理名称：

• 每个 SW-C 类型属于一个命名空间；
• 命名空间通过 ARPackage 组织；
• 跨命名空间的引用应当通过完整的引用路径。

12 SwSystemconsts

SwSystemconsts 是 AUTOSAR 中定义系统级常量的容器。这些常量在整个 ECU 中可用。

13 端口原型蓝图（PortPrototypeBlueprints）

端口原型蓝图（PortPrototypeBlueprint）是可重用的端口模板。每个蓝图应当具有唯一的 shortLabel 和 symbol。

14 组件层次结构（ComponentHierarchy）

组合 SW-C（Composition SW-C）通过组件层次结构组织子组件。每个组件层次应当具有唯一的名称。

示例：多实例化 - Coordinator Wheels

Composition: Vehicle
   ├── SwComponentPrototype: Coordinator_FrontWheels
   │     └── Port: WheelAngleCmd (RPort)
   └── SwComponentPrototype: Coordinator_RearWheels
         └── Port: WheelAngleCmd (RPort)
  

15 SW-C 原型（SwComponentPrototypes）

每个 SwComponentPrototype 实例化一个 SwComponentType。原型应当具有唯一名称以支持多实例化。

16 SW 信号显示名称（Unique SW-Signal Display Names）

SW 信号（数据元素）应当具有唯一的显示名称，用于：

• 测量（Measurement）；
• 标定（Calibration）；
• 诊断（Diagnostics）；
• 文档（Documentation）。

示例：ExtrLi 多实例化

SwComponentType: ExtrLi (Exterior Light Controller)
   └── SwComponentPrototype: ExtrLi_FrontLeft
         └── DataElement: HeadLightStatus
   └── SwComponentPrototype: ExtrLi_FrontRight
         └── DataElement: HeadLightStatus
  

FlatMap 后：

Vehicle.ExtrLi.ExtrLi_FrontLeft.HeadLightStatus
Vehicle.ExtrLi.ExtrLi_FrontRight.HeadLightStatus
  

17 附录：动力总成域的物理/逻辑关键字（P/L-List）

附录列出了动力总成（Powertrain）域的物理/逻辑关键字（P/L-List），包括：

• EngN（Engine Speed，发动机转速）；
• EngTq（Engine Torque，发动机扭矩）；
• AccPdlPos（Accelerator Pedal Position，加速踏板位置）；
• VehSpd（Vehicle Speed，车速）；
• 等等。

每个 P/L 关键字提供：

• 短标签（shortLabel）：人类可读的简短名称；
• 符号（symbol）：唯一标识符；
• 描述（description）：详细说明。