常用コマンド

ドキュメント説明

このドキュメントは、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