1. Home
  2. Docs
  3. H60 Gateway Manual
  4. Home Assistant MQTT integration
  5. Setup Home Assistant for H60

Setup Home Assistant for H60

This guide is based on latest Image and instructions from home-assistant.io and the use of Raspberry Pi.

If you are using older HA version having no Add-on store, Mosquitto MQTT Broker have to be installed manually in Linux. Look up guides available on various online support sites for instructions.

Download the install image from home-assistant.io and follow the instructions for installation on your Raspberry Pi.

Create user account

When HA is up an running, access it’s web interface and access your user profile in the left bottom and turn on “Advanced mode”.

Next, go to Configuration, Users and add a user account for the MQTT connection. In this example we will setup “mqtt_user” with password “1234”.

Install Mosquitto

Access HA web interface and enter the the “Supervisor” menu on the left. On the top select “Add-on Store”. Type “Mosq” in the search field and “Mosquitto broker” add-on will be shown. Select it and install, Start it.
Tip: For easy access to edit the configuration.yaml file, install the add-on “File Editor”. We also recommend to install the “Check Home Assistant Configuration” plugin to avoid errors made in the configuration.yaml file.

Configuration.yaml in HA
Add the following section in the configuration.yaml file
(See configuration.yaml example section for additional config)

broker: localhost

H60 configuration
Next, access the web interface on the H60 and configure with help of the example below.

MQTT_SRVR = IP Of the HA unit (Raspberry Pi)
MQTT_PORT = 1883 (standard)
MQTT_USER = mqtt_user (set as same in HA config above)
MQTT_PASS = 1234 (set as same in HA config above
MQTT_PUBALL = 20 (Time in minutes for re-publish all data, 0=off)
MQTT_SUBS = 1 (1=HP setting can be changed from HA, 0= Read only)

Depending on type, brand or model of heat pump you are having, the sensor definitions has to be adjusted to match the specific heat pump.

So what you need to do is to add, remove and change the sensor definitions to match the correct Sensor ID:s (0001 in this case) with the correct description in HA, “Rad Return”
The available and usable Sensor ID:s for different heatpumps can be found in the H60 web interface home screen. Also your MAC address has to be entered to every definition as this is how your H60 is identified.

platform: mqtt
state_topic: "+/HP/0001"
name: "Rad Return"
icon: mdi:thermometer
unit_of_measurement: "C"

To be able to change settings in the heat pump rom HA, the SET topic must be enabled by changing the H60 setting MQTT_SUBS to 1.
Reset H60 after settings are changed.

The CMD Topic
Additionaly H60 is subscribing on the CMD topic to perform various actions.

Send data “STATUS” to the CMD topic to have H60 to publish current status. For example: Uptime, Wifi signal strength, etc.

Send data “GETALL” to the CMD topic to request H60 to publish an update on all heat pump data.

Send: “841d2e82daf0/HP/CMD” with data: “STATUS”
Return:”841d2e82daf0/HP/STATUS/RSSI”, “Good -66dBm”


After your HA installation and H60 has been configured and restarted you should be able to view all data from the Heatpump in the HA dashboard.
If it is just showing zeros or nothing, there is a problem.

Check H60
Start with accessing H60 and check its LOG.
Is is showing “MQTT Connected with user/pass” we know that H60 is communicating with HA.

If it is showing “MQTT Reconnecting, retrying” os similar, please check all setup from start. Correct IP to HA?, Correct username and password?, H60 and HA on same network? etc.

Check HA
You can get valuable info for troubleshooting by entering the Mosquitto Log. in HA. Supervisor->Mosquitto broker->Log
Check that Mosuitto broker is started in the Supervisor menu.

How can we help?