Setup - ghzserg/zmod GitHub Wiki

Setup

Возврат принтера к заводским установкам (необходимо для установки мода)

  1. Удалить KlipperMod, если он был установлен
  2. Сбросить принтер до настроек по умолчанию
  3. Отформатировать USB Flash в FAT/FAT16/FAT32
  4. Поместить файл из Native firmware в корневую папку USB Flash
    • Adventurer5M-3.1.3-2.2.3-20250107-Factory.tgz для FF5m
    • Adventurer5MPro-3.1.3-2.2.3-20250107-Factory.tgz для FF5mPro версии
    • AD5X-1.0.2-1.0.2-20250120-Factory.tgz для AD5X
  5. Выключить принтер
  6. Вставить флешку в принтер
  7. Включить принтер
  8. Дождаться установки родной прошивки
  9. Настроить WiFi или Lan новый бобер
  10. Получить последние обновления для принтера

Установка мода

  1. Вернуть принтер к заводским настройкам
  2. Отформатировать USB Flash в FAT/FAT16/FAT32
  3. Поместить файл в корневую папку USB Flash.
    • для FF5M: Adventurer5M-zmod-*.tgz
    • для FF5MPro: Adventurer5MPro-zmod-*.tgz
    • для AD5X: AD5X-zmod-*.tgz
  4. Выключить принтер
  5. Вставить флешку в принтер
  6. Включить принтер
  7. Дождаться установки мода
  8. Вытащить флешку
  9. Выключить принтер
  10. Включить принтер

Обновление мода

Если мод пишет Обновите ZMOD с флешки, то нужно обновить zmod с флешки, даже если вы его недавно обновляли.

При обновлении с флешки все данные сохраняются.

Проще всего обновить мод через флешку макросом ZFLASH

В этом случае, вам нужно вставить флешку в принтер, перезагрузить принтер и вызвать макрос ZFLASH.

  • Макрос посмотрит последнюю актуальную версию
  • Скачает последний релиз для вашей модели принтера
  • Проверит контрольные суммы
  • Перезагрузит принтер
  • Новая версия установится автоматически после перезагрузки (флешку вытаскивать нет необходимости, ее можно оставить в принтере для следующих обновлений)
  • Далее переходите во Fluidd/Mainsail на вкладку Настройки -> Обновление ПО. Нажмите Проверить обновления и установите последние обновления ZMOD

Посмотреть текущую версию операционной системы мода можно на вкладке "Система" -> "Дистрибутив"

Текущая версия zmod (вкладка "Настройки" -> "Обновление" -> "ffm5/zmod"), должна совпадать первыми двумя цифрами с версией со вкладки система.

Если не совпадает, то мод будет работать некорректно, в этом случае не надо жаловаться на ZMOD

Требование обновления с флешки связано с тем, что в работе мода были изменения, которые не передаются при обновлении по сети, а значит макросы могут обращаться к несуществующим в старых версиях функциям. Или функционал/бинарные файлы/конфиги/скрипты были изменены и их нужно установить с флешки.

Если меняется первая или вторая цифра версии, то необходимо обновляться через флешку.

Если меняется третья, четвертая или пятая, то достаточно обновиться через Fluidd/Mainsail и перезагрузить принтер.

Пример, если текущая версия на вкладке "Система" 1.2.6:

  • через Fluidd показывает новую версию 1.2.6-19 - то обновляться через флешку не надо
  • через Fluidd показывает новую версию 1.2.7-12 - то обновляться через флешку не надо пикачу
  • через Fluidd показывает новую версию 1.3.4 (изменилась 2-я цифра) или 2.0.0 (изменилась 1-я цифра), то надо обновляться через флешку.

Обновление через флешку:

  1. Отформатировать USB Flash в FAT/FAT16/FAT32
  2. Поместить файл в корневую папку USB Flash.
    • для FF5M: Adventurer5M-zmod-*.tgz
    • для FF5MPro: Adventurer5MPro-zmod-*.tgz
    • для AD5X: AD5X-zmod-*.tgz
  3. Выключить принтер
  4. Вставить флешку в принтер
  5. Включить принтер
  6. Дождаться перезагрузки принтера (вытаскивать флешку не надо)
  7. Дождаться установки мода
  8. Когда принтер напишет что установка прошла
  9. Вытащить флешку
  10. Выключить принтер
  11. Включить принтер
  12. Переходите во Fluidd/Mainsail на вкладку Настройки -> Обновление ПО. Нажмите Проверить обновления и установите последние обновления ZMOD

Помочь разработке

На развитие мода

Удаление - временное отключение мода

  • SKIP_ZMOD - макрос перезагрузки без запуска moonraker и fluidd
  • REMOVE_ZMOD - макрос удаления мода

Рекомендуется удалять мод через макрос REMOVE_ZMOD, удаление через флешку использовать, только если нет возможности запустить макрос.

Удаление мода через флешку:

  • Отформатируйте флешку в FAT/FAT16/FAT32
  • Поместите файл flashforge_init.sh на эту флешку
  • Выключите принтер
  • Вставьте флешку в принтер
  • Включите принтер
  • Принтер 3 раза перезагрузится
  • Извлеките флешку и пользуйтесь стоковой прошивкой

Как обновлять сток?

Если пришло обновление стока и у вас последняя версия zmod, то после обновления стока и перезагрузки все будет в порядке.

Если у вас не последняя версия zmod, то лучше с флешки обновить до последней версии zmod, скачать последние обновления через fluidd и потом уже обновить сток.

Если вы сначала обновили сток, и что то пошло не так, то установите zmod с флешки и обновите его через fluidd.

Работа на относительно стабильном релизе

У вас есть возможность переключится на относительно стабильную ветку разработки (по тегам).

В mod_data/user.moonraker.conf нужно добавить

[update_manager zmod]
channel: stable

Обновления в этой ветке выходят не раньше раза в неделю.

Если у вас в этой ветке возникла проблема или вы хотите новый функционал, то вам нужно будет обновиться на последнюю версию текущего релиза (удалив выше добавленные строки) и только после этого обращаться в поддержку, т.к. ваша проблема уже могла быть решена.

Восстановление загрузки

Авторы инструкции: @darksimpson, Александр, @Ikaros413, @SoloMen88

Для тех у кого принтер при включении повисает на заставке и не доступен по ЛАН кабелю.

/images/ff.jpg

Алгоритм восстановления:

  1. Обесточить принтер
  2. Подготовить преобразователь UART/USB (Нужен на 3.3V, или с джампером 5V/3.3V)

/images/ch340.jpg

ВНИМАНИЕ! конвертор должен быть на 3.3 ВОЛЬТА, подадите 5 вольт и процессор сгорит!

  1. Открыть заднюю стенку FlashForge
  2. Подключиться к выводу UART на плате (подключаем RX, TX, GND, 3.3V не подключать)

/images/connect.jpg

ОБЯЗАТЕЛЬНО, ПЕРЕКИДЫВАЕМ ДЖАМПЕР (если у вас есть) С 5V на 3.3V Если подадите на 5V, то попадете на замену материнской платы. Как должно выглядеть подключение в конечном итоге:

  • RX/TX подключаются крест накрест RX-TX TX-RX
  • GND преобразователя к GND на плате
  • 3.3V никуда не подключается

/images/connect_photo.jpg

  1. В системе должен появиться новый СОМ-порт.

/images/port.jpg

  1. Запускаем программу PuTTY, там вписываем ваш СОМ-порт(в примере выше COM6), скорость 115200, тип подключения - Serial.

  2. Подаем штатное питание на принтер.

  3. В терминале нужно дождаться строки:

Hit any key to stop autoboot

затем быстро нажать Enter.

  1. После этого вы окажетесь в U-Boot. Из него самого можно многое сделать (пишите help)

Но нам достаточно переопределить стартовую команду для ядра линукса, чтобы получить шелл.

Пишем в U-boot через терминал:

setenv init /bin/sh
boot

  1. Если все сделали правильно, то получите sh после загрузки ядра Linux.

  2. Файловая система смонтирована в режиме только для чтения, так что нужно будет её перемонтировать:

mount -t proc proc /proc
mount -o remount,rw /

  1. Исправляем то что сломалось, например rm -f /etc/init.d/S01bad_script, или rm -f /opt/config/mod/.shell/S98camera, если у вас не проходит запуск из-за камеры.

  2. Нужно сохранить изменения: sync

  3. И перезагрузиться: reboot