Ошибка «достигнуто максимальное значение разрешения или скорости» на 3D-принтере с прошивкой Klipper или Marlin появляется, когда заданное перемещение оси или экструдера превышает лимит, прописанный в конфигурации — чаще всего это max_velocity или max_extrude_only_distance в printer.cfg. Принтер при этом останавливает печать и выводит сообщение в консоль интерфейса Mainsail или Fluidd.

Проблема не всегда означает неисправность железа: в большинстве случаев это конфликт между настройками слайсера и ограничениями прошивки. Реже причина кроется в механических заеданиях, из-за которых реальная скорость не соответствует расчётной. Ниже разберём, как отличить программную причину от аппаратной и что проверять в первую очередь.

Что именно ограничивает прошивка

В Klipper для каждой оси и экструдера задаются предельные параметры движения. Если G-код или команда вручную запрашивает перемещение быстрее лимита, контроллер прерывает работу, чтобы защитить механику от пропуска шагов и ударов.

Основные параметры, которые стоит открыть в printer.cfg:

  • 🔧 max_velocity — максимальная линейная скорость оси в мм/с;
  • ⚙️ max_accel — максимальное ускорение, влияет на разгон при старте движения;
  • 🧵 max_extrude_only_distance — максимальная длина одиночной экструзии/ретракта без перемещения по XY;
  • 📏 max_extrude_only_velocity — предел скорости подачи прутка вне печати.

Команды ручной экструзии через панель управления тоже подпадают под эти лимиты. Поэтому ошибка иногда появляется не во время печати, а при прогрузке филамента длинным шагом — например, при попытке выдавить 100 мм за одну команду, когда лимит установлен ниже.

💡

Ошибка лимита скорости или расстояния — это защитная реакция прошивки, а не признак поломки. Сначала проверяйте конфигурацию, а не механику.

Программные причины: слайсер и конфиг

Самый частый сценарий — профиль слайсера рассчитан на другой принтер или на иные лимиты. Если вы перенесли профиль из Cura в PrusaSlicer или взяли чужой стартовый G-код, скорости перемещений и ретрактов могут превышать значения из printer.cfg.

Проверьте соответствие следующих параметров:

  • 🖨️ Скорость холостых перемещений (travel) в слайсере против max_velocity осей X и Y;
  • 🔄 Скорость и длина ретракта против лимитов экструдера;
  • 🚀 Ускорения в профиле печати против max_accel;
  • 📄 Стартовый и завершающий G-код — там могут быть команды с завышенной скоростью подачи.
⚠️ Внимание: не повышайте лимиты в printer.cfg «с запасом» в несколько раз. Значения должны соответствовать реальным возможностям механики — шаговых двигателей, ремней и направляющих. Завышенные лимиты приводят к пропуску шагов и смещению слоёв.
📊 Где чаще всего возникала у вас эта ошибка?
При ручной экструзии филамента
Во время печати из слайсера
При движении осей из панели управления
После обновления прошивки или смены профиля

Пошаговая диагностика

Действуйте от простого к сложному — так вы исключите программные причины, не разбирая принтер.

Порядок проверки:

  • 1️⃣ Откройте консоль в Mainsail/Fluidd и найдите полный текст ошибки — там указано, какой параметр превышен;
  • 2️⃣ Сравните значение из ошибки с соответствующим лимитом в printer.cfg;
  • 3️⃣ Если превышение небольшое — снизьте соответствующую скорость в слайсере и пересохраните G-код;
  • 4️⃣ Если ошибка возникает при ручной экструзии — уменьшите длину или скорость выдачи в панели управления;
  • 5️⃣ После правок конфига выполните RESTART или FIRMWARE_RESTART, чтобы изменения применились.

☑️ Чек-лист диагностики ошибки лимита

Выполнено: 0 / 5

Если после снижения скоростей ошибка исчезла — причина была программной. Если сообщение появляется даже на малых скоростях, переходите к проверке механики.

Механические причины

Заедания в механике сами по себе не вызывают сообщение о лимите напрямую, но могут провоцировать сопутствующие ошибки и пропуски шагов, которые пользователь путает с лимитом скорости. Особенно это касается осей с загрязнёнными направляющими и перетянутыми ремнями.

⚠️ Внимание: перед проверкой механики отключите моторы командой M84 (или через кнопку отключения шаговых в веб-интерфейсе) и двигайте каретки только вручную, плавно. Резкие перемещения генерируют обратный ток в драйверы.

Проверьте плавность хода каретки по каждой оси, состояние ремней и отсутствие люфтов. На экструдере убедитесь, что филамент проходит свободно: пережатый или спутанный пруток повышает сопротивление подачи.

💡

Запишите заводские или проверенные значения max_velocity и max_accel в комментарии внутри printer.cfg — после экспериментов будет к чему откатиться.

Таблица: типичные симптомы и их источники

СимптомВероятная причинаЧто делать
Ошибка при ручной экструзииПревышен max_extrude_only_distanceУменьшить длину шага подачи
Ошибка в начале печатиЗавышенные скорости в стартовом G-кодеОтредактировать стартовый блок в слайсере
Ошибка на быстрых перемещенияхTravel-скорость выше max_velocityСнизить скорость холостых ходов
Ошибка после смены профиляПрофиль от другого принтераСверить все лимиты с конфигом
Почему Klipper прерывает печать, а не просто снижает скорость

Прошивка рассчитывает траекторию заранее, и если запрошенное движение физически невозможно выполнить в заданных лимитах, безопаснее остановиться, чем печатать с искажённой геометрией. Поэтому ошибка фатальна для текущей печати, но не для принтера.

Когда обращаться к документации

Точные допустимые значения скоростей и ускорений зависят от конкретной модели принтера, типа кинематики и установленных драйверов. Универсальных цифр не существует: то, что нормально для CoreXY-машины, может быть недостижимо для картезианского принтера с тяжёлым столом.

Ориентируйтесь на официальную документацию производителя принтера и справочник по конфигурации Klipper. Значения из чужих конфигов используйте только как отправную точку и проверяйте их тестовыми печатями с постепенным повышением скорости.

💡

Надёжный метод подбора лимитов — поднимать скорость небольшими шагами с контрольной печатью после каждого изменения, а не копировать чужие максимальные значения.

Частые вопросы

Можно ли просто увеличить лимит в printer.cfg и забыть об ошибке?

Технически да, но только если новое значение реально достижимо для механики принтера. Завышенный лимит приведёт к пропускам шагов, смещению слоёв и ударам каретки. Сначала выясните, почему слайсер запросил такую скорость.

Почему ошибка появилась после обновления прошивки?

Возможная причина — изменение значений по умолчанию или сброс конфигурации при обновлении. Сравните текущий printer.cfg с резервной копией, если она есть.

Ошибка возникает только на ретрактах — что проверить?

Скорость ретракта в слайсере и лимит max_extrude_only_velocity. Снизьте скорость ретракта в профиле печати и повторите тест.

Опасна ли эта ошибка для принтера?

Нет, это защитное сообщение — прошивка останавливает печать именно для предотвращения повреждений. Опасно как раз игнорировать причину и бездумно задирать лимиты.

Нужно ли перепрошивать принтер для исправления?

Нет, достаточно отредактировать printer.cfg и выполнить перезапуск конфигурации командой RESTART. Перепрошивка требуется только при смене платы или версии прошивки.