一、机智云接入流程概述:
注册开发者 —> 创建产品 —> 设备开发/应用开发—> 产品调试 —> 申请发布 —> 正式量产
1、注册成为机智云开发者
2、创建产品
【a】点击“创建新产品”
【b】输入产品名称与选择设备接入方案
【c】创建数据点
【d】下载云端自动生成的协议
3、设备与应用开发
【a】设备端接入
【b】应用端接入
4、调试产品
5、申请发布
6、正式量产
二、创建个人项目产品流程:
1、进入产品列表,选择个人项目或企业项目,创建新产品
产品列表 —》个人项目 —》创建新产品 —》 选择产品分类及产品名称(产品分类、产品名称、3种技术方案) —》 基本信息 —》 查看产品标识码和产品密匙 —》 数据点 —》 定义数据点 —》 开发向导 —》 下载MCU串口通讯协议以及SOC接入协议
2、三种技术方案可分为:
【a】WIFi/移动网络方案(通讯方式:WIFi、移动网络、NB-IoT,数据传输方式:定长、变长)
云端 —》 WIFi/移动网络/NB-IoT —》 设备
【b】蓝牙方案
云端 —》 蓝牙 —》 设备
【c】网关方案(通讯方式:WIFi、移动网络、NB-IoT,数据传输方式:定长、变长)
云端 —》 WIFi/移动网络 —》 网关 —》 子设备
三、开发向导:
1、定义产品功能说明
产品开发的第一步是定义产品的功能,一个数据点可以定义为产品的某个功能,如开关等。可以查看文档《如何定义数据点》
2、MCU开发/App开发/微信开发
【a】进入MCU开发,机智云根据你定义的产品数据点,会自动生成MCU串口通信代码或整个MCU工程代码,同时也有SOC方案的工程代码。可以查看以下文档
《空气净化器WiFi方案01 - 机智云独立MCU方案接入通信协议文档》
《 空气净化器WiFi方案01 - 机智云SOC方案接入通信协议文档 》
【b】进入App开发,机智云根据你定义的产品数据点,会自动生成对应的App源码,可直接编译打包成App安装包,安装后便可运行控制设备。你也可以在源码的基础上进行二次开发,比如修改成更美观的界面、加入更丰富的功能等。可以查看以下文档
【c】进入微信开发, 机智云提供了微信开发SDK,大大提高了开发微信应用的效率。对于想开发微信点的应用,让用户可以使用微信控制设备的需求。可以查看以下文档
3、功能调试
进入在线调试,功能调试分为两方面,一方面是调试app的功能,另一方面是调试硬件设备。对于app的调试,机智云会根据你定义的功能参数自动生成一个虚拟设备,用你的app绑定虚拟设备后就可以模拟真实的设备对app进行调试。
对于硬件设备的调试,机智云提供了Demo App 下载, 可以使用该App调试硬件设备,同时在开发者中心可以查看设备实时日志。
4、发布产品
如果产品准备量产上市,建议申请发布产品。发布后的产品,可以获得更多的增值服务, 以及更稳定、更快的云服务。
四、如何定义数据节点:
1、概述
数据点即设备产品的功能的抽象,用于描述产品功能及其参数。创建数据点后,设备与云端通讯的数据格式即可确定,设备、机智云可以相互识别设备与机智云互联互通的数据。
2、数据点详解
数据点定义基本内容可分为:显示名称,标识名,读写类型,数据类型及备注。
【a】显示名称(开关、温度)
【b】标识名(命名规则遵循标准的开发语言变量名命名规范,支持英文字母、数字和下划线,以英文字母开头)
【c】读写类型(只读、可写、报警、故障)
【d】数据类型(布尔值、枚举、数值、扩展)
【e】备注
【f】分辨率、增量换算(公式是:y=kx+m, 显示值==传输值x分辨率+增量)
3、数据点创建步骤
【a】分析硬件需求
【b】定义数据点
【c】创建数据点:个人项目 —》 数据点 —》 新建数据点 —》 添加数据点
【d】修改数据点
五、机智云接入后体验:
1、安装机智云调试App
2、启动虚拟设备
【a】进入开发者中心,点击左上角选择栏,选择《机智云实验室》
【b】选择一个智能硬件产品,即虚拟设备
【c】启动虚拟设备
3、使用机智云调试APP绑定虚拟设备
【a】点击“调试提示”功能内的红框“显示二维码”来显示虚拟设备二维码
【b】手机登陆机智云调试APP并绑定设备
【c】机智云调试APP控制虚拟设备
4、虚拟设备上报数据到机智云调试APP
六、机智云名词定义:
1、云端名词定义
【a】Product Key:产品标识码
【b】Product Secret:产品密钥
【c】DID:设备号
【d】AppID:应用标识码
【e】App Secret:应用密钥
【f】小循环:智能设备与手机、智能设备与智能设备之间,通过连接同一个路由器实现局域网内部的通信(查看状态或控制)。
【g】大循环:智能设备通过路由器或直接接入互联网以实现用户的远程监测与控制。
2、设备端名词定义
【a】Gagent:全称Gizwits Agent,运行于Wi-Fi模块中,设备通过GAgent接入机智云服务器。
【b】PassCode:设备通行证,用于校验用户的绑定/控制权限。
【c】Onboarding:也叫配置入网,用户将一款基于Wi-Fi的物联网设备配置连接上路由器的过程称为Onboarding。
【d】Station模式:类似于无线终端,sta本身并不接受无线的接入,它可以连接到AP,一般无线网卡即工作在该模式。
【e】AP模式:Access Point,提供无线接入服务,允许其它无线设备接入,提供数据访问,一般的无线路由/网桥工作在该模式下。
【f】AirLink:机智云对各种SmartConfig、SmartLink这种UDP广播报方式对设备配置入网的技术统称,兼容了多个Wi-Fi模块厂商的配置协议,总结了一套良好用户体验的标准Onboarding操作流程,机智云的Wi-Fi 设备接入SDK已经内置AirLink技术。
【g】SoftAP:由于目前各个Wi-Fi模块厂商的Smart Config协议均未完全成熟,也不支持5G路由器信号。机智云在提供了AirLink配置模式的同时也支持SoftAP模式配置设备接入路由器。
七、机智云源码说明:
1、概述:自动生成 APP 代码集成了用户注册、登陆、密码重置、设备入网配置、设备发现、设备绑定与解绑、设备控制等物联网控制 APP 的常用功能,并集成了第三方登陆和消息推送等可配置的功能,开发者可以通过在配置文件中配置来选择性地使用这些功能。(App框架:用户部分、设备部分、消息推送)
2、部署源码并控制虚拟设备
【1】部署源码到手机上
【2】启动虚拟设备
【3】扫码控制虚拟设备
3、源码说明之iOS目录结构
【1】Library(库模块):第三方框架和机智云SDK
【2】GOpenSourceModules(组成模块):开源框架和资源
【3】GOpenSourceAppkit(工程模块):主要工程
【4】Products(ipa包模块):ipa
4、App文件配置
【1】appInfo: 主要用来设置APP连接的域名,机智云上申请的应用信息,产品信息,QQ、微信以及第三方推送申请到的 appId 和 appSecret 等信息。
【2】templateSelect,这块主要是用来配置设备列表界面的。
【3】functionConfig,主要作用,设置各个功能模块是要启动还是关闭。
【4】viewConfig,设置界面的背景风格
5、第三方登录
【1】查看文档
http://docs.gizwits.com/zh-cn/AppDev/third-party.html
【2】appConfig.json 文件中配置
【3】配置URL Schemes
QQ登录接入
【1】查看文档
http://docs.gizwits.com/zh-cn/AppDev/third-party.html
【2】appConfig.json 文件中配置
【3】配置URL Schemes
6、消息推送
【1】极光推送
【2】百度推送
网友评论