MMX
Un chemin complet de zéro à une configuration Klipper multicolore fonctionnelle : fichiers, nomenclature, assemblage du matériel, câblage, configuration Happy Hare, calibrage, première impression et support.
Happy Hare installation — step by step
This page is written for someone who has never installed Happy Hare before. Do one step, verify it, then continue. Do not paste every command on the page at once.
1. SSH into your Klipper host
Open a terminal on your computer and connect to the Raspberry Pi / CB1 / Linux host that runs Klipper.
ssh pi@your-printer-ip
Replace your-printer-ip with the real IP address of your printer. If your username is not pi, use your actual username.
2. Clone Happy Hare on the printer
Run these commands one at a time. This downloads Happy Hare to your Klipper host.
cd ~ git clone https://github.com/moggieuk/Happy-Hare.git cd Happy-Hare
When the last command finishes, your terminal should be inside the Happy-Hare folder.
3. Start the interactive installer
Run the installer in interactive mode. The installer will ask questions one by one.
./install.sh -i
4. Answer the installer questions for MMX
| Installer question | Answer for MMX | Why |
|---|---|---|
| MMU Type | MMX | Happy Hare has a dedicated MMX option. |
| Number of gates | 4 | The current MMX OG build uses gates 0, 1, 2 and 3. |
| MCU board | EBB42 or your actual board | The guide pinout uses BTT EBB42 as reference. |
| NeoPixels | Yes | MMX has per-gate RGB/RGBW LED indication. |
| Servo | MG996 or your installed servo | The BOM/manual reference MG996. |
| Endless spool | Optional | Enable only if you want automatic switching to another spool. |
| Include MMU config files | Yes | You need the generated MMU config structure. |
| Mini screen menu | Usually no | Only choose yes if you have a dedicated supported screen. |
| Default pause/resume macros | Yes | Recommended starting point. |
| ERCF filament cutter | No | Standard MMX does not include an integrated cutter unless you added one. |
| Blobifier | No, unless installed | Only enable hardware you physically installed. |
5. Enable the MMU panel in Mainsail or Fluidd
Open Mainsail/Fluidd in your browser. Update the interface if needed, then go to settings and enable the MMU panel. Restart the interface after enabling it.
6. Open the generated MMU config files
Happy Hare creates several files under ~/printer_data/config/mmu/base/ or a similar config path. You will edit these four files:
| File | What you edit there |
|---|---|
| mmu.cfg | Board pin aliases for the EBB42 / MMU board. |
| mmu_hardware.cfg | Stepper, servo, pre-gate sensors and toolhead sensor. |
| mmu_parameters.cfg | Selector type, sync feedback setting, servo behavior and MMU behavior. |
| mmu_macro_vars.cfg | Toolhead distances, tip forming, purge and saved variables path. |
7. Set MMX pin aliases in mmu.cfg
In mmu.cfg, set the aliases to match your actual wiring. For the reference EBB42 wiring from the MMX guide, use this mapping:
[board_pins mmu]
mcu: mmu
aliases:
MMU_GEAR_UART=PA15,
MMU_GEAR_STEP=PD0,
MMU_GEAR_DIR=PD1,
MMU_GEAR_ENABLE=PD2,
MMU_SEL_SERVO=PB9,
MMU_NEOPIXEL=PD3,
MMU_PRE_GATE_0=PB7,
MMU_PRE_GATE_1=PB5,
MMU_PRE_GATE_2=PB6,
MMU_PRE_GATE_3=PB8,8. Configure sensors in mmu_hardware.cfg
Add the four pre-gate sensors and the toolhead sensor. MMX does not have a sync feedback tension/compression sensor, so leave sync feedback undefined/disabled.
[mmu_sensors] pre_gate_switch_pin_0: ^mmu:MMU_PRE_GATE_0 pre_gate_switch_pin_1: ^mmu:MMU_PRE_GATE_1 pre_gate_switch_pin_2: ^mmu:MMU_PRE_GATE_2 pre_gate_switch_pin_3: ^mmu:MMU_PRE_GATE_3 # No separate gate sensor unless you physically added one gate_switch_pin: #^mmu:MMU_GATE_SENSOR # Toolhead sensor from the MMX wiring diagram toolhead_switch_pin: ^mmu:PB4
9. Disable sync feedback in mmu_parameters.cfg
If the installer enabled sync feedback, disable it for standard MMX.
sync_feedback_enabled: 0
10. Set the selector type
Still in mmu_parameters.cfg, make sure MMX uses the servo selector type.
selector_type: ServoSelector
11. Restart Klipper and check for errors
Save the config files, then restart Klipper. If Klipper reports a config error, fix that first. Do not start calibration until Klipper starts cleanly.
12. Test every sensor before calibration
Use the MMU panel. Insert filament manually into Gate 0, Gate 1, Gate 2 and Gate 3. Each pre-gate sensor must change state. Then test the toolhead sensor.