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

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

重要な安全注意事項

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

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

ファームウェアタイプの説明​

  • Katapult / HID モード

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

  • Bootloader モード

    • 機能:従来のメモリカードを介した書き込み方法です。
    • 利点:この方法はフォールトトレランスに優れており、誤って書き込みを失敗しても、メモリカードを再書き込みして再度試行でき、マザーボードが「文鎮化」する心配がありません。

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

コンパイルの準備とアドバイス
  • コンパイルの成功確率を最大限高めるため、MobaXterm をSSHクライアントとして使用することを推奨します。ユーザーからの報告によると、一部の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回押して、書き込みモードに再び入ってください。
  • 手順の遵守:公式チュートリアルの書き込み方法を厳密に守ってください。検証されていない他の方法を使用すると、デバイスが損傷する可能性があります。
  • コンパイルの確認:書き込み前に、ファームウェアにコンパイルエラーがないことを必ず確認してください。誤ったファームウェアファイルは書き込みの失敗やデバイスの動作不良を引き起こします。

Katapult ファームウェア書き込みエラーの復旧​

  1. マザーボード上の物理リセットボタンを素早く2回押します。
  2. 通常、Flyマザーボード内のLEDインジケーターが点滅し、Katapult モードに正常に入ったことを示します。
  3. この状態でマザーボード上の誤ったファームウェアを消去し、正しいKlipperファームウェアを再書き込みできます。

Bootloader ファームウェア書き込みエラーの復旧​

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

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

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