UDP通讯协议

设备通过UDP端口上传数据,对其他设备发送指令。

一、通讯地址

通讯方式:UDP

地址:www.bigiot.net(或IP:121.42.180.30)

端口:9090

二、格式

Json字符串
形如:{"M":"checkin"}

注:UDP以数据包形式发送,字符串末尾无需换行符。

三、命令列表

1、上传实时数据

{"M":"update","ID":"xx1","V":{"id1":"value1",...},"K":"xx2"}

说明:此命令无返回信息,两次发送间隔不得小于4s,无需登录可随时发送

M —— 固定(Method)
update —— 固定,实时更新数据指令
ID —— 固定
xx1 —— 可变,设备ID,在会员中心查看
V —— 固定(Value)
    id1 —— 可变,数据接口ID,在会员中心查看
    value1 —— 可变(数值型),本地数据(譬如:传感器测量数据)
    ... —— 可以更新该设备下多个数据接口的数据

K ——固定(apiKey)

xx2——可变,设备apiKey,在会员中心查看

2、对用户或设备发送指令

{"M":"say","ID":"xx1","toID":"xx2","C":"xx3","SIGN":"xx4","K":"xx5"}

说明:此命令用于向指定设备或用户发送命令,命令内容可自定义,接收目标必须处于在线状态才能收到该指令,接收端收到的指令格式通同CP协议。

M —— 固定(Method)
say —— 固定,沟通指令

ID —— 固定
xx1 —— 可变,设备ID,在会员中心查看

toID —— 固定

xx2 —— 可变,发送目标的唯一通讯ID,其组成为字符“D"+设备ID、”U“+用户ID、”G“+游客ID,如D24、U23,当xx1为“ALL”时,将向该用户及其名下所有设备发送该消息

C —— 固定(content)

xx3 —— 可变(数据类型自定,符合Json字符串要求即可),发送指令内容

SIGN —— 固定(可选)

xx4 —— 可变(可选),自定义字符串,可用于对指令的签名标识

K ——固定(apiKey)

xx5——可变,设备apiKey,在会员中心查看

3、重载设备设置信息

{"M":"reload","ID":"xx1","K":"xx2"}

说明:在用户修改设备的apikey、数据保存频率、报警条件等设置时,需进行重载操作,相当于TCP连接状态时的重启设备。

M —— 固定(Method)
say —— 固定,沟通指令

ID —— 固定
xx1 —— 可变,设备ID,在会员中心查看

K ——固定(apiKey)

xx2——可变,设备apiKey,在会员中心查看


4、PC端模拟测试

linux下nc指令测试,向指定用户发送命令如下:

udp.jpg

用户接收到信息如下:

udp_rev.JPG


上一篇:图片接口协议(https)
下一篇:设备加密登录说明
返回顶部