Klipperr に接続
- 本チュートリアルは Fly-Buffer-Plus バッファに KLIPPER ファームウェアを書き込むためのものです
- 書き込み完了後は圧力ファームウェアのピンが上書きされることを意味します
- 以前の機能を実現するには、自身でマクロを作成するか、以前のファームウェアを再度書き込む必要があります
- あらゆる設定および使用するマクロは自身で作成する必要があります
ブートローダー (BL) 書き込み
書き込みモードに入る
- 書き込みモードに入る方法は2通りあります
- 方法1:ツールボードの電源を完全に切った状態で BOOT ボタンを押しながら、データ転送用の TYPE-C ケーブルを一方はマザーボードに、もう一方を自分のデバイスに接続します
- 方法2:データ転送用の TYPE-C ケーブルを一方はマザーボードに、もう一方を自分のデバイスに接続した後、BOOT ボタンを押しながら RST ボタンを押し、その後 RST ボタンを離し、最後に BOOT ボタンを離します
ファームウェア書き込み
- Windows書き込みチュートリアル
- ホスト書き込みチュートリアル
- バッファの BL ファームウェア
- 以下のダウンロードリンクをクリックしてください
-
Loading...
USB3.0
は書き込みに失敗する可能性があるため、できるだけPCのUSB2.0
を使用して書き込みを行ってください。- それでも書き込みができない場合は、ホストコンピュータを使用して書き込みを行ってください。
- 下記のエラーが発生した場合は、USBハブを使用してください。
- 書き込みツール ダウンロード先
SetupSTM32CubeProgrammer
とSTM32 DFUドライバ
をダウンロードする必要があります- ファームウェアをPC内の任意のディレクトリにダウンロードします
- Type-Cケーブルを使用してマザーボードをPCに接続し、
dfu
書き込みモードに入っていることを確認してください - STM32CubeProgrammerでUSBモードを選択し、更新して接続します
- エラーポップアップが表示されなければ接続成功です。
警告
下図のような画面が表示された場合は、PCまたはソフトウェアの問題です。ホストコンピュータを使用して書き込みを行ってください:ホストコンピュータによる書き込み手順
- 左側のダウンロードアイコンをクリックし、下記の項目にチェックを入れます
- 矢印が指す
Browse
をクリックし、書き込みたいファームウェアを選択します Start address
に0x08000000
を入力します- ファームウェアが
HEX
形式の場合はこの手順は無視してください!!
- ファームウェアが
- 下部にある
Start automatic mode
をクリックしてファームウェアの書き込みを開始します - 下記のメッセージが表示されたらファームウェアの書き込みが完了です
- フラッシュツールのインストール
- FLY上位機はフラッシュツールのインストールを実行する必要はありません
- インストールが必要な場合に注意してください:上位機はインターネットに接続できる必要があります
- すでにインストール済みの場合、インストールする必要はありません
sudo apt update
sudo apt install dfu-util -y
- 接続が成功したかどうかを確認するために以下のコマンドを実行します。
lsusb
- DFUデバイスがない場合は再びフラッシュモードに入ることを試してください
- システムバージョンの問題により他の名前が表示される可能性があります。
0483:df11
と表示された場合、フラッシュモードに入ったことを示します

- 事前にコンパイルされたファームウェアを取得
- これらはすべて事前にコンパイルされたファームウェアです
- 注意してください:上位機はインターネットに接続できる必要があります
- 上位機は次のコマンドを実行してファームウェアパッケージをダウンロードする必要があります(上位機のネットワーク問題によりファイルを取得できない場合は、售后群で管理者に連絡してください)
cd && git clone https://github.com/FengHua741/FLY_Katapult.git
- ファームウェアパッケージを既にダウンロードしている場合は、残りの操作を行う前にファームウェアパッケージを更新することをお勧めします
cd ~/FLY_Katapult && git pull
- ファームウェア書き込み
いずれか1つのファームウェアのみ書き込めば十分です
- 以下がファームウェア書き込みコマンドです
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/BL/buffer/FLY_BUFFER.bin
-
以下の図の矢印部分に表示される
File downloaded successfully
というメッセージが表示されれば書き込み成功です
書き込み完了後、マザーボードの電源を一度完全に切る必要があります
USB ファームウェアコンパイル
コンパイル開始
- は
klipper
サービスがインストールされているホストコンピュータを使用する必要があります ネットワーク経由でSSHに接続する - また、デバイスをホストコンピュータに接続してください
- 注意:通常のホストコンピュータを使用してください。例えば、Raspberry Pi FLY派などです。マジックカスタムホストコンピュータ(例:WiFi棒子、Redmiなど)の場合、問題が多いので技術サポートは提供できません
- FlyOS-Armbianシステムと通常のシステムの注意点
- FlyOS-FASTシステムの注意点
FlyOS-Armbian
システムと通常のシステムの注意点- Raspberry Pi、FLY派などの通常のホストコンピュータシステムはこの種類になります
- この種類のホストコンピュータでは
ROOT
ユーザーを使用してあらゆる操作を行ってはいけません - 通常のユーザーを使用してください
- ユーザー切り替え方法については、
FlyOS-Armbian
システムの場合はsu fly
コマンドを使用して通常のユーザーに切り替えてください - 他のシステムの場合は
su <あなたのホストコンピュータのユーザー名>
コマンドを使用して通常のユーザーに切り替えてください
su <あなたのホストコンピュータのユーザー名>
FlyOS-FAST
システムの注意点FASTシステム
のデフォルトのユーザー名はroot
で、パスワードはmellow
です- ファームウェアをビルドするには
root
ユーザーのみを使用してください - さらに、
FASTシステム
にはROOT
ユーザーのみがあり、ユーザーの切り替えは必要ありません!!!
- 上位機が正常にネットワークに接続できていることを確認してください
- 固件のコンパイル前に、SSHを使用してネットワーク経由で上位機にログインする必要があります
- 上位機にシリアルポートツールを使用しないでください
Klipperファームウェアのコンパイルと設定ページ操作説明
キーボード入力モードを半角モード(英語モード)に設定してください
- キーボードの
↑
キー、↓
キーは、カーソルを上下移動させてメニュー項目を選択します - 確認キー
Enter
またはスペースキーSpace
は、メニューをチェックするかサブメニューに進むために使用します - 戻るキー
ESC
は、一つ前のメニューに戻ります Q
キーは、Klipperファームウェアの設定ページを終了しますY
キーは、Klipperファームウェアの設定ページを終了する際に、プロンプトがある場合に、Y
キーを押して設定ファイルを保存します
配置ページのオプションが少ない場合は、最初に[ ] Enable extra low-level configuration options
をチェックして、一部の隠しオプションを表示してください
以下はファームウェアをコンパイルする方法です:
-
SSHに接続した後、次のコマンドを入力し、Enterを押します:
cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig
-
そのうち
rm -rf ~/klipper/.config && rm -rf ~/klipper/out
は以前のコンパイルデータとファームウェアを削除し、make menuconfig
はファームウェアをコンパイルします。実行後、以下のインターフェースが表示されるはずです。 -
Enable extra low-level configuration optionsを選択し、Enterを押します
-
メニューMicro-controller Architectureに入り、STMicroelectronics STM32を選択してEnterを押します
-
メニューProcessor modelに入り、STM32F072を選択してEnterを押します
-
Bootloader offsetを選択し、8KiB bootloaderを選択します
-
Communication interfaceを選択し、**USB (on PA11/PA12)**を選択してEnterを押します
-
以下の図と照らし合わせて、一致していることを確認してください。一致したら次へ進んでください。
Q
キーを押し、Save configuration が表示されたら、次にY
キーを押します- これで設定を保存し、コマンドラインインターフェースに戻ったはずです
- 以下のコマンドを入力してコンパイルを開始します(時間がかかることがあります)
make -j4

-
最後に以下の内容が表示されればコンパイル成功です
Linking out/klipper.elf
Creating hex file out/klipper.bin
- 以下はコンパイルファームウェアの操作手順の記録です
書き込みモードに入る
RST
ボタンをダブルクリックして、書き込みモードに入ります

書き込みモードに入ったか確認
- 上位機が正常にネットワークに接続できることを確認し、下位機と接続されているデータケーブルがデータ転送機能を持っていることを確認してください。
- 上位機にSSH接続し、コマンドラインで
lsusb
を入力してEnterを押します。もし下の画像で囲まれた情報が表示された場合、次のステップに進むことができます。- 何も情報が返ってこない場合、これは上位機のシステムの問題です。こちらでは対応できませんので、正常なシステムに変更するか、上位機を交換してください。
lsusb
コマンドが見つからない場合、以下のコマンドを実行してインストールできます:sudo apt-get install usbutils
1d50:6177
は今回使用する予定のデバイスです。- 一部の上位機はシステムの問題により、完全に表示されないか、全く表示されないことがあります。
lsusb
コマンドを入力するとデバイスが表示されるが、1d50:6177
が表示されない場合は、データケーブルを交換して、マザーボードを上位機の他のUSBポートに接続してみてください。
- 上記の手順を以前に実行しており、Klipperファームウェアの書き込みが成功し、マザーボードが正常に動作している場合、Klipperファームウェアを更新するだけであれば、このページの右側メニューにある「ファームウェア更新」セクションをご覧ください。
1d50:6177
デバイスが表示された後でなければ、次のステップに進めません。
ファームウェア書き込み
- ファームウェア書き込みプラグインをインストールする際はネットワークに接続されている必要があります。ホストマシンがインターネットに正常に接続されていることを確認してください。
- すでにインストール済みの場合は、再度インストールする必要はありません。
書き込み開始
-
Flyホストマシン以外 の場合は、必ず以下のコードを実行してファームウェア書き込みに必要な依存パッケージをインストールしてください。さもなくばファームウェアを書き込めません!
- デフォルトリポジトリ
- 国内リポジトリ
cd && git clone https://github.com/Arksine/katapult.git
cd && git clone https://gitee.com/MrCakeFuck/katapult.git
-
以下のコマンドでデバイスIDを検索してください。図に示すようなIDが表示されます(注:図のIDは一例です。マザーボードごとにIDは異なります)。
ls /dev/serial/by-id/*
-
ファームウェアの書き込みには以下のコードを使用してください。ファームウェアがすでにコンパイル済みであることを確認し、
<あなたのマザーボードID>
を前の手順で調べたIDに置き換えてください。
- Fly-Armbianと通常のホストマシンでの書き込み方法
- Fly-FASTでの書き込み方法
~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<あなたのマザーボードID>
python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<あなたのマザーボードID>
-
参考図
-
書き込み完了時の参考図
ファームウェア更新
- USBファームウェアの更新
- ブリッジCANファームウェアの更新
-
以下のコマンドでマザーボードのIDを検索してください。図に示すようなIDが表示されます(注:図のIDは一例です。マザーボードごとにIDは異なります)。
ls /dev/serial/by-id/*
下図の/dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00
はマザーボードのIDです。

-
USBファームウェアの更新は、最新のファームウェアをコンパイルした後、以下のコマンドで更新してください。
<あなたのマザーボードID>
を前の手順で調べたIDに置き換えてください。cd ~/klipper/ && make flash FLASH_DEVICE=<あなたのマザーボードID>
- USBブリッジCANファームウェアの更新を行うには、最新ファームウェアをコンパイルした後、以下のコマンドでKatapultにリセットしてください。(図に示すIDは参考例です。ご使用の設定ファイルに記載されたIDを使用してください)
<CANBUS UUID>
はprinter.cfgファイルに記載されたマザーボードのCANBUS UUIDです。
- Fly-Armbianと通常のホストマシンでKatapultにリセットする方法
- Fly-FASTでKatapultにリセットする方法
<あなたのマザーボードID>
を前の手順で調べたIDに置き換えてください~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>
<あなたのマザーボードID>
を前の手順で調べたIDに置き換えてくださいpython3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>
- 下図の
f95cee90e1f9
はマザーボードのCANBUS UUIDです。

-
Katapultにリセットした後、以下のコマンドでマザーボードのIDを検索してください。図に示すようなIDが表示されます(注:図のIDは一例です。マザーボードごとにIDは異なります)。
ls /dev/serial/by-id/*
下図の/dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00
はマザーボードのIDです。

-
新しいファームウェアのコンパイルが完了したことを確認した上で、書き込みを行ってください。
<あなたのマザーボードID>
を前の手順で調べたIDに置き換えてください。cd ~/klipper/ && make flash FLASH_DEVICE=<あなたのマザーボードID>
間違ったファームウェアを書き込んだ場合の対処方法
- マザーボードの電源を切って再投入し、リセットボタンを素早くダブルクリックすると、再度書き込みモードに戻ることができます。
- または、Windows/ホストマシンから再度katapultファームウェアを書き込み直してくださいkatapultファームウェアの書き込み
CAN IDの検索
- ブラウザを開き、アドレス欄にホストコンピュータのIPアドレスを入力します。例として、私のホストコンピュータのIPは
192.168.101.179
です。そのまま入力してEnterキーを押してください。

- ホストコンピュータのWEBインターフェースを開き、左サイドバーの設定オプション内で以下の項目を探します:
![]() |
![]() |
-
printer.cfg
を開いた後、右上にあるDEVICES
をクリックします。 -
CAN
をクリックし、その後更新してください。- fluiddでの更新方法
- mainsailでの更新方法
-
IDをコピーします。矢印の指す部分をクリックするとコピーできます。
- fluiddの場合、最初の矢印が指す部分が
Klipper
になっているか確認し、そうなっていれば右側の矢印が指す部分をクリックしてコピーしてください。
- mainsailの場合、最初の矢印が指す部分が
Klipper
になっているか確認し、そうなっていれば右側の矢印が指す部分をクリックしてコピーしてください。
- fluiddの場合、最初の矢印が指す部分が
CAN IDの入力
DEVICES
を閉じてIDを入力します。
- 設定ファイル内の:
[mcu]
serial: /tmp/klipper_host_mcu
を以下に変更してください:
[mcu host]
serial: /tmp/klipper_host_mcu
- 以下の項目を追加してください:
[mcu]
canbus_uuid: <ここに先ほど検索したIDを入力してください>
![]() |
![]() |
- 設定にIDを入力します。
- IDを入力した後、右上の
SAVE & RESTART
をクリックしてください。
![]() | ![]() |
ADC out of range
というKlipperの警告が出る場合がありますが、これは正常な現象です。ヒートベッドとサーミスタをマザーボードに接続し、ヘッドとヒートベッドのサーミスタピンを正しく設定した後、保存して再起動してください。
注意: 文書内で使用されているすべてのIDはあくまで例です。実際の各マザーボードのIDは異なりますので、実際に取得したIDを入力してください。