目录 [TOC] ## 一、搭建MQTT服务器并测试连接 搭建MQTT Broker服务器，可参考以下两种开源软件的官方资料进行搭建，本文档不做描述。 1. EMQ X Broker 是基于高并发的 Erlang/OTP 语言平台开发，支持百万级连接和分布式集群架构，发布订阅模式的开源 MQTT 消息服务器，EMQ X Broker支持开源免费使用。 EMQ官网：[https://www.emqx.io/cn/](https://www.emqx.io/cn/) 2. Mosquitto是一款实现了消息推送协议MQTT 5.0, 3.1.1 和 3.1.的开源消息代理软件，提供轻量级的、支持可订阅/可发布的消息推送模式，是设备与设备之间的短消息通信变得简单，从低功耗嵌入式到大规模服务器都可适用。 Mosquitto官网：[http://mosquitto.org/](http://mosquitto.org/) 请使用MQTT客户端连接测试连接，如mqtt.fx、MQTTBox、MQTTX等 ## 二、智能网关配置 >[warning] 请确保网关**固件版本为1.0.18及以上**，EdgeLink服务为最新版本 > 本地或远程进入网关管理页面，左侧菜单选择`第三方云接入`，`云平台名称`选择`自建MQTT服务器`，然后根据服务端设置，配置服务器连接方式；  接入自建MQTT服务器支持两种连接方式：基本的mqtt/tcp直连，和mqtt/tls 加密连接。 >[warning] 建议用户使用mqtt/tls加密方式连接，更安全。 mqtt/tls加密连接支持三种认证方式： 1. CA Signed Server Certificate 2. CA Certificate Only，该方式需要上传CA证书 3. Self Signed Certificates，该方式需要上传CA证书，客户端证书，客户端秘钥 ## 三、配置网关数据采集 >[danger] 第三方平台数据上传功能依赖于网关数据采集功能，请在网关管理页面设置串口模式为**采集模式**。 配置网关或EdgeLink的采集通道、设备、及设备点表。 参考文档及相关案例：[智能网关与电脑主机驱动列表](../Drivers.md) ## 四、订阅数据及发布数据 使用任意一款MQTT客户端软件连接MQTT服务器。 订阅主题：`BOX/+/event/property/post/+`，会收到网关发布的json格式的数据 数据下发主题：`BOX/${deviceId}/event/property/setResult/${nDeviceId}` 西门子：`BOX/${deviceid}/event/ppi/set/${nDeviceId}` 三菱 ： `BOX/${deviceid}/event/fx/set/${nDeviceId}` 台达 ：`BOX/${deviceid}/event/aelta/set/${nDeviceId}` 信捷 : ` BOX/${deviceid}/event/xinje/set/${nDeviceId}` 永宏 ：`BOX/${deviceid}/event/fatek/set/${nDeviceId}` Modbus: `BOX/${deviceId}/event/property/set/${nDeviceId}` 数据上报主题： 西门子：`BOX/${deviceid}/event/property/post/ppi/{nDeviceId}` 三菱 ：`BOX/${deviceid}/event/property/post/fx/{nDeviceId}` 台达 ：`BOX/${deviceid}/event/aelta/setResult/${nDeviceId}` 信捷 : `BOX/${deviceid}/event/property/post/xinje/{nDeviceId}` 永宏 ：`BOX/${deviceid}/event/fatek/setResult/${nDeviceId}` Modbus: `BOX/${deviceId}/event/property/post/${nDeviceId}` 数据下发结果： 西门子：`BOX/${deviceid}/event/ppi/setResult/${nDeviceId}` 三菱 ：`BOX/${deviceid}/event/fx/setResult/${nDeviceId}` 台达 ：`BOX/${deviceid}/event/aelta/setResult/${nDeviceId}` 信捷 : `BOX/${deviceid}/event/xinje/setResult/${nDeviceId}` 永宏 ：`BOX/${deviceid}/event/fatek/setResult/${nDeviceId}` Modbus: `BOX/${deviceId}/event/property/setResult/${nDeviceId}` | 参数 | 说明 | | --- | --- | | deviceid | 网关ID，[获取网关ID和设备ID](getID.md) | | nDeviceId | 设备ID，[获取网关ID和设备ID](getID.md) | >[warning] 网关采集数据上报主题和设备数据下发主题，请参照该文档： [MQTT客户端接入创恒云平台](mqtt-truhigh-cloud.md) >[danger] 主题格式不允许更改