MindConnect API¶
构想¶
MindConnect Service 公开了一个 API，使车间设备能够安全可靠地向 MindSphere 发送数据。它允许自定义应用（代理）收集和上传由云上的应用存储和使用的数据。
访问¶
要访问此服务，您需要具有 MindConnect API 角色和范围中列出的相应角色。
代理需要一个现场端网络基础设施将出站 HTTPs 请求转发和路由到 Internet。
MindConnect 支持多个代理设备类别：强大的硬件平台以及资源受限设备。所有目标代理平台必须符合以下最低要求：
- HTTP 处理
- TLS
- JSON 解析
- JSON Web Token (JWT) 生成
- HMAC 生成（最好是基于 SHA2 的散列）
基础知识¶
数据源配置¶
需要使用数据源配置来解析从代理接收到的数据。该配置包含数据源和数据点。数据源代表逻辑组，例如一个传感器或一台机器，其中包含一个或多个可测量的数据点，如温度或压力。
使用Agent Management Service对数据源进行定义。具体说明请参考创建数据源配置。
数据点映射¶
需要使用数据点映射来存储从代理接收到的数据，将数据源配置中的数据点映射到表示代理的数字实体的属性。当MindSphere从代理接收到数据后，会查找数据点所映射的属性并将数据存储在属性中。
使用MindConnect Service来定义数据点映射. 具体说明请参考创建数据点映射.
数据上传¶
MindConnect API允许代理向其上传数据。数据可以是如下类型:
- 时序型
- 文件
- 事件
数据格式遵循HTTP多方规范的子集，但只允许两层嵌套。具体说明请参考上传代理数据。
标准数据类型¶
MindConnect Service 使用标准数据类型，让MindSphere可以自动处理数据而无需额外的配置或编码。这表示：
- API 定义了如何传输标准数据类型，例如，如何将元数据和生产数据格式化为 HTTPs 有效载荷。
- 标准数据类型是自动被解析的，其信息会存储到（虚拟）asset中。
- 每种标准数据类型都有可用的预配置海量数据存储。
- 应用和分析工具能够以标准化方式访问和查询标准类型的数据。
对生产数据，支持以下标准数据类型：
- 时间序列
时间序列是随时间不断变化的数据点值，例如来自温度传感器等模拟传感器的值。这也适用于具有关联时间戳的任何其他测量值。 - 事件
事件是基于机器事件，例如紧急停止或机器故障。但是该机制也可用于上传自定义通知，例如，当您在进行现场阈值监控并希望报告超过阈值的情况。 - 文件
每次 exchange 调用可上传最大 10 MB 的文件。文件会附加到相应的（虚拟）asset，例如设备日志文件或复杂的传感器结构。上传的文件可以由父（虚拟）asset 引用。MindSphere 不会解析这些文件的内容，您需要使用自定义应用或分析工具来解读和可视化数据。 - 数据模型
数据模型描述了代理端asset的层级结构以及包括测量点在内的配置信息。
功能¶
MindConnect Service向代理开放API以实现以下任务：
- 上传时间序列
- 上传文件
- 描述并上传 asset 数据模型
- 上传用于自定义处理的自定义类型的数据
示例场景¶
风电场的经理想要收集风力涡轮机的传感器数据。
开发人员编写用于收集传感器数据的现场应用（代理）。数据通过 MindConnect API 发送到 MindSphere。