Skip to content

Commit

Permalink
Updates to Nord Pool integration (home-assistant#36261)
Browse files Browse the repository at this point in the history
  • Loading branch information
gjohansson-ST authored Dec 11, 2024
1 parent 0363872 commit b99bee1
Showing 1 changed file with 22 additions and 9 deletions.
31 changes: 22 additions & 9 deletions source/_integrations/nordpool.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,9 @@ The **Nord Pool** {% term integration %} integrates [Nord Pool Group](https://ww

The {% term integration %} provides the public market prices displayed on the [Nord Pool Auction page](https://data.nordpoolgroup.com/auction/day-ahead/prices).

{% include integrations/config_flow.md %}

{% tip %}
Only a single configuration entry is supported. Use the reconfigure option from the configuration entry if needed to modify the settings.
Most European energy is traded via the Nord Pool Group marketplace. If your energy provider doesn't have a dedicated Home Assistant integration and you have a spot-price-based contract, you can use the **Nord Pool** {% term integration %}. This integration provides spot prices for your selected market, which you can, as an example, use in a {% term template %} to calculate prices for your [energy dashboard](#energy-dashboard).

EUR is the base currency for market prices. If you choose another currency, you can find the conversion rate in the `Exchange rate` sensor.
All prices are displayed as `selected_currency/kWh`.
{% endtip %}
{% include integrations/config_flow.md %}

{% configuration_basic %}
Areas:
Expand All @@ -37,9 +32,22 @@ Currency:
description: Currency to display prices in. EUR is the base currency in Nord Pool prices.
{% endconfiguration_basic %}

{% tip %}
Only a single integration entry is supported. To modify the settings, you can use the reconfigure option from the integration entry.

EUR is the base currency for market prices. If you choose another currency, you can find the conversion rate in the `Exchange rate` sensor.
All prices are displayed as `[Currency]/kWh`.
{% endtip %}

## Data fetching and limitations

Data is polled from the **Nord Pool** API on an hourly basis, exactly on the hour, to ensure the price sensors are displaying the correct price.

If polling cannot happen because of no connectivity or a malfunctioning API, there is no retry; the next periodic update will try again.

## Sensors

The integration will create entities showing today's energy prices for the configured market area. Only the base energy price is shown. VAT and other additional costs are not included.
The integration will create entities showing today's energy prices for the configured market area. Only the base energy price is shown. VAT and other additional costs are not included.

### Main sensors

Expand Down Expand Up @@ -82,11 +90,12 @@ The block price sensors are not enabled by default.

## Examples

A template sensor to add VAT and fixed cost is useful to get the actual energy cost in the energy dashboard.
A template sensor to add VAT and fixed cost is useful to get the actual energy cost in the energy dashboard.

### UI Template

Create a helper using the UI.

1. Go to {% my integrations title="**Settings** > **Devices & Services**" %} and at the top, choose the **Helpers** tab.
2. In the bottom right corner, select **Create helper**.
3. Select **Template** and **Template a sensor**.
Expand Down Expand Up @@ -128,3 +137,7 @@ To use the Nordpool integration in the **Energy** dashboard, when configuring gr
<p class='img'>
<img src='/images/integrations/nordpool/nordpool_energy_dashboard.png' alt='Screenshot: Create template sensor'>
</p>
## Remove the integration
{% include integrations/remove_device_service.md %}

0 comments on commit b99bee1

Please sign in to comment.