Руководство по устранению неполадок датчика EDDY
Частые вопросы о датчике EDDY
Ошибка при возврате в исходное положение Error during homing z: Eddy current sensor error
При возникновении этой ошибки проверяйте по порядку.
Обновите Klipper или систему
Ранее существовала проблема совместимости функции возврата в исходное положение по оси Z для EDDY, которая была исправлена в обновлении Klipper от 6 января 2026 года.
- Обычные хост-контроллеры: обновите Klipper до более новой стабильной версии.
- Хост-контроллеры FLY: обновите версию системы до V1.3.5 или выше.
После завершения обновления необходимо заново откалибровать EDDY.
Настройка тока возбуждения
- Откройте файл
printer.cfg. - Найдите параметр
reg_drive_current =в нижней части конфигурации. - Увеличьте или уменьшите текущее значение на
1, например,15можно изменить на16или14. - Указывайте непосредственно вычисленный результат, не вводите выражения типа
15+1. - Сохраните файл и перезагрузите принтер, затем повторно протестируйте возврат в исходное положение.
Настройка смещения зонда
Если после обновления и настройки тока возбуждения проблема не устранена, можно проверить параметр descend_z.
- В файле
printer.cfgнайдите секцию конфигурации[probe_eddy_current fly_eddy_probe]. - Соответствующим образом увеличьте значение
descend_z:. Обычно значение по умолчанию равно0.5, можно попробовать2.0или2.5. - Этот параметр может присутствовать в данной секции конфигурации только в одном месте, не дублируйте его.
- Рекомендуемое значение не должно превышать
3.0, итоговое значение определяется конструкцией станка и высотой установки зонда. - Сохраните и перезагрузите принтер, затем снова протестируйте возврат в исходное положение.
В конфигурации [probe_eddy_current] в Klipper после марта 2026 года используется параметр descend_z. Параметр z_offset в старой конфигурации устарел и может быть удален в следующих версиях; если в инструкциях, старой конфигурации или скриншотах все еще указан z_offset, предпочтительно заменить его на descend_z.
Сообщение Amplitude Low/High warning
Текст ошибки: my_eddy_probe: Amplitude Low/High warning (36), Amplitude Low/High warning (48) и т.д. Число в скобках — фактическое значение амплитуды.
Распространенные причины:
- Неподходящее значение
reg_drive_current, амплитуда колебаний датчика выходит за пределы идеального диапазона. - Расстояние между зондом и нагревательным столом слишком большое или слишком маленькое.
- Зонд установлен неплотно или поверхность нагревательного стола неровная.
Способы решения:
- Повторно выполните калибровку тока возбуждения:
LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe, затемSAVE_CONFIG. - Если после калибровки предупреждение сохраняется, вручную подстройте
reg_drive_current(по ±1 за раз), как описано в разделе «Настройка тока возбуждения» выше. - Проверьте надежность крепления зонда, рекомендуемое расстояние между нижней частью зонда и поверхностью нагревательного стола — 0.3–1.0 мм.
- Убедитесь, что нагревательный стол представляет собой ровную металлическую поверхность без деформаций и выпуклостей.
- Если предупреждение появляется только в определенных местах, возможно, поверхность стола локально неровная; можно попробовать перекалибровку в другом месте.
Сообщение !! probe_eddy_current sensor not in valid range
Эта ошибка означает, что показания зонда выходят за пределы допустимого диапазона. Распространенная причина — после включения зонда EDDY высота зондирования в других секциях конфигурации не применяется должным образом, что приводит к выходу зонда за пределы физического диапазона измерений.
Проверьте следующие места:
[probe_eddy_current fly_eddy_probe][bed_mesh][z_tilt]или[quad_gantry_level]- Пользовательские макросы возврата в исходное положение, выравнивания, сканирования стола
Способы обработки:
- Убедитесь, что все высоты опускания при зондировании находятся в допустимом диапазоне EDDY.
- Избегайте повторного переопределения одного и того же параметра высоты в нескольких макросах или секциях конфигурации.
- После изменений сохраните и перезапустите Klipper, затем заново выполните возврат в исходное положение или выравнивание.
Сообщение Eddy I2C STATUS/DATA error или Invalid read data
Подобные ошибки указывают на проблемы связи или чтения данных между EDDY и MCU.
Распространенные причины:
- Плохой контакт в жгуте проводов EDDY, разъеме или паяных соединениях.
- Слишком длинные линии I2C, низкое качество проводов или прокладка рядом с проводами двигателей и нагревателей, вызывающая помехи.
- Слишком высокая скорость I2C, нестабильная работа при текущих проводах и условиях.
- Нестабильное питание зонда.
Способы обработки:
Перед повторным подключением жгута проводов EDDY, укладкой проводов или проверкой разъемов полностью выключите принтер и отключите источник питания. Не подключайте и не отключайте датчик и не касайтесь клемм, пока принтер включен.
- При выключенном питании заново подключите жгут проводов EDDY, проверьте надежность клемм.
- Удалите провода связи EDDY от проводов двигателей, нагревателей и нагревательного стола.
- При использовании аппаратного I2C попробуйте снизить скорость I2C; если нестабильность сохраняется, протестируйте программный I2C.
- Предпочтительно проводить перекрестное тестирование путем замены готового жгута проводов, смены порта или замены датчика; электрическую проверку оголенных клемм доверьте службе поддержки или специалистам.
- После изменений заново выполните возврат в исходное положение или
PROBE_EDDY_CURRENT_CALIBRATE.
Контакты I2C и подключение: Описание контактов и конфигурации I2C для EDDY
Сообщение Unable to obtain probe_eddy_current sensor readings
Эта ошибка означает, что Klipper не получил действительных данных от датчика EDDY в течение заданного времени.
Распространенные причины:
- Обрыв линии связи датчика или ошибка в конфигурации шины/выводов.
- Зонд находится слишком далеко от металлической поверхности стола, показания вне допустимого диапазона.
- Неподходящее значение
reg_drive_current, недостаточный диапазон частот датчика. - Не завершена калибровка тока возбуждения или калибровка высоты Z.
Способы обработки:
Перед проверкой шины EDDY, подключения выводов или заменой жгута проводов датчика полностью выключите принтер и отключите источник питания. Не подключайте и не отключайте датчик, пока принтер включен.
- При выключенном питании убедитесь, что шина и выводы в конфигурации
[probe_eddy_current fly_eddy_probe]соответствуют фактическому подключению. - Переместите печатающую головку в центр нагревательного стола, убедившись, что EDDY находится над металлической поверхностью стола.
- Повторно выполните
LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probeиSAVE_CONFIG. - Повторно выполните
PROBE_EDDY_CURRENT_CALIBRATE CHIP=fly_eddy_probe. - Если ошибка возникает только при возврате в исходное положение, продолжайте настраивать
reg_drive_currentиdescend_zв соответствии с разделом «Ошибка при возврате в исходное положение» выше.
MCU Protocol error: Unknown command i2c_write
Текст ошибки: MCU Protocol error, mcu 'eddy': Unknown command: i2c_write, Command format mismatch.
Такие ошибки обычно указывают на несоответствие версий прошивки периферийного MCU EDDY / RP2040 и Klipper на хост-контроллере. Частая ситуация — обновление Klipper на хост-контроллере без перекомпиляции и прошивки прошивки EDDY; также возможно, что прошивка EDDY новее, чем Klipper на хост-контроллере, и хост еще не знает новых команд, используемых прошивкой периферийного устройства.
Способы обработки:
- Проверьте в
klippy.logзначенияGit versionиLoaded MCU 'eddy' ... version, чтобы убедиться, что хост-контроллер и прошивка EDDY получены из одного набора версий Klipper. - Перекомпилируйте и прошейте прошивку MCU, на котором находится EDDY; способ прошивки указан в документации соответствующей платы инструмента или продукта EDDY.
- При использовании сторонних интегрированных систем или модифицированного Klipper от производителя сначала убедитесь, что система поддерживает текущую прошивку EDDY; при неуверенности предпочтительно использовать пакет прошивки, предоставляемый той же системой.
- После прошивки выполните
FIRMWARE_RESTART, затем заново выполните калибровку тока возбуждения и высоты EDDY.
Общая проверка версий: MCU Protocol error
Ненормальное срабатывание в режиме TAP
При использовании METHOD=tap у EDDY, если зондирование останавливается преждевременно, не останавливается после касания стола или результаты明显 нестабильны, обычно это связано с состоянием tap_threshold и сопла/стола.
Подробный процесс: Метод отладки режима TAP для EDDY
Тест TAP заставляет сопло приближаться к нагревательному столу или касаться его. Перед выполнением убедитесь, что сопло и поверхность стола чистые, руки и инструменты находятся вдали от области движения, и подготовьте аварийную остановку.
Основные моменты проверки:
- Убедитесь, что сопло и поверхность стола чистые; остатки материала на сопле напрямую влияют на результат TAP.
- Перед началом TAP расстояние от сопла до стола рекомендуется поддерживать в пределах нескольких миллиметров, не слишком близко и не слишком далеко.
- Если остановка происходит без касания стола, возможно, значение
tap_thresholdслишком низкое — его можно适当 увеличить. - Если остановка не происходит после касания стола, возможно, значение
tap_thresholdслишком высокое — немедленно остановите процесс и снизьте порог. - После настройки заново выполните
PROBE_EDDY_CURRENT_TAP_CALIBRATE, после успешного прохождения —SAVE_CONFIG.
Срабатывание Timer too close при возврате в исходное положение / TAP
Текст ошибки: MCU 'xxx' shutdown: Timer too close.
Характер ошибки: При возврате в исходное положение EDDY, TAP или Z_TILT_ADJUST используется механизм синхронизации trsync, который в определенных условиях может вызывать скачок часов. Разработчики ядра Klipper подтверждали подобные случаи (скачок часов trsync в логах, переполнение 32-битного счетчика). Это известная проблема, ожидающая исправления, которая проявляется периодически, воспроизводится нестабильно и не обязательно означает повреждение жгута проводов или оборудования.
Распространённые причины:
- Таймерная синхронизация trsync при EDDY-хоуминге / TAP в определённых условиях приводит к скачку часов.
- Сценарий с CAN-инструментальной платой более подвержен; в строках
Statsдо и после ошибки могут одновременно появляться CAN-ретрансмиссии или пики нагрузки на хост-систему. - При наложении сторонних плагинов (автоматическое регулирование скорости, автоматическая настройка, синхронизация двигателей и т.д.) вероятность срабатывания повышается.
Способы решения:
- Обновите Klipper и перепрошейте все прошивки MCU, убедитесь, что версии хоста, инструментальной платы и EDDY MCU совпадают.
Z_TILT_ADJUSTможно временно переключить наMETHOD=scan— режим сканирования не использует путь trsync, что значительно снижает вероятность срабатывания.- Упростите макросы запуска, избегайте повторного хоуминга, повторного TAP и последовательных операций сканирования кровати, чтобы уменьшить возможности срабатывания.
- Поочерёдно отключайте сторонние плагины (автоматическое регулирование скорости, автоматическая настройка и т.д.) и проводите повторные тесты, чтобы определить, вызвано ли это наложением плагинов.
- Если одновременно появляются CAN-ретрансмиссии или коммуникационные ошибки, проверьте жгут проводов и состояние шины согласно разделу Устранение ошибок CAN.
Специальная проверка TAP: EDDY TAP / Z_TILT вызывает Timer too close
Системная проверка: Timer too close
Внутренняя ошибка stepcompress при сканировании кровати / выравнивании
Сообщение об ошибке: Internal error in stepcompress, Error in syncemitter 'xxx' step generation, Exception in flush_handler.
При высокоскоростном сканировании EDDY, BED_MESH_CALIBRATE, Z_TILT_ADJUST или сканировании через scanner, если очередь движения накладывается на выборку EDDY, что приводит к внутренним аномалиям в генерации шагов, может возникнуть такая ошибка.
Способы решения:
- Сохраните полный
klippy.log, просмотрите Python Traceback и выполняемую команду до и после ошибки. - Снизьте скорость сканирования, количество точек зонда, плотность интерполяции и параметры сканирования EDDY, затем повторите тест.
- Временно отключите сторонние плагины scanner, автоматического регулирования скорости, улучшенного авто-выравнивания и т.д., используйте оригинальный Klipper для повторного теста.
- После обновления Klipper перепрошейте все прошивки MCU.
Подробное устранение: Внутренние ошибки stepcompress / syncemitter / flush_handler
Нестабильность первого слоя из-за температурного дрейфа
EDDY — это вихретоковый датчик; изменения температуры кровати, температуры сопла, температуры катушки датчика и температуры близлежащих металлических деталей влияют на результаты измерений. Обычно это проявляется так: калибровка на холодной машине проходит нормально, но на горячей машине первый слой печати получается выше или ниже.
Способы решения:
- По возможности выполняйте калибровку EDDY при температуре, близкой к фактической температуре печати.
- Перед печатью дождитесь стабилизации температуры кровати и сопла, затем выполняйте хоуминг, выравнивание или сканирование кровати.
- Если EDDY оснащён датчиком температуры, настройте
[temperature_probe]и выполните компенсацию температурного дрейфа. - Для закрытых машин рекомендуется выполнять точную калибровку после стабилизации температуры в камере.
Рекомендации по отладке descend_z
Во множестве случаев отладки установка начального значения descend_z в [probe_eddy_current fly_eddy_probe] на 2.5 позволяет быстрее ввести многие датчики EDDY в рабочее состояние.
2.5 — это лишь отправная точка для отладки, а не универсальное фиксированное значение и не официальная конфигурация по умолчанию. Оптимальное смещение зависит от места установки зонда, высоты сопла и конструкции машины; руководствуйтесь фактическими результатами калибровки.