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编程-建立第一个网页。
示例效果
在网页点击 ON 后,浏览器将向服务器发起 Get 请求,实际发起的 URL 为:http://192.168.47.100/gpio2_on。
可以参考上节讲述的方法,打开浏览器的设置,使用开发者工具查看发起的HTTP请求。
讨论
1)前端与后端代码建立联系的关键是,前端使用的关键字与后端使用的关键字一致。如本例程中的前端代码中 href="gpio2_on"
与后端 handler 中的 /gpio2_on
保持一致。
总结
1)本节介绍了典型的物联网项目-在 ESP32 中通过 Web Server 的网页控制设备的 GPIO。
2)前端代码与后端代码一致的关键是-前后端代码使用的关键字要一致。
资源链接
1)ESP32-Web-Server ESP-IDF系列博客介绍
2)对应示例的 code 链接 (点击直达代码仓库)
3)下一篇:ESP32-Web-Server 实战编程-通过网页控制设备多个 GPIO
(码字不易感谢点赞或收藏)