3MS Quickstart

Page Sections:

• Cloning Happy Hare Repo
• Running Installer
• Configuration

This quickstart guide explains how to install Happy Hare firmware for use with the 3MS modular multimaterial system.

Cloning Happy Hare Repo

First, download the Happy Hare repository onto your Raspberry Pi using the git tool. Log into your Raspberry Pi via SSH (PuTTy on Windows):

ssh pi@klippy.local

Note

Replace klippy.local with your Raspberry Pi's hostname. If you use a different username than pi, replace pi with your custom username.

Now, clone the Happy Hare repository onto your Raspberry Pi:

Important

K1 series users (K1, K1C, K1 Max, etc.) should instead perform the following steps (thank you @trandanhlam!):

1. Upgrade Klipper using this guide .
2. Upgrade Klipper Firmware using this guide and this firmware .

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

Happy Hare is now downloaded onto your Raspberry Pi. The next step is installing it.

Running Installer

To install Happy Hare firmware, run the following commands on your Raspberry Pi through SSH:

cd ~/Happy-Hare
./install.sh -i

This will open the interactive installer. You will be presented by several options, each of which are explained below.

1. MMU Type

This is the type of MMU you are setting up. In this case, it is a 3MS. Find it in the list, and type the number located next to it.

2. Number of Gates

The installer will then ask for the number of gates you have. This corresponds to how many filament units you have set up on your 3MS. Type the number and press enter.

Note

In the screenshot below, three filament units are present, so the number 3 is entered.

3. Control Board

Next, the installer will ask which controller you are using. If your controller is in the list, type the number next to its name in the list, and press enter. If not, press the number next to Not in list / Unknown.

4. Serial Port

The installer will attempt to locate the serial port of your selected control board. If the displayed port is correct, type y and press enter. If not, type n and press enter.

Tip

If you're unsure about the serial port, open a new SSH window, unplug your controller board, and run:

ls /dev/serial/by-id

Next, plug in your controller board, and re-run the command. The newly added line is your controller's serial address.

5. LEDs

Choose whether or not you want LEDs enabled for your 3MS.

6. EndlessSpool

Choose whether or not you want Endless Spool to be enabled. This let Happy Hare automatically load another spool if your current spool runs out.

7. printer.cfg

This is usually set to y on new Happy Hare installations, and n on existing ones.

---

🎉 Happy Hare is successfully installed! If you selected one of the default control boards, you don't need to follow the rest of this guide. You can continue with configuration and calibrations here.

If you selected `Not in list / Unknown`, read on.

Configuration

If you aren't using one of the default Happy Hare provided control boards, you will have to create a 3MS-specific configuration for your control board.

Controller Configuration

Instructions have been moved to the 3MS Configuration Generator

Note

You can continue with configuration and calibrations here