收藏官网首页
查看: 622|回复: 0

[分享] 毕业设计攻略 | 机智云平台的应用指南

64

主题

72

帖子

2648

积分

金牌会员

Rank: 6Rank: 6

积分
2648
 楼主| 发表于 2024-1-26 11:44:48 | 显示全部楼层 |阅读模式
注册成为机智云开发者,手机加虚拟设备快速开发
毕业设计攻略 | 机智云平台的应用指南


机智云官网

https://www.gizwits.com/

登录或者注册登录云平台

进入开发者中心

1.png

创建智能产品

2.png

选择合适的方案类型

我这里选择自定义方案

3.png

自定义方案创建一个产品(WiFi单品)
4.png


定义自己需要的数据点(彩灯为例)
5.png


下载自己手机上使用的调试APP
6.png


给自己的WiFi模组刷入官方
1、准备官方的固件
6.png


2、准备烧写软件
esp8266烧写软件非机智云提供

8.png
3、进行烧写
9.png


自动生成代码

选择通用平台,生成代码可移植性更高。

10.png

下载代码&代码移植,参考最新版开发指南适配到自己的平台
11.png






官方移植参考
API 介绍
void gizwitsInit(void)
gizwits 协议初始化接口。
用户调用该接口可以完成 Gizwits 协议相关初始化(包括协议相关定时器、串口的初始化)。
void gizwitsSetMode(uint8_t mode)
参数 mode[in]:WIFI_MODE_TYPE_T 枚举值
参数为 WIFI_RESET_MODE,恢复模组出厂配置接口,调用会清空所有配置参数,恢
复到出厂默认配置。
参数为 WIFI_SOFTAP_MODE 或 WIFI_AIRLINK_MODE,配置模式切换接口,支持SoftAP 和 AirLink 模式。
参数为 WIFI_SOFTAP_MODE 时配置模组进入 SoftAp 模式,
参数为 WIFI_AIRLINK_MODE 配置模组进入 AirLink 模式。
参数为 WIFI_PRODUCTION_TEST,模组进入产测模式。
参 数 为 WIFI_NINABLE_MODE , 模 组 进 入 可 绑 定 模 式 , 可 绑 定 时 间 为
NINABLETIME(gizwits_protocol.h 中**),默认为 0,表示模组永久可绑定。
void gizwitsGetNTP(void)
获取 NTP 时间接口。
用户调用该接口可以获取当前网络时间,MCU 发起请求,模组回复后将产生 WIFI_NTP
事件,用户可在 gizwitsEventProcess 函数中进行相应处理。
void gizwitsHandle(dataPoint_t *dataPoint)
参数 dataPoint[in]:用户设备数据点。
该函数中完成了相应协议数据的处理及数据上报的等相关操作。
int8_t gizwitsEventProcess(eventInfo_t *info, uint8_t *data, uint32_t
len)
参数 info[in]:事件队列
参数 data[in]:数据
参数 len [in]:数据长度
用户数据处理函数,包括 wifi 状态更新事件和控制事件。
a) Wifi 状态更新事件
WIFI_开头的事件为 wifi 状态更新事件,data 参数仅在 WIFI_RSSI 有效,data 值为
RSSI 值,数据类型为 uint8_t,取值范围 0~7。
b) 控制事件
与数据点相关,本版本代码会打印相关事件信息,相关数值也一并打印输出,用户
只需要做命令的具体执行即可。
int32_t gizwitsPassthroughData(uint8_t *data, uint32_t len)
参数 data[in]:数据
参数 len [in]:数据长度
用户调用该接口可以完成私有协议数据的上报。
3 移植
MCU 通用平台版代码对硬件平台的要求:
平台支持两个串口接口(至少一个),一个负责与 wifi 模组间的数据收发(必须),一个用于调试信息打印(可复用数据收发串口)。
平台支持定时器功能(1ms 精确定时)。
平台支持至少 2K 的 RAM 空间(太少会导致数据协议的处理异常)。
自动化代码生成工具已经根据用户定义的产品数据点信息,生成了对应的机智云串口协议层代码,用户需要移植代码到自己的工程中,完成设备的接入工作。

程序结构框图如下:
gizwits 逻辑和程序主流程已经帮用户实现,图中用黄色小注标明的部分待用户实现并完成代码的移植。
用户的移植工作主要分以下几个方面进行。
实现串口 A 驱动
MCU 方案需要用户实现一个串口,用于设备 MCU 与 WIFI 模组之间数据通信。用户首先需要实现串口接收中断服务函数接口 UART_IRQ_FUN(),该接口调用 gizPutData()函数实
现串口数据的接收并且写入协议层数据缓冲区。另外,用户需要实现串口的发送接口,
uartWrite()函数调用该接口实现设备数据的发送。需要特别注意的是 gizwits_product.c 文件
中 uartWrite()函数是伪函数,用户需根据自己实现的串口发送接口完善 uartWrite(),请注意
相关注释信息,以防出错。

下面以 STM32F103C8T6 平台为例,本例使用 USART2 与模组通信,串口初始化不在
此罗列,中断服务函数和串口发送报文函数实现如下:
/**

@brief USART2 串口中断服务函数
接收功能,用于接收与 WiFi 模组间的串口协议数据
@param none * @return none /
void UART_IRQ_FUN(void)
{
uint8_t value = 0;
if(USART_GetITStatus(USART2, USART_IT_RXNE) != RESET)
{
USART_ClearITPendingBit(USART2,USART_IT_RXNE);
value = USART_ReceiveData(USART2);
gizPutData(&value, 1);
}
}
/*
@brief 串口写操作,发送数据报文(报文数据中遇 0xFF 需要用 0x55 转义)到 WiFi 模组
@param buf : 数据地址
@param len : 数据长度
@return : 正确返回有效数据长度;-1,错误返回
/
int32_t uartWrite(uint8_t buf, uint32_t len)
{
uint32_t i = 0;
if(NULL == buf)
{
return -1;
}
for(i=0; i<len; i++)
{
USART_SendData(UART, buf);
while (USART_GetFlagStatus(UART, USART_FLAG_TXE) == RESET);
if(i >=2 && buf == 0xFF)
{
USART_SendData(UART,0x55);
while (USART_GetFlagStatus(UART, USART_FLAG_TXE) == RESET);
}
}
return len;
}
实现定时器
协议层使用到了一个系统时间,该事件单位为毫秒,所以要求用户实现一个毫秒定时器,
并且实现中断服务函数 TIMER_IRQ_FUN(),该函数调用 gizTimerMs()实现协议层系统时间
的维护。
下面以 STM32F103C8T6 平台为例,本例使用 TIM3 实现时间维护,定时器初始化不在
此罗列,中断服务函数实现如下:
/
@brief 定时器 TIM3 中断处理函数
@param none * @return none /
void TIMER_IRQ_FUN(void)
{
if (TIM_GetITStatus(TIMER, TIM_IT_Update) != RESET)
{
TIM_ClearITPendingBit(TIMER, TIM_IT_Update );
gizTimerMs();
}
}
实现芯片复位函数
根据串口协议文档规定,模组可以发送命令复位设备 MCU,所以用户需要实现
mcuRestart()接口完成设备的复位。
下面以 STM32F103C8T6 平台为例,本例使用 TIM3 实现时间维护,定时器初始化不在
此罗列,中断服务函数实现如下:
/*
@brief MCU 复位函数
@param none * @return none /
void mcuRestart(void)
{ __set_FAULTMASK(1);
NVIC_SystemReset();
}
实现串口打印驱动
如果用户需要打印日志调试信息,要求用户实现 printf 函数。协议层将用 GIZWITS_LOG
宏替代 printf,进行相关信息的打印。如果用户不使用日志调试,那么需要将协议层相关日
志打印部分的代码屏蔽掉方可运行。如果用户不使用日志调试,遇到问题请咨询机智云工程
师。
下面以 STM32F103C8T6 平台为例,本例使用 USART1 实现串口打印,串口初始化不
在此罗列,printf 重定向实现如下:
#ifdef GNUC
#define PUTCHAR_PROTOTYPE int __io_putchar(int ch)
#else
#define PUTCHAR_PROTOTYPE int fputc(int ch, FILE f)
#endif
/
@brief printf 打印重定向
@param none * @return none /
PUTCHAR_PROTOTYPE
{
USART_SendData(USART1,(u8)ch);
while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET);
return ch;
}
实现配置入网
模组支持 SoftAp 和 AirLink 两种方式配置入网,相应接口为 gizwitsSetMode(),建议采
用按键的方式,相应的按键动作触发执行具体的模式设置。
另外,可以通过 gizwitsSetMode()接口复位模组,恢复默认出厂设置。
下面以 STM32F103C8T6 平台为例,本例使用按键方式实现配置入网和控制模组复位功
能,按键初始化不在此罗列,按键触发操作实现如下:
/*
key1 按键长按处理
@param none * @return none /
void key1LongPress(void)
{
printf(“KEY1 PRESS LONG ,Wifi Reset\n”);
gizwitsSetMode(WIFI_RESET_MODE);
}
/*
key2 按键短按处理
@param none * @return none /
void key2ShortPress(void)
{
printf(“KEY2 PRESS ,Soft AP mode\n”);
gizwitsSetMode(WIFI_SOFTAP_MODE);
}
/*
key2 按键长按处理
@param none * @return none */
void key2LongPress(void)
{
//AirLink mode
printf(“KEY2 PRESS LONG ,AirLink mode\n”);
gizwitsSetMode(WIFI_AIRLINK_MODE);
}
实现下行动作执行
数 据 点 方 式 将 转 换 成 数 据 点 事 件 , 开 发 者 只 需 要 在 gizwits_product.c 文 件 的
gizwitsEventProcess()相应事件下作具体处理即可。
下面使用 STM32F103C8T6 平台,以微信宠物屋实现 APP 控制电机转动为例,
motorStatus()函数是需要开发者自己实现,其他代码自动化工具会帮助开发者生成,
gizwitsEventProcess()函数省略其他代码段,案例如下:
case EVENT_MOTOR_SPEED:
currentDataPoint.valueMotor_Speed = dataPointPtr->valueMotor_Speed;
GIZWITS_LOG(“Evt:EVENT_MOTOR_SPEED %d\n”,currentDataPoint.valueMotor_Speed);
motorStatus(currentDataPoint.valueMotor_Speed);
break;
实现上行数据采集
该工程代码默认在 Gizwits/gizwits_product.c 文件中 userHandle()函数实现传感器数
据采集,并且该函数在 while 循环执行,原则上用户只需要关心如何采集数据。特别提醒,
默认 while 循环执行速度较快,需要针对不同的需求,用户可调整数据点数据的采集周期和
接口实现位置,预防由于传感器数据采集过快引发的不必要的问题。数据点变量的初始化见
Gizwits/gizwits_product.c 文件 userInit 函数,待用户完善。
下面使用 STM32F103C8T6 平台,以微信宠物屋实现红外探测为例,irHandle()函数是需
要开发者自己实现,其他代码自动化工具会帮助开发者生成,案例如下:
void userHandle(void)
{
currentDataPoint.valueInfrared = irHandle();
}
实现模组状态处理
参考接口 gizwitsEventProcess(),本版软件已经将 wifi 状态数据转换成了 event,开发者
仅关注相应事件即可。用户可以通过获取到的 WIFI 状态做相应的逻辑处理。
下面使用 STM32F103C8T6 平台,以微信宠物屋实现配置入网后接收到网络连接到路由
器关闭 RGB 灯为例,ledRgbControl()函数是需要开发者自己实现,其他代码自动化工具会
帮助开发者生成,gizwitsEventProcess()函数省略其他代码段,案例如下:
case WIFI_CON_M2M:
ledRgbControl(0,0,0);
break;







您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

版权与免责声明 © 2006-2024 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

快速回复 返回顶部 返回列表