资源预览内容
第1页 / 共14页
第2页 / 共14页
第3页 / 共14页
第4页 / 共14页
第5页 / 共14页
第6页 / 共14页
第7页 / 共14页
第8页 / 共14页
第9页 / 共14页
第10页 / 共14页
亲,该文档总共14页,到这儿已超出免费预览范围,如果喜欢就下载吧!
资源描述
Alibaba Alibaba 1 阿里巴巴物联平台协议标准 Alibaba Alibaba 2 修订修订历史历史 修订版本修订版本 修订内容修订内容 修订人、日期修订人、日期 0.1 初稿 陈辰 2014-06-20 0.2 增加智能设备安全策略、智能设备属性定义及分类细则 陈辰 2014-06-26 0.3 增加应用对接智能云初稿 陈辰、宋杨 2014-07-02 0.4 增加私有云对接智能云 陈辰 2014-07-04 0.5 修订了部分协议结构 陈辰、邓翔 2014-07-07 0.6 对照不同卷通信协议文档,把不一致的协议进行修正 邓翔 2014-07-07 0.7 1. 完善应用与物联平台通信协议 2. 将 key 从 request 里面放置到system 里面,修改部分错误 单志伟 2014-07-09 艾志青 0.8 1. 接口遵照 RESTful API 格式 2. 修改返回消息格式 3. 增加上报类消息的优先级机制 4. 增加通过 uuid 查询设备的接口 5. 修改了应用与物联平台通信协议 邓翔 2014-07-09 0.9 1. 增加智能应用接收 push 通道数据规范 2. 增加智能应用获取物联平台系统时间接口 3. 增加智能应用远程控制设备接口(setAttr 3. 添加查看设备状态; 4. 添加:定义,并修改之前的定义; 5. 添加 UTC 说明 艾志青 2014-07-16 1.0.0.0717 1. 增加私有云接口:设备上、下线通知,用户操作通知。 2. 增加设备属性定义 陈辰 2014-07-17 1.0.0.0724 1. 设备绑定添加 mac+model + account 的绑定方式; 艾志青 2014-07-24 1.0.0.0729 1. 私有云签名规则,代理的私有设备及应用的数据用对应的设备或者应用的 key 签名 2. 设备、App 协议中去除 Http 描述。按目前框架,所有消息走 tcp连接 3. 增加签名范例 4. 修改 App 与云端接口 5. 检查范例中 json 格式是否正确 6. 按目前产品对接信息,增补卷四 陈辰 2014-07-29 1.0.1.0804 1. 分拆各卷 2. 补充服务端返回值定义 3. 补充设备功能属性定义 4. 修改部分属性名称,以缩写表示 陈辰 2014-08-04 1.0.1.0806 1. 修改消息回馈格式规范定义 陈辰 2014-08-06 Alibaba Alibaba 4 1.0.1.0807 1. 增加 light 属性 陈辰 2014-08-07 1.0.1.0810 1. 将 triggerTime 改为 when,此属性标记状态更新的时间,也可作为定时功能之用,即当设置修改状态命令时,指定的预定时间。 陈辰 2014-08-10 1.0.1.0825 1. 修改 1.1.4 2. 新增空调、水壶、空气净化器设备属性 陈辰 2014-08-11 Alibaba Alibaba 5 目录目录 卷四:属性定义、分类和附录 . 6 第一章 智能设备定义及细则 . 6 1.1 智能设备属性定义及分类 . 6 1.1.1 智能设备硬件属性定义 . 6 1.1.2 智能设备可供用户定制硬件属性定义(待完善) . 7 1.1.3 智能设备功能属性定义(待完善) . 7 1.1.4 智能设备工作状态属性定义(待完善) . 10 1.2 智能设备型号(model)定义规则 . 10 1.3 设备属性名值对(:)定义 . 11 第二章 消息格式规范 . 12 2.1 请求消息回馈格式规范 . 12 2.1.1 功能描述 . 12 2.1.2 消息回馈的格式规范 . 12 2.2 错误码定义 . 13 3.3 消息优先级规范 . 14 3.3.1 功能描述 . 14 3.3.2 消息优先级规范定义 . 14 Alibaba Alibaba 6 卷四:属性定义、卷四:属性定义、分类分类和和附录附录 第第一一章章 智能设备定义及细则智能设备定义及细则 1.1 智能设备智能设备属性定义及属性定义及分类分类 物联平台将智能设备按照所属类别、类型及自身提供的功能进行分类。智 能设备所有硬件属性、功能属性及工作状态属性都按规则细分为单一属性项, 属性对应的参数作为该属性项的取值范围,标准定义如下。 1.1.1 智能设备硬件属性定义 属性名称 类型 格式/长度 说明 来源 name 字符串 xxxx / 32bytes 设备名字 出厂设置 model 字符串 xxxx / 80bytes 设备型号 出厂设置 type 字符串 xxxx / 32bytes 设备类型 出厂设置 category 字符串 xxxx / 32bytes 设备类别 出厂设置 uuid 字符串 xxxx / 32bytes 设备唯一标识,不可重复 物联平台服务器分配 sn 字符串 xxxx / 64bytes 设备序列号 出厂设置 mac 字符串 xx-xx-xx-xx-xx-xx / 12bytes 设备无线 mac 地址,不可重复 出厂设置 manufacturer 字符串 xxxx / 32bytes 设备制造商信息 出厂设置 version 字符串 xxxx / 32bytes 固件版本号 出厂设置 注:物联平台以上述属性来区分设备个体。设备出厂时必须预置 model, sn, mac。uuid 由设备在首次注册时由物联平台分配并在设备端储存,如果设备端无 法存储,则需要私有云存储此信息。 Alibaba Alibaba 7 1.1.2 智能设备智能设备可供用户定制可供用户定制硬件属性定义硬件属性定义(待完善待完善) 属性名称 类型 格式/长度 说明 取值定义 修改来源 nickName 字符串 xxxx /255bytes 设备在线状态 默认为空,用户可自定义 应用 description 字符串 xxxx /255bytes 设备工作模式 默认为空,用户可自定义 应用 timezone 字符串 UTC-+: 设备所在时区 默 认UTC+08:00 用户可修改 应用 1.1.3 智能设备功能属性定义(待完善) 设备类别 CATEGORY 设备类型 TYPE 属性 attr 属性取值参考 范围 val 单位 说明 LIVING KETTLE ct 0100 当前温度 ft 0100 底座温度 tt 0100 目标温度 ib 0,1 - 是否沸腾 dt 01000 sec 除氯时间 ikw 0,1 - 是否保温 as 0100 - 报警状态 oat - 预约用水绝对时间 ort 01440 - 预约用水相 对时间 ptt 0100 预约时水温 pft 0100 预约时底座温度 evt 0100 - 运行事件 st 0100 - 运行状态 LIGHT state on,off - 开关状态 brightness 0.1000 - 亮度等级 colortemp 0.4000 - 色温等级 red 0.255 - 红光成分 green 0.255 - 绿光成分 blue 0.255 - 蓝光成分 saturation 0.255 - 饱和度 nightlight on,off - 夜灯状态 backlight on,off - 背光状态 transtime 0.1000 min 渐变时间 AIRCONDITION power on,off - 电源开关 Alibaba Alibaba 8 temp 10,50 温度 mode warm, cold, dry, wind, auto - 模式 fanspeed -110 - 风速 sleepmode 010 - 睡眠 ontimestart ontimestart quartz 定时开 ontimestop ontimestop quartz 定时关 ptc on,off - 电辅热 vwind -110 - 上下风门, -1:自动, 0:关闭, 110:档位 hwind -110 - 左右风门, -1:自动, 0:关闭, 11
网站客服QQ:2055934822
金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号