Näe mitä kaukolämpösäätimesi tekee
Ouman H23 -kaukolämpösäätimen tiedot Home Assistantiin Modbus-väylän kautta, selkokielisellä tilalla, lämmityskäyrällä ja hälytysilmoituksilla.
- Julkaistu
- Taso
- Edistynyt
- Laitteet
- Ouman H23 -säädin, Modbus TCP–RTU-yhdyskäytävä
Moni kaukolämpökeskus toimii Ouman H23 -säätimellä. Se hoitaa tehtävänsä hyvin, mutta kaikki sen tieto on teknisen tilan pienen näytön takana: meno- ja paluuveden lämpötilat, mihin säädin pyrkii, kuinka auki venttiili on ja odottaako jokin hälytys.
Tämä projekti lukee kaiken tämän Home Assistantiin säätimen Modbus-portin kautta. Saat lukemat dashboardille, historiakäyrät ja ilmoituksen, kun säädin hälyttää tai lakkaa vastaamasta.
Projekti vain lukee. Mikään tässä ei muuta säätimen asetuksia, ja lämmitys toimii täsmälleen kuten ennenkin.

Mitä se tekee
- Näyttää lämmityspiirin yhdellä silmäyksellä. Meno-, paluu- ja tavoitelämpötila, venttiilin asento, lämpötilan pudotus piirissä ja paljonko huonekompensointi siirtää tavoitetta.
- Näyttää käyttövesipuolen. Käyttöveden meno- ja kiertolämpötila, asetusarvo, venttiilin asento ja paljonko kiertovesi jäähtyy.
- Lukee lämmityskäyrän. Käyrän viisi pistettä ja menoveden rajat, joten näet mitä säädin tekee kullakin ulkolämpötilalla.
- Kertoo tilanteen selkokielellä. Dashboardin ylin rivi sanoo “Lämmitys toimii normaalisti”, “Kesäsulku” tai nimeää aktiivisen hälytyksen.
- Ilmoittaa. Pieni blueprint ilmoittaa, kun jokin säätimen hälytys aktivoituu tai säädin ei ole vastannut viiteen minuuttiin. Valitset itse miten: oletuksena Home Assistantin ilmoitus, tai esimerkiksi kriittinen hälytys puhelimeen.
Mitä tarvitset
- Ouman H23 -säätimen. Alla olevat rekisteriosoitteet ovat Oumanin virallisesta H23 v2.0.1 -Modbus-rekisterilistasta.
- Modbus TCP–RTU-yhdyskäytävän (RS-485–Ethernet-muunnin), joka on kytketty säätimen RS-485-porttiin. Itse käytän Wavesharen RS485 TO POE ETH (B) -laitetta. Sen voi syöttää Ethernet-kaapelin kautta (PoE) tai 6–36 V:n tasavirtalähteellä; omani toimii erillisellä virtalähteellä. Mikä tahansa Modbus TCP:n Modbus RTU:ksi muuttava yhdyskäytävä käy.
- Home Assistantin Modbus-integraation, joka määritellään YAML:lla.

Vaihe 1: yhdyskäytävä
Aseta yhdyskäytävä Modbus TCP -palvelintilaan porttiin 502 ja sovita sen sarjaliikenneasetukset säätimen Modbus-asetuksiin. Anna yhdyskäytävälle kiinteä osoite lähiverkossa. Paketissa säätimen Modbus-osoite (slave) on 1; vaihda se, jos omasi on eri.
Vaihe 2: paketti
Tallenna paketti nimellä config/packages/ouman_h23.yaml. Paketti luo Modbus-sensorit, muutaman lasketun arvon ja binäärisensorin jokaiselle hälytykselle. Yhdyskäytävän osoite laitetaan secrets.yaml-tiedostoon:
ouman_host: 192.168.1.50Näytä paketti
# Ouman H23 district heating controller over Modbus: read-only monitoring.# Save as config/packages/ouman_h23.yaml (packages must be enabled in configuration.yaml).## Connection: a Modbus TCP-to-RTU gateway (RS-485 to Ethernet) wired to the H23's RS-485 port.# Put the gateway's address in secrets.yaml, for example: ouman_host: 192.168.1.50 Register addresses follow the official# H23 v2.0.1 Modbus register list. Values are 32-bit, read here as the low 16-bit word,# which covers every value this package uses.## L1 = heating circuit 1, DHW = domestic hot water.# This package only reads. Nothing here writes to the controller.# Alarm and connection notifications: blueprint heating_controller_watchdog.yaml.## Some unique_ids are in Finnish: they come from the first version of this package and# are kept so that upgraded installs keep their entity IDs and history.
modbus: - name: ouman_h23 type: tcp host: !secret ouman_host port: 502 delay: 1 timeout: 5
sensors: # ---------- Measurements ---------- - name: Ouman outdoor temperature unique_id: ouman_h23_ulko slave: 1 address: 201 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
- name: Ouman L1 supply temperature unique_id: ouman_h23_l1_meno slave: 1 address: 203 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
- name: Ouman L1 return temperature unique_id: ouman_h23_l1_paluu slave: 1 address: 205 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
- name: Ouman DHW supply temperature unique_id: ouman_h23_lv_meno slave: 1 address: 215 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
- name: Ouman DHW circulation temperature unique_id: ouman_h23_lv_kierto slave: 1 address: 217 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
# ---------- Control ---------- - name: Ouman L1 supply setpoint unique_id: ouman_h23_l1_asetus_laskennall slave: 1 address: 285 # calculated supply water setpoint input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
- name: Ouman L1 setpoint from curve unique_id: ouman_h23_l1_kayra slave: 1 address: 287 # supply water according to the heating curve input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement
- name: Ouman L1 valve position unique_id: ouman_h23_l1_venttiili_asento slave: 1 address: 613 input_type: holding data_type: int16 unit_of_measurement: '%' state_class: measurement
- name: Ouman L1 summer shutdown raw unique_id: ouman_h23_l1_kesasulku slave: 1 address: 293 # 1 = summer shutdown active input_type: holding data_type: uint16
- name: Ouman DHW setpoint unique_id: ouman_h23_lv_asetus slave: 1 address: 593 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement - name: Ouman DHW valve position unique_id: ouman_h23_lv_venttiili slave: 1 address: 225 input_type: holding data_type: int16 unit_of_measurement: '%' state_class: measurement
- name: Ouman delayed outdoor temperature unique_id: ouman_h23_ulko_hidastettu slave: 1 address: 279 # the smoothed outdoor value the controller actually uses input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C device_class: temperature state_class: measurement scan_interval: 60
# ---------- L1 heating curve (whole degrees, read every 10 min) ---------- # The end points are fixed at -20 °C and +20 °C outdoors.
# How much room compensation is shifting the supply setpoint right now - name: Ouman L1 room compensation effect unique_id: ouman_h23_l1_huonekomp_vaikutus slave: 1 address: 289 input_type: holding data_type: int16 scale: 0.1 precision: 1 unit_of_measurement: °C state_class: measurement scan_interval: 60 - name: Ouman L1 curve point 1 supply unique_id: ouman_h23_l1_kayra_out1 slave: 1 address: 502 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 2 outdoor unique_id: ouman_h23_l1_kayra_in2 slave: 1 address: 504 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 2 supply unique_id: ouman_h23_l1_kayra_out2 slave: 1 address: 506 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 3 outdoor unique_id: ouman_h23_l1_kayra_in3 slave: 1 address: 508 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 3 supply unique_id: ouman_h23_l1_kayra_out3 slave: 1 address: 510 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 4 outdoor unique_id: ouman_h23_l1_kayra_in4 slave: 1 address: 512 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 4 supply unique_id: ouman_h23_l1_kayra_out4 slave: 1 address: 514 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 curve point 5 supply unique_id: ouman_h23_l1_kayra_out5 slave: 1 address: 516 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 supply minimum unique_id: ouman_h23_l1_meno_min slave: 1 address: 518 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600 - name: Ouman L1 supply maximum unique_id: ouman_h23_l1_meno_max slave: 1 address: 520 input_type: holding data_type: int16 unit_of_measurement: °C scan_interval: 600
# ---------- Alarms (raw; bit 0 = active) ---------- - name: Ouman alarm raw DHW high temperature unique_id: ouman_h23_alarm_lv_ylalampo slave: 1 address: 532 input_type: holding data_type: uint16 - name: Ouman alarm raw L1 supply deviation unique_id: ouman_h23_alarm_l1_poikkeama slave: 1 address: 533 input_type: holding data_type: uint16 - name: Ouman alarm raw L1 return low unique_id: ouman_h23_alarm_l1_paluu_ala slave: 1 address: 674 input_type: holding data_type: uint16 - name: Ouman alarm raw sensor M1 outdoor unique_id: ouman_h23_alarm_m1 slave: 1 address: 643 input_type: holding data_type: uint16 - name: Ouman alarm raw sensor M2 L1 supply unique_id: ouman_h23_alarm_m2 slave: 1 address: 644 input_type: holding data_type: uint16 - name: Ouman alarm raw sensor M3 L1 return unique_id: ouman_h23_alarm_m3 slave: 1 address: 645 input_type: holding data_type: uint16 - name: Ouman alarm raw sensor M8 DHW supply unique_id: ouman_h23_alarm_m8 slave: 1 address: 650 input_type: holding data_type: uint16 - name: Ouman alarm raw sensor M9 DHW circulation unique_id: ouman_h23_alarm_m9 slave: 1 address: 651 input_type: holding data_type: uint16
template: - sensor: # Supply minus return: how much heat the radiators or floor loops take out - name: Ouman L1 temperature drop unique_id: ouman_h23_l1_dt unit_of_measurement: °C state_class: measurement state: > {{ (states('sensor.ouman_l1_supply_temperature') | float - states('sensor.ouman_l1_return_temperature') | float) | round(1) }} availability: > {{ has_value('sensor.ouman_l1_supply_temperature') and has_value('sensor.ouman_l1_return_temperature') }}
# Measured supply minus setpoint: positive = warmer than asked - name: Ouman L1 control error unique_id: ouman_h23_l1_saatovirhe unit_of_measurement: °C state_class: measurement state: > {{ (states('sensor.ouman_l1_supply_temperature') | float - states('sensor.ouman_l1_supply_setpoint') | float) | round(1) }} availability: > {{ has_value('sensor.ouman_l1_supply_temperature') and has_value('sensor.ouman_l1_supply_setpoint') }}
# Hot water supply minus circulation return: heat lost in the circulation loop - name: Ouman DHW temperature drop unique_id: ouman_h23_lv_dt unit_of_measurement: °C state_class: measurement state: > {{ (states('sensor.ouman_dhw_supply_temperature') | float - states('sensor.ouman_dhw_circulation_temperature') | float) | round(1) }} availability: > {{ has_value('sensor.ouman_dhw_supply_temperature') and has_value('sensor.ouman_dhw_circulation_temperature') }}
- binary_sensor: - name: Ouman L1 summer shutdown unique_id: ouman_h23_bs_l1_kesasulku state: "{{ states('sensor.ouman_l1_summer_shutdown_raw') | int(0) == 1 }}"
- name: Ouman alarm DHW high temperature unique_id: ouman_h23_bs_lv_ylalampo device_class: problem state: "{{ states('sensor.ouman_alarm_raw_dhw_high_temperature') | int(0) % 2 == 1 }}" - name: Ouman alarm L1 supply deviation unique_id: ouman_h23_bs_l1_poikkeama device_class: problem state: "{{ states('sensor.ouman_alarm_raw_l1_supply_deviation') | int(0) % 2 == 1 }}" - name: Ouman alarm L1 return low unique_id: ouman_h23_bs_l1_paluu_ala device_class: problem state: "{{ states('sensor.ouman_alarm_raw_l1_return_low') | int(0) % 2 == 1 }}" - name: Ouman sensor fault M1 outdoor unique_id: ouman_h23_bs_m1 device_class: problem state: "{{ states('sensor.ouman_alarm_raw_sensor_m1_outdoor') | int(0) % 2 == 1 }}" - name: Ouman sensor fault M2 L1 supply unique_id: ouman_h23_bs_m2 device_class: problem state: "{{ states('sensor.ouman_alarm_raw_sensor_m2_l1_supply') | int(0) % 2 == 1 }}" - name: Ouman sensor fault M3 L1 return unique_id: ouman_h23_bs_m3 device_class: problem state: "{{ states('sensor.ouman_alarm_raw_sensor_m3_l1_return') | int(0) % 2 == 1 }}" - name: Ouman sensor fault M8 DHW supply unique_id: ouman_h23_bs_m8 device_class: problem state: "{{ states('sensor.ouman_alarm_raw_sensor_m8_dhw_supply') | int(0) % 2 == 1 }}" - name: Ouman sensor fault M9 DHW circulation unique_id: ouman_h23_bs_m9 device_class: problem state: "{{ states('sensor.ouman_alarm_raw_sensor_m9_dhw_circulation') | int(0) % 2 == 1 }}"
# No answer from the controller for 5 minutes - name: Ouman connection lost unique_id: ouman_h23_bs_offline device_class: problem state: "{{ not has_value('sensor.ouman_outdoor_temperature') }}" delay_on: minutes: 5
- name: Ouman any alarm unique_id: ouman_h23_bs_any_alarm device_class: problem state: > {{ ['binary_sensor.ouman_alarm_dhw_high_temperature', 'binary_sensor.ouman_alarm_l1_supply_deviation', 'binary_sensor.ouman_alarm_l1_return_low', 'binary_sensor.ouman_sensor_fault_m1_outdoor', 'binary_sensor.ouman_sensor_fault_m2_l1_supply', 'binary_sensor.ouman_sensor_fault_m3_l1_return', 'binary_sensor.ouman_sensor_fault_m8_dhw_supply', 'binary_sensor.ouman_sensor_fault_m9_dhw_circulation'] | select('is_state', 'on') | list | count > 0 }}Paketit otetaan käyttöön kerran configuration.yaml-tiedostossa:
homeassistant: packages: !include_dir_named packagesModbusin ensimmäinen käyttöönotto vaatii Home Assistantin uudelleenkäynnistyksen. Sen jälkeen muutokset latautuvat ilman sitä kohdasta Kehitystyökalut → YAML → Modbus.
Vaihe 3: ilmoitukset
Ilmoitukset tulevat blueprintistä, joten ne otetaan käyttöön ja niitä muutetaan käyttöliittymässä. Valitse hälytyssensoriksi binary_sensor.ouman_any_alarm ja yhteyssensoriksi binary_sensor.ouman_connection_lost, ja valitse mitä kummassakin tapauksessa tapahtuu.
Tuo blueprint Home Assistantiin(avautuu uuteen välilehteen)Katso GitHubissa(avautuu uuteen välilehteen)
Näytä blueprint
blueprint: name: Heating controller alarm and connection watchdog author: Automate the North description: > Notifies when a heating controller raises an alarm or stops answering. Made for the Ouman H23 package, but works with any pair of binary sensors: one that is on while any alarm is active, and one that is on while the connection is lost.
By default it creates a Home Assistant notification. Replace the actions with your own, for example a phone notification or a script that sends a critical alert. source_url: https://github.com/automate-the-north/home-assistant/blob/main/blueprints/automation/automate_the_north/heating_controller_watchdog.yaml domain: automation input: alarm: name: Alarm sensor description: A binary sensor that is on while any controller alarm is active. selector: entity: filter: - domain: binary_sensor connection_lost: name: Connection lost sensor description: A binary sensor that is on while the controller doesn't answer. selector: entity: filter: - domain: binary_sensor on_alarm: name: Actions on alarm default: - action: persistent_notification.create data: title: Heating controller alarm message: The heating controller reports an active alarm. Check the controller. selector: action: {} on_connection_lost: name: Actions when the connection is lost default: - action: persistent_notification.create data: title: Heating controller not answering message: >- No answer from the heating controller. Heating keeps running on the controller's own control, but Home Assistant can't see it. selector: action: {}
mode: queuedmax: 10
triggers: - trigger: state id: alarm entity_id: !input alarm to: 'on' - trigger: state id: connection_lost entity_id: !input connection_lost to: 'on'
actions: - choose: - conditions: - condition: trigger id: alarm sequence: !input on_alarm - conditions: - condition: trigger id: connection_lost sequence: !input on_connection_lostItse käytän skriptiä, joka lähettää puhelimeen kriittisen hälytyksen. Se menee läpi, vaikka puhelin olisi äänettömällä.
Vaihe 4: dashboard
Osio käyttää vain Home Assistantin omia kortteja: tilarivin, kuusi ruutua ja 24 tunnin käyrän meno-, tavoite-, paluu- ja ulkolämpötilasta. Lisää Sections-näkymään osio, avaa Muokkaa YAML:na ja liitä:
Näytä dashboardin YAML
# Ouman H23:n dashboard-osio. Sections-näkymässä: lisää osio → ⋮ → Muokkaa YAML:na ja liitä tämä.type: gridcards: - type: heading heading: 'Kaukolämpö' heading_style: title icon: mdi:radiator badges: - type: entity entity: sensor.ouman_outdoor_temperature name: 'Ulkona' icon: mdi:thermometer show_name: false show_state: true - type: markdown text_only: true grid_options: columns: full content: |- {%- macro t(e) -%}{{ (states(e) | float | round(1) | string) | replace('.', ',') if has_value(e) else '–' }}{%- endmacro -%} {%- set active = [ ('binary_sensor.ouman_alarm_dhw_high_temperature', 'käyttövesi liian kuumaa'), ('binary_sensor.ouman_alarm_l1_supply_deviation', 'menovesi poikkeaa asetusarvosta'), ('binary_sensor.ouman_alarm_l1_return_low', 'paluuvesi liian kylmää'), ('binary_sensor.ouman_sensor_fault_m1_outdoor', 'ulkoanturin vika'), ('binary_sensor.ouman_sensor_fault_m2_l1_supply', 'menovesianturin vika'), ('binary_sensor.ouman_sensor_fault_m3_l1_return', 'paluuvesianturin vika'), ('binary_sensor.ouman_sensor_fault_m8_dhw_supply', 'käyttövesianturin vika'), ('binary_sensor.ouman_sensor_fault_m9_dhw_circulation', 'kiertovesianturin vika') ] | selectattr(0, 'is_state', 'on') | map(attribute=1) | list -%} {%- if is_state('binary_sensor.ouman_connection_lost', 'on') -%} ## Ei yhteyttä säätimeen Lämmitys jatkuu säätimen omalla ohjauksella. Tarkista Modbus-yhdyskäytävä. {%- elif active -%} ## Hälytys: {{ active | join(', ') }} Tarkista säädin. {%- elif is_state('binary_sensor.ouman_l1_summer_shutdown', 'on') -%} ## Kesäsulku Tilojen lämmitys on pois. Käyttövesi on {{ t('sensor.ouman_dhw_supply_temperature') }} °C. {%- else -%} ## Lämmitys toimii normaalisti Menovesi {{ t('sensor.ouman_l1_supply_temperature') }} °C (tavoite {{ t('sensor.ouman_l1_supply_setpoint') }} °C), paluuvesi {{ t('sensor.ouman_l1_return_temperature') }} °C. Venttiili {{ states('sensor.ouman_l1_valve_position') }} % auki. {%- endif -%} - type: tile entity: sensor.ouman_l1_supply_temperature name: 'Menovesi' icon: mdi:thermometer-chevron-up vertical: false grid_options: columns: 6 - type: tile entity: sensor.ouman_l1_return_temperature name: 'Paluuvesi' icon: mdi:thermometer-chevron-down vertical: false grid_options: columns: 6 - type: tile entity: sensor.ouman_l1_supply_setpoint name: 'Menoveden tavoite' icon: mdi:target vertical: false grid_options: columns: 6 - type: tile entity: sensor.ouman_l1_valve_position name: 'Venttiili' icon: mdi:valve vertical: false grid_options: columns: 6 - type: tile entity: sensor.ouman_dhw_supply_temperature name: 'Käyttövesi' icon: mdi:water-thermometer vertical: false grid_options: columns: 6 - type: tile entity: sensor.ouman_dhw_circulation_temperature name: 'Käyttöveden kierto' icon: mdi:water-sync vertical: false grid_options: columns: 6 - type: history-graph title: 'Viimeiset 24 tuntia' hours_to_show: 24 grid_options: columns: full entities: - entity: sensor.ouman_l1_supply_temperature name: 'Menovesi' - entity: sensor.ouman_l1_supply_setpoint name: 'Menoveden tavoite' - entity: sensor.ouman_l1_return_temperature name: 'Paluuvesi' - entity: sensor.ouman_delayed_outdoor_temperature name: 'Ulkona (hidastettu)'Hyvä tietää
- Miten rekisterit luetaan. Jokainen rekisterilistan arvo on 32-bittinen ja jaettu kahteen rekisteriin. Paketti lukee alemman rekisterin 16-bittisenä kokonaislukuna, mikä riittää arvoille ±3276,7 °C asti skaalalla 0,1, eli kaikkeen mitä tässä luetaan. Rekisterilista numeroi rekisterit ykkösestä alkaen, ja paketti käyttää numeroita sellaisenaan.
- Hälytysrekisterit ovat bittikenttiä. Hälytys on päällä, kun bitti 0 on asetettu, joten binäärisensorit tarkistavat onko arvo pariton. Muissa biteissä on muuta tietoa: ilman hälytystä raaka-arvot ovat tässä tyypillisesti 36 tai 40.
- Hidastettu ulkolämpötila on se, joka ratkaisee. Säädin tasoittaa ulkolämpötilan ennen käyttöä, joten hidastettu arvo selittää, miksi menoveden tavoite seuraa äkillisiä sääpyörähdyksiä viiveellä.