ESP32 电子相框 esp32-photoframe

ESP32 2/5 已发布
aitjcize 131 Stars MIT BOM 完整度: 0/5 教程完整度: 0/5
ESP32 电子相框

项目简介

ESP32电子纸固件,功能丰富,图像质量卓越。


ESP32 PhotoFrame 是一个专为 ESP32 芯片驱动的电子墨水屏相框打造的开源固件项目,目前支持 Waveshare PhotoPainter、Seeed Studio XIAO EE02/EE04 以及 reTerminal E1002 等主流设备。它的核心使命是替代设备自带的原厂固件,通过一套强大的 RESTful API、现代化的 Web 管理界面以及显著提升的图像显示质量,彻底改变电子墨水屏相框的使用体验。

标签

项目特点

🎨 **卓越画质**:使用实测色彩调色板,配合自动校准,图像效果远超原厂固件
🔋 **智能电源管理**:深度睡眠模式实现数周续航,或始终在线模式配合 Home Assistant
📁 **灵活图片来源**:支持 SD 卡轮播、URL 获取(天气、新闻、随机图片)
🌐 **现代 Web 界面**:拖拽上传、画廊视图、实时电池状态
📱 **移动端 App**:配套 App 支持 WiFi 配置、图像处理和 AI 生成
🖼️ **图像服务器**:配套服务器支持 Google Photos、Synology DS Photos 和 Telegram Bot
🏠 **Home Assistant 集成**:提供官方集成,实现控制、监控和自动化
🔌 **RESTful API**:完整的程序化控制接口
🤖 **AI 图像生成**:支持 OpenAI (GPT Image, DALL-E) 和 Google Gemini

技术规格

主控芯片 ESP32-S3
支持显示屏 7.3" 7色 / 13.3" 6色 / 7.3" 6色 电子墨水屏
存储方式 SD卡 (SDIO/SPI) / 内部Flash (LittleFS)
电源管理 深度睡眠 (~10μA) / 始终在线 (~40-80mA)
连接方式 WiFi 2.4GHz
图像格式 JPEG, BMP, PNG
图像算法 Floyd-Steinberg 抖动 + 实测色彩调色板
固件升级 Web 刷写 / esptool.py 手动刷写
配套生态 Home Assistant 集成、图像服务器、移动端 App

项目资源

物料清单 (BOM)

物料名称 数量 参考价格 备注
ESP32-S3 开发板 (如 Waveshare PhotoPainter) 1 根据所选硬件型号
电子墨水屏 (7.3" 或 13.3") 1 与主控板配套
microSD 卡 (可选) 1 用于图片存储和WiFi配置
锂电池 (可选) 1 用于便携使用
USB-C 数据线 1 用于供电和刷写

能力画像

⚪ 记忆与知识检索: 1/5
🔵 逻辑推演: 2/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 1/5
⚪ 数理与计算: 2/5
🔵 动手与操作: 3/5
⚪ 狂热与坚持: 2/5
⚪ 创造与创新: 2/5

所需技能

🔧 **动手能力**:需要掌握基本的硬件连接和刷写操作,如使用 USB 数据线连接设备、进入下载模式、刷写固件等。 💻 **编程能力**:具备基础的命令行操作能力,能够使用 esptool.py 或 Web 刷写工具。如需从源码构建,则需要 Python 和 ESP-IDF 开发环境知识。 ⚡ **电子电路**:了解基本的电源管理概念,如深度睡眠和电池供电,但无需复杂的电路设计知识。

适用场景

**智能家居数字相框**:作为 Home Assistant 的配件,自动轮播家庭照片或显示天气、新闻等信息。
**个人桌面装饰**:在办公室或家中展示个人照片、艺术作品或 AI 生成的图像。
**信息展示终端**:在商店、展览或会议中显示宣传海报、日程安排或实时数据。
**远程照片分享**:通过配套的图像服务器,从 Google Photos、Synology DS Photos 或 Telegram Bot 远程推送照片到相框。