TCPServer模式(设备作为服务器)
⚠️
TCPServer模式，仅在测试和内网环境下使用。
设备当作TCP服务器，可连接数量有限，最大可连接4个客户端。
获取设备信息
客户端发送：
{
"messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
"param": {
"type": "info"
}
}| 字段 | 类型 | 长度 | 备注 |
|---|---|---|---|
| messageid | String | 32 | 消息ID(用于标识消息，服务器返回时按照发送消息原样返回) |
| code | String | 32 | 消息类型(info:获取设备信息) |
服务端(设备)回传信息
指令正常设备返回：
{
"messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
"code": 200,
"type": "ST200THPE",
"data": {
"temperature": 26.95,
"humidity": 49.78,
"pressure": 948.38,
"altitude": 554.68
},
"compensate": {
"t_compensate": 0,
"h_compensate": 0,
"p_compensate": 0
},
"set": {
"mqtt_timed_report": 0,
"mqtt_interval_time": 5,
"tcp_timed_report": 0,
"tcp_interval_time": 5,
"http_timed_report": 1,
"http_interval_time": 5
},
"net": {
"connmethed": "eth",
"ssid": "---",
"dhcp": 1,
"ip": "192.168.31.213"
},
"sys": {
"version": "HW:1.0.0_SDK:2.0.0",
"runtime": 90,
"eth_mac": "E8:6B:EA:C2:32:8F",
"sta_mac": "E8:6B:EA:C2:32:8C"
},
"protocol": {
"mqtt": 1,
"http": 1,
"tcpserver": 0,
"tcpclient": 0
}
}| 字段 | 类型 | 长度 | 备注 |
|---|---|---|---|
| messageid | String | 32 | 消息ID (用于标识消息，服务器返回时按照发送消息原样返回，保证收发一致性) |
| code | Int | 8 | 状态码 (200:成功) |
| type | String | 8 | 设备类型 |
| temperature | Float | 8 | 温度 (单位:摄氏度) |
| humidity | Float | 8 | 湿度 (单位:%) |
| pressure | Float | 8 | 气压 (单位:hPa) |
| altitude | Float | 8 | 海拔 (单位:米) |
| connmethed | String | 8 | 网络连接方式 (eth:以太网，wifi:无线) |
| t_compensate | Float | 8 | 温度补偿 (单位:摄氏度) [范围-20至+20] |
| h_compensate | Float | 8 | 湿度补偿 (单位:%) [范围-20至+20] |
| p_compensate | Float | 8 | 气压补偿 (单位:hPa) [范围-500至+500] |
| ssid | String | 8 | 无线SSID名称 |
| dhcp | Int | 8 | 是否DHCP (1:启用，0:静态) |
| ip | String | 16 | 设备IP |
| eth_mac | String | 24 | 以太网MAC地址 |
| sta_mac | String | 24 | WIFI MAC地址 |
| version | String | 24 | 固件版本 |
| runtime | Int | 8 | 设备运行的时间 (单位:秒) |
| protocol | Int | 8 | 各类协议是否启用 (1:启用，0:未启用) |
| mqtt_timed_report | Int | 8 | MQTT定时上报 (1:启用，0:未启用) |
| mqtt_interval_time | Float | 8 | MQTT定时上报间隔时间 (单位:秒) |
| tcp_timed_report | Int | 8 | TCP定时上报 (1:启用，0:未启用) |
| tcp_interval_time | Float | 8 | TCP定时上报间隔时间 (单位:秒) |
| http_timed_report | Int | 8 | HTTP定时上报 (1:启用，0:未启用) |
| http_interval_time | Float | 8 | HTTP定时上报间隔时间 (单位:秒) |
指令异常设备返回：
{
"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"
}
}| 字段 | 类型 | 长度 | 备注 |
|---|---|---|---|
| messageid | String | 32 | 消息ID(用于标识消息，服务器返回时按照发送消息原样返回) |
| code | String | 32 | 消息类型(ota:升级) |
| uri | String | 128 | 升级文件下载地址 |
TCPCLIENT模式(设备作为客户端)
获取设备信息
服务端发送：
{
"messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
"param": {
"type": "info"
}
}| 字段 | 类型 | 长度 | 备注 |
|---|---|---|---|
| messageid | String | 32 | 消息ID(用于标识消息，服务器返回时按照发送消息原样返回) |
| code | String | 32 | 消息类型(info:获取设备信息) |
客户端(设备)回传信息
指令正常设备返回：
{
"messageid": "3FBD8A5D-9824-D355-EF7A-B31A609522CC",
"code": 200,
"type": "ST200THPE",
"data": {
"temperature": 26.95,
"humidity": 49.78,
"pressure": 948.38,
"altitude": 554.68
},
"compensate": {
"t_compensate": 0,
"h_compensate": 0,
"p_compensate": 0
},
"set": {
"mqtt_timed_report": 0,
"mqtt_interval_time": 5,
"tcp_timed_report": 0,
"tcp_interval_time": 5,
"http_timed_report": 1,
"http_interval_time": 5
},
"net": {
"connmethed": "eth",
"ssid": "---",
"dhcp": 1,
"ip": "192.168.31.213"
},
"sys": {
"version": "HW:1.0.0_SDK:2.0.0",
"runtime": 90,
"eth_mac": "E8:6B:EA:C2:32:8F",
"sta_mac": "E8:6B:EA:C2:32:8C"
},
"protocol": {
"mqtt": 1,
"http": 1,
"tcpserver": 0,
"tcpclient": 0
}
}| 字段 | 类型 | 长度 | 备注 |
|---|---|---|---|
| messageid | String | 32 | 消息ID (用于标识消息，服务器返回时按照发送消息原样返回，保证收发一致性) |
| code | Int | 8 | 状态码 (200:成功) |
| type | String | 8 | 设备类型 |
| temperature | Float | 8 | 温度 (单位:摄氏度) |
| humidity | Float | 8 | 湿度 (单位:%) |
| pressure | Float | 8 | 气压 (单位:hPa) |
| altitude | Float | 8 | 海拔 (单位:米) |
| connmethed | String | 8 | 网络连接方式 (eth:以太网，wifi:无线) |
| t_compensate | Float | 8 | 温度补偿 (单位:摄氏度) [范围-20至+20] |
| h_compensate | Float | 8 | 湿度补偿 (单位:%) [范围-20至+20] |
| p_compensate | Float | 8 | 气压补偿 (单位:hPa) [范围-500至+500] |
| ssid | String | 8 | 无线SSID名称 |
| dhcp | Int | 8 | 是否DHCP (1:启用，0:静态) |
| ip | String | 16 | 设备IP |
| eth_mac | String | 24 | 以太网MAC地址 |
| sta_mac | String | 24 | WIFI MAC地址 |
| version | String | 24 | 固件版本 |
| runtime | Int | 8 | 设备运行的时间 (单位:秒) |
| protocol | Int | 8 | 各类协议是否启用 (1:启用，0:未启用) |
| mqtt_timed_report | Int | 8 | MQTT定时上报 (1:启用，0:未启用) |
| mqtt_interval_time | Float | 8 | MQTT定时上报间隔时间 (单位:秒) |
| tcp_timed_report | Int | 8 | TCP定时上报 (1:启用，0:未启用) |
| tcp_interval_time | Float | 8 | TCP定时上报间隔时间 (单位:秒) |
| http_timed_report | Int | 8 | HTTP定时上报 (1:启用，0:未启用) |
| http_interval_time | Float | 8 | HTTP定时上报间隔时间 (单位:秒) |
指令异常设备返回：
{
"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"
}
}| 字段 | 类型 | 长度 | 备注 |
|---|---|---|---|
| messageid | String | 32 | 消息ID(用于标识消息，服务器返回时按照发送消息原样返回) |
| code | String | 32 | 消息类型(ota:升级) |
| uri | String | 128 | 升级文件下载地址 |