Siemens Simit 接口(Pro)

⚠️

请注意此接口仅包含在 realvirtual Professional 中

ℹ️

版本 6.0.4 新功能: 本文档包含 realvirtual 6.0.4 中的新功能和改进,包括一键编译定义设置和增强的 SIMIT Unity 耦合 V4.0.2 支持。

概述

Siemens Simit Unity Coupling Interface 提供 realvirtual 与 Siemens SIMIT 仿真平台之间的时间同步通信。此接口实现基于 Unity 的虚拟调试与 SIMIT 工厂模型及 PLC 仿真环境(包括 PLCSIMAdvanced)的精确耦合。

主要功能:

  • 与 SIMIT 的时间同步通信
  • realvirtual 和 SIMIT 之间的自动信号映射
  • 支持二进制(Binary)、模拟(Analog)和整数(Integer)信号类型
  • 一键编译定义设置 (6.0.4 新增)
  • 增强的 SignalType 枚举处理 (6.0.4 新增)
  • 兼容 PLCSIMAdvanced 集成
  • 实时双向数据交换

何时使用此接口

在以下情况下使用 Siemens SIMIT 接口:

  • 需要 Unity 和 SIMIT 仿真之间的精确时序同步
  • 耦合仿真中 Unity 等待 SIMIT 计算步骤
  • 通过 SIMIT 耦合的 PLCSIMAdvanced 集成
  • 需要确定性时序的高级联合仿真场景

对于没有时序要求的标准应用,请考虑使用 SIMIT Shared Memory Interface 作为更轻量的替代方案。

更多信息请参见:

Siemens Simit Coupling - Documentation

要求

软件要求:

  • Unity 2022.3 LTS 或更高版本(推荐 Unity 6)
  • Siemens SIMIT V11.2 或更高版本
  • SIMIT Unity Coupling Package V4.0.2 或更高版本
  • realvirtual Professional 许可证

硬件要求:

  • Windows 10/11(64 位)
  • 最低 8GB RAM(推荐 16GB)
  • DirectX 11 兼容显卡

安装

步骤 1:获取 SIMIT Unity Coupling Package

从 Siemens 下载 SIMIT Unity Coupling 包:

步骤 2:安装 SIMIT Unity Package

  1. 将 SIMIT Unity 包解压到本地目录
  2. 在 Unity 中,打开 Window → Package Manager
  3. 点击 + → Add package from disk
  4. 导航到解压的 SIMIT 包并选择 package.json
  5. 等待 Unity 导入包
Siemens Simit 接口

步骤 3:设置编译定义符号

接口需要设置编译定义 REALVIRTUAL_SIEMENSSIMIT。realvirtual 6.0.4 提供自动设置:

  1. SiemensSimitInterface 组件添加到场景中的游戏对象
  2. 在检视器中,点击 "Add REALVIRTUAL_SIEMENSSIMIT Define" 按钮
  3. Unity 将自动添加定义并重新编译脚本

6.0.4 新增: 一键编译定义设置消除了手动配置错误,简化了 SIMIT 接口设置过程。

一键编译定义设置
ℹ️

一旦正确定义,设置按钮会自动消失,防止意外重复定义。

配置

将接口添加到场景

  1. 创建接口游戏对象:添加空游戏对象,添加 SiemensSimitInterface 组件
  2. 添加 SIMIT 连接:将 SimitConnection 预制件拖入场景,在 SiemensSimitInterface 中引用它
  3. 在 Unity 中完成 SIMIT 接口设置

信号配置

步骤 1:添加 realvirtual 信号

将所有 realvirtual 信号组件作为 SiemensSimitInterface 游戏对象的子对象添加。支持的信号类型:

  • PLCInputBool/PLCOutputBool → SIMIT 二进制信号
  • PLCInputFloat/PLCOutputFloat → SIMIT 模拟信号
  • PLCInputInt/PLCOutputInt → SIMIT 整数信号

步骤 2:更新信号映射

启用自动更新信号(默认)时,每当您在编辑模式下添加、移除、重命名或更改子信号类型时,信号映射都会自动导出。要手动刷新,点击 "Refresh Simit Signals" 按钮。

步骤 3:在 SIMIT 中导入信号

在 SIMIT 项目中使用 Unity Coupling → Update Signals。所有信号以命名约定出现:

带 Auto Update Signals 和 Refresh Simit Signals 按钮的 SiemensSimitInterface
带 SIMIT 接口和信号的场景
在 SIMIT 中导入的信号

[SimitInterfaceName].realvirtualCoupler.[SignalName]

属性

Siemens Simit Interface (Script)

  • Active(Always/Never)- 接口激活模式
  • Simit Connection(GameObject)- 对 SimitConnection 预制件的引用
  • Allow Time Sync(布尔值)- 让 SIMIT 驱动 Unity 的 FixedUpdate 速率和信号更新周期
  • Auto Update Signals(布尔值)- 自动重新导出 Simit 信号列表
  • Debug Mode(布尔值)- 启用调试日志记录

Realvirtual Coupler (Script)

  • Signals(Signal[])- 映射信号的自动填充数组(只读)

故障排除

常见问题:

  1. "SIMIT types not found" 编译错误
    • 确保 SIMIT Unity 包已正确安装
    • 验证 REALVIRTUAL_SIEMENSSIMIT 定义已设置
    • 使用接口中的自动设置按钮
    • SIMIT 中无信号显示
    • 检查信号是否为 SiemensSimitInterface 的子对象
    • 确保 Auto Update Signals 已启用或点击 Refresh Simit Signals
    • 验证 SimitConnection 已引用并激活
    • 接口未连接
    • 确保 SimitConnection 预制件在场景中
    • 检查 SIMIT 中的 SIMIT Unity Coupling 设置
    • 验证网络连接(如果使用远程 SIMIT)
⚠️

确保在使用此接口之前已正确安装 SIMIT Unity Coupling 包。缺少 SIMIT 组件将导致编译错误。