homebridge-nordpool-baltics
TypeScript icon, indicating that this package has built-in type declarations

1.3.2 • Public • Published

homebridge-nordpool-baltics

verified-by-homebridge NPM Version NPM Downloads NPM License donate

If your electricity is billed based on hourly rates through a smart meter, this plugin enables you to automate power-intensive appliances in accordance with Nordpool's pricing levels. For example, this could apply to:

  • Car charging
  • House heating or cooling devices
  • Power-wall (to balance electricity costs)
  • Washer-dryer
  • Water heater (a.k.a boiler)

Currently, this plugin supports the following Nordpool electricity market areas:

  • Lithuania
  • Latvia
  • Estonia
  • Finland

How To Install

First, complete the Homebridge setup. Next, install the homebridge-nordpool-baltics plugin by using the Homebridge Plugins Manager.

Available Accessories

Plugin exposes the below described 'virtual' accessories:

  1. Nordpool_hourlyTickerSwitch: A switch that cycles ON and OFF every hour. Use it in 'An Accessory is Controlled' event on HomeKit automation. Then check for desired price/levels further on automation logic;

  2. Nordpool_currentPrice: A Light Sensor representing the current hour's electricity price in Euro cents (1 LUX = 1 cent). Due to HomeKit limitation, the minimal value is 0.0001, even if the actual price is 0 or negative.

  3. Nordpool_cheapestHour: Motion Sensor goes into 'motion detected' state if current hour electricity price ranks cheapest in the day. There can be more than one cheapest hours in the event of repeated same-price occurrences;

  4. Nordpool_cheapest4Hours to Nordpool_cheapest8Hours (optional on Plugin Config): A series of Motion Sensors which trigger a 'motion detected' state when the current hour's electricity price ranks among the cheapest of the day. The count can exceed the specified number in the event of repeated same-price occurrences;

  5. Nordpool_cheapest5HoursConsec (optional on Plugin Config): This Motion Sensor triggers during the 5 consecutive lowest-priced electricity hours ensuring energy-intensive appliances can operate uninterrupted for a stretch of 5 hours. Note more details about its calculation below.

  6. Nordpool_priciestHour: This Motion Sensor triggers 'motion detected' when any of the following is true:

    • Current hour price is most expensive of the day;
    • Current hour price is within 10% difference from most expensive hour;
    • Current hour price exceeds configured 'Excessive Price Margin Above Median' value (default 200%);
    • Current hour price exceeds configured 'Minimum Price Threshold for Priciest Hour(s)' value (default 0).
  7. Nordpool_currentHour (optional on Plugin Config): Temperature sensor (possible values 0-23) denoting current hour of the day (24h format). Eliminates 'current hour' scripting needed on HomeKit rules.

HomeKit Automation Examples

Here are a few automation examples, based on real-life use cases. Please note, the names of the accessories from the homebridge-nordpool-baltics plugin have been renamed to improve readability.

Water heater Floor heater Car charging
Boiler1 Floor1 Car1
Boiler2 Floor2 Car2

Have you devised an ingenious automation making the most out of this plugin? Don't keep it to yourself - share it using this form!

Cheapest Consecutive Hours Calculation Logic

Motion sensor Nordpool_cheapest5HoursConsec calculation logic is the following:

If 'Dynamic Cheapest Consecutive Hours' is Disabled in Plugin Config

  • At 00:00 (midnight): Recalculated using the pricing information of the new day.

If 'Dynamic Cheapest Consecutive Hours' is Enabled in Plugin Config

  • At 18:00 (6PM): If the cheapest 5 consecutive hours occurs later in the evening, the computation includes 0AM-6AM period from the next day. This could potentially shift the 5-hour period of cheapest price from the evening to the next day's early morning, aiming for maximum cost efficiency.

  • At 00:00 (midnight): If the 6PM run did not result in a shift, it will recalculate as normal using the pricing information of the new day.

  • At 07:00 (7AM): If the 6PM run shifted the 5-hour period, a recalculation happens considering the remaining pricing information of the current day.

Important Remark About Timezones

For accurate hour-to-price matching, it's important that the timezone of your homebridge system (the host) aligns with the timezone of the chosen Nordpool area. If there is a mismatch, the plugin will emit a warning in the log.

Additionally, please verify that your system's clock is regularly synchronized to ensure consistent and accurate hour-to-price ticking.

Package Sidebar

Install

npm i homebridge-nordpool-baltics

Weekly Downloads

6

Version

1.3.2

License

MIT

Unpacked Size

1.22 MB

Total Files

42

Last publish

Collaborators

  • mantaz40