Energy Manager |


Modbus

Modbus Configuration

Modbus is the protocol that Home Assistant and Energy Manager will use to access your inverter. It is important that this is configured correctly. Since Modbus is started very early in the Home Assistant startup process, it must obtain some settings from the /config/secrets.yaml file, and not from other entities within Home Assistant.

  • On the left menu, select Studio Code Server

Studio Code Server

  • Click Yes, I trust the authors so you can use the add-on (this is because this tool is very powerful, so only do what these instructions say)
  • From the top left menu of Studio Code Server, click on the three horizontal lines, then File > Open Folder

Open Folder

  • From the Open Folder, select config, and then OK

Config Folder

  • Select the secrets.yaml file and then on the right side of Studio Code Server edit the contents of this file. You will need to change the {modbus_host_ip} to the IP address of your inverter. If the IP address of your inverter is 10.10.10.5, then enter this address. Do not include the {} brackets. You may need to change the modbus_port and modbus_slave entries as well, but try it with these default settings first.

Config Folder

  • If your IP address was 10.10.10.5, then the file contents will look like this (but it is extremely unlikely this will be your address; you MUST find it yourself).

Config Folder

Note - You don't need to actually press save; the file is updated the moment you edit it, but you will need to restart Home Assistant for the settings to take effect.

ℹ️AlpaESS inverters

If you are using an AlphaESS inverter, you should also update the modbus_slave from 1 to 85.

💡Restart Home Assistant

For the Modbus integration to start working, you must restart Home Assistant. Please do that before continuing with your configuration. The recommendation is to perform this through Developer Tools > Check Configuration > Restart so you can see if there are any errors that may prevent Home Assistant from restarting.

⚠️Modbus warnings

The following modbus warnings are ok if you have not rebooted your Home Assistant since you updated the secrets.yaml file. The modifications to your secrets.yaml file have not been loaded yet, so modbus will issue warnings.

Config Folder