GizWits机智云平台技术说明书.A1.docx

GizWits（机智云）平台技术说明书概述1功能要点2基础知识5工作流程51.设备入网配置流程52.小循环（LAN）自举流程63.小循环（LAN）发现流程74.获取设备密保流程75.小循环登录流程86.设备对云端自注册流程97.关联绑定流程10开发者指引10概述GizWits（机智云）是杰升科技经过对物联网领域多年的积累，沉淀出一系列产品，形成的解决方案平台。她可以通过机智云网站实时生成客制化的物联网解决方案。整个解决方案包括： 移动/桌面应用程序开发包（SDK含设备软件模拟器） 云端解决方案（手机与设备间远程遥感及遥控、用户行为采集、设备状态采集、大数据分析服务、智能响应与决策等） 硬件级设备客制化开源参考实现我们相信，当合作伙伴选择GizWits的解决方案时，她可以帮助他们获得进入市场的最快时间，并在市场上保持产品的竞争优势。机智云平台可以提供以下两种商业合作模式： 基于开发者帐户免费级的标准服务 基于合作条款的全方位解决方案o NREo Cloud/MISo Big Datao Outsourcingo Dedicated service 手机: 图中的Mobile Phone Wi-Fi模组: 安装在设备端的无线通讯单元（图中Wi-Fi Module） 设备主控MCU: 负责具体设备业务逻辑的控制单元（图1中Device MCU） 云端: 云端服务器（图1中）功能要点 设备联网必备动作准协议o 入网配置（Onboarding, Soft AP/WAC/WPS/Easylink/）o 小循环（LAN）发现/自举（Discovery/Boot）o 大循环（WAN）上线/离线（Online/Offline）o 大小循环无差异透明传输（xpgcRead/xpgcWrite） 设备安全控制准协议o 大循环（WAN） 设备对云端自注册（DID + Passcode） 用户注册（UID + Password） 关联绑定（UID + DID） 认证、授权、计费（3A） 双安全级别连接（TCP/SSL）o 小循环（LAN） 获取密保（DID + Passcode） 设备登录（Passcode） 业务级协议完全自定义o 内置数据点简化模型，自定义业务协议o 内置数据帧模型，细节定义协议内具体每种收发数据包的二进制布局 支持五种数据类型：字节、字、双字、限长文本、变长二进制数据 实时生成解决方案o 自定义协议SDK实现 手机应用开发套件 桌面应用开发套件 设备模拟器软件o 自定义协议硬件原型实现（基于杰升参考模块列表中型号） 通讯模块固件 协议插件源代码（C语言） 云端大数据分析、 o 用户 相关消息推送 智能响应与决策，例如： 您所在区域雾霾已散，可以替您开窗换气吗？ 您父亲最近三天血压偏高，需要淘一盒银杏茶吗？ 您家中的电子汤煲已工作六小时，现厨房监测录得少量烟雾，需要断电以防火险吗？ 警告！您西郊别墅走廊处红外检测到人型热源进出，需要打开网络监控或者报警吗？ 产品相关文化、社交服务（酒友圈/高球会/）o 厂商 用户行为分析 设备生命周期管理 设备异常汇报 设备固件自动升级（OTA，避免小问题大召回） 智能响应与决策，例如： 罗帝凡空调自动报障排行，头三位故障码为EEPROM故障、电压保护(P1变频用)故障、过零检测故障 芬博酒柜本月全球共自动报障32例，28例位于上海市区o 九大领域的行业知识提炼基础知识工作流程 1. 设备入网配置流程a. SoftAp（软AP）b. WAC（苹果）c. Easylink（一键连）2. 小循环（LAN）自举流程3. 小循环（LAN）发现流程4. 获取设备密保流程5. 小循环登录流程6. 设备对云端自注册流程7. 关联绑定流程开发者指引 计划完成一个手机应用时，首先你需要使用准协议API，让你的应用与设备之间建立基本连接。然后调用机智云根据你的业务协议定义，所生成的业务协议API来完成与设备之间的各种交互。1. xpgcInit()，初始化SDK（须实现初始化要求的各个回调函数作为参数输入）2. xpgcFindDevice()，发出发现广播包a. foundDevice()回调将在收到设备响应时被调用b. xpgcConnectDevice()，如果有发现设备，可小循环连接3. xpgcConnectMqtt()，如果没有发现，可尝试云端大循环连接a. xpgcLoginDevice()，登录到云端4. 登录成功后，就可以调用生成的的各个业务逻辑包的操作函数。例如：定义中如果有一个SwitchOn的数据点或者WriteSwitchOnReq的数据帧定义，则生成的API中将会有 SendWriteSwitchOnReq()可供UI开发者直接发送指令。同时也会有onSendWriteSwitchOnResp()回调在得到相应返回时被调用。而不必人