Komunikační protokol
- Rozložení obrazovek
- Command: BEEP
- Command: CLOCK
- Command: COLOR
- Command: DIMM
- Command: ICON
- Command: LCD
- Command: LED
- Command: RTTTL
- Command: TEXT
- Command: WEATH
- Event: DIMM
- Event: Proximity
- Event: Tlačítka
- Report: Stav senzorů
Rozložení obrazovek
Spodní řádek
Na obrazovce panelu se mohou zobrazovat až tři ikony/hodnoty nezávisle na zvolené obrazovce.
Layout 212 - bez ikon
|
A1 |
B1 |
C1 |
|
A2 |
C2 |
Layout 2×3
|
A1 |
B1 |
C1 |
|
A2 |
B2 |
C2 |
A1, B1, C1, A2, B2, C2 → tlačítka, mohou obsahovat ikonu nebo text
Lze vynechat některá tlačítka (např. A1, B2, D3)
Layout 3x4
|
A1 |
B1 |
C1 |
D1 |
|
A2 |
B2 |
C2 |
D2 |
|
A3 |
B3 |
C3 |
D3 |
A1–D3 → tlačítka, mohou obsahovat ikonu nebo text
Lze vynechat některá tlačítka (např. A1, B2, D3)
Command: BEEP
zvuková odezva při stisku tlačítka
k dispozici od verze firmware 1.4.8
Příkaz BEEP umožňuje zapnout / vypnout pípnutí při stisku tlačítek na displeji
Hodnota může být 0 (vypnuto) nebo 1 (zapnuto).
Syntaxe
Příklady zapnutí pípnutí při stisku tlačítek
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
pouze hodnota 0 nebo 1
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Úspěšně nastaveno. |
| 10 |
Set beep out of range Value 0-1 only
|
Povolené jsou pouze hodnoty 0 nebo 1 |
Command: CLOCK
nastavení času
Příkaz CLOCK slouží k ručnímu nastavení času v panelu, pokud nelze využít NTP.
Nepoužívá datum — pouze hodiny, minuty nebo kompletní HH:MM.
Hodnota se nastavuje buď přímým parametrem hour, minute nebo time.
Syntaxe
Příklady pro odeslání času 18:59
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT HomeAssistant
Topic
Hodnota (Value)
📋 Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| hour | ❌ | Nastaví pouze hodinu (0–23). |
| minute | ❌ | Nastaví pouze minutu (0–59). |
| time | ❌ | Nastaví čas ve formátu HH:MM. |
Minimálně jeden z parametrů musí být uveden.
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Čas úspěšně nastaven. |
| 10 | Time out of range (00:00-23:59) | špatný rozsah času |
| 10 | Hour out of range (0-23) | hodiny mimo povolený rozsah |
| 10 | Minute out of range (0-59) | minuty mimo povolený rozsah |
| 20 | Format: hh:mm, hour ## or minute ## | špatný formát času pro hodiny a minuty použijte vždy dvě místa |
Command: COLOR
změna barvy textu nebo ikony
Slouží k nastavení barvy textu nebo ikony na konkrétním tlačítku.
Barevné nastavení není uloženo po restartu panelu.
Syntaxe
Příklady pro nastavení žluté barvy tlačítka A1 na obrazovce číslo 1
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
scr# - nastavení čísla obrazovky kde # je číslo 1~3
btn$# - nastavení tlačítka podle zvoleného layoutu $ je písmeno sloupce A~D, # je číslo řádku 1~3
Barva se zadává v RGB hex formátu hRRGGBB.
není podporovaný formát hRGB
Doporučené barvy
| Výchozí barva | h7F7F7F |
|
doporučená červená |
h7F0000 |
| doporučená zelená | h007F00 |
| doporučená žlutá | h7F7F00 |
| doporučená modrá | h00007F |
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| scr# | ✅ | Číslo obrazovky (1–3). |
| btn$# | ✅ | Umístění tlačítka — $ = sloupec (A–D), # = řádek (1–3). |
| hRRGGBB | ✅ | Barva v HEX formátu (např. h7F7F7F). |
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Příkaz proveden. |
| 21 | Bad color format (use: hRRGGBB) | Špatný formát barvy použijte hRRGGBB (R - červená, G - zelená, B - modrá) |
| 22 | Bad color format missing 'h' in front of color code (use: hRRGGBB) | Špatný formát barvy, chybí identifikátor pro barvu 'h' před kódem |
| 30 | Screen or button doesn't exist (index out of range) | Tlačítko nebo obrazovka neexistuje |
| 31 | bad button format (use: scr# btn$#) | Špatný formát označení obrazovky a tlačítka |
Command: DIMM
automatické zhasnutí displeje
Příkaz DIMM umožňuje automaticky zhasnout displej po uplynutí nastaveného času.
Hodnota může být 0 (vypnuto) nebo 1 (zapnuto).
Čas zhasnutí se nastavuje pouze přes WEB/Settings/Device setting/Auto dimm delay in seconds
Syntaxe
Příklady zapnutí automatického vypnutí displeje
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
pouze hodnota 0 nebo 1
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Úspěšně nastaveno. |
| 10 |
Set display dimm out of range 0 or 1
|
Povolené jsou pouze hodnoty 0 nebo 1 |
Command: ICON
změna ikony na tlačítku
k dispozici od verze firmware 1.5.2
Umožňuje změnit ikonu na zvolené pozici v layoutu 2×3 nebo 3×4.
Podporuje pouze ikony ze seznamu.
-
Barva ikony se mění příkazem color.
-
Ikona je uložena jen v RAM
Syntaxe
Příklady pro tlačítko C1 (třetí sloupec a první řádek) na obrazovce číslo 1, ikona číslo 33 
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
scr# - nastavení čísla obrazovky kde # je číslo 1~3
btn$# - nastavení tlačítka podle zvoleného layoutu $ je písmeno sloupce A~D, # je číslo řádku 1~3
value - hodnota musí být ve formátu i## kde ## je číslo 1~78
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| scr# | ✅ | Číslo obrazovky (1–3). |
| btn$# | ✅ | Umístění tlačítka — $ = sloupec (A–D), # = řádek (1–3). |
| value i## | ✅ | číslo ikony |
Kódy ikon
Kódy jsou k dispoizici i v nastavení daného panelu jako tooltip. Při najetí myši nad ikonu, by se měla zobrazit poznámka které začíná i##_jméno_ikony, kde ## je kód ikony.
| Kód | Ikona | Kód | Ikona | Kód | Ikona | Kód | Ikona | Kód | Ikona | Kód | Ikona |
| 1 |
|
2 |  |
3 |  |
4 |  |
5 |  |
6 |  |
| 7 |
|
8 |
|
9 |
|
10 |
|
11 |
|
12 |
|
| 13 |
|
14 |
|
15 |
|
16 |
|
17 |
|
18 |
|
| 19 |
|
20 |
|
21 |
|
22 |
|
23 |
|
24 |
|
| 25 |
|
26 |
|
27 |
|
28 |
|
29 |
|
30 |
|
| 31 |
|
32 |
|
33 |
|
34 |
|
35 |
|
36 |
|
| 37 |
|
38 |
|
39 |  |
40 |
|
41 |
|
42 |
|
| 43 |
|
44 |
|
45 |
|
46 |
|
47 |
|
48 |
|
| 49 |
|
50 |
|
51 |
|
52 |
|
53 |
|
54 |
|
| 55 |
|
56 |
|
57 |
|
58 |
|
59 |
|
60 |
|
| 61 |
|
62 |
|
63 |
|
64 |
|
65 |
|
66 |
|
| 67 |
|
68 |
|
69 |
|
70 |
|
71 |
|
72 |
|
| 73 |
|
74 |
|
75 |
|
76 |
|
77 |
|
78 |
|
poskytovatel ikon pictogrammers.com
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Příkaz proveden. |
| 13 |
Icon index out of range (use: i## with 1-78)
|
číslo ikony je mimo povolený rozsah |
| 23 |
Bad icon format (use: i##)
|
špatný formát |
| 24 |
Bad icon format missing 'i' (use: i##)
|
špatný formát chybějící identifikátor 'i' |
| 30 |
Screen or button doesn't exist (index out of range)
|
Tlačítko nebo obrazovka neexistuje |
| 31 |
Bad button format (use: scr# btn$#)
|
Špatný formát označení obrazovky a tlačítka |
| 32 |
Screen or button doesn't exist or button is not defined as 'TEXT PLACE' (index out of range)
|
Neexistující tlačítko nebo obrazovka nebo tlačítko není definováno pro text |
Command: LCD
podsvícení displeje
Modul LCD umožňuje nastavit jas podsvícení samotného displeje.
Hodnota může být 0–100 %, doporučuje se minimálně 15 % pro čitelný displej.
Syntaxe
Příklady nastavení jasu na 50%
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
Hodnoty v rozsahu bez desetinných míst 0~100
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Podsvícení nastaven. |
| 10 |
Set LCD brightness out of range (0-100)
|
Hodnota je mimo povolený rozsah |
Command: LED
ambientní podsvícení panelu
Modul LED umožňuje nastavit intenzitu orientačního světýlka pod panelem.
Hodnota může být 0–100 %.
Syntaxe
Příklady nastavení jasu na 45%
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
Hodnoty v rozsahu bez desetinných míst 0~100
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Podsvícení nastaven. |
| 10 |
Set LED brightness out of range (0-100)
|
Hodnota je mimo povolený rozsah |
Command: RTTTL
přehrávání melodie
Příkaz RTTTL umožňuje přehrávat melodie na bzučáku panelu.
Zařízení má omezení maximální délky přehrávání 40 s. Pokud řetězec melodie přesáhne limit, přebytečná část se automaticky ořízne a nezazní.
Syntaxe
Příklady nastavení přehrání melodie dance:d=4,o=5,b=140:16e6,16e6,16f#6,8g6,8a6,8b6,4c7,4b6,8a6,8g6,8f#6,8e6,8d6,2d6v
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT
Topic
Hodnota (Value)
📋 Parametry
melodie ve formátu RTTTL jmeno:d=trvání,o=oktáva,b=rychlost:noty
⚠️ Chybové hlášky
Command: TEXT
zobrazení textu na tlačítku
Zobrazí vlastní text na zvolené pozici v layoutu 2×3 nebo 3×4.
Podporuje UTF-8, včetně diakritiky (rozsah 32~709). Používá se pro dynamické hodnoty (teploty, stavy, hlášení, …).
-
Text je automaticky centrován.
-
Dlouhý text se automaticky posouvá (scroll circular).
-
Barva textu se mění příkazem color.
-
Text je uložen jen v RAM
- Maximální délka je 127 znaků
Syntaxe
Příklady pro tlačítko C2 (třetí sloupec a druhý řádek) na obrazovce číslo 1, velikost fontu 30 a text
Pokus
textu
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
scr# - nastavení čísla obrazovky kde # je číslo 1~3
btn$# - nastavení tlačítka podle zvoleného layoutu $ je písmeno sloupce A~D, # je číslo řádku 1~3
font - velikost fontu 16, 20, 30 a 46. Velikost 46 nepodporuje ořádkování! A je primárně určena pro zobrazení hodnot např teploty °C. Pokud parametr font není uveden bude použita velikost 16
value - text musí být uzavřen 'v jednoduchých uvozovách'
UDP
HTTP
MQTT
Topic
Hodnota (Value) - JSON formát
"font":30,
"text":'Pokus\ntextu'
}
📋 Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| scr# | ✅ | Číslo obrazovky (1–3). |
| btn$# | ✅ | Umístění tlačítka — $ = sloupec (A–D), # = řádek (1–3). |
| font | ❌ | velikost fontu, možné velikosti 16, 20, 30 a 46 (nepodporuje odřádkování!), výchozí je 16 |
| value 'text' | ✅ | Hodnota textu, pro vymazání textu použijte jednu mezeru |
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | Příkaz proveden. |
| 12 |
Missing or bad value:'text' (use value:'your text')
|
Chybějící hodnota textu |
| 30 |
Screen or button doesn't exist (index out of range)
|
Tlačítko nebo obrazovka neexistuje |
| 31 |
Bad button format (use: scr# btn$#)
|
Špatný formát označení obrazovky a tlačítka |
| 32 |
Screen or button doesn't exist or button is not defined as 'TEXT PLACE' (index out of range)
|
Neexistující tlačítko nebo obrazovka nebo tlačítko není definováno pro text |
Command: WEATH
počasí a venkovní teplota
Příkaz WEATH slouží k nastavení ikony počasí a/nebo venkovní teploty, která se zobrazuje ve spodním stavovém řádku panelu.
Můžeš nastavit jen ikonu, jen teplotu, nebo oboje najednou.
Syntaxe
Příklady pro polojasno ve dne a venkovní teplota je 23°C
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
UDP
HTTP
MQTT
U MQTT z důvodu napojení na homeassistent je nutné mít i oddělené nastavení ikony a teploty.
Nastavení ikony
Topic
Hodnota (Value)
Nastavení teploty
Topic
Hodnota (Value)
📋 Parametry
| Parametr | Povinný | Popis |
|---|---|---|
| icon | ❌ | Kód ikonky počasí (viz tabulka). |
| temp | ❌ | Venkovní teplota v °C (−99 až +99). |
Minimálně jeden parametr musí být uveden.
Pořadí parametrů je libovolné.
Kódy ikon počasí
| Kód | Ikona | Význam |
|---|---|---|
| 1 |
|
slunečno |
| 91 |
|
noc jasno |
| 2 |
|
polojasno |
| 92 |
|
polojasno noc |
| 4 |
|
zataženo |
| 5 |
|
nízká oblačnost |
| 6 |
|
mlha |
| 7 |
|
vysoké teploty |
| 8 |
|
nízké teploty |
| 11 |
|
déšť |
| 12 |
|
přeháňky |
| 912 |
|
přeháňky noc |
| 13 |
|
deštivo |
| 14 |
|
bouřkové přeháňky |
| 914 |
|
bouřkové přeháňky noc |
| 15 |
|
bouřky |
| 16 |
|
husté sněžení |
| 20 |
|
sněhové přeháňky |
| 920 |
|
sněhové přeháňky noc |
| 21 |
|
sněžení |
| 22 |
|
větrno |
| 23 |
|
déšť se sněhem |
⚠️ Chybové hlášky
| Kód | Hláška | Význam |
|---|---|---|
| 0 | (bez chyby) | OK |
| 20 |
Bad weather format (use: temp## ico##)
|
špatný formát příkazu |
v případě, že bude nastavena ikona mimo seznam výše, bude zobrazena ikona 
Event: DIMM
ovládací panel odesílá informaci o zhasnutí podsvícení displeje podle nastavení:
WEB\Settings\UDP Configuration\Enabled
WEB\Settings\MQTT Configuration\Enabled
Nastavení času zhasnutí displeje WEB\Settings\Device setting Auto Dimm + Auto dimm delay in seconds pro nastavení času zhasnutí displeje.
Opětovné rozsvícení displeje je možná pomocí přiblížení ruky k displeji, dotykem na plochu nebo změnou nastavení přes Command: DIMM
Syntaxe
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
Hodnota:
0 - displej je aktivní
1 - displej je zhasnutý
UDP
MQTT
Topic
Hodnota (Value)
Event: Proximity
ovládací panel vrací hodnotu přiblížení ruky na ca <20mm od panelu:
WEB\Settings\UDP Configuration\Enabled
WEB\Settings\MQTT Configuration\Enabled
senzor přiblížení je umístěný v pravé straně rámu displeje, přibližně uprostřed.
Syntaxe
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
Hodnoty 0 nebo 1
UDP
MQTT
Topic
Hodnota (Value)
Event: Tlačítka
ovládací panel vrací hodnotu stisku nebo uvolnění tlačítka podle nastavení:
WEB\Settings\UDP Configuration\Enabled
WEB\Settings\MQTT Configuration\Enabled
Syntaxe
Příklady pro událost "dlouhý stisk" -> 5 tlačítka B3 (druhý sloupec a třetí řádek) na obrazovce číslo 1
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
scr# - nastavení čísla obrazovky kde # je číslo 1~3
btn$# - nastavení tlačítka podle zvoleného layoutu $ je písmeno sloupce A~D, # je číslo řádku 1~3
číslo scr# a btn$# dle použitého layoutu
Hodnoty:
0 - uvolněno
1 - krátký stisk
5 - dlouhý stisk >500ms
6 - dlouhý stisk opakování>500ms a opakuje každých 500ms puls
UDP
MQTT
Topic
Hodnota (Value)
Report: Stav senzorů
ovládací panel odesílá každých 15 sec naměřená data z vestavěných senzorů, podle nastavení:
WEB\Settings\UDP Configuration\Enabled
WEB\Settings\MQTT Configuration\Enabled
Syntaxe
devName - označení panelu WEB/Settings/Device setting/Device name
devIP - IP adresa panelu
Rozklíčování hodnot
| UDP | MQTT | význam |
| temp | temperature | teplota ve °C |
| rh | humidity | relativní vlhkost % |
| AQI | aqi | kvalita ovzduší index 1 - 5 |
| TVOC | tvoc | celkové těkavé organické sloučeniny 0~65000ppb |
| eCO | eco2 | equivalent CO2 400~65000ppm |