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

常用コマンド

ドキュメント説明

本ドキュメントは 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...