{"id":12960,"date":"2026-09-10T18:25:00","date_gmt":"2026-09-10T16:25:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=12960"},"modified":"2026-10-24T06:15:04","modified_gmt":"2026-10-24T04:15:04","slug":"tutorial-publikowanie-komunikatu-mqtt-discovery-ktory-trafia-do-panelu-energii","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/smart-home-pl\/tutorials-pl-smart-home-pl\/tutorial-publikowanie-komunikatu-mqtt-discovery-ktory-trafia-do-panelu-energii\/","title":{"rendered":"Tutorial: Publikowanie komunikatu MQTT Discovery, kt\u00f3ry trafia do panelu energii"},"content":{"rendered":"

MQTT Discovery opisuje czujnik w Home Assistant. Osobny temat przenosi odczyty. Panel energii korzysta nast\u0119pnie z odpowiednich danych i statystyk. Ka\u017cdy etap wymaga osobnej kontroli: poprawny JSON nie gwarantuje dzia\u0142aj\u0105cej encji ani wykresu energii.<\/p>\n

1. Najpierw okre\u015blenie mierzonej wielko\u015bci<\/h2>\n

Przyk\u0142ad dotyczy skumulowanego poboru energii elektrycznej w kWh. Licznik zwykle ro\u015bnie, lecz mo\u017ce rozpocz\u0105\u0107 ponownie od zera, dlatego pasuje tu total_increasing<\/code>. Licznik ca\u0142kowitego zu\u017cycia bez reset\u00f3w mo\u017ce korzysta\u0107 z total<\/code> bez last_reset<\/code>. Licznik bilansuj\u0105cy, kt\u00f3rego warto\u015b\u0107 ro\u015bnie i maleje, wymaga innego traktowania; total_increasing<\/code> b\u0142\u0119dnie interpretowa\u0142oby rzeczywiste spadki.<\/p>\n

Moc w W opisuje chwilowe tempo przep\u0142ywu energii, a energia w kWh \u2014 zgromadzon\u0105 ilo\u015b\u0107. Aktualne wersje Home Assistant obs\u0142uguj\u0105 r\u00f3wnie\u017c odpowiednie czujniki mocy w polach mocy panelu: device_class: power<\/code> z state_class: measurement<\/code>. Zmiana etykiety W na kWh nie przelicza warto\u015bci.<\/p>\n

\"Cztery
Cztery kontrole od Discovery do panelu energii<\/figcaption><\/figure>\n

2. Publikacja poprawnej konfiguracji czujnika<\/h2>\n

Warunki wst\u0119pne to dost\u0119pny broker, skonfigurowana integracja MQTT i w\u0142\u0105czone Discovery z w\u0142a\u015bciwym prefiksem. Przyk\u0142ad dla pojedynczego komponentu u\u017cywa homeassistant\/sensor\/example_meter_import\/config<\/code>. Identyfikatory w temacie Discovery dopuszczaj\u0105 litery, cyfry, podkre\u015blenia i \u0142\u0105czniki, a nie dowolny tekst.<\/p>\n

Plik energy-discovery.json<\/code> opisuje fikcyjny licznik. Sta\u0142y identyfikator musi pozosta\u0107 unikalny w instalacji. Nazwa wy\u015bwietlana mo\u017ce zmienia\u0107 si\u0119 niezale\u017cnie.<\/p>\n

{\n  "name": "Imported energy",\n  "state_topic": "example\/meter\/import_kwh",\n  "unique_id": "example_meter_import",\n  "device_class": "energy",\n  "unit_of_measurement": "kWh",\n  "state_class": "total_increasing",\n  "expire_after": 900,\n  "device": {\n    "identifiers": [\n      "example_meter"\n    ],\n    "name": "Example meter"\n  }\n}<\/code><\/pre>\n
state_topic<\/code> jest wymagany dla czujnika MQTT. Pozosta\u0142e pola zale\u017c\u0105 od potrzebnej funkcji. Unikalny identyfikator umo\u017cliwia zarz\u0105dzanie przez rejestr encji i pokazane powi\u0105zanie z urz\u0105dzeniem; nie stanowi og\u00f3lnego wymogu panelu energii. Discovery urz\u0105dzenia przez wsp\u00f3lny komunikat device<\/code> u\u017cywa innego formatu z dodatkowymi polami obowi\u0105zkowymi.<\/p>\n
3. Dost\u0119pna konfiguracja i \u015bwie\u017ce odczyty<\/h2>\n
Przyk\u0142ad zachowuje konfiguracj\u0119 u brokera przez Retain. Alternatyw\u0105 jest ponowne wys\u0142anie Discovery po komunikacie startowym Home Assistant, zwykle online<\/code> w temacie homeassistant\/status<\/code>. Po Discovery potrzebne s\u0105 r\u00f3wnie\u017c aktualne stany. Retain jest sposobem dostarczania danych, a nie obowi\u0105zkowym polem ani gwarancj\u0105 zapisu na dysku na wypadek awarii brokera.<\/p>\n
Poni\u017csze polecenia wymagaj\u0105 klient\u00f3w Mosquitto w wersji co najmniej 2.1, poniewa\u017c korzystaj\u0105 z -o<\/code>. Plik mqtt-client.conf<\/code> zawiera adres brokera, ustawienia TLS i dane logowania jako opcje, po jednej w wierszu. Ograniczone uprawnienia pliku chroni\u0105 dane dost\u0119powe; has\u0142o nie trafia do wiersza polece\u0144. W starszych wersjach alternatyw\u0105 jest domy\u015blny plik konfiguracji klienta. Plik nie mo\u017ce zawiera\u0107 opcji Retain dla publikacji stan\u00f3w.<\/p>\n
mosquitto_pub -o .\/mqtt-client.conf -q 1 -r \\\n  -t homeassistant\/sensor\/example_meter_import\/config \\\n  -f energy-discovery.json\nmosquitto_pub -o .\/mqtt-client.conf -q 1 \\\n  -t example\/meter\/import_kwh -m '1234.500'\nmosquitto_pub -o .\/mqtt-client.conf -q 1 \\\n  -t example\/meter\/import_kwh -m '1234.625'<\/code><\/pre>\n
Najpierw wykonywane jest tylko polecenie konfiguracji. Przed wys\u0142aniem obu odczyt\u00f3w encja i subskrypcja stanu musz\u0105 by\u0107 gotowe; udana publikacja nie dowodzi przetworzenia Discovery. Podczas migracji trzeba r\u00f3wnie\u017c usun\u0105\u0107 istniej\u0105cy zachowany odczyt z tematu stanu. Kolejne komunikaty bez Retain nie kasuj\u0105 starszej zachowanej warto\u015bci.<\/p>\n
R\u00f3\u017cnica mi\u0119dzy przyk\u0142adowymi odczytami wynosi 0,125 kWh. Przyk\u0142ad jest przeznaczony dla odizolowanego czujnika testowego; fikcyjne odczyty nie powinny trafi\u0107 do historii rzeczywistego licznika. Publikacja powinna odbywa\u0107 si\u0119 regularnie, z zapasem wobec ustawionego czasu wa\u017cno\u015bci 900 sekund.<\/p>\n
Komunikaty stanu celowo pomijaj\u0105 -r<\/code>. Przy expire_after<\/code> stary zachowany odczyt m\u00f3g\u0142by wr\u00f3ci\u0107 po prze\u0142adowaniu i ponownie wygl\u0105da\u0107 na \u015bwie\u017cy. Komunikaty dost\u0119pno\u015bci Birth i Will mog\u0105 dodatkowo sygnalizowa\u0107 utrat\u0119 po\u0142\u0105czenia. Nie dowodz\u0105 aktualno\u015bci fizycznego pomiaru.<\/p>\n
4. Osobna kontrola ka\u017cdego etapu<\/h2>\n