可DIY的树莓派墨水屏电子相框

一、硬件准备

• 树莓派任意版本（项目在树莓派5测试使用，外壳以树莓派5为基准设计）
• 7 寸 e6 800×480 墨水屏（这里使用的是微雪带模块的版本）
• 电商平台买的成品相框源头工厂小清新相框摆台带打印加相片挂墙6六7七8十寸相册A4批发-淘宝网
• 若干3D打印结构件

二、系统设置（打开SPI接口）

进入配置工具：

sudo raspi-config

按顺序设置：

• Interface Options
  • SPI → Enable

完成后重启：

sudo reboot

三、安装系统依赖（如使用最新树莓派镜像系统基本都是自带的库）

Python 基础库

sudo apt install -y \
    python3-pip \
    python3-pil \
    python3-numpy \
    python3-spidev \
    python3-rpi.gpio

---

Flask（Web 服务）

pip3 install flask

四、部署项目代码

将此文件上传即可：

epaper_frame.py

五、首次运行测试

启动程序

python epaper_frame.py

你应该看到类似输出：

 * Running on http://0.0.0.0:3096

---

浏览器访问

在手机或电脑浏览器中访问：

http://树莓派IP:3096

你应该看到：

• “墨水屏电子相框”页面
• 可选择图片
• 可拖动 / 缩放 / 裁剪

上传完成后：

• /home/pi/printouts/ 中生成图片
• 墨水屏刷新显示

---

六、设置开机自启动（推荐）

创建 systemd 服务

sudo nano /etc/systemd/system/epaper-frame.service

内容如下：

[Unit]
Description=E-Ink Photo Frame Server
After=network.target

[Service]
ExecStart=/usr/bin/python3 /home/pi/epaper_frame/epaper_frame.py
WorkingDirectory=/home/pi/epaper_frame
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

---

启用服务

sudo systemctl daemon-reload
sudo systemctl enable epaper-frame
sudo systemctl start epaper-frame

查看状态：

sudo systemctl status epaper-frame