缠丝猫 发表于 2025-1-13 21:15:33

基于 Arduino IDE 搭建一个轻量的 ESP32 Web 服务器

https://i-blog.csdnimg.cn/direct/ce92f218ac1b4bd3bc4bff06c0f0a9c5.png#pic_center
ESP32 是乐鑫公司继 ESP8266 后新发布的 MCU,集成了 WiFi 模块和低功耗蓝牙模块,经常应用于物联网相关的项目。本教程将基于 Arduino IDE2.0 以上版本的软件中,搭建一个轻量的 ESP32 Web 服务器。
   [!NOTE]
Web 服务器到底是什么,它是怎样工作的?
Web 服务器是用于存储和处置处罚网页,并将其提供给 Web 客户端的装备。Web 客户端就是我们在盘算机和手机上使用的 Web 浏览器。Web 客户端和 Web 服务器使用称为超文本传输协议 (HTTP) 的特殊协议进行通讯。
https://i-blog.csdnimg.cn/direct/27e76f8dbb9d457e826a086f28c9a315.png#pic_center
在此协议中,客户端通过发送针对特定网页的 HTTP 哀求来启动对话。然后,服务器会发回该网页的内容,假如找不到,则会发回错误消息(如著名的 404 错误)。
ESP32 的 WiFi 工作模式

ESP32 不仅能够毗连到现有的 WiFi 网络并充当 Web 服务器,还可以创建自己的网络,允许其他装备直接毗连到它并访问网页。
ESP32 的 WiFi 模块可以在三种模式下运行:Station(STA)模式、软接入点(AP)模式和 STA + AP 模式。
Station(STA)模式

在 Station(STA)模式下,ESP32 毗连到现有的 WiFi 网络(由无线路由器创建的网络)。
https://i-blog.csdnimg.cn/direct/b9fb0b0513464d6891024bca49a2366d.png#pic_center
在 STA 模式下,ESP32 从其毗连的无线路由器获取 IP 地点。使用此 IP 地点,它可以设置 Web 服务器并向现有 WiFi 网络上的全部毗连装备提供网页。
软接入点(AP)模式

在接入点(AP)模式下,ESP32 会创建自己的 WiFi 网络并充当集线器,就像 WiFi 路由器一样。但是,与 WiFi 路由器差别的是,它没有有线网络的接口。因此,这种操纵模式称为软接入点(soft-AP)。别的,不能凌驾 5 个工作站同时毗连到它。
https://i-blog.csdnimg.cn/direct/f89517f6466a4d85acedc1cee0f054b4.png#pic_center
在 AP 模式下,ESP32 会创建一个新的 WiFi 网络,并为其分配一个 SSID(网络名称)和一个 IP 地点。使用此 IP 地点,它可以向全部毗连的装备提供网页。
用 ESP32 Web 服务器点灯

将 LED 毗连到 ESP32

了解了 Web 服务器工作原理的基础知识,以及 ESP32 可以创建服务器的模式,再学习两个例子学习一下,怎样通过 WiFi 进行点灯操纵。
我这里使用的是 ESP32-WROOM 单片机,再用两个 220Ω 限流电阻器分别将两个 LED 毗连到数字 D4 和 D5,接纳的接法是共阴极接法(LED 的负极和 GND 毗连,靠 GPIO 输出高电平点亮 LED)。
https://i-blog.csdnimg.cn/direct/aabf68c2c3fd4470a4eea02b01288e7d.png#pic_center
   [!NOTE]
ESP32 只是一个芯片,这个教程适用于任何基于 ESP32 计划的开发板,乃至可以用在 ESP8266 的开发板上。
示例 1 – 在 AP 模式下搭建 ESP32 Web 服务器

本示例代码是基于 Arduino 框架编写的 ESP32 步伐,步伐中创建了一个无线接入点(Access Point, AP),并在该 AP 模式下运行一个简朴的 Web 服务器。用户可以通过毗连到 ESP32 创建的 WiFi 网络,并在浏览器中输入 IP 地点来访问 Web 页面,以控制两个 GPIO 引脚上的 LED 状态。
完备的代码已经推送至我的代码堆栈,链接在文章末端,必要的小伙伴可以自取(不会 git 命令的小伙伴,也可以在找我的小助理要代码)。以下是对代码的分段分析:
包含库和定义常量

#include <WiFi.h>
#include <WebServer.h>

const char* ssid   = "ESP32";
const char* password = "12345678";

IPAddress local_ip(192,168,1,1);
IPAddress gateway(192,168,1,1);
IPAddress subnet(255,255,255,0);

WebServer server(80);

uint8_t led_1_pin = 4;
bool led_1_status = LOW;

uint8_t led_2_pin = 5;
bool led_2_status = LOW;


[*]引入了 WiFi 和 WebServer 库,用于处置处罚 Wi-Fi 毗连和 HTTP 哀求。
[*]定义了 SSID、暗码以及静态 IP 设置信息,用来设置 ESP32 作为无线接入点时的网络参数。
[*]创建了一个 WebServer 对象,监听端口 80,这是 HTTP 协议默认使用的端口。
[*]定义了两个 LED 所毗连的 GPIO 引脚编号以及它们的初始状态。
setup() 函数

void setup()
{
    Serial.begin(115200);
    pinMode(led_1_pin, OUTPUT);
    pinMode(led_2_pin, OUTPUT);

    WiFi.softAP(ssid, password);
    WiFi.softAPConfig(local_ip, gateway, subnet);
    delay(100);

    server.on("/", handle_on_connect);
    server.on("/LED1On", handle_led_1_turn_on);
    server.on("/LED1Off", handle_led_1_turn_off);
    server.on("/LED2On", handle_led_2_turn_on);
    server.on("/LED2Off", handle_led_2_turn_off);
    server.onNotFound(handle_not_found);

    server.begin();
    Serial.println("HTTP server started");
}


[*]初始化串行通讯,设置 LED 引脚为输出模式。
[*]设置 ESP32 进入软 AP 模式,并设置了静态 IP 设置。
[*]设置了 Web 服务器的路由及其对应的处置处罚函数。
[*]启动 Web 服务器,并打印一条消息表明服务器已启动。
loop() 函数

void loop()
{
    server.handleClient();
    if (led_1_status)
      digitalWrite(led_1_pin, HIGH);
    else
            digitalWrite(led_1_pin, LOW);

    if (led_2_status)
      digitalWrite(led_2_pin, HIGH);
    else
            digitalWrite(led_2_pin, LOW);
}


[*]连续调用 handleClient 方法处置处罚客户端哀求。
[*]根据 led_1_status 和 led_2_status 变量的状态更新 LED 的实际物理状态。
HTTP 哀求处置处罚器

void handle_on_connect()
{
    led_1_status = LOW;
    led_2_status = LOW;
    Serial.println("GPIO4 Status: OFF | GPIO5 Status: OFF");
    server.send(200, "text/html", send_html(led_1_status, led_2_status));
}

void handle_led_1_turn_on()
{
    led_1_status = HIGH;
    Serial.println("GPIO4 Status: ON");
    server.send(200, "text/html", send_html(true, led_2_status));
}

void handle_led_1_turn_off()
{
    led_1_status = LOW;
    Serial.println("GPIO4 Status: OFF");
    server.send(200, "text/html", send_html(false, led_2_status));
}

void handle_led_2_turn_on()
{
    led_2_status = HIGH;
    Serial.println("D5 Status: ON");
    server.send(200, "text/html", send_html(led_1_status, true));
}

void handle_led_2_turn_off()
{
    led_2_status = LOW;
    Serial.println("GPIO5 Status: OFF");
    server.send(200, "text/html", send_html(led_1_status, false));
}

void handle_not_found()
{
    server.send(404, "text/plain", "Not found");
}


[*]这些函数定义了当吸收到特定 HTTP 哀求时应执行的操纵,比方打开或关闭 LED,并发送相应的 HTML 响应给客户端。
HTML 生成函数 send_html

String send_html(uint8_t led_1_stat, uint8_t led_2_stat)
{
    String ptr = "<!DOCTYPE html> <html>\n";
    ptr += "<head><meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0, user-scalable=no\">\n";
    ptr += "<title>LED Control</title>\n";
    ptr += "<style>html { font-family: Helvetica; display: inline-block; margin: 0px auto; text-align: center;}\n";
    ptr += "body{margin-top: 50px;} h1 {color: #444444;margin: 50px auto 30px;} h3 {color: #444444;margin-bottom: 50px;}\n";
    ptr += ".button {display: block;width: 80px;background-color: #3498db;border: none;color: white;padding: 13px 30px;text-decoration: none;font-size: 25px;margin: 0px auto 35px;cursor: pointer;border-radius: 4px;}\n";
    ptr += ".button-on {background-color: #3498db;}\n";
    ptr += ".button-on:active {background-color: #2980b9;}\n";
    ptr += ".button-off {background-color: #34495e;}\n";
    ptr += ".button-off:active {background-color: #2c3e50;}\n";
    ptr += "p {font-size: 14px;color: #888;margin-bottom: 10px;}\n";
    ptr += "</style>\n";
    ptr += "</head>\n";
    ptr += "<body>\n";
    ptr += "<h1>ESP32 Web Server</h1>\n";
    ptr += "<h3>Using Access Point(AP) Mode</h3>\n";

    if (led_1_stat)
      ptr += "<p>LED1 Status: ON</p><a class=\"button button-off\" href=\"/LED1Off\">OFF</a>\n";
    else
      ptr += "<p>LED1 Status: OFF</p><a class=\"button button-on\" href=\"/LED1On\">ON</a>\n";

    if (led_2_stat)
      ptr += "<p>LED2 Status: ON</p><a class=\"button button-off\" href=\"/LED2Off\">OFF</a>\n";
    else
      ptr += "<p>LED2 Status: OFF</p><a class=\"button button-on\" href=\"/LED2On\">ON</a>\n";

    ptr += "<style>\n";
    ptr += "body {margin-top: 15%;}\n";
    ptr += ".footer-text { font-size: 30px; }";
    ptr += ".bold-text { font-weight: bold; }";
    ptr += "</style>\n";

    ptr += "<div class='footer'>";
    ptr += "<p class='footer-text'>This software was written by <span class='bold-text'>Grayson Zheng</span>.</p>";
    ptr += "</div>\n";

    ptr += "</body>\n";
    ptr += "</html>\n";
    return ptr;
}


[*]该函数构建并返回一个包含当前 LED 状态的 HTML 页面,用户可以通过这个页面与 ESP32 进行交互,控制 LED 的开关。
毗连 ESP32 Web 服务器并访问

把步伐下载至 ESP32 后,Web 服务器就启动了,这时可以用一部可以毗连到 WiFi 的手机、平板电脑或电脑等装备,搜索一个 WiFi 名为 “ESP32” 的网络。如下图所示,我使用的是小米 11:
https://i-blog.csdnimg.cn/direct/7ed9d0b2abb14210835cd3fa73d09b0d.png#pic_center 输入预设的暗码 :12345678
https://i-blog.csdnimg.cn/direct/118cc1c4dfce49328f2594712d2e5214.jpeg#pic_center 毗连成功后,如下图。这里提示一下,由于 ESP32 确实没有接入互联网,没办法访问外界的网络,不外这不影响我们加下来的操纵。小米手机在检测到当前的 WiFi 无法访问互联网的时候,会弹出提示窗口,选择 “保持毗连” 即可。其他手机不知是否有类似的提示,选择类似的操纵即可。
https://i-blog.csdnimg.cn/direct/4013f1850ce9415dbd96ce334ccef321.jpeg#pic_center 怎样打开浏览器,在地点栏输入预设的 “192.168.1.1”,然后进入即可实现点灯的操纵。假如能看到如下图一样的界面,就证明实验成功了。
https://i-blog.csdnimg.cn/direct/fedea717a2e1481a997ed3c512741376.jpeg#pic_center
整个操纵过程,会在串口有对应的输出,可以通过串口进行对应的调试:
https://i-blog.csdnimg.cn/direct/550fb4c7f26e4c7498d65e8b1dbe92c2.png#pic_center
具体操纵,如视频所示:

   ESP32 Web 服务器

示例 2 – 在 WiFi STA 模式下搭建 ESP32 Web 服务器

本示例代码同样也是基于 Arduino 框架编写的 ESP32 步伐,用于创建一个 Web 服务器,该服务器毗连到现有的 WiFi 网络(Station 模式),并提供了一个简朴的 Web 界面来控制两个 GPIO 引脚上的 LED。
完备的代码与上一个示例放在同一个堆栈,已经推送至我的代码堆栈(链接在文章末端),必要的小伙伴可以自取(不会 git 命令的小伙伴,也可以在找我的小助理要代码)。
由于大部分代码与示例 1 相同,所以接下来的代码分析只说明代码修改的部分,以下是对代码的分段分析:
包含库和定义常量

#include <WiFi.h>
#include <WebServer.h>

const char* ssid =   "Grayson";
const char* password = "Zhengxinyu13@";

// IPAddress local_ip(192,168,1,1);
// IPAddress gateway(192,168,1,1);
// IPAddress subnet(255,255,255,0);

WebServer server(80);

uint8_t led_1_pin = 4;
bool led_1_status = LOW;

uint8_t led_2_pin = 5;
bool led_2_status = LOW;
引入了 WiFi 库和 WebServer 库,另有两个 LED 所毗连的 GPIO 引脚编号以及它们的初始状态这些代码稳定。修改的地方:


[*]定义了要毗连的 WiFi 网络的 SSID 和暗码,这部分不要照抄,写自己家里的 WiFi 或者热点网络。
[*]由于是 STA 模式,静态 IP 设置信息是不必要设置的,所以这里把 AP 模式的设置静态 IP 的代码注释(删除也行)。
setup() 函数

void setup()
{
    Serial.begin(115200);
    pinMode(led_1_pin, OUTPUT);
    pinMode(led_2_pin, OUTPUT);
    delay(100);

    Serial.print("Connecting to ");
    Serial.println(ssid);

    //connect to your local wi-fi network
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED) {
      delay(500);
      Serial.print(".");
    }
    Serial.println("");
    Serial.println("WiFi connected..!");
    Serial.print("Got IP: ");Serial.println(WiFi.localIP());

    server.on("/", handle_on_connect);
    server.on("/LED1On", handle_led_1_turn_on);
    server.on("/LED1Off", handle_led_1_turn_off);
    server.on("/LED2On", handle_led_2_turn_on);
    server.on("/LED2Off", handle_led_2_turn_off);
    server.onNotFound(handle_not_found);

    server.begin();
    Serial.println("HTTP server started");
}
初始化串行通讯、设置 LED 引脚为输出模式、设置 Web 服务器的路由及其对应的处置处罚函数等稳定,去掉之前 AP 模式用到的 IP 设置。改为:


[*]每 500 毫秒尝试一次毗连到指定的 WiFi 网络
[*]成功毗连后,打印出分配给 ESP32 的本地 IP 地点。
HTML 生成函数 send_html

String send_html(uint8_t led_1_stat, uint8_t led_2_stat)
{
    ...
    ptr += "</head>\n";
    ptr += "<body>\n";
    ptr += "<h1>ESP32 Web Server</h1>\n";
    ptr += "<h3>Using Station(STA) Mode</h3>\n"; // 修改此行

    if (led_1_stat)
      ptr += "<p>LED1 Status: ON</p><a class=\"button button-off\" href=\"/LED1Off\">OFF</a>\n";
    ...
}
send_html 函数只修改了一行,把 ptr += "<h3>Using Access Point(AP) Mode</h3>\n"; 修改为 ptr += "<h3>Using Station(STA) Mode</h3>\n";。
毗连 ESP32 Web 服务器并访问

把步伐下载至 ESP32 后,Web 服务器就启动了。我们先打开 Arduino IDE 自带的串口监视器,设置波特率为 115200bps,再按一下开发板上的复位按钮(Reset),稍等一会就可以在串口监视器中看到打印信息:
https://i-blog.csdnimg.cn/direct/91d0f6ac027546ab83c3f3277a2627e2.png#pic_center
打开毗连到同一个 WiFi 的手机、平板电脑或电脑的浏览器,输入分配给 ESP32 Web 服务器的 IP 地点,就可以进行点灯操纵了。操纵过程同样会有串口的调试信息打印出来,具体过程如下:

   ESP32

代码链接

GitHub:zhengxinyu13/Simple_ESP32_Web_Server
Gitee:Grayson_Zheng/Simple_ESP32_Web_Server
GitCode:Simple_ESP32_Web_Server - GitCode
   [!NOTE]
不会使用 git 命令克隆代码的小伙伴,可以在我主页找到我助理的地球号,或者直接看下面,找我的助理领取。

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: 基于 Arduino IDE 搭建一个轻量的 ESP32 Web 服务器