WS1型号设备接口 十一月 6, 2017

概述

对于设备进行操作建议使用配套Micro-USB数据线。先将设备关机,然后插入数据线。

请确认先打开串口,并采用以下串口设置参数:

  • 波特率:115200,数据位:8,检验位:无,停止位:1
  • 发送数据格式:字符串,接收数据格式:字符串。

设备支持大部分串口调试工具及SDK,您也可以从此处下载我司提供的串口调试工具。


以下为设备相关信息读取操作接口


读取设备固件信息

请求数据:

{"command": "ReadProduct"}

成功返回如下:

{"ProductID":"ubibot-ws1-cn","SeriesNumber":"XXXXXX","Host":"api.ubibot.cn","CHANNEL_ID":"XX","USER_ID":"XXX-XXXX","USAGE":"0%","firmware":"ws1_v1.6_17_10_18","backup_ip":"xxx.xxx.xxx.xxx"}

读取设备Wi-Fi配置信息

请求数据:

{"command": "ReadWifi"}

成功返回如下:

{"SSID":"XXXXXX","password":"XXXXXX","type":"WPA"}

读取设备参数配置

请求数据:

{"command": "ReadMetaData"}
成功返回如下:

{"fn_th":120,"fn_light":60,"fn_mag":86400,"fn_mag_int":2,"fn_acc_tap1":0,"fn_acc_tap2":0,"fn_acc_act":0,"fn_acc_min":90,"fn_bt":300,"fn_ext":600,"fn_battery":36
00,"fn_dp":600,"cg_data_led":1}

读取设备内部存储的感知数据

请求数据:
{"command": "ReadData"}

成功返回如下:

 {"created_at":"2015-12-17T18:16:22Z","field1":0}……

读取设备最近错误代码

请求数据:

{"command": "GetLastError"}

扫描设备周围Wi-Fi网络信息

请求数据:

{"command": "ScanWifiList"}

成功返回如下:

{"WiFi_List_Sum":%d }\n\r
{"SSID":"%s","rssi":%d,"type":%d}\n\r

设备自检测试(用于调试检测设备内部元器件功能情况)

请求数据:

{"command": "CheckSensors"}

成功返回如下:

{"created_at":"2017-05-12T04:41:10Z","temp_val":32.132446,"humi_val":17,"light_val":767.359985,"power_vol_val":4.524133,"ssid":"m_work-GN","rssi":-37,"acce_xval":0,"acce_yval":0,"acce_zval":0,"mag_val":1,"ext_temp_val":65535}

以下为设备相关信息更改操作接口


 清空设备内部存储的感知数据(过程将持续超过30秒)

请求数据:

{"command": "ClearData"}

更改设备参数配置

请求数据:(其中”metadata”部分为设备设置进行JSON转译)

{"command":"SetMetaData","metadata":"{\"fn_th\":60,\"fn_light\":60,\"fn_mag\":120,\"fn_mag_int\":2,\"fn_acc_tap1\":0,\"fn_acc_tap2\":0,\"fn_acc_act\":0,\"fn_acc_min\":5,\"fn_bt\":120,\"fn_ext_t\":1480041854,\"fn_battery\":120,\"fn_dp\":120,\"cg_data_led\":\"on\"}"}

成功返回如下:

{\"status\":0,\"code\": 0x00}

设定设备Wi-Fi接入点配置

请求数据:(其中type值为Wi-Fi加密协议,支持WPA,WEP,OPEN三种方式;backup_ip为API域名解析失败后所采用的备用IP地址)
{"command": "SetupWifi",”SSID”: "XXXXX",”password”: "XXXXX","backup_ip":"101.201.30.5"}
成功返回如下:<

{\"status\":0,\"code\": 0x00}

更改设备参数配置

若您需要将设备配置直接连接到您私有化的服务器或平台,请与我们销售人员联系获取相关信息。