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

Setup Home Assistant for H60

We recommend installing the Hassio image as it is easiest to configure and have the easy to use and nice looking Lovelace graphical interface.

To enable the built in mqtt server for Home Assistant, start with the following section in the configuration.yaml file.

mqtt:
password:
<your password>

The built in mqtt server is depricated on later versions of HA so then you have use another. The standard way is to install the Mosquitto MQTT broker. It is very easy and there are many guides to be found online on how to do this.
Steps too install Mosquitto includes: Install Mosquitto app from hassio add-on store, Start service, Create a user account in HA that has to be the same as you enter in the H60 settings.

When it is installed you should use these settings instead in the config.

mqtt:
broker:
<the broker IP>

Set broker ip to “localhost” of Mosquitto is installed on the same server, otherwise input the IP adress of the server.


H60 configuration
MQTT_SRVR = IP Of the HA unit (Raspberry Pi)
MQTT_PORT = 1883 (standard)
MQTT_USER = homeassistant (for built in broker, otherwise the one you created)
MQTT_PASS = <same as above if built in broker>

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)


CONFIGURATON.YAML
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: "841d2e82daf0/HP/0001" (use H60 mac-address)
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.

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

How can we help?