首页
/ eInkCalendar 开源项目使用教程

eInkCalendar 开源项目使用教程

2025-04-16 13:22:12作者:吴年前Myrtle

1. 项目的目录结构及介绍

eInkCalendar 项目是一个基于 Python 的电子墨水日历开源项目。以下是项目的目录结构及文件介绍:

eInkCalendar/
├── fonts/                    # 存放字体文件
├── hardware/                 # 存放硬件相关的 STL 文件
├── lib/                      # 存放项目依赖的库文件
├── pictures/                 # 存放项目使用的图片资源
├── .gitignore                # 指定 Git 忽略的文件和目录
├── LICENSE.md                # 项目许可证文件
├── README.md                 # 项目说明文件
├── dataHelper.py             # 数据处理辅助文件
├── displayHelpers.py         # 显示辅助功能文件
├── displayRun.py             # 主程序运行文件
├── displayTest.py            # 显示测试文件
├── requirements.txt          # 项目依赖的 Python 包列表
├── run_calendar.py           # 日历运行脚本
├── run_calendar.sh           # 系统启动时运行的脚本
├── settings.py.sample        # 配置文件示例

2. 项目的启动文件介绍

项目的启动主要通过 run_calendar.sh 脚本实现。该脚本在系统启动时自动运行,通过以下命令实现:

@reboot sleep 60 && /home/pi/eInkCalendar/run_calendar.sh

该脚本会调用 run_calendar.py 脚本,该脚本负责驱动电子墨水屏幕显示日历信息。

3. 项目的配置文件介绍

项目的配置文件为 settings.py.sample,需要将其复制为 settings.py 并进行修改。以下是配置文件中需要设置的几个主要参数:

  • LOCALE: 设置项目的语言和日期格式,例如 "zh_CN"
  • WEBDAV_CALENDAR_URL: 设置 WebDAV 日历的 URL。
  • WEBDAV_IS_APPLE: 设置是否为苹果的 iCloud 日历。
  • CALDAV_CONTACT_USER: 设置 CALDAV 联系人列表的用户名。
  • CALDAV_CONTACT_PWD: 设置 CALDAV 联系人列表的密码。
  • ROTATE_IMAGE: 设置是否在显示前旋转屏幕图像,通常在使用 STL 文件打印时需要设置为 True

配置文件中的其他参数可根据需要自行调整,确保项目能够正确运行。

登录后查看全文
热门项目推荐