設定クラスのエラーメッセージ
このページでは、設定セクションの競合、パラメータのスペルミス、include ファイル、および SAVE_CONFIG に関する問題をまとめています。設定を変更した後は、まず klippy.log の最初の設定エラーを確認し、項目ごとに処理してください。
homing override method always homes X and Y before homing Z
エラーメッセージ：セーフZホーミングとホーミングオーバーライド設定の競合。
エラーの原因：[safe_z_home] と [homing_override] の両方が設定されており、Klipper がどちらのホーミングロジックを使用すべきか判断できません。
解決方法：
- 設定ファイル内で
[safe_z_home]と[homing_override]を検索します。 - マシンの実際のホーミングロジックに基づいて、どちらか一方のみを残します。
- 保存して Klipper を再起動します。
関連設定の参考：ホーミングと方向調整ガイド、ホーミングオーバーライドの参考設定。
Option 'xxx' is not valid in section 'yyy'
エラーメッセージ：Option 'xxx' is not valid in section 'yyy'。指定された設定セクションに認識できないオプション名が存在します。
一般的な原因：
- オプション名のスペルミス。例：
sensor_pinをsensor_pingと記述。 - 他の設定セクションのオプションを誤って現在のセクションに貼り付け。例：
[probe]のオプションを[stepper_z]に記述。 - Klipper のバージョンアップ後、以前のバージョンでサポートされていたオプションが削除または名前変更された。
- 実際のパラメータではないコメント内容を使用。例：
default_parameter_z。
解決方法：
- エラーが示す設定セクションとオプション名を注意深く確認し、スペルを確認します。
- Klipper 設定リファレンスドキュメント を参照して、そのオプションがどの設定セクションに属するかを確認します。
- 最近 Klipper をアップグレードした場合は、設定変更履歴 を確認して、オプションに変更がないか確認します。
- 無効なオプションを削除するか、正しい設定セクションに移動します。
関連設定の参考：設定変更の説明。
Section 'xxx' is not a valid config section
エラーメッセージ：Section 'xxx' is not a valid config section、Unknown config object、または特定の設定セクションが Klipper に認識されません。
一般的な原因：
- 設定セクション名のスペルミス。例：
[bed_mesh]を[bedmesh]と記述。 - 現在の Klipper バージョンがその設定セクションをサポートしていない、または更新/ダウングレード後に設定形式に互換性がない。
- サードパーティのプラグイン設定をコピーしたが、対応するプラグイン、拡張モジュール、または Klipper ブランチがインストールされていない。
- include ファイルに、他のマシンや他のマザーボード用の設定セクションが残っている。
解決方法：
- エラーの設定セクション名に基づいて、
printer.cfgとすべての include ファイル内で該当する段落を特定します。 - スペルが Klipper 設定リファレンスと一致しているか確認します。設定セクション名に中国語の括弧や全角記号を使用しないでください。
- その設定がサードパーティのプラグインやカスタムマクロパッケージからのものである場合、対応するプラグインがインストールされ、現在の Klipper バージョンと互換性があることを確認します。
- 該当段落の用途が不明な場合は、まずその設定セクションをコメントアウトして再起動テストを行い、項目ごとに復元します。
関連設定の参考：設定変更の説明。
Unable to open config file / Include file does not exist
エラーメッセージ：Unable to open config file /home/xxx/printer_data/config/printer.cfg または Include file 'xxx.cfg' does not exist。
一般的な原因：
printer.cfgファイルのパスが間違っているか、ファイルが誤って削除された。[include]で参照されているサブ設定ファイルが存在しないか、ファイル名が一致しない。- KIAUH などのインストールツールが自動生成した
[include]参照に対応する cfg ファイルがインストールされていない。 - 権限の問題により Klipper が設定ファイルを読み取れない。
解決方法：
printer.cfgが Klipper 設定ディレクトリ（通常は~/printer_data/config/printer.cfg）に存在するか確認します。- すべての
[include xxx.cfg]行をチェックし、参照されているファイルが実際に存在することを確認します。 fluidd.cfgやmainsail.cfgがない場合は、対応する Web インターフェースのインストールドキュメントを参照して設定を追加します。- 設定ファイルの権限が正しいことを確認します：
ls -la ~/printer_data/config/。
Unable to parse option / option must be specified
エラーメッセージ：Unable to parse option 'xxx' in section 'yyy'、Option 'xxx' in section 'yyy' must be specified、または must have minimum/maximum、must be above/below。
一般的な原因：
- 必須パラメータの欠落。例：
[extruder]にstep_pin、dir_pin、heater_pin、またはsensor_typeがない。 - パラメータの形式が正しくない。例：数値が必要なところに文字が入力されている、座標リストにカンマがない。
- パラメータ値が Klipper の許容範囲外。例：
run_current、max_temp、position_maxの設定が不合理。 - 設定をコピーした際に、中国語の句読点や全角記号、非表示文字が残っている。
解決方法：
- エラーの設定セクションとパラメータ名に基づき、該当する
.cfgファイルで項目ごとにチェックします。 - 数字、座標、リストパラメータについては、形式がサンプルと一致していることを確認します。例：
mesh_min: 20, 20。 must be above/belowまたはminimum/maximumの場合は、まず公式サンプルまたはマザーボードチュートリアルの推奨値に戻します。- 保存後
RESTARTを実行し、それでも失敗する場合は、klippy.logの最初の設定エラーを確認します。
関連設定の参考：設定変更の説明。
Unknown pin chip name / pin used multiple times
エラーメッセージ：Unknown pin chip name 'xxx'、Invalid pin description 'xxx'、pin xxx used multiple times in config。
一般的な原因：
- 複数 MCU 設定でピン接頭辞を間違えている。例：
EBBCan:PB0と書くべきところを、存在しない MCU 名で記述。 - ピン名のスペルミス、またはマザーボードチュートリアルのピンを別のマザーボードにそのままコピー。
- 同じ物理ピンが複数の機能で重複使用されている。例：ファン、ヒーター、エンドストップが同じピンを使用。
- ピンの反転
!、プルアップ^、プルダウン~を誤った位置に記述。
解決方法：
[mcu xxx]の名前がピン接頭辞と完全に一致しているか（大文字小文字も含めて）確認します。- マザーボードのピン配置図と照らし合わせて、各
pin:、step_pin:、dir_pin:、heater_pin:が現在のマザーボードに属しているか確認します。 - すべての include ファイルでエラーのピンを検索し、重複している項目を削除または変更します。
- ピン修飾子はピン名の前に記述します。例：
^PB7、!PC13、mcu2:^PB7。
gcode command XXX already registered
エラーメッセージ：Error: gcode command XXX already registered。
エラーの原因：2つの異なるマクロまたはシステムモジュールが同じ G-code コマンド名を登録しています。例：2つのマクロが両方とも [gcode_macro NEXT] を定義している。
よくあるシナリオ：
- ユーザー定義マクロが Klipper システムモジュールまたはサードパーティ設定と競合。
- 複数の
[gcode_macro M600]定義。
解決方法：
printer.cfgとすべての[include]ファイルで重複定義を検索します。- 競合する
[gcode_macro]を削除するか、名前を変更します。 [homing_override]、[gcode_macro PAUSE]、[gcode_macro RESUME]、[gcode_macro CANCEL_PRINT]などの一般的なマクロを確認します。
関連設定の参考：マクロの紹介。
SAVE_CONFIG の失敗または設定の競合
エラーメッセージ：SAVE_CONFIG 実行後に Unable to write config、Option conflict、Cannot save config と表示される、または保存後にプリンターが起動しない。
一般的な原因：
printer.cfgファイルの権限が不足しており、Klipper プロセスが書き込めない。sudoを使用して設定ファイルを編集した後に発生しやすい。- 自動保存領域（
#*#マークブロック）の設定項目が、手動の[include]ファイル内の同じオプションと競合。 - MCU がシャットダウン状態であり、
SAVE_CONFIGが新しい設定を正常に送信できない。 printer.cfgファイルの末尾に構文エラーがあるか、切り詰められており、自動保存領域への書き込みに失敗。- 複数の include ファイルで、PID や Z offset など、
SAVE_CONFIGによって自動保存されるべきではないパラメータが重複定義されている。
解決方法：
-
設定ファイルの権限を確認します：
ls -la ~/printer_data/config/printer.cfg所有者が現在のユーザーでない場合は、以下を実行します：
sudo chown $USER:$USER ~/printer_data/config/printer.cfg -
SAVE_CONFIG後にプリンターが起動しない場合は、printer.cfgを開いて下部の#*#自動保存領域を確認します。 -
同じオプションが include ファイルにも存在する場合は、自動保存領域の重複項目を削除するか、include ファイルで一元的に管理するように変更します。
-
MCU がシャットダウン状態の場合は、まず
FIRMWARE_RESTARTを実行し、その後再度SAVE_CONFIGを実行します。 -
権限が正常でも書き込めない場合は、ディスク容量を確認します：
df -h ~/printer_data/。
関連設定の参考：設定変更の説明。