Integration - HomeAssistant

Introduction

HomeAssistant is an open source project that allows you to monitor, control and automate various devices on a single platform. SolarAssistant integrates with HomeAssistant via MQTT automatic discovery. It allows you to turn on relays or control external devices based on inputs from your solar system.

NB: You can not run HomeAssistant on the Raspberry PI that SolarAssistant is installed on. You need a 2nd PI or other machine. SolarAssistant is a very minimal linux based system that is optimized to use the SD card and other system resources very sparingly to allow it to run continuously for many years and update itself without issues.

Step 1 - Enable MQTT output

Follow our MQTT guide to enable and test that your MQTT output is working.

Step 2 - Enable HomeAssistant discovery

Enable automatic discovery on the "Configuration" tab in SolarAssistant.

Enable HomeAssistant MQTT discovery

This will publish MQTT retain messages that tell HomeAssistant what each value represents.

Step 3 - Install and configure HomeAssistant MQTT

In HomeAssistant, navigate to "Integration" and install MQTT if it's not installed already. Select "configure":

Configure HomeAssistant MQTT integration

Enter your SolarAssistant IP as the MQTT broker in HomeAssistant:

Configure HomeAssistant MQTT integration

On the next page, ensure discovery is enabled. It's on by default.

Configure HomeAssistant MQTT integration

Step 4 - Wait for inverter to be discovered

After a few minutes you should see your inverter appear under the devices section in HomeAssistant:

Configure HomeAssistant MQTT integration

Select the device to view it:

Configure HomeAssistant MQTT integration

These data points are also available under the "Entities" section:

Configure HomeAssistant MQTT integration

Reusing your existing HomeAssistant MQTT broker

If you already have an MQTT broker configured in HomeAssistant and would like to consume SolarAssistant messages there, you need to set up an MQTT bridge.

Troubleshooting

If your inverter does not appear in HomeAssistant after 10 minutes, go back to the HomeAssistant MQTT integration and use the "Listen to a topic" to test that HomeAssistant is receiving SolarAssistant MQTT messages. You should see messages as shown below:

Test HomeAssistant MQTT messages