Часто используемые команды
В этом документе собраны часто используемые команды 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
Прошивка Bootloader
Для первой прошивки необходимо собрать инструмент:
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