Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

ghzserg/zmod

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FF5M / FF5M Pro / AD5X ZMOD

Caution

If you want to install this mod on your AD5M (Pro) / AD5X, be aware that you risk voiding the warranty or damaging the printer. Proceed at your own risk if you wish to try this mod!

If you don’t know what this is, don’t understand why a Klipper web interface is needed, or are simply satisfied with the stock firmware, do NOT install this modification. For everyone else – please read the entire instructions carefully!

After installing the mod, if you don’t want to delve into details – just print as usual. No additional configuration or changes are required. If you decide to explore further – proceed by reading the documentation.

На русском

Latest version: 1.4.3 can only be installed via USB flash drive or the ZFLASH macro.

Macro LANG - change language (RU<->EN)

Download.

MD5 checksums:

  • Adventurer5M-zmod-1.4.3.tgz 1ef1da80e02794696e2a32a4d465ddfb
  • Adventurer5MPro-zmod-1.4.3.tgz 1ef1da80e02794696e2a32a4d465ddfb
  • AD5X-zmod-1.4.3.tgz 147dbe90aa51dc543741df6ccfd842e1

How to verify:

  • Navigate to the folder containing Adventurer5M-zmod-1.4.3.tgz
  • Right-click on an empty space -> Open in Terminal
  • Run:
    certutil -hashfile Adventurer5M-zmod-1.4.3.tgz md5
    certutil -hashfile Adventurer5MPro-zmod-1.4.3.tgz md5
    certutil -hashfile AD5X-zmod-1.4.3.tgz md5
  • Ensure the checksums match.

Compatible with clean firmware versions:

  • FF5M/FF5MPro: v2.7.5 or higher (2.7.5, 2.7.6, 2.7.7, 2.7.8, 2.7.9, 3.1.3, 3.1.4, 3.1.5)
  • AD5X: v1.0.2 or higher

Clean firmware files are located in the Stock_Firmware folder.

Do NOT install this mod if the following stock firmware fixes suffice

These features are ported to the stock firmware:

  1. E0011 error fix
  2. E0017 error fix
  3. Disable printer updates/telemetry/Chinese clouds
  4. Factory reset
  5. Convert FF5M to FF5MPro
  6. Convert FF5MPro to FF5M

Moonraker and Fluidd/Mainsail/GuppyScreen Support on Stock Klipper

Supported features:

  1. Web interface based on Fluidd or Mainsail (port 80)
  2. File upload and printing via Octoprint/Fluidd/FlashForge/Mainsail/GuppyScreen/Telegram Bot
  3. Print recovery after power loss
  4. Adaptive bed mesh with KAMP
  5. Bed leveling at any temperature, optionally triggered at print start
  6. Input Shaper calibration with graphs, accounting for SCV (square_corner_velocity).
  7. Bed screw adjustment
  8. PID calibration for extruder and bed.
  9. Nozzle cleaning (stock-like)
  10. Support for both stock and alternative camera implementation (saves memory and allows resolution changes).
  11. Moonraker-telegram-bot support on external hosts
  12. MIDI file playback
  13. MD5 verification for network transfers
  14. Automatic updates for Fluidd/Mainsail/Moonraker and ZMOD via network
  15. Headless mode (no stock screen). Saves 20MB RAM.
  16. GuppyScreen – lightweight screen replacement
  17. ROOT access and mc support
  18. COLDPULL (nozzle cleaning) without force. Based on this method.
  19. Entware
  20. Fixed E0011 error
  21. Fixed E0017 error
  22. Rollback from firmware
  23. Automatic print stop on part detachment or nozzle collision.
  24. File/permissions/symlink verification and repair
  25. Stock screen menu functionality remains unchanged

Version History

Changelog

FAQ

Must-read

Printer Stability Recommendations

Read if encountering issues

Macro List

All features are accessed via macros.

Macro List

Configuration Storage

Access the mod_data folder via Fluidd web interface:
ConfigurationConfiguration Filesmod_data

  • Custom Klipper settings go into mod_data/user.cfg, which can override/supplement printer_base.cfg.
  • Custom Moonraker settings go into mod_data/user.moonraker.cfg.
  • Custom MIDI files are stored in mod_data/midi/.
  • Global mod settings are saved via the SAVE_ZMOD_DATA macro.
  • Shutdown scripts are stored in mod_data/power_off.sh.
  • Power on scripts are stored in mod_data/power_on.sh.

Known Peculiarities:

  • During actions like M109 (extruder heating), M190 (bed heating), PID calibration, or any gcode-pausing task, the stock screen freezes.
  • Restarting Klipper freezes the stock screen (use NEW_SAVE_CONFIG for restarts).
  • After canceling a print, press "OK" on the stock screen (use CLOSE_DIALOGS or FAST_CLOSE_DIALOGS).
  • The stock screen always loads the DEFAULT_MESH profile when starting a print and deletes the Default profile post-print.

Screenless Version Notes:

  • Remove all start gcode and use START_PRINT and END_PRINT macros.
  • Stock camera disabled; use the alternative via CAMERA_ON.
  • Manually set Z_OFFSET in START_PRINT or use LOAD_ZOFFSET to load saved offsets.
  • Bed mesh auto loads automatically on startup.
  • FlashForge protocol is unsupported (handled by the screen). Use "Octo/Klipper":
    • Protocol: Octo/Klipper
    • Hostname: printer_IP:7125
    • URL: printer_IP

Credits

This mod builds upon KlipperMod but is not a direct continuation and is incompatible with it.

Installation/Update/Removal

Installation/Update/Removal Guide

Support Development

Donate to support development