Zmod

Makro je malý program napsaný v jazyce Klipper/Gcode.

Lze jej spustit z:

GCODE souboru
Konzole Fluidd/Mainsail (stiskněte anglické písmeno C ve Fluidd)

Poznámka

Hodnota v závorkách je výchozí hodnota

CAMERA_ON¶

Zapne alternativní implementaci kamery. Parametry:

WIDTH — šířka obrázku (výchozí: 640)
HEIGHT — výška obrázku (výchozí: 480)
FPS — snímky za sekundu (výchozí: 20)
VIDEO — video zařízení (výchozí: video0)
FS — 1 = zapnout omezení velikosti snímku pro problematické kamery, 0 = vypnout (výchozí: 0)
STREAMER — jaký streamer použít (auto, mjpg_streamer, ustreamer)
FORMAT — formát obrazu pro ustreamer: YUYV, YVYU, UYVY, RGB565, RGB24, BGR24, MJPEG, JPEG; výchozí: MJPEG

Před zavoláním tohoto makra vypněte kameru na obrazovce tiskárny.

Chcete-li kameru zapnout, použijte CAMERA_ON VIDEO=video0 nebo CAMERA_ON VIDEO=video3 nebo CAMERA_ON VIDEO=video99.

{D2A001DD-7C89-4AB9-9CB9-741B7007B0B4}

Pokud kamera nefunguje, podívejte se na logy v mod_data/log/cam/.

Spotřeba RAM u standardní kamery:

640x480: 2,9 MiB
1280x720: 7,8 MiB
1920x1080: 18,1 MiB

Mnoho kamer z AliExpressu/Ozonu/Wildberries vždy spotřebuje 18 MiB.

Poznámka

Camera Off Waiting... - tato zpráva se zobrazí, pokud stream kamery ještě není k dispozici. Kamera se spouští až po Klipperu, během zobrazení informací o globálních parametrech. To je normální.

Nastavení kamery¶

Základní parametry

Parametr	Popis	Výchozí hodnota
`WIDTH`	Šířka obrázku	640
`HEIGHT`	Výška obrázku	480
`FPS`	Snímky za sekundu	20
`VIDEO`	Zařízení kamery	video0
`FS`	Oprava problematických kamer (1 – ano, 0 – ne)	0
`STREAMER`	Program pro zpracování streamu kamery	auto
`FORMAT`	Formát obrázku (pouze pro ustreamer)	MJPEG

Co je to streamer?

Streamer je program, který snímá obraz z kamery a zpřístupní ho v prohlížeči.

Jsou k dispozici dvě možnosti:

mjpg_streamer – jednoduchý program, funguje pouze s MJPG kamerami
ustreamer – výkonnější, ale spotřebuje více paměti; podporuje různé kamery

Parametr STREAMER=auto automaticky zvolí vhodný streamer.

Formáty obrázků (pouze pro ustreamer)

Můžete si vybrat: YUYV, YVYU, UYVY, RGB565, RGB24, BGR24, MJPEG, JPEG.

Výchozí je MJPEG.

Příklady příkazů

Jednoduchý start kamery video0 přes mjpg_streamer:

CAMERA_ON VIDEO=video0

Start kamery video0 přes ustreamer s vlastním nastavením:

CAMERA_ON VIDEO=video0 STREAMER=ustreamer FORMAT=YUYV WIDTH=640 HEIGHT=480

Kde zobrazit obraz?

Otevřete v prohlížeči: http://IP_tiskárny:8080

Tam můžete upravit jas, kontrast a další nastavení.

Řešení problémů

Kamera není detekována? Spusťte:

CAMERA_ON VIDEO=video99

Program zobrazí seznam dostupných kamer.

Logy (záznamy chyb) se nacházejí v adresáři: log/cam/

CAMERA_OFF¶

Vypne alternativní implementaci kamery.

CAMERA_RESTART¶

Restartuje alternativní implementaci kamery.

REMOVE_ZMOD¶

Odinstaluje Z-Mod.

FULL: 0 = zachovat /opt/config/mod_data, 1 = smazat /opt/config/mod_data (výchozí: 0)

Adresář /opt/config/mod_data ukládá konfigurace pro zmod, fluidd, moonraker a mainsail. Ve výchozím nastavení se nemaže, protože se makro REMOVE_ZMOD často volá omylem.

Varování! Sami deaktivujte všechny pluginy a přejděte na nativní Klipper.

SKIP_ZMOD¶

Restartuje do původního systému bez spuštění Z-Mod. Deaktivuje konfigurace Z-Mod, Moonraker a Fluidd.

Varování! Sami deaktivujte všechny pluginy a přejděte na nativní Klipper.

Zůstane aktivní:

Alternativní kamera
SSH

TAR_CONFIG¶

Zálohuje konfigurační soubory do archivu. Archiv stáhnete přes: Konfigurace → mod_data → config.tar.gz

RESTORE_TAR_CONFIG¶

Obnoví konfigurace z archivu config.tar.gz. Archiv nahrajte do: Konfigurace → mod_data → config.tar.gz

ZFLASH¶

Aktualizuje firmware přes síť pomocí USB disku.

Vložte USB disk do tiskárny a zapněte ji.
Pokud pracujete bez nativní obrazovky, ujistěte se, že je USB disk vložen před zapnutím.
Makro vyhledá nejnovější verzi, stáhne ji na USB disk, ověří MD5 součet a po restartu ji nainstaluje.

STOP_ZMOD¶

Uvolní z paměti Guppy, Helix, Moonraker a Fluidd/Mainsail. Telegram bot také přestane fungovat.

Parametry:

SCREEN (0 - neuvolňovat, 1 - uvolnit)
MOONRAKER (0 - neuvolňovat, 1 - uvolnit)
HTTP (0 - neuvolňovat, 1 - uvolnit)

Příklad:

STOP_ZMOD SCREEN=1 MOONRAKER=0 HTTP=0

Pokud je tento řádek přidán do startovacího kódu, bude GUPPY/HELIX po zahájení tisku uvolněn z paměti.

START_ZMOD¶

Po STOP_ZMOD znovu spustí Guppy, Helix, Moonraker a Fluidd/Mainsail.

Parametry:

SCREEN (0 - nenačíst, 1 - načíst)
MOONRAKER (0 - nenačíst, 1 - načíst)
HTTP (0 - nenačíst, 1 - načíst)

Příklad:

START_ZMOD SCREEN=1 MOONRAKER=0 HTTP=0

Pokud je tento řádek přidán do koncového kódu, bude GUPPY/HELIX spuštěn po dokončení tisku.

ZSSH_ON¶

Zapne SSH tunelování. Parametry:

SSH_SERVER — IP/hostname vzdáleného SSH serveru
SSH_PORT — SSH port (výchozí: 22)
SSH_USER — uživatelské jméno vzdáleného serveru
VIDEO_PORT — port vzdáleného serveru pro video streaming (výchozí: 8080)
MOON_PORT — port vzdáleného serveru pro Moonraker (výchozí: 7125)
REMOTE_RUN — příkaz k provedení na vzdáleném serveru (výchozí: "NONE"). Příklad: Použijte skript ff5m.sh: ./ff5m.sh bot1 (umístěno v mod/telegram/) pro restart Telegram bota.

Skript nastavení (pokud není nainstalován jedním příkazem):

su - tbot  # Přepněte na uživatele bot service
wget --cache=off -q -O ff5m.sh https://raw.githubusercontent.com/ghzserg/zmod_ff5m/refs/heads/main/telegram/ff5m.sh
chmod +x ff5m.sh

Příklad použití v konzoli Fluidd/Mainsail:

ZSSH_ON SSH_SERVER=remote.server.ru SSH_PORT=22 SSH_USER=tbot VIDEO_PORT=8080 MOON_PORT=7125 REMOTE_RUN="./ff5m.sh bot1"

SSH se spustí 3 minuty po startu Klipperu a automaticky se restartuje na začátku tisku (přes makro START_PRINT).

Více o Telegram botovi

ZSSH_OFF¶

Vypne SSH klienta.

ZSSH_RESTART¶

Restartuje SSH klienta.

ZSSH_RELOAD¶

Znovu spustí SSH klienta, pokud neběží. Toto makro se spouští na začátku tisku (přes START_PRINT).

ZRESTORE¶

Obnoví tisk po výpadku napájení nebo chybách tiskárny.

Požadavky:

Nativní obrazovka musí být vypnutá (má vlastní obnovu, která není kompatibilní se ZRESTORE).
Název tisknutého souboru nesmí začínat číslem.

ZLINK¶

Připojí se ke cloudu zmod.link

Cloud vám umožní spravovat tiskárnu přes Fluidd nebo Mainsail odkudkoliv.
Spotřeba paměti na tiskárně se zvýší o 1 MB.
Data se odesílají z tiskárny do cloudu pomocí šifrování.
Přístup do cloudu odkudkoliv také používá šifrování.
Uživatel vidí pouze své vlastní tiskárny a nemůže se připojit k ostatním.
Přístup k tiskárnám uživatele je chráněn přihlašovacím jménem a heslem.

Jak získat přihlašovací jméno a heslo:

Napište botovi @zmod_help_bot
Zadejte příkaz cloud - pokud jste se již registrovali, sdělí vám vaše přihlašovací jméno
Chcete-li zaregistrovat uživatele se jménem test, zadejte: cloud register test
Chcete-li obnovit heslo, zadejte: cloud reset_password
Chcete-li odebrat aktuálního uživatele, zadejte: cloud remove

Pokud Telegram není dostupný:

Otevřete vk.com/zmod_official
Napište zprávu do skupiny
Zadejte příkaz cloud – pokud jste se již registrovali, sdělí vám vaše přihlašovací jméno
Chcete-li zaregistrovat uživatele se jménem test, zadejte: cloud register test
Chcete-li obnovit heslo, zadejte: cloud reset_password
Chcete-li odebrat aktuálního uživatele, zadejte: cloud remove

Jak se připojit ke cloudu zmod.link:

Navštivte web zmod.link a zadejte své přihlašovací jméno a heslo

{264D6782-600F-4700-B9D2-0582F7427FD2}

Klikněte na tlačítko "Add Printer"

Otevřete tiskárnu v samostatné kartě a v konzoli tiskárny zadejte příkaz ZLINK

{90DC4366-D258-4912-8028-22C589DF4E91}

Zkopírujte klíč do schránky – na snímku je zvýrazněn
Zadejte jméno tiskárny a klíč, který jste zkopírovali v předchozím kroku

Příklad:

testprinter
ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBDxX5XzNDXg+sbTArdiOzFpMtHXzgAhfC2N2ogS4TUsQYV4AD6HfSFL3J4ISNZ2DgesZf35rfH1I/qI2ckQVGlE=

{E4FC2206-84BC-4134-92C2-B4253D8F23E5}