代码收藏家技术教程 2023-05-28

ESP32简易Web服务器实现

本文介绍一下如何使用ESP32快速方便的搭建一个简易的web服务器。

使用ESP32或ESP8266搭建web服务器的方式有很多，但是大多数都的web页面代码都是内嵌在程序中的，这样如果要修改web页面就十分的不方便。今天介绍一种方法将web页面的代码以文件的形式上传到存储器中，然后在程序中直接利用文件搭建web服务器。

这里首先介绍一下SPIFFS。

SPIFFS又叫SPI闪存文件系统。是一种小型嵌入式系统专用的文件系统。它支持用户创建文件和目录。

以下是SPIFFS的主要特点：

专为微控制器上的低 RAM 使用场景而设计；

使用固定大小的 RAM 缓冲区；

Posix-like api：打开，关闭，读取，写入，搜索，统计等；

POSIX：Portable Operating System Interface 可移植操作系统接口；

不仅仅是SPI闪存 (SPI Flash:Serial Peripheral interface 串行外围设备接口, 串行通信接口的NOR FLASH),它可以在任何非易失闪存（NOR Flash）上运行，多个 SPIFFS 配置可以在同一目标上运行甚至可以在同一个 SPI 闪存设备上运行；

实现静态磨损均衡；

内置的系统一致性检查；

高度可配置，可适用于各种闪存类型。

使用Arduino进行ESP32开发时，开发套件中集成有SPIFFS可以直接使用。但是开发工具中不具有文件上传功能，所以首先需要给ArduinoIDE添加SPIFFS文件上传插件。

首先下载文件上传工具，可以在下面的链接处下载，也可以在文末分享的链接处下载。

GitHub – me-no-dev/arduino-esp32fs-plugin: Arduino plugin for uploading files to ESP32 file system

将所下载的文件“esp32fs.jar”放置到Arduino安装目录下的工具文件夹中。如F:\arduino-1.8.19\tools\ESP32FS\tool。然后重启Arduino IDE。

重启Arduino IDE后在工具菜单下就可以看到“ESP32 Sketch Data Upload”选项，通过该选项就可以将工程目录下data文件夹中的文件上传到ESP32的文件存储系统中。上传过程中一定要关闭ESP32的串口监视器窗口，否则会导致上传失败。

文件上传工具安装完成后，接下来需要安装异步web服务器库。主要包括ESPAsyncWebServer和AsyncTCP两个库。通过这两个库可以实现简单的异步web服务器的搭建。

异步web服务器有以下优点：

使用异步意味着服务器可以同时处理来自客户端的多个连接；

一旦请求准备好并被解析，您就会被调用；

当您发送响应时，您可以立即准备好处理其他连接，而服务器会在后台处理发送响应

速度很快；

易于使用的 API、HTTP Basic 和 Digest MD5 身份验证（默认）、ChunkedResponse；

易于扩展以处理任何类型的内容；

支持继续 100；

异步 WebSocket 插件提供不同的位置，无需额外的服务器或端口；

Async EventSource (Server-Sent Events) 插件向浏览器发送事件；

用于条件和永久 URL 重写的 URL 重写插件；

支持缓存、Last-Modified、默认索引等的 ServeStatic 插件；

处理模板的简单模板处理引擎；

两个库的下载地址如下：

ESPAsyncWebServer https://github.com/me-no-dev/ESPAsyncWebServer

AsyncTCP https://github.com/me-no-dev/AsyncTCP

两个库安装完成后就可以开始创建web页面了。web前端页面的开发工具有很多，自行选择一种喜欢的方式就可以了。

    <!DOCTYPE html>
    <html>
      <head>
        <meta charset="utf-8">
        <link rel="stylesheet" type="text/css" href="style.css">
        <title>懂事电子设计</title>
      </head>
      <body>
        <h1>懂事电子设计</h1>
        <p>这是一个测试网页</p>
        <img border="0" src="1.jpg" alt="Pulpit rock" width="500" height="500">
      </body>
    </html>

使用Arduino IDE创建ESP32工程。在工程下创建data文件夹，并将创建的HTML程序文件放到data文件夹内。然后依次点击”工具”->”ESP32 Sketch Data Upload”将WEB程序文件上传到ESP32存储器中。

修改程序中的WIFI信息，点击上传到ESP32即可。

上传完成后可以打开串口监视窗口，等ESP32完成网络连接后会输出对应的IP地址。使用同一网络下的PC或手机的浏览器访问该IP即可进入到web页面。

#include <WiFi.h>
#include <SPIFFS.h>
#include "ESPAsyncWebServer.h"
AsyncWebServer server(80);
//连接WIFI
void connect_wifi(){
  const char* wifi_ssid = "***";
  const char* wifi_password = "********";
  Serial.begin(115200);
  WiFi.begin(wifi_ssid, wifi_password);         //连接WIFI
  Serial.print("Connected");
  //循环，直到连接成功
  while(WiFi.status() != WL_CONNECTED){
    Serial.print(".");
    delay(500);
  }
  Serial.println();
  IPAddress local_IP = WiFi.localIP();
  Serial.print("WIFI is connected,The local IP address is "); //连接成功提示
  Serial.println(local_IP); 
}
 
void web_server(){
 if(!SPIFFS.begin(true)){
    Serial.println("An Error has occurred while mounting SPIFFS");
    return;
  }
  server.serveStatic("/", SPIFFS, "/").setDefaultFile("index.html");
  server.begin();                       //初始化
}
 
void setup() {
  connect_wifi();
  web_server();
}
 
void loop() {
 
}