System_en - ghzserg/zmod GitHub Wiki

System

Прочитать на русском языке

A macro is a small program written in Klipper/Gcode language.

It can be called from:

  • A GCODE file
  • The Fluidd/Mainsail console (press the English letter C in Fluidd)

Note

The value in parentheses is the default value


🔷 System Macros 🔷

CHECK_SYSTEM MEM CHECK_MD5 WEB
CLEAR_EMMC TEST_EMMC DISPLAY_OFF DISPLAY_ON
DATE_GET DATE_SET UPDATE_MCU

DISPLAY_ON

Enable the standard screen and reboot the printer.

Top


DISPLAY_OFF

  • GUPPY: 0 = disable GuppyScreen, 1 = enable GuppyScreen (default: 1)

Disable the standard screen. Saves 13 MB of RAM (20 MB on older firmware versions).

GuppyScreen (alternative screen implementation):

  • Supports all native screen features except WiFi configuration.
  • Uses 9 MB RAM (vs. 23 MB for the native screen).
  • Prevents Klipper freezes during reboots.
  • Recommended for non-native screen workflows.
  • Better print recovery after interruptions.
  • Based on this fork.

Warning:

  • Do not disable the screen unless you fully understand bed leveling, Z-offset, and the START_PRINT/END_PRINT macros.
  • The screen remains active for 3 minutes after reboot but does not affect Z-offset or printing.

Adjust activation timing via the DISPLAY_OFF_TIMEOUT global parameter.

Learn more about screen modes.

Top


MEM

View memory usage.

Top


TEST_EMMC

Test EMMC performance and wear level. Parameters:

  • SIZE — data size to write in MB (default: 100).
  • SYNC1 = synchronous mode (measure speed), 0 = asynchronous background write (default: 1).
  • FLASH — target storage: 0 = EMMC, 1 = USB flash, 2 = RAM (default: 0).
  • RANDOM — use random data: 1 = yes, 0 = no (default: 0).

Stock firmware command:

./zfs.sh 400 1

Top


CLEAR_EMMC

Clear EMMC storage. Parameters:

  • LOG — clear log files: 1 = yes, 0 = no (default: 1).
  • ANY — clear all files (G-code, images, videos): 1 = yes, 0 = no (default: 0).

Top


DATE_GET

Display current system time.

Top


DATE_SET

Set system date and time.

  • DT — date/time in YYYY.MM.DD-HH:MM:SS format.

Top


WEB

Switch between Fluidd and Mainsail web interfaces.

Top


SET_TIMEZONE

Set timezone.

  • ZONE — timezone identifier (default: Asia/Yekaterinburg).

Top


CHECK_MD5

Verify file integrity via MD5 checksum.

  • DELETE — delete corrupted files: yes/no.

Usage:

  1. Copy addMD5.bat (Windows) or addMD5.sh (macOS/Linux) from the printer's mod folder.
  2. Add the script to your slicer's post-processing settings:
    • OrcaSlicer: Process → Other → Post-processing Scripts
    • PrusaSlicer/SuperSlicer: Print Settings → Output Options → Post-processing Scripts
  3. Add CHECK_MD5 or CHECK_MD5 DELETE=true to your start G-code.

Note: Enabled by default via FORCE_MD5.

Top


UPDATE_MCU

Update MCU firmware (experimental).

  • Switches between Klipper v11 and v12.

Warnings:

  • Klipper v12 disables extruder heating, temperature monitoring, and load cell functionality.
  • Recovery requires factory reset.

Top


CHECK_SYSTEM

Diagnose OS file integrity.

  • RESTORE0 = no repair, 1 = repair damaged files (default: 0).

Checks:

  • File permissions/MD5 hashes.
  • Directory permissions.
  • Symbolic links.

Recovery: Download intact files from here.

Top


Back Top Forward

⚠️ **GitHub.com Fallback** ⚠️