概要
本项目可实现通过ESP8266模块、MQTT通信协议及Onenet物联网开发平台实现对家居设备的远程控制和数据同步。
实现通过DHT温湿度传感器测量环境温湿度,通过单总线协议将温湿度数据传给STM32并显示在OLED屏幕上,同时将数据通过USART传输给ESP8266,再由Esp8266连接Wifi后通过MQTT协议上传到Onenet云平台上实时显示并监测,并且可以在云平台及通过HBuild X开发的小程序页面实现下发指令来远程实现灯控和数据同步读取。
项目过程
初始化外设
首先利用onenet物联网平台中的“开发者文档”中选择MQTT的历程,并将不需要的外设配置代码删除,以便移植自己需要的外设。当下我们需要的外设主要是DHT11温湿度传感器,LED灯(模拟家居台灯)以及用于显示信息和调试的OLED屏幕。
OLED屏幕移植的是中景园电子的文件。
DHT11使用GPIOA GPIO_Pin_0引脚、LED灯使用GPIOA GPIO_Pin_13引脚、控制LED的按键使用GPIOA GPIO_Pin_1引脚、OLED屏幕使用GPIOB GPIO_Pin_0|GPIO_Pin_1引脚;
我在main.c中用一个函数来Hardware_Init(void)初始化以上添加的外设,便于管理和模块化:
/*
************************************************************
* 函数名称: Hardware_Init
*
* 函数功能: 硬件初始化
*
* 入口参数: 无
*
* 返回参数: 无
*
* 说明: 初始化单片机功能以及外接设备
************************************************************
*/
void Hardware_Init(void)
{
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); //中断控制器分组设置
Delay_Init(); //systick初始化
Usart1_Init(115200); //串口1,打印信息用
Usart2_Init(115200); //串口2,驱动ESP8266用
Key_Init(); //软件IIC初始化
Led_Init(); //LED初始化
OLED_Init(); //初始化OLED
while(DHT11_Init())
{
// UsartPrintf(USART_DEBUG,"DHT11 Error \r\n");
OLED_ShowString(0,0,"DHT11 Error",16);
DelayMs(1000);
}
//UsartPrintf(USART_DEBUG," Hardware init OK\r\n");
OLED_Clear();
OLED_ShowString(0,0,"Hardware init OK",16);
DelayMs(1000);
}
初始化配置完成后,进行调试,看看DHT是否能正常读取温湿度并显示,以及是否能通过按键控制LED的开启关闭。
初始化ESP8266
本项目选用的是Esp8266 01s,并且需要注意需要用TLL来外接供电,连接到STM32系统板供电,由于其他外设分压,可能导致8266无法达到正常工作的电压。
ESP8266接线图参考:
ESP8266 有三种主要的工作模式,分别是:
1. Station Mode (STA)
在这种模式下,ESP8266 作为一个客户端连接到现有的 Wi-Fi 网络。设备可以通过这个网络访问互联网或与其他设备通信。用途:用于 IoT 设备连接到家庭或办公网络,发送数据到云端或接收指令。
特点:
需要配置 Wi-Fi SSID 和密码。
可以通过 DHCP 自动获取 IP 地址。
2. Access Point Mode (AP)
在此模式下,ESP8266 充当一个无线接入点,允许其他设备(如手机、电脑)直接连接到它。用途:在没有其他网络可用时,允许用户直接与 ESP8266 进行通信,常用于设备配置或本地控制。
特点:ESP8266 创建自己的 Wi-Fi 网络,设备可以连接。
可以配置一个固定的 IP 地址供连接设备使用。
3. Station + Access Point Mode (STA + AP)
这种模式同时启用 Station 和 Access Point 模式,ESP8266 可以连接到一个 Wi-Fi 网络,同时也可以作为接入点提供服务。用途:适用于需要与现有网络通信,同时允许其他设备连接的场景,例如 IoT 设备的配置界面。
特点:
设备可以同时连接到一个网络并提供本地连接。
在这种模式下,ESP8266 可以作为中介设备。
本项目使用的AP模式,并且通过串口进行打印Esp8266的工作信息,在串口助手上查看,便于查看和调试,初始化如下:
//==========================================================
// 函数名称: ESP8266_Init
//
// 函数功能: 初始化ESP8266
//
// 入口参数: 无
//
// 返回参数: 无
//
// 说明:
//==========================================================
void ESP8266_Init(void)
{
OLED_Clear();
ESP8266_Clear();
UsartPrintf(USART_DEBUG, "1. AT\r\n");
OLED_ShowString(0,0,"1. AT...",16);
while(ESP8266_SendCmd("AT\r\n", "OK"))
DelayXms(500);
UsartPrintf(USART_DEBUG, "2. CWMODE\r\n");
OLED_ShowString(0,2,"2. CWMODE...",16);
while(ESP8266_SendCmd("AT+CWMODE=1\r\n", "OK"))
DelayXms(500);
UsartPrintf(USART_DEBUG, "3. AT+CWDHCP\r\n");
OLED_ShowString(0,4,"3. AT+CWDHCP...",16);
while(ESP8266_SendCmd("AT+CWDHCP=1,1\r\n", "OK"))
DelayXms(500);
UsartPrintf(USART_DEBUG, "4. CWJAP\r\n");
OLED_ShowString(0,6,"4. CWJAP...",16);
while(ESP8266_SendCmd(ESP8266_WIFI_INFO, "GOT IP"))
DelayXms(500);
OLED_Clear();
UsartPrintf(USART_DEBUG, "5. ESP8266 Init OK\r\n");
OLED_ShowString(0,0,"ESP8266 Init OK.",16);
DelayXms(500);
}
项目中移植的Esp8266文件已经封装好了基本操作的函数,我们只需调用即可:比如在给Esp8266下发指令时,我们只需调用ESP8266_SendCmd():
/==========================================================
// 函数名称: ESP8266_SendCmd
//
// 函数功能: 发送命令
//
// 入口参数: cmd:命令
// res:需要检查的返回指令
//
// 返回参数: 0-成功 1-失败
//
// 说明:
//==========================================================
_Bool ESP8266_SendCmd(char *cmd, char *res)
{
unsigned char timeOut = 200;
Usart_SendString(USART2, (unsigned char *)cmd, strlen((const char *)cmd));
while(timeOut--)
{
if(ESP8266_WaitRecive() == REV_OK) //如果收到数据
{
if(strstr((const char *)esp8266_buf, res) != NULL) //如果检索到关键词
{
ESP8266_Clear(); //清空缓存
return 0;
}
}
DelayXms(10);
}
return 1;
}
Esp8266连接Wifi同时也需要配置Wifi热点的信息,定义一个宏 ESP8266_WIFI_INFO,用于配置 ESP8266 连接到 Wi-Fi 网络的 AT 命令。
如:热点名称为:“iPhone”,密码为“000000000”。
#define ESP8266_WIFI_INFO "AT+CWJAP=\"iPhone\",\"000000000\"\r\n"
调试成功如下图:OLED显示和串口助手打印信息;
调试过程中遇到过错误:Esp8266连接时一直卡在1.AP的指令下。
这个时候可以将Esp8266定义的函数中,将每一步操作都添加上一行UsartPrintf()来验证是哪一步出现了问题。同时,首先也应该检查发送的AT指令有没有错误,比如“回车”和“换行符”正不正确;也有可能是固件版本的问题,可以通过助手去检查和升级版本,一般商家附送的文件也有固件文件;其次就是要去检查接线和电源,比如我就是因为供电不足,所以导致不能正常工作,特别是在连接Wifi过程中,供电要稳定,我将电源外接使用TTL进行供电后,连接就正常了,所以在本章节前我也提及了一定要确保电源正常。
连接MQTT
我们需要通过Esp8266连接Wifi后向Onenet平台通过TCP协议发送数据或是报文。
因此我们也要想办法与Onenet平台进行连接,Onenet平台支持通过 HTTP POST 请求发送数据。同时幸运的是,移植的平台实例中也准备了Onenet.c,我们也只需要配置一些信息,并调用其封装好的函数即可。
首先就是通过宏定义配置好在Onenet平台注册好的产品信息(下一章节会讲):产品ID、密钥、设备名称;
同时,也需要获得Onenet平台的端口号,可以在官网的开发文档中的MQTT连接中找到:文档。
需要在main.c定义好Esp8266连接MQTT服务器的端口,在连接操作可以加入UsartPrintf串口打印信息和OLED显示信息,方便调试,这样我们的连接操作就完成了。
main.c代码如下:
//单片机头文件
#include "stm32f10x.h"
//网络协议层
#include "onenet.h"
//网络设备
#include "esp8266.h"
//硬件驱动
#include "delay.h"
#include "usart.h"
#include "dht11.h"
#include "led.h"
#include "key.h"
#include "oled.h"
// #include "sht20.h"
//C库
#include <string.h>
//mqtts.heclouds.com:1883
#define ESP8266_ONENET_INFO "AT+CIPSTART=\"TCP\",\"mqtts.heclouds.com\",1883\r\n"
void Hardware_Init(void);
void Display_Init(void);
void Refresh_Data(void);
uint8_t temp,humi;
/*
************************************************************
* 函数名称: main
*
* 函数功能:
*
* 入口参数: 无
*
* 返回参数: 0
*
* 说明:
************************************************************
*/
int main(void)
{
unsigned short timeCount = 0; //发送间隔变量
unsigned char *dataPtr = NULL;
Usart2_Init(115200);
Hardware_Init(); //初始化外围硬件
ESP8266_Init(); //初始化ESP8266
UsartPrintf(USART_DEBUG, "Connect MQTTs Server...\r\n");
OLED_Clear();
OLED_ShowString(0,0,"Connect MQTTs Server...",16);
DelayXms(500);
while(ESP8266_SendCmd(ESP8266_ONENET_INFO, "CONNECT"))
DelayXms(500);
UsartPrintf(USART_DEBUG, "Connect MQTTs Server Success\r\n");
OLED_Clear();
OLED_ShowString(0,0,"Connect MQTTs Server Success.",16);
DelayXms(500);
OLED_Clear();
OLED_ShowString(0,0,"Device Login...",16);
DelayXms(500);
while(OneNet_DevLink()) //接入OneNET
{
ESP8266_SendCmd(ESP8266_ONENET_INFO, "CONNECT");
DelayXms(500);
}
OneNET_Subscribe();
Display_Init();
while(1)
{
// DHT11_Read_Data(&temp,&humi);//
// UsartPrintf(USART_DEBUG,"temp %d ,humi %d\r\n",temp,humi);
if(++timeCount >= 50) //发送间隔5s
{
DHT11_Read_Data(&temp,&humi);
//UsartPrintf(USART_DEBUG, "OneNet_SendData\r\n");
OneNet_SendData(); //发送数据
timeCount = 0;
ESP8266_Clear();
}
dataPtr = ESP8266_GetIPD(0);
if(dataPtr != NULL)
OneNet_RevPro(dataPtr);
Refresh_Data();
// // UsartPrintf(USART_DEBUG, " Hardware init OK\r\n"); 这个删除了
DelayMs(10);
}
}
/*
************************************************************
* 函数名称: Hardware_Init
*
* 函数功能: 硬件初始化
*
* 入口参数: 无
*
* 返回参数: 无
*
* 说明: 初始化单片机功能以及外接设备
************************************************************
*/
void Hardware_Init(void)
{
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); //中断控制器分组设置
Delay_Init(); //systick初始化
Usart1_Init(115200); //串口1,打印信息用
Usart2_Init(115200); //串口2,驱动ESP8266用
Key_Init(); //软件IIC初始化
Led_Init(); //LED初始化
OLED_Init(); //初始化OLED
while(DHT11_Init())
{
// UsartPrintf(USART_DEBUG,"DHT11 Error \r\n");
OLED_ShowString(0,0,"DHT11 Error",16);
DelayMs(1000);
}
//UsartPrintf(USART_DEBUG," Hardware init OK\r\n");
OLED_Clear();
OLED_ShowString(0,0,"Hardware init OK",16);
DelayMs(1000);
}
void Display_Init(void)
{
OLED_Clear();
OLED_ShowCHinese(0,0,1);//温
OLED_ShowCHinese(18,0,2);//度
OLED_ShowCHinese(36,0,0);//:
// OLED_ShowString(54,0,"22",16);
OLED_ShowCHinese(72,0,3);//℃
OLED_ShowCHinese(0,3,4);//湿
OLED_ShowCHinese(18,3,5);//度
OLED_ShowCHinese(36,3,0);//:
// OLED_ShowString(54,3,"33",16);
OLED_ShowString(72,3,"%",16);//%
OLED_ShowCHinese(0,6,6);//台
OLED_ShowCHinese(18,6,7);//灯
OLED_ShowCHinese(36,6,0);//:
// OLED_ShowCHinese(54,6,8);//亮/灭
}
void Refresh_Data(void)
{
char buf[3];
sprintf(buf, "%2d", temp);
OLED_ShowString(54,0,buf,16);//温度
sprintf(buf, "%2d", humi);
OLED_ShowString(54,3,buf,16);//湿度
//亮/灭
if(led_info.Led_Status)OLED_ShowCHinese(54,6,8);
else OLED_ShowCHinese(54,6,9);
}
大概就是实现了硬件外设的初始化后,进行与MQTT服务器的连接,同时将提示连接信息,订阅Onenet平台信息,同时进入循环读取DHT11的温湿度数据和LED灯信息,并上传平台。
Onenet平台
在Onenet平台中,创建项目十分简单,在开发者中心按需操作即可:
创建好项目和设备后,接着需要下载MQTT fx客户端进行配置:
需要填写端口号,要和刚才在代码配置的地址一致,同时加入设备ID等,
还需要填写在Onenet平台的产品ID和密钥:
以上步骤也可以参考官网中的开发文档,地址在此:参考文档。
我们还需要为项目添加功能属性,如下:
接着需要再次回到MQTT fx客户端,进行以上属性的订阅:
在编辑Json代码时要格外注意代码的格式:
还需要进行设备侧的接受数据和上报数据的订阅:
数据上传和下发
基于HBuild X进行小程序开发
在这一部分,因为并不懂小程序的开发,只能参照着别人的程序来实现,可以分成四个部分:
生成token、从云平台获取数据、下发命令、界面美化;
其中生成token,主要是在 OneNet 中,生成 Token 用于进行安全认证和数据传输。
其中的代码很有熟悉的感觉,感觉和前端的知识很类似,和qt界面开发也比较像。
到此为止,我们的项目就基本完成了。
成果展示
设备端、平台、客服端都可以实时同步数据,远程操控:
小结
这个项目并不难,但是也让我有所收获,让我了解到了如何通过云平台进行设备的互联,也让我熟悉了ESP8266的使用以及MQTT协议的具体操作,同时在移植平台实例文件,删除不要的东西,增加自己需要的东西,如各种外设,让我体会到了移植的便利,通过参考平台的开发文档进行操作,也让我渐渐地培养起查文档,再操作的习惯。在项目实现过程中,我觉得自己对STM32的各种串口、时钟等初始化更为熟练了,在遇到BUG或者报错时,也能冷静在添加串口打印来通过串口助手来寻找是哪出现的问题,然后带着问题去思考怎么解决,带着问题去各个论坛去寻找相似的情况和解决方案。在这个项目中,基本实现了对智能家居的模拟控制,我认为在未来还可以添加更多的外设,并应用RTOS实时操作系统来创造更多的进程和任务,满足真是的家居环境的需求,也使这个项目更加贴近实际,更有含金量。
这篇文章,只是大致介绍了我实现项目的一些粗略的过程,后续还会认真再复盘,补充完整的、详细的过程和涉及的技术、知识,未完待续。