ファームウェアコンパイルに関する説明

重要な安全注意事項

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

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

ファームウェア種別の説明

Katapult / HID モード
- 機能:この2つのモードは機能的に同じで、接触なしでのファームウェア書き込み（SDカードを抜き差しすることなくホストコンピュータからファームウェアを更新可能）が実現できます。
- 説明:HID はFLY組み込みホストコンピュータが使用するブートローダーで、本質的には Katapult と同じものです。
- 重要な注意事項:Katapult モードを使用する際、誤ったファームウェアを書き込んでマザーボードが反応しなくなった場合は、マザーボード上のリセットボタンを素早くダブルクリックして再度 Katapult モードに入り、再度書き込みを行ってください。
Bootloader モード
- 機能:従来のSDカード経由での書き込み方式。
- 利点:この方式はフォールトトレランス性が高く、誤って誤ったファームウェアを書き込んでもSDカードに再度ファームウェアを書き込み直せば問題なく再度試行可能で、マザーボードが「ブリック（故障）状態）」になる心配もありません。

コンパイル準備と推奨事項

コンパイル成功の可能性を最大限に高めるため、SSHクライアントとして MobaXterm を使用することを推奨します。ユーザーからの報告によると、一部のSSHツールでは未知のコンパイルエラーが発生する可能性があります。
重要な設定項目:コンパイル設定画面では、Enable extra low-level configuration options のチェックボックスを必ずチェックしてください。これをチェックしないと一部の高度な設定が表示されません。

重要な注意事項

設定構文:
- ピン名の前に ! を付けると起動時にそのピンをローレベル（低電圧）に設定します。! を付けない場合はハイレベル（高電圧）に設定します。
- STM32シリーズ:ピン番号は大文字でなければなりません（例: !PF8 または PF8）。
- RP2040シリーズ:ピン番号は小文字でなければなりません（例: !gpio5 または gpio5）。
複数ピンの設定:複数のピンを設定する場合は、英語のカンマ , で区切ります。
- 例:!gpio5,!gpio19,gpio24 は起動時に gpio5 と gpio19 をローレベルに、gpio24 をハイレベルに設定します。

セキュリティに関する説明

設定した GPIO pins to set at micro-controller startup は Klipper が接続開始前の起動時のみに有効です。Klipper が接続され正常に動作している間は、この設定はいかなるピン操作にも影響しませんので安全にご利用いただけます。

書き込み失敗時の回復と一般的な保護機能

誤ったファームウェア書き込み時の保護:Katapult、HID、Bootloader の各ファームウェアには保護機能が備わっています。特別なDFUモードでの書き込みを行わない限り、メインファームウェアを誤って書き込んでもこれらが上書きされることはありませんので、マザーボードが「ブリック（故障）状態」になることはありません。
書き込み完了後の必要操作:ファームウェアの書き込みが完了後は、必ずマザーボードの電源を完全に切る（ケーブルを抜く）必要があります。その後、再度電源を入れることで新しいファームウェアが正しくロードされ、安定して動作します。

書き込み前注意事項

デバイス認識:Katapult を使用して書き込みを行う場合、ホストコンピュータがデバイスを認識できるようにしてください。デバイスが見つからない場合は、マザーボード上のリセットボタンを素早くダブルクリックして、再度書き込みモードに入れてください。
公式ガイドラインの遵守:公式マニュアルの書き込み方法を厳密に守ってください。未検証の他の方法を使用するとデバイスが破損する可能性があります。
コンパイル確認:書き込み前にはファームウェアにコンパイルエラーがないことを必ず確認してください。エラーのあるファームウェアファイルは書き込み失敗やデバイスの正常な動作不能を引き起こします。