开发文档
平台公告
常见问题
硬件接入
开放平台
-
开放平台服务介绍
-
iOS SDK 集成指南
-
Android SDK 集成指南
-
蓝牙接入iOS SDK集成指南
-
蓝牙接入Android SDK集成指南
-
Websocket API 指南
-
Open API
- 微信硬件接入指南
-
APICloud开发接入文档
统计分析
Gokit开发套件
- GoKit介绍
-
GoKit上手指南
- GoKit 2 开箱
- 第一步:下载 IoE Demo App
- 第二步:将GoKit连接上网
- GoKit通过WiFi通信模块以无线的方式连接路由器并接入互联网,这里我们需要做的就是把可用WiFi的路由器SSID和密码告诉GoKit(就像你新买的手机需要输入家里的WiFi密码一样),但GoKit没有键盘和屏幕,如何做到呢?GoKit提供三种配置方式:AirLink 、WebConfig、 SoftAP。下面我们分别学习三种不同的配置方式,大家人选一种即可。
- AirLink配置入网
- AirLink配置就是说明书上介绍的方法,实现过程就是:通过按键触发开启设备“AirLink”模式,开启后设备会不断接收特定编码的WiFi广播包,手机连接可用的WiFi网络后,通过指定的App(如IoE Demo)发送编码后的WiFi网络的SSID和密码广播,设备接收到之后自动尝试连接此WiFi网络,连接成功即配置完成。下面一步步完成GoKit通过AirLink接入路由器连接网络吧。(注意:AirLink配置不支持5G的WiFi网络,请使用传统2.4G WiFi信号)
- 1.智能手机进入“系统设置”连接您附件可用的WiFi网络。
- 2.打开下载好的“IoE Demo” App,点击主屏幕右上角“菜单栏”中的“添加新设备”。如下图
- 3.使用USB线为GoKit供电,开机后长按[KEY2]直到[RGB LED]亮绿灯(Arduino版本GoKit短按[KEY2]),表示设备AirLink模式已经开启。如下图
- 4.IoE Demo APP上输入已连接WiFi的密码,点击配置按钮,等待30秒到一分钟,APP提示配置成功。在此期间,您可以看到GoKit的绿灯熄灭,WiFi模组两个指示灯瞬间熄灭,直到指示灯开始交叉闪烁,这表示GoKit已经连上路由器,配置完成。
- SoftAP配置入网
- 由于AirLink配置方式有一定的技术限制,GoKit支持另一种配置方式——SoftAP,实现过程就是将GoKit上的WiFi模组切换到AP模式,手机直接与GoKit连接,并将可用的WiFi网络SSID和密码发送给GoKit,GoKit接收到配置信息后自动尝试连接路由器。具体步骤如下:
- 1.GoKit正常供电情况下,长按[KEY1]直到[RGB LED]亮红灯(Arduino底板[RGB LED]蓝色闪一下),表示GoKit已经初始化。而GoKit在初始状态下将自动进入“SoftAP”模式。
- 2.手机进入“系统设置”中的“WiFi设置”,找到“XPG-GAgent-XXXX”(XXXX是你的GoKit MAC地址后4位)并连接此WiFi网络,如需密码请输入:123456789 。
- 3.打开“IoE Demo” App,此时App会自动进入SoftAP配置模式,选择或手动输入你附近的可用WiFi网络SSIS及密码,点击“确定”。
- 4.等待30秒到一分钟,当GoKit上WiFi模组的指示灯交叉闪烁时,表示配置完成。
- Web Config配置模式
- Web Config是SoftAP配置模式的一种升级,解决了智能硬件配置上网对独立专用App的依赖问题。实现原理与SoftAP类似,但直接使用手机自带的浏览器即可配置。具体步骤如下:
- 1.GoKit正常供电情况下,长按[KEY1]直到[RGB LED]亮红灯(Arduino底板[RGB LED]蓝色闪一下),表示GoKit已经初始化,而GoKit在初始状态下将自动进入“SoftAP”模式。
- 2.手机进入“系统设置”中的“WiFi设置”,找到“XPG-GAgent-XXXX”(XXXX是你的GoKit MAC地址后4位)并连接此WiFi网络,如需密码请输入:123456789 。
- 3.打开手机浏览器,并在地址栏输入“10.10.100.254”即可访问GoKit配置页面,根据提示输入可用WiFi网络SSID及密码,点击配置。
- 4.等待30秒到一分钟,当GoKit上WiFi模组的指示灯交叉闪烁时,表示配置完成。
- 第三步:使用IoE Demo控制GoKit
- 第四步:使用微信控制GoKit
- 微信从5.x版本开始,支持服务号设备功能。通过微信扫描设备二维码关注设备公众号后即可以实现对设备的控制。机智云作为微信设备号首批技术合作伙伴,在GoKit上也加入微信控制的功能,而GoKit也是目前世界上唯一一款开通了服务好设备功能的智能硬件开发板。使用微信控制GoKit具体步骤如下:
- 1.打开GoKit附带的说明书,找到一张白色二维码(此二维码每台设备唯一,请注意保管)。如图:
- 2.打开微信扫描说明书上的二维码,点击“关注”并进入公众号。
- 3.点击“窝窝”,公众号将返回你绑定的设备列表。点击进入设备主界面,如图
- 4.在此界面上你可以看到宠物屋(GoKit)当前的状态,并可以通过点击“送风”或“抽湿”对GoKit上的电机进行控制。
- 第五步:开始您的智能硬件开发之旅
一、成为机智云开发者¶
在使用机智服务前,你需要通过site.gizwits.com 注册一个开发者账号。请完整填写你的注册信息。
二、创建第一个新设备¶
1、设备列表页点击[新设备接入]按钮,按提示填写设备基本信息:
2、点击[确定]进入“新设备接入向导”.
三、使用向导完成设备配置¶
第一步,编辑设备数据点。¶
方法一:使用方案模板创建生成设备数据点,你可以从模板列表中选择与新设备类似的方案模板,点击查看方案模板详细数据点列表。点击“应用此模板”即可将模板数据点应用到新的设备,可以继续对数据点进行编辑、添加或删除。
方法二:手动编辑设备数据点,如果没有合适的模板,你可以根据新设备功能逐个进行数据点的编辑。点击“添加数据点”,按要求填写数据点信息。完成后点击“添加”,系统将为你的设备创建第一个数据点。你可以继续对数据点进行微调。
第二步:开发硬件功能:¶
根据上一步添加的设备数据点,自动生成了协议文档开发指南,硬件开发人员只需按照文档指示即可轻松完成硬件功能的开发。
第三步:开始调试你的新设备。¶
1、机智云根据设备数据点,云端自动生成此设备页面,只需安装并运行Demo App,登录后即可与新设备进行交互。
2、如果设备未完成开发,可以使用机智云提供的虚拟设备进行功能的调试。
完成并退出向导¶
至此,你已经完成了一款智能设备的接入,接下来你将进入此设备页面,你可以直接申请发布,也可以继续编辑、查看或调试设备。
四、修改、查看设备信息¶
设备信息编辑:¶
设备正式上线之前,你都可以对设备信息进行修改。
设备识别码是你的新设备在机智云中的唯一标识,由系统自动生成,无法更改。
数据点编辑:¶
在你添加新设备时添加的设备数据点,你可以继续添加、编辑或删除。也可以将此设备的数据点方案另存为模板,在开发同类型设备时可重复使用。
每次修改数据点之后,必须点击应用,修改的数据点才会生效
虚拟设备¶
点击“启动设备”,虚拟设备启动后将自动与设备服务器连接,并等待用户绑定。
打开机智云Demo App,进入App设备列表页面,使用菜单中的二维码扫描,扫描后App将与设备绑定,设备列表出现新设备,点击即可开始查看或控制虚拟设备状态。
运行记录¶
通过运行记录页面,可查看基础的设备(包含虚拟设备)数据统计,包括当前在线的设备数、累计上线设备数以及故障设备数。所有有连接记录的设备都可以查看实时或历史的运行记录数据。
点击每台设备“查看运行状态”,可查看所有的设备数据点运行状态。
开发资源下载¶
当完成了设备数据点编辑后,可下载对应的SDK集成到已完成界面设计的移动应用,即可实现设备的控制。同时也可以直接下载并安装Demo App,登录后即可对连接并查看、控制设备。
五、申请发布¶
当你完成了一款设备的开发和设计并且开始准备要量产上市,你需要向机智云发起申请。机智将免费为你提供人工审核以及严谨的测试,审核通过后,机智云会根据你提交的量产计划免费提供后台服务器支持。
按要求填写发布申请表单,提交申请后寄送设备样品,我们会在5~7个工作日完成审核工作。
寻求帮助¶
有任何问题或需要技术支持,欢迎随时与我们取得联系。