ESP32-C3 多功能信号灯

ESP32C3 多功能信号灯

介绍

本项目是一个基于 ESP32C3 微控制器的高性能交互式显示与多媒体控制平台。它不仅限于简单的信号灯显示，而是支持多路 LCD 屏幕控制、高清 JPEG/音频解码、动画播放以及音频录制功能。设备可通过 WiFi 连接，并提供 Web 界面进行实时控制。

Gitee代码：https://gitee.com/pei_lin_chen/esp32c3duogongnengxinhao
B站：https://www.bilibili.com/video/BV1cUud6nE45/?share_source=copy_web&vd_source=dc80a4130cfa2e450586ea8478dd1334

免焊通道：https://item.taobao.com/item.htm?ft=t&id=1066540678264

功能特性

• 多通道显示：支持 3 路独立 LCD 屏幕控制（GC9A01 驱动），支持 JPEG 图片解码、静态显示与 GIF 动画播放。
• 音频处理：集成 ES8311 音频编解码器，支持 MP3 播放及 WebSocket 实时音频流录制与回放。
• 无线配网：
  • SmartConfig/AP 配网：支持 AP (热点) 模式，浏览器访问即可配网。
  • mDNS：支持通过 http://esp32.local/ 域名访问设备。
• Web 控制界面：提供基于浏览器的可视化操作面板，支持同时控制多个显示通道及音频设备。
• API 接口：提供完整的 REST API 和 WebSocket 接口，方便第三方集成或程序化控制。

硬件需求

• 主控：ESP32C3
• 显示：GC9A01 SPI LCD 屏幕（支持 1.9寸圆形屏幕等）
• 音频：ES8311 I2S 音频编解码器
• 存储：支持 MicroSD 卡或内置 SPIFFS 存储多媒体资源
• 外壳模型：MakerWorld - LCD屏幕款创意信号灯

软件架构

• 开发框架：ESP-IDF (Espressif IoT Development Framework)
• 前端：HTML5 + CSS3 + JavaScript (构建为 SPIFFS 镜像)
• 核心模块：
  • main/display/: 屏幕初始化、像素处理及 JPEG 渲染核心
  • main/audio/: ES8311 音频驱动及 I2S 数据流处理
  • main/wifi/: WiFi 管理器及 Captive Portal (强制门户) 实现
  • main/file_server/: HTTP/WebSocket 服务器，处理文件上传及 API 请求
  • main/settings/: NVS 存储模块，保存系统配置

快速开始

1. 安装依赖
   确保已安装 ESP-IDF 环境及 Node.js。

2. 构建前端资源
   项目包含一个构建脚本，用于压缩前端代码并生成 SPIFFS 镜像：

   node build.js
   

3. 编译固件

   idf.py build
   

4. 烧录与监控

   idf.py -p  flash monitor
   

配网流程

1. 设备首次启动后，进入 AP 模式。
2. 使用手机或电脑连接以 ESP_XXXXXX 开头的热点。
3. 连接成功后，浏览器将自动弹出（或手动访问 192.168.4.1）配网页面。
4. 输入当前环境的 WiFi 名称和密码，设备重启后即自动连接。

使用说明

• 设备联网后，确保终端设备（手机/电脑）与设备处于同一局域网。
• 打开浏览器，访问 http://esp32.local/ 即可进入交互界面。

API 文档

详细的接口说明（包括 WebSocket 音频流、显示画面传输及 REST API）请参考项目根目录下的 API.md 文件。

项目图片

(此处预留项目演示及硬件连接示意图位置)