my-PV

The my-PV integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you control and monitor devices made by my-PV from Home Assistant. my-PV builds power electronics that turn surplus solar electricity into heat, for example by driving a heating element in a hot water tank.

The integration communicates directly with the device over your local network. No cloud account is required.

Use cases

• Monitor tank temperatures, heating power, and PV power on your dashboard or in the energy-related cards.
• Change the hot water target temperature from Home Assistant, for example to store more heat on sunny days.
• Turn hot water heating on or off, or enable or disable boost mode, from an automationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more], for example when you go on holiday.

Supported devices

The following devices are supported by this integration:

• AC ELWA 2
• AC•THOR range
• HEA•THOR IoT
• SOL•THOR

Unsupported devices

The following devices are not supported by this integration:

• AC ELWA-E
• ELWA immersion heater
• WiFi Meter

If you try to add an unsupported device, setup stops with the message that the device is not supported.

Prerequisites

• The my-PV device must be connected to the same network as Home Assistant, and you need to know its IP address or hostname if it is not discovered automatically.
• Depending on the firmware version, your device may require a password. If you have not set a custom password, use the device key instead. You can find the device key in the Info menu of your my-PV device. For the HEA•THOR IoT, the device key is printed on the device label.

You can change the password through the web interface of your my-PV device.

Configuration

To add the my-PV device to your Home Assistant instance, use this My button:

my-PV can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Home Assistant can discover my-PV devices on your network automatically using DHCP and zeroconf. A discovered device shows up under Settings > Devices & services, where you can select Add to set it up. If your device is not discovered, you can add it manually.

Supported functionality

The integration adds one device per my-PV unit. The device information includes the model, serial number, firmware and hardware version, and a link to the device’s web interface.

Which entities are created depends on your device model, its firmware, and how it is configured. The integration only creates entities for values your device reports.

Water heater

When the device is configured for hot water heating and has a temperature sensor connected, a water heater entity is created. It provides:

• Current temperature: The temperature measured by the first temperature sensor.
• Target temperature: The hot water target temperature. The minimum, maximum, and step size are taken from the device’s own configuration.
• Operation mode: Off or Electric. You can also use the turn on and turn off actions.

Switches

• Hot water heating: When the device is configured for hot water heating but has no temperature sensor connected, a switch named after the device is created instead of the water heater entity. Use it to turn heating on or off.
• Boost mode: Enables or disables boost mode on devices that offer it as a simple on/off setting. This does not start or stop boost heating itself; it sets whether the device is allowed to boost.

Selects

• Boost mode: On devices that can boost through different outputs, selects the boost target: Off (boost mode disabled), On (the main load, usually the heating element), Relay, SELV relay, or AUX relay. The available options depend on your device. Like the switch, this configures boost mode and does not start or stop boost heating itself.

Numbers

• Boost target temperature: The temperature the hot water is heated to during boost.
• Minimum hysteresis: How far the temperature has to drop below the target temperature before heating starts again. Disabled by default.
• Maximum hysteresis: How far the temperature has to rise above the target temperature before heating stops. Disabled by default.

Buttons

• Restart: Restarts the my-PV device.

Sensors

• Device status: What the device is doing: Standby, Heat, Boost, Heating finished, No connection / Disabled, Failure, or Block active.
• Power: The power the device is currently using for heating.
• Temperature 1 to Temperature 4: The temperatures measured by the connected sensors. If only one sensor is available, the entity is called Temperature.
• Current phase L1 to Current phase L3: The current per phase. On single-phase devices, the entity is called Current.
• Voltage phase L1 to Voltage phase L3: The voltage per phase. On single-phase devices, the entity is called Voltage.
• PV power and PV voltage: The power and voltage of the solar panels connected directly to the device, for devices that support this.

The following diagnostic sensors are disabled by default:

• Device temperature: The internal temperature of the device’s power stage.
• Mains frequency
• Network mode: LAN, WLAN, or AP.
• Uptime
• Wi-Fi signal strength

Examples

Here are a few ideas to get you started. Replace the entity IDs with those of your own devices.

Automation: Raise the hot water temperature on sunny afternoons

On sunny days, there is often more solar power than you need. By raising the target temperature around noon, your hot water tank stores more of that energy as heat. This example uses a weather entity, so you need a weather integration set up in Home Assistant.

• Trigger: Time: at 12:00
• Condition: Entity state: your weather entity is Sunny
• Action: Water heater: Set target temperature
  • Target: your my-PV water heater
  • Temperature: 65

The temperature is in the unit your Home Assistant uses. This example assumes Celsius. If your Home Assistant uses Fahrenheit, use 149 instead. Make sure the value is within your device’s temperature range.

The target temperature stays at the new value until you change it. To go back to your usual temperature, create a second automation that sets it back, for example at 18:00.

alias: "Raise hot water temperature on sunny afternoons"
triggers:
  - trigger: time
    at: "12:00:00"
conditions:
  - condition: state
    entity_id: weather.home
    state: "sunny"
actions:
  - action: water_heater.set_temperature
    target:
      entity_id: water_heater.my_pv_ac_thor_9s
    data:
      temperature: 65

Automation: Turn hot water heating off while you are away

When you go on holiday, there is no need to keep your hot water tank warm. This example uses a toggle helperA helper is a virtual entity you create inside Home Assistant. It is not backed by a physical device. Helpers store values, track state, or do calculations that your automations and dashboards need. [Learn more] to tell Home Assistant you are away. To create one, go to Settings > Devices & services > Helpers, select Create helper > Toggle, and name it, for example, Vacation mode. Turn the toggle on when you leave.

• Trigger: Entity state: Vacation mode changes to On
• Action: Water heater: Turn off
  • Target: your my-PV water heater

To turn heating back on when you return, create a second automation that triggers when Vacation mode changes to Off and uses the Water heater: Turn on action on your my-PV water heater.

alias: "Turn off hot water heating when away"
triggers:
  - trigger: state
    entity_id: input_boolean.vacation_mode
    to: "on"
actions:
  - action: water_heater.turn_off
    target:
      entity_id: water_heater.my_pv_ac_thor_9s

Data updates

The my-PV integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] the device every 5 seconds. If the device reports that it is receiving too many requests, the integration keeps the last known values and slows down polling to every 10 seconds.

Known limitations

• The water heater entity only supports hot water heating. Other operating modes of my-PV devices, such as room heating, are not available as a water heater.
• Entities are created when the integration is set up. If you change the configuration of the device, for example by connecting an extra temperature sensor, reload the integration to update the entities.
• The IP address or hostname cannot be changed through the UI. If the device is discovered on a new IP address, Home Assistant updates it automatically. Otherwise, remove the integration and add it again.

Troubleshooting

The device cannot be found or connected to

• Check that the device is powered on and connected to your network, and that you can open its web interface from a browser.
• Make sure Home Assistant and the device are on the same network. Discovery does not work across VLANs or subnets unless your network forwards mDNS.
• Give the device a fixed IP address in your router, so its address does not change.

Authentication fails

• Check that you entered the custom password you set on the device. If no custom password is set, use the device key from the Info menu or, for the HEA•THOR IoT, from the device label.
• If you change the password on the device after setup, Home Assistant notifies you that reauthentication is required. Follow the notification under Settings > Devices & services and enter the new password. All entities and settings are kept.

“Too many requests” when changing a setting

The device limits how often it accepts requests. Wait a few seconds and try again.

An entity is missing

Entities are only created for values your device reports. Check the configuration in the web interface of your my-PV device, then reload the integration. Some diagnostic entities are disabled by default and need to be enabled first.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
   • Depending on the integration, the entries are listed under one of the following headings:
     • Devices
     • Hubs
     • Services
     • Integration entries
3. To confirm, select Delete.
   • Home Assistant also deletes the devices and entities of the entry.
4. If Home Assistant asks you to restart, restart Home Assistant.
5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
   • If you keep them, Home Assistant uses them automatically when you add the integration again.
   • To delete them later, refer to Deleting application credentials.