项目使用与配置指南

1. 目录结构及介绍

epd_display 项目包含以下几个主要目录和文件：

• documentation：存放项目的文档资料。
• install：包含用于安装和配置项目的脚本文件。
• paperpi：项目的核心代码目录，包含主程序和相关插件。
• .gitignore：定义 Git 忽略的文件和目录。
• LICENSE：项目使用的 GPL-3.0 许可文件。
• Pipfile：用于定义项目依赖的 Pipfile 文件。
• README.ipynb 和 README.md：项目的说明文件，分别以 Jupyter Notebook 和 Markdown 格式存储。
• build.sh 和 create_devel_venv.sh：构建项目和创建开发环境的脚本文件。
• install.sh：用于将项目安装为系统服务的脚本。
• 其他文件：包括配置文件、脚本和示例代码等。

2. 项目的启动文件介绍

项目的启动文件是位于 paperpi/dist/paperpi 的可执行文件。在第一次运行时，它会创建一个配置文件 ~/.config/com.txoof.paperpi/paperpi.ini，然后退出。用户需要编辑这个配置文件来指定显示类型和其他设置。

启动项目的方法如下：

./paperpi/dist/paperpi

如果想要将项目作为守护进程在系统启动时运行，可以使用 install.sh 脚本进行安装：

sudo ./install.sh

3. 项目的配置文件介绍

项目的配置文件是 paperpi.ini，它可以在两个位置：

• 对于单用户运行，配置文件位于 ~/.config/com.txoof.paperpi/paperpi.ini。
• 对于系统服务运行，配置文件位于 /etc/defaults/paperpi.ini。

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

以下是配置文件的一个示例：

[display]
display_type = epd2in7
vcom = 0.0

根据具体的显示屏幕和项目需求，还可能需要配置其他插件和设置。在编辑配置文件后，重新启动项目以应用新的设置。

# 对于单用户运行
./paperpi/dist/paperpi

# 对于系统服务运行
sudo systemctl restart paperpi

确保在更改配置后正确地启动或重启项目，以查看新的配置是否生效。