Help - ghzserg/zmod GitHub Wiki

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

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

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

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

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

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

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

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

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

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

Наш «автопарк» насчитывает более 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 — очистить старые логи
  1. Выключи принтер полностью из розетки → Подожди 10 сек
  1. Включи принтер
  1. Воспроизведи проблему (запусти печать, нажми кнопку — вызови ошибку)
  1. Выполни TAR_CONFIG — это создаст архив config.tar.gz со всеми логами

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

  • Создай одно сообщение
  • В него:
  • понятное описание (п. 3),
  • обязательно прикрепи config.tar.gz,
  • приложи G-код, если проблема возникает при печати конкретного файла.

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

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

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

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

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

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

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

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

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

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