当前位置：首页 > news >正文

ESP32-Web-Server 实战编程-通过网页控制设备的 GPIO

news 2025/9/14 18:03:10

ESP32-Web-Server 实战编程-通过网页控制设备的 GPIO

概述

前述博客讲解了 Web 编程的基本知识，包括 HTML、CSS、JavaScript 三个部分，从这节开始，我们进入实战部分，在实际项目中进一步学习 ESP32-Web 编程。

GPIO （General Purpose Input/Output）是通用输入输出口，本节演示通过网页控制 GPIO 输出高、低电平。你可以将一个灯泡连接到对应受控的 GPIO 上，这样就可以通过网页实际控制灯泡的亮灭了。

需求及功能解析

通过网页的按钮触发 web server 的回调 handler，然后在对应的 handler 中控制 GPIO 输出高、低电平。

目录结构

├── CMakeLists.txt
├── main
│   ├── CMakeLists.txt
│   └── main.c                 User application
├── components
│   └── fs_image└── index.html└── ...
|	└── url_handlers└── url_handlers.c└── ...
└── README.md                  This is the file you are currently reading

目录结构主要包含主目录 main，以及组件目录 components.
其中组件目录components中包含了用于存储网页文件的 fs_image 目录（即前述前端文件），以及用于记录 ESP32 上接收来自服务器的请求，并作出响应的 url_handlers 目录（即后端文件）。如前所述，浏览器可以通过 URL 请求服务器端的资源（包括数据和文件），每个 URL 到来时都可以设计一个函数，来决定如何响应该 URL 请求，这便是 url_handlers 要完成的功能。

前端设计

前端代码中主要是建立两个按钮ON、OFF，它们分别控制GPIO 输出的开、关。

<a href="gpio2_on"><button class="button-on">ON</button></a>
<a href="gpio2_off"><button class="button-off">OFF</button></a>

该示例没有使用 JS，直接在 HTML 中使用 button 对象的 button on\button off 方法。

后端代码

后端代码中增加了两个对应于前端 “/gpio2_on”、“/gpio2_off” 的handler，用于响应点击对应按钮时后端的处理。

httpd_uri_t peri_httpd_uri_array[] = {{"/gpio2_on", HTTP_GET, light_on_get_handler, NULL},{"/gpio2_off", HTTP_GET, light_off_get_handler, NULL},
};

此外，主程序中还增加了初始化 GPIO 的操作：

static void configure_led(void)
{ESP_LOGI(TAG, "Example configured to blink GPIO LED!");gpio_reset_pin(BLINK_GPIO);/* Set the GPIO as a push/pull output */gpio_set_direction(BLINK_GPIO, GPIO_MODE_OUTPUT);
}

关于 ESP32 的 GPIO 的 API，大家可以参考 ESP32 GPIO。

编译并烧录固件到设备中可参考 ESP32-Web-Server编程-建立第一个网页。