基于ST和机智云的 I-CUBE-GizWits 使用指南（一）

顾名思义，I-cube-gizwits软件包是STM32 Cube的扩展软件包，基于STM32 Cube HAL库，可运行在基于ARM Cortex-M处理器的STM32微控制器上。具有以下特点优势：

1. 基于STM32 Cube，图形化操作，能够快速配置MCU外设，以及工程配置，提高开发效率。

2. 支持导出多个格式的工程：

3. IAR Embedded Workbench for ARM ;

4. KEIL uVision;

5. System Workbench for STM32;

6. 采用平台无关API，MCU/WIFI芯片平台切换成本低；

7. 嵌入式机智云GAgent联网服务，自动完成了联网功能，能够快速玩转机智云物联网云平台；

I-cube-gizwits软件包嵌入了机智云的GAgent，设备可以通过GAgent访问机智云云平台。GAgent主要的作用是数据转发，是设备数据、机智云、应用端（APP）的数据交互桥梁。GAgent提供了机智云云平台与单片机之间的通信协议，开发者可以根据该协议实现MCU与GAgent之间的通信。

[ 准备工作 ]

言归正传，在了解I-cube-gizwits后，接下来开始进入实践开发。

在开发前，需要准备和了解以下内容

1）.硬件

1）B-L475E-IOT01A2开发板

2）Micro USB线

2）. 软件：

下面三种开发工具任选其一：
1） IAR Embedded Workbench for ARM
2） KEIL uVision5
3） System Workbench for STM32

3）. 其他：

1）机智云开发者账号：用于产品接入、设备管理、OTA服务、MCU开发等的功能使用。
2）I-cube-gizwits固件包

4）. 了解：

I-cube-gizwits固件包文件夹结构简介：

[ 开始开发 ]

现在进入开发阶段，由于篇幅过长，将分成以下几部分讲解：

1. 在机智云自助开发平台创建产品
   

2. Gagent API详解

3. 项目源码修改
   

4. OTA升级实现
   

5. FAQ

1、在机智云自助开发平台创建产品

登录机智云自助开发平台 dev.gizwits.com，新建一个“产品”（假设本次项目为GizTest），并创建云端“数据点”（即设备产品的功能的抽象，用于描述产品功能及其参数。创建数据点后，设备与云端通讯的数据格式即可确定，设备、机智云可以相互识别设备与机智云互联互通的数据）。

以本次的项目“GizTest”为例，简单描述一下云端数据点和产品的功能点的关系，本次的项目“GizTest”，它需要实现的功能是：

（1） 获取开发板陀螺仪X、Y、Z轴数值；
（2） 获取开发板相对湿度和温度传感器数值；
（3） 获取开发板LED的状态以及控制LED开关；

那我们需要在云端建立对应的数据点，如下图。

下表是所有数据点的具体设置：

添加数据点完成之后点击“应用”，完成整个产品的数据点的新建工作。

2、 GAgent API的几个重要参数

gagent_soc.h文件中API

（1）gagent_soc.h文件内容预览

（2）API功能简介
1）gagentInit

• 功能：gagent相关参数初始化

• 函数定义：void gagentInit(struct devAttrs attrs)

• 参数：struct devAttrs attrs ：对应初始化参数的结构体

• 返回：无

2）gagentUploadData

• 功能：上传数据到客户端

• 函数定义：
  int32 gagentUploadData(uint8 szDID, uint8 src, uint32 len,uint8 flag, void *arg,gagentUploadDataCb fun )

• 参数：

• 返回：
  GAT_OK 0 成功
  GAT_ERR_FAIL -1 失败

  3）gagentGetNTP

• 功能：获取NTP时间

• 函数定义：void gagentGetNTP(_tm *time)

• 参数：

• 返回：无

4）gagentReset

• 功能：重置模组，会清除配置信息和解除用户与之间的关系，该函数会导致模组重启

• 函数定义：void gagentReset(void)

• 参数：无

• 返回：无

  
  

↓↓↓点击阅读原文，了解更多设计资源