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

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