实验四：ESP8266WIFI通讯实验

Posted 2023-01-06 I am Supreme

本实验开发板基于：GD32F103

我们首先需要看一下原理图

根据原理图可以看到，ESP8266是通过PA2 PA3这个串口进行通讯，PA13是控制它的复位，

从芯片手册中可以看到PA2PA3是串口1，PA2是串口1的发送，PA3是串口1的接收。

一、ESP8266简介

本项目使用ESP8266型号为ESP-01S 自带排针WIFI模块

功能特点：基于ESP8266芯片开发，模组继承了透传功能，即买即用，支持串口AT指令，用户通过串口实现网络访问，可广泛应用于智能穿戴，智能家居，家庭安防，遥控器，汽车电子，智慧照明，工业物联网等领域等。

二、产品参数

模块支持4Mbps高速连传，在WiFi打印机，WiFi串口摄像头，WiFi高速数据采集等大数据量传输应用中，速度更快。

三、电路图

四、ESP8266开发方式

ESPb266系列一般有三种开发方式：AT指令开发和LUA语言编程以及Arduino 开发。

AT指令开发：厂家出厂时已经预先在ESP8266芯片烧好固件，封装好wifi的协议栈，内部已经实现透传，而用户只需要使用一个USB转TTL的模块或者单片机的串口就能实现与wifi模块的通信，发送AT指令来对WIFI模块进行控制。（和蓝牙透传模块类似）

LUA语言编程：这是一种单独8266编程的方式，可以不依靠单片机和串口调试软件，直接把程序编写到ESP8266内部。

Arduino 开发：这个接触过Arduino的都会比较熟悉。可以直接在Arduinoide的环境下使用Arduino的开发方式进行开发。

五、常用AT指令

AT指令不区分大小写，以回车、转行结尾。

指令名	响应	含义
AT	OK	测试指令
AT+CWMODE=<mode>	OK	设置应用模式（需重启生效）
AT+CWMODE?	+CWMODE:<mode>	获得当前应用模式
AT+CWLAP	+CWLAP:<ecn>,<ssid>,<rssi>	返回当前的AP列表
AT+CWLAP=<ssid>,<pwd>	OK	加入某一AP
AT+CWJAP?	+CWJAP=<ssid>,	返回当前加入的AP
AT+CIPSTART=<type>,<addr>,port	OK	建立TCP/UDP连接
AT+CIPMUX=<mode>	OK	是否启用多连接
AT+CIPSEND=<param>	OK	发送数据
AT+CIPMODE=<mode>	OK	是否进入透传模式

AT+CWMODE=1：STA模式

AT+CWMODE=2：AP模式

AT+CWMODE=3：STA+AP模式

AT+RST:复位

AT+CIPMUX=1：多连接

AT+CIPSERVER=1：建立服务器

AT+CIFSR：查询模块IP端口

AT+CIPSERVER=1,60000：建立服务器的同时设置端口号

AT+CIPMUX=0：单连接

AT+CIPSEND=0,1：向连接序号为0的连接发1个字节

AT+CIPSTATUS：检测连接状态

AT+MQTTUSERCFG：配置用户属性

六、应用模式

ESP8266支撑单AP模式，单STA模式和混合模式（可以在两种模式切换的状态）

AP模式下，ESP8266 模块作为热点，手机或电脑直接与模块连接，实现局域网无线控制。该模式对应TCP传输协议中的服务端（TCP Server）。

STA模式下，WiFi模块为连接到无线网络的终端（站点），可以连接到AP，一般无线网卡工作在STA模式下，该模式对应TCP传输协议中的客户端（TCP Client）

简单来说：AP模式可以将ESP8266作为热点，让其他的设备连接上它；STA模式可以连接上当前环境下的WIFI热点。

七、几个相关概念

透传（透明传输）：就是指不需要关心WiFi协议是如何传输的，所需要做的是A通过串口发数据，B通过串口收数据，整个过程中A串口和B串口就好像是用导线连接起来了一样。使用者不用关心内部具体实现，模块对于使用者是“透明的”、“似乎不存在的”（因为可无视中间的实现原理）。

如果不开启透传模式，在每次发送数据前都必须先发送指令AT+CIPSEND=<param>。若开启了透传模式，就不需要再每次发数据之前都发指令了，只需要发送一次AT+CIPSEND，之后发送的内容都会当成是数据。如果再次发送命令，需要退出透传模式（发送“+++”退出），否则就会把命令当成是数据发送过去。

八、工作流程

ESP8266一般用于连接当前环境的热点，与服务器建立TCP连接，传输数据，大致流程如下：

AT+CWMODE=1：设置工作模式（STA模式）

RT+RST：模块重启（生效工作模式）

AT+CWJAP=”111”，”111111”：连接当前环境的WIFI热点（热点名，密码）

AT+CIPMUX=0：设置单路连接模式

AT+CIPSTART=”TCP”：”xxx.xxx.xxx.xxx”,”xxxx”：建立TCP连接服务器IP与服务器端口号

AT+CIPMODE：透传模式下

AT+CIPSEND：传输数据

+++：退出透传模式

九、主要代码如下：

ESP8266的初始化和TCP功能函数：

ESP8266.h

void ESP8266_Init(void);
void ESP8266_AT_Test(void);
bool ESP8266_Send_AT_Cmd(char *cmd,char *ack1,char *ack2,u32 time);
void ESP8266_Rst(void);
bool ESP8266_Net_Mode_Choose(ENUM_Net_ModeTypeDef enumMode);
bool ESP8266_JoinAP( char * pSSID, char * pPassWord );
bool ESP8266_Enable_MultipleId ( FunctionalState enumEnUnvarnishTx );
bool ESP8266_Link_Server(ENUM_NetPro_TypeDef enumE, char * ip, char * ComNum, ENUM_ID_NO_TypeDef id);
bool ESP8266_SendString(FunctionalState enumEnUnvarnishTx, char * pStr, u32 ulStrLength, ENUM_ID_NO_TypeDef ucId );
bool ESP8266_UnvarnishSend ( void );
void ESP8266_ExitUnvarnishSend ( void );
u8 ESP8266_Get_LinkStatus ( void );
void USART_printf( uint32_t USARTx, char * Data, ... );

ESP8266.c

#include "esp8266.h"
#include "gd32f10x.h"
#include "systick.h"
#include <stdarg.h>
#include "string.h"

extern uint8_t UartRxbuf[512];
extern uint16_t UartRxLen;
extern uint8_t UartRecv_Clear(void);


struct STRUCT_USART_Fram ESP8266_Fram_Record_Struct =  0 ;  //定义了一个数据帧结构体
void ESP8266_Init(void)

    ESP8266_RST_Pin_Periph_Clock();//PC时钟
        gpio_init(ESP8266_RST_Pin_Port, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, ESP8266_RST_Pin);//复位配置成输出
      ESP8266_Rst();//PC13复位管脚配置  复位操作：低-延迟-高

//对ESP8266模块发送AT指令 AT指令网上资料很多的
// cmd 待发送的指令
// ack1,ack2;期待的响应，为NULL表不需响应，两者为或逻辑关系
// time 等待响应时间
//返回1发送成功， 0失败
bool ESP8266_Send_AT_Cmd(char *cmd,char *ack1,char *ack2,u32 time)
 
    UartRecv_Clear(); //重新接收新的数据包
    ESP8266_USART("%s\\r\\n", cmd);
    if(ack1==0&&ack2==0)     //不需要接收数据
    
    return true;
    
    delay_1ms(time);   //延时
        delay_1ms(1000);
        if(Uart_RecvFlag()==1)
        
            UartRxbuf[UartRxLen]='\\0';
        
   // printf("%s",UartRxbuf);
    if(ack1!=0&&ack2!=0)
    
        return ( ( bool ) strstr ( UartRxbuf, ack1 ) || 
                         ( bool ) strstr ( UartRxbuf, ack2 ) );
    
    else if( ack1 != 0 )  //strstr(s1,s2);检测s2是否为s1的一部分，是返回该位置，否则返回false，它强制转换为bool类型了
        return ( ( bool ) strstr ( UartRxbuf, ack1 ) );

    else
        return ( ( bool ) strstr ( UartRxbuf, ack2 ) );




//复位重启
void ESP8266_Rst(void)

    ESP8266_RST_Pin_SetL;
    delay_1ms(500); 
    ESP8266_RST_Pin_SetH;



//发送恢复出厂默认设置指令将模块恢复成出厂设置
void ESP8266_AT_Test(void)

    char count=0;
    delay_1ms(1000); 
    while(count < 10)
    
        if(ESP8266_Send_AT_Cmd("AT+RESTORE","OK",NULL,500)) 
        
           // printf("OK\\r\\n");
            return;
        
        ++ count;
    



//选择ESP8266的工作模式
// enumMode 模式类型
//成功返回true，失败返回false
bool ESP8266_Net_Mode_Choose(ENUM_Net_ModeTypeDef enumMode)

    switch ( enumMode )
    
        case STA:
            return ESP8266_Send_AT_Cmd ( "AT+CWMODE=1", "OK", "no change", 2500 ); 

        case AP:
            return ESP8266_Send_AT_Cmd ( "AT+CWMODE=2", "OK", "no change", 2500 ); 

        case STA_AP:
            return ESP8266_Send_AT_Cmd ( "AT+CWMODE=3", "OK", "no change", 2500 ); 

        default:
          return false;
           



//ESP8266连接外部的WIFI
//pSSID WiFi帐号
//pPassWord WiFi密码
//设置成功返回true 反之false
bool ESP8266_JoinAP( char * pSSID, char * pPassWord)

    char cCmd [120];
    
    sprintf ( cCmd, "AT+CWJAP=\\"%s\\",\\"%s\\"", pSSID, pPassWord );
    return ESP8266_Send_AT_Cmd( cCmd, "OK", NULL, 5000 );


//ESP8266 透传使能
//enumEnUnvarnishTx  是否多连接，bool类型
//设置成功返回true，反之false
bool ESP8266_Enable_MultipleId (FunctionalState enumEnUnvarnishTx )

    char cStr [20];

    sprintf ( cStr, "AT+CIPMUX=%d", ( enumEnUnvarnishTx ? 1 : 0 ) );

    return ESP8266_Send_AT_Cmd ( cStr, "OK", 0, 500 );




//ESP8266 连接服务器
//enumE  网络类型
//ip ，服务器IP
//ComNum  服务器端口
//id，连接号，确保通信不受外界干扰
//设置成功返回true，反之fasle
bool ESP8266_Link_Server(ENUM_NetPro_TypeDef enumE, char * ip, char * ComNum, ENUM_ID_NO_TypeDef id)

    char cStr [100] =  0 , cCmd [120];

    switch (  enumE )
    
        case enumTCP:
          sprintf ( cStr, "\\"%s\\",\\"%s\\",%s", "TCP", ip, ComNum );
          break;

        case enumUDP:
          sprintf ( cStr, "\\"%s\\",\\"%s\\",%s", "UDP", ip, ComNum );
          break;

        default:
            break;
    

    if ( id < 5 )
        sprintf ( cCmd, "AT+CIPSTART=%d,%s", id, cStr);

    else
        sprintf ( cCmd, "AT+CIPSTART=%s", cStr );

    return ESP8266_Send_AT_Cmd ( cCmd, "OK", "ALREAY CONNECT", 4000 );




//透传使能
//设置成功返回true， 反之false
bool ESP8266_UnvarnishSend ( void )

    if (!ESP8266_Send_AT_Cmd ( "AT+CIPMODE=1", "OK", 0, 500 ))//进入透传模式
        return false;

    return 
            ESP8266_Send_AT_Cmd( "AT+CIPSEND", "OK", ">", 500 );//然后开始发送数据




//ESP8266发送字符串
//enumEnUnvarnishTx是否使能透传模式
//pStr字符串
//ulStrLength字符串长度
//ucId 连接号
//设置成功返回true， 反之false
bool ESP8266_SendString(FunctionalState enumEnUnvarnishTx, char * pStr, u32 ulStrLength, ENUM_ID_NO_TypeDef ucId )

    char cStr [20];
    bool bRet = false;


    if ( enumEnUnvarnishTx )
    
        ESP8266_USART ( "%s", pStr );

        bRet = true;

    

    else
    
        if ( ucId < 5 )
            sprintf ( cStr, "AT+CIPSEND=%d,%d", ucId, ulStrLength + 2 );

        else
            sprintf ( cStr, "AT+CIPSEND=%d", ulStrLength + 2 );

        ESP8266_Send_AT_Cmd ( cStr, "> ", 0, 1000 );

        bRet = ESP8266_Send_AT_Cmd ( pStr, "SEND OK", 0, 1000 );
  

    return bRet;




//ESP8266退出透传模式
void ESP8266_ExitUnvarnishSend ( void )

    delay_1ms(1000);
    ESP8266_USART( "+++" );
    delay_1ms( 500 );    



//ESP8266 检测连接状态
//返回0：获取状态失败
//返回2：获得ip
//返回3：建立连接 
//返回4：失去连接 
u8 ESP8266_Get_LinkStatus ( void )

    if (ESP8266_Send_AT_Cmd( "AT+CIPSTATUS", "OK", 0, 500 ) )
    
        if ( strstr ( ESP8266_Fram_Record_Struct .Data_RX_BUF, "STATUS:2\\r\\n" ) )
            return 2;

        else if ( strstr ( ESP8266_Fram_Record_Struct .Data_RX_BUF, "STATUS:3\\r\\n" ) )
            return 3;

        else if ( strstr ( ESP8266_Fram_Record_Struct .Data_RX_BUF, "STATUS:4\\r\\n" ) )
            return 4;       

    

    return 0;


static char *itoa( int value, char *string, int radix )

    int     i, d;
    int     flag = 0;
    char    *ptr = string;

    /* This implementation only works for decimal numbers. */
    if (radix != 10)
    
        *ptr = 0;
        return string;
    

    if (!value)
    
        *ptr++ = 0x30;
        *ptr = 0;
        return string;
    

    /* if this is a negative value insert the minus sign. */
    if (value < 0)
    
        *ptr++ = '-';

        /* Make the value positive. */
        value *= -1;

    

    for (i = 10000; i > 0; i /= 10)
    
        d = value / i;

        if (d || flag)
        
            *ptr++ = (char)(d + 0x30);
            value -= (d * i);
            flag = 1;
        
    

    /* Null terminate the string. */
    *ptr = 0;

    return string;

 /* NCL_Itoa */


void USART_printf ( uint32_t  USARTx, char * Data, ... )

    const char *s;
    int d;   
    char buf[16];
    unsigned char TempData;


    va_list ap;
    va_start(ap, Data);

    while ( * Data != 0 )     // 判断数据是否到达结束符
                                             
        if ( * Data == 0x5c )  //'\\'
                                             
            switch ( *++Data )
            
                case 'r':                                     //回车符
                                TempData=0x0d;
                                usart_data_transmit(USARTx, TempData);
                                while (RESET == usart_flag_get(USARTx, USART_FLAG_TC));//发送完成判断
                Data ++;
                break;

                case 'n':                                     //换行符
                                TempData=0x0a;
                                usart_data_transmit(USARTx, TempData);
                                while (RESET == usart_flag_get(USARTx, USART_FLAG_TC));//发送完成判断                        
                Data ++;
                break;

                default:
                Data ++;
                break;
                        
        

        else if ( * Data == '%')
                                             
            switch ( *++Data )
                           
                case 's':                                         //字符串
                s = va_arg(ap, const char *);
                for ( ; *s; s++) 
                
                                        TempData=*s;
                                        usart_data_transmit(USARTx, TempData);
                                      while (RESET == usart_flag_get(USARTx, USART_FLAG_TC));//发送完成判断
                
                Data++;
                break;

                case 'd':           
                    //十进制
                d = va_arg(ap, int);
                itoa(d, buf, 10);
                for (s = buf; *s; s++) 
                
                       TempData=*s;
                                      usart_data_transmit(USARTx, TempData);
                                      while (RESET == usart_flag_get(USARTx, USART_FLAG_TC));//发送完成判断
                
                     Data++;
                     break;
                default:
                     Data++;
                     break;
                    
        
        else 
                
                                        TempData=*Data++;
                                    usart_data_transmit(USARTx, TempData);
                                        while (RESET == usart_flag_get(USARTx, USART_FLAG_TC));//发送完成判断                    
                

    


//下面为ESP8266MQTT功能指令

/*
*MQTT配置用户属性
*LinkID 连接ID,目前只支持0
*scheme 连接方式，这里选择MQTT over TCP,这里设置为1
*client_id MQTTclientID 用于标志client身份
*username 用于登录 MQTT 服务器 的 username
*password 用于登录 MQTT 服务器 的 password
*cert_key_ID 证书 ID, 目前支持一套 cert 证书, 参数为 0
*CA_ID 目前支持一套 CA 证书, 参数为 0
*path 资源路径，这里设置为""
*设置成功返回true 反之false
*/
bool ESP8266_MQTTUSERCFG( char * pClient_Id, char * pUserName,char * PassWord)

    char cCmd [120];
    sprintf ( cCmd, "AT+MQTTUSERCFG=0,1,\\"%s\\",\\"%s\\",\\"%s\\",0,0,\\"\\"", pClient_Id,pUserName,PassWord );
    return ESP8266_Send_AT_Cmd( cCmd, "OK", NULL, 500 );



/*
*连接指定的MQTT服务器
*LinkID 连接ID,目前只支持0
*IP：MQTT服务器上对应的IP地址
*ComNum MQTT服务器上对应的端口号，一般为1883
*设置成功返回true 反之false
*/
bool ESP8266_MQTTCONN( char * Ip, int  Num)

    char cCmd [120];
    sprintf ( cCmd,"AT+MQTTCONN=0,\\"%s\\",%d,0", Ip,Num);
    return ESP8266_Send_AT_Cmd( cCmd, "OK", NULL, 500 );


/*
*订阅指定连接的 MQTT 主题, 可重复多次订阅不同 topic
*LinkID 连接ID,目前只支持0
*Topic 订阅的主题名字，这里设置为Topic
*Qos值：一般为0，这里设置为1
*设置成功返回true 反之false
*/
bool ESP8266_MQTTSUB(char * Topic)

    char cCmd [120];
    sprintf ( cCmd, "AT+MQTTSUB=0,\\"%s\\",1",Topic );
    return ESP8266_Send_AT_Cmd( cCmd, "OK", NULL, 500 );



/*
*在LinkID上通过 topic 发布数据 data, 其中 data 为字符串消息
*LinkID 连接ID,目前只支持0
*Topic 订阅的主题名字，这里设置为Topic
*data：字符串信息
*设置成功返回true 反之false
*/
bool ESP8266_MQTTPUB( char * Topic,char *temp)

    char cCmd [120];
    sprintf (cCmd, "AT+MQTTPUB=0,\\"%s\\",\\"%s\\",1,0", Topic ,temp);
    return ESP8266_Send_AT_Cmd( cCmd, "OK", NULL, 1000 );


/*
*关闭 MQTT Client 为 LinkID 的连接, 并释放内部占用的资源
*LinkID 连接ID,目前只支持0
*Topic 订阅的主题名字，这里设置为Topic
*data：字符串信息
*设置成功返回true 反之false
*/
bool ESP8266_MQTTCLEAN(void)

    char cCmd [120];
    sprintf ( cCmd, "AT+MQTTCLEAN=0");
    return ESP8266_Send_AT_Cmd( cCmd, "OK", NULL, 500 );


//ESP8266发送字符串
//enumEnUnvarnishTx是否使能透传模式
//pStr字符串
//ulStrLength字符串长度
//ucId 连接号
//设置成功返回true， 反之false
bool MQTT_SendString(char * pTopic,char *temp2)

    
    bool bRet = false;
    ESP8266_MQTTPUB(pTopic,temp2);
      delay_1ms(1000);
    bRet = true;
    return bRet;

实现效果如下：