使用Web页面配置ESP8266的参数

前言　　

　　使用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的连接。具体不详述。

 void ICACHE_FLASH_ATTR
 user_init(void)
 {
     os_printf("SDK version:%s\r\n", system_get_sdk_version());
     os_printf("Compile time:%s %s\r\n", __DATE__, __TIME__);

     wifi_set_opmode(STATIONAP_MODE);
     // ESP8266 softAP set config.
     user_set_softap_config();

     user_webserver_init(SERVER_PORT);
 }

 void ICACHE_FLASH_ATTR
 user_webserver_init(uint32 port)
 {
     LOCAL struct espconn esp_conn;
     LOCAL esp_tcp esptcp;

     esp_conn.type = ESPCONN_TCP;
     esp_conn.state = ESPCONN_NONE;
     esp_conn.proto.tcp = &esptcp;
     esp_conn.proto.tcp->local_port = port;
     espconn_regist_connectcb(&esp_conn, webserver_listen);

     espconn_accept(&esp_conn);
 }

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

 LOCAL void ICACHE_FLASH_ATTR
 webserver_listen(void *arg)
 {
     struct espconn *pesp_conn = arg;

     espconn_regist_recvcb(pesp_conn, webserver_recv);
     espconn_regist_reconcb(pesp_conn, webserver_recon);
     espconn_regist_disconcb(pesp_conn, webserver_discon);
     espconn_regist_sentcb(pesp_conn, webserver_sent);
 }

　　 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格式发送给网页端，然后就可以显示出网页了。

 void ICACHE_FLASH_ATTR
 webserver_recv(void *arg, char *pusrdata, unsigned short length)
 {
     URL_Frame *pURL_Frame = NULL;
     char *pParseBuffer = NULL;
     char *index = NULL;
     SpiFlashOpResult ret = ;

     USER_DBG("len:%u\r\n",length);
     USER_DBG("Webserver recv:-------------------------------\r\n%s\r\n", pusrdata);

     pURL_Frame = (URL_Frame *)os_zalloc(sizeof(URL_Frame));
     parse_url(pusrdata, pURL_Frame);

     switch (pURL_Frame->Type) {
         case GET:
             USER_DBG("We have a GET request.\r\n");

             if(pURL_Frame->pFilename[] == ){
                 index = (char *)os_zalloc(FLASH_READ_SIZE+);
                 if(index == NULL){
                     ERR_LOG("os_zalloc error!\r\n");
                     goto _temp_exit;
                 }

                 // Flash read/write has to be aligned to the 4-bytes boundary
                 ret = spi_flash_read(0xD0*SPI_FLASH_SEC_SIZE, (uint32 *)index, FLASH_READ_SIZE);  // start address:0x10000 + 0xC0000
                 if(ret != SPI_FLASH_RESULT_OK){
                     ERR_LOG("spi_flash_read err:%d\r\n", ret);
                     os_free(index);
                     index = NULL;
                     goto _temp_exit;
                 }

                 index[HTML_FILE_SIZE] = ;   // put 0 to the end
                 data_send(arg, true, index);

                 os_free(index);
                 index = NULL;
             }
             break;

         case POST:
             USER_DBG("We have a POST request.\r\n");

             pParseBuffer = (char *)os_strstr(pusrdata, "\r\n\r\n");
             if (pParseBuffer == NULL) {
                 data_send(arg, false, NULL);
                 break;
             }
             // Prase the POST data ...
             break;
     }

     _temp_exit:
         ;
     if(pURL_Frame != NULL){
         os_free(pURL_Frame);
         pURL_Frame = NULL;
     }
 }

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

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

注意点

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