tannoo / happy-hare

MMU software driver for Klipper (ERCF, Tradrack, Prusa)

Happy Hare

Universal MMU driver for Klipper

       

Happy Hare is the second edition of what started life and as alternative software control for the ERCF v1.1 ecosystem - the original open source filament changer for multi-colored printing. However it has now been rearchitected to support most types of MMU's connected to the Klipper ecosystem. That includes ERCF, Tradrack, AMS-style and other custom designs. It has extensive configuration to allow for customization and using the installer simplifies initial setup for common MMU types. The three conceptual types of MMUs and the function and operation of their various sensors can be found here and should be consulted for any customized setup. It is best partnered with KlipperScreen for Happy Hare projet at least until the Mainsail integration is complete :-)

Some folks have asked about making a donation to cover the cost of the all the coffee I'm drinking (actually it's been G&T lately!). Although I'm not doing this for any financial reward this is a BIG undertaking (9000 lines of python, 5000 lines of doc, 4000 lines of macros/config). I have put hundreds of hours into this project and if you find value and feel inclined a donation to PayPal https://www.paypal.me/moggieuk will certainly be spent making your life with your favorate MMU more enjoyable. Thank you!

Major features:

• Support any brand of MMU and user defined monsters (ERCF 1.1, 2.0, Tradrack, Custom. Prusa & KMS coming very soon)
• Synchronized movement of extruder and gear motors (with feedback control) to overcome friction and even work with FLEX materials!
• Sophisticated multi-homing options including extruder!
• Implements a Tool-to-Gate mapping so that the physical spool can be mapped to any tool
• EndlessSpool allowing a spool to automatically be mapped and take over from a spool that runs out
• Sophisticated logging options (console and mmu.log file)
• Can define material type and color in each gate for visualization and customized settings (like Pressure Advance)
• Spoolman integration
• Automated calibration for easy setup
• Supports MMU "bypass" gate functionality
• Ability to manipulate gear and extruder current (TMC) during various operations for reliable operation
• Moonraker update-manager support
• Complete persistence of state and statistics across restarts. That's right you don't even need to home!
• Highly configurable speed control that intelligently takes into account the realities of friction and tugs on the spool
• Optional integrated encoder driver that validates filament movement, runout, clog detection and flow rate verification!
• Vast customization options most of which can be changed and tested at runtime
• Integrated help, testing and soak-testing procedures
• Gcode pre-processor check that all the required tools are avaialble!
• Drives LEDs for functional feed and some bling!
• Built in tip forming and filament cutter support
• Lots more... Detail change log can be found in the Wiki

Controlling an ERCF with companion customized KlipperScreen for easy touchscreen MMU control!

Installation

The module can be installed into an existing Klipper setup with the supplied install script. Once installed it will be added to Moonraker update-manager to easy updates like other Klipper plugins. Full installation documentation is in the Wiki but start with cloning the repo onto your rpi:

cd ~
git clone https://github.com/moggieuk/Happy-Hare.git

Documentation

MMU's are complexd! Fortunately Happy Hare has elaborate documentation logically organized in the Wiki Other Resources: German instructional video created by Crydteam

My Testing and Setup:

Most of the development of Happy Hare was done on my trusty ERCF v1.1 setup but as it's grown, so has my collection of MMU's and MCU controllers. Multi-color printing is addictive but can be frustrating during setup and learning. Be patient and use the forums for help! But first read the Wiki!

There once was a printer so keen,
To print in red, yellow, and green.
It whirred and it spun,
Mixing colors for fun,
The most vibrant prints ever seen!

---

  (\_/)
  ( *,*)
  (")_(") Happy Hare Ready