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

コンパイルの開始

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

手記

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

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

ヒント

• 上位機が正常にネットワークに接続できていることを確認してください
• 固件のコンパイル前に、SSHを使用してネットワーク経由で上位機にログインする必要があります
• 上位機にシリアルポートツールを使用しないでください

Klipperファームウェアのコンパイルと設定ページ操作説明

ヒント

キーボード入力モードを半角モード（英語モード）に設定してください

1. キーボードの↑キー、↓キーは、カーソルを上下移動させてメニュー項目を選択します
2. 確認キーEnterまたはスペースキーSpaceは、メニューをチェックするかサブメニューに進むために使用します
3. 戻るキーESCは、一つ前のメニューに戻ります
4. Qキーは、Klipperファームウェアの設定ページを終了します
5. 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を選択してEnterを押します

  

• Bootloader offsetを選択し、NO bootloaderを選択します

  

• Communication interfaceを選択し、USBSERIALを選択します

  

• Q キーを押して Save configuration が表示されたら、その後に Y キーを押します

• 現在は設定が保存され、コマンドラインに戻ったはずです
• make -j4 を入力してコンパイルを開始します。時間がかかります

• 最後に以下の内容が出力されたらコンパイル成功です

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

ブートローダーモードの確認

• 上位機（ホストマシン）が正常にネットワークに接続できており、下位機（デバイス）と接続されているデータ線がデータ転送機能を持っていることを確認してください。
• SSHで上位機に接続後、lsusb を入力してエンターキーを押します。以下に示す画像内の丸で囲まれた情報が表示された場合、次のステップに進むことができます。
  • 何も情報が返ってこない場合、これは上位機のシステムの問題であり、解決できません。正常なシステムに切り替えるか、上位機を交換してください。
  • lsusb コマンドがないと表示される場合、以下のコマンドを実行してインストールできます

    sudo apt-get install usbutils

    
• 赤枠内に表示されているIDは参考値ですが、固定ではありません。変動可能です。OpenMoko, Inc. rp2040 の後ろにあるサフィックス XX が重要な判断基準です。
  • 部分的にシステムの問題により、上位機が情報を完全に表示しない場合があります。

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

::: tip

• プラグインのフラッシュ中にインターネットに接続する必要があります。上位機が正常にインターネットに接続されていることを確認してください。
• もしすでにインストール済みの場合、再度インストールする必要はありません。 :::

フラッシュ開始

::: warning 警告

• 非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に置き換えてください。

  ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<あなたのボードID>

fastシステムではこのコマンドを使用してフラッシュします。<あなたのボードID>を前ステップで取得したIDに置き換えてください。

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<あなたのボードID>

• 参考画像

  

• フラッシュ完了時の参考

  

ファームウェアの更新

USBファームウェアの更新

• ボードIDを検索するために以下のコマンドを使用し、下図のようなIDが表示されることを確認してください。（図中のIDは例示であり、各ボードのIDは異なります）

  ls /dev/serial/by-id/*

::: tip 注意 下図中の/dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00がボードのIDです。 :::

• USBファームウェアを更新するには、最新のファームウェアをコンパイルした後、以下のコマンドを使用して更新します。<あなたのボードID>を前ステップで取得したIDに置き換えてください。

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

  

CANブリッジファームウェアの更新

• CANブリッジファームウェアを更新する場合、最新のファームウェアをコンパイルした後、以下のコマンドを使用してKatapultにリセットします。（下図は例示であり、図中のIDは参考としてください。実際は設定ファイル内のIDを使用してください） ::: tip 注意

  • <あなたの CANBUS UUID>はprinter.cfg設定ファイル内のボードのCANBUS UUIDです。 :::
  
  

~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <あなたの CANBUS UUID>

fastシステムではこのコマンドを使用してフラッシュします。<あなたのボードID>を前ステップで取得したIDに置き換えてください。

python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <あなたの CANBUS UUID>

::: tip 注意

• 下図中のf95cee90e1f9がボードのCANBUS UUIDです。 :::

• Katapultにリセットした後、以下のコマンドを使用してボードIDを検索し、下図のようなIDが表示されることを確認してください。（図中のIDは例示であり、各ボードのIDは異なります）

  ls /dev/serial/by-id/*

::: tip 注意 下図中の/dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00がボードのIDです。 :::

• 新しいファームウェアをコンパイルした後に実行することを確認し、<あなたのボードID>を前ステップで取得したIDに置き換えてください。

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

  

ファームウェアの誤刷解決方法

• ボードを電源から切り、再度電源を入れ直し、リセットボタンを素早くダブルクリックすることで、再びフラッシュモードに入ることができます。
• または、Window/上位機を使用してkatapultファームウェアを再びフラッシュできます。katapultファームウェアのフラッシュ