USB ファームウェアのビルド

ビルドを開始する

• は klipper サービスがインストールされているホストコンピュータを使用する必要があります ネットワーク経由でSSHに接続する
• また、デバイスをホストコンピュータに接続してください
• 注意：通常のホストコンピュータを使用してください。例えば、Raspberry Pi FLY派などです。マジックカスタムホストコンピュータ（例：WiFi棒子、Redmiなど）の場合、問題が多いので技術サポートは提供できません

FlyOS-Armbianシステムと通常のシステムの注意点

手記

• FlyOS-Armbianシステムと通常のシステムの注意点
  • Raspberry Pi、FLY派などの通常のホストコンピュータシステムはこの種類になります
  • この種類のホストコンピュータでは ROOT ユーザーを使用してあらゆる操作を行ってはいけません
  • 通常のユーザーを使用してください
  • ユーザー切り替え方法については、FlyOS-Armbianシステムの場合は su fly コマンドを使用して通常のユーザーに切り替えてください
  • 他のシステムの場合は su <あなたのホストコンピュータのユーザー名> コマンドを使用して通常のユーザーに切り替えてください

  su <あなたのホストコンピュータのユーザー名>

FlyOS-FASTシステムの注意点

手記

• FlyOS-FASTシステムの注意点
  • FASTシステムのデフォルトのユーザー名は root で、パスワードは mellow です
  • ファームウェアをビルドするには root ユーザーのみを使用してください
  • さらに、FASTシステムには ROOT ユーザーのみがあり、ユーザーの切り替えは必要ありません！！！

ヒント

• 上位機が正常にネットワークに接続できていることを確認してください
• 固件のコンパイル前に、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

• 以下はファームウェアのビルド操作の記録です

Asciinema cast

ブートローディングモードに入る

ヒント

2024年9月1日以降に製造されたD5はすでにKatapultファームウェアがインストールされています

• TypeCデータケーブルを使用してメインボードをホストコンピュータに接続した後、リセットボタンを二回押してください。このときメインボードのLEDランプが点滅します。

警告

• LEDランプが点滅しない場合は、再びKatapultファームウェアを焼いてください：Katapultファームウェアのブートローディング
• LEDランプが点滅しない場合は、Katapultファームウェアをブートローディングした後、次のステップを実行してください

ブートローディングモードに入っているか確認する

• 上位機が正常にネットワークに接続できることを確認し、下位機と接続されているデータケーブルがデータ転送機能を持っていることを確認してください。
• 上位機に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と通常のホストマシンでの書き込み方法

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

Fly-FASTでの書き込み方法

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

• 参考図

  

• 書き込み完了時の参考図

  

ファームウェア更新

USBファームウェアの更新

• 以下のコマンドでマザーボードの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>

  

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

• USBブリッジCANファームウェアの更新を行うには、最新ファームウェアをコンパイルした後、以下のコマンドでKatapultにリセットしてください。(図に示すIDは参考例です。ご使用の設定ファイルに記載されたIDを使用してください)

注意

• <CANBUS UUID>はprinter.cfgファイルに記載されたマザーボードのCANBUS UUIDです。

Fly-Armbianと通常のホストマシンでKatapultにリセットする方法

• <あなたのマザーボードID>を前の手順で調べたIDに置き換えてください

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

Fly-FASTでKatapultにリセットする方法

• <あなたのマザーボード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ファームウェアの書き込み