【ESP32 C++教程】Unit9-2:文件系统应用

本小节是一个Web服务结合SD卡文件系统的应用示例。

在前面使用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文件夹内。

编译项目并上传开发板检验

【ESP32 C++教程】Unit9-2:文件系统应用

用手机连接热点并访问192.168.5.1

【ESP32 C++教程】Unit9-2:文件系统应用

- 本文由用户 老张 发布,文中观点仅代表作者本人,不代表本站立场。
- 如需转载,请联系作者;如有侵权,请联系本站处理。

03-31   阅读(1)   评论(0)
 标签: 编程 ESP32 ESP32-ArduinoFx

涨知识
GPIO

GPIO 是指单片机(微控制器)主板上的一组引脚,这些引脚可以发送或接收电信号,但它们不是为任何特定目的而设计的,这就是为什么它们被称为“通用”IO。

评论:
相关文章
【ESP32 C++教程】Unit9-1:文件系统

本节主要讲解FileSystem类的使用,以及Flash文件系统配置和SD存储模块的使用。


【ESP32 C++教程】Unit8-2:Wifi热点和网页上控制设备

本节主要讲解Wifi热点的Web服务使用,以及使用网页交互来控制LED。


【ESP32 C++教程】Unit8-1:WiFi连接和HTTP请求

本节主要讲解WifiBoard类的功能和HTTPClient库及cJSON的使用。


【ESP32 C++教程】Unit7-3:TFT-LCD显示屏

本节主要讲解TFT-LCD显示屏的使用和Window派生类与TFT_eSPI库的使用。


基于STEAM教育和设计思维的初中化学跨学科实践活动——基于血氧指标控制的简易供氧器设计与制作

这篇文章展示了如何将化学与工程、信息技术、现代制造技术紧密结合,以“血氧指标控制的简易供氧器”为载体,组织一次真实的跨学科项目。设计中突出“从需求出发”“闭环控制”“可视化反馈”,不仅呼应了新课标中“跨学科实践”的要求,更贴近生活实际需求,尤其适用于对科技应用、健康关怀有兴趣的学生群体,可作为项目式学习或社团活动的优质课例。


【ESP32 C++教程】Unit7-2:OLED显示屏

本节主要讲解OLED显示屏的使用和Display类及派生类的介绍及使用。


【ESP32 C++教程】Unit7-1:四位7段式数码管

本节主要讲解用TM1650来驱动四位7段式数码管模块的显示使用。


【ESP32 C++教程】Unit6-4:资源互斥访问

本节主要讲解FreeRTOS任务间如何使用互斥对象来实现资源互斥访问。


ESP32 Guru Meditation Error报错定位分析

在ESP32的开发,经常会有系统崩溃一直重启的情况,那么如何快速定位出现异常的代码呢?


【ESP32 C++教程】Unit6-3 FreeRTOS任务间通信

本节主要讲解FreeRTOS任务间如何使用消息队列、事件组和二进制信号量进行通信。