System_en - ghzserg/zmod GitHub Wiki
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 |
Enable the standard screen and reboot the printer.
-
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.
View memory usage.
Test EMMC performance and wear level. Parameters:
-
SIZE
— data size to write in MB (default:100
). -
SYNC
—1
= 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
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
).
Display current system time.
Set system date and time.
-
DT
— date/time inYYYY.MM.DD-HH:MM:SS
format.
Switch between Fluidd and Mainsail web interfaces.
Set timezone.
-
ZONE
— timezone identifier (default:Asia/Yekaterinburg
).
Verify file integrity via MD5 checksum.
-
DELETE
— delete corrupted files:yes
/no
.
Usage:
- Copy
addMD5.bat
(Windows) oraddMD5.sh
(macOS/Linux) from the printer'smod
folder. - 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
- Add
CHECK_MD5
orCHECK_MD5 DELETE=true
to your start G-code.
Note: Enabled by default via FORCE_MD5
.
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.
Diagnose OS file integrity.
-
RESTORE
—0
= no repair,1
= repair damaged files (default:0
).
Checks:
- File permissions/MD5 hashes.
- Directory permissions.
- Symbolic links.
Recovery: Download intact files from here.