Перейти к основному содержанию

Ошибки класса конфигурации

На этой странице собраны вопросы, связанные с конфликтами разделов конфигурации, опечатками параметров, include файлами и SAVE_CONFIG. После изменения конфигурации сначала просмотрите первую ошибку конфигурации в klippy.log, затем обрабатывайте каждую по порядку.

homing_override method always homes X and Y before homing Z​

Сообщение об ошибке: Безопасное позиционирование по Z конфликтует с конфигурацией переопределения позиционирования.

Loading...

Причина ошибки: Одновременно настроены [safe_z_home] и [homing_override], из-за чего Klipper не может определить, какую логику позиционирования использовать.

Метод решения:

  1. Найдите в файле конфигурации [safe_z_home] и [homing_override].
  2. В зависимости от фактической логики позиционирования станка оставьте только один из них.
  3. Сохраните и перезапустите 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.

Метод решения:

  1. Тщательно проверьте раздел конфигурации и имя опции, указанные в сообщении об ошибке, убедитесь в правильности написания.
  2. Обратитесь к справочной документации по конфигурации Klipper, чтобы подтвердить, к какому разделу конфигурации должна относиться эта опция.
  3. Если вы недавно обновляли Klipper, просмотрите журнал изменений конфигурации, чтобы проверить, не было ли изменений в опции.
  4. Удалите недействительную опцию или переместите ее в правильный раздел конфигурации.

Связанная конфигурация: Инструкция по изменению конфигурации.

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 файлах сохранены разделы конфигурации, относящиеся к другому станку или другой материнской плате.

Метод решения:

  1. В соответствии с именем раздела конфигурации из сообщения об ошибке найдите соответствующий абзац в printer.cfg и всех include файлах.
  2. Убедитесь, что написание соответствует справочнику по конфигурации Klipper, не используйте китайские скобки или полноширинные символы в именах разделов конфигурации.
  3. Если эта конфигурация взята из стороннего плагина или пользовательского макропакета, убедитесь, что соответствующий плагин установлен и совместим с текущей версией Klipper.
  4. Если вы не уверены в назначении этого раздела, сначала закомментируйте его и перезапустите для теста, затем восстанавливайте по порядку.

Связанная конфигурация: Инструкция по изменению конфигурации.

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 не может прочитать файл конфигурации.

Метод решения:

  1. Убедитесь, что printer.cfg существует в каталоге конфигурации Klipper, обычно ~/printer_data/config/printer.cfg.
  2. Проверьте все строки [include xxx.cfg], убедитесь, что указанные файлы действительно существуют.
  3. Если отсутствуют fluidd.cfg или mainsail.cfg, обратитесь к документации по установке соответствующего веб-интерфейса для дополнения конфигурации.
  4. Убедитесь в правильности прав доступа к файлам конфигурации: 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.
  • При копировании конфигурации сохранены китайские знаки препинания, полноширинные символы или невидимые символы.

Метод решения:

  1. Согласно разделу конфигурации и имени параметра из сообщения об ошибке, вернитесь к соответствующему .cfg файлу и проверьте каждый элемент.
  2. Для числовых, координатных и списочных параметров убедитесь, что формат соответствует примеру, например, mesh_min: 20, 20.
  3. Для must be above/below или minimum/maximum сначала верните значение, рекомендованное в официальном примере или руководстве по материнской плате.
  4. После сохранения выполните 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.
  • Опечатка в имени вывода или прямое копирование вывода из руководства по материнской плате для другой платы.
  • Один и тот же физический вывод повторно используется несколькими функциями, например, вентилятор, нагреватель и концевой выключатель используют один и тот же вывод.
  • Инверсия вывода !, подтяжка ^, стягивание ~ написаны в неправильном месте.

Метод решения:

  1. Проверьте, совпадает ли имя в [mcu xxx] с префиксом вывода, включая регистр.
  2. Сверьтесь со схемой выводов материнской платы, убедитесь, что каждый pin:, step_pin:, dir_pin:, heater_pin: относится к текущей материнской плате.
  3. Найдите во всех include файлах указанный в ошибке вывод, удалите или замените повторно используемые элементы.
  4. Модификаторы вывода должны быть записаны перед именем вывода, например, ^PB7, !PC13, mcu2:^PB7.

Связанная конфигурация: Инструкция по изменению конфигурации, Эталонная конфигурация вентилятора.

gcode command XXX already registered​

Сообщение об ошибке: Error: gcode command XXX already registered.

Причина ошибки: Два разных макроса или системных модуля зарегистрировали одно и то же имя G-кода команды, например, оба макроса определяют [gcode_macro NEXT].

Распространенные сценарии:

  • Конфликт пользовательского макроса с системным модулем Klipper или сторонней конфигурацией.
  • Несколько определений [gcode_macro M600].

Метод решения:

  1. Найдите дублирующиеся определения в printer.cfg и всех [include] файлах.
  2. Удалите или переименуйте конфликтующий [gcode_macro].
  3. Проверьте распространенные макросы, такие как [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 находится в состоянии shutdown, SAVE_CONFIG не может нормально отправить новую конфигурацию.
  • В конце файла printer.cfg присутствует синтаксическая ошибка или он обрезан, что приводит к сбою записи области автосохранения.
  • Несколько include файлов повторно определяют параметры, которые не должны автоматически сохраняться SAVE_CONFIG, такие как PID, Z offset.

Метод решения:

  1. Проверьте права доступа к файлу конфигурации:

    ls -la ~/printer_data/config/printer.cfg

    Если владелец не текущий пользователь, выполните: sudo chown $USER:$USER ~/printer_data/config/printer.cfg

  2. Если после SAVE_CONFIG принтер не запускается, откройте printer.cfg, внизу просмотрите область автосохранения #*#.

  3. Если та же опция существует и в include файле, удалите дублирующийся элемент из области автосохранения или измените, чтобы управлять им централизованно в include файле.

  4. Если MCU находится в состоянии shutdown, сначала выполните FIRMWARE_RESTART, затем снова выполните SAVE_CONFIG.

  5. Если права доступа в порядке, но запись все равно не удается, проверьте место на диске: df -h ~/printer_data/.

Связанная конфигурация: Инструкция по изменению конфигурации.

Loading...