Gokit1介绍、资料分享

sept · 发表于 2016-8-12 13:03:30

基于gokit 1的产品开发指导

基于GoKit1 的产品开发指导 (1).rar (230.11 KB, 下载次数: 51)

目录：

1. 开发GoKit..................................................................................................................................... 1

1.1. 开发过程（思路）..................................................................................................................... 1

1.2. 了解GoKit................................................................................................................................. 1

1.3. 定义新产品............................................................................................................................... 1

1.4. 选择产品模板............................................................................................................................ 1

1.5. 调整产品参数............................................................................................................................ 2

1.6. 生成MCU协议........................................................................................................................... 3

1.7. 生成虚拟设备............................................................................................................................ 3

1.8. GoKit工程与调试....................................................................................................................... 4

1.9. 协议细节................................................................................................................................... 4

1.9.1. WIFI模块获取MCU基本信息................................................................................................ 4

1.9.2. WIFI读取MCU属性............................................................................................................. 5

1.9.3. 设定LED的R值................................................................................................................... 5

1.9.4. 设定LED的G值................................................................................................................... 6

1.9.5. 设定电机转速...................................................................................................................... 7

1.9.6. MCU主动上报状态............................................................................................................... 7

2. 以GoKit为例，开发新产品........................................................................................................... 8

sept · 发表于 2016-8-12 13:04:47

GoKit1上手指南

您需要了解的还有这些：

WiFi通讯模组可以负责和云端以及手机APP的数据通讯，不限定模组厂商，目前可以和市面上很多模组兼容，比如庆科、汉枫、新岸线、君正、思存……。
温湿度传感器、电机、LED灯、红外传感器，这些都是GoKit的板载外设。
也可以通过扩展接口进行功能的扩展。
使用ULink或者Jlink可以对GoKit进行二次开发。
按钮的定义如下表：

按键触发功能
Reset短按将GoKit板载的MCU复位
Key1长按（4秒）将WiFi模组复位，复位后，模组处于SoftAP模式
Key2在长按Key1后短按Key2将WiFi模组处于快连配置状态
Key3短按触发LED和电机故障
Key3长按（4秒）触发报警1
Key4短按触发温湿度传感器故障和红外传感器故障
Key4长按（4秒）触发报警2关于说明书

说明书上含有两个二维码，印刷在说明书上的二维码是GoKit对应的APP的下载链接，如下图：

贴在说明书上的二维码可以将您的GoKit和微信账号绑定：

下载APP扫描说明书上的二维码就可以下载APP，参见2.2，我们提供了Android和iOS两个版本，您也可以在http://www.gizwits.com/注册我们的开发者账号，定义产品后，在产品的开发资源中下载APP。
将您的GoKit连接到您的路由器OK，现在您已经拿到了GoKit，已经下载了APP，那么接下来的一步，就是将您的GoKit连接到您的路由器上去，如何做到呢？GoKit提供三种配置入网方式：AirLink 、WebConfig、 SoftAP。
AirLink配置入网

GoKit供电，打开电源开关（如图一），手机连接您的路由器，可以上外网；

2.打开APP，启动IOE Demo，如果您的APP未使用过，您的APP应该不会显示任何设备（如图二）；
3.点击此界面的右上菜单，点击添加设备（如图三），输入您的路由器密码（如图四）；

4.按下面的方法打开GoKit的AirLink配置模式（如图五）：
i. 长按Key1键4秒，LED灯快速闪一次蓝色，此时，模组上的指示灯会熄灭瞬间再点亮；ii. 等模组上的指示灯再次点亮后，短按Key2键，LED亮绿色，同时模组灯闪烁；

5.在APP上点击配置按钮，等待30秒到一分钟，APP就可以提示配置成功（如图六），在此期间，您可以看到GoKit的绿灯熄灭，模组两个灯瞬间熄灭，一直到模组的指示灯交叉闪烁，这表示模组自动重启成功。
Web Config配置模式此方法适用于微信服务号类的应用，可以不适用任何APP，用一个普通浏览器就可以登陆到模组并进行配置，部分GoKit需要升级模组程序才能支持这个功能，具体方法如下。

长按Key1键4秒，LED灯快速闪一次蓝色，此时，模组上的指示灯会熄灭瞬间再点亮；
手机在系统设置里，连接形如“XPG-GAgent”或者“XPG-GAgent-XXXX”的WiFi热点（XXXX是WiFi模组的MAC后四位，新版模组程序支持），密码：123456789（如图七和图八）；

3.连接热点成功后，打开浏览器，输入10.10.100.254，登陆到WiFi模组的配置页面（如图九），密码发送成功后，提示配置成功（如图十）；
4.成功后，也会看到模组的指示灯状态为交替闪；

SoftAP配置入网

按Web Config的配置方式，做到第2步，也就是让手机连接到GoKit的WiFi热点；
打开APP，按照APP的提示选择或者输入您的路由器和密码，确认即可（如图十一）；
成功后，也会看到模组的指示灯状态为交替闪；

让GoKit亮起来

设备配置成功后，默认在发现新设备列表，并且未绑定（如图十二）；
点击设备，自动绑定成功，此时设备进入可操作设备列表（如图十三）；

3.点击设备，进入设备的操作页面（如图十四和图十五），在此页面，您可以对GoKit进行各种控制，也可以收到GoKit跟您返回的各种状态。

4.需要注意的几点是：
i. 如果您在设定LED组合颜色中，选择了自定义，您可以分别设定R、G、B的颜色；ii. 如果您在设定LED组合颜色中，选择了具体的颜色，您就不可以再对R、G、B进行设置；iii. 红外探测和报警以及故障，都是在GoKit上进行触发，在APP上显示，您可以短按或者长按Key3或者Key4键，来模拟一些故障和报警；iv. 测试红外时，您可以将红外探测阻挡（离传感器3厘米左右），然后APP就会收到被阻挡的信号，红外探测的状态随即会被更改；
即使GoKit不在身边依然近在咫尺GoKit天生支持远程连接，您可以将您的手机切换成2G、3G、4G，然后打开软件，您的GoKit依然存在，点击设备后就如同本地操作一样，唯一不同的就是目前的连接方式是远程连接。

sept · 发表于 2016-8-12 13:07:05

GoKit1硬件原理图

产品简介

1) GoKit是一款面向机智云智能硬件开发者量身定做的开发套件，开发者可以注册后免费获取，从而快速完成产品模型开发及验证。

2) GoKit板载一个STM32 MCU、一颗全彩LED、一颗正反转电机、一个温湿度传感器、一个红外探测传感器，这些外设可以代表或者模拟目前大部分的智能硬件功能。

3) GoKit可以与市面上流行的wifi模块通讯，结合机智云发布的M2M以及SDK，可以快速完成智能硬件的发现、配置、连接、管理。

4) 微信宠物屋，是以GoKit开发板为硬件载体，设计而来的一款应用产品，包含了对LED灯的控制、电机控制、温湿度的显示、红外探测结果显示、报警和故障显示，具体的微信宠物屋功能请参见文档《宠物屋产品设备端开发指南.pdf》。微信宠物屋是一个示例项目，开源所有文件，各开发者可以参考此项目进行产品定义、协议制定、代码编写。具体的文档说明，http://club.gizwits.com/forum.ph ... d=36&extra=page%3D1

5) 开发者可以方便的套用机智云提供的解决方案：在网站上定义产品功能、自动生成虚拟设备和测试工具、自动生成开发协议文档、自动生成相关产品MCU代码和示例、可以连接云端进行远程设备管理…更多信息可以访问我们的开发者网站www.gizwits.com。

功能规格

名称	型号	功能
供电电压、电流	5V、0.5A	USB供电
MCU	STM32F103C8T6	与wifi模块
LED	RGB全彩色	任意控制LED的颜色和亮度
电机	可调转速、正反转	可模拟电动窗帘、洗衣机等应用场景
温湿度传感器	DHT11	获取温度和湿度，采集值需要根据本地环境做适当修正
红外探测器	直插式对管探测器	在10厘米内探测有无阻挡
JTAG	20 pin直插	可以试用ULink或者JLink对MCU进行编程
USB调试	CP2102	USB连接PC，并将MCU和USB的通讯连接后，可以用PC与MCU进行串口通讯

更多原理图请看附件。

Gokit 1硬件功能概览 V1.0.rar (551.36 KB, 下载次数: 29)

GoKit1 硬件原理图.pdf (439.36 KB, 下载次数: 26)

boboP · 发表于 2016-8-12 14:20:21

好东西。顶一个！