Chytré hodiny na kulatém 2,1″ displeji pro Home Assistant nebo i bez něj

Stručně: Stručně: Waveshare Hodiny jsou české open-source firmware pro desku Waveshare ESP32-S3-Touch-LCD-2.1, které na kulatém displeji 480 × 480 ukazují čas, datum, počasí, hodnoty ze senzorů a srážkový meteoradar ČHMÚ. Firmware nahrajete z prohlížeče přes USB, Wi-Fi zadáte přes Improv Serial nebo QR kódem na displeji a všechno ostatní nastavíte ve webovém rozhraní zařízení. Data berou z open-meteo bez účtu, z vlastních čidel na TMEP.cz nebo z Home Assistantu – tam stačí long-lived access token a ID entit, žádné MQTT ani vlastní integrace. Aktuální verze je 1.8.2, kód je pod licencí MIT.

Kulatý displej Waveshare ESP32-S3-Touch-LCD-2.1 má u nás nakročeno stát se malým bastlířským standardem. Vedle radaru letadel na něm teď běží další povedený český projekt: Waveshare Hodiny od Ondřeje.

Je to informační dashboard pro Home Assistant. Velké digitální hodiny s českým datem, vteřinovým prstencem, animovanou ikonou počasí a k tomu dvě místnosti s teplotou a dvě volitelné veličiny, třeba CO₂, VOC, vlhkost nebo tlak. Přes den barevně, v noci se celý displej přepne do červené a ztlumí, aby v ložnici nerušil.

A pokud Home Assistant nemáte, můžete počasí a hodnoty použít ze služby open-meteo, stačí zadat vaše město. A pokud měříte doma po svém, přihodíte k tomu vlastní čidla z TMEP.cz – stačí vložit URL exportu a hodnoty naskočí do stejných výběrů.

Hlavní výhodou je, že se nic nekompiluje ani neprogramuje. Vzhled, entity, jas i barevné škály se nastavují ve webovém rozhraní přímo v zařízení.

Stejná deska jako MeteoPlaneRadar

Pokud vám ta deska přijde povědomá, máte pravdu. Přesně stejný kus hardwaru používá i MeteoPlaneRadar, tedy radar letadel a srážkový meteoradar ČHMÚ na jednom kulatém displeji.

Prakticky to znamená jednu příjemnou věc: když už desku doma máte, můžete si na ni jen nahrát jiný firmware a vyzkoušet, co vám vedle monitoru dává větší smysl. A hodí se i stejná 3D tištěná krabička – stojánek.

Co si musíte pořídit

  • desku Waveshare ESP32-S3-Touch-LCD-2.1 (PájeníčkoLaskaKit),
  • datový USB-C kabel,
  • počítač s prohlížečem Chrome nebo Edge (Web Serial),
  • běžící Home Assistant v téže domácí síti nebo využít data ze služby open-meteo.

Nic se nepájí ani nedrátuje, displej i mikrokontrolér jsou na jedné desce. Autor výslovně upozorňuje, že firmware je určený jen pro tento model. Jiná deska s ESP32-S3 má jiný pinout i rozdělení flash paměti a nemusí fungovat.

Co všechno musíte nainstalovat a zprovoznit

Vlastní instalace má pět kroků a jde zvládnout za pár minut. Poslední dva patří jen těm, kdo hodiny napíchnou na Home Assistant – bez něj končíte třetím krokem.

1. Nahrání firmware. Otevřete instalační stránku projektu, připojte desku USB-C kabelem a vyberte sériový port. Instalátor nahraje všechny části na správné adresy. Tlačítko je už aktivní, stabilní release na GitHubu vyšel. Kdo si raději sestaví firmware sám, potřebuje Arduino CLI, ESP32 core 3.0.7, LVGL 8.3.10 a PNGdec 1.0.1. Počítejte s tím, že první čistá instalace může vymazat uložená data zařízení.

2. Wi-Fi přes Improv Serial. Veřejný firmware neobsahuje žádné přednastavené údaje. Síť zadáte hned po instalaci ve stejné stránce, uloží se do trvalé NVS paměti. Fungují oba USB-C konektory, tedy USB-UART přes CH343P i nativní USB.

3. Otevření webové konfigurace. Po připojení se na displeji objeví IP adresa. V prohlížeči otevřete http://waveshare-hodiny.local/, případně přímo tu IP adresu, pokud vám v síti nefunguje mDNS.

4. Token z Home Assistantu, pokud ho používáte. V Home Assistantu jděte do svého uživatelského profilu, sekce Long-lived access tokens, vytvořte nový token a vložte ho do webové konfigurace spolu s adresou Home Assistantu. Tlačítkem Otestovat připojení si ověříte, že to spolu mluví. Token se po uložení už zpátky do prohlížeče neposílá, jde jen přepsat. Když změníte adresu Home Assistantu, musíte zadat i nový token.

5. Vyplnění entit, opět jen s Home Assistantem. ID entit se zadávají ručně, žádný výběr ze seznamu tu není. Prakticky potřebujete tyhle:

ÚdajPříklad entityPoznámka
Počasíweather.domovtextový stav HA nebo číselný kód
Sluncesun.sunřídí automatický denní a noční režim
Venkovní teplotasensor.venkovni_teplotalibovolný číselný senzor
Pokojová teplotasensor.obyvak_teplotalibovolný číselný senzor
Hodnota A a Bsensor.obyvak_co2CO₂, VOC, PM, vlhkost, tlak a další

Neplatná nebo nedostupná hodnota se na displeji zobrazí jako --. Když se to stane, zkontrolujte entitu ve Vývojářských nástrojích – Stavy, jestli je její stav opravdu číselný.

A co nepotřebujete: MQTT, žádnou vlastní integraci, žádný doplněk z HACS ani administrátorský účet. Firmware si entity čte přes REST API Home Assistantu.

A celý tenhle krok s tokenem a entitami můžete klidně přeskočit. Bez Home Assistantu si hodiny vezmou počasí z open-meteo a vaše vlastní hodnoty z TMEP.cz.

Aktualizace 15. 9. 2026

Od srpna firmware pořádně povyrostl. Veřejná verze je teď 1.8.2 a přibylo toho tolik, že to chce vlastní kapitolu.

Meteoradar ČHMÚ přímo na hodinách. Swipe do strany a místo času naběhne srážkový kompozit MAX_Z s obrysem republiky a městy. Pět pohledů: 25, 50, 100 a 200 km kolem uložené polohy, nebo celá ČR. Animace od jednoho do patnácti snímků, pauza na konci, čas toho nejaktuálnějšího zeleně.

V noci radar nezhasne, jen zčervená. Jednotlivé stupně odrazivosti si zachovají rozlišení, takže i v červené poznáte, kde padá víc.

Jedna věc potěší méně. Radar běží jen pro polohy, které Open-Meteo označí kódem země CZ – za hranicemi se nenačte, nereaguje na gesta a vypne střídání obrazovek. U dat ČHMÚ se těžko divit.

A poznámka, ze které mám radost: autor v poděkování píše, že část kódu radaru i mapové podklady převzal z MeteoPlaneRadaru. Přesně kvůli tomuhle má smysl zveřejňovat zdrojáky.

Tři ciferníky místo jednoho. K digitálnímu přibyl analogový a Retro LCD se segmentovým časem. Swipe nahoru, swipe dolů, přepínáte je přímo na displeji. Digitál si navíc vybírá ze čtyř fontů: Barlow, Liberation Sans, LCD DSEG a Doto.

Předpověď na samostatné obrazovce. Dvanáct hodin dopředu, teploty, větší ikony a plynulý teplotní přechod po obvodu displeje. Střídání hodin, předpovědi a radaru má teď vlastní časy, nula obrazovku vynechá.

Home Assistant je oficiálně nepovinný. Open-Meteo je výchozí zdroj, bez účtu a bez tokenu. Vybrané město přitom nastaví tři věci naráz – časové pásmo hodin, místo pro počasí a střed radaru. Platí to i když data tažíte z HA.

Vlastní čidla z TMEP.cz. Vložíte URL rozšířeného JSON exportu, dáte ověřit a až dvaatřicet čidel naskočí do stejných výběrů jako hodnoty z Open-Meteo. Jednotku si firmware vezme z exportu, takže si poradí i s vlastními veličinami.

Wi-Fi přes QR kód. Když Improv Serial přeskočíte nebo se uložená síť nepřipojí, hodiny vyhodí QR kód a otevřou vlastní captive portál. Nové údaje navíc přepíšou ty staré až po úspěšném připojení, o funkční konfiguraci se tedy nepřipravíte.

Zámek na webové konfiguraci. Konečně. Heslo o šesti až dvaceti znacích, stav bez hesla svítí v záložce Systém červeně. Přibyla i samostatná stránka /diagnostics, která zůstane dostupná i při zamčeném webu, a šifrovaná záloha .whbackup. Wi-Fi v záloze není, ta se při obnově nemění.

Ovládací API pro Home Assistant. URL s náhodným 128bitovým secretem, REST příkazem vynutíte aktualizaci dat nebo zhasnete podsvícení. Berte ji jako heslo, do screenshotů nepatří.

Odkazy

Ptáte se

Potřebuji Home Assistant?

Ne. Bez Home Assistantu si hodiny vezmou počasí ze služby open-meteo, stačí zadat vaše město. Vlastní naměřené hodnoty k tomu přidáte z TMEP.cz.

Jaký hardware potřebuji?

Desku Waveshare ESP32-S3-Touch-LCD-2.1, datový USB-C kabel a počítač s prohlížečem Chrome nebo Edge kvůli Web Serial. Nic se nepájí ani nedrátuje, displej i mikrokontrolér jsou na jedné desce.

Musím něco kompilovat nebo programovat?

Ne. Firmware nahrajete přímo z prohlížeče přes instalační stránku projektu. Vzhled, entity, jas i barevné škály se pak nastavují ve webovém rozhraní přímo v zařízení.

Umí hodiny zobrazit meteoradar?

Ano, od verze 1.6.0. Firmware zobrazuje srážkový kompozit MAX_Z z otevřených dat ČHMÚ s obrysem republiky a městy, v pohledech 25, 50, 100 a 200 km nebo na celou ČR. Radar se ale spustí jen pro polohy v České republice.

Jaké ciferníky jsou k dispozici?

Tři: digitální se čtyřmi fonty, analogový s nastavitelným barevným tónem a Retro LCD se segmentovým časem. Přepínají se swipem nahoru a dolů přímo na displeji, trvalý ciferník se ukládá přes web.

Potřebuji MQTT nebo doplněk z HACS?

Ne. Firmware si entity čte přes REST API Home Assistantu. Nepotřebujete MQTT, vlastní integraci, doplněk z HACS ani administrátorský účet. Stačí long-lived access token z uživatelského profilu.

Funguje firmware i na jiné desce s ESP32-S3?

Firmware je určený jen pro model Waveshare ESP32-S3-Touch-LCD-2.1. Jiná deska s ESP32-S3 má jiný pinout i rozdělení flash paměti a nemusí fungovat. Autor na to výslovně upozorňuje.

Na displeji se místo hodnoty zobrazuje jen pomlčka. Co s tím?

Zkontrolujte entitu ve Vývojářských nástrojích v sekci Stavy, jestli je její stav opravdu číselný. Neplatná nebo nedostupná hodnota se na displeji zobrazí jako dvě pomlčky.

Má displej noční režim?

Ano. Displej se přes den zobrazuje barevně, v noci se přepne do červené a ztlumí, aby v ložnici nerušil. Do červené se převede i meteoradar včetně stupňů odrazivosti. Denní i noční jas lze doladit přímo na displeji dlouhým stiskem dashboardu.

Jak fungují aktualizace?

Firmware používá A/B rozdělení flash paměti se dvěma 6MiB oddíly. Nová verze se zapisuje do neaktivního slotu a před aktivací se kontroluje velikost, SHA-256 i rodina čipu. Když něco nesedí, zůstane běžet stávající verze. Automatické aktualizace jsou po instalaci vypnuté.

Dá se deska použít i pro jiný projekt?

Ano. Přesně stejný kus hardwaru používá i projekt MeteoPlaneRadar, tedy radar letadel a srážkový meteoradar ČHMÚ. Stačí nahrát jiný firmware a hodí se i stejná 3D tištěná krabička.
Sdílejte článek:
Komentáře:
2 komentářů na sociálních sítích
Super projekt od @brejda a displeje jsou skladem 😉 ...více
Číst komentáře
- a -
Přidat svůj názor
Tričko Chiptron s potiskem Trust me, I'm a maker
Ukaž světu,
že jsi Maker!
Koupit tričko
Kafe pro Chiptrona
Dodej energii dalšímu článku
Buy Me a Coffee

Související články

MeteoPlaneRadar ve verzi 0.7.0. Na kulatém 2,1″ displeji hodiny, letadla z adsb.fi, srážkový meteoradar ČHMÚ nebo RainViewer, předpověď, spotová cena elektřiny a energetický mix. Všechno se nastavuje v prohlížeči, firmware nahrajete bez programování.

Vytvořit informační displej pro ESPHome není úplně jednoduchá zábava. Každá změna znamená úpravu YAMLu, nahrání do zařízení a čekání, jestli to konečně vypadá tak, jak jste chtěli. Přesně tohle se snaží řešit nástroj ESPHome Designer.

Viděl jsem desku ESP32 s velkým 3.

Pokud vás někdy napadlo, co je za letadlo, které právě přelétá nad vaším domem, pravděpodobně jste sáhli po některé z mobilních aplikací typu FlightRadar24. Projekt ESP32 Plane Radar ale přináší zajímavější řešení – vlastní stolní radar postavený na ESP32, který…

Chtěl jsem vědět, co mi zrovna letí nad hlavou – jakože letadla. Ne v mobilu, ne v další záložce prohlížeče – na malé kulaté věci na polici, vedle monitoru, na kterou se jen mrknu.

Meteostanice na LaskaKit ESPink-4.26, která nepotřebuje internet ani cloud. Sama rozpozná připojená čidla, kreslí grafy na e-paper a nastavíte ji přes USB nebo WiFi z telefonu. Aktualizace: nová verze podporující i SEN63C, SEN66 a nově i čtyř grafy na displeji.…

Trendy