Skip to main content

Usage Instructions

  • This tutorial is based on Raspberry Pi OS with Desktop.
  • System version: Debian GNU/Linux 12 (bookworm).
  • Ensure your system has Klipper and Moonraker installed and that you can access Klipper's web interface (such as Mainsail or Fluidd) via a browser.
  • Before starting, please ensure you have SSH access to your Raspberry Pi. To confirm your system version, execute the following command:
    cat /etc/os-release
  • You should see output similar to PRETTY_NAME="Debian GNU/Linux 12 (bookworm)".
    Loading...
  • If you are using a different system, you can also refer to the tutorial below for installation. Some commands may not apply, so please adjust accordingly.

Wiring

  • Updating...

Install Components

  • Execute the following command for automatic installation:
    curl -sSL https://cnb.cool/3dmellow/public/Moon2Uart/-/git/raw/master/scripts/install.sh | sudo bash
    Loading...

Edit Configuration

Step 1

  • Open and edit the /boot/firmware/config.txt file:
    sudo nano /boot/firmware/config.txt
  • Add the following content at the end of the file:
    enable_uart=1
    dtoverlay=miniuart-bt
    force_turbo=1
    dtoverlay=uart0
    Loading...
  • Save and exit the editor by pressing Ctrl + S, then Ctrl + X.

Step 2

  • Open and edit the /boot/firmware/cmdline.txt file:
    sudo nano /boot/firmware/cmdline.txt
    • If console=serial0,115200 exists, please remove it.
      Loading...
    • Save and exit the editor by pressing Ctrl + S, then Ctrl + X.

Step 3

  • Execute the following command in SSH.
  • No prompt indicates successful execution.
    sudo chmod 777 /home/pi/printer_data/logs/moon2uart.log
    Loading...

Step 4

  • Access Klipper's web interface (such as Mainsail or Fluidd) via a browser.
  • Open the moon2uart.cfg file.
    Loading...
  • Change the address after SERIAL_PORT= to "/dev/ttyAMA0".
Important Note
  • The UART interface name in Raspberry Pi may vary depending on the system version. If you cannot find /dev/ttyAMA0 in the configuration file, try using /dev/ttyS0 or another.
  • For other host systems, please refer to the corresponding system's serial port name for modification.
  • For example, use /dev/ttyS0 for Fly host systems.
Loading...
  • After modification, click the SAVE & RESTART button in the top right corner to save and restart the service.
    Loading...

Step 5

  • Reboot the Raspberry Pi.
Loading...