Klipper+Mainsail Install

ID: 146933

Description: This guide is still a WIP. The Arduino +...

Steps:

  1. Download and extract the latest version of Mainsail from their Github
  2. Open the Raspberry Pi Imager
  3. Select Operating System > Use custom > Select the Mainsail OS you downloaded.
  4. Select Storage > Select your SD.
  5. Bring up the Advanced Settings menu by pressing "Ctrl + Shift + X".
  6. Here you can setup your WiFi, locale, enable SSH and numerous other options.
  7. Write > Yes to confirm
  8. After imaging is complete the SD is automatically ejected. Insert it into the RPI and power it on.
    9. Step image Step image
  9. With the Raspberry Pi connected to the Duet 2 WiFi via USB, power on the RPI and SSH into the Pi.
  10. You can find the IP address of the Pi by looking at the connected client list in your router or by opening cmd.exe on your PC and running
  11. ping mainsailos.local -4
  12. In a webpage enter http://mainsailos.local or your printers IP address
  13. Navigate to the Machine tab on the left.
  14. Select Upgrade to update the RPI image and Update to install updates for Klipper, Mainsail and Moonraker. Once the updates are complete reboot the RPI
    15. Step image Step image
  15. Originally when I wrote this guide I saw many sources say you do not need to manually erase the firmware when you configure the Duet 2 WiFi for Klipper for the first time. However there's been many cases that has proven false.
  16. With the board powered off place a jumper on the erase pins.
  17. Connect the USB cable from the Duet 2 WiFi to a 5v power source(your PCs USB Port).
  18. Once the diag light comes on remove the jumper
  19. Any firmware saved to the Duet has been erased.
    20. Step image
  20. Connect the Duet 2 WiFi to the Pi with a USB cable. Power on the Pi and SSH into it.
  21. cd klipper
  22. make clean
  23. make menuconfig
  24. Micro-Controller > SAM3/SAM4 (Due and Duet)
  25. Processor > SAM4e8e (Duet WiFi/Eth)
  26. Communication Interface > USB
  27. Press the escape key on your keyboard and enter Y to save the config
    28. Step image
  28. Enter make
  29. Stop the Klipper service.
  30. sudo service klipper stop
  31. Get the Duet's serial ID # and copy it down.
  32. ls /dev/serial/by-id/*
  33. Enter "make flash FLASH_DEVICE=" and paste your serial after the =
  34. If the flash fails usually this will place the board into a bootloader mode like original install does when you hit the erase pins. If this occurs please rerun ls /dev/serial/by-id/* so that you can get the correct serial
  35. Enter make "flash FLASH_DEVICE=" and paste your serial your new serial after the =
    36. Step image Step image
  36. Make sure you're in the klipper directory:
  37. cd ~/klipper/
  38. Enter the following commands:
  39. sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/
  40. sudo systemctl enable klipper-mcu.service
  41. make clean
  42. make menuconfig
    43. Step image
  43. Micro-Controller Architecture > Linux Process. Press esc than Y
  44. make
  45. make flash
  46. sudo service klipper start
  47. Verify klipper_host_mcu is in the tmp directory with ls /tmp/*
  48. Add the pi to the TTY group
  49. sudo usermod -a -G tty pi
  50. sudo reboot -h now
    51. Step image Step image Step image
  51. Next we will go to a Web browser to the Pi's IP address. You will see an error for "Unable to open config file /home/pi/klipper_config/printer.cfg"
  52. Download the printer.cfg file from github and upload it to the config directory
  53. Open your newly created "printer.cfg". Scroll down to line 169. Make sure you update the config with your serial ID you got from "ls /dev/serial/by-id/*"
  54. Double check the mcu rpi serial ID in line 181 maches "ls /tmp/*"
  55. Click SAVE and restart the printer
    56. Step image
  56. If you use a separate 5v PSU for PS_ON You'll need to add the following lines
  57. [output_pin psupower] pin: PD15
  58. [gcode_macro M80] gcode: SET_PIN PIN=psupower VALUE=1
  59. [gcode_macro M81] gcode: SET_PIN PIN=psupower VALUE=0
    60. Step image
  60. PanelDue is compatible with Klipper but only with v1.24. Instructions can be found here
  61. Connect the PanelDue to the RPI.
  62. 5v > 5v
  63. GND > GND
  64. UART0 TX > DIN
  65. UART0 RX > DOut
    66. Step image
  66. SSH into the RPI.
  67. sudo nano /boot/config.txt
  68. At the bottom of the config file enter:
  69. dtoverlay=pi3-miniuart-bt
  70. Press Ctrl+X > Y to save > Enter to accept
    71. Step image
  71. We need to disable the serial console
  72. sudo nano /boot/cmdline.txt
  73. Remove the following string
  74. console=serial0,115200
  75. Press Ctrl+X > Y to save > Enter to accept
    76. Step image
  76. Disable serial console
  77. Sudo raspi-config
  78. 3 Interface Options > P6 Serial Port > No > Yes
  79. Yes to reboot the RPI
  80. Make sure you change the baud rate on the paneldue to 115200
  81. There's also a number of configs that need to be added to your moonraker.cfg. Those details can be found here.
    82. Step image
  82. Download the file and extract.
  83. Under "machine" menu, click on the Gear icon and select the checkbox for "show hidden files".
  84. Select "Create Directory".
  85. In the name field enter “.theme” and select CREATE.
  86. it has to be named as seen in the screenshot.
  87. Select the newly created ".theme" folder. Upload all the files from the zip archive into .theme folder.
  88. hit Ctrl+F5 and Enjoy.
    89. Step image Step image Step image
Back