BoxTurtle开源项目安装与配置指南

BoxTurtle开源项目安装与配置指南

BoxTurtle Modular compact automated filament changer for klipper 3d printers 项目地址: https://gitcode.com/gh_mirrors/bo/BoxTurtle

1. 项目基础介绍

BoxTurtle 是一个为 Klipper 3D 打印机设计的开源自动化丝材更换系统。它的目标是提供一个接近于 AMS（自动物料供应系统）的用户体验，兼容各种形式的 Klipper 机器，尤其是 VORON 设计的打印机。BoxTurtle 采用基于通道的自动化丝材更换系统，每个通道配备有自己的专用挤出机，能够独立地将丝材送入和移出打印头。丝材的管理使用低摩擦的顶部供丝电动复绕机。

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

• 编程语言：主要使用 Python 语言进行开发，与 Klipper 打印机软件相兼容。
• 关键技术：
  • 自动化控制：使用电动复绕机进行丝材的自动更换。
  • 传感器融合：通过传感器实现丝材状态监测和精确控制。
  • 挤出机协调：确保挤出机与打印头之间的协调运作，包括丝材缓冲机制。
• 外部框架：BoxTurtle 需要与 AFC Klipper Add-On 一起使用，该插件提供了丝材更换的必要功能和配置选项。

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

准备工作

• 确保您的 Klipper 版本至少为 0.12.0。
• 确保您的单板计算机（SBC）具有 root 访问权限，并且能够安装或修改 Klipper 安装。
• 确保您的 Klippy-env Python 环境安装为 3.x 版本。
• 准备好网络连接，以从 GitHub 仓库克隆项目。

安装步骤

1. 克隆 BoxTurtle 仓库到您的 SBC：

   git clone https://github.com/ArmoredTurtle/BoxTurtle.git
   cd BoxTurtle
   

2. 安装 AFC Klipper Add-On：

   根据官方文档进行安装，确保在安装过程中选择正确的配置选项。

3. 配置 Klipper：

   • 编辑 Klipper 配置文件 printer.cfg，加入 AFC Klipper Add-On 相关配置。
   • 如果您使用的是打印头丝材切割器，确保在安装 AFC Klipper Add-On 时选择了该选项，或者在 AFC/AFC.cfg 文件中手动启用，然后重启 Klipper。

4. 集成传感器（可选）：

   如果您使用预挤出丝材传感器或后挤出丝材传感器，请将它们定义在 AFC 配置中。

5. 调整切片机设置：

   根据需要调整切片机软件中的冲洗体积乘数和塔宽度设置。

6. 测试配置：

   完成配置后，进行一次测试，确保所有组件正确安装且工作正常。

7. 故障排除：

   如果遇到问题，请参考项目的 ERRATA.md 文件，或者加入 ArmoredTurtle 的 Discord 社区寻求帮助。

通过以上步骤，您应该能够成功安装和配置 BoxTurtle 系统，并开始享受自动化丝材更换带来的便捷。

BoxTurtle Modular compact automated filament changer for klipper 3d printers 项目地址: https://gitcode.com/gh_mirrors/bo/BoxTurtle