USB ファームウェアのコンパイル

ヒント

以前のチュートリアルの問題により、2025年6月28日までに購入したお客様はBLファームウェアを再書き込みすることをお勧めします
USB加速度計は出荷時にUSB接続用のKlipperファームウェアがすでに書き込まれています
ファームウェアのみを更新すればよいです
USBケーブルでコンピュータとUSB加速度計を接続できます

コンパイルを開始する

klipperサービスがインストールされた上位機を使用する必要がありますネットワーク経由でSSHに接続
そしてデバイスを上位機に接続してください
注意：一般的な上位機を使用してください。例えば、ラズベリーパイやFLY派などです。改造された上位機（例：WiFiスティック、レッドミーなど）は問題が多いので、技術サポートを提供できません

手記

下記のコマンドを入力してROOTユーザーから通常のユーザーに切り替えることができます
ROOTユーザーを使用しないでください
flyユーザーの場合、su flyと直接入力できます。flyユーザー以外の場合、<あなたの上位機のユーザーネーム>をあなたの上位機のユーザーネームに置き換えてください！

su <あなたの上位機のユーザーネーム>

ヒント

请确保上位机可以正常联网
固件编译前需要使用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に入り、Raspberry Pi RP2040/RP235xを選択してEnterキーを押します。
Bootloader offsetを選択し、16KiB bootloaderを選択します。
Communication interfaceを選択し、USBSERIALを選択します。

マイクロコントローラー起動時に設定するGPIOピンを選択し、gpio8を入力してください
Q キーを押して Save configuration を表示し、その後 Y キーを押します

これで設定が保存され、コマンドラインインターフェースに戻ります
次のコマンドを入力してコンパイルを開始してください。時間がかかる場合があります

make -j4

最後に次の内容が出力されればコンパイル成功です

  Linking out/klipper.elf
  Creating bin file out/klipper.bin

デバイスの検索

上位機が正常にネットワークに接続できることを確認し、下位機と接続されているデータケーブルがデータ転送機能を持っていることを確認してください。
上位機にSSH接続し、コマンドラインで lsusb を入力してEnterを押します。もし下の画像で囲まれた情報が表示された場合、次のステップに進むことができます。
- 何も情報が返ってこない場合、これは上位機のシステムの問題です。こちらでは対応できませんので、正常なシステムに変更するか、上位機を交換してください。
- lsusb コマンドが見つからない場合、以下のコマンドを実行してインストールできます：
```
sudo apt-get install usbutils
```
1d50:6177 は今回使用する予定のデバイスです。
- 一部の上位機はシステムの問題により、完全に表示されないか、全く表示されないことがあります。
- lsusb コマンドを入力するとデバイスが表示されるが、1d50:6177 が表示されない場合は、データケーブルを交換して、マザーボードを上位機の他のUSBポートに接続してみてください。
上記の手順を以前に実行しており、Klipperファームウェアの書き込みが成功し、マザーボードが正常に動作している場合、Klipperファームウェアを更新するだけであれば、このページの右側メニューにある「ファームウェア更新」セクションをご覧ください。

注意事項

1d50:6177 デバイスが表示された後でなければ、次のステップに進めません。

ファームウェアの焼入

USBファームウェアの書き込み

下記のコマンドを使用して、マザーボードのIDを検索します。以下の図に示すIDが表示されるはずです。（注：図中のIDは例示であり、各マザーボードのIDは異なります）

ls /dev/serial/by-id/*

注意

図中の参考ID/dev/serial/by-id/usb-Klipper_rp2040_12345-if00がマザーボードのIDです。

USBファームウェアの更新には、最新のファームウェアをコンパイルした後、以下のコマンドを入力して更新してください。<あなたのマザーボードID>を先ほど取得したIDに置き換えてください

cd ~/klipper/ && make flash FLASH_DEVICE=<あなたのマザーボードID>

間違ったファームウェアの書き込み対策

ボタンを押してDFUモードに入り、PCは新しいUディスクを認識します。ファームウェアをドラッグアンドドロップするだけでOKです
WINDOWSでファームウェアをクリアしてから再びファームウェアを書き込む

ファームウェアが起動したか確認する

ファームウェアが正常に起動すればLEDが点灯します

コンパイルを開始する​

Klipper固件编译和配置页面操作说明​

デバイスの検索​

ファームウェアの焼入​

間違ったファームウェアの書き込み対策​

ファームウェアが起動したか確認する​