Homeplate 项目下载及安装教程

1. 项目介绍

Homeplate 是一个开源项目，旨在在 Inkplate 10 e-ink 显示屏上展示 Home Assistant 仪表板。该项目能够展示美丽的电子墨水屏仪表板，通过 WiFi QR 码供访客连接家中 WiFi，显示来自 Home Assistant 的消息，并报告传感器数据等。

2. 项目下载位置

该项目托管在 GitHub 上，您可以从以下位置下载源代码：

https://github.com/lanrat/homeplate.git

3. 项目安装环境配置

安装 PlatformIO

首先，您需要在您的计算机上安装 PlatformIO。PlatformIO 是一个跨平台、跨架构的编译器、调试器和命令行工具，用于开发嵌入式系统。

以下是在 Windows 系统上安装 PlatformIO 的步骤：

• 下载并安装 PlatformIO 的安装程序。
• 按照安装向导的指示完成安装。

配置环境变量

安装完成后，确保 PlatformIO 的路径已经添加到系统环境变量中。

• 在 Windows 上，您可以通过系统属性 -> 环境变量来设置。

4. 项目安装方式

1. 克隆项目到本地：

git clone https://github.com/lanrat/homeplate.git

2. 进入项目目录：

cd homeplate

3. 运行 PlatformIO 初始化：

pio project init

4. 根据您的 Inkplate 设备型号，选择正确的环境：

pio run -e inkplate10v2

如果是首次安装，需要通过 USB 进行刷写。后续更新可以通过 USB 或 WiFi 进行。

5. 项目处理脚本

项目中的处理脚本主要是通过 PlatformIO 的命令来编译和上传固件。以下是一些常用的 PlatformIO 命令：

• 编译项目：

pio run

• 清除构建目录：

pio run --target clean

• 监听串口输出：

pio device monitor

• 更新 PlatformIO：

pio upgrade

通过以上步骤，您应该能够在您的 Inkplate 10 设备上成功安装 Homeplate 项目。