Add documentation and setup instructions for ista EcoTrend statistics (#34342)

* Add documentation and setup instructions for ista EcoTrend statistics

* fix indentation

* fix error

* some more fixes

* remove blank line

* Tiny style tweaks

* implement feedback from the rabbit

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Mr. Bubbles 2024-08-26 08:59:48 +02:00 committed by GitHub
parent 76a2ca9a92
commit d875190496
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -34,3 +34,37 @@ The **ista EcoTrend** integration exposes the last monthly readings as sensors.
- **Water costs**: estimated costs in EUR
Not all values may be available in your ista EcoTrend account. Cost estimation is an optional service that has to be booked by your property manager. Therefore, the cost sensors are deactivated by default.
## Long-term statistics
The **ista EcoTrend** integration allows you to import all your historical consumption readings from your ista EcoTrend account into long-term statistic entities. These entities can be displayed in your Home Assistant energy dashboard, providing a comprehensive view of your consumption data over time.
### Identifying ista EcoTrend statistic entities
The statistic entities imported via this integration have a `ista_ecotrend:` prefix. This prefix helps you identify and distinguish these entities from other sensor statistics when setting up the long-term statistics in the energy dashboard.
### Setting up long-term statistics in the energy dashboard
To set up the **ista EcoTrend** long-term statistics in your Home Assistant energy dashboard, follow these steps:
- **Access the energy configuration panel**
- Go to the [energy configuration panel](https://my.home-assistant.io/redirect/config_energy/) of your Home Assistant instance.
[![Open your Home Assistant instance and show your energy configuration panel.](https://my.home-assistant.io/badges/config_energy.svg)](https://my.home-assistant.io/redirect/config_energy/)
- **Add heating energy usage**
- Go to **Gas consumption**.
- Select **Add gas source**.
- Choose your **Heating energy** entity (for example, `ista_ecotrend:luxemburger_str_1_heating_energy`).
- For cost tracking, select the **Use an entity tracking the total costs** option.
- Select the corresponding **Heating costs** entity (for example, `ista_ecotrend:luxemburger_str_1_heating_cost`).
- **Add hot water energy usage**
- To track hot water energy usage and costs (for example, `ista_ecotrend:luxemburger_str_1_hot_water_energy` and `ista_ecotrend:luxemburger_str_1_hot_water_cost`), repeat the above steps for your **Hot water energy** and **Hot water costs** entities.
- **Add hot water consumption**
- Go to **Water consumption**.
- Select **Add water source**.
- Choose the **Hot water** entity (for example, `ista_ecotrend:luxemburger_str_1_hot_water`).
- For cost tracking, select the **Use an entity tracking the total costs** option.
- Select the corresponding **Hot water costs** entity (for example, `ista_ecotrend:luxemburger_str_1_hot_water_cost`).
- **Add water consumption**
- To track cold water consumption and costs (for example, `ista_ecotrend:luxemburger_str_1_water` and `ista_ecotrend:luxemburger_str_1_water_cost`), repeat the above steps for your **Water** and **Water costs** entities.