MQTT协议接入

搭建MQTT服务器(以EMQX为例)[如有MQTT服务器可忽略]

MQTT教程及快速入门： https://www.emqx.com/zh/mqtt-guide

EMQX下载： https://www.emqx.com/zh/try?product=broker

MQTTX客户端工具下载： https://www.emqx.com/zh/products/mqttx

获取设备信息

向设备订阅主题发送：

{
        "messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
        "param": {
            "type": "info"
        }
}

获取设备信息
字段	类型	长度	备注
messageid	String	32	消息ID(用于标识消息，服务器返回时按照发送消息原样返回)
type	String	32	消息类型(info:获取设备信息)

设备回传信息

指令正常设备向服务器返回：

{
    "messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
    "code": 200,
    "type": "ST200THPE",
    "data": {
            "temp": 20.79,
            "humidity": 34.16,
            "pressure": 97274.14,
            "altitude": 342.85
    },
    "net": {
            "connmethed": "eth",
            "ssid": "---",
            "dhcp": 1,
            "ip": "192.168.31.49"
    },
    "sys": {
            "version": "1.0.1-release",
            "runtime": 216,
            "eth_mac": "E8:6B:EA:C2:10:5F",
            "sta_mac": "E8:6B:EA:C2:10:5C"
    },
    "protocol": {
            "mqtt": 1,
            "http": 0,
            "tcpserver": 0,
            "tcpclient": 1,
            "udpserver": 0,
            "udpclient": 0
    }
}

设备回传信息
字段	类型	长度	备注
messageid	String	32	消息ID(用于标识消息，服务器返回时按照发送消息原样返回)
code	Int	8	状态码(200:成功)
temp	Float	8	温度(单位:摄氏度)
humidity	Float	8	湿度(单位:%)
pressure	Float	8	气压(单位:hPa)
altitude	Float	8	海拔(单位:米)
connmethed	String	8	网络连接方式(eth:以太网，wifi:无线)
ssid	String	32	无线SSID名称
humidity	Float	8	湿度(单位:%)
dhcp	Int	8	是否DHCP(1:启用，0:静态)
ip	String	16	设备IP
mac	String	24	设备MAC(使用以太网即以太网MAC，使用无线即无线MAC)
version	String	24	固件版本
runtime	Int	8	设备运行的时间 (单位:秒)
protocol	Int	8	各类协议是否启用(1:启用，0:未启用)

备注

WIFI和以太网只能选用一种。

指令异常设备向服务器返回：

{
    "messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
    "code": 204,
    "msg": "type not found"
}

异常返回
字段	类型	长度	备注
messageid	String	32	消息ID(用于标识消息，服务器返回时按照发送消息原样返回)
code	Int	8	状态码(204:失败)
msg	String	32	错误信息

OTA升级

向设备订阅主题发送：

{
    "id": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
    "param": {
            "type": "ota",
            "uri": "http://10.0.0.50/idf/module_v1.bin"
    }
}

OAT升级
字段	类型	长度	备注
messageid	String	32	消息ID(用于标识消息，服务器返回时按照发送消息原样返回)
type	String	32	消息类型(ota:升级)
uri	String	128	升级文件下载地址