[GoKit资料]

8266程序移植：实现联网机智云

2016-12-7 10:56:14 6345

本帖最后由机智小编于 2016-12-7 11:53 编辑

原文：GoKit3 8266版程序移植开发（非代码自动生成方式）
之前使用Gokit3做了一些小项目（完全基于官方提供的程序Demo修改的），现在机智云又推出了“云端代码自动生成工具”，这对开发者来说真是方便了不少，但感觉太依赖自动生成的代码会降低对代码的深入理解，并且在一些情况下：例如已经使用了一次代码自动生成工具，进行了一部分开发，后来又修改了云端数据点，这时就不想再自动生成一次了，因为会影响之前的修改的代码，这时就想用“纯移植的方式”开发了。

故总结了一下之前的开发经验，使用纯移植的方式来讲讲如何进行Gokit的二次开发。

文章写得正式了些，还请各位海涵

1. 前序1.1 总介绍

本文基于Gokit3(S)上的二次开发，开发前需了解：

1) GoKit3(S) 基础版教学课程。

2) GoKit3(S) 开发环境搭建教学课程。

本文将以“植物宝”的开发为例来介绍如何在原有代码基础上完成二次开发。

1.2 相关介绍

1) 什么是植物宝？

“植物宝”是用来监控植物所处的环境，并能控制电机吹风，相关数据点定义：

数据点	数据点类型
控制电机定速转动	可写、布尔型
读取环境温度	只读、数值型
读取环境湿度	只读、数值型
读取土壤湿度	只读、数值型

2) GoKit3(S)源码程序下载地址在哪？

http://site.gizwits.com/zh-cn/developer/resource/hardware?type=GoKit

3) GoKit3(S)的二次开发的顺序是什么样的？

a. 云端定义产品数据点。

b. 查看产品的《机智云接入串口通信协议文档》

c. 根据通信协议修改源码程序。

d. 使用串口日志来调试修改程序。

2. 编辑数据点

1)在云端定义产品：植物宝

选择个人项目、点击硬件接入、创建新产品

2)输入自己的产品信息

注：

此示例产品名称示例为“my_plants”，开发者可自定名称。

3)选择手动定义数据点，新建数据点

4)定义电机功能

5)定义室内温度

6)定义室内湿度

7)定义土壤湿度

8)完成定义，选择下一步、下一步、完成

9)下载通信协议文档

在“产品管理”的“产品开发资源”中下载对应的通信协议文档（《my_plants-机智云接入串口通信协议文档》）。

3. 修改程序3.1 修改程序PK

修改代码位置：

appGizwitsgizwits_protocol.h 中的宏定义：PRODUCT_KEY

解释：

PK的作用是将开发者在云端定义的产品与Gokit上运行的程序联系起来。

修改：

注：

1. 将程序中的”your_product_key”替换为云端的PK

2. 程序中的PK保留英文型双引号

3.2 修改数据结构3.2.1 控制型协议数据结构修改

修改代码位置：

appGizwitsgizwits_protocol.h 中的gizwits_attr_flags、gizwits_attr_vals结构体。

解释：

结构体gizwits_attr_flags、gizwits_attr_vals分别对应《通信协议文档》中的“4.10 WiFi模组控制设备”中的：attr_flags(1B) + attr_vals(6B)位：

程序修改：

根据协议文档“4.10 WiFi模组控制设备”中的相关说明修改相应程序：

特别说明：

1) 位段使用说明

uint8_t motor_switch:1; 是一种位段的使用方式。因为 uint8_t型数据占用 8bit（8位）的空间，协议中motor_switch占用字段bit0（第一位）所以uint8_t motor_switch:1表示使用1位的空间。

uint8_t reserve:7;因为程序中申请内存时的最小单位是byte(字节)，而这里我们是按bit(位，8bit = 1byte)进行了使用，故需补齐不足1byte的剩余bit(使用n bit后需补齐剩余的8-n bit)，否则会造成数据读写错误。

3.2.2 上报型协议数据结构修改

修改代码位置：

appGizwitsgizwits_protocol.h 中的dev_status_t结构体。

解释：

对应《机智云设备串口通讯协议》中“4.9 设备MCU向WiFi模组主动上报当前状态”中的：dev_status(11B) 位：

[size=10.5000pt]

程序修改：

根据协议文档“4.9 设备MCU向WiFi模组主动上报当前状态”中的修改相应程序：

[size=10.5000pt]

[size=10.5000pt]

修改相应程序：

3.2.3 枚举事件修改

代码位置：

appGizwitsgizwits_protocol.h 中 EVENT_TYPE_T 枚举结构：

[size=10.5000pt]

说明：

在该枚举结构中定义写类型枚举事件。

程序修改：

根据协议文档“4.10 WiFi模组控制设备”定义写类型数据点枚举事件（电机控制为例）：

3.2.3 宏定义修改

代码位置：

appGizwitsgizwits_protocol.h 中 “数据点相关定义”部分：

[size=10.5000pt]

说明：

根据“数值型”数据点的“分辨率、增量”的值添加对应的宏定义（会在之后的数据转换中用到）。

代码修改：

根据云端定义的数值型数据点：

[size=10.5000pt]

添加相应的宏定义

3.3 修改“可写类型”相关代码

与控制型协议相关的函数调用关系如下：

函数调用说明：

函数	说明
giziIssuedProcess	该函数被gagent调用，接收来自云端或app端下发的相关协议数据
ACtiON_CONTROL_DEVICE	进行“控制型协议”的相关处理
dataPoint2Event	根据协议生成“控制型事件”
gizEventProcess	根据已生成的“控制型事件”进行相应处理（包括相应的驱动函数）

3.3.1 写类型事件的生成

相关代码:

appGizwitsgizwits_product.c 中 gizEventProcess() 函数：

功能说明：

获取可写型外设的数据状态，并转化为对应的上报型协议数据。

程序修改：

将可写类型的数据转化为文档“4.9 设备MCU向WiFi模组主动上报当前状态”中设备状态(dev_status)所对应的上报数据格式（电机为例）：

3.5 配置入网相关程序

代码工程默认使用按键检测进入相应的配置模式，分别是：

1) 短按key2键进入：SoftAp配置模式

2) 长按key2键进入：AirLink配置模式

代码位置：

appuseruser_main.c

AirLink模式接口代码:

gizSetMode(2);

SoftAp模式接口代码:

gizSetMode(1);

注：

开发者可以调用对应模式的接口代码实现自定义的配置入网操作。

3.6 外设驱动相关代码
3.6.1 外设驱动介绍

1) 驱动代码存放位置：

appdriver

说明：

相关外设的驱动代码以 ‘.c’ 的型式存放于此处，每个 ‘.c’ 文件实现了一种外设驱动功能，用户可以调用对应驱动接口函数实现相应的功能。Gokit3(S) 提供的默认外设，即相关接口函数有：

外设硬件名称	接口函数说明
hal_motor.c	motorInit() 初始化电机控制 motorControl(0 )表示电机关闭 motorControl(-5~0) 表示电机正传 motorControl(0~5) 表示电机反转
hal_rgb_led.c	rgbGpioIni() 初始化RGB LEDt rgbControl(1~255,0,0) 表示亮红灯 rgbControl(0,1~255,0) 表示亮绿灯 rgbControl(0,0,1~255) 表示亮蓝灯
hal_infrared.c	irInit() 初始化红外传感器 irUpdateStatus() 获取红外状态
hal_temp_hum.c	dh11Init() 初始化温湿度传感器 dh11Read() 获取温湿度传感器数值
hal_key.c	keyParaInit() 按键初始化 keyStateRead() 获取按键按当前状态