Часто используемые команды
В этом документе собраны часто используемые команды Linux в системе Klipper, предназначенные для:
- Справочник по повседневным операциям – быстрый поиск часто используемых команд
- Помощь в диагностике проблем – при возникновении типичных проблем можно найти соответствующие команды для проверки или исправления
- Изучение и памятка – как базовый набор команд для взаимодействия Linux и Klipper
Примечание: Данный документ содержит только описание команд и краткие пояснения, не затрагивая конкретные процессы отладки или анализ неисправностей. При реальном использовании учитывайте конкретную ситуацию.
Идентификация устройств
Запрос ID устройства CAN
Обычный хост:
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
Хост FLY:
python3 ~/klipper/scripts/canbus_query.py can0
Запрос ID устройства USB
ls /dev/serial/by-id/*
Прошивка
Серия STM32 (режим DFU)
- Обратите внимание, что HEX-файлы не поддерживаются
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/<файл_прошивки>.bin
Прошивка Klipper через Katapult
Прошивка через USB
Обычный хост:
~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<ID_вашей_платы>
Хост FLY:
python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<ID_вашей_платы>
Универсальная команда (требуется указать ID устройства):
cd ~/klipper/ && make flash FLASH_DEVICE=<ID_вашей_платы>
Прошивка через CAN
Выберите правильную команду в зависимости от версии вашей системы:
-
FlyOS-FAST 1.3.8 и выше или системы с обновленным Klipper после 9 апреля 2026 года:
python3 ~/klipper/lib/katapult/flashtool.py -u <CAN-ID> -
Старые версии системы (до FAST 1.3.8 или Klipper не обновлялся до 9 апреля 2026 года):
python3 ~/klipper/lib/canboot/flash_can.py -u <CAN-ID>
Сброс CAN в BL
Обычный хост:
~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <ID_вашей_платы>
Хост FLY:
python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <ID_вашей_платы>
Серия RP2040
Прошивка Klipper
cd ~/klipper/ && make flash FLASH_DEVICE=2e8a:0003
Прошивка загрузчика
Для первой прошивки требуется компиляция инструмента:
cd ~/klipper/ && cd ~/klipper/lib/rp2040_flash/ && make
Выполнение прошивки:
sudo ~/klipper/lib/rp2040_flash/rp2040_flash ~/<путь_к_прошивке>/<имя_файла>.uf2
Управление кодом
Получение конкретной ветки
Получить ветку dev-flyos репозитория в каталог /data/klipper:
cd && git clone https://cnb.cool/3dmellow/public/klipper -b dev-flyos /data/klipper
Управление службами
Служба Klipper
Перезапуск службы
sudo systemctl restart klipper
Просмотр журнала в реальном времени
sudo journalctl -u klipper -f
Просмотр статуса службы
sudo systemctl status klipper
Служба Moonraker
Перезапуск службы
sudo systemctl restart moonraker
Просмотр журнала в реальном времени
sudo journalctl -u moonraker -f
Просмотр статуса службы
sudo systemctl status moonraker
Служба KlipperScreen
Перезапуск службы
sudo systemctl restart KlipperScreen
Просмотр журнала в реальном времени
sudo journalctl -u KlipperScreen -f
Просмотр статуса службы
sudo systemctl status KlipperScreen