メインコンテンツにスキップ

常用コマンド

ドキュメント説明

本ドキュメントでは、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 書き込み​

python3 ~/klipper/lib/canboot/flash_can.py -u <CAN-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...