LED Matrix Panel je projekt, který z barevného LED panelu Waveshare 96×48 a desky LaskaKit ESP32-S3-DEVKit udělá nástěnnou stanici. Ukazuje hodiny, předpověď počasí, srážkový radar ČHMÚ/RainViewer a letadlo, které vám právě letí nad hlavou. Sám pozná, co je zrovna důležité, a podle toho přepíná obrazovky.
Nastavuje se celý z telefonu, programovat nemusíte. Hotový firmware nahrajete z prohlížeče přes esp32flasher.chiptron.cz, zapojení je šestnáct vodičů. Projekt vychází z mého MeteoPlaneRadaru, jen místo kulatého displeje svítí 4 608 LED s roztečí 2,5 mm.
Projekt je zdarma. Pokud chcete, můžete mě podpořit kávou na buymeacoffee.com/chiptroncz.
Tento článek není placenou spoluprací!

Kam chcete?
Co to umí
Obrazovky · Kdy se co ukáže · Noc · Odkud jsou data
Chci si ho postavit
Co koupit · Zapojení · Nahrání firmwaru · První spuštění · Nastavení · Aktualizace · Když něco nejde
Chci na tom stavět
Překlad v Arduino IDE · Jak to funguje uvnitř · JSON API · Vlastní obrazovka · Kód a licence
Co panel umí
Panel má čtyři obrazovky. Všechny jsou nakreslené přímo pro rozlišení 96×48 bodů.

Hodiny

Ručičkové s vyhlazenými ručičkami a plynule běžící vteřinovkou, nebo digitální. Kolem ciferníku den v týdnu, datum, měsíc a rok. Barvu ručiček, vteřinovky, číslic, značek ciferníku i data si nastavíte, vteřiny a datum jdou vypnout.
Předpověď

Tři sloupce: teď, dnes, zítra. Ikona počasí, teplota, u dneška a zítřka maximum a minimum, u aktuálního stavu rychlost větru v m/s.
Letadlo

Volací znak, typ letadla, rychlost, výška a vzdálenost. Ikona letadla je natočená podle skutečného směru letu.
Ukazuje se vždy nejbližší letadlo v okruhu (výchozí 10 km). Když jich je v okolí víc, vlevo dole přibude „+1“, „+2“ a tak dál.
Užitečná je volba směr výhledu. Zadáte, kam máte výhled z okna (třeba na jihovýchod), šířku výseče (výchozí ±30°) a její dosah (výchozí 5 km). Letadlo v této výseči má přednost před nejbližším a zobrazí se i za běžným okruhem. Takže na panelu je právě to letadlo, které vidíte z okna.
Radar

Mapa České republiky s animací posledních šesti snímků srážkového radaru (u ČHMÚ posledních 25 minut, u RainVieweru zhruba 50). Krajská města jsou malé modré křížky, vaše poloha zelený bod, vpravo barevná škála a v rohu běží digitální hodiny.
Snímek ČHMÚ je mnohonásobně větší než 96×48 bodů panelu. Při zmenšení si každý bod panelu ponechá nejsilnější ozvěnu z oblasti, kterou pokrývá. Malá bouřková buňka tak nezmizí v průměru okolí.
Zdroj radaru si vyberete na webu na záložce Radar. Když chcete tento projekt použít mimo Českou republiku, přepnete na RainViewer.
| Zdroj | Co to je |
|---|---|
| ČHMÚ | kompozit MAX Z, nový snímek každých 5 minut, výchozí volba |
| ČHMÚ masked | stejný kompozit, ale jen srážky, které dopadnou na zem (bez virgy a kovadlin vzdálených bouřek) |
| RainViewer | mezinárodní kompozit, nový snímek každých 10 minut, hrubší rozlišení |
Kdy se co ukáže
O tom rozhoduje režim obrazovky. Vybírá se na webu na záložce Stav a panel si ho pamatuje i po vypnutí. Na výběr jsou tři: automatický, střídání a pevně jedna obrazovka.
Automatický režim

Panel se ptá shora dolů a ukáže první obrazovku, jejíž podmínka platí:
- Letí letadlo? V okruhu 10 km, nebo ve výseči směru výhledu. Pak letadlo.
- Prší v okolí? Nejnovější radarový snímek ukazuje srážky od 20 dBZ do 100 km od vás. Pak radar.
- Jinak hodiny, každých 50 sekund vystřídané na 10 sekund předpovědí.
20 dBZ odpovídá slabému dešti. Pokud nechcete, aby panel přepínal kvůli každé přeháňce na Šumavě, zvyšte práh nebo zmenšete okruh. Všechny časy a vzdálenosti jdou změnit.
U letadel si navíc vyberete, jak moc mají být dotěrná:
- Ukázat ihned: letadlo přebije všechno, i radar. Po odletu zůstane ještě 5 sekund, aby obraz nepoblikával na hranici okruhu.
- Ukazovat občas: letadlo se ukáže na 15 sekund, pak má minutu pauzu, během které běží hodiny, předpověď nebo radar. Dokud je letadlo v okolí, opakuje se to. Hodí se, když bydlíte u letiště a nechcete koukat jen na letadla.
- Nikdy: automatický režim letadla vynechá.
Střídání

Vybrané obrazovky jdou dokola v pevném pořadí hodiny, předpověď, radar, letadlo, každá 15 sekund. Které se střídají, zvolíte na záložce Displej.
Obrazovka, která nemá co ukázat, se přeskočí. Hodiny nikdy, předpověď když je vypnutá nebo ještě nejsou data, radar když v okruhu neprší (pokud nezapnete volbu Radar i bez deště) a letadlo když žádné neletí. Když letadlo odletí, zatímco je na řadě, panel hned přejde na další obrazovku.
Pevně jedna obrazovka
Panel ukazuje stále totéž: hodiny, předpověď, radar, nebo letadlo. Radar pak kreslí mapu i bez deště, letadlo při prázdné obloze napíše „zadne letadlo“.
Noc
Noční režim se zapíná podle času (výchozí 22:00 až 6:00), nebo od západu do východu slunce, který si panel spočítá z vaší polohy. V noci panel ztlumí jas, nebo se úplně vypne. Volitelně ukazuje jen hodiny, aby vás nebudil blikající radar.
Vypnutí platí ve všech režimech. Volba jen hodiny platí pro automatický režim a střídání, pevně zvolená obrazovka zůstává.
Odkud jsou data
| Data | Zdroj | Jak často |
|---|---|---|
| Letadla | adsb.fi, otevřené API bez klíče | každých 10 s |
| Srážkový radar | ČHMÚ open data, kompozit MAX Z | každých 5 min |
| Srážkový radar (alternativa) | RainViewer, otevřené API bez klíče | každých 10 min |
| Předpověď | Open-Meteo | každých 15 min |
| Čas | hlavička Date odpovědí těchto serverů | s každým dotazem |
Žádný vlastní ADS-B přijímač ani registrace nejsou potřeba, stačí WiFi. Letadla a předpověď fungují kdekoli na světě. Mapa na panelu je jen česká, takže radar dává smysl hlavně v Česku, i když RainViewer má data i ze zahraničí.
Co koupit
Pájet nemusíte, všechno se spojuje vodiči s dutinkami.
| Díl | Poznámka |
|---|---|
| Waveshare RGB-Matrix-P2.5-96×48-F | flexibilní panel 96×48 LED, rozteč 2,5 mm, rozměr 240×120 mm, rozhraní HUB75. Waveshare, odkaz LaskaKit. Sehnat se dá i na AliExpressu, já objednal na LaskaKitu. |
| LaskaKit ESP32-S3-DEVKit | ESP32-S3 s 16 MB flash, PSRAM není potřeba. Odkaz LaskaKit. Šlo by použít i Espressif ESP32-S3 vývojový kit, ten jsem neměl po ruce. |
| Zdroj 5 V | aspoň 4 A, napájí panel (v mém případě proud nepřesáhl 500 mA) |
| USB-C kabel | napájí ESP32 a slouží k nahrání firmwaru |
| 16 vodičů dupont F-F | 14 signálů a 2× GND, co nejkratší, ideálně do 10 cm |
Pozor na verzi panelu. Waveshare ho prodává ve dvou verzích. Firmware je nastavený na V2, kterou poznáte podle označení končícího 24S-A1 na zadní straně. Verze V1 funguje taky, jen je potřeba přepnout jednu hodnotu a firmware si přeložit (viz část pro vývojáře).
Zapojení

Panel se připojuje do vstupního konektoru HUB75 IN (2×8 pinů). Číslování pinů platí při pohledu na zadní stranu panelu s výřezem konektoru nahoru. Na schématu má každý pin desky napsané, na který pin konektoru vede, a naopak.
| Pin HUB75 | Signál | GPIO ESP32-S3 | Pin HUB75 | Signál | GPIO ESP32-S3 |
|---|---|---|---|---|---|
| 1 | R1 | 4 | 2 | G1 | 5 |
| 3 | B1 | 6 | 4 | GND | GND |
| 5 | R2 | 7 | 6 | G2 | 15 |
| 7 | B2 | 16 | 8 | E | 21 |
| 9 | A | 17 | 10 | B | 18 |
| 11 | C | 8 | 12 | D | 41 |
| 13 | CLK | 38 | 14 | LAT | 40 |
| 15 | OE | 39 | 16 | GND | GND |
Piny D a E panel V2 nepoužívá, zapojte je ale taky. Nic nezkazí a stejné zapojení pak funguje i s verzí V1.
Signálové vodiče udržujte co nejkratší, ideálně do 10 cm. Panel se budí rychlými signály po 14 vodičích a dlouhé vodiče fungují jako anténa. S vodiči kolem 20 cm mi problikávaly body na levém okraji. Horší bylo, že se rozpadala WiFi: stránka nastavení se načítala 10 sekund místo 0,2 s a telefon padál z nastavovací sítě. Firmware proto posílá data do panelu na 8 MHz místo 16 MHz a se slabšími budiči pinů. Pak už všechno jelo bez problémů.
Pokud potíže přetrvávají, vodiče ještě zkraťte, veďte je dál od antény ESP32 a použijte plochý kabel se zemí.
Napájení: panel napájejte přímo ze zdroje 5 V do jeho napájecího konektoru, nikdy přes ESP32. Deska jede z USB-C. Zem zdroje, panelu a ESP32 musí být propojená, jinak panel zobrazuje nesmysly.
Popisky pinů HUB75 na plošném spoji panelu nesouhlasí se skutečným zapojením! Řiďte se tabulkou výše.
Nahrání firmwaru
Žádné Arduino IDE, žádné knihovny. Stačí prohlížeč Chrome, Edge nebo Firefox 151 a novější (Safari Web Serial neumí), USB-C kabel a pár minut.
- Z Releases na GitHubu si u nejnovější verze stáhněte LED_Matrix_Panel_CZ.merged.bin (čeština), nebo LED_Matrix_Panel_EN.merged.bin (angličtina). Jazyk jde později změnit i na webu. Soubor obsahuje celou paměť včetně bootloaderu a rozdělení oddílů, takže funguje i na úplně nové desce.
- Připojte desku k počítači přes USB-C konektor označený UART.
- Otevřete esp32flasher.chiptron.cz, připojte se k portu desky, vyberte stažený soubor a dejte nahrát.
- Po dokončení stiskněte na desce RESET.
Po startu panel na chvíli ukáže tři pruhy: červený, zelený a modrý. To je test barev. Když svítí v tomhle pořadí, je zapojení v pořádku.
První spuštění a WiFi
Panel zatím nezná vaši WiFi, takže si vytvoří vlastní.
- Na panelu se objeví QR kód a název otevřené sítě LED-Matrix-XXXX (poslední čtyři znaky jsou z MAC adresy desky).
- Naskenujte QR kód telefonem. Stránka s nastavením se otevře sama, případně zadejte
http://192.168.4.1. - Na záložce WiFi vyberte domácí síť a zadejte heslo.
- Panel nastavovací síť zavře, připojí se domů a na 10 sekund ukáže svou IP adresu. Pak naskočí hodiny.
Když se k domácí síti nepřipojí do 20 sekund (překlep v hesle, vypnutý router), nastavovací síť se vrátí. Pokud už má síť uloženou, zkusí ji znovu každých 5 minut, ale jen když k nastavovací síti zrovna není připojený žádný telefon.
Na polohu nezapomeňte. Výchozí je Praha. Na záložce Poloha napíšete název obce a vyberete ji ze seznamu, nebo zadáte souřadnice.
Nastavení v prohlížeči

Web běží pořád na adrese http://ledmatrix.local, případně na IP adrese z úvodní obrazovky. Je česky nebo anglicky (přepíná se na záložce Systém a platí i pro texty na panelu) a má osm záložek.
| Záložka | Co tam najdete |
|---|---|
| Stav | čas, aktuální obrazovka, letadlo, radar, počasí, volná paměť, výběr režimu |
| WiFi | vyhledání sítí, připojení, zapomenutí sítě |
| Poloha | vyhledání obce, zeměpisná šířka a délka |
| Letadla | zapnutí, okruh, minimální výška, jen s volacím znakem, interval dotazů, směr výhledu s mapkou výseče |
| Radar | zapnutí, zdroj dat (ČHMÚ, ČHMÚ masked, RainViewer), okruh a práh deště, počet snímků, rychlost animace, legenda, města, podklad mapy |
| Hodiny a počasí | ručičkové nebo digitální, vteřiny, datum, všechny barvy, předpověď a její časování |
| Displej | automatický režim a střídání, jas ve dne a v noci, noční režim |
| Systém | jazyk (čeština, angličtina), název zařízení, časové pásmo, záloha a obnova nastavení, aktualizace firmwaru, restart, tovární nastavení |
Nastavení se ukládá do paměti desky a přežije výpadek proudu i aktualizaci firmwaru. Zálohu si stáhnete jako JSON a stejnou cestou ji nahrajete zpátky.
Aktualizace firmwaru
Další verze už kabel nepotřebují. Z Releases na GitHubu si stáhněte LED_Matrix_Panel.bin (bez merged v názvu) a nahrajte ho na webu panelu na záložce Systém. Panel se po nahrání sám restartuje, nastavení zůstane.
Když něco nejde
- Pruhy při startu mají jiné barvy (místo červené modrá a naopak): máte panel s jiným pořadím barev. Řeší to hodnota
PANEL_SWAP_RBpři překladu. - Svítí celé řádky nebo pruhy: jiná verze panelu, viz
PANEL_LINE_DECODERv části pro vývojáře. - Body na okraji problikávají: zkraťte vodiče, zkontrolujte společnou zem a zdroj (viz Zapojení).
- ESP32 se restartuje při vysokém jasu nebo hned po zapnutí (v Serial Monitoru „Brownout“): nestabilní napájení, typicky ve chvíli, kdy se rozbíhá WiFi a panel zrovna svítí. Silnější zdroj, kondenzátor kolem 1000 µF na svorky panelu, nebo nižší jas na záložce Displej.
- Stránka nastavení se načítá dlouho, telefon padá z nastavovací sítě, radar hlásí timeouty: rušení z vodičů panelu. Zkraťte je a veďte dál od antény ESP32.
- Web na ledmatrix.local nejde otevřít: některé sítě a telefony adresy .local nepřekládají. Použijte IP adresu z úvodní obrazovky.
Pro vývojáře: překlad v Arduino IDE
Tahle část je pro ty, kdo si chtějí firmware upravit nebo na něm postavit něco svého. Pokud jste nahráli hotový soubor, klidně ji přeskočte.
- Balíček desek esp32 by Espressif Systems verze 3.x.
- Knihovny z Library Manageru: ESP32 HUB75 LED MATRIX PANEL DMA Display od mrcodetastic (3.1.0 a novější, starší SM5368 neumí), Adafruit GFX Library (nainstaluje se jako závislost) a ArduinoJson 7. PNGdec instalovat nemusíte. Je přibalený v projektu (verze 1.1.7 s větší pamětí na řádek), protože snímky ČHMÚ mají 680 px a do výchozí velikosti se nevejdou. Aktuální verze z Library Manageru je dokonce odmítne (chyba 7). QR kód je přibalený taky.
- Tools: deska ESP32S3 Dev Module, Flash Size 16MB, Partition Scheme 16M Flash (3MB APP/9.9MB FATFS) (dva sloty pro aplikaci, jinak nefunguje aktualizace přes web), PSRAM podle modulu nebo Disabled, USB CDC On Boot Disabled.
- Nahrávejte přes konektor UART, na stejném portu pak běží Serial Monitor (115 200 Bd).
Soubor pro aktualizaci přes web vyrobíte přes Sketch, Export Compiled Binary.
Co jde změnit v config.h
| Konstanta | K čemu je |
|---|---|
PIN_* | přiřazení 14 signálů HUB75 k GPIO |
PANEL_LINE_DECODER | řádkový budič: SM5368 pro panel V2, TYPE138 pro V1 |
PANEL_SWAP_RB | prohodí červenou a modrou, Waveshare V2 potřebuje 1 |
PANEL_CLK_PHASE | fáze hodin, když je obraz posunutý o bod |
PANEL_I2S_MHZ | rychlost dat do panelu, výchozí 8 MHz (16 MHz ruší WiFi) |
PANEL_DRIVE_STRENGTH | síla budičů pinů 0 až 3, výchozí 1. Nižší = pomalejší hrany a méně rušení, příliš slabá = špatné body na panelu |
DEFAULT_* | výchozí nastavení, použije se jen při prvním startu nebo po továrním nastavení |
DEBUG_ENABLED, DEBUG_CONSOLE | výpisy a ovládání přes Serial Monitor |
Zvolené GPIO se vyhýbají bootovacím pinům (0, 3, 45, 46), USB (19, 20), UART0 (43, 44), konektoru μŠup (2, 42, 47), měření baterie (9) a pinům octal PSRAM (35 až 37).
Jak to funguje uvnitř
Firmware běží na obou jádrech ESP32-S3 a nepotřebuje PSRAM. Panel, dekódování radaru i HTTPS spojení se vejdou do vnitřní RAM čipu.
- Jádro 1 (hlavní smyčka): stavový automat WiFi, webový server, výběr obrazovky a kreslení.
- Jádro 0 (síťová úloha s 16 kB zásobníkem): dotazy na adsb.fi, ČHMÚ, RainViewer a Open-Meteo. Výsledky publikuje do sdílené struktury
SkyDatachráněné mutexem. Stahování nikdy neblokuje displej ani web.
Radar na ESP32 bez PSRAM
Názvy snímků ČHMÚ obsahují čas, takže je firmware nehledá ve výpisu adresáře (ten má přes 300 kB), ale zkouší je přímo od nejnovějšího po pětiminutových krocích. Výpis adresáře zůstal jen jako záloha. Všechny snímky jdou přes jedno udržované HTTPS spojení (keep-alive) a mezi snímky dostanou slovo letadla, takže obrazovka letadla během stahování radaru nezamrzne.
Každé PNG se pak dekóduje knihovnou PNGdec po řádcích přímo během stahování přes posuvné okno 4 kB, celý soubor v paměti nikdy není.
Každý řádek se rovnou promítne do mřížky 96×48. Barvy ČHMÚ (u RainVieweru přes hodnotu dBZ) se převedou na 4bitový index stupnice, takže jeden snímek zabere 2 304 B a šest snímků animace necelých 14 kB. Na nejnovějším snímku se pak hledá déšť nad prahem v okruhu od vaší polohy.
Mapa Česka je předpočítaná z Natural Earth 1:10m v projekci Web Mercator, stejné jako u radarových snímků, takže hranice a srážky lícují bod na bod.
Čas bez NTP
Panel čas bere z hlavičky Date HTTPS odpovědí, které stejně stahuje, a převádí ho podle POSIX řetězce časového pásma (výchozí CET-1CEST,M3.5.0,M10.5.0/3). Když vypnete letadla, radar i předpověď, udělá kvůli času jeden malý dotaz každých 30 minut.
JSON API
Webová stránka panelu používá jednoduché JSON API. Stejně ho můžete volat ze skriptu, z Home Assistantu nebo z Node-RED.
| Metoda a cesta | Co dělá |
|---|---|
GET /api/status | čas, aktuální obrazovka a režim, WiFi, letadlo, radar, počasí, paměť |
GET /api/config | celé nastavení |
POST /api/config | změna nastavení, stačí poslat jen měněné položky |
POST /api/mode | režim: AUTO, ROTATE, CLOCK, FORECAST, RADAR, PLANE |
GET /api/export, POST /api/import | záloha a obnova nastavení |
POST /api/reboot, POST /api/reset | restart, tovární nastavení |
POST /update | nahrání firmwaru (.bin) |
Například přepnutí na radar a zvýšení denního jasu:
curl -X POST http://ledmatrix.local/api/mode -d '{"mode":"RADAR"}'
curl -X POST http://ledmatrix.local/api/config -d '{"brightDay":120}'
Názvy všech položek nastavení uvidíte v odpovědi GET /api/config.
Sériová konzole
V Serial Monitoru (115 200 Bd) panel vypisuje, co dělá: připojení, každý dotaz, počet letadel, stažené snímky radaru, volnou paměť. Jednoznakové příkazy: m přepíná režimy, r stáhne radar hned, + a - mění jas, l zkouší latch blanking proti blikání, d zkouší sílu budičů pinů proti rušení WiFi, i vypíše stav, h nápovědu.
Vlastní obrazovka
Kreslí se běžným Adafruit GFX API do plátna v RAM, panel se změní až po zavolání show():
Display::clear();
Display::gfx().setCursor(2, 2);
Display::gfx().setTextColor(rgb565(255, 160, 0));
Display::gfx().print("Ahoj");
Display::show(); // do panelu jdou jen zmenene body
Nová obrazovka znamená tři místa v kódu: kreslicí funkci v screens.cpp, položku ve výčtu Station::Mode a pravidlo, kdy se má ukázat, v station.cpp. Data ze sítě patří do síťové úlohy v fetcher.cpp a do SkyData, kreslení na ně nikdy nečeká.
Každý modul má jednu věc na starosti, takže se v kódu zorientujete rychle: adsb, chmu, rainviewer a forecast stahují data, net drží sdílené HTTPS spojení, screens kreslí, station vybírá obrazovku, web a web_page.h obsluhují nastavení, wifi_setup síť. Přehled všech souborů je v README.
Kód a licence
GitHub: github.com/petus/LED_Matrix_Panel
Kód je pod licencí MIT. Můžete ho použít, upravit i začlenit do vlastního projektu, jen v něm ponechte copyright a text licence. Pokud na něm postavíte něco vlastního, budu rád za odkaz na chiptron.cz nebo GitHub projektu.
Na data se licence kódu nevztahuje. Letadla jsou z adsb.fi a předpověď z Open-Meteo (CC BY 4.0), obojí zdarma pro nekomerční použití. Radar je z otevřených dat ČHMÚ, nebo z RainViewer (osobní a nekomerční použití), mapa z Natural Earth (public domain).
Projekt obsahuje dekódování PNG PNGdec 1.1.7 od Larryho Banka (Apache 2.0, uvnitř zlib), upravený kvůli větší paměti na řádek, a generátor QR kódů ricmoo/QRCode (MIT). Firmware dál používá knihovny ESP32-HUB75-MatrixPanel-DMA (MIT), Adafruit GFX (BSD) a ArduinoJson (MIT).
Jde o hobby projekt, dělám ho, protože mě to baví. Za funkčnost v budoucnu neručím, API třetích stran se mohou změnit.








Žádné sociální komentáře k dispozici.