电子墨水显示项目安装与配置指南

1. 项目基础介绍

本项目是基于电子墨水显示技术的一个开源项目，主要利用电子墨水屏幕的低功耗、长续航以及阳光下可读等特点，设计了一个可定制的显示系统。用户可以通过配置不同的插件，在电子墨水屏幕上显示天气信息、时间、音乐控制界面、新闻摘要等内容。该项目主要使用Python编程语言开发。

2. 关键技术与框架

• Python：作为主要的编程语言，用于实现项目的逻辑和用户界面。
• PyInstaller：用于将Python代码打包成可执行的独立程序，方便部署和运行。
• Systemd：Linux系统中的服务管理器，用于项目作为后台服务运行。
• WaveShare电子墨水屏：该项目支持多种WaveShare品牌的电子墨水屏幕，通过SPI接口与Raspberry Pi连接。

3. 安装和配置准备工作

在开始安装之前，请确保您已经准备好以下环境：

• 硬件：Raspberry Pi（推荐型号为4，但3和Zero也可以使用）、支持的WaveShare电子墨水屏幕、电源、SD卡等。
• 操作系统：Raspberry Pi OS Buster或更新的版本（64位支持）。
• 网络连接：确保您的Raspberry Pi可以连接到互联网。

详细安装步骤

1. 启用SPI接口

   在Raspberry Pi上启用SPI接口：

   sudo raspi-config
   > Interface Options > SPI > Yes
   

   重启Raspberry Pi。

2. 安装依赖

   安装项目所需的Python依赖和其他软件包：

   sudo apt-get update
   sudo apt-get install python3-pip git
   sudo pip3 install pipenv
   

3. 克隆项目

   使用git克隆项目仓库：

   git clone https://github.com/txoof/epd_display.git
   cd epd_display
   

4. 创建虚拟环境并安装依赖

   创建项目的Python虚拟环境并安装所需依赖：

   pipenv --python 3.7
   pipenv install
   

5. 构建项目

   构建项目文件：

   ./build.sh
   

   构建完成后，可执行文件会存放在./dist/目录下。

6. 配置项目

   第一次运行项目时，会自动生成配置文件。编辑该配置文件以匹配您的硬件和需求：

   nano ~/.config/com.txoof.paperpi/paperpi.ini
   

   在配置文件中至少指定display_type参数，如果使用的是HD IT8951显示屏幕，还需要设置vcom值。

7. 运行项目

   运行项目以查看效果：

   ./paperpi/dist/paperpi
   

   按下ctrl+c可以干净地关闭paperpi。

8. 设置为后台服务（可选）

   如果您希望项目在系统启动时自动运行，可以将其设置为后台服务：

   sudo ./install.sh
   

   然后编辑/etc/defaults/paperpi.ini配置文件，并使用以下命令启动服务：

   sudo systemctl restart paperpi
   

按照上述步骤，您应该能够成功安装并运行电子墨水显示项目。如果遇到任何问题，请参考项目文档或向社区寻求帮助。