Integracja kotła KOSPEL EKCO.M3 i modułu CM.I z Home Assistant

Zakładam, że jeżeli tu trafiłeś, to sam kocioł masz już podłączony i działający, tak samo jak moduł CM.I

Moduł CM.I, może pracować zarówno w trybie chmurowym jak i lokalnym, przy czym, jeżeli masz podłączony moduł do chmury Kospel, to w Twojej sieci jest on również widoczny pod lokalnym adresem IP.

Aby zacząć integrację, musimy odszukać IP modułu CM.I. Po wejściu na jego adres, JavaScript zaszyty w kodzie strony odpyta podłączone urządzenie i doklei do adresu odpowiedni numer. Dla mojego kotła M3 numer ten to 65.

Zatem wchodząc np na: http://10.1.78.230 wylądujemy na http://10.1.78.230/65.

Jest to ważne, ponieważ numer ten jest używany w API modułu.

Adres API to http://10.1.78.230/api/dev/65/0b2f/30 gdzie możemy podejrzeć JSON z numerami rejestrów płytki sterującej wewnątrz kotła oraz ich wartościami.

Jeżeli mamy właściwy adres i potwierdzone działające API, możemy użyć je w Home Assistant za pomocą platformy REST w sekcji sensor

sensor:

  - platform: rest
    name: CMI
    resource: http://10.1.78.230/api/dev/65/0b2f/30
    json_attributes:
      - regs
    value_template: "OK"

Następnie za pomocą platformy template możemy poprzeliczać wartości rejestrów:

- platform: template
    sensors:
      temp_wlot:
        friendly_name: "Temperatura wlotowa"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b48'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: temperature
        unit_of_measurement: "°C"
      temp_wylot:
        friendly_name: "Temperatura wylotowa"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b49'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: temperature
        unit_of_measurement: "°C"
      nastawa_czynnika:
        friendly_name: "Temperatura czynnika"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b44'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: temperature
        unit_of_measurement: "°C"
      temp_pok:
        friendly_name: "Temperatura w pokoju"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b4b'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: temperature
        unit_of_measurement: "°C"
      temp_zewn:
        friendly_name: "Temperatura zewnętrzna"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b4c'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: temperature
        unit_of_measurement: "°C"
      moc:
        friendly_name: "Moc"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b46'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: power
        unit_of_measurement: "kW"
      cisnienie:
        friendly_name: "Ciśnienie"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b4e'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 100}}"
        device_class: pressure
        unit_of_measurement: "bar"
      przeplyw:
        friendly_name: "Przepływ wody"
        value_template: "{% set value = state_attr('sensor.cmi', 'regs')['0b4f'] %}{% set str= value[2:4] + value[0:2] %}{% set resultInt = str | int(base=16) %}{% if resultInt | bitwise_and(0x8000) > 0 %}{% set resultInt = resultInt - 0x10000 %}{% endif %}{{resultInt | float / 10}}"
        device_class: gas
        unit_of_measurement: "L"

Jeżeli wszystko się waliduje, to możemy już zdefinowanych nowych sensorów użyć w Home Assistant to pokazywania aktualnych wartości.

Warto dodatkowo zintegrować smart termostaty - polecam takie od Tuya, lub dowolny wariant TS0601 - dla potrzeb HA i integracji sterującej mają najwięcej możliwości.

Do sterowania temperaturą w pokojach polecam nie polegać na wewnętrznych pomiarach w termostatach ponieważ są one mocno niedokładne oraz ciężko je skonfigurować w Home Assistant. Natomiast rewelacyjną alternatywą, która robi wszystko to co sam termostat, ale dodatkowo korzysta z zewnętrznych czujników pokojowych temperatury i wilgotności, czujników temp. zewnętrznej (np. ten od Kospela), oraz integracji pogodowych czy czujników otwarcia okien - Better Thermostat: https://github.com/KartoffelToby/better_thermostat, wraz z dodatkową karta dla UI: https://github.com/KartoffelToby/better-thermostat-ui-card

Integracja jest na razie w wersji beta w repozytorium HACS, ale u mnie sprawdza sie rewelacyjnie.

Polecane komponenty zewnętrzne:

Jeżeli będzie zainteresowanie, mogę napisać w kolejnych postach jak skonfigurować termostaty oraz Better Thermostat, tak aby znacząco oszczędzić energię używaną do ogrzania domu przez kocioł elektryczny.