KlipperScreen-Happy-Hare-Edition 使用与配置教程

1. 项目目录结构及介绍

KlipperScreen-Happy-Hare-Edition 是一个基于 KlipperScreen 的开源项目，专为使用 Happy Hare 驱动软件的 MMU（多材料单元）设计。以下是项目的目录结构及各部分的简要介绍：

KlipperScreen-Happy-Hare-Edition/
├── .github/              # GitHub 工作流和配置文件
├── config/              # 配置文件
├── docs/                # 文档资料
├── happy_hare/          # Happy Hare 相关的文件和脚本
├── ks_includes/         # KlipperScreen 包含的文件
├── panels/              # 面板布局和样式文件
├── scripts/             # 脚本文件
├── styles/              # CSS 样式文件
├── .gitignore           # Git 忽略文件列表
├── README.md            # 项目说明文件
├── LICENSE              # 许可证文件
└── screen.py            # 主屏幕程序文件

• .github/: 包含 GitHub Actions 工作流等自动化脚本。
• config/: 存放配置文件，如 KlipperScreen.conf 和 mmu_klipperscreen.conf。
• docs/: 存储项目文档和教程。
• happy_hare/: 包含 Happy Hare 版本的特有文件和安装脚本。
• ks_includes/: KlipperScreen 包含的通用文件。
• panels/: 定义了各种面板的布局和结构。
• scripts/: 包含项目运行所需的脚本，如安装脚本。
• styles/: 包含 CSS 样式文件，用于定制界面外观。
• .gitignore: 指定 Git 应该忽略的文件和目录。
• README.md: 项目描述和基本使用说明。
• LICENSE: 项目的开源许可证。
• screen.py: KlipperScreen 的主程序文件。

2. 项目的启动文件介绍

项目的启动主要通过 screen.py 文件进行。这是 KlipperScreen 的主程序，负责初始化用户界面和处理用户交互。在实际部署时，通常会通过一个启动脚本（例如 install_ks.sh）来设置环境变量、安装依赖并启动 screen.py。

启动脚本的使用示例如下：

./install_ks.sh -g <num_gates>

其中 <num_gates> 是你构建的 MMU 上的选择器数量。

3. 项目的配置文件介绍

KlipperScreen-Happy-Hare-Edition 的配置主要通过以下几个文件进行：

• KlipperScreen.conf: KlipperScreen 的主配置文件，定义了屏幕的基本设置和行为。
• mmu_klipperscreen.conf: MMU 特有的配置文件，用于设置 MMU 相关的参数。
• menus.conf: 菜单配置文件，定义了屏幕上显示的菜单结构和内容。

配置文件通常位于 config/ 目录下，可以通过编辑这些文件来定制项目的行为。安装脚本 install_ks.sh 会在安装过程中创建或更新这些配置文件，并确保它们放置在正确的位置。

要修改配置，可以直接编辑这些文件，或者使用项目提供的工具和脚本进行更新。在修改配置后，通常需要重启 KlipperScreen 以使更改生效。