grant0013/K2-OpenKlipper

# K2 OpenKlipper 这是一个实验性的、面向社区的创想力 K2 Plus 上游 Klipper 技术栈。它保留了 PRTouch、Z 轴调平、RS485 电机控制、风扇反馈和 CFS 运行所需的 K2 专属 MCU 协议。 首个公开快照版本 `v0.1.0-alpha.1` 基于经过实机测试的 v62 构建版本。它面向能够在测试失败时自行恢复打印机的开发者和有经验的 K2 用户。它使用以下专用的开放控制平面： - Klipper API socket：`/tmp/klippy_uds` - Moonraker：端口 7126 - Mainsail 2.18.2：端口 4409 - 为回滚保留了传统的 Fluidd/Moonraker：端口 4408/7125 创想力的 `master-server` 和 `Monitor` 已被禁用，因为它们都会下发打印机控制指令。因此，原厂触摸屏控制平面不可用。被动的创想力 Wi-Fi、摄像头、音频、App、网页和升级服务保持不变。 ## 项目状态 实机 K2 已经完成： - 使用开源 PRTouch 实现的 X/Y/Z 归零 - 擦拭喷嘴以及第二次高精度 PRTouch Z 归零 - 自适应热床网格 - 网格生成后向清理桶的移动 - CFS 打印开始时的挤料 - 向切片首层的过渡 - 在已保存的验证节点处完成了当前 Benchy 打印的 32%，且没有出现 MCU 计时错误或工具头停顿 这是一个 alpha 版本，而非正式固件。在 v62 版本上尚未完成过完整的长时打印。CFS 可以在开发版 K2 上正常工作，但其电气接口以及对其他打印机的适用性尚未得到验证。 PRTouch 目前通过 K2 硬件的 PA15 到 PC7 信号和原生 Klipper trsync 来停止 Z 轴；代码库中的 host 分类器仅作为实验性的备选方案。 有关验证矩阵和发布门控，请参阅 [PROJECT-STATUS.md](docs/PROJECT-STATUS.md)。 这仍然是实验性打印机固件。请务必看护初始打印过程，保持原厂回滚路径可用，并且在正在打印或已暂停的任务期间不要切换 Klipper 构建版本。 ## OrcaSlicer 使用： ``` START_PRINT EXTRUDER_TEMP=[nozzle_temperature_initial_layer] BED_TEMP=[bed_temperature_initial_layer_single] TOOL=[initial_no_support_extruder] ``` 将创想力传统的 **Change filament G-code** 替换为： ``` G90 G1 Z{max(z_after_toolchange, 0.6)} F600 ``` 完整说明位于 `config/ORCA-K2-PROFILE.cfg` 中。 ## 仓库结构 - `config/` - K2 配置和 Orca 配置文件说明 - `klippy/` - 锁定版本的 Klipper host 代码以及 K2 集成 - `system/` - Mainsail、Moonraker 服务/配置、兼容性补丁以及创想力服务隔离 - `tools/` - 发布部署助手 - `OPEN-STACK.md` - 架构、修复、备份、回滚和实机运行证据 - `K2-BUILD-MANIFEST` - 精确的上游与集成提交溯源 - `docs/PROJECT-STATUS.md` - 就绪状态和验证矩阵 - `docs/CFS-PROTOCOL.md` - 当前 CFS 连线和状态机的研究发现 - `docs/PRTOUCH.md` - 当前 PRTouch 架构和待解决问题 - `CONTRIBUTING.md` - 安全的测试与贡献方式 ## 招募帮助 - 在其他 K2 Plus 固件和硬件版本上进行验证 - CFS 的电气、寻址和冷启动研究发现 - 将通用 CFS 协议与 K2 运动控制和传感器分离 - 用于 CFS 轮询的非阻塞串行传输 - 在干净和受污染的喷头上测试 PRTouch 重复性数据 - 完整的长时打印和恢复测试 请使用 issue 模板，并提供确切的版本号、日志以及正在测试的阶段。请勿泄露凭据、序列号、Wi-Fi 信息或其他隐私数据。 ## 重要限制 内置的 Moonraker 是创想力的固件包。其 Klipper 和 Moonraker 自动更新程序已被刻意禁用，因为该设备缺少更新程序所需的元数据、Git 客户端、依赖文件和构建工具链。 Mainsail 网页客户端仍然可以独立更新。 ## 许可证 衍生自 Klipper 的代码在 GNU GPLv3 协议下发布；请参阅 `COPYING`。 内置的第三方组件保留其各自上游的版权和许可。 请参阅 `THIRD_PARTY.md`、`K2-BUILD-MANIFEST` 和 `system/mainsail/release_info.json`。

标签：3D打印固件, Klipper, 创想威图K2, 物联网控制面, 逆向工具