开发文档
平台公告
常见问题
硬件接入
开放平台
-
开放平台服务介绍
-
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上的电机进行控制。
- 第五步:开始您的智能硬件开发之旅
机智云¶
机智云(Gizwits)是国内第一个专门为智能硬件提供后台支持的云服务平台。成立于2010年,已为过百家国内外智能硬件开发商累计超过200万台设备提供云服务。2014.9月发布机智云2.0,为国内开发者以及企业团队提供智能硬件自助开发及设备云服务。
GAgent¶
全称Gizwits Agent,运行于Wi-Fi模块中,设备通过GAgent接入机智云服务器。目前已兼容国内主流的Wi-Fi模块,开发者也可以通过获取GAgent二次开发包实现自定义的模块接入机智云。
小循环¶
智能设备与手机、智能设备与智能设备之间,通过连接同一个路由器实现局域网内部的通信(查看状态或控制),我们称之为小循环。
大循环¶
智能设备通过路由器或直接接入互联网以实现用户的远程监测与控制,我们称为大循环。
Productkey¶
产品标识码,开发者通过机智云后台创建新产品后,自动生成的一个32位字符串。在机智云的数据库中是一个唯一的号码,开发者完成开发写入设备主控MCU后,机智云通过此标识码对设备进行识别并自动完成注册。
did¶
设备号,当一个设备初次接入机智云时,机智云自动根据Productkey以及设备Wi-Fi模块MAC地址为此设备注册一个did,此did全网唯一,用于与用户的绑定及后续操作。
passcode¶
设备通行证,用于校验用户的绑定/控制权限。当用户发起设备绑定时,只要是合法操作即可拿到此通行证,通过此通行证绑定设备并对设备进行有效期内的查看、控制等操作。GAgent首次运行时生成随机数作为设备通行证,生成后保存在非易失性存储器上。设备上线时需要上报给服务器。
AppID¶
应用标识码,当开发者需要为一款智能产品开发应用(包括iOS、Android、Web应用等)时,后台会自动生成一个AppID,并与此设备进行关联。应用开发时需要填入此AppID。
Onboarding¶
用户将一款基于Wi-Fi的物联网设备配置连接上路由器的过程称为Onboarding。新设备第一次使用时需要知道路由器的账号和密码,以通过路由器连接互联网。由于大多数的物联网设备没有自带的屏幕和键盘,所以需要通过智能手机向设备发送路由器的SSID和密码,这个过程机智云称为Onboarding。机智云提供的Wi-Fi设备接入SDK中已经内置了此配置的功能。
AirLink¶
机智云推出的实现Onboarding的一套技术名称,兼容了多个Wi-Fi模块厂商的Smart-Config协议以及一套良好用户体验的标准Onboarding操作流程,机智云的Wi-Fi设备接入SDK已经内置AirLink技术。
SoftAP¶
由于目前各个Wi-Fi模块厂商的Smart-Config协议均未完全成熟,也不支持5G路由器信号。机智云在提供了AirLink配置模式的同时也支持SoftAP模式配置设备接入路由器。当设备进入SoftAP配置模式时,设备本身将成为一个AP,智能手机可直接与设备进行连接,然后在手机上的界面上输入路由器的SSID和密码,设备接收到信息的时候会自动尝试连接路由器,连接成功则自动切换到正常使用的模式。