跳到主要内容

使用说明

本教程用于在树莓派系统中安装并配置 moon2uart，让 Nova 3.5 串口屏可以通过 UART 与 Klipper 上位机通信。

项目说明
参考系统Raspberry Pi OS with Desktop
参考版本Debian GNU/Linux 12 (bookworm)
前置条件已安装 Klipper 与 Moonraker，并且可以通过浏览器访问 Mainsail 或 Fluidd
操作方式需要先通过 SSH 登录到树莓派

在开始之前，请先确认系统版本：

cat /etc/os-release

如果输出中包含类似 PRETTY_NAME="Debian GNU/Linux 12 (bookworm)" 的内容，说明系统版本与本教程一致。

Loading...

如果使用其他 Linux 上位机系统，也可以参考本教程，但文件路径、串口名称或服务管理方式可能不同，需要按实际系统调整。

接线说明​

断电操作

开始前请完全关闭打印机并断开电源供应。不要在通电状态下插拔线束、整理接口线序或触碰端子。

Nova 3.5 使用 UART 串口通信，接线时需要连接 5V、GND、TX、RX。具体接线图正在补充中；接线完成后再继续进行下方软件配置。

安装组件​

在 SSH 中执行下方命令，自动安装 moon2uart：

curl -sSL https://cnb.cool/3dmellow/public/Moon2Uart/-/git/raw/master/scripts/install.sh | sudo bash
Loading...

编辑系统串口配置​

第一步：启用树莓派 UART​

打开 /boot/firmware/config.txt 文件：

sudo nano /boot/firmware/config.txt

在文件末尾添加以下内容：

enable_uart=1
dtoverlay=miniuart-bt
force_turbo=1
dtoverlay=uart0
Loading...

添加完成后，按 Ctrl + S 保存，再按 Ctrl + X 退出编辑器。

第二步：关闭系统串口控制台​

打开 /boot/firmware/cmdline.txt 文件：

sudo nano /boot/firmware/cmdline.txt

如果文件中存在 console=serial0,115200，请删除这一段内容，避免系统控制台占用串口。

Loading...

修改完成后，按 Ctrl + S 保存，再按 Ctrl + X 退出编辑器。

第三步：调整日志文件权限​

在 SSH 中执行下方命令：

sudo chmod 777 /home/pi/printer_data/logs/moon2uart.log

命令没有输出通常表示执行成功。如果系统用户不是 pi，请将 /home/pi/printer_data 改为实际的 printer_data 路径。

Loading...

第四步：修改 moon2uart 配置​

通过浏览器打开 Klipper 的 Web 界面，例如 Mainsail 或 Fluidd，然后打开 moon2uart.conf 文件。

Loading...

找到 SERIAL_PORT= 配置项，并将串口地址改为：

SERIAL_PORT="/dev/ttyAMA0"

同时确认 PRINTER_DATA_PATH 为当前系统实际的 printer_data 路径，例如：

PRINTER_DATA_PATH="/home/pi/printer_data"
串口名称

树莓派的 UART 设备名可能会因系统版本、硬件型号或系统配置不同而变化。如果 /dev/ttyAMA0 无法使用，可以尝试 /dev/ttyS0，或根据实际系统中的串口设备名进行修改。

其他上位机系统请使用对应系统的串口名称。例如 FLY 上位机通常使用 /dev/ttyS0。

Loading...

修改完成后，点击右上方的 SAVE 保存配置。

Loading...

第五步：重启树莓派​

配置保存后，重启树莓派让系统串口配置生效：

sudo reboot
Loading...