ESP32 电子相框 esp32-photoframe

ESP32 ⭐⭐☆☆☆ (2/5) 已发布
aitjcize 131 Stars MIT BOM 完整度: /5 教程完整度: /5
查看源码

项目简介

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

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

标签

esp32 e-ink e-ink-display e-ink-frame e-paperdisplay epaper epaper-displays photoframe

项目特点

🎨 **卓越画质**：使用实测色彩调色板，配合自动校准，图像效果远超原厂固件
🔋 **智能电源管理**：深度睡眠模式实现数周续航，或始终在线模式配合 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

技术规格

主控芯片
支持显示屏
存储方式
电源管理
连接方式
图像格式
图像算法
固件升级
配套生态

项目资源

aitjcize/esp32-photoframe aitjcize.github.io/esp32-photoframe esp32-photoframe/#flash aitjcize/esp32-photoframe aitjcize/esp32-photoframe aitjcize/esp32-photoframe aitjcize/ha-esp32-photoframe aitjcize/esp32-photoframe-server esp-frame/id6762510995?l=en-GB apps/details?id=com.aitjcize.espframe g/esp32-photoframe-app-testers aitjcize/epaper-image-convert balloob/home-assistant-addons aitjcize/esp32-photoframe

物料清单 (BOM)

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

所需工具

工具用途是否必需
电脑 (Chrome/Edge/Opera) Web 刷写固件 ✅ 是
USB-C 数据线 连接设备与电脑 ✅ 是
esptool.py (可选) 手动刷写固件 ▢ 推荐
Python 3 + ESP-IDF (可选) 从源码构建 ▢ 推荐
移动端 App (可选) WiFi 配置和图像管理 ▢ 推荐

能力画像

记忆与知识检索
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 远程推送照片到相框。