USB-акселерометр BIGTREETECH ADXL345
ADXL345 · RP2040 · USB Type-C · Klipper
USB-акселерометр BIGTREETECH ADXL345 предназначен для измерения резонансов 3D-принтера и настройки Input Shaper в Klipper. Трёхосевой датчик передаёт данные через встроенный RP2040, поэтому для подключения к хосту достаточно USB-кабеля с линиями данных. Модуль устанавливают на печатающую голову или подвижный стол на время калибровки.
На плате находятся ADXL345, RP2040, разъём USB Type-C и кнопка BOOT. SPI-соединение датчика с микроконтроллером выполнено внутри модуля. После прошивки и настройки Klipper можно оценить частоты колебаний конкретной механики и подобрать параметры их программного подавления.

Данные для анализа колебаний принтера.
Внутренняя SPI не требует внешнего шлейфа.
Измерения после изменения механики.
Для чего нужны измерения
После резкого изменения скорости механика может продолжать колебаться. На модели это проявляется повторяющимися волнами рядом с углами и мелкими деталями. Акселерометр фиксирует ускорения во время теста, а Klipper строит частотный отклик и рассчитывает варианты Input Shaper.
Измерение полезно после сборки принтера, замены экструдера, изменения массы головы или натяжения ремней. Сначала устраняют люфты, заедания и ослабленные крепления. Затем подбирают параметры шейпера с учётом сглаживания движения, ускорений и возможностей экструзии.

Аппаратные характеристики
| Датчик | Трёхосевой ADXL345 |
|---|---|
| Контроллер модуля | RP2040, два ядра Cortex-M0+ |
| Связь с хостом | USB 2.0, разъём Type-C |
| Питание | 5 В от USB; логика платы 3,3 В |
| Интерфейс датчика | Четырёхпроводная SPI внутри платы |
| Частота выдачи данных | До 3200 Гц по руководству семейства |
| Размер платы | 33,25 × 15,5 мм по документации USB-семейства |
| Обслуживание | Кнопка BOOT, дополнительные площадки для проводов |
| Защита | ESD-защита USB-интерфейса |
| Программная работа | Klipper с прошивкой MCU и конфигурацией ADXL345 |
Крепление и выбор измеряемого узла
Датчик закрепляют жёстко: гибкий держатель или свободный винт добавляет собственный резонанс и искажает результат. USB-кабель оставляют с достаточным запасом для полного хода и фиксируют так, чтобы он не тянул плату. Крепёж и кронштейн выбирают под геометрию конкретной головы.
У CoreXY голова перемещается по X и Y, поэтому оба измерения обычно выполняют на ней. У принтера с подвижным столом ось X измеряют на голове, а Y — на столе. Один модуль можно переставлять между тестами, каждый раз проверяя ориентацию и axes_map.
Плату размещают вдали от открытых контактов нагревателя и горячего блока. Температурный диапазон микросхемы ADXL345 не определяет допустимую температуру всей платы, USB-разъёма и крепления.
Документация и прошивка
Товар указан в каталоге как v2.1; официальное руководство USB-семейства BTT называется V2.0 и отдельно описывает изменение V2.0.1. Перед использованием дополнительных выводов сверяйте маркировку своей платы. Общая схема USB и внутренней SPI приведена в фирменной конфигурации.
В руководстве от 7 мая 2025 года для сборки Klipper указаны rp2040, No bootloader, Flash GENERIC_03H with CLKDIV 4 и USBSERIAL. BOOT удерживают при подключении USB, чтобы войти в штатный загрузчик RP2040. После прошивки получают собственный путь устройства в /dev/serial/by-id/.
Кнопка BOOT нужна для входа в загрузчик, а обычные измерения выполняются с запущенной прошивкой. Зарядный кабель без линий данных для связи не подходит. Если устройство не обнаруживается, сначала проверяют кабель, порт хоста и режим загрузки.
Конфигурация именно USB-модуля BTT
Файл sample-bigtreetech-adxl345-v2.0.cfg использует cs_pin на GPIO9 и шину spi1_gpio8_gpio11_gpio10. Соответствие сигналов: MISO — GPIO8, MOSI — GPIO11, SCLK — GPIO10. Эти номера относятся к RP2040 на модуле; настройки SPI-разъёма Raspberry Pi здесь не подставляют.
В примере указаны демонстрационный serial ID, axes_map: -x,-y,-z и точка 100, 100, 20. Их заменяют данными своего устройства, ориентацией платы и безопасной точкой внутри рабочего объёма. Установленный датчик должен соответствовать имени, заданному в секции resonance_tester.
Проверка и сохранение результата
До тестовых движений выполняют ACCELEROMETER_QUERY и MEASURE_AXES_NOISE. Ошибку идентификатора или отсутствие данных сначала устраняют проверкой SPI-настроек и связи. Если шум высок, проверяют крепление и влияние вентиляторов; отключать обдув можно только при безопасном состоянии хотэнда.
Далее запускают SHAPER_CALIBRATE для нужной оси, оценивают предложенные параметры и сохраняют результат через SAVE_CONFIG. Частота выдачи 3200 Гц не является гарантированной частотой резонанса, которую можно компенсировать; реальный результат зависит от измерения и механики.
После снятия акселерометра удаляют или отключают его MCU и связанные секции из активной конфигурации. Сохранённые настройки Input Shaper оставляют. Иначе Klipper при запуске будет ожидать отключённый модуль.
Документация
Руководство BTT ADXL345 USB · Фирменная конфигурация Klipper · Измерение резонансов в Klipper.
