USBブリッジCANファームウェアの書き込み

コンパイルを開始

klipperサービスがインストールされたホストコンピュータが必要ですネットワーク経由でSSH接続
そして、デバイスをホストコンピュータに接続してください
注意：一般的なホストコンピュータ（例えば、ラズベリーパイ、FLY派など）を使用してください。改造ホストコンピュータ（例えば、WiFi棒、Redmiなど）は問題が多く、技術サポートを提供できません

普通のホストコンピュータでファームウェアをコンパイルする手順
FASTシステムでのファームウェアコンパイル手順

手記

ラズベリーパイ、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に接続した後、次のコマンドを入力してエンターを押します：

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を選択してエンターを押します。
メニューMicro-controller Architectureに進み、STMicroelectronics STM32を選択してエンターを押します。
メニューProcessor modelに進み、STM32F072を選択してエンターを押します。
Bootloader offsetを選択し、8KiB bootloaderを選択します。
Communication interfaceを選択し、**USB to CAN bus bridge (USB on PA11/PA12)**を選択してエンターを押します。
USB to CAN bus bridge (USB on PA11/PA12)を選択したら、デフォルトでこのパラメータを変更する必要はありませんCAN bus interface （CAN bus (on PB8/PB9)）--->
下の画像と照らし合わせて確認し、一致していることを確認してからコンパイルしてください

Q キーを押して Save configuration が表示されたら、続けて Y キーを押します
設定を保存してコマンドラインインターフェースに戻ったはずです
以下のコマンドを入力してコンパイルを開始します（時間がかかることがあります）

make -j4

最後に以下の内容が出力されればコンパイルは成功です
```
Linking out/klipper.elf
Creating bin file out/klipper.bin
```

書き込みモードに入る

案内

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

Type-Cケーブルでマザーボードをホストコンピュータに接続し、リセットボタンをダブルクリックします。この時、マザーボード上の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と通常のホストマシンでの書き込み方法
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ファームウェアの書き込み

コンパイルを開始​

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

書き込みモードに入る​

書き込みモードに入ったか確認​

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

書き込み開始​

ファームウェア更新​

間違ったファームウェアを書き込んだ場合の対処方法​