Help

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

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

1. Обновить Z-Mod и все плагины до последней версии
2. Перевести мод на русский язык LANG LANG=ru
3. Четко сформулировать проблему. Скрины, фото, текстовое описание.
4. Вызвать CLEAR_EMMC для очистки логов
5. Обязательно выключить принтер
6. Включить принтер
7. Сгенерировать проблему
8. Выполнить TAR_CONFIG - сохранить лог файлы
9. Выложить одно сообщение с описанием и файлом config.tar.gz
10. Добавить сообщение об ошибке

Если невозможно выполнить 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. Опиши проблему чётко и конкретно

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

✅ Хорошо:

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

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

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

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

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

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

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

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

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

Выполни строго по порядку:

1. CLEAR_EMMC — очистить старые логи

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

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

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

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

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

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

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

• В него:

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

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

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

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

---

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

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

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

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

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

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

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

---

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

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