Плагин анализа резонанса Klippain Shake&Tune

Klippain Shake&Tune — это плагин для анализа резонанса и калибровки входного шейпера Klipper, который создает визуальные графики на основе вибрационных данных, собранных акселерометром, помогая выявлять механические проблемы и оптимизировать фильтры Input Shaper.

Пользователям FlyOS-FAST

В FlyOS-FAST v1.3.5 и выше Shake&Tune уже предустановлен, ручная установка не требуется. Просто добавьте секцию [shaketune] в printer.cfg и перезапустите систему.

Полные параметры конфигурации и описание см.: Документация плагина Shake&Tune для FlyOS-FAST

Установка

Подключитесь к управляющему компьютеру через SSH и убедитесь, что выполнены следующие условия:

1. На управляющем компьютере установлена прошивка Klipper.
2. Акселерометр (ADXL345, LIS2DW и т.п.) установлен и корректно настроен, команда ACCELEROMETER_QUERY успешно возвращает данные.
3. В printer.cfg определена секция [resonance_tester].

Получение или обновление плагина

На этом этапе требуется подключение к GitHub. Убедитесь, что репозиторий успешно получен, затем запустите скрипт установки.

cd ~
if [ -d ~/klippain-shaketune/.git ]; then
  git -C ~/klippain-shaketune pull --ff-only
else
  git clone https://github.com/Frix-x/klippain-shaketune.git ~/klippain-shaketune
fi

Запуск скрипта установки

cd ~/klippain-shaketune
chmod +x install.sh
./install.sh
systemctl restart klipper

Если вы используете систему FlyOS-FAST, путь установки следует изменить на каталог /data/. Подробности см. в документации FlyOS-FAST выше.

Добавление секции конфигурации

Добавьте в printer.cfg:

[shaketune]
# result_folder: ~/printer_data/config/ShakeTune_results
#    Путь сохранения результатов обработки. Папка создается автоматически, если не существует
# number_of_results_to_keep: 10
#    Количество последних результатов для хранения. Старые файлы удаляются автоматически при превышении лимита
# keep_raw_data: False
#    Установите True для одновременного сохранения исходных файлов .stdata для отладки проблем или отправки отзывов
# show_macros_in_webui: True
#    Показывать кнопки макросов Shake&Tune в веб-интерфейсе Fluidd / Mainsail
# timeout: 600
#    Таймаут генерации графиков (в секундах). Можно увеличить для устройств с низкой производительностью

Сохраните файл и перезапустите Klipper.

Проверка установки

systemctl is-active klipper

После возврата значения active введите в веб-консоли такие макрокоманды, как TEST_RESONANCES, чтобы убедиться, что команды распознаются.

Доступные макрокоманды

После установки следующие макрокоманды можно использовать в веб-консоли или G-code:

Макрокоманда	Назначение
TEST_RESONANCES AXIS=X	Измерение резонанса по оси X и создание графика спектра с рекомендуемыми параметрами Input Shaper
TEST_RESONANCES AXIS=Y	Измерение резонанса по оси Y и создание графика спектра
TEST_RESONANCES AXIS=X OUTPUT=raw_data	Только сбор исходных данных без автоматической генерации графиков
COMPARE_RESONANCES	Сравнение двух последних измерений резонанса для наблюдения за эффектом настройки
BELTS_SHAPER_TUNING	Специальный тест резонанса ремней с созданием сравнительного графика спектра с окном Ханна

После каждого выполнения Shake&Tune создает файлы PNG-графиков в папке result_folder, которые можно просмотреть через файловый менеджер Fluidd / Mainsail.

Отличия от встроенных команд Klipper

Shake&Tune не заменяет встроенную команду Klipper SHAPER_CALIBRATE, а дополняет её более детальным визуальным анализом:

Функция	Встроено в Klipper	Shake&Tune
Автоматический расчет параметров Input Shaper	SHAPER_CALIBRATE записывает напрямую в конфигурацию	TEST_RESONANCES создает графики для ознакомления
Визуальные графики спектра	Нет	Автоматическая генерация PNG-графиков спектра
Сравнение натяжения ремней	Нет	BELTS_SHAPER_TUNING создает сравнительные графики
Сравнение нескольких измерений	Нет	COMPARE_RESONANCES сравнивает последние результаты

Встроенные команды подходят для быстрой автоматической калибровки; Shake&Tune подходит для сценариев, требующих детального просмотра спектра, поиска механических проблем или сравнения натяжения ремней.

Часто задаваемые вопросы

Таймаут генерации графиков

На устройствах с низкой производительностью генерация графиков может завершаться по таймауту. Соответственно увеличьте значение timeout в секции [shaketune], например: timeout: 900.

В папке результатов ничего не создается

Убедитесь, что путь result_folder существует и у Klipper есть права на запись.

Ошибка ACCELEROMETER_QUERY после установки

Shake&Tune не влияет на низкоуровневую связь с акселерометром. Если после установки возникают ошибки связи, сначала проверьте оборудование и конфигурацию в соответствии с разделом Тестирование и калибровка акселерометра.

Конфигурация и тестирование акселерометра: См. тестирование и калибровку акселерометра

Компенсация резонанса и настройка Input Shaper: См. проблемы конфигурации компенсации резонанса и упреждающего давления