diff --git a/source/_integrations/nordpool.markdown b/source/_integrations/nordpool.markdown index 5a9ca8e37698..b7c3bc14c8c5 100644 --- a/source/_integrations/nordpool.markdown +++ b/source/_integrations/nordpool.markdown @@ -39,58 +39,92 @@ Currency: ## Sensors -Each market area will create a device which has the following 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. ### Main sensors -- Current price for the selected area -- Previous price for the selected area -- Next price for the selected area +| Sensor | Type | Description | +| ------------------------- | ----------------- | --------------------------------------------------------------------------------- | +| Current price | [Currency]/kWh | The current (hourly) energy price. | +| Previous price | [Currency]/kWh | The price of the previous hour. | +| Next price | [Currency]/kWh | The price of the next hour. | +| Daily average | [Currency]/kWh | The average of today's energy prices. | -These sensors can be used to calculate your current energy cost, or to help decide whether to charge the battery now or in an hour, etc. +### Peak & off-peak sensors -### Block price sensors +Additional sensors are provided for peak and off-peak blocks. -- Block average -- Block minimum -- Block maximum -- Block start time -- Block end time +- Peak refers to the price of the period from 8am to 8pm. +- Off-peak 1 refers to the price of the time period from midnight to 8am. +- Off-peak 2 refers to the average price of the time period from 8pm to midnight. + +
+ +
+ +| Sensor | Type | Description | +| ------------------------------- | ----------------- | --------------------------------------------------------------------------------- | +| [peak/off-peak] highest price | [Currency]/kWh | The hightest hourly price during the given timeframe. | +| [peak/off-peak] lowest price | [Currency]/kWh | The lowest hourly price during the given timeframe. | +| [peak/off-peak] average | [Currency]/kWh | The average price of the given timeframe. | +| [peak/off-peak] time from | Datetime | The start date/time of the given timeframe. | +| [peak/off-peak] time until | Datetime | The end date/time of the given timeframe. | -These sensors show the minimum/maximum and average during certain blocks of the day. More known as off-peak (typically lower price) or peak hours (typically higher price). The block price sensors are not enabled by default. -### Daily average +### Diagnostic sensors -- Daily average +| Sensor | Type | Description | +| ------------------------- | ----------------- | --------------------------------------------------------------------------------- | +| Currency | [Currency] | The configured currency. | +| Exchange rate | Integer | The exchange rate between the configure currency and Euro's. | +| Last updated | Datetime | The time when the market prices were last updated. | -The daily average sensor is not enabled by default. +## Examples -### Diagnostic sensors +A template sensor to add VAT and fixed cost is useful to get the actual energy cost in the energy dashboard. + +### UI Template -- Last updated - indicates when the market price was last updated. -- Currency - The selected currency. -- Exchange rate - EUR is the base currency so will show the exchange rate used on the market place. +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**. +4. Enter the fields as shown below. -The `Exchange rate` sensor is not enabled by default. +The template below takes the current price attributes, adds 0.1293 EUR as fixed costs and adds 21% VAT. -## Example ++ +
-A simple template sensor to add VAT and a fixed cost from an `input_number` entity +### YAML Template + +A template sensor to add VAT and a fixed cost from an helper entity `input_number.add_fixed_cost`. {% raw %} ```yaml template: - sensor: - - name: "Full SE3 current price" - unit_of_measurement: "SEK/kWh" + - name: "Nordpool" + unit_of_measurement: "EUR/kWh" state_class: measurement state: > - {% set cost = states('sensor.nord pool_se3_current_price') | float(0) %} + # create a variable with the current price + {% set cost = states('sensor.nord_pool_nl_current_price') | float(0) %} + # create a variable with the additional fixed cost {% set add_cost = states('input_number.add_fixed_cost') | float(0) %} - # Add fixed cost to the spot price and add VAT (25%) + # Add cost and additional fixed cost. Add VAT (25%) by multiplying with 1.25 and round to 2 digits: {{ ((cost + add_cost) * 1.25) | round(2, default=0) }} ``` {% endraw %} + +### Energy Dashboard + +To use the Nordpool integration in the **Energy** dashboard, when configuring grid consumption and production, use the **Use an entity with current price** option. + ++ +
diff --git a/source/images/integrations/nordpool/nordpool-blocks.png b/source/images/integrations/nordpool/nordpool-blocks.png new file mode 100644 index 000000000000..1be6787bb032 Binary files /dev/null and b/source/images/integrations/nordpool/nordpool-blocks.png differ diff --git a/source/images/integrations/nordpool/nordpool_create_template.png b/source/images/integrations/nordpool/nordpool_create_template.png new file mode 100644 index 000000000000..0aead05531e6 Binary files /dev/null and b/source/images/integrations/nordpool/nordpool_create_template.png differ diff --git a/source/images/integrations/nordpool/nordpool_energy_dashboard.png b/source/images/integrations/nordpool/nordpool_energy_dashboard.png new file mode 100644 index 000000000000..fbf62fa245f0 Binary files /dev/null and b/source/images/integrations/nordpool/nordpool_energy_dashboard.png differ diff --git a/source/images/integrations/nordpool/nordpool_tempalte_sensor.png b/source/images/integrations/nordpool/nordpool_tempalte_sensor.png new file mode 100644 index 000000000000..1de7a3e958a4 Binary files /dev/null and b/source/images/integrations/nordpool/nordpool_tempalte_sensor.png differ