开源项目：E-paper Photo Frame (EPF) 使用与启动教程

开源项目：E-paper Photo Frame (EPF) 使用与启动教程

EPF epaper photo frame 项目地址: https://gitcode.com/gh_mirrors/epf1/EPF

1. 项目介绍

E-paper Photo Frame（EPF）项目是一款利用ESP32和电子纸显示技术打造的照片展示框架。该项目通过 Immich 服务组织相册和照片，利用 Flask 服务器在NAS或云服务器上处理图像，然后快速显示在电子纸屏幕上。特点是支持节能模式、快速更新照片，并且可以通过服务器网页进行显示设置。

2. 项目快速启动

环境准备

• ESP32-C6开发板
• 7.3英寸E Ink Spectra 6（E6）全彩电子纸显示模块
• Li-Po电池（带PH2.0接口）
• 一个用于唤醒和设置的按钮

克隆仓库

git clone https://github.com/jwchen119/epf.git

构建Docker镜像

docker build -t epf .

或者，你可以从DockerHub下载预编译的镜像：

docker pull jwchen119/epf

运行容器

创建容器时，不要忘记编辑Immich API密钥。

docker run --name epf -e IMMICH-API-KEY='<你的Immich API密钥>' -d -p <替换端口号>:5000 jwchen119/epf

配置

编辑config.yaml文件（如果需要的话），配置Immich的专辑名称、照片旋转角度、服务器URL、颜色增强等级和对比度等级。

硬件连接

根据正确的接线图连接EPD、ESP32-C6、Li-Po电池和设置按钮。

编译与上传

1. 安装并设置Arduino IDE。
2. 连接ESP32-C6。
3. 将仓库中的Arduino文件夹重命名为epd7in3e。
4. 打开epd7in3e.ino文件。
5. 在Arduino库管理器中安装以下库：Arduinojson、Async TCP、ESP Async Web Server。
6. 点击“上传”按钮。

设置Wi-Fi

上传后，连接到ESP32创建的Wi-Fi热点ESP32_ePAPER，在出现的捕获门户中输入你的Wi-Fi详情和Docker容器的细节。

3. 应用案例和最佳实践

• 节能模式: 在不需要显示时，可以让设备进入深度睡眠，以节省电力。
• 自定义显示: 通过服务器网页配置显示设置，如照片方向、基本颜色调整等。
• 自动化管理: 利用Immich服务自动同步照片到相框，无需手动操作。

4. 典型生态项目

目前，EPF项目是基于以下开源项目和技术构建的：

• ESP32-C6开发板：用于驱动显示和连接Wi-Fi。
• Immich：一个开源的相册组织服务。
• Flask：用于创建Web服务，处理图像和配置信息。
• Arduino IDE：用于编译和上传代码到ESP32-C6。
• Docker：用于运行Web服务容器。

通过这些技术的结合，EPF项目为用户提供了一个易于配置和维护的电子照片展示解决方案。

EPF epaper photo frame 项目地址: https://gitcode.com/gh_mirrors/epf1/EPF