Get desktop application:
View/edit binary Protocol Buffers messages
创建分组
获取分组信息列表
分组可以属于某个区域下
用途 不填默认为default
用途
repeated GroupInfo listAll = 3;
获取分组信息详情
id
用途 不填默认为default
更新分组
删除分组
创建分组设备
更新分组设备
删除分组设备
用途 不填默认为default
设备交互
调用设备行为
产品id 获取产品id下的所有设备信息
设备名
产品数据模板中行为功能的标识符,由开发者自行根据设备的应用场景定义
输入参数
是否异步获取
异步选项
获取异步调用设备行为的结果
回复调用设备行为
产品id 获取产品id下的所有设备信息
设备名
调用id
输出参数 注意:此字段可能返回 null,表示取不到有效值。
返回状态
设备返回状态码
请求设备获取设备最新属性
产品id (必填)
设备名(必填)
获取的具体标识符的数据 如果不指定则获取所有属性数据,一个属性一条
设备返回状态码
返回状态
调用id
上报时间戳(毫秒时间戳)
获取到的值
请求设备获取设备最新属性
获取的具体标识符的数据 如果不指定则获取所有属性数据,一个属性一条
产品id
设备名
如果是不同的产品,则传这个字段,上面两个参数填了优先使用
控制一个区域的设备
根据区域路径控制设备
控制一个组的设备
批量设备返回结果列表
调用设备属性
产品id
设备名
属性数据, JSON格式字符串, 注意字段需要在物模型属性里定义
设备影子控制 0:自动,当设备不在线的时候设置设备影子,设备在线时直接下发给设备 1:只实时下发,不在线报错 2:如果有设备影子只修改影子,没有的也不下发 3: 只修改云端的值,不下发设备
是否异步操作 异步情况通过获取接口来获取
同步超时时间(单位:秒)
批量调用设备属性
产品id
设备名
如果是不同的产品,则传这个字段,上面两个参数填了优先使用
设备影子控制 0:自动,当设备不在线的时候设置设备影子,设备在线时直接下发给设备 1:只实时下发,不在线报错 2:如果有设备影子只修改影子,没有的也不下发
属性数据, JSON格式字符串, 注意字段需要在物模型属性里定义
是否异步操作 异步情况通过获取接口来获取
控制一个区域的设备
根据区域路径控制设备
控制一个组的设备
同步超时时间(单位:秒,不填默认3秒)
批量设备返回结果列表
获取异步调用设备属性的结果
发送消息给设备 -- 调试使用
发送的topic
发送的数据
(message has no fields)
获取网关拓扑关系
产品id
设备名
通知网关绑定子设备
提供给边缘端进行http访问
对应 mqtt topic的第一个 thing ota config 等等
操作类型 从topic中提取 物模型下就是 property属性 event事件 action行为
设备管理
鉴定是否是root账号(提供给mqtt broker)
用户名
密码
clientID
访问的ip地址
客户端证书
新增设备
更新设备
删除设备
产品id
设备名称
获取设备信息列表
分页信息 只获取一个则不填
过滤条件: 产品id
过滤条件: 产品id
过滤条件:模糊查询 设备名
过滤条件:精准查询 设备名
key tag过滤查询,非模糊查询 为tag的名,value为tag对应的值
key tag过滤查询,模糊查询 为tag的名,value为tag对应的值
过滤条件:取距离坐标点固定范围内的设备
设备定位,默认百度坐标系
区域ids
区域路径过滤
过滤条件:模糊查询 设备别名
在线状态过滤 1离线 2在线
产品品类id
产品品类id
过滤分享的设备(这里只获取分享的设备) 1: 同时获取分享的设备 2:只获取分享的设备
过滤收藏的设备(这里只获取收藏的设备) 1: 同时获取收藏的设备 2:只获取收藏的设备
通讯方式:1:其他,2:wi-fi,3:2G/3G/4G,4:5G,5:BLE,6:LoRaWAN
租户过滤
版本列表
非版本
过滤设备类型:0:全部,1:设备,2:网关,3:子设备
获取网关下子设备列表
设备分组用途 不填默认为default
模糊查询
过滤分销商的数据
额定功率:单位w/h
是否被人拥有
用户id查询
到期时间
SIM卡卡号
同时返回子设备的网关
协议查询
过滤分销商的数据
设备信息
总数(只有分页的时候会返回)
批量更新设备状态
产品id
项目区域id
分销商的数据
额定功率:单位w/h
获取设备信息详情
产品id
设备名称
同时返回子设备的网关
中绑定的token
配网token
批量绑定
产品id
设备名称
中绑定,强制解绑参数 对参数(deviceName、nonce、productID、timestamp)按字典序升序排序。 将以上参数,按参数名称 = 参数值 & 参数名称 = 参数值拼接成字符串, 如:"deviceName=xxx&nonce=2125656451&productID=xxx×tamp=1687525491"。 使用 HMAC-sha1 算法对上一步中获得的字符串进行计算,密钥取secretType 取设备的物模型密码类型的属性。 将生成的结果使用 Base64 进行编码,即可获得最终的签名串放入 signature。
采用秘钥的类型
签名
秒时间戳
hmacsha256 hmacsha1 hmacmd5(默认)
随机数
设备重置
设备信息
日志清除
设备物模型定义清除
绑定关系解绑
设备信息恢复出厂设置,包含过期时间,名称,设备配置等
将设备信息迁移到新的设备中
需要转移的设备
转移的对象
设备配置-profile,schemaAlias:profile
填id或者以下三个参数
绑定网关下子设备设备
不通知网关设备状态做了调整
是否校验设备签名
绑定网关下子设备设备
获取绑定信息的设备信息列表
获取网关下子设备列表
获取子设备绑定的网关列表
删除网关下子设备
设备计数
设备类型
在线设备数:status,设备类型: deviceType
0:全部 1:area 2:group
//统计的id列表, areaID或者groupID
更新设备物模型
新增设备
批量新增物模型,只新增没有的,已有的不处理
物模型信息
删除设备物模型
产品id 如果为空返回所有产品的信息
标识符
获取设备物模型列表
分页信息 只获取一个则不填
产品id 必填
物模型类型 1:property属性 2:event事件 3:action行为
过滤条件: 物模型标签 1:自定义 2:可选 3:必选
过滤标识符列表
标识符名字过滤
是否支持场景联动控制
功能分类: 1:普通功能 2:系统功能
用户权限操作: 1:r(只读) 3:rw(可读可写)
属性类型可用 读写类型: 1:r(只读) 2:rw(可读可写)
控制模式: 1: 可以群控,可以单控 2:只能单控
同时获取产品物模型
总数(只有分页的时候会返回)
产品id
设备ID 必填
同时获取产品物模型
物模型tsl
将设备加到多个分组中
更新设备所在分组
删除设备所在分组
设备消息
获取设备sdk调试日志
获取sdk调试日志信息
产品id
设备名
获取时间的开始
时间的结束
日志等级
分页信息 只获取一个则不填
sdk调试日志信息
总数
获取设备调试信息记录登入登出,操作
实时获取对应信息
产品id
设备名
获取时间的开始(毫秒时间戳)
时间的结束(毫秒时间戳)
分页信息
过滤操作类型 connected:上线 disconnected:下线 property:属性 event:事件 action:操作 thing:物模型提交的操作为匹配的日志
过滤主题
过滤内容
过滤请求ID
实时获取对应信息
总数
实时获取对应信息
只有管理员有权限
只有管理员有权限
只有管理员有权限
只有管理员有权限
产品品类id
产品id
设备名
获取时间的开始(毫秒时间戳)
时间的结束(毫秒时间戳)
分页信息
请求结果状态,200为成功
identify
实时获取对应信息
总数
实时获取对应信息
产品id
设备名
获取时间的开始(毫秒时间戳)
时间的结束(毫秒时间戳)
分页信息
在线状态
实时获取对应信息
总数
实时获取对应信息
只有管理员有权限
只有管理员有权限
只有管理员有权限
只有管理员有权限
产品品类id
产品id
设备名
获取时间的开始(毫秒时间戳)
时间的结束(毫秒时间戳)
分页信息
异常类型
请求结果状态,200为成功
实时获取对应信息
总数
获取设备数据信息
获取设备数据信息
获取对应日志信息
使用了聚合函数及间隔的时候无效
设备ID
产品id (必填)
获取的具体标识符的数据(必填)
获取时间的开始(毫秒时间戳)
时间的结束(毫秒时间戳)
间隔 如果这个值不为零值 则时间的开始和结束必须有效及聚合函数不应该为空
间隔单位 a (毫秒,默认), d (天), h (小时), m (分钟), n (月), s (秒), u (微秒), w (周), y (年)
聚合函数 avg:平均值 first:第一个参数 last:最后一个参数 count:总数 twa: 时间加权平均函数 参考:https://docs.taosdata.com/reference/taos-sql/function
/* FILL 语句指定某一窗口区间数据缺失的情况下的填充模式。填充模式包括以下几种: 不进行填充:NONE(默认填充模式)。 VALUE 填充:固定值填充,此时需要指定填充的数值。例如:FILL(VALUE, 1.23)。 PREV 填充:使用前一个非 NULL 值填充数据。例如:FILL(PREV)。 NULL 填充:使用 NULL 填充数据。例如:FILL(NULL)。 LINEAR 填充:根据前后距离最近的非 NULL 值做线性插值填充。例如:FILL(LINEAR)。 NEXT 填充:使用下一个非 NULL 值填充数据。例如:FILL(NEXT)。 */
填充模式 参考:https://docs.taosdata.com/reference/taos-sql/distinguished/#fill-%E5%AD%90%E5%8F%A5
时间排序 0:aes(默认,从久到近排序) 1:desc(时间从近到久排序)
切分数据,可以填写deviceName
产品品类id,通用物模型有效
获取设备数据信息
获取对应日志信息
使用了聚合函数及间隔的时候无效
产品id (必填)
设备名(不填获取产品下所有设备)
废弃
获取的具体标识符的数据(必填)
获取时间的开始(毫秒时间戳)
时间的结束(毫秒时间戳)
类型 事件类型: 信息:info 告警alert 故障:fault
获取对应日志信息
总数
获取设备影子列表
获取网关可以绑定的子设备列表
更新时间
新的ota功能实现
添加升级包
产品id
固件升级包名称
* 当前OTA升级包的版本号,仅支持英文字母、数字、半角句号(.)、短划线(-)和下划线(_)。长度限制为1~64个字符。
版本号
* OTA升级包签名方法。取值: MD5(默认):MD5签名。 SHA256:SHA256签名。
签名方法
文件描述
* OTA升级包类型。可选: 0:整包升级包,您上传的升级包文件包含完整的升级包,将推送整包升级包给设备进行升级。 1:差分升级包,您上传的升级包文件仅包含新版本升级包与之前版本的差异部分,仅推送差异部分给设备进行升级。 不传入此参数,则默认值为0。
升级包类型
是否需要验证
自定义数据
模块编码
修改升级包
固件id
固件升级包名称
文件描述
推送设备端的信息
删除升级包
升级包列表
分页
产品id
产品名称
查询升级包
创建静态升级批次
获取升级包下的升级任务批次列表
查询指定升级批次的详情
取消动态升级策略
查询指定升级批次下的设备升级作业列表
设备升级作业状态。1:待确认。 2:待推送。 3:已推送。 4:升级中。 5:升级成功 6: 升级失败. 7:已取消
设备是否在线
取消指定批次下的设备升级作业
重新升级指定批次下升级失败或升级取消的设备升级作业
app确认设备升级
产品管理
产品管理
repeated string initType =1;//thing:物模型
产品id,不填初始化所有产品
新增产品
更新产品
删除产品
产品id
获取产品信息列表
分页信息 只获取一个则不填
过滤设备类型:0:全部,1:设备,2:网关,3:子设备
过滤条件: 产品名称
过滤产品id列表
key tag过滤查询,非模糊查询 为tag的名,value为tag对应的值
协议配置查询
协议类型
传输层协议类型
场景模式 读写类型: r(只读) rw(可读可写) none(不参与场景)
场景模式 读写类型: r(只读) rw(可读可写) none(不参与场景)
产品状态 1:启用 2:禁用 3:开发中
产品状态 1:启用 2:禁用 3:开发中
通讯方式:1:其他,2:wi-fi,3:2G/3G/4G,4:5G,5:BLE,6:LoRaWAN
项目id,只获取项目下有设备的
区域下有设备的产品列表
区域路径过滤
产品品类
产品信息
总数(只有分页的时候会返回)
获取产品信息详情
产品id
更新产品配置
物模型管理
更新产品物模型
物模型信息
新增产品
物模型信息
批量新增物模型,只新增没有的,已有的不处理
物模型信息
删除产品
产品id 如果为空返回所有产品的信息
标识符
获取产品信息列表
分页信息 只获取一个则不填
产品id 必填
物模型类型 1:property属性 2:event事件 3:action行为
过滤条件: 物模型标签 1:自定义 2:可选 3:必选
过滤标识符列表
标识符名字过滤
是否支持场景联动控制
功能分类: 1:普通功能 2:系统功能
用户权限操作: 1:r(只读) 3:rw(可读可写)
属性类型可用 读写类型: 1:r(只读) 2:rw(可读可写)
控制模式: 1: 可以群控,可以单控 2:只能单控
总数(只有分页的时候会返回)
删除产品
产品id
物模型tsl
获取产品信息列表
产品id
物模型tsl
脚本管理
新增产品
更新产品
删除产品
获取产品信息列表
分页信息 只获取一个则不填
过滤名字
项目id,只获取项目下有设备的
产品信息
总数(只有分页的时候会返回)
获取产品信息详情
id
获取产品品类下的物模型列表,绑定的物模型会自动添加到该产品品类及子分类的产品中,并不支持删除
同时返回父节点的物模型
过滤标识符列表
协议列表
iThings,iThings-thingsboard,wumei,aliyun,huaweiyun,tuya
协议类型
传输协议: mqtt,tcp,udp
排除的协议包
协议详情
协议创建
协议更新
协议删除
更新服务状态,只给服务调用
iThings,iThings-thingsboard,wumei,aliyun,huaweiyun,tuya
协议列表
1:up 2:down
收到前处理1:before 2:after
状态:是否启用
协议详情
协议创建
协议更新
协议删除
1:up 2:down
收到前处理1:before 2:after
脚本内容
请求
回复
协议列表
product:1 device:2
状态:是否启用
脚本对应的ID
同时返回产品或设备信息
同时返回脚本信息
协议详情
协议创建
协议更新
协议删除
公共物模型管理
更新产品物模型
物模型信息
新增产品
物模型信息
删除产品
获取产品信息列表
分页信息 只获取一个则不填
有这个属性的产品id列表
物模型类型 1:property属性 2:event事件 3:action行为
过滤标识符列表
标识符名字过滤
过滤属于该产品品类的物模型
同时返回父节点的物模型
是否支持场景联动控制
功能分类: 1:普通功能 2:系统功能
用户权限操作: 1:r(只读) 3:rw(可读可写)
过滤区域下设备共有的物模型
区域路径过滤
过滤项目下设备共有的物模型
过滤分组下设备共有的物模型
过滤分组下设备共有的物模型
属性类型可用 读写类型: 1:r(只读) 2:rw(可读可写)
控制模式: 1: 可以群控,可以单控 2:只能单控
产品场景模式 读写类型: r(只读) rw(可读可写) none(不参与场景)
总数(只有分页的时候会返回)
用户收藏的设备
分享设备
更新权限
取消分享设备
取消分享设备
指定项目的情况下删除分享的所有设备
获取设备分享列表(只有设备的所有者才能获取)
设备信息
获取设备分享的详情
转让设备
rpc userDeviceOtaGetVersion(UserDeviceOtaGetVersionReq)returns(userDeviceOtaGetVersionResp); 创建批量分享二维码,设备列表写入缓存
扫码后获取设备列表
接受批量分享的设备
分享的对象
分享的账号(只读)
设备的日志数据
Used as request type in: DeviceMsg.abnormalLogCreate
Used as field type in:
发生时间戳(毫秒时间戳)
触发1还是解除2
异常类型
原因
服务器端事务id
Used as response type in: DeviceInteract.actionRead, DeviceInteract.actionSend
调用id
输出参数 注意:此字段可能返回 null,表示取不到有效值。
返回状态
设备返回状态码
Used in:
, ,物模型类型 1:property属性 2:event事件 3:action行为
标识符
功能名称
描述
是否必须 1:是 2:否
是否支持场景联动控制
功能分类: 1:普通功能 2:系统功能
用户权限操作: 1:r(只读) 3:rw(可读可写)
是否存储历史记录
是否是密码类型,密码类型需要加掩码
各功能类型的详细参数定义
拓展参数
排序
控制模式: 1: 可以群控,可以单控 2:只能单控
绑定的产品品类(如果绑定了,则该品类下的产品会自动新增并不允许删除)
Used in:
,"=":相等 "!=":不相等 ">":大于">=":大于等于"<":小于"<=":小于等于 "like":模糊查询
值
"=":相等 "!=":不相等 ">":大于">=":大于等于"<":小于"<=":小于等于 "like":模糊查询
值
Used in:
自定义主题需要以$custom 并包含设备名称{deviceName}及产品名称{productID}
1:上行 2:下行 3:双向
Used in:
设备创建默认分配给的租户
设备创建默认分配给的项目
设备创建默认分配给的区域ID
设备创建默认分配给的部门
Used as response type in: DeviceManage.deviceBindTokenCreate, DeviceManage.deviceBindTokenRead
配网token
token状态 1:初始状态 2: 设备已上报
Used in:
, , , , , , , , , , , , , , , , , , , , , , , , , , , , ,产品id
设备名称
Used in:
Used in:
产品id
设备名称
属性id
Used in:
产品id
设备名称
Used in:
产品id
设备名称
签名
Used as request type in: DeviceManage.deviceGatewayMultiDelete, DeviceManage.deviceGatewayMultiUpdate
不通知网关设备状态做了调整
Used in:
子设备绑定签名串。 签名算法: 1. 签名原串,将产品 ID 设备名称,随机数,时间戳拼接:text=${product_id}${device_name};${random};${expiration_time} 2. 使用设备 Psk 密钥,或者证书的 Sha1 摘要,进行签名:hmac_sha1(device_secret, text)
随机数。
时间戳,单位:秒。
签名算法。支持 hmacsha1、hmacsha256
Used as request type in: DeviceManage.deviceGroupMultiCreate, DeviceManage.deviceGroupMultiDelete, DeviceManage.deviceGroupMultiUpdate
产品id
设备ID 必填
Used as request type in: DeviceManage.deviceInfoCreate, DeviceManage.deviceInfoUpdate
Used as response type in: DeviceManage.deviceInfoRead
Used as field type in:
,租户号,只有default租户能查到这个字段
产品id 只读
项目id 只读
项目区域id
区域id 路径
产品名称 只读
设备名称 读写
创建时间 只读
设备秘钥 只读
设备证书 只读
IMEI号信息 只读
MAC号信息 只读
固件版本 读写
模组硬件型号 只读
模组软件版本 只读
设备定位,默认百度坐标系
所在地址 读写
地区编码 读写
设备标签
在线状态 1离线 2在线 只读
激活时间 只读
第一次绑定的时间
最后一次绑定时间
最后上线时间 只读
日志级别:1)关闭 2)错误 3)告警 4)信息 5)调试 读写
设备别名 读写
移动运营商:1)移动 2)联通 3)电信 4)广电
手机号
SIM卡卡号
设备物模型别名,如果是结构体类型则key为xxx.xxx
设备信号(信号极好[-55— 0],信号好[-70— -55],信号一般[-85— -70],信号差[-100— -85])
额定功率:单位w/h
设备状态 1-未激活,2-在线,3-离线 4-异常(频繁上下线,告警中)
是否启用
设备类型:1:设备,2:网关,3:子设备
网络类型
过滤分销商的数据
到期时间,如果为0,则不限制
需要app确认升级的任务ID,为0是没有
待确认升级的版本
拥有者的用户ID
产品图片
产品品类
最后登录的ip,只读
过滤分销商的数据
子设备绑定的网关
排序
Used as response type in: DeviceManage.deviceModuleVersionRead
Used as field type in:
Used as request type in: DeviceManage.deviceProfileUpdate
Used as response type in: DeviceManage.deviceProfileRead
Used as field type in:
Used as request type in: DeviceManage.deviceProfileDelete, DeviceManage.deviceProfileRead
Used as request type in: DeviceManage.deviceSchemaCreate, DeviceManage.deviceSchemaUpdate
Used as field type in:
,产品id 必填
设备ID 必填
物模型标签 1:自定义 2:可选 3:必选 必选不可删除
物模型类型 1:property属性 2:event事件 3:action行为
标识符
功能名称
描述
是否必须 1:是 2:否
是否支持场景联动控制
功能分类: 1:普通功能 2:系统功能
用户权限操作: 1:r(只读) 3:rw(可读可写)
控制模式: 1: 可以群控,可以单控 2:只能单控
是否存储历史记录
是否是密码类型,密码类型需要加掩码
各功能类型的详细参数定义
拓展参数
排序
Used in:
产品id
产品名称 只读
设备名称
产品图片
设备别名 读写
Used as request type in: DeviceManage.deviceTransfer, userDevice.userDeviceTransfer
设备信息
设备信息
指定原来的项目ID,不写使用头
转让给: 1: 某个人 2: 自己的某个项目
用户id
项目id
转移到项目时指定区域ID
是否清除数据:1是 2否
Used as request type in: DeviceManage.deviceBindTokenCreate, SchemaManage.commonSchemaInit, userDevice.userDeviceCollectIndex
Used as response type in: DeviceGroup.groupDeviceMultiCreate, DeviceGroup.groupDeviceMultiDelete, DeviceGroup.groupDeviceMultiUpdate, DeviceGroup.groupInfoDelete, DeviceGroup.groupInfoMultiCreate, DeviceGroup.groupInfoUpdate, DeviceInteract.actionResp, DeviceInteract.gatewayGetFoundSend, DeviceInteract.gatewayNotifyBindSend, DeviceManage.DeviceInfoMultiUpdate, DeviceManage.deviceGatewayMultiCreate, DeviceManage.deviceGatewayMultiDelete, DeviceManage.deviceGatewayMultiUpdate, DeviceManage.deviceGroupMultiCreate, DeviceManage.deviceGroupMultiDelete, DeviceManage.deviceGroupMultiUpdate, DeviceManage.deviceInfoBind, DeviceManage.deviceInfoCanBind, DeviceManage.deviceInfoCreate, DeviceManage.deviceInfoDelete, DeviceManage.deviceInfoUnbind, DeviceManage.deviceInfoUpdate, DeviceManage.deviceMove, DeviceManage.deviceOnlineMultiFix, DeviceManage.deviceProfileDelete, DeviceManage.deviceProfileUpdate, DeviceManage.deviceReset, DeviceManage.deviceSchemaCreate, DeviceManage.deviceSchemaMultiCreate, DeviceManage.deviceSchemaMultiDelete, DeviceManage.deviceSchemaUpdate, DeviceManage.deviceTransfer, DeviceManage.rootCheck, DeviceMsg.abnormalLogCreate, OtaManage.otaFirmwareDeviceCancel, OtaManage.otaFirmwareDeviceConfirm, OtaManage.otaFirmwareDeviceRetry, OtaManage.otaFirmwareInfoDelete, OtaManage.otaFirmwareJobUpdate, OtaManage.otaModuleInfoDelete, OtaManage.otaModuleInfoUpdate, ProductManage.productCategoryDelete, ProductManage.productCategorySchemaMultiCreate, ProductManage.productCategorySchemaMultiDelete, ProductManage.productCategorySchemaMultiUpdate, ProductManage.productCategoryUpdate, ProductManage.productConfigUpdate, ProductManage.productCustomUpdate, ProductManage.productInfoCreate, ProductManage.productInfoDelete, ProductManage.productInfoUpdate, ProductManage.productInit, ProductManage.productSchemaCreate, ProductManage.productSchemaDelete, ProductManage.productSchemaMultiCreate, ProductManage.productSchemaTslImport, ProductManage.productSchemaUpdate, ProtocolManage.ProtocolScriptDelete, ProtocolManage.ProtocolScriptDeviceDelete, ProtocolManage.ProtocolScriptDeviceUpdate, ProtocolManage.ProtocolScriptUpdate, ProtocolManage.protocolInfoDelete, ProtocolManage.protocolInfoUpdate, ProtocolManage.protocolServiceDelete, ProtocolManage.protocolServiceUpdate, RemoteConfig.RemoteConfigCreate, RemoteConfig.RemoteConfigPushAll, SchemaManage.commonSchemaCreate, SchemaManage.commonSchemaDelete, SchemaManage.commonSchemaInit, SchemaManage.commonSchemaUpdate, userDevice.userDeivceShareMultiAccept, userDevice.userDeviceCollectMultiCreate, userDevice.userDeviceCollectMultiDelete, userDevice.userDeviceShareDelete, userDevice.userDeviceShareMultiDelete, userDevice.userDeviceShareUpdate, userDevice.userDeviceTransfer
(message has no fields)
设备的日志数据
Used in:
发生时间戳(毫秒时间戳)
事件类型: 信息:info 告警alert 故障:fault
属性id
获取到的值
设备名(不填获取产品下所有设备)
下面是ota固件管理模块的消息
创建时间 只读
升级包名称
升级包版本
是否差分包,1:整包,2:差分
签名方法 MD5/SHA
描述
自定义数据
产品信息
Used in:
Used in:
创建时间 只读
升级包名称
升级包版本
是否差分包,1:整包,2:差分
签名方法 MD5/SHA
描述
自定义数据
产品信息
分页信息 只获取一个则不填
固件信息
总数(只有分页的时候会返回)
创建时间 只读
升级包名称
升级包版本
是否差分包,1:整包,2:差分
描述
自定义数据
产品信息
Used as request type in: DeviceGroup.groupDeviceMultiCreate, DeviceGroup.groupDeviceMultiUpdate
Used as request type in: DeviceGroup.groupInfoCreate, DeviceGroup.groupInfoUpdate
Used as response type in: DeviceGroup.groupInfoRead
Used as field type in:
,用途 不填默认为default
分组可以属于某个区域下
DeviceInfoCount deviceInfoCount =11;
用途 不填默认为default
分组可以属于某个区域下
设备的日志数据
Used in:
发生时间戳(毫秒时间戳)
操作类型;connected:上线 disconnected:下线 property:属性 event:事件 action:操作 thing:物模型提交的操作为匹配的日志
请求ID
服务器端事务id
主题
具体内容
请求结果状态
返回的内容
Used in:
,Used in:
Used in:
当前的升级进度 0-100% -1:升级失败。-2:下载失败。-3:校验失败。-4:烧写失败。
详情
设备升级作业状态。1:待确认。 2:待推送。 3:已推送。 4:升级中。 5:升级成功 6: 升级失败. 7:已取消
只读 设备是否在线
Used in:
,Used in:
Used in:
string signMethod = 7;
Used as response type in: OtaManage.otaFirmwareInfoRead
Used as field type in:
固件id
固件升级包名称
版本号
产品id
产品名称
状态
添加时间
签名方式:MD5/SHA256
文件描述
推给设备端端消息
文件列表
整包or差包
是否需要验证
模块编码
Used as request type in: OtaManage.otaFirmwareJobCreate, OtaManage.otaFirmwareJobUpdate
Used as response type in: OtaManage.otaFirmwareJobRead
Used as field type in:
升级包ID,升级包的唯一标识符。
升级包所属产品的JobType。 验证升级包:1 批量升级:2
批次状态,计划中:1 执行中:2 已完成:3 已取消:4
升级策略,1-静态,2-动态
待升级版本号列表。 发起全量升级(TargetSelection=ALL)和灰度升级(TargetSelection=GRAY)任务时,可以传入该参数。 使用差分升级包发起全量升级和灰度升级任务时,该参数值需指定为差分升级包的待升级版本号(SrcVersion)。 发起定向升级(TargetSelection=SPECIFIC)或分组升级(TargetSelection=GROUP)任务时,不能传入该参数。 可以调用 QueryDeviceDetail ,查看设备 OTA 模块版本号(FirmwareVersion)。 列表中不能有重复的版本号。 最多可传入 10 个版本号。
待升级版本号列表。最多可传入10个版本号。用逗号分隔多个版本号
设备升级失败后,自动重试的时间间隔,单位为分钟。 动态升级 静态升级 -1 为不重试
自动重试次数。1/2/5次 动态升级 静态升级
设备升级超时时间,单位为分钟。 动态升级 静态升级
每分钟最多向多少个设备推送升级包下载URL。 动态升级 静态升级
是否覆盖之前的升级任务。取值: 2(默认):不覆盖。若设备已有升级任务,则只执行已有任务。 1:覆盖。设备只执行新的升级任务。此时 MultiModuleMode 不能传入 true。 动态升级 静态升级
是否覆盖之前的升级任务。取值:1(不覆盖)、2(覆盖)。
物联网平台是否主动向设备推送升级任务。 1(默认):是。批次任务创建完成后,物联网平台主动将升级任务,直接推送给升级范围内的在线设备。 此时,设备仍可主动向物联网平台发起请求,来获取 OTA 升级任务信息。 2:否。设备必须通过向物联网平台发起请求,来获取 OTA 升级任务信息。 动态升级
物联网平台是否主动向设备推送升级任务。
如需自主控制设备 OTA 升级时,可配置此参数,通过手机 App 来控制,设备是否可进行 OTA 升级。手机 App 需您自行开发。 2(默认):否。直接按照 NeedPush 设置,获取 OTA 升级任务信息。 1:是。设备无法获取 OTA 升级任务,需 App 侧确认 OTA 升级后,才能按照 NeedPush 设置,获取 OTA 升级任务信息。
升级范围。 1:全量升级。 2:定向升级。 3:灰度升级。 4:分组升级(不做) 5: 区域升级(不做)
分组升级和区域升级填写对应的id
指定租户
Used in:
动态升级模式。取值范围: 1(默认):除了升级当前满足升级条件的设备,还将持续检查设备是否满足升级条件,对满足升级条件的设备进行升级。 2:仅对后续上报新版本号的设备生效。 动态升级
Used in:
定向升级的设备名称列表。 使用差分升级包进行定向升级时,要升级的设备的当前 OTA 模块版本号需与差分升级包的待升级版本号(SrcVersion)相同。 可以调用 QueryDeviceDetail ,查看设备 OTA 模块版本号(FirmwareVersion)。 列表中的设备所属的产品必须与升级包所属产品一致。 列表中不能有重复的设备名称。 最多可传入 200 个设备名称。 静态升级
定向升级的设备名称列表。最多可传入200个设备名称。以逗号分隔
指定结束升级的时间。 结束时间距发起时间(ScheduleTime)最少 1 小时,最多为 30 天。取值为 13 位毫秒值时间戳。 不传入该参数,则表示不会强制结束升级。 静态升级
指定结束升级的时间,单位为毫秒。
指定发起 OTA 升级的时间。 定时时间范围需为当前时间的 5 分钟后至 7 天内。取值为秒时间戳。 不传入该参数,则表示立即升级。 静态升级
灰度的范围,小数点后两位, 1.23%为 123
Used as request type in: OtaManage.otaModuleInfoCreate, OtaManage.otaModuleInfoUpdate
Used as response type in: OtaManage.otaModuleInfoRead
Used as field type in:
Used in:
, , , , , , , , , , , , , , , , , , , , , , , , , , , ,排序信息
Used in:
排序的字段名
排序方式:1 从小到大, 2 从大到小
Used in:
,经度
纬度
Used as request type in: ProductManage.productCategoryCreate, ProductManage.productCategoryUpdate
Used as response type in: ProductManage.productCategoryRead
Used as field type in:
, ,只有这个参数为true的时候才会更新产品图片,传参为产品图片的file path
子节点
Used as request type in: ProductManage.productCategorySchemaMultiCreate, ProductManage.productCategorySchemaMultiDelete, ProductManage.productCategorySchemaMultiUpdate
过滤标识符列表
Used as request type in: ProductManage.productConfigUpdate
Used as field type in:
产品id 只读
设备初始化配置
Used as request type in: ProductManage.productCustomUpdate
Used as response type in: ProductManage.productCustomRead
脚本语言类型(默认JavaScript) 1:JavaScript 2:lua 3:python
协议转换脚本
登录认证脚本
自定义topic信息 只有mqtt协议有用
Used in:
版本号,递增
Used as request type in: ProductManage.productInfoCreate, ProductManage.productInfoUpdate
Used as response type in: ProductManage.productInfoRead
Used as field type in:
,创建时间 只读
产品id 只读
产品名称
认证方式:1:账密认证,2:秘钥认证
设备类型:1:设备,2:网关,3:子设备
产品品类
通讯方式:1:其他,2:wi-fi,3:2G/3G/4G,4:5G,5:BLE,6:LoRaWAN
协议code,默认urMqtt,设备下发只会发送给主协议 urMqtt,urHttp,wumei,aliyun,huaweiyun,tuya
子协议,主协议和子协议传输类型必须不相同, 设备控制下发只会发送给主协议, 当设备是音视频设备但是控制协议需要单独走的时候就可以把主协议定义为普通协议,子协议定义为音视频协议,这样就能实现音视频走音视频协议,控制走子协议
动态注册:1:关闭,2:打开,3:打开并自动创建设备
动态注册产品秘钥 只读
描述
产品标签
产品图片
只有这个参数为true的时候才会更新产品图片,传参为产品图片的file path
主协议信息
子协议信息
试用时间(单位为天,为0不限制)
场景模式 读写类型: r(只读) rw(可读可写) none(不参与场景)
产品状态 1:启用 2:禁用 3:开发中
自定义ui
设备物模型模式:1:关闭,2:设备自动创建3: 设备自动创建及上报无定义自动创建
绑定级别: 1:强绑定(默认,只有用户解绑之后才能绑定) 2:中绑定(可以通过token强制绑定设备) 3:弱绑定(app可以内部解绑被绑定的设备)
产品配置
Used in:
,Used in:
, , ,产品id 必填
物模型类型 1:property属性 2:event事件 3:action行为
物模型标签 1:自定义 2:可选 3:必选 必选不可删除
标识符
功能名称
描述
是否必须 1:是 2:否
是否支持场景联动控制
功能分类: 1:普通功能 2:系统功能
用户权限操作: 1:r(只读) 3:rw(可读可写)
控制模式: 1: 可以群控,可以单控 2:只能单控
是否存储历史记录
是否是密码类型,密码类型需要加掩码
各功能类型的详细参数定义
拓展参数
排序
Used in:
设备名
设备返回状态码
返回状态
调用id
系统错误信息
系统错误码
Used as response type in: DeviceInteract.propertyControlRead, DeviceInteract.propertyControlSend
设备返回状态码
返回状态
调用id
Used in:
设备返回状态码
返回状态
调用id
上报时间戳(毫秒时间戳)
获取到的值
产品id (必填)
设备名(必填)
系统错误信息
系统错误码
获取对应日志信息
Used as response type in: DeviceMsg.propertyLogIndex, DeviceMsg.propertyLogLatestIndex, DeviceMsg.propertyLogLatestIndex2
总数
设备的日志数据
Used in:
发生时间戳(毫秒时间戳)
产品名称
设备名称
属性id
获取到的值
获取对应日志信息
Used as request type in: DeviceMsg.propertyLogLatestIndex, DeviceMsg.shadowIndex
产品id (必填)
设备名(必填)
获取的具体标识符的数据 如果不指定则获取所有属性数据,一个属性一条,如果没有获取到的不会返回值
Used in:
Used in:
Used as request type in: ProtocolManage.protocolInfoCreate, ProtocolManage.protocolInfoUpdate
Used as response type in: ProtocolManage.protocolInfoRead
Used as field type in:
,iThings,iThings-thingsboard,wumei,aliyun,huaweiyun,tuya
协议类型: 普通设备(默认):normal 音视频:media
传输协议: mqtt,tcp,udp
是否支持主动同步产品信息
是否支持主动同步设备信息
配置字段列表,没有可以不传
配置列表
产品需要的配置字段列表
设备需要的配置字段列表
Used as request type in: ProtocolManage.ProtocolScriptCreate, ProtocolManage.ProtocolScriptUpdate
Used as response type in: ProtocolManage.ProtocolScriptRead
Used as field type in:
,名称
1:up 2:down
收到前处理1:before 2:after
对应 mqtt topic的第一个 thing ota config 等等
操作类型 从topic中提取 物模型下就是 property属性 event事件 action行为
描述
脚本内容
状态:是否启用
创建时间
Used as request type in: ProtocolManage.ProtocolScriptDeviceCreate, ProtocolManage.ProtocolScriptDeviceUpdate
Used as response type in: ProtocolManage.ProtocolScriptDeviceRead
Used as field type in:
产品:1 设备:2
脚本对应的ID
执行优先级 大于0
状态:是否启用
创建时间
脚本信息
withDevice时,绑定的是产品返回
withDevice时,绑定的是设备返回
Used as request type in: ProtocolManage.protocolServiceUpdate
Used as field type in:
协议code
协议服务的ip地址
监听的端口,如果没有填0即可
服务状态
更新时间
首次加入时间
发布消息结构体
Used in:
,对应 mqtt topic的第一个 thing ota config 等等
操作类型 从topic中提取 物模型下就是 property属性 event事件 action行为
毫秒时间戳
内部使用的拓展字段
如果有该字段则回复的时候也会带上该字段
获取异步消息的请求
Used as request type in: DeviceInteract.actionRead, DeviceInteract.propertyControlRead
产品id
设备名
调用id
调用参数
返回参数
物模型定义
Used in:
, ,参数类型: bool int string struct float timestamp array enum
枚举及bool类型:bool enum
数值最小值:int float
数值最大值:int string float
初始值:int float
步长:int float
单位:int float
结构体:struct
数组:array
事件类型: 信息:info 告警alert 故障:fault
事件参数
物模型参数
Used in:
,参数标识符
参数名称
参数定义
读写类型: r(只读) rw(可读可写)
参数定义
物模型结构体说明
Used in:
参数标识符
参数名称
参数定义
Used in:
发生时间戳(毫秒时间戳)
操作类型;显示相应的操作名称、API名称、服务的method
具体内容
设备的日志数据
Used in:
发生时间戳(毫秒时间戳)
账号
操作类型 propertySend:属性控制 actionSend:操作控制 propertyGetReportSend:获取最新属性请求
identify
服务器端事务id
操作的内容
请求结果状态,200为成功
Used in:
超时失败时间
请求超时,超时后会进行重试
重试间隔
设备的日志数据
Used in:
属性id
获取到的值
更新到设备的时间
Used in:
,1:r(只读) 3(默认):rw(可读可写)
设备的日志数据
Used in:
发生时间戳(毫秒时间戳)
设备状态
产品id
设备名
Used in:
,Used as request type in: userDevice.userDeviceCollectMultiCreate, userDevice.userDeviceCollectMultiDelete
Used as response type in: userDevice.userDeviceCollectIndex
Used as request type in: userDevice.userDeviceShareCreate, userDevice.userDeviceShareUpdate
Used as response type in: userDevice.userDeviceShareRead
Used as field type in:
设备信息
分享的对象
分享的账号(只读)
物模型权限,只需要填写需要授权并授权的物模型id
操作权限 hubLog:设备消息记录,ota:ota升级权限,deviceTiming:设备定时
授权类型:1:全部授权 2:部分授权
设备归属的项目
到期时间,如果为0,则不限制
Used as request type in: userDevice.userDeviceShareMultiCreate
Used as response type in: userDevice.userDeivceShareMultiIndex
设备信息
物模型权限,只需要填写需要授权并授权的物模型id
操作权限 hubLog:设备消息记录,ota:ota升级权限,deviceTiming:设备定时
授权类型:1:全部授权 2:部分授权
设备归属的项目
有效期,如果为0,则不限制
生成分享的人id
Used as request type in: userDevice.userDeivceShareMultiIndex
Used as response type in: userDevice.userDeviceShareMultiCreate
Used as request type in: userDevice.userDeviceShareDelete, userDevice.userDeviceShareRead
设备信息
Used as request type in: DeviceGroup.groupInfoDelete, OtaManage.otaFirmwareInfoDelete, OtaManage.otaFirmwareInfoRead, OtaManage.otaFirmwareJobRead, OtaManage.otaModuleInfoDelete, ProductManage.productCategoryDelete, ProtocolManage.ProtocolScriptDelete, ProtocolManage.ProtocolScriptDeviceDelete, ProtocolManage.ProtocolScriptDeviceRead, ProtocolManage.ProtocolScriptRead, ProtocolManage.protocolInfoDelete, ProtocolManage.protocolServiceDelete, SchemaManage.commonSchemaDelete
Used as response type in: DeviceGroup.groupInfoCreate, OtaManage.otaFirmwareInfoCreate, OtaManage.otaFirmwareInfoUpdate, OtaManage.otaFirmwareJobCreate, OtaManage.otaModuleInfoCreate, ProductManage.productCategoryCreate, ProtocolManage.ProtocolScriptCreate, ProtocolManage.ProtocolScriptDeviceCreate, ProtocolManage.protocolInfoCreate, userDevice.userDeviceShareCreate
Used as request type in: OtaManage.otaModuleInfoRead, ProtocolManage.protocolInfoRead
Used in:
Used in: