Upgrade Your 3D Printer to Klipper with MainsailOS

Klipper moves the heavy math from the printer's small board to the Raspberry Pi. The result: higher speeds, vibration compensation and easy configuration in a text file.

Video tutorial

▶ Control 3D · Video in SpanishWatch on YouTube ↗

Video by Control 3D, embedded from YouTube. The written steps below are our own and match the parts list.

Mission steps

1. Flash MainsailOS

   In Imager: Other specific-purpose OS → 3D printing → MainsailOS.

2. Find your printer config

   Klipper's repository includes sample printer.cfg files for many printers and boards.

3. Build and flash the MCU firmware

   SSH in, run make menuconfig in ~/klipper for your board's chip, then make, and flash the resulting firmware to the printer board as its docs describe.

4. Connect and configure

   Upload printer.cfg in Mainsail, set the serial path from ls /dev/serial/by-id/ and restart.

5. Tune

   Run PID calibration, measure input shaping with an accelerometer (ADXL345) and tune pressure advance.

Code

cd ~/klipper
make menuconfig      # choose your printer board's microcontroller
make
ls /dev/serial/by-id/   # copy this path into printer.cfg [mcu] serial:

Tip: test every script on the bench before installing it in a moving machine.

Questions