开发文档
平台公告
常见问题
硬件接入
开放平台
-
开放平台服务介绍
-
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上的电机进行控制。
- 第五步:开始您的智能硬件开发之旅
第一步:将 GizAnalyticsBT导入到你的工程中¶
将GizAnalyticsBT添加到您的工程中,(GizAnalyticsBT的添加及引用过程参考以上)
第二步:添加依赖框架¶
添加 sqlite3.dylib 到您的工程中 。
第三步:方法调用¶
一、在- (BOOL)application: didFinishLaunchingWithOptions:方法中调用initWithAppKey方法来初始化GizAnalytics:¶
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [[GizAnalytics sharedInstance] initWithAppKey:@"YOUR_APP_KEY"]; //参数为机智云官网中添加应用后得到的AppKey //…… return YES; }
二、在负责蓝牙处理的类.h文件里添加EASession的属性¶
@property (strong, nonatomic) EASession *session;
三、在搜索到设备的类,将连接设备相应的EAAccessory,ProtocolString传入到负责蓝牙处理类.m文件自定义的初始化方法中:(初始化方法仅供参考,可视项目实际情况而定)¶
-(id)initAccessory:(EAAccessory *)accessory_ withProtocol:(NSString *)protocol{ if (self = [super init]) { self.accessory = accessory_; self.session = [GizAnalytics createSessionWithAccessoryDelegate:self streamDelegate:self Accessory:accessory_ Protocol:protocol]; } return self; }
四、当断开连接时调用¶
- (void)viewWillDisappear:(BOOL)animated { [[GizAnalytics sharedInstance] closeSession]; _accessory = nil; }