智源云盾边缘网关EDGE GATEWAY

Developer Hub

开发者技术对接

MQTT / Modbus-RTU / Modbus-TCP 协议集成文档。网关原生支持标准物联网协议,对接只需配置 Broker 地址和认证信息,无需写网关侧代码。

平台对接架构

网关采集 PLC / 传感器 / 仪表数据 → MQTT 上报智源云盾平台 → 平台 AI 分析 & 告警 & 报表

智源云盾 SaaS

Brokermqtts://mqtt.zhiyuanyundun.com:8883
认证X.509 证书 + Access Token 双向认证

推荐国内工厂使用,自动开通,按设备数计费

本地一体化部署

Brokermqtt://{客户内网IP}:1883
认证用户名 / 密码

适用于内网隔离场景,数据不出厂区,支持 docker compose 一键部署

私有化定制

Broker视部署环境而定
认证自定义认证方案

适用于大型集团、跨国项目,支持 Kubernetes 集群部署

MQTT Topic 定义

所有数据交互通过标准 MQTT 3.1.1 / 5.0 协议完成,下表为核心 Topic 清单。

Topic说明
v1/gateway/{gatewayId}/telemetry温度、振动、压力、电流等传感器原始数据,JSON key-value 格式
v1/gateway/{gatewayId}/attributes设备型号、固件版本、运行状态等属性变更时上报
v1/gateway/{gatewayId}/rpc/request平台向网关下发远程重启、配置更新、固件升级等指令
v1/gateway/{gatewayId}/rpc/response网关执行 RPC 指令后返回结果
v1/gateway/{gatewayId}/event/alarm设备异常、通信中断、阈值越限等告警事件实时推送

遥测数据 JSON 格式

网关按配置间隔上报,ts 为毫秒级 Unix 时间戳,values 内 key 为自定义点位名称。

{
  "ts": 1697452800000,
  "values": {
    "temperature": 37.2,
    "vibration_x": 0.12,
    "vibration_y": 0.08,
    "vibration_z": 0.15,
    "current_a": 14.8,
    "pressure_mpa": 0.73,
    "running_hours": 15230
  }
}

Modbus-RTU 配置参数

在网关 Web 管理界面(端口 10080)导入此 JSON 即可完成 Modbus 设备接入。

// Modbus-RTU 配置示例(网关 web 管理界面 JSON)
{
  "channel": 1,
  "mode": "rtu",
  "baudrate": 9600,
  "parity": "N",
  "dataBits": 8,
  "stopBits": 1,
  "slaveId": 1,
  "registers": [
    {
      "name": "temperature",
      "address": 40001,
      "type": "holding",
      "dataType": "float",
      "unit": "°C",
      "interval": 5000
    },
    {
      "name": "current",
      "address": 40003,
      "type": "holding",
      "dataType": "float",
      "unit": "A",
      "interval": 5000
    }
  ]
}

技术 FAQ

网关如何对接智源云盾平台?

网关原生支持 MQTT 协议,在 web 管理界面配置平台 MQTT Broker 地址和认证信息即可。清单内所有网关均预置 MQTT 客户端,无需额外开发网关侧代码。工程师可远程协助调试。

Modbus 设备数据格式如何转成平台能识别的 JSON?

网关内置协议转换引擎,在管理界面配置 Modbus 寄存器地址、数据类型和上报间隔后,网关自动轮询设备、完成二进制↔JSON 转换并上报到平台,无需编写转换脚本。

支持哪些认证方式?

SaaS 版支持 X.509 证书 + Access Token 双向认证;本地部署版支持用户名/密码;私有化部署可按需定制 Token、OAuth2.0 等认证方案。

海外节点延迟大怎么办?

智源云盾在东南亚(新加坡)、欧洲(法兰克福)已部署 MQTT Broker 节点,网关可指定就近接入。海外项目建议在选型时备注区域,工程师会推荐对应节点。

有示例代码或 SDK 吗?

平台提供 REST API 和 Webhook 接口文档,预留邮箱后可获取 Python / Node.js 调用示例。网关侧无需写代码,平台侧 REST API 支持任意语言调用。

海外合规与信任

与海外中转站/代理商最大差异:我们提供公司主体背书和合规文档,不是"个人代购"。

🏢 公司主体

国内主体可签正式供货合同;海外子公司可出具英文 Invoice 和商业发票,支持对公银行转账。

🛡️ 数据处理合规

海外 SaaS 数据存储于新加坡 / 法兰克福节点,符合 GDPR 数据本地化要求,可签署 DPA(数据处理协议)。

🔐 数据不离开内网

选择本地一体化部署版,所有设备数据完全不离开客户内网 / VPC,无需额外合规成本,适合银行、能源等强监管行业。

📄 等保与认证

国内 SaaS 通过等保二级认证;网关硬件通过 CE、FCC 认证,可出具英文版合规声明供海外项目投标使用。

🌍 海外交付能力

支持国际物流发货(DHL/FedEx),英文技术文档与远程调试支持,东南亚/欧洲/中东已有落地案例。

💰 透明报价

报价单分列硬件、云订阅、实施费、传感器四项,无隐藏费用。英文 Invoice 可直接用于企业采购流程。

需要定制开发或私有化部署?

适合有自定义协议、私有化部署、SaaS 集成等需求的开发团队。预留联系方式后,技术工程师 2 小时内对接, 提供完整 API 文档和示例代码。

  • REST API 完整文档(Python / Node.js 示例)
  • Webhook 回调接入指南
  • 私有化部署 Kubernetes Helm Chart
  • 海外节点延迟测试工具

申请技术对接

填写公司名称与联系方式,技术团队 2 小时内联系。

相关文档与资源