Integracja zużycia wody w Home Assistant

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:

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.

1. 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.
2. 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ę).
3. 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).

Projekt obudowy 3d

Projekt umieszczam na printables.com – z biegiem czasu będę umieszczał kolejne wersje projektu.

Wideoporadnik