ESP32 TFT Dashboard — skonfiguruj panele przez przeglądarkę

Mark
Autor
ESP32 TFT Dashboard — skonfiguruj panele przez przeglądarkę

Podoba Ci się ten artykuł?

Tworzenie poradników zajmuje dużo czasu, a na stronie nie chce reklam. Jeśli pomogłem i masz na to ochotę — postaw mi kawę . To motywuje do dalszego pisania!

ESP32 TFT Dashboard — konfiguracja paneli i kafelków przez panel webowy
Weather, Power flow, Energy price, Universal, Doors & gates — wszystko przez przeglądarkę, bez YAML, bez kodu

Jak to działa

Panel webowy ESP32 to pełne centrum konfiguracji — wchodzisz przez przeglądarkę pod adresem IP wyświetlonym na ekranie i ustawiasz wszystko: panele, kafelki, MQTT, kolory, wyświetlacz. Bez edytowania plików, bez YAML, bez restartu HA.
Lewa kolumna to lista paneli — każdy panel to osobny ekran na TFT. Dashboard rotuje między nimi automatycznie co kilka sekund (czas możesz ustawić osobno dla każdego panelu). Kliknięcie panelu po lewej otwiera jego konfigurację po prawej.
Ważne: ESP32 zapisuje maksymalnie 8 paneli. Przy zapisie firmware wczytuje tylko pierwsze 8 z listy — jeśli masz więcej, kolejne są pomijane. Masz już 8 paneli? Usuń zbędny lub połącz treść na mniejszej liczbie ekranów.
Zielona kropka MQTT w górnym pasku — jak jest zielona, ESP32 jest połączony z brokerem i dane płyną. Czerwona — sprawdź konfigurację MQTT z artykułu 2.

Dodawanie i zarządzanie panelami

Pod listą paneli w lewej kolumnie znajdziesz przycisk + Dodaj panel. Po kliknięciu wybierasz typ panelu — każdy typ ma inny układ i inne pola konfiguracji.
Universal
Siatka kafelków 1 lub 2 kolumny. Dowolne dane z HA.
Weather
Pogoda z encji HA — aktualny stan i prognoza 5 dni.
Power flow
Przepływ energii PV → dom → sieć → bateria → EV.
Energy price
Wykres cen energii 24h z oznaczeniem tanich okien.
Doors & gates
Do 8 sensorów binarnych — bramy, drzwi, okna, zamki.
Charts
Wykresy historii — wykres liniowy lub słupkowy.
YouTube & site
Statystyki kanału YouTube i odwiedziny strony.
NAS monitor
Monitoring Synology DSM lub podobnego NAS.
Kolejność paneli na liście po lewej określa kolejność rotacji na TFT. Strzałki ▲▼ przy każdym panelu pozwalają zmieniać kolejność. Po skonfigurowaniu wszystkiego klikasz Zapisz i wyślij do ESP32 na dole strony — ESP32 restartuje się i wczytuje nową konfigurację.
Panel webowy ESP32 TFT Dashboard — lista paneli w lewej kolumnie

Panel Universal — kafelki z dowolnymi danymi

Universal to najbardziej elastyczny typ panelu — siatka kafelków w 1 lub 2 kolumnach, każdy kafelek to jedna encja z HA. Możesz mieszać typy: temperatura, wykres, wskaźnik, binarny stan, zegar — wszystko na jednym ekranie.
W konfiguracji panelu ustawiasz: Nazwę (wyświetlaną na TFT), liczbę kolumn (1 lub 2), opcję Zegar w statusbarze i Interwał rotacji w sekundach. Następnie dodajesz kafelki przyciskiem + Dodaj kafelek.
Ustawienia wyświetlacza ESP32
Jak dodać kafelek
1
Kliknij + Dodaj kafelek — pojawi się nowy kafelek na liście, kliknij go żeby rozwinąć konfigurację
2
W zakładce Podstawowe wpisz Etykietę (np. „Temperatura”) i Topic MQTT — najprościej skopiować go z integracji TFT Dashboard w HA przy dodawaniu encji (krok 3, adres MQTT pokazany przy encji)
3
Ustaw Jednostkę (np. °C, W, %) i liczbę Decimali po przecinku
4
W prawym górnym rogu kafelka widzisz Podgląd TFT — miniatura pokazuje jak kafelek będzie wyglądał na ekranie jeszcze przed zapisem
Skąd wziąć topic MQTT? Najprościej w HA przy dodawaniu encji do integracji TFT Dashboard — interfejs pokazuje adres MQTT który ma być wpisany tutaj. Alternatywnie: Narzędzia deweloperskie → Stan → znajdź encję → typowy topic to np. homeassistant/sensor/nazwa/state lub z prefiksem tft/ zależnie od ustawień integracji.
Zakładki konfiguracji kafelka
Podstawowe
Etykieta, typ kafelka (sensor, binary, gauge, chart_line, chart_bar, clock, text_block), topic MQTT, jednostka, decimale
Kolory
Kolor wartości, etykiety, tła kafelka, progi warn/crit dla gauge — wszystko w palecie RGB565
Ikony
Wybór ikony MDI z dostępnej biblioteki ikon wbudowanej w firmware
Zaawansowane
Dodatkowe opcje zależnie od typu kafelka — np. progi alarmowe, odwrócenie logiki binary, zakres wykresu

Panel Weather — pogoda z Home Assistant

Najprostsza konfiguracja ze wszystkich paneli — wpisujesz jeden topic MQTT i gotowe. Panel sam pobiera aktualny stan pogody i prognozę z encji HA.
W polu Topic MQTT pogody wpisz adres stanu encji weather z HA — np. tft/weather. Pamiętaj żeby dodać tę encję do integracji TFT Dashboard w HA, bo inaczej dashboard nie będzie jej publikował na MQTT.
Poniżej topicu znajdziesz paletę kolorów ikon pogody — możesz wybrać kolor tła dysku (ikony warunkowej pogody) i obręczu. Domyślne ustawienia wyglądają dobrze, możesz je zostawić.
Integracja OpenWeatherMap w HA — dodaje lokalizację i tworzy encję weather — to jest polecany topic tutaj. Link do integracji znajdziesz bezpośrednio w konfiguracji tego panelu.

Panel Power flow — przepływ energii

Panel dla wszystkich z fotowoltaiką lub magazynem energii. Animowany schemat pokazuje przepływ mocy między PV, domem, siecią, baterią i opcjonalnie EV lub klimatyzacją — wszystko na bieżąco.
Konfiguracja to zestaw topiców MQTT — osobno dla każdego węzła schematu. Dla każdego wpisujesz adres encji z HA którą integracja TFT Dashboard publikuje na MQTT:
PV
Moc produkcji z paneli słonecznych (W lub kW)
Dom
Zużycie energii przez dom (W lub kWh)
Pobrana z sieci
Pobór mocy z sieci energetycznej
Oddana do sieci
Eksport nadwyżki PV do sieci
Bateria
Moc ładowania/rozładowania magazynu energii
SOC %
Stan naładowania baterii w procentach
Ważna opcja: Skala mocy. Domyślnie 1 = wartość już w watach. Jeśli Twoje encje HA podają moc w kilowatach (jak FoxESS/HA — np. 2.5 = 2500 W), ustaw skalę na 1000. Możesz też włączyć opcję Dom / Pobrana / Oddana — wartości w kWh jeśli Twoje encje podają energię zamiast chwilowej mocy.
Konfiguracja panelu Power flow — topiki PV, dom, sieć, bateria, SOC

Panel Energy price — ceny energii RCE

Wykres 24h cen energii z oznaczonymi tanimi oknami — przydatny jeśli masz taryfę dynamiczną RCE. Ten panel nie używa kafelków — cała konfiguracja to dwa topiki MQTT i kilka opcji wykresu.
Topic MQTT — cena
Encja z aktualną ceną lub tablicą cen na dziś. Skalar lub JSON z polem state / prices_today. Dla RCE polecana integracja ha_rce.
Topic „tanio” (opcja)
Binary sensor z HA_RCE — oznacza tanie godziny na wykresie. Np. ha/binary_sensor/...
Punkty wykresu
Domyślnie 24 — godziny doby. Możesz zmienić jeśli Twoja encja podaje inne okno czasowe.
Jednostka
Wyświetlana na ekranie — np. zł/kWh
Konfiguracja panelu Energy price — topic ceny i opcje wykresu

Panel Doors & gates — bramy, drzwi, okna

Jeden rzut oka na ekran i wiesz czy wszystkie bramy są zamknięte. Panel wyświetla do 8 sensorów binarnych z ikonkami — każdy to osobne wejście z podpisem.
Dla każdego sensora konfigurujesz: Topic MQTT, Podpis (np. „Garage 1”), Ikonę (garaż, brama wjazdowa, drzwi do domu, furtka, okno) i opcjonalnie Odwróć logikę jeśli sensor ma odwrotną polaryzację. Możesz też włączyć Powiadomienie pełnoekranowe przy zmianie stanu — wtedy otwarcie bramy wyświetla alert na całym ekranie TFT.
Firmware automatycznie pokazuje odpowiednią grafikę — przy stanie on/open wyświetla ikonę „otwarte”, przy closed/off — „zamknięte”. Wybierz typ sensora z listy (garaż, brama, drzwi, furtka, okno) żeby ikona pasowała.
Konfiguracja panelu Doors & gates — Garage 1, Garage 2, Door, Gate

Panel Charts — wykresy historii

Panel wykresów działa jak Universal — dodajesz kafelki, ale każdy kafelek to wykres liniowy (chart_line) lub słupkowy (chart_bar). ESP32 zbiera historię wartości w pamięci RAM od chwili uruchomienia — im dłużej działa, tym więcej danych widać na wykresie.
Każdy kafelek wykresu konfiguruje się tak samo jak sensor — etykieta, topic MQTT, jednostka — z tym że typ ustawiasz na chart_line (wykres liniowy, dobry do temperatury) lub chart_bar (słupkowy, dobry do mocy PV godzinowej lub produkcji energii).
Uwaga: historia wykresu jest trzymana w RAM ESP32 — po restarcie urządzenia dane są tracone i wykres zaczyna się od nowa. To ograniczenie sprzętowe ESP32, nie błąd.
Panel Charts — kafelki Temp Out (chart_line) i Temp In (chart_bar)

Ustawienia wyświetlacza i systemu

W sekcji Wyświetlacz (lewy panel, dół) znajdziesz kilka przydatnych opcji:
Jasność
Suwak — reguluje podświetlenie TFT. Warto zmniejszyć jeśli wyświetlacz jest zbyt jasny w nocy.
Obrót ekranu
0° / 90° / 180° / 270° — jeśli obraz jest do góry nogami, zmień tutaj. Domyślnie 180° dla ST7789.
Tryb ciemny
Włączony domyślnie. Ciemne tło, jasny tekst — lepiej wygląda na TFT w warsztacie.
Strefa czasowa
String POSIX TZ — dla Polski: CET-1CEST-2,M3.5.0/2,M10.5.0/3. Ważne dla poprawnego wyświetlania czasu i przełączania lato/zima.
Buzzer
Włącz/wyłącz sygnał dźwiękowy, głośność (czas trwania impulsu) i rodzaj sygnału (krótki / długi). Przycisk Test sprawdza buzzer od razu bez zapisu.
Ustawienia wyświetlacza ESP32 — jasność, obrót, strefa czasowa, buzzer
System — backup i akcje
Zakładka System zawiera status ESP32 (IP, RSSI, heap, uptime, MQTT sub/RX), opcję Backup i restore (pobierz/wgraj config jako JSON — warto zrobić przed każdą większą zmianą), aktualizację firmware OTA przez plik .bin oraz przyciski akcji: Restart ESP32, Zmień sieć WiFi i Ustawienia fabryczne.
Rób backup regularnie — JSON z konfiguracją zajmuje kilka kB i możesz go zaimportować po flashu nowego firmware bez konfigurowania wszystkiego od nowa.

Zapisz i wyślij do ESP32

Kiedy skończysz konfigurację kliknij Zapisz i wyślij do ESP32 na dole strony. Panel webowy zniknie na chwilę — ESP32 restartuje się i wczytuje nowe ustawienia. Po kilku sekundach dashboard pojawi się na ekranie z nową konfiguracją.
Przed zapisem zrób backup — System → Pobierz backup. Zajmuje 5 sekund i oszczędza dużo czasu jeśli coś pójdzie nie tak.
Masz inne panele albo pytania o konkretny typ kafelka? Napisz w komentarzu.

Społeczność MarkLabs

Dyskutuj na forum

Pytania, doświadczenia i rozwiązania do tego artykułu publikujemy teraz na forum MarkLabs.

Otwórz dyskusję na forum

Wymagane jest bezpłatne konto MarkLabs. Dotychczasowe komentarze bloga nie są przenoszone.

buycoffee.to