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

コンパイル開始

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

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

手記

• ラズベリーパイ、FLY派などの一般的なホストコンピュータシステムはこのカテゴリに含まれます
• このようなホストコンピュータではROOTユーザーを使用していかなる操作も行ってはいけません
• 通常のユーザーを使用してください
• ユーザー切り替え方法:FlyOS-Armbianシステムの場合はsu flyコマンドで通常ユーザーに切り替えてください
• その他のシステムの場合はsu <あなたのホストコンピュータのユーザー名>コマンドで通常ユーザーに切り替えてください

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

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に接続した後、次のコマンドを入力し、エンターを押します:

  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に入り、STM32H723を選択し、エンターを押します。

  

• Bootloader offsetを選択し、128KiB bootloaderを選択します。

  

• **Clock Reference (8 MHz crystal)**を選択し、25 MHz crystalを選択します。

  

• Communication interfaceを選択し、**USB to CAN bus bridge (USB on PA11/PA12)**を選択します。

  

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

make -j4

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

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

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

• Type-Cケーブルでマザーボードをホストコンピュータに接続し、リセットボタンをダブルクリックします。この時、マザーボード上のLEDが点滅します。

警告

• LEDが点滅しない場合は、katapultファームウェアを再書き込みしてください：katapultファームウェア書き込み
• LEDが点滅しない場合は、katapultファームウェアの書き込みが完了してから、次のステップを実行してください。

デバイスの検索

• 上位機に正常にログイン済みの場合、lsusbを入力してデバイスを検索できます。以下のいずれかの状況が発生する可能性があります。
  • lsusbを入力した際にlsコマンドが見つからないというメッセージが表示される場合、以下のコマンドでコマンドをインストールできます。

    sudo apt-get install usbutils

  • lsusbを入力しても何の反応もない場合、これはシステムの問題です。こちらでは対応できませんので、システムを変更するか、正常なシステムを使用してください。
  • 以下の画像のような情報が表示されます。ただし参考情報であり、1d50:606fが表示されていることを確認すれば問題ありません。
    
• 1d50:606fは今回使用するデバイスです。
• 複数の1d50:606fが表示される場合、片方を除外する必要があります。そうでないと今後のファームウェア書き込みや接続に影響が出ます。例えばFLY MINI PADの場合、他のCANブリッジではなく、基板に搭載されているUTOCを使用することをおすすめします。
• 表示されない場合は、自分でケーブルがしっかり接続されているか、ファームウェアが正しく書き込まれているかを確認してください。

注意事項

1d50:606fが表示されている場合のみ、CAN IDの検索を行ってください。

ファームウェア書き込み

ヒント

• 焼录プラグインのインストールにはインターネット接続が必要です。ホストマシンがインターネットに正常に接続されていることを確認してください。
• すでにインストール済みの場合は再度のインストールは不要です。

焼录を開始

警告

• 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を使用してください。）

注意

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

Fly-Armbianと通常のホストマシンでのリセット焼込方法

• <あなたのマザーボードID> を先ほど検索したIDに置き換えてください。

  ~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <あなたのマザーボードID>

Fly-FASTでのリセット焼込方法

• <あなたのマザーボードID> を先ほど検索したIDに置き換えてください。

  python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <あなたのマザーボードID>

注意

• 図の中の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>

  

間違ったファームウェア焼込時の対処方法

• マザーボードの電源を切って再投入し、リセットボタンを素早く2回押すことで再び焼込モードに入ることができます。
• または、Windows/ホストマシンを使用してKatapultファームウェアを再焼込してくださいKatapultファームウェアの焼込はこちら