Deweloperzy Home Assistant poświęcili ostatnio sporo uwagi panelowi energii, dodając dedykowaną zakładkę do analizy zużycia wody. Dlaczego warto to zrobić? Od momentu, gdy zacząłem śledzić koszty wody u siebie, zacząłem znacznie bardziej zwracać uwagę na ten aspekt domowego budżetu. Dziś pokażę Wam, jak zintegrować nakładkę licznika Apator bezpośrednio z Home Assistantem, wykorzystując niezawodny układ ESP32, moduł CC1101 i najnowszą, stabilną wersję komponentu WM-Bus.
Co będzie potrzebne?
Zanim przejdziemy do działania, upewnij się, że masz przygotowane niezbędne elementy.
Sprzęt:
- Płytka ESP32 DevKit: Polecam wersję z portem USB-C dla wygody. Uwaga: Jeśli masz stare układy ESP8266, w tym projekcie ich nie użyjemy – nowa wersja komponentu wymaga ESP32, który jest szybszy i w pełni wspierany.
- Moduł CC1101 (868 MHz): To kluczowy element, który odbierze sygnał radiowy z nakładki Apator.
- Przewody połączeniowe (Jumper wires): Warto mieć ich zapas.
- Zasilacz USB-C 5V.
- Licznik wody: Apator AT-WMBUS-16-2 lub inny model zgodny z protokołem WM-Bus.
Oprogramowanie:
- Home Assistant oraz dodatek ESPHome (do zainstalowania ze sklepu z dodatkami).
- Sterowniki CH340 (linki znajdziesz w sekcji pobierania).
Krok 1: Podłączenie elektroniki (Schemat)
To najważniejszy moment całej operacji. Moduł CC1101 posiada 8 pinów, które musimy połączyć z ESP32.
⚠️ Bardzo Ważne: Zasilanie modułu CC1101 (Pin VCC) podłączamy wyłącznie do 3.3V na płytce ESP32. Podłączenie do 5V może trwale uszkodzić moduł!.
Oto rozpiska połączeń, która zapewni poprawną komunikację SPI:
| Pin CC1101 | Pin ESP32 | Funkcja |
| VCC | 3.3V | Zasilanie |
| GND | GND | Uziemienie |
| MOSI | GPIO23 | Master Out, Slave In |
| MISO | GPIO19 | Master In, Slave Out |
| CLK | GPIO18 | Zegar |
| CS | GPIO15 | Chip Select |
| GDO0 | GPIO4 | Wyjście cyfrowe |
| GDO2 | GPIO27 | Wyjście cyfrowe |
Jeśli zasięg Twojego modułu okaże się niewystarczający (np. licznik jest w piwnicy), rozważ dolutowanie gniazda SMA i użycie zewnętrznej anteny. Pozwala to zwiększyć zasięg z kilkunastu do kilkudziesięciu metrów.
Krok 2: Konfiguracja ESPHome (Kod)
Poniżej znajdziesz gotową konfigurację YAML dla ESPHome. Wykorzystujemy tu komponent wmbus w wersji 4, która rozwiązała problemy z kompatybilnością występujące w ESPHome 2025.8.
W sekcji sensor musisz uzupełnić meter_id (numer swojego licznika) oraz key (klucz szyfrujący).
- Nie znasz klucza? W 99% przypadków jest to po prostu trzydzieści zer. Jeśli nie, szukaj go w dokumentacji od operatora.
- Masz więcej liczników? Jeden moduł CC1101 obsłuży je wszystkie – wystarczy dodać kolejne bloki w sekcji sensor.
Pobierz kod:
YAML
captive_portal:
time:
- platform: sntp
id: time_sntp
external_components:
- source: github://SzczepanLeon/esphome-components@version_4
components: [ wmbus ]
wmbus:
mosi_pin: GPIO23
miso_pin: GPIO19
clk_pin: GPIO18
cs_pin: GPIO15
gdo0_pin: GPIO4
gdo2_pin: GPIO27
frequency: 868.950
all_drivers: False
sync_mode: True
log_all: True
sensor:
- platform: wmbus
meter_id: 0x1043295
type: apator162
key: "00000000000000000000000000000000"
sensors:
- name: "ZimnaWoda"
field: "total"
accuracy_decimals: 3
unit_of_measurement: "m³"
device_class: "water"
state_class: "total_increasing"
icon: "mdi:water"
- name: "ZimnaWoda RSSi"
field: "rssi"
accuracy_decimals: 0
unit_of_measurement: "dBm"
device_class: "signal_strength"
state_class: "measurement"
entity_category: "diagnostic"
FAQ i Diagnostyka
Podczas instalacji mogą pojawić się pytania. Oto odpowiedzi na te najczęstsze, które dostaję od Was w wiadomościach prywatnych.
- Czy mogę zasilać układ z powerbanku?Tak. Aby oszczędzać energię, warto wtedy wgrać firmware „offline” (przez kartę SD, jeśli masz taką możliwość), aby nie zużywać prądu na ciągłą transmisję WiFi przy aktualizacjach20.
- Jak sprawdzić czy mam dobry zasięg?Sprawdź encję RSSI w diagnostyce Home Assistant.
- -40 do -70 dBm: Doskonały zasięg.
- -70 do -90 dBm: OK.
- Poniżej -90 dBm: Słaby zasięg (rozważ lepszą antenę).
- Co robić w przypadku problemów z debugowaniem?W nowej wersji komponentu możesz włączyć pełne logowanie (log_all: True) dynamicznie z poziomu Home Assistanta, bez konieczności ponownego wgrywania całego kodu22.
Podsumowanie
Po wgraniu oprogramowania i konfiguracji panelu energii, zyskujesz pełny wgląd w zużycie wody w czasie rzeczywistym. To nie tylko gadżet – wiedza o tym, ile kosztuje jedna kąpiel, potrafi skutecznie zmotywować do zmiany nawyków (np. częstsze wybieranie prysznica zamiast wanny).
