添加设备
| 功能说明 | 添加设备 | | ------------ | ------------ | | URL 地址 | https://cloudapi.usr.cn/usrCloud/dev/addDevice | | HTTPS 请求方式 | POST | 参数说明: | 参数英文名 | 参数中文名 | 是否必须 | 备注 | | ------------ | ------------ | ------------ | ------------ | | token | token | true |登录成功时返回的 token | |subAccount | 所属用户 | false | 设备的所属用户,用于一级账号给二级账号添加设备,不填写默认为当前登录账号 | |deviceId | 设备编号 |false | 普通设备:最长12位,系统会自动补全至20位。 | | name | 设备名称 | true | | | groupId | 设备分组 | false | | | pass | 通讯密码 |flase | 必须为 8 位 (不填写默认用账号默认的设备通讯密码) | | hardver | 硬件版本 |false | | | softver |软件版本 | false | | | img | 图片地址 | false | | | groupId | 分组id | false | 默认为 0 | | length | 合包长度 | false | | | customFields | 自定义地段 | false | | | position | 地图位置(经纬度) | true | | | address | 地图位置(详细地址) | true | | | sn | SN | | 设备校验码 | | protocol | 通讯协议 | |0:ModbusRTU<br/> 1:ModbusTCP<br/> 2:TCP透传<br/>3:DL/T645-97<br/> 4:DL/T645-07 <br/> 5:烟感协议| | pollingInterval | 采集频率 | | 当设备通讯协议为数据透传时不填写 主动上传为-1 | |type | 设备类型 | true | 设备类型:<br/>0:默认设备<br/> 1:LoRa集中器 <br/> 2:CoAP/NB-IoT<br/> 3 :LoRa模块<br/> 4:网络io<br/> 5:扫码添加 <br/> 6:LoRaWAN <br/> 7.电信 CoAP/NB-IoT | | deviceSlaves | 设备从机集合 | flase | 当设备类型为 默认设备 / LoRa模块 / CoAP/NB-IoT 且通讯协议为 ModbusRTU/ModbusTCP 时必填;<br/>其他情况不需要填写 | |QRcode | 二维码 | flase | || 请求示例 Request Body [TOC] ------------ #####默认设备 请求示例 ```JSON 默认设备:(数据透传) { "subAccount":"test2", // 所属用户 "device":{ "deviceId":"1", // 设备id (可不填写此字段由系统自动生成) "pass":"12345678", // 通讯密码 (可不填写此字段使用用户默认通讯密码) "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"0", // 设备类型 "img":"", // 图片地址 "protocol":"2",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` ```JSON 默认设备(ModbusRtu、DL/T645-97、DL/T645-07): { "subAccount":"test2",// 所属用户 "device":{ "deviceId":"1", // 设备id (可不填写此字段由系统自动生成) "pass":"12345678", // 通讯密码 (可不填写此字段使用用户默认通讯密码) "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"0",// 设备类型 "img":"",// 图片地址 "pollingInterval":300,// 轮询时间,单位为秒 "protocol":"0",// 通讯协议 "position":"117.02496707,36.68278473",//地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "deviceSlaves": // 从机信息 [ { "slaveIndex":1, // 从机序号 同一设备下不重复 "slaveName":"从机名称", // 从机名称 "slaveAddr":"1", // 从机地址 同一设备下不能重复 "dataTemplateId":1493 // 模板id } ], "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` #####LoRaWAN模块 请求示例 ```JSON LoRaWAN 模块(数据透传): { "subAccount":"test2", // 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+devEUI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"6", // 设备类型 "img":"", // 图片地址 "protocol":"2",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` ```JSON LoRaWAN 模块(ModbusRtu): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+devEUI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"6", // 设备类型 "img":"", // 图片地址 "protocol":"0",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "deviceSlaves": // 从机信息 [ { "slaveIndex":1, // 从机序号 同一设备下不重复 "slaveName":"从机名称", // 从机名称 "slaveAddr":"1", // 从机地址 同一设备下不能重复 "dataTemplateId":1493 // 模板id } ], "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` #####网络IO设备 请求示例 ```JSON 网络IO设备: { "subAccount":"test2",// 所属用户 "device":{ "type":5, // 设备类型 "QRcode":"deviceId:xxxxxxx,sn:xxxxxx" // 二维码 组成规则 ‘deviceId:’+MAC/IMEI+‘,sn:’+校验码 }, "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` #####网络io(手动输入参数) 请求示例 ```JSON 网络io(手动输入参数) {"subAccount":"toobug", "device":{ "type":5, "QRcode":"deviceId:xxxxxx,sn:xxxxxx", "protocol":0, "name":"12345678", "pass":"12345678", "pollingInterval":500 }, "token":"eyJhbGci.eyJzdWIiOiJ0b29idWciLCJ1aWQiOjg.OcXT0pQx351lQk....", "deviceSlaves":[ {"slaveIndex":1, "slaveName":"1", "slaveAddr":"1", "dataTemplateId":2920 }] } ``` #####二维码添加 请求示例 ```JSON 二维码添加: { "subAccount":"test2",// 所属用户 "device":{ "type":5, // 设备类型 "QRcode":"deviceId:xxxxxxx,verifyCode:xxxxxx" // 二维码 扫到的数据 }, "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` #####LoRa模块 请求示例 ```JSON LoRa模块(数据透传): { "subAccount":"test2", // 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+ID+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"3", // 设备类型 "img":"", // 图片地址 "protocol":"2",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` ```JSON LoRa模块(烟感协议): { "subAccount":"test2", // 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+ID+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"3", // 设备类型 "img":"", // 图片地址 "protocol":"5",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` #####LoRa集中器 请求示例 ```JSON LoRa集中器: { "subAccount":"test2", // 所属用户 "device":{ "deviceId":"deviceId:xxxxxxx,sn:xxxxxxx", // 设备id "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"1", // 设备类型 "img":"", // 图片地址 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` #####CoAP/NB-IoT 请求示例 ```JSON CoAP/NB-IoT(数据透传): { "subAccount":"test2", // 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"2", // 设备类型 "img":"", // 图片地址 "protocol":"2",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` ```JSON CoAP/NB-IoT(ModbusRtu): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"2", // 设备类型 "img":"", // 图片地址 "protocol":"0",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "deviceSlaves": // 从机信息 [ { "slaveIndex":1, // 从机序号 同一设备下不重复 "slaveName":"从机名称", // 从机名称 "slaveAddr":"1", // 从机地址 同一设备下不能重复 "dataTemplateId":1493 // 模板id } ], "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` ```JSON CoAP/NB-IoT(烟感协议): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"2", // 设备类型 "img":"", // 图片地址 "protocol":"5",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` #####电信CoAP/NB-IoT 请求示例 ```JSON 电信CoAP/NB-IoT(数据透传): { "subAccount":"test2", // 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"7", // 设备类型 "img":"", // 图片地址 "protocol":"2",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` ```JSON 电信CoAP/NB-IoT(ModbusRtu): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"7", // 设备类型 "img":"", // 图片地址 "protocol":"0",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "deviceSlaves": // 从机信息 [ { "slaveIndex":1, // 从机序号 同一设备下不重复 "slaveName":"从机名称", // 从机名称 "slaveAddr":"1", // 从机地址 同一设备下不能重复 "dataTemplateId":1493 // 模板id } ], "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` ```JSON 电信CoAP/NB-IoT(烟感协议): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"7", // 设备类型 "img":"", // 图片地址 "protocol":"5",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` #####华为CoAP/NB-IoT 请求示例 ```JSON 电信CoAP/NB-IoT(数据透传): { "subAccount":"test2", // 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"8", // 设备类型 "img":"", // 图片地址 "protocol":"2",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhI1NiJ9.eyJzdWIiOiJ04NTIyOD.QUrLJniFlkBpN-JRNsVjyPVPT..." } ``` ```JSON 电信CoAP/NB-IoT(ModbusRtu): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"8", // 设备类型 "img":"", // 图片地址 "protocol":"0",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "deviceSlaves": // 从机信息 [ { "slaveIndex":1, // 从机序号 同一设备下不重复 "slaveName":"从机名称", // 从机名称 "slaveAddr":"1", // 从机地址 同一设备下不能重复 "dataTemplateId":1493 // 模板id } ], "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ``` ```JSON 电信CoAP/NB-IoT(烟感协议): { "subAccount":"test2",// 所属用户 "device":{ "QRcode":"deviceId:xxxxxxx,sn:xxxxxxx", // 二维码 组成规则 ‘deviceId:’+IMEI+‘,sn:’+校验码 "groupId":"0", // 设备分组 "name":"设备名称", // 设备名称 "type":"8", // 设备类型 "img":"", // 图片地址 "protocol":"5",// 通讯协议 "position":"117.02496707,36.68278473", //地图位置(经纬度) "address":"山东省济南市历下区" // 地图位置(详细地址) }, "token":"eyJhbGciOiJI.V4cCI6MTUyMjgyMDI0MSw.uWqKvFJ8jR..." } ```