跳到主要内容

HTTP 推送 / 电机感知 (Motor Sense)

这是从 PLC 以外的 外部 IT 系统 / 测量解决方案 获取数值的两种模式。

模式适用场景
HTTP 推送外部系统主动向网关"发送"数值时。例如：厂内 MES 推送批次名称、条码扫描器推送数值
电机感知 (MOTOR_SENSE)以 polling 方式获取 KOPENS 电机感知解决方案的振动/状态数据时

HTTP 推送模式​

不是网关主动去 PLC "读取"数值，而是由外部系统将数值推送 (push) 进来的方式。

注册表单输入项​

输入栏填写内容
IP 地址（实际不使用，仅用于识别）— 例如：127.0.0.1
端口（实际不使用）— 例如：0
采集周期网关从缓存中读取并处理外部推送数值的周期 — 通常为 1000

标签的 PLC 地址表示法​

为自由键字符串，是外部系统推送数值时使用的标识符。

示例含义
temperature自由命名
line/A/rpm可包含斜杠
barcode.last可包含点号

从外部发送数值的方法​

向网关发送以下格式的 HTTP 请求。

POST http://<gateway-ip>/api/v1/tag/<tag-id>/value
Content-Type: application/json

{ "value": "25.7" }

或参考 高级 — REST API 页面的"写入数值"章节。

数值进入后，将在下一个采集周期显示到画面上，并与普通 PLC 一样通过 MQTT / Sparkplug 等方式发送出去。

常见用例​

用例做法
MES 推送批次名称创建 recipe.name 之类的标签，数据格式设为 String
采集条码扫描器结果barcode.last、String
中继外部 PLC（无法连接的 PLC）的数值由对方系统发送已预先转换好的数值
发送外部分析结果quality.score、Float

电机感知 (Motor Sense)​

用于获取 KOPENS 电机感知解决方案数据的专用模式。

与普通 PLC 的区别​

项目普通 PLC电机感知
画面显示标签表格按资产（Asset）显示卡片（HEALTH INDEX / SIGNAL）
标签注册用户逐个输入自动生成（signals + health_index）
刷新周期画面 5 秒1 秒后台刷新
数据格式自由JSON 数组（多台资产打包）

注册表单输入项​

输入栏填写内容
API KEYKOPENS 签发的 API 密钥
客户 IDKOPENS 签发的客户标识符
资产列表 URL资产列表查询 URL
资产信号 URL资产信号数据 URL
资产状态指数 URL资产状态（健康指数）URL
波形/频谱加载是否一并接收较大的波形数据

URL 必须以 http:// 或 https:// 开头。

自动生成的标签​

网关会自动生成两个标签。

标签名称含义
signals各资产的振动 / 温度 / 电压等信号集合（JSON 数组）
health_index各资产的健康指数（不平衡 / 对中 / 轴承等，JSON 数组）

各资产的数据以卡片形式展开显示。

常见问题与解决​

HTTP 推送模式​

现象原因解决
数值未进入外部系统未推送，或标签 ID 拼写有误检查外部系统日志。确认 POST /api/v1/tag/.../value 是否返回 200 OK
数值刷新延迟采集周期过长缩短 PLC 注册中的 [采集周期]（例如 500ms）

电机感知模式​

现象原因解决
提示"drive 不在 classpath 中"未安装电机感知专用 jar请系统管理员安装电机感知 jar
401 UnauthorizedAPI KEY / 客户 ID 错误准确核对 KOPENS 签发的密钥
URL 被拒绝未以 http:// 或 https:// 开头检查 URL 格式

更详细的示例 / 自动化注册​

请参考 高级 — REST API 中的 HTTP / 电机感知示例。