This integration integrates Askoheat+ devices through modbus.
There exist a modbus integration in home assistant core, why should I use this custom integration instead?
It's possible to integrate an Askoheat+ device using the core modbus integration but it's cumbersome as you will have to:
- Go through the list of read/write registers manually and pick the once's you'd like to integrate
- Map status registers through helpers to be able to map them to
binary_sensorstates - Write services to write values back to aksoheat+ device with the convertion needed manually
- all registers listed in the modbus are queried independantly, even if it would be possible to scan all the states in one shot
This integration provides support for the following modbus register data blocks defined by the manufacturer and queries all states of a data block with a single query using different predefined scan_intervals:
| Data block | Scan interval |
|---|---|
| Energymanager Block | Polls every 5 seconds for state changes |
| Paramter Block | Read registers once on startup |
| Configuration Block | Polls registers once an hour |
| Data Values Block | Polls registers once a minute |
Some of the states are exposed in more than one data block and are therefore integrated only once.
All the entities created by this integration are assigned to one of the following device units through which you can filter out not needed states based on the local Askoheat water boiler setup:
| Device unit | Description |
|---|---|
| Water heater | Required. Entities related to core water heater sensors and configuration parameters |
| Energy manager | Required. Entities related to controlling the water heater through Home assistant as energy manager (i.e. load feed-in, etc.) |
| Analog input | Optional. Exposes entities related to contrlling the askoheat+ water heater through analog input |
| Heatpump | Optional. Exposes entities related to an integration with a connected heatpump sending heatpump requests |
| Legionalla protection | Optional. Exposes entities related to the integration legionalla protection mechanism |
| Modbus master | Optional. Exposes entities to use the askoheat water heater as a modbus master connecting to other slave devices |
To use HA to control auto feed-in (solar) mode of the askoheat device, a power sensor needs to be configured in the setup or later configuration of the device integration. An additional parameter defines if the provided value of the configures power device should get inverted. If not, the askoheat device assumes negative values of the power entity if energy is fed back to the grid and could be used to heat up the water instead.
In the energy manager device two additional entities are provided to enable controlling the auto feed-in support based.
| Entity Id Pattern | Description |
|---|---|
| number.askoheat_{serial_number}_auto_feedin_buffer | Buffer of feed-back energy use for short term loads. Will be added to the value of the energy fed back (assuming fead-back value has a negative value) |
| switch.askoheat_{serial_number}_auto_feedin | Switch to enable auto feed-in mode. Will observe the power entity and send changes continously to the askoheat device |
Add the custom repo to HACS
- Go to 'HACS > Integration'
- Select 'Custom repositories' from the top right menu
- Under Repository, enter 'https://github.com/toggm/askoheat'
- Under Category, select 'Integration'
- Click 'Add' The new integration will appear as a new integration and under 'Explore & Download Repositories' in the bottom right
Install the integration
- Click on the new integration or find it under 'Explore & Download Repositories' in the bottom right with the search word 'askoheat'.
- Select 'download' at the bottom right.
- Restart Home Assistant
Add the integration to Home Assistant
- Download the latest release of the Askoheat integration from this repository
- In Home Assistant, create a folder 'config/custom_components'
- Add the Luxtronik integration to the 'custom_components' folder;
- Restart Home Assistant;
Install the integration
- Add the Askoheat integration to Home Assistant (
Settings -> Devices & services -> Add integration); - Restart Home Assistant;
Your askoheat device should be autodiscovered only if the device is using it's standard dhcp name askoheat.local.
Press Configure and follow the steps to the end by selecting the additional device units you want to be created and monitored through this integration.
If you are using multiple askoheat devices, you're using a different hostname or work with static ip addresses you have to add your device manually.
To add the heatpump manually go to Settings -> Devices & services -> Add integration and add a new Adkoheat+ device.'
Provide correct hostname and configure the additional device units you want to be created and monitored through this integration.
ℹ️ If you access you're device by IP address, ensure the IP address is static. This can be configured in your router.
This integration follows standard integration removal. No extra steps are required.
To be able to delete a device unit, you first need to deactive the device unit in the integration. After deactivating the device unit can get deleted in the device detail page.
ℹ️ Be aware that the device units energy manager and water heater can't be deleted.
It is currently not possible, to turn on the emergency mode through modbus.
If you want to contribute to this please read the Contribution guidelines
The hardware of the askoheat device seems to be very sensible. Check the network plug and the outlets for any damage or try a different outlet or cable.
Check that the device is either configured with a static IP address or your local DNS can still resolve the configured hostname.
The askoheat device support a so called feed-in functionality. The device will itself start to heaten up the water in different power steps, depending on the solar power fed back to the grid. The integration provides a switch which automatically forwards any changes of the solar power to the device. As the device does figure out the maximum power level by slowly incresing the levels and checking the feed-in power, it might come to toggling on and off the power shortly before sunset and after sunrise, you can define an automation which toggles the auto feed-in switch depending on the state of the sun (i.e. toggle on an hour after sunrise, toggle off an hour before sunset). More information are available here
Share your examples in the discussion section