v.1.1.11 (#277)

* Modify is_on_fn to check for non-zero power (#251)

Updated is_on_fn to check for non-zero output power, reflecting both charging and discharging states.

Fixes #250

* Enable plant rated sensors by default (#219)

* simple comment typo fix (#216)

* swap import and export icons (#212)

These icons are designed from the perspective of the grid.

"tower-import" means the grid is importing power. From the SigenStor perspective, this is when the SigenStor is sending/exporting power to the grid.

So when the local system is 'exporting', we need to use the 'tower-import' icon. And vice versa for importing.

* Swap import/export icons and update sensor icons

Swap transmission-tower import/export icons for grid and PCS entities; replace several transmission-tower-export icons with generator-stationary and ev-station for clearer sensor representation.

* README: separate copyright from license link and add Step-by-step guide link

* Dashboards: add Nordpool energy chart card, README and example image

- Add card_nordpool_energy_chart.yaml: configurable Lovelace chart (custom:config-template-card + custom:apexcharts-card)
  - Displays today/tomorrow Nordpool prices, grid import and battery SOC
  - Dynamic price calculations, color thresholds, formatted axes and grouping
- Add README with installation, configuration and disable instructions
- Add example screenshot HA_energy_chart.jpg

* Dashboards: nordpool energy chart - use filtered plant sensors, update cost calc, fix graph span and formatting

- Switch to plant-filtered sensors for grid import and battery SOC
- Replace simple cost template with expanded additional_cost_template
- Add update_interval and correct graph_span calculation (divide by 4)
- Normalize quoting and color string styles for consistency
- Minor formatting tweaks (offset quoting, newline at EOF)

* Dashboards: add Energy Flow dashboard (yaml + preview image) and update README add-ons links

- Add Dashboards/energy_flow_gauge/energy_flow.yaml (new Energy Flow dashboard with multiple apexcharts gauges)
- Add Dashboards/energy_flow_gauge/energy_flow.jpg (dashboard preview image)
- Update README: add links for Energy Flow Dashboard and Nordpool custom prices; rename Si-GCG link to "Add-ons & tools by Si-GCG"

* Dashboards: add Energy Flow dashboard README and update main README link

* README: add Step-by-step guide link to Add-ons section

* Fix typo (#213)

* Bump version to 1.1.11 in manifest.json

---------

Co-authored-by: Mark Purcell <[email protected]>
Co-authored-by: Brendan Annable <[email protected]>
Co-authored-by: lawther <[email protected]>

Author: 4 people

Dashboards/energy_flow_gauge/energy_flow.jpg

@@ -0,0 +1,26 @@
+# Energy flow gauge displaying energy consumption and generation.
+
+This is a set of gauges displaying energy flow from grid, solar and battery.
+
+![alt text](energy_flow.jpg)
+
+# Pre-requirements
+
+This has not been tested on HA earlier than 2024.9 and requires the following HACS addons:
+
+- Apex-Charts card
+- Config Template Card Card - For scripting inside the chart card.
+- lovelace-card-mod - For styling.
+- bar-card
+
+The sensor names needs to be changed to suit your system.
+
+# Installation
+- Copy - paste the raw card code from `energy_flow.yaml` to your a new card on you lovelace dashboard. Add any card and replace the raw code that you can edit by clicking on the *SHOW CODE EDITOR* in the bottom left.
+
+
+# Configuration 
+
+In the chart-card you should change the following variables to suit your needs:
+
+  - Check so the sensor names are correct.

Dashboards/energy_flow_gauge/energy_flow.yaml

@@ -0,0 +1,269 @@
+# This code should be copy-pasted into a lovelace card.
+# Requires the custom:config-template-card, custom:apexcharts-card, custom:nordpool-card and custom:congif-template-card to be installed. 
+
+type: custom:config-template-card
+update_interval: 60s
+variables:
+  nordpool_sensor: "'sensor.nordpool'"
+  grid_import_sensor: "'sensor.sigen_plant_filtered_daily_grid_import_energy'"
+  battery_soc_sensor: "'sensor.sigen_plant_filtered_battery_charge'"
+  additional_cost_template: "'*1.25 +(27.2 + 42.8 + 3.04 + 2.19 + 1.4) *1.25'"
+  decimals_in_prices: 0
+  decimals_in_energy: 1
+  chart_price_cutoff_coerficient: 0.1
+  price_y_axis_unit: "'öre'"
+  energy_y_axis_unit: "'kWh'"
+  price_overview_unit: "'öre/kWh'"
+  chart_title: "'Electricity prices today'"
+  total_purchease_price_text: "'Total purchease price'"
+  grid_import_text: "'Grid Import today'"
+  battery_soc_text: "'Battery charge'"
+  lowest_price_text: "'Lowest future price'"
+  highest_price_text: "'Highest future price'"
+  price_now_text: "'Current price'"
+  now_text: "''"
+  get_chart_cutoff: |
+    (_min_price, _max_price, _coefficient) => {
+      if (_min_price <= 0) {
+          return "auto";
+      }
+      return _min_price - ((_max_price-_min_price) * _coefficient)
+    }
+  get_total_max_nordpool_price: |
+    (_nordpool_sensor, _additional_cost_template) => {
+      return states[_nordpool_sensor].attributes.raw_today.concat(states[_nordpool_sensor].attributes.raw_tomorrow).map(data=> eval("data.value"+_additional_cost_template)).reduce((a, b) => Math.max(a, b), -Infinity)
+    }
+  get_total_min_nordpool_price: |
+    (_nordpool_sensor, _additional_cost_template) => {
+      return states[_nordpool_sensor].attributes.raw_today.concat(states[_nordpool_sensor].attributes.raw_tomorrow).map(data=> eval("data.value"+_additional_cost_template)).reduce((a, b) => Math.min(a, b), Infinity)
+    }
+  get_low_bottom_threshold_nordpool_price: |
+    (_min, _max) => {
+      return parseFloat(_min) + parseFloat(((_max) - parseFloat(_max)) /10)
+    }
+  get_low_threshold_nordpool_price: |
+    (_min, _max) => {
+      return parseFloat(_min) + parseFloat(((_max) - parseFloat(_min)) /3)
+    }
+  get_high_threshold_nordpool_price: |
+    (_min, _max) => {
+      return parseFloat(_min) 
+      + (( parseFloat(_max) - parseFloat(_min) ) /3) * 2
+    }
+  get_high_top_threshold_nordpool_price: |
+    (_min, _max) => {
+      return parseFloat(_min) + parseFloat(((_max) - parseFloat(_min)) /10)*9
+    }
+  get_total_prices: |
+    _cost_template => {
+      return "return (entity.attributes.raw_today.map((start, index) => {return [new Date(start['start']).getTime(), entity.attributes.raw_today[index]['value']"
+      + _cost_template
+      + "];})).concat(entity.attributes.raw_tomorrow.map((start, index) => {return [new Date(start['start']).getTime(),entity.attributes.raw_tomorrow[index]['value'] "
+      + _cost_template + "];}));"
+    }
+  get_future_total_prices: |
+    _cost_template => {
+      return "const now = new Date().getTime() - 3600000;"
+      + "const futureData = entity.attributes.raw_today.concat(entity.attributes.raw_tomorrow).filter(data"
+      + " => new Date(data.start).getTime() >= now);"
+      + "return futureData.map((data, index) => {"
+      + "return [new Date(data.start).getTime(), futureData[index].value"
+      + _cost_template + "];});"
+    }
+entities:
+  - ${nordpool_sensor}
+  - ${battery_soc_sensor}
+  - ${grid_import_sensor}
+card:
+  type: custom:apexcharts-card
+  graph_span: >-
+    ${ (states[nordpool_sensor].attributes.raw_today.length +
+    states[nordpool_sensor].attributes.raw_tomorrow.length) / 4 + 'h' }
+  yaxis:
+    - id: y-price
+      min: >-
+        ${get_chart_cutoff(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),get_total_max_nordpool_price(nordpool_sensor,additional_cost_template),chart_price_cutoff_coerficient)}
+      max: auto
+      apex_config:
+        opposite: false
+        forceNiceScale: true
+        decimalsInFloat: ${decimals_in_prices}
+        labels:
+          formatter: >
+            ${"EVAL:function(value) {return value.toFixed(" + decimals_in_prices
+            + ") + ' " + price_y_axis_unit + "' }"
+    - id: y-energy
+      min: 0
+      max: auto
+      apex_config:
+        opposite: true
+        forceNiceScale: true
+        decimalsInFloat: ${decimals_in_energy}
+        labels:
+          formatter: |
+            ${"EVAL:function(value) {return value.toFixed("
+            + decimals_in_energy
+            + ") + ' " + energy_y_axis_unit + "' }"
+    - id: y-SOC
+      show: false
+      min: 0
+      max: 100
+  apex_config:
+    chart:
+      height: 340px
+    legend:
+      show: false
+    title:
+      floating: false
+      align: center
+      style:
+        fontSize: 20px
+        fontWeight: bold
+    xaxis:
+      labels:
+        datetimeFormatter:
+          hour: HH:mm
+  show:
+    last_updated: true
+  experimental:
+    color_threshold: true
+  header:
+    title: ${chart_title}
+    show: true
+    show_states: true
+    colorize_states: true
+  span:
+    start: day
+  now:
+    show: true
+    label: ${now_text}
+  series:
+    - entity: ${nordpool_sensor}
+      yaxis_id: y-price
+      name: ${total_purchease_price_text}
+      offset: "-30min"
+      float_precision: ${decimals_in_prices}
+      show:
+        extremas: false
+        in_header: false
+      type: column
+      data_generator: ${get_total_prices(additional_cost_template)}
+      color_threshold:
+        - value: -1000
+          color: "#00f738"
+        - value: >-
+            ${get_low_bottom_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,additional_cost_template)
+            )}
+          color: "#12A141"
+        - value: >-
+            ${get_low_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,additional_cost_template))}
+          color: "#F3DC0C"
+        - value: >-
+            ${get_high_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,
+            additional_cost_template))}
+          color: "#E76821"
+        - value: >-
+            ${get_high_top_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,additional_cost_template))}
+          color: "#DC182F"
+    - entity: ${grid_import_sensor}
+      yaxis_id: y-energy
+      name: Grid import Chart
+      color: "#FF4646"
+      curve: stepline
+      float_precision: ${decimals_in_energy}
+      show:
+        extremas: false
+        in_header: false
+      type: line
+      stroke_width: 3
+      opacity: 0.75
+      extend_to: false
+      unit: ${energy_y_axis_unit}
+      group_by:
+        func: delta
+        duration: 1h
+    - entity: ${grid_import_sensor}
+      name: ${grid_import_text}
+      color: "#FF4646"
+      float_precision: ${decimals_in_energy}
+      show:
+        in_chart: false
+        in_header: raw
+      unit: ${energy_y_axis_unit}
+    - entity: ${battery_soc_sensor}
+      yaxis_id: y-SOC
+      name: ${battery_soc_text}
+      color: "#7a50d9"
+      float_precision: 0
+      show:
+        extremas: false
+        in_header: raw
+        header_color_threshold: true
+      type: line
+      stroke_width: 3
+      opacity: 0.75
+      extend_to: false
+      group_by:
+        func: avg
+        duration: 1h
+    - entity: ${nordpool_sensor}
+      color: "#7bff00"
+      float_precision: ${decimals_in_prices}
+      name: ${lowest_price_text}
+      unit: ${price_overview_unit}
+      show:
+        in_chart: false
+        legend_value: false
+      group_by:
+        func: min
+        duration: 2d
+      data_generator: ${get_future_total_prices(additional_cost_template)}
+    - entity: ${nordpool_sensor}
+      name: ${price_now_text}
+      type: column
+      unit: ${price_overview_unit}
+      show:
+        in_header: before_now
+        in_chart: false
+        header_color_threshold: true
+      float_precision: ${decimals_in_prices}
+      data_generator: ${get_future_total_prices(additional_cost_template)}
+      color_threshold:
+        - value: -1000
+          color: "#00f738"
+        - value: >-
+            ${get_low_bottom_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,additional_cost_template)
+            )}
+          color: "#12A141"
+        - value: >-
+            ${get_low_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,additional_cost_template))}
+          color: "#F3DC0C"
+        - value: >-
+            ${get_high_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,
+            additional_cost_template))}
+          color: "#E76821"
+        - value: >-
+            ${get_high_top_threshold_nordpool_price(get_total_min_nordpool_price(nordpool_sensor,additional_cost_template),
+            get_total_max_nordpool_price(nordpool_sensor,additional_cost_template))}
+          color: "#DC182F"
+    - entity: ${nordpool_sensor}
+      color: "#DC182F"
+      float_precision: ${decimals_in_prices}
+      name: ${highest_price_text}
+      unit: ${price_overview_unit}
+      show:
+        in_chart: false
+        legend_value: false
+      group_by:
+        func: max
+        duration: 2d
+      data_generator: ${get_future_total_prices(additional_cost_template)}
+layout_options:
+  grid_columns: full

Dashboards/energy_flow_gauge/readme.md

@@ -0,0 +1,87 @@
+# Energy price chart using nordpool prices.
+
+This is my atempt at a chart displaying todays prices and tomorows prices when available along with imported energy.
+- Upper and Lower price threshold is calculated for today+tomorows ***comming*** price.
+  - Orange is upper 3:rd of the pricing interval.
+  - Green is lower 3:rd of the prices interval.
+  - Red is the upper 10% of the pricing interval.
+
+![alt text](HA_energy_chart.jpg)
+
+# Pre-requirements
+
+This has not been tested on HA earlier than 2024.9 and requires the following HACS addons:
+
+- Nordpool - For getting energy prices.
+- Apex-Charts card
+- Config Template Card Card - For scripting inside the chart card.
+- lovelace-card-mod - For styling.
+
+The Nordpool entity should be changed from the default name to just "nordpool" as per the components installation instructions.
+
+# Installation
+- Copy - paste the raw card code from `card_nordpool_energy_chart.yaml` to your a new card on you lovelace dashboard. Add any card and replace the raw code that you can edit by clicking on the *SHOW CODE EDITOR* in the bottom left.
+
+
+# Configuration 
+
+Configure your Nordpool integration.
+
+In the chart-card you should change the following variables to suit your needs:
+
+  - Check so the `nordpool_sensor:` name is correct.
+  - The Grid import sensor name: `grid_import_sensor:` should be changed if not using Sigenergy system.
+  - The 
+  - Change `currency` if needed.
+  - `chart_price_cutoff_coerficient` from 0 to 1 to show more or less barheight under the minimum value.
+  - `decimals_in_prices` and `decimals_in_energy` to indicate how many decimals to show.
+  - `additional_cost_template` is used for adding extra costs if not added by nordpol sensor. It should be empty or start with a arithmetic operator.
+    - Example:
+    - additional_cost_template: '''*1.25 +(27.2 + 42.8 + 3.04 + 2.19 + 1.4) *1.25'''
+    - Ads 25% taxes and then other costs as specified by the grid operator with more taxes.
+  - Change the Now text to any label you want to apear `now_text: '''Now'''` besides the line showing current time in the chart.
+  - And any of the texts below to suit your language or prefferences.
+
+# Disable the Grid or Battery chart
+
+## Disable the Grid chart
+
+1. Comment out the update entity:
+    ```
+    entities:
+     - ${nordpool_sensor}
+     - ${battery_soc_sensor}
+     # - ${grid_import_sensor}
+   ```
+
+2. Delete the rows starting with  ```- entity: ${grid_import_sensor}``` and all rows under it until the next ```- entity:```. There are currently two such sections.
+
+## Disable the Battery SOC
+
+1. Comment out the update entity:
+    ```
+    entities:
+     - ${nordpool_sensor}
+     # - ${battery_soc_sensor}
+     - ${grid_import_sensor}
+   ```
+
+2. Delete the row starting with  ```- entity: ${battery_soc_sensor}``` and all rows under it until the next ```- entity:```. There is currently only one such section.
+
+
+# Performance concerns
+
+Most of the calculations are done serverside so it's important to have a good computer.
+
+If the chart flickers and takes long time to load, deactivate updating the chart with each change of battery charge and grid consumption:
+```
+entities:
+  - ${nordpool_sensor}
+  # - ${battery_soc_sensor}
+  # - ${grid_import_sensor}
+```
+
+
+--
+
+Happy savings!