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

常用コマンド

ドキュメント説明

本書では 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 書き込み​

バージョン説明

お使いのシステムバージョンに応じて正しいコマンドを選択してください：

  • FlyOS-FAST 1.3.8 以降 または 2026年4月9日以降に Klipper を更新したシステム：

    python3 ~/klipper/lib/katapult/flashtool.py -u <CAN-ID>

  • 旧バージョンのシステム（FAST 1.3.8 未満 または 2026年4月9日より前に Klipper を更新していないシステム）：

    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...