Uživatelská příručka pro firmware MeshOS Meshcore na zařízeních T-Deck a T-Display P4.

Poslední aktualizace: 2026-03-12

Všechny příkazy se zadávají v terminálu s prefixem / . Terminál otevřete z menu MeshOS.

Základní první kroky:

1. Zapněte GPS (pokud je k dispozici): /gps on a počkejte na sync času. Případně se vám čas sesynchronizuje s úspěšně přijatým advertem.
2. Nastavte časovou zónu: /gps tz +1 (váš UTC offset)
3. Ověřte nastavení rádia: /get radio
4. Vyhledejte repeatery: /repeaters

• Zařízení ukládá až 150 záznamů celkem (kontakty + repeatery + místnosti).
• Po úvodním nastavení vypněte /autorep, abyste nezaplnili seznam vzdálenými repeatery.
• Pro přidání kontaktu: nechte je odeslat Zero Hop advert (/advert) s povoleným automatickým přidáváním kontaktů, nebo použijte /import s jejich klíčem vizitky.
• Dlouhým stiskem na kontakty v UI je můžete spravovat (smazat, zobrazit detaily).
• Použijte /clearcontacts repeaters pro hromadné odebrání pouze repeaterů bez ztráty chatových kontaktů.

• Čas je uložen jako UTC. Časová zóna displeje se nastavuje přes /gps tz <offset>.
• GPS automaticky synchronizuje hodiny. Bez GPS poskytuje synchronizaci času mesh síť.
• T-Deck Plus používá 38400 baud pro GPS. Standardní T-Deck s externím GPS modulem může vyžadovat /gps baud 9600.
• Pokud GPS nezíská fix: přepněte off/on, zajistěte výhled na oblohu a počkejte několik minut.
• Zařízení nemá RTC — čas musí být znovu získán při každém zapnutí (přes GPS nebo mesh).

• Kanál 1 (Public): Otevřené vysílání, vidí všechny uzly.
• Kanál 2 (Local): Vysílání na krátký dosah.
• Kanály 3-4: Vlastní hashtag kanály, pojmenované přes /setchannel.
• Kanál 5: Soukromý kanál s PSK šifrováním, konfigurovaný přes /setchannel 5.
• Kanály nevyžadují adverty pro výměnu zpráv.
• Room servery nejsou v MeshOS aktuálně podporovány.

• Použijte /repeaters pro vyhledání okolních repeaterů.
• Seznam Heard (volatilní paměť) ukládá všechny slyšené uzly pro mapu — maže se při restartu.
• Uložené repeatery přetrvají restart.
• Pokrytí zkontrolujte na: meshcore.co.uk/map.html nebo analyzer.letsmesh.net/map.
• Pokud slyšíte vzdálené uzly, ale nemůžete odesílat: váš signál pravděpodobně nedosáhne na repeater. Zkuste vyšší pozici nebo lepší anténu.

• Používá se pro: mapové dlaždice, .wav audio soubory, zachycené obrázky (P4), logy, úložiště souborů.
• Vlastní poskytovatelé mapových dlaždic mohou být konfigurováni z SD karty.
• Přehrávač hudby podporuje přehrávání .wav souborů na pozadí.

Soubor musí být pojmenován přesně wallpaper.png a umístěn v kořenovém adresáři SD karty. Možnost tapety se v nastavení nezobrazí, dokud soubor není přítomen.

Pouze .png

Maximálně 200 KB.

320 × 240 pixelů

Andykirby doporučuje tento příkaz pro konverzi v ImageMagick:

magick input.png -resize 320x240! -ordered-dither o8x8,32,64,32 output.png

Vykřičník ! za rozměry vynutí přesné rozměry bez zachování poměru stran. Přepínač dithering optimalizuje obrázek pro displej.

Konfiguruje se přes Settings > Wallpaper — lze přepínat, na kterých obrazovkách se tapeta zobrazí.

1. Zkopírujte wallpaper.png do kořenového adresáře SD karty
2. Restartujte zařízení
3. Přejděte do Nastavení > Wallpaper a zvolte, kde se má tapeta zobrazovat

• Na šedých nebo barevně pestrých tapetách mohou být ikony špatně viditelné (známý problém UI).
• Přizpůsobení bootovací obrazovky zatím není podporováno.

• T-Deck Plus: GPS na 38400 baud, vestavěná klávesnice se správným on/off ovládáním.
• Standardní T-Deck: Může vyžadovat externí GPS, konfiguraci baud rate, klávesnice má omezené ovládání.
• T-Display P4: Dotykový displej, kamera, experimentální GFSK režim pro vysokou přenosovou rychlost (hlas, soubory).
• Aktualizace firmwaru lze provést přes USB web flasher na flasher.meshcore.co.uk nebo přes SD kartu.
• Aktualizace přes SD kartu zachovává nastavení; USB flash je může resetovat — nejdříve zálohujte.

Obecné

• /set — Nastavení zařízení včetně jména, pozice, parametrů rádia a audio frekvence
• /get radio — Zobrazení aktuální konfigurace rádia
• /card — Zobrazení vizitky zařízení (veřejný klíč a identifikační údaje)
• /import — Import vizitky kontaktu pro přidání do kontaktů
• /clock — Zobrazení aktuálního času zařízení
• /time — Ruční nastavení hodin zařízení na konkrétní čas
• /memory — Zobrazení statistik využití heap a RAM
• /battery — Zobrazení napětí baterie a stavu nabíjení
• /sd — Zobrazení stavu SD karty
• /sd ls — Výpis souborů a adresářů na SD kartě
• /sd format — Smazání všech souborů z SD karty
• /list — Zobrazení všech kontaktů, repeaterů a místností
• /messages — Zobrazení posledních přijatých zpráv
• /messages all — Zobrazení všech zpráv včetně odeslaných
• /clearmessages — Smazání všech zpráv z úložiště
• /clearcontacts — Smazání všech kontaktů ze zařízení
• /contacts delete — Smazání konkrétního kontaktu podle hex ID prefixu
• /find — Vyhledání kontaktu podle hex ID prefixu
• /to — Nastavení aktuálního příjemce přímých zpráv
• /send — Odeslání přímé zprávy aktuálnímu příjemci
• /advert — Vysílání identity přes zero-hop advert
• /advert flood — Vysílání identity do celé mesh sítě
• /trace — Odeslání trace paketu pro testování routování
• /getpath — Zobrazení aktuální cesty routování ke kontaktu
• /setpath — Ruční nastavení cesty routování ke kontaktu
• /reset path — Reset cesty routování na automatickou
• /resetpath — Reset cesty ke konkrétnímu kontaktu na automatickou
• /public — Odeslání zprávy do veřejného kanálu (kanál 1)
• /local — Odeslání zprávy do lokálního kanálu (kanál 2)
• /ch3 — Odeslání zprávy do kanálu 3
• /ch4 — Odeslání zprávy do kanálu 4
• /ch5 — Odeslání zprávy do kanálu 5 (soukromý/šifrovaný)
• /setchannel — Nastavení názvu hashtag kanálu (kanály 1-4)
• /setchannel 5 — Konfigurace kanálu 5 s PSK
• /channel — Zobrazení informací o konkrétním kanálu
• /channels — Výpis všech kanálů
• /adverts — Přepínání zobrazení advert notifikací
• /quiet — Přepínání tichého režimu
• /mobrep — Přepínání režimu mobilního repeateru
• /autorep — Přepínání automatického přidávání repeaterů
• /replist — Zobrazení whitelistu povolených repeaterů
• /clearrep — Vymazání whitelistu repeaterů
• /scope — Nastavení regionálního filtru pro routování zpráv
• /scope clear — Odstranění aktuálního filtru scope
• /pathsize — Nastavení velikosti path hash (1-3 byty)
• /uizoom — Nastavení úrovně přiblížení UI
• /uifont — Nastavení fontu displeje
• /control — Odeslání surového řídicího příkazu
• /repeaters — Vyhledávání okolních repeaterů
• /repeateradmin — Přihlášení do administrace repeateru

Administrace repeateru

• stats — Statistiky repeateru
• help — Zobrazení CLI příkazů repeateru

GPS

• /gps on — Zapnutí GPS přijímače
• /gps off — Vypnutí GPS přijímače
• /gps get — Zobrazení stavu GPS

Nastavení zařízení včetně jména, pozice, parametrů rádia a audio frekvence.

/set {name|lat|lon|freq|sf|bw|tx|cr|af} {value}

Příklady:

• /set name MujNode
• /set lat 50.0755
• /set lon 14.4378
• /set freq 906.875

• Pozici lze nastavit automaticky přes GPS.
• Při připojení k companion aplikaci se nastavení synchronizují automaticky.
• Nastavení rádia musí odpovídat vašemu regionálnímu frekvenčnímu plánu.
• Použijte /get radio pro ověření aktuálního nastavení rádia po změnách.

Zobrazení aktuální konfigurace rádia včetně frekvence, spreading factoru, šířky pásma, TX výkonu a coding rate.

/get radio  (show current radio settings)

• Užitečné pro ověření nastavení po změnách nebo při řešení problémů s konektivitou.

Zobrazení vizitky zařízení (veřejný klíč a identifikační údaje). Jedná se o sdílitelné kontaktní informace, které potřebují ostatní uzly pro komunikaci s vámi.

/card

• Na jiném zařízení použijte /import pro přidání tohoto kontaktu.

Import vizitky kontaktu (veřejného klíče) pro přidání do vašich kontaktů.

/import {biz card}

Příklady:

• /import <řetězec vizitky>

• Pro získání vizitky kontaktu: otevřete MeshCore aplikaci > Kontakty > klepněte na kontakt > menu se 3 tečkami > Sdílet > Kopírovat odkaz do schránky.
• Zkopírovaný klíč vložte za /import v terminálu.
• Alternativa: použijte Zero Hop advert s povoleným automatickým přidáváním kontaktů v nastavení — mnohem jednodušší než ruční import.
• Web flasher na flasher.meshcore.co.uk má také konzoli pro /import.

Zobrazení aktuálního času zařízení.

/clock

• Čas je interně uložen jako UTC; lokální časová zóna se aplikuje pouze pro zobrazení.
• Časovou zónu nastavte přes /gps tz +1 (nebo váš offset).
• GPS může automaticky synchronizovat hodiny, pokud je zapnuté.
• Bez GPS se čas synchronizuje z mesh sítě.

Ruční nastavení hodin zařízení na konkrétní čas.

/time <epoch‑seconds>

Příklady:

• /time 1710288000

• Hodnota je v Unix epoch sekundách (UTC).
• Preferujte GPS nebo mesh synchronizaci před ručním nastavením času.
• Správný čas je důležitý — sdílení přes Zero Hop advert selhává, pokud jsou hodiny mezi zařízeními příliš odlišné.

Zobrazení statistik využití heap a RAM.

/memory  (show heap/RAM statistics)

• Užitečné pro diagnostiku problémů s výkonem nebo pádů.

Zobrazení napětí baterie a stavu nabíjení.

/battery  (show battery voltage and status)

• Během nabíjení je hlášené napětí vyšší než skutečné napětí baterie, takže procento může ukazovat přes 100 %.

Zobrazení stavu SD karty (připojení, velikost, volné místo).

/sd  (show SD card status)

• SD karta se používá pro mapové dlaždice, audio soubory, logy a úložiště souborů.
• Na SD kartu lze nahrát vlastní mapové dlaždice pro offline mapy.
• Přehrávač hudby podporuje .wav soubory z SD karty.

Výpis souborů a adresářů na SD kartě.

/sd ls [path]  (list SD card directory)

Příklady:

• /sd ls
• /sd ls /maps

Smazání všech souborů z SD karty. Používejte opatrně.

/sd format  (erase all files from SD card)

• Toto je destruktivní operace a nelze ji vrátit zpět.

Zobrazení všech kontaktů, repeaterů a místností s celkovým počtem.

/list {n}

Příklady:

• /list
• /list 20

• Celkový limit je 150 záznamů (kontakty + repeatery dohromady).
• Pokud je seznam plný, nové kontakty/repeatery nelze přidat.
• Použijte pro kontrolu, zda nepřekračujete limit kontaktů při řešení problémů.

Zobrazení posledních přijatých zpráv.

/messages {n}  (show last n received messages, default 10)

Příklady:

• /messages
• /messages 20

• Výchozí hodnota zobrazí posledních 10 zpráv.

Zobrazení všech zpráv včetně odeslaných i přijatých.

/messages all  (show all messages including sent)

Smazání všech zpráv z úložiště zařízení.

/clearmessages  (delete all messages from storage)

• Toto je trvalé a nelze vrátit zpět.

Smazání všech kontaktů ze zařízení.

/clearcontacts  (delete all contacts)

• Použijte /clearcontacts repeaters pro smazání pouze repeaterů.
• Použijte /clearcontacts rooms pro smazání pouze místností.
• Použijte /clearcontacts chat pro smazání pouze chatových kontaktů.
• Pokud je tabulka kontaktů poškozená, tento příkaz může problém vyřešit.

Smazání konkrétního kontaktu podle hex ID prefixu.

/contacts delete <prefix>  (e.g. /contacts delete c08b)

Příklady:

• /contacts delete c08b

Vyhledání kontaktu podle hex ID prefixu.

/find <id>  (e.g. /find 3a or /find 3af5)

Příklady:

• /find 3a
• /find 3af5

• Fungují částečné hex prefixy — použijte 2 nebo 4 znaky.

Nastavení aktuálního příjemce přímých zpráv. Bez argumentů vymaže příjemce.

/to <recipient name or prefix>

Příklady:

• /to Alice
• /to c08b
• /to

• Můžete použít jméno kontaktu nebo hex ID prefix.

Odeslání přímé zprávy aktuálnímu příjemci (nastavenému přes /to).

/send <text>

Příklady:

• /send Ahoj, jak se máš?

Vysílání vaší identity přes zero-hop (přímý, nepřeposílaný) advert.

/advert  (zero‑hop broadcast)

• Adverty sdílejí váš veřejný klíč, aby vás ostatní zařízení mohla přidat jako kontakt.
• T-Decky automaticky vysílají advert každé 3 hodiny.
• Adverty obsahují GPS data, pokud je v nastavení povoleno sdílení polohy.
• Ostatní zařízení potřebují mít povolené automatické přidávání kontaktů, aby vás z advertu automaticky uložila.
• Adverty od známých kontaktů se zobrazují v seznamu Heard. Po restartu se kontakty v Heard nezobrazí, dokud znovu nevyšlou advert.

Vysílání identity do celé mesh sítě (multi-hop, přeposíláno přes repeatery).

/advert flood  (mesh‑wide broadcast)

• Používejte střídmě — generuje provoz napříč celou mesh sítí.

Odeslání trace paketu po zadané cestě pro testování routování.

/trace <path>  (e.g. /trace 1a,1b,1c)

Příklady:

• /trace 1a,1b,1c

• Každá hodnota je hex ID uzlu. Paket se pokusí následovat zadanou cestu.

Zobrazení aktuální cesty routování ke kontaktu.

/getpath <hex>  (show path to contact, e.g. /getpath c08b)

Příklady:

• /getpath c08b

• Zobrazuje řetězec hopů přes repeatery použitých k dosažení kontaktu.

Ruční nastavení cesty routování ke kontaktu.

/setpath <hex> <path>  (e.g. /setpath c08b 1a,2c or direct)

Příklady:

• /setpath c08b 1a,2c
• /setpath c08b direct

• Použijte direct pro vynucení přímé komunikace (bez repeateru).
• Hex ID oddělená čárkami specifikují řetězec repeaterů.

Reset cesty routování k aktuálnímu příjemci (nastavenému přes /to) zpět na automatickou.

/reset path  (reset path to current recipient)

Reset cesty routování ke konkrétnímu kontaktu zpět na automatickou.

/resetpath <hex>  (reset path to contact, e.g. /resetpath c08b)

Příklady:

• /resetpath c08b

Odeslání zprávy do veřejného kanálu (kanál 1). Viditelná pro všechny uzly.

/public <text>

Příklady:

• /public Ahoj všichni!

Odeslání zprávy do lokálního kanálu (kanál 2). Typicky kratší dosah nebo lokální skupina.

/local <text>

Příklady:

• /local Je tu někdo poblíž?

Odeslání zprávy do kanálu 3.

/ch3 <text>

Příklady:

• /ch3 Ahoj kanál 3!

Odeslání zprávy do kanálu 4.

/ch4 <text>

Příklady:

• /ch4 Ahoj kanál 4!

Odeslání zprávy do kanálu 5 (soukromý/šifrovaný kanál).

/ch5 <text>

Příklady:

• /ch5 Tajná zpráva

• Kanál 5 podporuje vlastní PSK pro šifrovanou skupinovou komunikaci. Viz /setchannel 5.

Nastavení názvu hashtag kanálu (kanály 1-4).

/setchannel <1‑4> #<name>  (e.g. /setchannel 3 #Jokes)

Příklady:

• /setchannel 3 #Vtipy
• /setchannel 4 #Nouze

• Názvy kanálů by měly začínat znakem #.

Konfigurace kanálu 5 s vlastním názvem a pre-shared key (PSK) pro soukromou skupinovou komunikaci.

/setchannel 5 <name> <hex_psk>  (e.g. /setchannel 5 mygroup 5339fba440a4d198076cefcc0f5aab9a)

Příklady:

• /setchannel 5 mojeskupina 5339fba440a4d198076cefcc0f5aab9a

• PSK je 32znakový hex řetězec (128bitový klíč).
• Všichni členové skupiny potřebují stejný PSK pro komunikaci na tomto kanálu.

Zobrazení informací o konkrétním kanálu.

/channel <1‑5>  (show channel info)

Příklady:

• /channel 1
• /channel 5

Výpis všech nakonfigurovaných kanálů s jejich názvy a nastavením.

/channels  (list all channels)

• MeshOS podporuje 5 kanálů: Public (1), Local (2), dva vlastní hashtag kanály (3-4) a jeden soukromý PSK kanál (5).
• Room servery nejsou v MeshOS aktuálně podporovány.

Přepínání zobrazení advert notifikací v UI.

/adverts (toggle advert display)

• Užitečné pro snížení šumu v oblastech s vysokým provozem.
• Toto pouze skryje zobrazení — adverty jsou stále přijímány a zpracovávány.
• Data advertů jsou uložena v adverts.bin.
• Pro úplné ztišení viz /quiet.

Přepínání tichého režimu, který skryje adverty i notifikace zpráv.

/quiet (toggle quiet mode ‑ hides adverts and messages)

• Hlasitost notifikačního zvuku se ovládá v nastavení zařízení.
• Notifikační zvuk je záměrně tichý; vlastní zvuky z SD karty jsou v plánu.

Přepínání režimu mobilního repeateru. Když je zapnutý, vaše zařízení funguje jako relay pro ostatní uzly.

/mobrep (toggle mobile repeater)

Přepínání automatického přidávání VŠECH slyšených repeaterů do kontaktů.

/autorep (toggle auto‑add ALL repeaters to contacts)

• Vypněte po úvodním nastavení — jinak se vaše zařízení zaplní stovkami vzdálených repeaterů.
• Limit kontaktů je 150 celkem (kontakty + repeatery), takže auto-add ho může rychle vyčerpat.

Zobrazení whitelistu povolených repeaterů.

/replist (show allowed repeater whitelist)

• Vyhledávání repeaterů vytváří whitelist repeaterů k přidání, ale ty stále musí vysílat advert, aby byly plně přidány.

Vymazání whitelistu repeaterů.

/clearrep (clear repeater whitelist)

Nastavení, zobrazení nebo vymazání regionálního filtru pro routování zpráv.

/scope #<region>  (e.g. /scope #london)

Příklady:

• /scope #praha
• /scope clear
• /scope

• Scoping omezuje, které zprávy vidíte, na základě regionálních tagů.

Odstranění aktuálního filtru scope.

/scope clear

Nastavení nebo zobrazení velikosti path hash používaného při routování (1-3 byty).

/pathsize <1‑3>  (set path hash size in bytes)

Příklady:

• /pathsize 2
• /pathsize

• Větší velikost path = unikátnější routování, ale vyšší režie.
• Výchozí hodnota je obvykle dostačující pro většinu sítí.

Nastavení nebo zobrazení úrovně přiblížení UI.

/uizoom <10|12|13|15>  (set UI zoom: 1.0x/1.2x/1.33x/1.5x)

Příklady:

• /uizoom 15
• /uizoom

• Užitečné pro uživatele se zrakovými obtížemi nebo menšími obrazovkami.

Nastavení nebo zobrazení fontu displeje.

/uifont <0|1>  (set font: 0=bitmap, 1=FreeSans)

Příklady:

• /uifont 1
• /uifont

Odeslání surového řídicího příkazu jako hex hodnoty.

/control <hex>  (e.g. /control 80AABBCC)

Příklady:

• /control 80AABBCC

• Pokročilý příkaz pro nízkoúrovňové ovládání zařízení. Používejte opatrně.

Vyhledávání okolních repeaterů.

/repeaters [seconds]  (scan for repeaters, default 10s)

Příklady:

• /repeaters
• /repeaters 30

• Výchozí doba skenování je 10 sekund.
• Nalezené repeatery jsou přidány do whitelistu, ale stále musí vysílat advert, aby byly plně registrovány.
• Po úvodním nastavení vypněte automatické přidávání repeaterů, abyste nezaplnili seznam kontaktů.
• Nepotřebujete všechny repeatery ve svém seznamu — seznam Heard je ukládá do volatilní paměti pro mapu.
• Pokrytí repeaterů zkontrolujte na meshcore.co.uk/map.html nebo analyzer.letsmesh.net/map.

Přihlášení do administračního rozhraní repeateru pro vzdálenou správu.

/repeateradmin <hex> [pass] (login to repeater admin)

Příklady:

• /repeateradmin a1b2 mojeheslo
• /repeateradmin a1b2

• Použijte 2bytový hex klíč repeateru a volitelně administrátorské heslo.
• Bez hesla získáte přístup jako host (pouze statistiky).
• Po přihlášení se terminál stane terminálem repeateru. Použijte help pro zobrazení dostupných příkazů repeateru.

Statistiky repeateru (dostupné po přihlášení přes /repeateradmin).

stats ‑ Get repeater statistics

• Zobrazuje uptime, počty zpráv a síťové statistiky.
• Hostovský přístup umožňuje prohlížení statistik; pro změny konfigurace je vyžadováno administrátorské heslo.

Zobrazení dostupných CLI příkazů repeateru, ke kterému jste přihlášeni.

help  ‑ Show repeater's CLI commands

• Dostupné pouze po přihlášení k repeateru přes /repeateradmin.

Zapnutí GPS přijímače a zahájení vyhledávání satelitů.

/gps on    ‑ Enable GPS and start receiving

• Na T-Deck Plus funguje GPS ihned na 38400 baud.
• Na standardním T-Decku s externím GPS může být nutné nastavit baud rate: /gps baud 9600.
• První fix může trvat několik minut, zejména v interiéru. Vezměte zařízení ven s výhledem na oblohu.
• Pokud GPS nezíská fix, zkuste /gps off a poté /gps on — to často vyřeší zaseknutý stav.
• GPS automaticky synchronizuje hodiny zařízení.

Vypnutí GPS přijímače pro úsporu energie.

/gps off   ‑ Disable GPS

• Čas se již nebude automaticky synchronizovat z GPS; bude se spoléhat na mesh synchronizaci nebo ruční nastavení.

Zobrazení aktuálního stavu GPS včetně kvality fixu, počtu satelitů a pozice.

/gps get   ‑ Show GPS status and position

• Zobrazuje: stav fixu (ano/ne), počet satelitů, souřadnice a počet NMEA vět.