使用Web页面配置ESP8266的参数

Posted 2020-09-27 卡拉OK

前言　　

　　使用Web页面配置ESP8266的参数相对于使用串口AT指令配置更加直观和简单。与配置路由器方式类似。

基本思路

　　基本思路是ESP8266工作AP模式下，作为TCP Server监听TCP Client的连接。因为网页HTTP默认的端口是80，所以ESP8266作为TCP Server的端口需要设置为80。电脑连接上ESP8266的AP后，网页访问默认IP地址192.168.4.1，此时ESP8266就会收到来自网页的HTTP的Get请求,此请求数据为html格式。ESP8266收到请求后，读出保存在Flash中的HTML格式网页，并将带有HTML应答头的HTML网页发送给网页，网页端就可以显示出网页。下面是具体实现步骤：

开发环境

• ESP8266 SDK版本：ESP8266_NONOS_SDK_2.0.0
• IDE：ESP8266 IDE v2.0
• 操作系统：64位 Win7

步骤

　　1. 设置ESP8266工作模式

　　　　设置为AP模式，并设置AP模式下的参数，作为TCP Server，注册连接回调函数，监听TCP Client的连接。具体不详述。

 1 void ICACHE_FLASH_ATTR
 2 user_init(void)
 3 {
 4     os_printf("SDK version:%s\\r\\n", system_get_sdk_version());
 5     os_printf("Compile time:%s %s\\r\\n", __DATE__, __TIME__);
 6     
 7     wifi_set_opmode(STATIONAP_MODE);
 8     // ESP8266 softAP set config.
 9     user_set_softap_config();
10 
11     user_webserver_init(SERVER_PORT);
12 }

 1 void ICACHE_FLASH_ATTR
 2 user_webserver_init(uint32 port)
 3 {
 4     LOCAL struct espconn esp_conn;
 5     LOCAL esp_tcp esptcp;
 6 
 7     esp_conn.type = ESPCONN_TCP;
 8     esp_conn.state = ESPCONN_NONE;
 9     esp_conn.proto.tcp = &esptcp;
10     esp_conn.proto.tcp->local_port = port;
11     espconn_regist_connectcb(&esp_conn, webserver_listen);
12 
13     espconn_accept(&esp_conn);
14 }

 

         2.  在连接回调函数中注册接收回调函数，在接收回调函数中处理Client发送的数据

 1 LOCAL void ICACHE_FLASH_ATTR
 2 webserver_listen(void *arg)
 3 {
 4     struct espconn *pesp_conn = arg;
 5 
 6     espconn_regist_recvcb(pesp_conn, webserver_recv); 
 7     espconn_regist_reconcb(pesp_conn, webserver_recon);
 8     espconn_regist_disconcb(pesp_conn, webserver_discon);
 9     espconn_regist_sentcb(pesp_conn, webserver_sent);
10 }

　　 3. 带无线网卡的电脑连接ESP8266的AP，并在路由器中输入192.168.4.1

　　　　此时浏览器会将HTML格式的GET请求发送给TCP Server。这时网页是显示错误的，因为TCP Server并没有上传网页到Web端。可以使用HttpWatch这个IE浏览器插件抓取网页发送的GET请求数据。

 

　　4. 在TCP Server接收函数中实现解析GET请求并上传保存在Flash中的HTML网页

          这里主要是解析HTML格式字符串，请求网页的那个GET请求时不带Filename的，需要区别不同的GET请求，具体看网页实现。如果是GET请求网页，就从Flash中读取保存的网页，并通过HTML格式发送给网页端，然后就可以显示出网页了。

 1 void ICACHE_FLASH_ATTR
 2 webserver_recv(void *arg, char *pusrdata, unsigned short length)
 3 {
 4     URL_Frame *pURL_Frame = NULL;
 5     char *pParseBuffer = NULL;
 6     char *index = NULL;
 7     SpiFlashOpResult ret = 0;
 8 
 9     USER_DBG("len:%u\\r\\n",length);
10     USER_DBG("Webserver recv:-------------------------------\\r\\n%s\\r\\n", pusrdata);
11 
12     pURL_Frame = (URL_Frame *)os_zalloc(sizeof(URL_Frame));
13     parse_url(pusrdata, pURL_Frame);
14 
15     switch (pURL_Frame->Type) {
16         case GET:
17             USER_DBG("We have a GET request.\\r\\n");
18 
19             if(pURL_Frame->pFilename[0] == 0){
20                 index = (char *)os_zalloc(FLASH_READ_SIZE+1);
21                 if(index == NULL){
22                     ERR_LOG("os_zalloc error!\\r\\n");
23                     goto _temp_exit;
24                 }
25 
26                 // Flash read/write has to be aligned to the 4-bytes boundary
27                 ret = spi_flash_read(0xD0*SPI_FLASH_SEC_SIZE, (uint32 *)index, FLASH_READ_SIZE);  // start address:0x10000 + 0xC0000
28                 if(ret != SPI_FLASH_RESULT_OK){
29                     ERR_LOG("spi_flash_read err:%d\\r\\n", ret);
30                     os_free(index);
31                     index = NULL;
32                     goto _temp_exit;
33                 }
34 
35                 index[HTML_FILE_SIZE] = 0;   // put 0 to the end
36                 data_send(arg, true, index);
37 
38                 os_free(index);
39                 index = NULL;
40             }
41             break;
42 
43         case POST:
44             USER_DBG("We have a POST request.\\r\\n");
45 
46             pParseBuffer = (char *)os_strstr(pusrdata, "\\r\\n\\r\\n");
47             if (pParseBuffer == NULL) {
48                 data_send(arg, false, NULL);
49                 break;
50             }
51             // Prase the POST data ...
52             break;
53     }
54 
55     _temp_exit:
56         ;
57     if(pURL_Frame != NULL){
58         os_free(pURL_Frame);
59         pURL_Frame = NULL;
60     }
61 }

 

         5. 网页配置就是POST请求，网页发送HTML格式的POST请求，ESP8266解析数据并作出设置。

　　　　POST请求数据中的Content内容可以是自定也格式，一般使用json格式比较好。这里就详细列出如何处理了。ESP8266 SDK的IOT demo中有HTML格式的解析以及回应HTML格式数据的例程，可以参考。

 

注意点

　　网页是通过烧录固件的工具烧录到Flash的。当时如何把网页的数据保存到Flash中这个问题困扰我很久，网上找很久都没有具体说明，是直接将xx.html文件烧录到Flash中的，此Flash空间是用户可用区间，具体见官方文档。不同Flash都是不同的，这个地址也是需要记下的，SPI读取时需要用到，文件大小也是需要记下。下面是32Mbit 的Flash的烧录截图。