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に入り、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

書き込みモードへの確認

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

    sudo apt-get install usbutils

    
• 赤枠内に表示される ID は参考程度ですが、**固定ではありません（可変）**です。OpenMoko, Inc. stm32f072xx の後ろの 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ファームウェアのフラッシュ