Portal Calendar 项目下载及安装教程

1. 项目介绍

Portal Calendar 是一个基于 ESP32 平台的电子墨水日历，具有 Portal 主题风格。它可以运行在 AAA 电池上，续航时间可以达到数年，并且可选集成 OpenWeatherMap 的天气信息功能。该项目旨在制作一个低功耗且游戏风格的墙壁安装日历。

2. 项目下载位置

项目托管在 GitHub 上，下载地址为：https://github.com/wuspy/portal_calendar.git

3. 项目安装环境配置

环境要求

• Arduino IDE
• ESP32 开发板
• 电子墨水显示屏（例如 Waveshare 7.5" 800x480 E-Ink 显示屏）
• ESP32 扩展板（例如 EzSBC ESP32 扩展板）
• 4xAAA 电池座

配置步骤

1. 安装 Arduino IDE 并添加 ESP32 开发板支持。

   

2. 准备电子墨水显示屏和 ESP32 扩展板。

   

3. 连接电子墨水显示屏和 ESP32 扩展板。

   

4. 项目安装方式

1. 克隆项目到本地：

   git clone https://github.com/wuspy/portal_calendar.git
   

2. 在 Arduino IDE 中打开项目：

   • 打开 Arduino IDE
   • 选择 File > Open > 选择项目文件夹

3. 配置项目：

   • 选择正确的开发板和端口
   • 配置项目所需的库（例如 ArduinoJson 7.2.0，ESPAsyncWebSrv 1.2.8）

4. 编译并上传固件到 ESP32：

   • 点击 Sketch > Upload 或按 Ctrl + U 上传固件

5. 项目处理脚本

项目中的主要代码文件为 portal_calendar.ino，其中包含了所有必要的初始化代码和功能实现。以下是一些关键脚本示例：

void setup() {
  // 初始化串口
  Serial.begin(115200);
  // 初始化电子墨水显示屏
  initDisplay();
  // 初始化天气功能
  initWeather();
}

void loop() {
  // 更新天气信息
  updateWeather();
  // 更新显示内容
  updateDisplay();
}

确保根据项目需求和官方文档进行适当修改和配置，以适应不同的硬件和功能需求。

以上就是关于 Portal Calendar 项目的下载及安装教程，希望对您有所帮助。