Skróty: Releases · Dokumentacja · License
- Sterowanie CO
- włącz/wyłącz (tryb pracy CO)
- ustawienie temperatury zadanej CO
- histereza CO
- moc maksymalna (33/67/100)
- Sterowanie CWU
- tryb pracy CWU: Włączony / STOP / PRIORYTET
- ustawienie temperatury zadanej CWU
- histereza CWU
- Termostaty (Climate)
- Termostat CO (OFF/HEAT + temperatura)
- Termostat CWU (OFF/HEAT + temperatura + preset: Normalny/Priorytet)
- Sensory
- status pieca (%)
- temperatura wody CO / CWU (°C)
- energia – licznik (kWh) (jeśli dostępne w ramkach urządzenia)
- Integracja lokalna
- urządzenie wysyła status do Home Assistanta (push)
- niskie opóźnienia sterowania
- Logi “produkcyjne”
- czytelne logi po polsku
- Home Assistant (Core / Supervised / OS)
- Sieć lokalna (LAN)
- Możliwość zestawienia połączenia z urządzenia do Home Assistanta na wskazany port (domyślnie 1088)
Uwaga: Integracja uruchamia w HA lokalny serwer TCP. Jeśli HA działa w kontenerze, musisz zadbać o to, aby urządzenie mogło połączyć się z adresem HA i portem nasłuchu.
Integracja była weryfikowana w środowisku domowym na następującej konfiguracji:
- Moduł internetowy: Elterm WIZ108SR (instrukcja: https://www.elterm.pl/fileadmin//user_upload/Elterm_instrukcja_modulu_internetowego_2022.pdf)
- Kocioł elektryczny: Elterm Pułkownik (AsZN‑W) (produkt: https://www.elterm.pl/produkty/elektryczne-kotly-grzewcze-seria-zaawansowana-lcd/elektryczny-kociol-grzewczy-pulkownik)
Uwaga: inne modele/konfiguracje mogą mieć inny zestaw pól w ramkach statusu (np. dodatkowe/nieobecne klucze).
vIdorazvPintraktuj jak dane wrażliwe (nie publikuj w issue / screenshotach).- Integracja jest przeznaczona do pracy w sieci lokalnej.
- Rekomendacje:
- nie wystawiaj portu nasłuchu na Internet,
- ogranicz ruch (VLAN / firewall) tylko do urządzenia,
- jeśli to możliwe, użyj stałych adresów IP w LAN.
Aby urządzenie mogło wysyłać status i odbierać komendy z Home Assistanta, w ustawieniach kotła/sterownika skonfiguruj połączenie z HA:
- Ustaw Serwer na adres IP / nazwę hosta Home Assistanta w Twojej sieci LAN (Serwer = HA).
- Ustaw Port na 1088 (lub inny, jeśli zmieniłeś port nasłuchu w integracji).
- Zapisz ustawienia na piecu (i jeśli urządzenie tego wymaga — wykonaj restart).
Upewnij się, że urządzenie ma trasę do HA i że firewall/VLAN nie blokuje połączenia TCP na wybrany port.
- Skopiuj katalog
custom_components/lokalterm/do:/config/custom_components/lokalterm/ - Zrestartuj Home Assistanta.
- Przejdź do: Ustawienia → Urządzenia i usługi → Dodaj integrację → LokalTerm
- Uzupełnij konfigurację.
Ten projekt jest przygotowany pod HACS jako repozytorium niestandardowe.
- Otwórz HACS → Integrations
- Menu (⋮) → Custom repositories
- Dodaj repo:
- Repository:
https://github.com/drozdzszymon/lokalterm-ha - Category: Integration
- Repository:
- Zainstaluj integrację z HACS.
- Zrestartuj Home Assistanta.
- Dodaj integrację w UI (jak wyżej).
Podczas dodawania integracji pojawią się pola:
- Nazwa – nazwa urządzenia w HA (domyślnie:
LokalTerm) - ID urządzenia (vId)
- PIN urządzenia (vPin)
- Adres nasłuchu (domyślnie:
0.0.0.0) - Port nasłuchu (domyślnie:
1088)
Adres nasłuchuiPort nasłuchuto parametry serwera TCP uruchamianego w Home Assistant.
switch.lokalterm_co_enable— CO Włączoneselect.lokalterm_co_moc— CO Moc maksymalnanumber.lokalterm_co_temperatura_zadana— CO Temperaturanumber.lokalterm_co_histereza— CO Histerezanumber.lokalterm_cwu_temperatura_zadana— CWU Temperaturanumber.lokalterm_cwu_histereza— CWU Histerezaselect.lokalterm_cwu_tryb_pracy— CWU Tryb pracy
climate.lokalterm_termostat_co— Termostat COclimate.lokalterm_termostat_cwu— Termostat CWU (preset: Normalny/Priorytet)
sensor.lokalterm_status_pieca— Status piecasensor.lokalterm_temp_wody_co— Temperatura wody COsensor.lokalterm_temp_wody_cwu— Temperatura wody CWUsensor.lokalterm_energia_licznik_kwh— Energia - licznik (kWh) (jeśli dostępne)
Uwaga:
entity_idmogą się różnić, jeśli Home Assistant nadał je wcześniej lub jeśli były zmieniane ręcznie.
Zawsze sprawdzisz je w: Ustawienia → Urządzenia i usługi → Encje (wyszukajlokalterm).
W configuration.yaml dodaj:
logger:
default: info
logs:
custom_components.lokalterm: debugNastępnie zrestartuj Home Assistanta.
Uwaga: w logach DEBUG może pojawić się pełny payload zawierający
vId/vPin. Przed publikacją logów usuń te dane.
- Sprawdź czy urządzenie łączy się do HA na port nasłuchu (domyślnie 1088).
- Sprawdź logi: Ustawienia → System → Logi.
- Upewnij się, że adres HA jest osiągalny z urządzenia (routing/VLAN/firewall).
- Integracja wysyła komendy natychmiast, a potwierdzenie przychodzi w kolejnych ramkach statusu.
- Jeśli urządzenie nie potwierdzi zmian w określonym czasie, w logach pojawi się ostrzeżenie o timeout.
- Sprawdź, czy urządzenie nie ma ograniczeń co do częstotliwości zmian (bardzo szybkie klikanie w UI).
Najczęstsza przyczyna: urządzenie nie wysyła danego pola w ramce statusu (np. DHWTempAct).
Włącz DEBUG i sprawdź, czy pole jest obecne w danych statusu.
- UI konfiguracji (Config Flow) posiada tłumaczenia PL/EN (
translations/). - Nazwy encji i logi są domyślnie w języku polskim.
Tworząc Issue, dołącz:
- wersję Home Assistanta,
- wersję integracji,
- fragment logów bez danych wrażliwych,
- informację o sieci (VLAN/firewall) oraz port nasłuchu.
PR-y mile widziane. Prośba: nie zmieniaj logiki sterowania “w ciemno” — integracja jest wrażliwa na drobne zmiany. Najlepiej opisać zmianę, dodać logi i scenariusz testów.
Repozytorium jest udostępniane na licencji MIT — szczegóły znajdują się w pliku LICENSE.
Jeśli tworzysz fork lub dystrybucję, zachowaj informację o licencji oraz prawa autorskie zgodnie z warunkami MIT.