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 bashLoading...
Edit Configuration
Step 1
- Open and edit the
/boot/firmware/config.txtfile: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=uart0Loading... - Save and exit the editor by pressing
Ctrl + S, thenCtrl + X.
Step 2
- Open and edit the
/boot/firmware/cmdline.txtfile:sudo nano /boot/firmware/cmdline.txt- If
console=serial0,115200exists, please remove it.Loading... - Save and exit the editor by pressing
Ctrl + S, thenCtrl + X.
- If
Step 3
- Execute the following command in SSH.
- No prompt indicates successful execution.
sudo chmod 777 /home/pi/printer_data/logs/moon2uart.logLoading...
Step 4
- Access Klipper's web interface (such as Mainsail or Fluidd) via a browser.
- Open the
moon2uart.cfgfile.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/ttyAMA0in the configuration file, try using/dev/ttyS0or another. - For other host systems, please refer to the corresponding system's serial port name for modification.
- For example, use
/dev/ttyS0for Fly host systems.
Loading...
- After modification, click the
SAVE & RESTARTbutton in the top right corner to save and restart the service.Loading...
Step 5
- Reboot the Raspberry Pi.
Loading...