跳到主要内容

常用指令

文档说明

本文档整理了在 Klipper 系统 中常用的 Linux 命令，主要用于：

  • 日常操作参考 – 提供高频命令的快速查询
  • 问题排查辅助 – 在遇到常见问题时，可对应查找相关命令进行验证或修复
  • 学习与备忘 – 作为 Linux 与 Klipper 交互的基础命令集

注意：本文档仅作命令收录与简要说明，不涉及具体的调试流程或故障分析。实际使用时请结合具体场景。

设备识别​

CAN 设备 ID 查询​

普通上位机：

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

FLY 上位机：

python3 ~/klipper/scripts/canbus_query.py can0

USB 设备 ID 查询​

ls /dev/serial/by-id/*

固件烧录​

STM32 系列 (DFU 模式)​

  • 请注意无法烧录HEX文件
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/<固件文件>.bin

通过 Katapult 烧录 Klipper​

USB 连接方式​

普通上位机：

~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<你的主板ID>

FLY 上位机：

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<你的主板ID>

通用指令（需指定设备ID）：

cd ~/klipper/ && make flash FLASH_DEVICE=<你的主板ID>

CAN 重置进BL​

普通上位机：

~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <你的主板ID>

FLY 上位机：

python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <你的主板ID>

RP2040 系列​

烧录 Klipper 固件​

cd ~/klipper/ && make flash FLASH_DEVICE=2e8a:0003

烧录 Bootloader​

首次烧录需编译工具：

cd ~/klipper/ && cd ~/klipper/lib/rp2040_flash/ && make

执行烧录：

sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/<固件路径>/<文件名>.uf2

代码管理​

拉取特定分支​

将仓库的 dev-flyos 分支拉取到 /data/klipper 目录：

cd && git clone https://cnb.cool/3dmellow/public/klipper -b dev-flyos /data/klipper

服务管理​

Klipper 服务​

重启服务​

sudo systemctl restart klipper

查看实时日志​

sudo journalctl -u klipper -f

查看服务状态​

sudo systemctl status klipper

Moonraker 服务​

重启服务​

sudo systemctl restart moonraker

查看实时日志​

sudo journalctl -u moonraker -f

查看服务状态​

sudo systemctl status moonraker

KlipperScreen 服务​

重启服务​

sudo systemctl restart KlipperScreen

查看实时日志​

sudo journalctl -u KlipperScreen -f

查看服务状态​

sudo systemctl status KlipperScreen
Loading...