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

ファームウェアコンパイル説明

重要セキュリティ通知

システムの安定稼働を確保するため、以下のファームウェア使用原則に必ず従ってください:

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

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

  • Katapult / HID モード

    • 機能: この2つのモードは機能が同じで、どちらも非接触書き込み（SDカードの抜き差しなしで、ホストマシンから直接ファームウェアを更新）を実現できます。
    • 説明: HID は FLY ボード搭載ホストマシンが使用する Bootloader であり、その本質は Katapult と同じです。
    • 重要ヒント: Katapult 使用時に、誤ったファームウェアを書き込んでマザーボードが応答しなくなった場合は、マザーボード上のリセットボタンを見つけて素早く2回ダブルクリックしてください。これで再び Katapult モードに入り、再度書き込みが可能になります。

  • Bootloader モード

    • 機能: 従来のSDカードを使用した書き込み方法です。
    • 利点: この方法はフォールトトレランスが高く、誤って書き込んでしまった場合でも、SDカードを再書き込みすれば再度試行できます。マザーボードが「ブリック」する心配はありません。

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

コンパイル準備と推奨事項
  • コンパイル成功の可能性を最大限に高めるため、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 を使用して書き込む場合、ホストマシンがデバイスを認識できることを確認してください。デバイスが見つからない場合は、マザーボード上のリセットボタンを素早くダブルクリックして、書き込みモードに再入してください。
  • 仕様遵守: 公式チュートリアルの書き込み方法に厳密に従ってください。未検証の他の方法を使用すると、デバイスが損傷する可能性があります。
  • コンパイル確認: 書き込む前に、ファームウェアにコンパイルエラーがないことを必ず確認してください。誤ったファームウェアファイルは、書き込みの失敗やデバイスの動作不良を引き起こします。

Katapult ファームウェア誤書き込み回復​

  1. マザーボード上の物理リセットボタンを見つけ、素早くダブルクリックします。
  2. 正常な場合、Flyマザーボード内のLEDインジケーターが点滅を開始し、Katapult モードへの正常な移行を示します。
  3. これで、マザーボード上の誤ったファームウェアを消去し、正しいKlipperファームウェアを再書き込みできます。

Bootloader ファームウェア誤書き込み回復​

  1. 正しいファームウェアが入ったTFカードをマザーボードに再挿入します。
  2. 書き込めない場合は、まず完全に電源をオフし、TFカードを挿入した後、再度電源を入れてください。
  3. 約5秒間通電したままにすると、自動書き込みが完了します。

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

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