Как обратиться в поддержку к разработчику¶

Откройте телеграм бот @zmod_help_bot и задайте ему ваш вопрос, он знает всю документацию.

Обновить zMod и все плагины до последней версии
Перевести мод на русский язык LANG LANG=ru
Четко сформулировать проблему. Скрины, фото, текстовое описание.
Вызвать CLEAR_EMMC для очистки логов
Обязательно выключить принтер
Включить принтер
Сгенерировать проблему
Выполнить TAR_CONFIG - сохранить лог файлы
Выложить одно сообщение с описанием и файлом config.tar.gz
Добавить сообщение об ошибке

Если невозможно выполнить TAR_CONFIG, подключитесь к принтеру по SSH:

AD5M/AD5MPro:

chroot /data/.mod/.zmod/
/opt/config/mod/.shell/tar_config.sh

AD5X:

chroot /usr/data/.mod/.zmod/
/opt/config/mod/.shell/tar_config.sh

Почему я прошу оформлять тикеты — объяснение «на пальцах»¶

Представь, что твой принтер — это машина. А я — механик в огромном гараже, где одновременно ремонтирую сотни разных авто.

Ты приезжаешь и кричишь:

«У меня машина не едет!»

И я вынужден начать с простейшего вопроса:

«А что у тебя за машина — марка, модель, год выпуска?»

Почему это так важно — разбор «по частям»¶

Наш «автопарк» насчитывает более 100 уникальных конфигураций. Только по основным параметрам:

3 разных производителя:

FF5M, FF5M Pro, AD5X

3 версии «двигателя» (Klipper):

11, 12, 13

2 архитектуры процессора:

ARM и MIPS

Варианты «салонного оснащения»:
- с родным экраном
- с GuppyScreen
- вообще без экрана
Два основных интерфейса управления:

Fluidd и Mainsail

Разные способы отправки задач на печать:

через родной экран, Guppy, OrcaSlicer (FF-протокол, Klipper-протокол и др.)

Дополнительные «опции» (плагины):

nopoop, recommend, bambufy, g28_tenz, timelapse, notify и прочие

Сенсоры и периферия:

датчик филамента, датчик движения, IFS и т.п.

А ещё бывают случаи, когда владелец сам что-то перепаивает под капотом, заливает «непонятное топливо» (старые прошивки, сторонние моды), или читает советы от ИИ, никогда не видевших его конкретный принтер.

В итоге¶

Когда ты пишешь просто «не работает», я трачу часы, чтобы только выяснить:

Какая у тебя модель?
Какая прошивка/версия Klipper?
С экраном или без?
Какой слайсер и настройки?
Какие плагины включены?

Это неэффективно, тормозит помощь и выводит из себя всех.

Как правильно «привезти машину в сервис» — инструкция по созданию тикета¶

Чтобы я не гадал, а сразу помог, сделай всё по чек-листу:

1. Обновись до актуальной версии¶

Следуй официальной инструкции по обновлению.

2. Установи русский язык¶

Выполни в консоли:
LANG LANG=ru

3. Опиши проблему чётко и конкретно¶

❌ Плохо: «Не работает»

✅ Хорошо:

_«После обновления zMod до версии X.Y.Z при нажатии «Печать» с родного экрана:

— стол нагревается,

— экструдер НЕ греется,

— температура на экране 0°C,

— через 2 минуты печать просто отменяется.»_

🔹 Приложи скриншоты ошибок, фото,

🔹 Опиши последовательность действий,

🔹 Приложи, файл который печатаешь (возможно, проблема в G-коде!).

4. Сделай полную диагностику¶

Выполни строго по порядку: 1. CLEAR_EMMC — очистить старые логи

Выключи принтер полностью из розетки → Подожди 10 сек

Включи принтер

Воспроизведи проблему (запусти печать, нажми кнопку — вызови ошибку)

Выполни TAR_CONFIG — это создаст архив config.tar.gz со всеми логами

5. Оформи тикет правильно¶

Перейди на страницу Issues

Создай одно сообщение

В него:

понятное описание (п. 3),

обязательно прикрепи config.tar.gz,

приложи G-код, если проблема возникает при печати конкретного файла.

⚠️ Без config.tar.gz диагностика невозможна — это как сдать анализ крови без крови.

Что даёт такой подход?¶

Ты перестаёшь кричать «машина не едет!»,

и начинаешь привозить мне:

🚗 Конкретную модель,

📋 Журнал поломок,

📊 Результаты диагностики.

И тогда я могу начать чинить — сразу, а не гадать.

Спасибо за понимание и за уважение к чужому времени.

Это не бюрократия — это единственный способ сделать поддержку быстрой и эффективной.