メインコンテンツにスキップ

ファームウェアコンパイル手順

重要な安全注意事項

システムの安定動作を確保するため、以下のファームウェア使用原則を必ず守ってください。

  • ファームウェアコンパイルの一貫性:Klipper ファームウェアは、現在使用している上位機でコンパイルする必要があります。他人がコンパイルしたものやバージョンが一致しないファームウェアを使用すると、予期しないシステム障害が発生する可能性があります。
  • ハードウェアプラットフォームの標準化:標準の上位機ハードウェアを使用することを強く推奨します。非公式に改造されたデバイス（一部のセットトップボックス、WiFiスティック、特定のRedmiデバイスなど）の使用は避けてください。これらのデバイスには互換性や安定性のリスクがある可能性があります。
  • 仮想化環境の制限:上位機システムを仮想マシンで実行することは推奨しません。これにより、パフォーマンスやリアルタイム性に干渉が生じ、印刷品質に影響を与える可能性があります。

ファームウェアの種類について​

  • Katapult / HID モード

    • 機能:これら2つのモードは機能が同じで、どちらも非接触書き込み（メモリーカードの抜き差し不要、上位機を介して直接ファームウェアを更新）を実現できます。
    • 説明:HID は FLY オンボード上位機で使用されるブートローダーで、その本質は Katapult と同じです。
    • 重要な注意事項:Katapult を使用する際に、誤ったファームウェアを書き込んでマザーボードが応答しなくなった場合は、マザーボード上のリセットボタンを見つけてすばやく2回押すことで、再度 Katapult モードに入り、再書き込みが可能です。

  • Bootloader モード

    • 機能:従来のメモリーカードを使用した書き込み方法です。
    • 利点:この方法はエラー耐性が高く、誤って書き込みを失敗しても、メモリーカードを再書き込みすることで再度試行でき、マザーボードが「文鎮化」する心配がありません。

ファームウェアコンパイルガイド​

コンパイルの準備とアドバイス
  • コンパイルの成功率を最大限に高めるため、SSHクライアントとして MobaXterm の使用を推奨します。ユーザーからの報告によると、一部のSSHツールは原因不明のコンパイルエラーを引き起こす可能性があります。
  • 重要な設定項目:コンパイル設定画面で、必ず Enable extra low-level configuration options オプションにチェックを入れてください。そうしないと、一部の詳細設定が表示されません。

起動ピン設定 (GPIO pins to set at micro-controller startup)​

重要な注意事項
  • このオプションは、マイクロコントローラーの起動時に特定のGPIOピンのレベル状態を強制的に設定するために使用します。
  • 英語入力モードに切り替える必要があります。そうしないと、ファームウェアがコンパイルできません。

  • 設定の構文:

    • ピン番号の前に ! を付けると、起動時にそのピンをLow（低レベル）に設定します。! を付けない場合はHigh（高レベル）に設定します。
    • STM32シリーズ:ピン番号は大文字で記述する必要があります（例：!PF8 または PF8）。
    • RP2040シリーズ:ピン番号は小文字で記述する必要があります（例：!gpio5 または gpio5）。

  • 複数ピンの設定:複数のピンを設定する必要がある場合は、カンマ , で区切ります。

    • 例:!gpio5,!gpio19,gpio24 は、起動時に gpio5 と gpio19 をLowに、gpio24 をHighに設定することを意味します。
安全性について

設定した GPIO pins to set at micro-controller startup は、Klipper が起動して接続する前にのみ有効です。Klipper が接続を完了して正常に動作している場合、この設定はピンのその他の動作に影響を与えません。安全に使用できます。

書き込み失敗の復旧と一般的な保護
  • 誤ったファームウェア書き込みの保護:Katapult、HID、Bootloader の3種類のファームウェア自体に保護機構があります。特別なDFUモードに入って書き込まない限り、メインのファームウェアを誤って書き込んでも、これらは上書きされず、マザーボードは「文鎮化」しません。
  • 書き込み完了後の必須操作:いかなるファームウェアの書き込みが完了した後も、必ず下位機の電源を完全に一度切ってから（電源ケーブルを抜く）、再び電源を入れてください。これにより、新しいファームウェアが正しく読み込まれ、安定して動作することが保証されます。

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

書き込み前の注意事項
  • デバイスの認識:Katapult を使用して書き込む場合、上位機がデバイスを認識できることを確認してください。デバイスが見つからない場合は、マザーボード上のリセットボタンをすばやく2回押して、書き込みモードに入り直すか、マザーボードのBLファームウェアを再書き込みしてください。
  • 手順の遵守:公式チュートリアルの書き込み方法に厳密に従ってください。他の検証されていない方法を使用すると、デバイスが損傷する可能性があります。
  • コンパイルの確認:書き込み前に、ファームウェアにコンパイルエラーがないことを必ず確認してください。誤ったファームウェアファイルは、書き込みの失敗やデバイスの誤動作の原因となります。

Katapult ファームウェア誤書き込みからの復旧​

  1. マザーボード上の物理的なリセットボタンを見つけてすばやく2回押してください。
  2. 通常、FlyマザーボードのLEDインジケーターが点滅し始め、Katapult モードへの移行が成功したことを示します。
  3. この状態で Katapult モードに入り、正しい Klipper ファームウェアを再書き込みできます。

Bootloader ファームウェア誤書き込みからの復旧​

  1. 正しいファームウェアが保存された TF カードをマザーボードに再挿入します。
  2. 書き込みができない場合は、一度完全に電源を切り、TF カードを挿入してから再び電源を入れてください。
  3. 電源を入れたまま約 5 秒間 待つと、自動書き込みが完了します。

Katapult インストール書き込み依存関係​

⚠️ 重要
  • Fly公式以外の上位機をお使いの場合は、必ず以下のコマンドを実行してファームウェア書き込み依存パッケージをインストールしてください！
  • 以下のリポジトリはどちらか一方を選択してください。
  • github リポジトリ 
    cd && git clone https://github.com/Arksine/katapult.git
  • 中国地域ミラーリポジトリ 
    cd && git clone https://cnb.cool/3dmellow/public/katapult
Loading...
Loading...