KlipperScreen-Happy-Hare-Edition 安装与配置指南

1. 项目基础介绍

KlipperScreen-Happy-Hare-Edition 是 KlipperScreen 的一个分支版本，专为使用 Happy Hare 驱动软件管理多材料单元（MMU）而设计。该项目主要是对 KlipperScreen 进行功能增强，使其更好地适应 MMU 的操作和管理。项目主要使用 Python 编程语言。

2. 项目使用的关键技术和框架

• Python: 主要编程语言，用于开发屏幕界面和与打印机交互的逻辑。
• Jinja2: 一个模板引擎，用于动态生成 HTML 内容。
• Flask: 一个轻量级的 Web 应用框架，用于创建 Web 界面。
• CSS/HTML: 用于界面设计和样式。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 一个运行着 Klipper 的 Raspberry Pi。
• Klipper 已经配置好并与打印机连接正常。
• 确保您的 Raspberry Pi 可以访问互联网。

安装步骤

1. 克隆项目

   首先需要将项目克隆到您的 Raspberry Pi 上：

   cd ~
   mv KlipperScreen KlipperScreen.orig # 如果已有 KlipperScreen 目录，请重命名
   git clone https://github.com/moggieuk/KlipperScreen-Happy-Hare-Edition.git KlipperScreen
   

2. 安装依赖

   进入项目目录，安装所需的 Python 包：

   cd ~/KlipperScreen/happy_hare
   ./install_ks.sh -g <num_gates>
   

   其中 <num_gates> 是您打印机上 MMU 的选择器数量，例如 9。

3. 配置文件

   KlipperScreen 需要配置文件来正确运行。确保 Klipper 的 config 目录中存在 KlipperScreen.conf 和 mmu_klipperscreen.conf。如果没有，您可能需要在命令行中指定配置目录：

   ./install_ks.sh -g <num_gates> -c /path/to/klipper/config
   

4. 重启 KlipperScreen

   安装脚本执行完成后，需要重启 KlipperScreen 服务以应用更改：

   sudo systemctl restart KlipperScreen
   

5. 字体问题

   如果屏幕上显示的字体有问题，可能需要安装或更新字体。按照以下步骤操作：

   sudo apt install fontconfig
   fc-cache -f -v
   sudo systemctl restart KlipperScreen
   

   如果问题仍然存在，可以尝试安装 JetBrains Mono 字体并更新 CSS 文件中的字体设置。

完成以上步骤后，您应该能够看到增强版的 KlipperScreen 界面，并且能够更好地管理和操作您的 MMU 打印机。如果在安装过程中遇到任何问题，可以查阅项目文档或在 GitHub 上创建一个 Issue 来寻求帮助。