4. OPC UA信息建模

OPC UA 之所以能够成为工业互操作的标准，其核心优势不在于简单的数据读写，而在于其强大的、面向对象的信息建模能力。传统工业协议（如 Modbus、Profibus）传输的是无结构的寄存器或数据块，而 OPC UA 则允许我们将现实世界中的设备、系统、软件组件及其复杂关系，以标准化的、机器可读的方式映射到地址空间（AddressSpace）中。本章将深入剖析 OPC UA 信息建模的基石——节点（Node）与引用（Reference），并系统讲解如何利用它们构建类型层次、对象实例、数据类型以及自定义信息模型，帮助您从“传数据”的思维升级到“建模型”的架构思维。

上图清晰地展示了 OPC UA 信息建模的四大支柱：节点、引用、类型层次和对象实例。节点是信息的最小单元，引用将这些节点编织成一张有向图，类型层次定义了信息的语义结构，而对象实例则是类型在现实世界中的具体映射。下面我们将逐一拆解这些概念，并探讨如何在实际项目中应用它们。

4.1 节点与引用：信息建模的原子与化学键

4.1.1 核心原理：一切皆节点，关系皆引用

在 OPC UA 地址空间中，所有信息都被建模为节点（Node）。每个节点都包含一组标准属性，用于唯一标识和描述该节点。最重要的属性包括：

• NodeId：节点的唯一标识符，类似于数据库中的主键。它由命名空间索引（NamespaceIndex）和标识符（Identifier）组成，确保不同厂商的节点不会冲突。
• NodeClass：节点的类型，决定了节点的基本语义。OPC UA 定义了 8 种节点类：对象（Object）、变量（Variable）、方法（Method）、对象类型（ObjectType）、变量类型（VariableType）、数据类型（DataType）、引用类型（ReferenceType）和视图（View）。
• BrowseName：用于浏览（Browse）操作的名称，通常是一个人类可读的字符串，但不要求全局唯一。
• DisplayName：用于界面显示的本地化名称，可以包含多语言翻译。
• Description：节点的文本描述，用于文档化。

引用（Reference）则是连接两个节点的有向边，其本质是一个三元组：SourceNodeId + ReferenceTypeId + TargetNodeId。引用类型（ReferenceType）本身也是一个节点，它定义了引用的语义。例如，Organizes 表示组织关系，HasComponent 表示包含关系，HasProperty 表示属性关系，HasSubtype 表示继承关系。

4.1.2 判断方法：如何选择正确的节点类和引用类型

在实际建模时，工程师经常面临“该用对象还是变量？”、“该用 HasComponent 还是 HasProperty？”的困惑。以下判断流程可以帮助您做出正确决策：

1. 判断节点类：如果该信息是一个“东西”（如一台电机、一个工单、一个配方），则使用对象（Object）；如果该信息是一个“数值”（如温度、压力、状态码），则使用变量（Variable）；如果该信息是一个“操作”（如启动、停止、复位），则使用方法（Method）。
2. 判断引用类型：如果目标节点是源节点的“组成部分”且生命周期一致，使用 HasComponent；如果目标节点是源节点的“属性”且为简单数据类型（如字符串、整数），使用 HasProperty；如果目标节点是源节点的“子类型”，使用 HasSubtype；如果目标节点是源节点的“组织单元”（如文件夹），使用 Organizes。
3. 判断数据类型：如果变量值是一个简单的标量（如 Float、Int32），直接使用内置数据类型；如果变量值是一个结构体（如包含 X、Y、Z 的坐标），则需要自定义数据类型。

场景	推荐节点类	推荐引用类型	说明
电机转速	Variable	HasComponent	转速是电机的组成部分，类型为 Float
电机序列号	Variable	HasProperty	序列号是电机的属性，类型为 String
电机启动操作	Method	HasComponent	启动是电机的功能
电机类型定义	ObjectType	HasSubtype	从 BaseObjectType 继承
工厂车间分组	Object	Organizes	车间是工厂的组织单元

4.1.3 案例拆解：构建一个简单的“泵”对象

假设我们需要为一个水泵建模。该泵具有以下信息：运行状态（布尔值）、出口压力（浮点数）、累计运行时间（整数），以及一个“启动”方法。我们按照以下步骤构建模型：

1. 定义类型：创建一个对象类型 PumpType，其父类型为 BaseObjectType。在 PumpType 下添加两个变量节点：IsRunning（数据类型 Boolean）和 OutletPressure（数据类型 Float），以及一个方法节点 Start。
2. 定义属性：为 PumpType 添加一个属性 SerialNumber（数据类型 String），使用 HasProperty 引用。
3. 实例化：在地址空间中创建一个对象节点 Pump_01，其类型定义为 PumpType。此时，Pump_01 自动继承了 PumpType 下声明的所有变量、方法和属性。
4. 设置值：将 Pump_01.IsRunning 的当前值设置为 False，Pump_01.OutletPressure 设置为 0.0。

// 伪代码：创建类型和实例
// 1. 创建 PumpType
NodeId pumpTypeId = new NodeId("PumpType", 2);
ObjectTypeNode pumpType = new ObjectTypeNode(pumpTypeId);
pumpType.DisplayName = "PumpType";
pumpType.SuperType = ObjectTypeIds.BaseObjectType;

// 2. 添加变量 IsRunning
VariableNode isRunning = new VariableNode(new NodeId("IsRunning", 2));
isRunning.DataType = DataTypeIds.Boolean;
isRunning.TypeDefinition = VariableTypeIds.BaseDataVariableType;
pumpType.AddComponent(ReferenceTypeIds.HasComponent, isRunning);

// 3. 实例化 Pump_01
NodeId pump01Id = new NodeId("Pump_01", 2);
ObjectNode pump01 = new ObjectNode(pump01Id);
pump01.TypeDefinition = pumpTypeId;
pump01.DisplayName = "Pump_01";

4.1.4 常见误区与总结复盘

• 误区一：将属性建模为组件。属性（Property）应该是简单的、不可再分的元数据（如序列号、厂商名），而组件（Component）可以是复杂的对象或变量。将属性建模为组件会导致浏览层次混乱。
• 误区二：忽略命名空间。不同厂商的节点必须使用不同的命名空间索引，否则 NodeId 会冲突。建议在服务器启动时动态分配命名空间索引。
• 误区三：滥用 Organizes 引用。Organizes 用于定义层次结构，但不表示“包含”关系。例如，将“车间”用 Organizes 指向“设备”是合理的，但将“设备”用 Organizes 指向“温度变量”则不合理，应该使用 HasComponent。

复盘：节点和引用是 OPC UA 信息建模的语法基础。掌握它们的关键在于理解“节点是名词，引用是动词”。在建模前，先列出所有需要表达的名词（设备、变量、方法），再确定它们之间的动词关系（包含、继承、组织、触发）。

4.2 类型层次与对象实例：从抽象到具体

4.2.1 核心原理：类型定义行为，实例承载状态

OPC UA 的类型系统是面向对象的。类型（Type）定义了对象的结构、行为和约束，而实例（Instance）是类型的具体实现，拥有独立的状态（即变量的值）。类型层次通过 HasSubtype 引用构建，形成一棵继承树。例如：

• BaseObjectType → DeviceType → PumpType → CentrifugalPumpType
• BaseDataVariableType → AnalogItemType → PressureSensorType

类型层次的设计直接影响到信息模型的复用性和可维护性。一个良好的类型层次应该遵循“单一职责”原则，将通用的行为放在高层类型中，将特殊的行为放在低层类型中。

4.2.2 操作流程：设计类型层次的四步法

1. 识别抽象层：分析您的设备或系统，找出所有可以抽象为“类型”的概念。例如，所有电机都有“转速”和“温度”变量，因此可以定义一个 MotorType。
2. 定义继承关系：确定类型之间的父子关系。例如，InductionMotorType 是 MotorType 的子类型，增加了“滑差”变量。
3. 声明实例成员：在类型节点下声明变量、方法和属性。这些成员在实例化时会被复制到实例节点中。
4. 实例化并赋值：创建具体的对象节点，指定其 TypeDefinition 属性指向对应的类型节点。然后为实例中的变量设置初始值。

4.2.3 案例拆解：构建一个“变频驱动器”类型层次

我们以变频驱动器（VFD）为例，设计一个包含三个层次的信息模型：

层次	类型名称	父类型	新增成员
L1	VFDType	BaseObjectType	OutputFrequency (Float), OutputCurrent (Float), Start() 方法
L2	AdvancedVFDType	VFDType	DCBusVoltage (Float), FaultCode (Int32), Reset() 方法
L3	ServoVFDType	AdvancedVFDType	PositionFeedback (Float), VelocityCommand (Float)

在实例化时，我们创建 VFD_Line1（类型为 AdvancedVFDType）和 VFD_RobotAxis（类型为 ServoVFDType）。这两个实例都继承了各自类型的所有成员，但它们的变量值是完全独立的。

4.2.4 常见误区与总结复盘

• 误区一：类型节点与实例节点混淆。类型节点是“模板”，实例节点是“成品”。在浏览地址空间时，用户通常只关心实例节点，但服务器必须同时暴露类型节点以供客户端发现。
• 误区二：在类型中定义过多具体属性。例如，在 MotorType 中定义“额定功率”属性是合理的，但定义“当前功率”则不合理，因为“当前功率”是运行状态，应该属于实例。
• 误区三：忽略类型定义的版本管理。当类型定义发生变化时，已存在的实例可能无法自动更新。建议在类型节点中添加一个 ModelVersion 属性，并在服务器启动时检查版本兼容性。

复盘：类型层次是信息模型的可复用资产。设计时要从“未来扩展”的角度出发，但也要避免过度设计。一个实用的方法是：先为当前需求建模，然后提取公共部分到父类型中，最后再考虑是否需要进一步抽象。

4.3 数据类型与自定义信息模型：扩展语义的边界

4.3.1 核心原理：内置类型与自定义结构体

OPC UA 提供了丰富的内置数据类型（如 Boolean、Int32、Float、String、DateTime 等），这些类型覆盖了大多数简单场景。然而，工业应用中经常需要传输结构化的数据，例如一个“坐标点”（X、Y、Z）或一个“诊断信息”（错误码、错误描述、时间戳）。此时，我们需要自定义数据类型。

自定义数据类型通过 DataType 节点定义，其父类型可以是 Structure（结构体）或 Union（联合体）。定义完成后，还需要指定数据编码方式（Data Encoding），常见的有：

• UA Binary：高效的二进制编码，适用于带宽受限的工业网络。
• UA JSON：可读性强的 JSON 编码，适用于 Web 应用和云平台。
• UA XML：基于 XML 的编码，适用于配置交换和文档化。

4.3.2 操作流程：创建自定义数据类型的步骤

1. 定义结构体：创建一个 DataType 节点，设置其 DataTypeClass 为 Structure，并指定其父类型（通常为 Structure 或已有的自定义结构体）。
2. 添加字段：为结构体添加字段。每个字段都是一个 Variable 节点，其数据类型可以是内置类型或其他自定义类型。
3. 生成编码：为结构体生成数据编码。在 UA Binary 编码中，需要为每个字段分配一个唯一的二进制编号（FieldId）。
4. 在变量中使用：将某个变量的 DataType 属性指向该自定义数据类型。

// 定义坐标点结构体
DataTypeNode coordinateType = new DataTypeNode(new NodeId("CoordinateType", 2));
coordinateType.DisplayName = "CoordinateType";
coordinateType.SuperType = DataTypeIds.Structure;

// 添加字段 X, Y, Z
VariableNode fieldX = new VariableNode(new NodeId("X", 2));
fieldX.DataType = DataTypeIds.Double;
coordinateType.AddComponent(ReferenceTypeIds.HasComponent, fieldX);
// 同理添加 Y, Z

4.3.3 案例拆解：为“机器人路径点”定义自定义数据类型

假设我们需要为机器人控制器建模，要求传输“路径点”数据，每个路径点包含位置（X、Y、Z）、姿态（A、B、C）和速度（Float）。我们定义一个名为 RobotPathPointType 的结构体：

字段名	数据类型	说明
Position	CoordinateType	自定义结构体，包含 X、Y、Z
Orientation	CoordinateType	自定义结构体，包含 A、B、C
Speed	Float	路径点速度

在服务器中，我们创建一个变量 CurrentTarget，其数据类型为 RobotPathPointType。客户端可以通过读取该变量获取完整的路径点信息，而无需分别读取 X、Y、Z 等 7 个独立变量。这不仅减少了网络通信次数，还保证了数据的一致性（所有字段同时更新）。