Open Edge Device Kit¶
简介¶
Open Edge Device Kit 针对的是想让自己的设备与 MindSphere 兼容的第三方设备生产商。它是一个独立的模块，可以安装在设备上并作为 MindSphere 的接口。Open Edge Device Kit 满足以下常见需求：
- 在 MindSphere 执行身份认证
- 执行与安全相关联的动作
- 周期性检查 MindSphere 上相关的信息
- 缓存数据
Open Edge Device Kit 调用 MindSphere 端点将状态更新和时间序列数据发送到云中，并为设备收集新信息。它使用 MQTT 消息处理设备上的通信。在设备上运行的模块不需要直接访问 MindSphere。他们只需要发布和订阅特定的主题，并与 Open Edge Device Kit 通信。这使得 Open Edge Device Kit 成为一个简单的解决方案，使现有的设备准备好连接到 MindSphere。
获取 Open Edge Device Kit¶
您可以从 Siemens Industry Online Support (SIOS) Portal 中下载 Open Edge Device Kit，请使用以下链接：[英语版]/[德语版]。Open Edge Device Kit 可以下载为安装脚本或 docker 映像。docker 映像还包含用作 MQTT 代理的 Eclipse Mosquitto。
通信协议¶
设备的模块必须使用 MQTT 协议来与 Open Edge Device Kit 通信并担当 MQTT 客户端。我们建议您使用 Mosquitto MQTT Broker，因为其他代理还没有在 Open Edge Device Kit 上进行测试。Open Edge Device Kit 的 docker 版本已经包括这个代理。
连接参数¶
需要以下参数来建立 MQTT 连接：
| 参数 | 值 | 描述 |
|---|---|---|
| Address | localhost:1883 | MQTT 客户端连接到代理的地址 |
| QoS | 参考主题细节 | 一条消息的 Quality of Service (QoS) 等级可以是以下的一种：
|
| Message Retention Policy | 参考主题细节 | 如果一条消息的 retained 标记设定为 TRUE，代理将储存主题的最后一条消息和对应的 QoS。每个订阅这个主题的客户端将在订阅后立即接收消息。 |
| Automatic Reconnect Policy | TRUE | MQTT 客户端必须激活自动重新连接功能。 |
| Clean Session | FALSE | MQTT 客户端的订阅将持续存在，任何具有 QoS 1或 QoS 2的消息都将存储，直到客户端重新连接。 |
| Connection Keep Alive Interval | 180 秒 | 定义消息之间的最大时间间隔。如果服务器不再可用而不等待 TCP/IP 超时，这将使 MQTT 客户端能够检测。客户端发送一条由服务器确认的 "ping" 消息。 |
| sys_interval | 10 | $SYS订阅层级更新之间的秒数，它提供关于代理的状态信息。 在加载信号时重新加载。 |
主题¶
通过 Open Edge Device Kit 订阅¶
Open Edge Device Kit 订阅本章中列出的主题。它们允许模块控制 Open Edge Device Kit 来发送状态消息和时间序列数据，这些将被 Open Edge Device Kit 上传到 MindSphere。
打开 Edge Device Kit Controls¶
模块可以使用以下主题来控制 Open Edge Device Kit：
状态消息¶
模块可以使用以下主题来发送他们的状态到 Open Edge Device Kit：
时间序列数据上传¶
模块可以使用以下主题来发送他们的数据到 Open Edge Device Kit：
通过 Open Edge Device Kit 发布¶
Open Edge Device Kit 发布本章中列出的主题。消息包含状态信息、配置数据和从 MindSphere 后端接收到命令。如果模块订阅各自的主题，它们仅接收这些消息。
Open Edge Device Kit 状态消息¶
Open Edge Device Kit 发布以下状态消息。
配置更新¶
Open Edge Device Kit 使用以下主题发布配置和固件更新：
时间序列数据上传¶
限制¶
数据上传限制¶
MindSphere 根据购买的 MindSPhere plan 限制允许的最大数据上传速率。因为该限制时可变的，Open Edge Device Kit 没有对上传速率使用检查机制。用户有责任保持在他们的限制之内。
Open Edge Device Kit 定期执行数据上传操作，在每个周期结束的一个周期内上传收到的所有数据。如果这导致超过数据摄入限制，MindSphere 将丢弃数据包并导致数据丢失。Open Edge Device Kit 的上传周期可以根据数据源配置文件中的每个数据源进行调整。