MeshOS Manuál

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

Poslední aktualizace: 2026-03-12

Rychlý start

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

Základní první kroky:

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.
Nastavte časovou zónu: /gps tz +1 (váš UTC offset)
Ověřte nastavení rádia: /get radio
Vyhledejte repeatery: /repeaters

Obecné tipy

Správa kontaktů

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 a GPS

Č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ály

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.

Repeatery a routování

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.

SD karta

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í.

Wallpaper

Název souboru

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.

Formát

Pouze .png

Velikost souboru

Maximálně 200 KB.

Rozměry

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.

Umístění tapety

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

Jak aktivovat

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

Poznámky

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.

Poznámky k hardwaru

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.

Obsah

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

Obecné

/set

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}

Parametr	Popis
`name`	Zobrazované jméno zařízení
`lat`	Zeměpisná šířka (desetinné stupně)
`lon`	Zeměpisná délka (desetinné stupně)
`freq`	Frekvence rádia v MHz
`sf`	Spreading factor
`bw`	Šířka pásma v kHz
`tx`	Vysílací výkon v dBm
`cr`	Coding rate
`af`	Audio frekvence

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.

/get radio

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.

/card

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

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.

/clock

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ě.

/time

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é.

/memory

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ů.

/battery

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 %.

/sd

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.

/sd ls

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

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

Příklady:

/sd ls
/sd ls /maps

/sd format

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.

/list

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ů.

/messages

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.

/messages all

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

/messages all  (show all messages including sent)

/clearmessages

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.

/clearcontacts

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.

/contacts delete

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

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

Příklady:

/contacts delete c08b

/find

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.

/to

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.

/send

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.

/advert flood

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í.

/trace

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.

/getpath

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.

/setpath

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 path

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)

/resetpath

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

/public

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!

/local

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íž?

/ch3

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

/ch3 <text>

Příklady:

/ch3 Ahoj kanál 3!

/ch4

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

/ch4 <text>

Příklady:

/ch4 Ahoj kanál 4!

/ch5

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.

/setchannel

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 #.

/setchannel 5

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.

/channel

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

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

Příklady:

/channel 1
/channel 5

/channels

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.

/adverts

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.

/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.

/mobrep

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)

/autorep

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.

/replist

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.

/clearrep

Vymazání whitelistu repeaterů.

/clearrep (clear repeater whitelist)

/scope

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ů.

/scope clear

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

/scope clear

/pathsize

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í.

/uizoom

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

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

Parametr	Popis
`10`	1.0x (výchozí)
`12`	1.2x
`13`	1.33x
`15`	1.5x

Příklady:

/uizoom 15
/uizoom

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

/uifont

Nastavení nebo zobrazení fontu displeje.

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

Parametr	Popis
`0`	Bitmapový font (výchozí)
`1`	FreeSans (hladší, lepší čitelnost)

Příklady:

/uifont 1
/uifont

/control

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ě.

/repeaters

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.

/repeateradmin

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.

Administrace repeateru

stats

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.

help

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.

GPS

/gps on

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í.

/gps off

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í.

/gps get

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.