Hyelicht 项目下载及安装教程

1. 项目介绍

Hyelicht 是一个用于家庭装饰和自动化的物联网/嵌入式项目。其软件允许用户在 LED 背光书架上进行彩色绘画和动画制作，使用嵌入式触摸屏和手机/PC 的配套应用程序。该项目还提供与智能灯光系统的集成。Hyelicht 的参考硬件是一个 5x5 的 IKEA Kallax 书架，配备多行 LED 背光和集成在美观相框中的 7 英寸触摸屏。书架内部隐藏了一台运行 Linux 的单板计算机、一个辅助 MCU 和两个 12A 5V 的台式电源。

2. 项目下载位置

要下载 Hyelicht 项目，请使用以下命令：

git clone https://github.com/eikehein/hyelicht.git

3. 项目安装环境配置

3.1 系统要求

• 操作系统：Linux（推荐 Raspberry Pi 4B 运行 Raspberry OS）
• 依赖库：
  • C++17 编译器
  • CMake v3.16+
  • Qt v5.15+ 模块（QtCore, QtNetwork, QtQML, QtQuick, QtRemoteObjects）
  • KDE Frameworks 5 v5.78+ 模块（Extra CMake Modules/ECM, KCoreAddons, KConfig, KI18n）
  • Linux 内核头文件（用于 SPI 通信）

3.2 环境配置示例

以下是配置环境的步骤示例：

1. 安装 C++ 编译器

   sudo apt-get update
   sudo apt-get install build-essential
   

2. 安装 CMake

   sudo apt-get install cmake
   

3. 安装 Qt 和 KDE Frameworks

   sudo apt-get install qt5-default libkf5coreaddons-dev libkf5config-dev libkf5i18n-dev
   

4. 启用 SPI 接口（适用于 Raspberry Pi）

   编辑 /boot/config.txt 文件，添加以下行：

   dtparam=spi=on
   

   重启系统：

   sudo reboot
   

4. 项目安装方式

4.1 克隆项目

git clone https://github.com/eikehein/hyelicht.git
cd hyelicht

4.2 配置和编译项目

mkdir build
cd build
cmake ..
make

4.3 安装项目

sudo make install

5. 项目处理脚本

Hyelicht 项目包含一个名为 hyelichtctl 的命令行前端工具，用于通过 HTTP REST API 进行本地和网络操作。以下是使用示例：

hyelichtctl --help
hyelichtctl --on
hyelichtctl --off

通过这些步骤，您可以成功下载、配置和安装 Hyelicht 项目，并开始使用其功能进行家庭装饰和自动化。