Zigbee Ultrasonic Heat Meter – Home Assistant Integration (Zigbee2MQTT + ZHA support)

zemismart · May 9, 2026, 9:53am

We are working on integrating a Zigbee ultrasonic heat energy meter into Home Assistant for HVAC and hydronic heating/cooling systems.

This device is not a traditional water meter, but a thermal energy meter (heat/cooling energy consumption in kWh or MJ equivalent) based on ultrasonic flow measurement and temperature differential.

It is commonly used in:

Floor heating systems
District heating
HVAC chilled water loops
Fan coil systems
Building energy monitoring
Thermal energy billing

Open-source Home Assistant integration

We currently support both major Zigbee ecosystems:
Zigbee2MQTT support (MQTT-based integration)
Implementation:

This converter exposes:

Flow rate (m³/h)
Supply water temperature
Return water temperature
Heating / cooling energy (kWh / MJ equivalent)
MQTT entities for Home Assistant

This makes it compatible with:

Home Assistant Energy Dashboard (via MQTT sensors)
Utility Meter / long-term energy tracking
Custom automation based on thermal load

5e6319da48702a812d59c6eda25534ef3374×2428 273 KB

ZHA native support (quirk-based integration)

Implementation:

github.com/zemismart-dev/zemismart-zha-quirks

DN15-223F.py

d2073602d

[heat_meter_.py](https://github.com/user-attachments/files/27546615/heat_meter_.py)
"""Collection of Tuya Valve devices e.g. water valves, gas valve etc."""
import struct

import zigpy.types as t
from zigpy.zcl.clusters.smartenergy import Metering

from zigpy.quirks.v2 import EntityType
from zigpy.quirks.v2.homeassistant import UnitOfElectricPotential
from zigpy.quirks.v2.homeassistant.sensor import (
    SensorDeviceClass,
    SensorStateClass,
)

from zhaquirks.tuya.builder import TuyaQuirkBuilder, TuyaValveWaterConsumed


# ===========================
# 水量计量配置（Metering）
# ===========================

This file has been truncated. show original

This quirk enables:

Direct Zigbee integration via ZHA (zigpy)
Native sensor exposure (flow / temperature / energy)
No MQTT required
Device-specific cluster mapping for correct reporting

image946×814 81.8 KB

Device technical overview

Based on ultrasonic heat metering principles:

Ultrasonic flow measurement (no moving parts)
Thermal energy calculation using flow and temperature differential
Designed for heating and cooling system applications
Intended for continuous HVAC monitoring environments

Why ultrasonic heat meters are interesting for Home Assistant

Compared to traditional mechanical flow meters:

No impeller-based mechanical wear
Reduced risk of blockage from debris
Potentially more stable over long-term operation
Suitable for thermal energy monitoring and billing applications
Direct measurement of thermal energy instead of estimated consumption

Potential Home Assistant use cases

Possible integrations include:

Potential Home Assistant Energy Dashboard integration
Floor heating monitoring
HVAC efficiency tracking
Boiler / chiller loop visualization
Building energy monitoring

Community feedback welcome

We would appreciate feedback from the Home Assistant community regarding:

Best practice for integrating heat energy data into HA dashboards
ZHA vs Zigbee2MQTT preference for energy metering devices
Long-term reliability of ultrasonic heat meter reporting
Existing EN1434-style heat meter integrations in Home Assistant

References

Product page:

Final note

This type of device sits somewhere between traditional HVAC instrumentation and smart home energy monitoring. We are interested in exploring how thermal energy metering can be integrated more effectively into the Home Assistant ecosystem.