Skip to content

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

License

Notifications You must be signed in to change notification settings

Firas95k/Happy-Hare

 
 

Repository files navigation

Happy Hare

Happy Hare

Universal Automated Filament Changer / 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, Box Turtle, Night Owl, Angry Beaver, 3MS and other custom designs (Prusa MMU3 and 3DChameleon are in the works). 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!


Don't forget to join the dedicated Happy Hare forum here: https://discord.gg/aABQUjkZPk

#f03c15 #c5f015 #1589F0 A few of the features:

  • Support almost any brand of Automated Filament Changer / MMU and user defined monsters
  • Synchronized movement of extruder and gear motors (with sync 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)
  • Deep Spoolman integration
  • Automated calibration for easy setup
  • Supports MMU "bypass" gate functionality
  • Moonraker update-manager support
  • Moonraker gcode pre-parsing to extract important print infomation
  • Complete persistence of state and statistics across restarts
  • Highly configurable speed control
  • 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!

KlipperScreen-Happy Hare edition


#f03c15 #c5f015 #1589F0 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

#f03c15 #c5f015 #1589F0 Documentation

wiki MMU's are complexd! Fortunately Happy Hare has elaborate documentation logically organized in the Wiki


Other Resources:

German instructional video created by Crydteam


English Happy Hare introduction by Silverback


#f03c15 #c5f015 #1589F0 Just how good a MMU multi-color prints?

Although the journey to calibrating and setup can be a frustrating one, I wanted to share @igiannakas (ERCFv2 + Orca Slicer + Happy Hare) example prints here. Click on the image to zoom it. Incredible! 🆒 👏

Example Prints


#f03c15 #c5f015 #1589F0 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!

My Setup

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

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 88.7%
  • Shell 11.1%
  • G-code 0.2%