使用Web页面配置ESP8266的参数

时间:2023-03-08 16:13:07

前言  

  使用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请求数据。

使用Web页面配置ESP8266的参数

  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的烧录截图。

使用Web页面配置ESP8266的参数