Nieoficjalna integracja Home Assistant dla sterowników kotłów Compit MULTI 765 / 765G podłączonych do chmury Compit iNext (bramka iNext). Odczyt pełnego stanu kotła, bezpieczny zapis wybranych nastaw oraz opcjonalne sterowanie pogodowe liczone w HA.
⚠️ Projekt niezależny, niezwiązany z firmą Compit. Używasz na własną odpowiedzialność. Zmiana nastaw kotła na paliwo stałe może wpłynąć na jego pracę i bezpieczeństwo – zawsze kieruj się instrukcją (DTR) swojego kotła.
Karta „Kocioł Compit” dołączona do integracji: temperatura kotła i powrotu, zadana z przyciskami −/+, sterowanie pogodowe, podajnik, opał w kg, spalanie i termin dosypania.
- Czujniki: temperatura kotła, temperatura powrotu, poziom paliwa (%), stan pomp CO/CWU, diagnostyczna lista wszystkich parametrów sterownika (~119).
- Nastawy (zapis): temperatura zadana kotła, obroty wentylatorów (PID moc MAX/MIN,
wentylator 2), czasy cyklu, podtrzymanie, temperatura powrotu MIN, histereza,
przejście w podtrzymanie, pojemność zasobnika, praca z podajnikiem.
- Zakresy są celowo węższe niż w sterowniku.
- Przed zapisem sprawdzane są reguły z DTR (np. moc MAX > moc MIN, czas cyklu Pmin ≥ Pmax + 60 s).
- Przycisk „Odśwież ze sterownika” – odpowiednik „Pobierz grupę” w panelu iNext.
- Sterowanie pogodowe (opcjonalne):
zadana = zadana przy 0 °C − nachylenie × T_zew (średnia 2 h), w granicach min–max, z obniżeniem wg dowolnej encji (harmonogram, input_boolean…) i korektą od termostatów. Zapis do sterownika tylko przy zmianie ≥ 2 °C i nie częściej niż co 30 min. - Opał: węgiel w zasobniku (kg), średnie spalanie (kg/h, kg/doba), termin dosypania i moment opróżnienia zasobnika – liczone w HA od ostatniego dosypania, więc prognoza nie „pływa”. Pojemność zasobnika uczy się sama po wpisaniu, ile kg dosypano.
- Profile mocy: 4 gotowe zestawy nastaw PID (łagodnie / normalnie / mróz / duży mróz) i fabryczny z DTR, wybór ręczny albo automatyczny wg średniej temperatury zewnętrznej z 6 h.
- Ponowne logowanie po zmianie hasła, diagnostyka bez danych logowania,
usługa
compit_multi765.dump_parameters.
- Ustawienia → Katalog społeczności. Przy pierwszym otwarciu przeczytaj i zaakceptuj komunikat.
- Połącz konto GitHub w katalogu – bez tego nie da się dodać repozytorium z linku.
- Dodaj z linku → wklej
https://github.com/xtronets/ha-compit-multi765. - Zainstaluj Compit MULTI 765 (iNext) i zrestartuj Home Assistant.
- HACS → ⋮ → Custom repositories →
https://github.com/xtronets/ha-compit-multi765, typ Integration. - Zainstaluj Compit MULTI 765 (iNext) i zrestartuj Home Assistant.
Jeśli integracja była zainstalowana przez HACS, po aktualizacji do 2026.11 zostanie automatycznie przeniesiona do katalogu społeczności.
Skopiuj katalog custom_components/compit_multi765 do config/custom_components/
i zrestartuj Home Assistant.
- Ustawienia → Urządzenia i usługi → Dodaj integrację → Compit MULTI 765.
- Zaloguj się tym samym kontem co na
inext.compit.pli wybierz sterownik. - (Opcjonalnie) Konfiguruj przy integracji – wybierz własne encje:
| Opcja | Co wybrać |
|---|---|
| Temperatura zewnętrzna | dowolny czujnik temperatury lub encja pogody (weather.*); °F przeliczane na °C |
| Źródło zapasowe | drugi czujnik / pogoda, gdy główne jest niedostępne |
| Encja obniżenia | np. pomocnik Harmonogram (schedule.*), input_boolean, binary_sensor, switch – stan on = obniżenie |
| Termostaty | encje climate.* (np. Better Thermostat, TRV); liczy się hvac_action: heating |
Bez czujnika zewnętrznego przełącznik Sterowanie pogodowe nie da się włączyć, a reszta integracji działa normalnie.
| Encja | Domyślnie | Opis |
|---|---|---|
| Krzywa: zadana przy 0 °C | 62 °C | punkt odniesienia krzywej |
| Krzywa: nachylenie | 0,6 | o ile °C rośnie zadana na każdy 1 °C mrozu |
| Krzywa: minimum | 58 °C | twarda dolna granica (także po obniżeniu i korekcie) |
| Krzywa: maksimum | 72 °C | górna granica |
| Obniżenie wg harmonogramu | 3 °C | gdy encja obniżenia = on |
| Korekta od głowic | 2 °C | −, gdy ≤ 1 termostat grzeje przez 15 min; +, gdy ≥ 60 % grzeje przez 30 min |
Encja Zadana wyliczona (pogodowa) pokazuje wynik krzywej także przy wyłączonym sterowaniu – możesz najpierw obserwować, potem włączyć.
Profil to zestaw czterech nastaw PID: obroty wentylatora MAX/MIN i czas cyklu MAX/MIN. Dłuższy cykl = rzadsze podawanie opału = mniej żaru na palenisku. Krótszy cykl i wyższy nadmuch = więcej mocy na mróz.
| Profil | Domyślnie dla T_zew (średnia 6 h) | Wentylator MAX / MIN | Cykl MAX / MIN |
|---|---|---|---|
| Łagodnie | powyżej 5 °C | 31 / 20 % | 270 / 430 s |
| Normalnie | −5 … 5 °C | 31 / 20 % | 250 / 400 s |
| Mróz | −12 … −5 °C | 33 / 22 % | 230 / 380 s |
| Duży mróz | poniżej −12 °C | 34 / 23 % | 220 / 360 s |
| Fabryczny (DTR) | tylko ręcznie | 40 / 22 % | 190 / 320 s |
„Fabryczny (DTR)” to nastawy producenta z instrukcji Carbo 1 (tabela 8.3, 25 kW) – punkt startu lub powrót do ustawień fabrycznych; automat nigdy go nie wybiera. Dla innej mocy kotła wpisz wartości z tabeli w DTR.
Pozostałe wartości domyślne pochodzą z kotła Kotrem Carbo 1 25 kW na ekogroszku. Dostrój je do swojego kotła (encje „Profil …” w sekcji Konfiguracja urządzenia) – zmiana wartości aktywnego profilu trafia od razu do sterownika.
- Profil mocy (select) – wybór ręczny; wyłącza tryb automatyczny.
- Profil mocy: auto wg pogody – dobiera profil sam: średnia z 6 h, histereza 2 °C wokół każdego progu, najwyżej jedna zmiana na 3 h. Wymaga czujnika temperatury zewnętrznej w opcjach integracji.
- Progi między profilami: encje „Profil: próg …” (°C).
- Nastawy są zapisywane w kolejności zgodnej z DTR (wentylator MAX > MIN, cykl MIN ≥ cykl MAX + 60 s).
- Atrybuty encji wyboru: średnia temperatura, sugerowany profil, czy sterownik ma nastawy profilu
(
matches_controller–false, gdy ktoś zmienił je ręcznie), ostatnia zmiana i jej powód.
Integracja sama dodaje do Home Assistanta kartę dashboardu – nie trzeba instalować card-mod ani kopiować kodu.
- Otwórz dashboard → Edytuj → Dodaj kartę → wyszukaj „Kocioł Compit”.
- Wybierz sterownik (przy jednym sterowniku wybierze się sam), opcjonalnie wpisz tytuł i podtytuł.
Albo w YAML:
type: custom:compit-boiler-card
# device: <id urządzenia> # opcjonalnie, gdy masz kilka sterowników
title: Kocioł węglowy
subtitle: Carbo 1 · 25 kW| Element karty | Działanie |
|---|---|
| Kocioł, temperatury, opał, powrót | otwiera historię danej encji |
| − / + przy zadanej | zmienia zadaną o 1 °C; przy włączonym sterowaniu pogodowym przesuwa krzywą grzewczą |
| POGODA | włącza/wyłącza sterowanie pogodowe (widoczne, gdy skonfigurowane) |
| PODAJNIK | włącza/wyłącza pracę z podajnikiem – z potwierdzeniem |
Animacje: płomień w wizjerze (mocniejszy przy pracy, słabszy w podtrzymaniu), dym z komina, wentylator, ruch szuflady podajnika, przepływ w rurach zasilania i powrotu, poziom węgla w zasobniku. Teksty po polsku lub angielsku – zależnie od języka użytkownika HA.
Po aktualizacji integracji odśwież przeglądarkę (Ctrl+F5), żeby wczytać nową wersję karty.
Sterownik zna tylko poziom paliwa w %. Liczy go z czasu pracy podajnika i parametru „Pojemność zasobnika” (minuty). Integracja dokłada do tego:
| Encja | Opis |
|---|---|
| Węgiel w zasobniku | kg = poziom % × pojemność zasobnika (kg) / 100 |
| Średnie spalanie | kg/h od ostatniego dosypania; atrybuty: %/h, kg/doba, źródło |
| Termin dosypania | kiedy poziom spadnie do progu dosypania |
| Zasobnik pusty | kiedy poziom spadnie do 0 % |
| Pojemność zasobnika (kg) | ile węgla mieści pełny zasobnik (konfiguracja) |
| Próg dosypania | domyślnie 10 % (konfiguracja) |
| Dosypano węgla | wpisz, ile kg dosypałeś – służy do kalibracji |
Jak to działa
- Dosypanie jest wykrywane samo, gdy poziom w sterowniku skoczy o co najmniej 10 pkt %. Od tej chwili liczone jest nowe średnie spalanie.
- Przez pierwsze 6 h po dosypaniu używane jest spalanie z poprzedniego cyklu (przy pierwszym uruchomieniu: wartość domyślna 1,2 %/h).
Kalibracja – krok po kroku
- Ustaw Pojemność zasobnika (kg) na przybliżoną wartość (np. liczba worków × 20 kg).
- Przy każdym dosypaniu: dosyp węgiel, ustaw w sterowniku poziom zasobnika (tak jak zwykle), a potem w HA wpisz w Dosypano węgla ile kg wsypałeś. Kolejność nie ma znaczenia – wpis czeka do 6 h na skok poziomu i odwrotnie.
- Integracja porówna kg ze wzrostem poziomu w % i poprawi pojemność zasobnika (pierwszy pomiar wprost, kolejne uśredniane). Po 2–3 dosypaniach prognoza jest dokładna.
Dostrojenie sterownika („Pojemność zasobnika” w minutach)
- Sterownik pokazuje 0 %, a w zasobniku jest jeszcze węgiel → zwiększ minuty.
- Węgiel kończy się, zanim sterownik pokaże 0 % → zmniejsz minuty.
- Zmieniaj o 5–10 % i obserwuj przez pełny cykl zasobnika. Dopiero gdy sterownik trafia w „pusty”, kalibracja kg w HA ma sens.
- Odczyt podstawowy co 2 min (API mobilne iNext), pełny stan co 10 min (panel WWW iNext).
- Zmiana nastawy trafia do sterownika przez chmurę z opóźnieniem ok. 1–2 min.
- Testowane na: Compit MULTI 765G + kocioł Kotrem Carbo 1 (podajnik szufladowy, ekogroszek).
Inne sterowniki iNext mogą mieć inne kody parametrów – zgłoś zrzut z usługi
dump_parametersw Issues.
MIT
