在前面使用Web服务的小节中,HTML字符串占用了宝贵的FLASH存储空间,若Web服务还包括图片、CSS、JS等大量文件,那么最好是用SD卡存储来实现,本小节就是一个Web服务结合SD卡文件系统的例子。
从 https://gitee.com/billyzh/esp32-cpp-lesson 下载本教程的源码到本地硬盘文件夹,如d:\esp32-cpp-lesson
在VSCode中,选择【文件】->【打开文件夹...】选择上一步保存的文件夹打开
打开项目后,选择config.h文件,修改第10行为
#define APP_LESSON92 1
打开unit9-lesson92/app_config.h文件,设置应用的相关配置
#define CONFIG_USE_WIFI 1 //启用WiFi #define CONFIG_USE_FS 1 //启用文件系统模块
#define CONFIG_USE_DISPLAY 1 //启用显示模块
#define CONFIG_USE_TFT_ESPI 1 //使用TFT_eSPI显示驱动
板级配置同前一小节
MyBoard修改为继承WiFiBoard类,代码见(unit9-lesson2/my_board.h)
创建FileSystem实例,同前一小节,代码见(unit9-lesson2/my_board.cpp)
WiFi网络启用代码(unit9-lesson92/my_application.cpp)
void MyApplication::OnInit() {
WifiBoard *board = (WifiBoard*)(&Board::GetInstance());
Display *display = board->GetDisplay();
display->Rotate(1);
//一、使用热点
char *ssid = "esp32_ap";
bool success = board->StartAP(ssid, ap_ip, ap_gateway, ap_subnet);
std::string message = "AP:" + std::string(ssid) + ", IP:" + std::string(ap_ip.toString().c_str());
// //二、连接已有WiFi网络
// bool success = board->StartNetwork("ssid", "password", 10000);
// std::string message = "IP:" + board->GetIpAddress();
if (success) {
Log::Info(TAG, message.c_str());
display->GetWindow()->SetText(1, message);
StartWebServer();
} else {
Log::Warn(TAG, "连接失败。");
display->GetWindow()->SetText(1, "连接失败。");
}
}
在应用类的OnInit方法中,先获得Board的实例并转换为WifiBoard类型,然后调用StartAP方法启动热点,参数1是热点名称,参数2,3,4分别是IP地址,网关和子网掩码;
若热点创建成功,在TFT-LCD显示屏上显示IP地址,否则显示“热点创建失败”
Web服务启动代码(unit9-lesson92/my_application.cpp)
void MyApplication::StartWebServer() {
webserver_ = new WebServer(80);
webserver_->onNotFound([this]() { HandleDefault(); });
webserver_->begin();
webtask_ = new FrtTask("WebServer");
webtask_->OnLoop([this](){
webserver_->handleClient();
delay(1);
});
webtask_->Start(8192, tskIDLE_PRIORITY+1);
}
程序解读
1.首先创建WebServer实例,使用80端口;
2.设置onNotFound的响应程序,当请求路径匹配不到on函数定义的路径时,会调用这个程序,在这里就是所有请求路径都用这个响应程序来处理。
3.调用实例webserver_的begin方法启动Web服务;
4.创建一个任务并使用handleClient方法监听Web请求,这是必须的,否则将无法响应。
文件输出代码(unit9-lesson92/my_application.cpp)
void MyApplication::HandleDefault() {
Display *display = Board::GetInstance().GetDisplay();
FileSystem *fsys = Board::GetInstance().GetFileSystem();
if (fsys == nullptr) {
webserver_->send(500, "text/plain", "文件系统求初始化。");
display->GetWindow()->SetText(2, "FileSystem init failed.");
return;
}
String path = "/html" + webserver_->uri();
if (fsys->ExistsFile(path.c_str())) {
OutputFile(path);
display->GetWindow()->SetText(3, "输出文件:" + std::string(path.c_str()));
return;
}
webserver_->send(404, "text/plain", "File not found.");
Log::Warn(TAG, "%s not found", path.c_str());
}
void MyApplication::OutputFile(String path) {
String dataType = "text/plain";
if (path.endsWith("/")) {
path += "index.html";
}
if (path.endsWith(".htm") || path.endsWith(".html")) {
dataType = "text/html";
} else if (path.endsWith(".css")) {
dataType = "text/css";
} else if (path.endsWith(".js")) {
dataType = "application/javascript";
} else if (path.endsWith(".png")) {
dataType = "image/png";
} else if (path.endsWith(".gif")) {
dataType = "image/gif";
} else if (path.endsWith(".jpg")) {
dataType = "image/jpeg";
}
FileSystem *fsys = Board::GetInstance().GetFileSystem();
File f = fsys->OpenFile(path.c_str());
webserver_->streamFile(f, dataType); // 输出文件内容
f.close();
}
程序解读
1.先通过WebServer实例的uri方法取得文件名;
2.然后通过FileSystem实例读取文件;
3.最后通过WebServer实例的streamFile方法发给文件内容给请求者;
复制unit9-lesson92/html/内的文件到SD卡的html文件夹内。
编译项目并上传开发板检验

用手机连接热点并访问192.168.5.1

GPIO 是指单片机(微控制器)主板上的一组引脚,这些引脚可以发送或接收电信号,但它们不是为任何特定目的而设计的,这就是为什么它们被称为“通用”IO。
本节主要讲解FileSystem类的使用,以及Flash文件系统配置和SD存储模块的使用。
本节主要讲解Wifi热点的Web服务使用,以及使用网页交互来控制LED。
本节主要讲解WifiBoard类的功能和HTTPClient库及cJSON的使用。
本节主要讲解TFT-LCD显示屏的使用和Window派生类与TFT_eSPI库的使用。
这篇文章展示了如何将化学与工程、信息技术、现代制造技术紧密结合,以“血氧指标控制的简易供氧器”为载体,组织一次真实的跨学科项目。设计中突出“从需求出发”“闭环控制”“可视化反馈”,不仅呼应了新课标中“跨学科实践”的要求,更贴近生活实际需求,尤其适用于对科技应用、健康关怀有兴趣的学生群体,可作为项目式学习或社团活动的优质课例。
本节主要讲解OLED显示屏的使用和Display类及派生类的介绍及使用。
本节主要讲解用TM1650来驱动四位7段式数码管模块的显示使用。
本节主要讲解FreeRTOS任务间如何使用互斥对象来实现资源互斥访问。
在ESP32的开发,经常会有系统崩溃一直重启的情况,那么如何快速定位出现异常的代码呢?
本节主要讲解FreeRTOS任务间如何使用消息队列、事件组和二进制信号量进行通信。