Skip to content

Altrec/remko_mqtt-ha

Repository files navigation

Home Assistant Remko-MQTT Integration

python badge HassFest tests github contributors last commit

This integration allows you to control and monitor your Remko heatpump from Home Assistant.

Prerequisite

You need a configured MQTT connection to your heatpump. (Directly or via a broker/bridge like Mosquitto). Username and password are needed for the connection.

  • The username is "0000000000000000"
  • The password can be found in the smt.min.js file from the web interface.
  • smt.min.js

Example config for Mosquitto: (add to mosquitto.conf)

# Remko
connection remko-bridge
address <ip_adress>:1883

# Maybe edit V04P28 to match the topic of your heatpump
topic V04P28/# both 0

remote_username 0000000000000000
remote_password <your_password>

start_type automatic
cleansession true
bridge_protocol_version mqttv311

Steps to install

The integration can be installed via HACS, or by manually copying the remko_mqtt directory to Home Assistant's config/custom_components/ directory.

There's a custom card available to edit the heatpump's time programs (dhw and hc) which has to be added manually.

Configuration

This integration can be configured through the Home Assistant UI. From the Devices & Services page click 'Add Integration' and search for 'Remko MQTT'.

The heatpump sends a message every second. To reduce log entries you can skip messages with the 'Skipped MQTT messages' config option.

Debugging

Make sure you see proper mqtt messages from the heatpump in a MQTT-Explorer before setting up HA.

Debug messages are not yet fully implemented.

Available data

The data available is listed in REGISTERS.md

Features and Limitations

  • Currently, provides all data from the heatpump in the form of sensors and binary sensors
  • Allows control over the heatpump
  • Only works with software versions 4.26+ (earlier version are not yet tested)

Contributing

Contributions are welcome! If you'd like to contribute, feel free to pick up anything on the current GitHub issues list! The naming, translation and grouping of registers can be improved, your input is appreciated. Most of it is in the remko_regs.py

All help improving the integration is appreciated!

About

Home Assistant integration for Remko heatpumps using MQTT

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors