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

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

重要な安全注意事項

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

  • ファームウェアコンパイルの一貫性: 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シリーズ: ピン番号は大文字で入力する必要があります。実際のマザーボードのドキュメントに従って記入してください。
    • RP2040シリーズ: ピン番号は小文字で入力する必要があります。実際のマザーボードのドキュメントに従って記入してください。

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

    • 例: !<pin_a>,!<pin_b>,<pin_c> は、起動時に最初の2つのピンをローに、3つ目のピンをハイに設定します。
安全性に関する説明

設定した 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...