npm - node-red-contrib-power-saver - Versions diffs - 3.0.7 → 3.1.0 - Mend

node-red-contrib-power-saver 3.0.7 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (106) hide show

package/docs/.vuepress/dist/nodes/strategy-input.html CHANGED Viewed

@@ -4,12 +4,12 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width,initial-scale=1">
     <meta name="generator" content="VuePress 2.0.0-beta.27">
-    <script src="https://c6.patreon.com/becomePatronButton.bundle.js"></script><link rel="icon" href="/euro.png"><title>Strategy input format | Power Saver</title><meta name="description" content="A Node-RED note to save money on hourly changing power prices">
-    <link rel="preload" href="/node-red-contrib-power-saver/assets/js/runtime~app.0d53f24f.js" as="script"><link rel="preload" href="/node-red-contrib-power-saver/assets/css/styles.e835bef6.css" as="style"><link rel="preload" href="/node-red-contrib-power-saver/assets/js/812.79dad458.js" as="script"><link rel="preload" href="/node-red-contrib-power-saver/assets/js/app.342dc054.js" as="script">
+    <link rel="icon" href="/euro.png"><title>Strategy input format | Power Saver</title><meta name="description" content="A Node-RED note to save money on hourly changing power prices">
+    <link rel="preload" href="/node-red-contrib-power-saver/assets/js/runtime~app.61982ee8.js" as="script"><link rel="preload" href="/node-red-contrib-power-saver/assets/css/styles.e835bef6.css" as="style"><link rel="preload" href="/node-red-contrib-power-saver/assets/js/812.79dad458.js" as="script"><link rel="preload" href="/node-red-contrib-power-saver/assets/js/app.5cf39ea6.js" as="script">
     <link rel="stylesheet" href="/node-red-contrib-power-saver/assets/css/styles.e835bef6.css">
   </head>
   <body>
-    <div id="app"><!--[--><div class="theme-container"><!--[--><header class="navbar"><div class="toggle-sidebar-button" title="toggle sidebar" aria-expanded="false" role="button" tabindex="0"><div class="icon" aria-hidden="true"><span></span><span></span><span></span></div></div><span><a href="/node-red-contrib-power-saver/" class=""><!----><span class="site-name">Power Saver</span></a></span><div class="navbar-links-wrapper" style=""><!--[--><!--]--><nav class="navbar-links can-hide"><!--[--><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/guide/" class="nav-link" aria-label="Guide"><!--[--><!--]--> Guide <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/nodes/" class="nav-link router-link-active" aria-label="Nodes"><!--[--><!--]--> Nodes <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/examples/" class="nav-link" aria-label="Examples"><!--[--><!--]--> Examples <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/contribute/" class="nav-link" aria-label="Contribute"><!--[--><!--]--> Contribute <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/changelog/" class="nav-link" aria-label="Changes"><!--[--><!--]--> Changes <!--[--><!--]--></a></div><!--]--></nav><!--[--><!--]--><button class="toggle-dark-button" title="toggle dark mode"><svg style="" class="icon" focusable="false" viewBox="0 0 32 32"><path d="M16 12.005a4 4 0 1 1-4 4a4.005 4.005 0 0 1 4-4m0-2a6 6 0 1 0 6 6a6 6 0 0 0-6-6z" fill="currentColor"></path><path d="M5.394 6.813l1.414-1.415l3.506 3.506L8.9 10.318z" fill="currentColor"></path><path d="M2 15.005h5v2H2z" fill="currentColor"></path><path d="M5.394 25.197L8.9 21.691l1.414 1.415l-3.506 3.505z" fill="currentColor"></path><path d="M15 25.005h2v5h-2z" fill="currentColor"></path><path d="M21.687 23.106l1.414-1.415l3.506 3.506l-1.414 1.414z" fill="currentColor"></path><path d="M25 15.005h5v2h-5z" fill="currentColor"></path><path d="M21.687 8.904l3.506-3.506l1.414 1.415l-3.506 3.505z" fill="currentColor"></path><path d="M15 2.005h2v5h-2z" fill="currentColor"></path></svg><svg style="display:none;" class="icon" focusable="false" viewBox="0 0 32 32"><path d="M13.502 5.414a15.075 15.075 0 0 0 11.594 18.194a11.113 11.113 0 0 1-7.975 3.39c-.138 0-.278.005-.418 0a11.094 11.094 0 0 1-3.2-21.584M14.98 3a1.002 1.002 0 0 0-.175.016a13.096 13.096 0 0 0 1.825 25.981c.164.006.328 0 .49 0a13.072 13.072 0 0 0 10.703-5.555a1.01 1.01 0 0 0-.783-1.565A13.08 13.08 0 0 1 15.89 4.38A1.015 1.015 0 0 0 14.98 3z" fill="currentColor"></path></svg></button><!----></div></header><!--]--><div class="sidebar-mask"></div><!--[--><aside class="sidebar"><nav class="navbar-links"><!--[--><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/guide/" class="nav-link" aria-label="Guide"><!--[--><!--]--> Guide <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/nodes/" class="nav-link router-link-active" aria-label="Nodes"><!--[--><!--]--> Nodes <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/examples/" class="nav-link" aria-label="Examples"><!--[--><!--]--> Examples <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/contribute/" class="nav-link" aria-label="Contribute"><!--[--><!--]--> Contribute <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/changelog/" class="nav-link" aria-label="Changes"><!--[--><!--]--> Changes <!--[--><!--]--></a></div><!--]--></nav><!--[--><!--]--><ul class="sidebar-links"><!--[--><!--[--><p class="sidebar-heading sidebar-item">Nodes</p><ul class=""><li><!--[--><a href="/node-red-contrib-power-saver/nodes/power-saver.md" class="nav-link sidebar-item" aria-label="Power Saver"><!--[--><!--]--> Power Saver <!--[--><!--]--></a><!----><!--]--></li><li><!--[--><p class="sidebar-item">Strategy nodes</p><ul class="sidebar-sub-items"><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-strategy-best-save.html" class="nav-link sidebar-item" aria-label="ps-strategy-best-save"><!--[--><!--]--> ps-strategy-best-save <!--[--><!--]--></a><!----><!--]--></li><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-strategy-lowest-price.html" class="nav-link sidebar-item" aria-label="ps-strategy-lowest-price"><!--[--><!--]--> ps-strategy-lowest-price <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--></li><li><!--[--><p class="sidebar-item">Utility nodes</p><ul class="sidebar-sub-items"><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-receive-price.html" class="nav-link sidebar-item" aria-label="ps-receive-price"><!--[--><!--]--> ps-receive-price <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--></li><li><!--[--><p class="sidebar-item">Grid tariff nodes</p><ul class="sidebar-sub-items"><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-elvia-add-tariff.html" class="nav-link sidebar-item" aria-label="ps-elvia-add-tariff"><!--[--><!--]--> ps-elvia-add-tariff <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--></li></ul><!--]--><!--[--><p class="sidebar-heading sidebar-item active">Data format</p><ul class=""><li><!--[--><a aria-current="page" href="/node-red-contrib-power-saver/nodes/strategy-input.html" class="router-link-active router-link-exact-active nav-link router-link-active sidebar-item active" aria-label="Strategy input format"><!--[--><!--]--> Strategy input format <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--><!--]--></ul><!--[--><!--]--></aside><!--]--><!--[--><main class="page"><!--[--><!--]--><div class="theme-default-content"><!--[--><h1 id="strategy-input-format" tabindex="-1"><a class="header-anchor" href="#strategy-input-format" aria-hidden="true">#</a> Strategy input format</h1><p>The common input for strategy nodes is a payload with a <code>priceData</code> array containing an object for each hour. Each object has a <code>value</code> wich is the price, and a <code>start</code> wich is the start time for the hour.</p><p>Example:</p><div class="language-json ext-json line-numbers-mode"><pre class="language-json"><code><span class="token punctuation">{</span>
+    <div id="app"><!--[--><div class="theme-container"><!--[--><header class="navbar"><div class="toggle-sidebar-button" title="toggle sidebar" aria-expanded="false" role="button" tabindex="0"><div class="icon" aria-hidden="true"><span></span><span></span><span></span></div></div><span><a href="/node-red-contrib-power-saver/" class=""><!----><span class="site-name">Power Saver</span></a></span><div class="navbar-links-wrapper" style=""><!--[--><!--]--><nav class="navbar-links can-hide"><!--[--><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/guide/" class="nav-link" aria-label="Guide"><!--[--><!--]--> Guide <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/nodes/" class="nav-link router-link-active" aria-label="Nodes"><!--[--><!--]--> Nodes <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/examples/" class="nav-link" aria-label="Examples"><!--[--><!--]--> Examples <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/contribute/" class="nav-link" aria-label="Contribute"><!--[--><!--]--> Contribute <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/changelog/" class="nav-link" aria-label="Changes"><!--[--><!--]--> Changes <!--[--><!--]--></a></div><div class="navbar-links-item"><a class="nav-link external" href="https://github.com/ottopaulsen/node-red-contrib-power-saver" rel="noopener noreferrer" target="_blank" aria-label="GitHub"><!--[--><!--]--> GitHub <span><svg class="icon outbound" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><!--[--><span class="sr-only">open in new window</span><!--]--></span><!--[--><!--]--></a></div><!--]--></nav><!--[--><!--]--><button class="toggle-dark-button" title="toggle dark mode"><svg style="" class="icon" focusable="false" viewBox="0 0 32 32"><path d="M16 12.005a4 4 0 1 1-4 4a4.005 4.005 0 0 1 4-4m0-2a6 6 0 1 0 6 6a6 6 0 0 0-6-6z" fill="currentColor"></path><path d="M5.394 6.813l1.414-1.415l3.506 3.506L8.9 10.318z" fill="currentColor"></path><path d="M2 15.005h5v2H2z" fill="currentColor"></path><path d="M5.394 25.197L8.9 21.691l1.414 1.415l-3.506 3.505z" fill="currentColor"></path><path d="M15 25.005h2v5h-2z" fill="currentColor"></path><path d="M21.687 23.106l1.414-1.415l3.506 3.506l-1.414 1.414z" fill="currentColor"></path><path d="M25 15.005h5v2h-5z" fill="currentColor"></path><path d="M21.687 8.904l3.506-3.506l1.414 1.415l-3.506 3.505z" fill="currentColor"></path><path d="M15 2.005h2v5h-2z" fill="currentColor"></path></svg><svg style="display:none;" class="icon" focusable="false" viewBox="0 0 32 32"><path d="M13.502 5.414a15.075 15.075 0 0 0 11.594 18.194a11.113 11.113 0 0 1-7.975 3.39c-.138 0-.278.005-.418 0a11.094 11.094 0 0 1-3.2-21.584M14.98 3a1.002 1.002 0 0 0-.175.016a13.096 13.096 0 0 0 1.825 25.981c.164.006.328 0 .49 0a13.072 13.072 0 0 0 10.703-5.555a1.01 1.01 0 0 0-.783-1.565A13.08 13.08 0 0 1 15.89 4.38A1.015 1.015 0 0 0 14.98 3z" fill="currentColor"></path></svg></button><!----></div></header><!--]--><div class="sidebar-mask"></div><!--[--><aside class="sidebar"><nav class="navbar-links"><!--[--><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/guide/" class="nav-link" aria-label="Guide"><!--[--><!--]--> Guide <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/nodes/" class="nav-link router-link-active" aria-label="Nodes"><!--[--><!--]--> Nodes <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/examples/" class="nav-link" aria-label="Examples"><!--[--><!--]--> Examples <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/contribute/" class="nav-link" aria-label="Contribute"><!--[--><!--]--> Contribute <!--[--><!--]--></a></div><div class="navbar-links-item"><a href="/node-red-contrib-power-saver/changelog/" class="nav-link" aria-label="Changes"><!--[--><!--]--> Changes <!--[--><!--]--></a></div><div class="navbar-links-item"><a class="nav-link external" href="https://github.com/ottopaulsen/node-red-contrib-power-saver" rel="noopener noreferrer" target="_blank" aria-label="GitHub"><!--[--><!--]--> GitHub <span><svg class="icon outbound" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewbox="0 0 100 100" width="15" height="15"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><!--[--><span class="sr-only">open in new window</span><!--]--></span><!--[--><!--]--></a></div><!--]--></nav><!--[--><!--]--><ul class="sidebar-links"><!--[--><!--[--><p class="sidebar-heading sidebar-item">Nodes</p><ul class=""><li><!--[--><a href="/node-red-contrib-power-saver/nodes/power-saver.md" class="nav-link sidebar-item" aria-label="Power Saver"><!--[--><!--]--> Power Saver <!--[--><!--]--></a><!----><!--]--></li><li><!--[--><p class="sidebar-item">Strategy nodes</p><ul class="sidebar-sub-items"><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-strategy-best-save.html" class="nav-link sidebar-item" aria-label="ps-strategy-best-save"><!--[--><!--]--> ps-strategy-best-save <!--[--><!--]--></a><!----><!--]--></li><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-strategy-lowest-price.html" class="nav-link sidebar-item" aria-label="ps-strategy-lowest-price"><!--[--><!--]--> ps-strategy-lowest-price <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--></li><li><!--[--><p class="sidebar-item">Utility nodes</p><ul class="sidebar-sub-items"><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-receive-price.html" class="nav-link sidebar-item" aria-label="ps-receive-price"><!--[--><!--]--> ps-receive-price <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--></li><li><!--[--><p class="sidebar-item">Grid tariff nodes</p><ul class="sidebar-sub-items"><li><!--[--><a href="/node-red-contrib-power-saver/nodes/ps-elvia-add-tariff.html" class="nav-link sidebar-item" aria-label="ps-elvia-add-tariff"><!--[--><!--]--> ps-elvia-add-tariff <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--></li></ul><!--]--><!--[--><p class="sidebar-heading sidebar-item active">Data format</p><ul class=""><li><!--[--><a aria-current="page" href="/node-red-contrib-power-saver/nodes/strategy-input.html" class="router-link-active router-link-exact-active nav-link router-link-active sidebar-item active" aria-label="Strategy input format"><!--[--><!--]--> Strategy input format <!--[--><!--]--></a><!----><!--]--></li></ul><!--]--><!--]--></ul><!--[--><!--]--></aside><!--]--><!--[--><main class="page"><!--[--><!--]--><div class="theme-default-content"><!--[--><h1 id="strategy-input-format" tabindex="-1"><a class="header-anchor" href="#strategy-input-format" aria-hidden="true">#</a> Strategy input format</h1><p>The common input for strategy nodes is a payload with a <code>priceData</code> array containing an object for each hour. Each object has a <code>value</code> which is the price, and a <code>start</code> which is the start time for the hour.</p><p>Example:</p><div class="language-json ext-json line-numbers-mode"><pre class="language-json"><code><span class="token punctuation">{</span>
   <span class="token property">&quot;priceData&quot;</span><span class="token operator">:</span> <span class="token punctuation">[</span>
     <span class="token punctuation">{</span>
       <span class="token property">&quot;value&quot;</span><span class="token operator">:</span> <span class="token number">0.9544</span><span class="token punctuation">,</span>
@@ -34,7 +34,7 @@
     <span class="token comment">// ... normally 24 or 48 hours</span>
   <span class="token punctuation">]</span>
 <span class="token punctuation">}</span>
-</code></pre><div class="line-numbers"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br></div></div><p>This format is used for:</p><ul><li>Output of the <code>ps-receive-price</code> node</li><li>Input and output of the <code>ps-xxx-add-tariff</code> nodes</li><li>Input for the strategy nodes (<code>ps-strategy-xxx-xxx</code>)</li></ul><!--]--></div><footer class="page-meta"><!----><div class="meta-item last-updated"><span class="meta-item-label">Last Updated: </span><span class="meta-item-info">12/12/2021, 2:17:07 PM</span></div><div class="meta-item contributors"><span class="meta-item-label">Contributors: </span><span class="meta-item-info"><!--[--><!--[--><span class="contributor" title="email: ottpau@gmail.com">Otto Paulsen</span><!----><!--]--><!--]--></span></div></footer><!----><!--[--><!--]--></main><!--]--></div><!----><!--]--></div>
-    <script src="/node-red-contrib-power-saver/assets/js/runtime~app.0d53f24f.js" defer></script><script src="/node-red-contrib-power-saver/assets/js/812.79dad458.js" defer></script><script src="/node-red-contrib-power-saver/assets/js/app.342dc054.js" defer></script>
+</code></pre><div class="line-numbers"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br></div></div><p>This format is used for:</p><ul><li>Output of the <code>ps-receive-price</code> node</li><li>Input and output of the <code>ps-xxx-add-tariff</code> nodes</li><li>Input for the strategy nodes (<code>ps-strategy-xxx-xxx</code>)</li></ul><!--]--></div><footer class="page-meta"><!----><div class="meta-item last-updated"><span class="meta-item-label">Last Updated: </span><span class="meta-item-info">12/20/2021, 10:10:18 PM</span></div><!----></footer><!----><!--[--><!--]--></main><!--]--></div><!----><!--]--></div>
+    <script src="/node-red-contrib-power-saver/assets/js/runtime~app.61982ee8.js" defer></script><script src="/node-red-contrib-power-saver/assets/js/812.79dad458.js" defer></script><script src="/node-red-contrib-power-saver/assets/js/app.5cf39ea6.js" defer></script>
   </body>
 </html>

package/docs/.vuepress/public/logo.png CHANGED Viewed

Binary file

package/docs/README.md CHANGED Viewed

@@ -3,7 +3,7 @@ home: true
 heroImage: /logo.png
 heroAlt: Power Saver
 heroText: node-red-contrib-power-saver
-tagline: Save money when power prices are changing every hour
+tagline: A collection of nodes to Node-RED that automates saving money on variable electricity prices
 actions:
   - text: Guide
     link: /guide
@@ -18,11 +18,11 @@ features:
   - title: Automatic scheduling
     details: Automatically calculate best plan and send signal to turn on and off.
   - title: Best Save Strategy
-    details: Postpone power consumption when there is most to save.
+    details: Postpone power consumption when there is most to save, perfect for the water heater.
   - title: Lowest Price Strategy
-    details: Turn on power when the prices are the lowest in a given period.
-  - title: Integrate with grid tariff APIs
-    details: Elvia grid tariff API already supported. Others are easy to add.
+    details: Turn on power when the prices are the lowest, perfect for smart charging or heating.
+  - title: Add variable grid tariff
+    details: Automatically add values that varies on fixed hours, or use API to get grid tariff from Elvia.
   - title: Perfect with Home Assistant
     details: Use Home Assistant with Node-RED and control switches via service calls.
   - title: Tibber and Nord Pool
@@ -30,3 +30,5 @@ features:
 footer: Created by Otto Paulsen<br/><br/><a href="https://www.patreon.com/bePatron?u=65948417" data-patreon-widget-type="become-patron-button">Become a Patron!</a>
 footerHtml: true
 ---
+This is a collection of nodes for the popular [Node-RED](https://nodered.org/) that you can use to save money on variable electricity prices. Node-RED is a widely used low-code programming tool that can be used together with many smart home solutions to create automations.

package/docs/changelog/README.md CHANGED Viewed

@@ -6,13 +6,30 @@ sidebar: "auto"
 List the most significant changes, starting in version 1.0.9.
+## 3.1.0
+- New node `ps-general-add-tariff` to add values that varies af fixed times during the day.
+## 3.0.10
+- Fix bug in ps-elvia-add-tariff so it connects to API.
+## 3.0.9
+- Fix Nord Pool input for current state node, to read data when payload is set to entity.
+## 3.0.8
+- Fix bug in Lowest Price node when period goes over midnight.
+- Fix documentation - lots of pages were failing.
 ## 3.0.7
 - Fix Nord Pool current state node input.
 ## 3.0.6
-- Remove non-existant node from package.json.
+- Remove non-existent node from package.json.
 ## 3.0.5
@@ -20,7 +37,7 @@ List the most significant changes, starting in version 1.0.9.
 ## 3.0.4
-- Remove `null`-values from Nordpool data for `tomorrow`.
+- Remove `null`-values from Nord Pool data for `tomorrow`.
 ## 3.0.3
@@ -34,7 +51,7 @@ List the most significant changes, starting in version 1.0.9.
 ## 3.0.1
-- Fix so elvia subscripion key is stored as credential
+- Fix so elvia subscription key is stored as credential
 - Fix bug on config for strategy nodes. Config was not saved properly.
 - Remove double output bug, and better handling when hoursOn > period
@@ -44,7 +61,7 @@ List the most significant changes, starting in version 1.0.9.
 - New node `ps-strategy-best-save` is replacing old node `Power Saver` together with the new `ps-receive-price` node.
 - Add new strategy node: `ps-strategy-lowest-price`.
 - Add new node: `ps-receive-price`.
-- Add gridd tariff for Elvia customers, using the `ps-elvia-add-tariff` node.
+- Add grid tariff for Elvia customers, using the `ps-elvia-add-tariff` node.
 - New documentation.
 - Change node category to Power Saver.
@@ -68,7 +85,7 @@ List the most significant changes, starting in version 1.0.9.
 ## 2.0.2
-- Fix so Nordpool data can be read directly from the current state node
+- Fix so Nord Pool data can be read directly from the current state node
 ## 2.0.1

package/docs/contribute/README.md CHANGED Viewed

@@ -32,7 +32,7 @@ It would be very nice to get more examples into the documentation. If you have m
 ## Bug reports
-If you find a bug, please describe it thouroghly and make a [GitHub issue](https://github.com/ottopaulsen/node-red-contrib-power-saver/issues). If the bug is related to the scheduling, **please provide the full output from output 3** on the strategy node.
+If you find a bug, please describe it thoroughly and make a [GitHub issue](https://github.com/ottopaulsen/node-red-contrib-power-saver/issues). If the bug is related to the scheduling, **please provide the full output from output 3** on the strategy node.
 ## Ideas

package/docs/examples/README.md CHANGED Viewed

@@ -3,3 +3,7 @@
 [Nord Pool and `current state` node in HA](./example-nordpool-current-state)
 [Nord Pool and `events: state` node in HA](./example-nordpool-events-state)
 [Tibber and mqtt](./example-tibber-mqtt)
+## User provided examples
+[Output schedule to a sensor entity](./example-next-schedule-entity.md) (by Stefan)

package/docs/examples/example-next-schedule-entity.md ADDED Viewed

@@ -0,0 +1,41 @@
+# Output schedule to a sensor entity
+This example was contributed by [Stefan](https://github.com/oakhill87)
+Note: Requires [Node-RED Companion Integration](https://github.com/zachowj/hass-node-red).
+![Sensor with timestamp and attributes](../images/next-schedule-sensor.png) ![Sensor flow](../images/next-schedule-flow.png)
+This JavaScript code snippet can be pasted into a Function-node. When connected to the schedule-output (3) from Best Save, it will loop through the array of available hours and find the next timestamp where a power saving schedule is initated.
+```js
+    for (var i = 0; i < msg.payload.hours.length; i++) {
+    if (msg.payload.hours[i].onOff != true) {
+        var schedule = {time: msg.payload.hours[i].start, topic: "Neste spareperiode", length: msg.payload.config.maxHoursToSaveInSequence, savings: msg.payload.hours[i].saving}
+        break}
+    else {
+        var schedule = {time: false, topic: "Ingen aksjoner", length: "0", savings: "0"}
+    }
+    }
+    var schedule_array = {upcoming: schedule}
+    return [schedule_array]
+```
+This will return the following:
+- msg.upcoming.time = Timestamp if saving is scheduled - False if no schedule with the current available prices.
+- msg.upcoming.length = How long the next saving will last - set to 0 if no schedule.
+- msg.upcoming.savings = Estimated savings retrieved from the node.
+## Setup
+1. Paste the code above into a Function node and connect it to the schedule output.
+2. Create an entity node from the Node-RED Companion Integration, and configure it according to the steps below:
+The msg.topic is currently not used, but in case you'd want to specify dynamic names in the sensor instead of in the frontend, go ahead and add them as attributes using the following configuration:
+1. **State**: msg.upcoming.time
+2. Attribute key **Duration**: msg.upcoming.length
+3. Attribute key **Savings**: msg.upcoming.savings
+<img src="../images/next-schedule-entity.png" width="25%">
+## To-do
+If you find any bugs, let me know, but as long as the payload doesn't change it should work.

package/docs/examples/example-nordpool-current-state.md CHANGED Viewed

@@ -10,157 +10,177 @@ In this example, data is read from the Nord Pool sensor in HA via the `current s
 ```json:no-line-numbers
 [
-  {
-    "id": "e2578f6a.210a8",
-    "type": "debug",
-    "z": "d938c47f.3398f8",
-    "name": "Nord Pool result",
-    "active": true,
-    "tosidebar": true,
-    "console": false,
-    "tostatus": false,
-    "complete": "true",
-    "targetType": "full",
-    "statusVal": "",
-    "statusType": "auto",
-    "x": 820,
-    "y": 440,
-    "wires": []
-  },
-  {
-    "id": "48bcdcca.fe42a4",
-    "type": "api-current-state",
-    "z": "d938c47f.3398f8",
-    "name": "Read Nord Pool",
-    "server": "ec4a12a1.b2be9",
-    "version": 2,
-    "outputs": 1,
-    "halt_if": "",
-    "halt_if_type": "str",
-    "halt_if_compare": "is",
-    "entity_id": "sensor.nordpool_kwh_trheim_nok_3_095_025",
-    "state_type": "str",
-    "blockInputOverrides": false,
-    "outputProperties": [
-      {
-        "property": "payload",
-        "propertyType": "msg",
-        "value": "",
-        "valueType": "entityState"
-      },
-      {
-        "property": "payload",
-        "propertyType": "msg",
-        "value": "",
-        "valueType": "entity"
-      }
-    ],
-    "x": 280,
-    "y": 380,
-    "wires": [["428d7c7ca88db95f"]]
-  },
-  {
-    "id": "97cc8e58.4247a",
-    "type": "inject",
-    "z": "d938c47f.3398f8",
-    "name": "",
-    "props": [
-      {
-        "p": "payload"
-      },
-      {
-        "p": "topic",
-        "vt": "str"
-      }
-    ],
-    "repeat": "3600",
-    "crontab": "",
-    "once": true,
-    "onceDelay": 0.1,
-    "topic": "",
-    "payloadType": "date",
-    "x": 110,
-    "y": 380,
-    "wires": [["48bcdcca.fe42a4"]]
-  },
-  {
-    "id": "a6f2769b.1a62a8",
-    "type": "api-call-service",
-    "z": "d938c47f.3398f8",
-    "name": "Turn on VVB",
-    "server": "ec4a12a1.b2be9",
-    "version": 3,
-    "debugenabled": false,
-    "service_domain": "switch",
-    "service": "turn_on",
-    "entityId": "switch.varmtvannsbereder_switch",
-    "data": "",
-    "dataType": "jsonata",
-    "mergecontext": "",
-    "mustacheAltTags": false,
-    "outputProperties": [],
-    "queue": "none",
-    "x": 810,
-    "y": 320,
-    "wires": [[]]
-  },
-  {
-    "id": "9fc75126.65dd3",
-    "type": "api-call-service",
-    "z": "d938c47f.3398f8",
-    "name": "Turn off VVB",
-    "server": "ec4a12a1.b2be9",
-    "version": 3,
-    "debugenabled": true,
-    "service_domain": "switch",
-    "service": "turn_off",
-    "entityId": "switch.varmtvannsbereder_switch",
-    "data": "",
-    "dataType": "json",
-    "mergecontext": "",
-    "mustacheAltTags": false,
-    "outputProperties": [],
-    "queue": "none",
-    "x": 810,
-    "y": 360,
-    "wires": [[]]
-  },
-  {
-    "id": "428d7c7ca88db95f",
-    "type": "ps-receive-price",
-    "z": "d938c47f.3398f8",
-    "name": "Price Receiver",
-    "x": 460,
-    "y": 380,
-    "wires": [["4147bf0b99fe626f"]]
-  },
-  {
-    "id": "4147bf0b99fe626f",
-    "type": "ps-strategy-best-save",
-    "z": "d938c47f.3398f8",
-    "name": "Best Save",
-    "maxHoursToSaveInSequence": "4",
-    "minHoursOnAfterMaxSequenceSaved": "1",
-    "minSaving": "0.03",
-    "sendCurrentValueWhenRescheduling": true,
-    "outputIfNoSchedule": "true",
-    "scheduleOnlyFromCurrentTime": "false",
-    "x": 630,
-    "y": 380,
-    "wires": [["a6f2769b.1a62a8"], ["9fc75126.65dd3"], ["e2578f6a.210a8"]]
-  },
-  {
-    "id": "ec4a12a1.b2be9",
-    "type": "server",
-    "name": "Home Assistant",
-    "version": 2,
-    "addon": true,
-    "rejectUnauthorizedCerts": true,
-    "ha_boolean": "y|yes|true|on|home|open",
-    "connectionDelay": true,
-    "cacheJson": true,
-    "heartbeat": false,
-    "heartbeatInterval": 30
-  }
+    {
+        "id": "e2578f6a.210a8",
+        "type": "debug",
+        "z": "d938c47f.3398f8",
+        "name": "Nord Pool result",
+        "active": false,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "true",
+        "targetType": "full",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 820,
+        "y": 440,
+        "wires": []
+    },
+    {
+        "id": "48bcdcca.fe42a4",
+        "type": "api-current-state",
+        "z": "d938c47f.3398f8",
+        "name": "Read Nord Pool",
+        "server": "ec4a12a1.b2be9",
+        "version": 2,
+        "outputs": 1,
+        "halt_if": "",
+        "halt_if_type": "str",
+        "halt_if_compare": "is",
+        "entity_id": "sensor.nordpool_kwh_trheim_nok_3_095_025",
+        "state_type": "str",
+        "blockInputOverrides": false,
+        "outputProperties": [
+            {
+                "property": "payload",
+                "propertyType": "msg",
+                "value": "",
+                "valueType": "entity"
+            }
+        ],
+        "x": 280,
+        "y": 380,
+        "wires": [
+            [
+                "428d7c7ca88db95f"
+            ]
+        ]
+    },
+    {
+        "id": "97cc8e58.4247a",
+        "type": "inject",
+        "z": "d938c47f.3398f8",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "3600",
+        "crontab": "",
+        "once": true,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payloadType": "date",
+        "x": 110,
+        "y": 380,
+        "wires": [
+            [
+                "48bcdcca.fe42a4"
+            ]
+        ]
+    },
+    {
+        "id": "a6f2769b.1a62a8",
+        "type": "api-call-service",
+        "z": "d938c47f.3398f8",
+        "name": "Turn on VVB",
+        "server": "ec4a12a1.b2be9",
+        "version": 3,
+        "debugenabled": false,
+        "service_domain": "switch",
+        "service": "turn_on",
+        "entityId": "switch.varmtvannsbereder_switch",
+        "data": "",
+        "dataType": "jsonata",
+        "mergecontext": "",
+        "mustacheAltTags": false,
+        "outputProperties": [],
+        "queue": "none",
+        "x": 810,
+        "y": 340,
+        "wires": [
+            []
+        ]
+    },
+    {
+        "id": "9fc75126.65dd3",
+        "type": "api-call-service",
+        "z": "d938c47f.3398f8",
+        "name": "Turn off VVB",
+        "server": "ec4a12a1.b2be9",
+        "version": 3,
+        "debugenabled": true,
+        "service_domain": "switch",
+        "service": "turn_off",
+        "entityId": "switch.varmtvannsbereder_switch",
+        "data": "",
+        "dataType": "json",
+        "mergecontext": "",
+        "mustacheAltTags": false,
+        "outputProperties": [],
+        "queue": "none",
+        "x": 810,
+        "y": 380,
+        "wires": [
+            []
+        ]
+    },
+    {
+        "id": "428d7c7ca88db95f",
+        "type": "ps-receive-price",
+        "z": "d938c47f.3398f8",
+        "name": "Price Receiver",
+        "x": 460,
+        "y": 380,
+        "wires": [
+            [
+                "4147bf0b99fe626f"
+            ]
+        ]
+    },
+    {
+        "id": "4147bf0b99fe626f",
+        "type": "ps-strategy-best-save",
+        "z": "d938c47f.3398f8",
+        "name": "Best Save",
+        "maxHoursToSaveInSequence": "4",
+        "minHoursOnAfterMaxSequenceSaved": "1",
+        "minSaving": "0.03",
+        "sendCurrentValueWhenRescheduling": true,
+        "outputIfNoSchedule": "true",
+        "scheduleOnlyFromCurrentTime": "false",
+        "x": 630,
+        "y": 380,
+        "wires": [
+            [
+                "a6f2769b.1a62a8"
+            ],
+            [
+                "9fc75126.65dd3"
+            ],
+            [
+                "e2578f6a.210a8"
+            ]
+        ]
+    },
+    {
+        "id": "ec4a12a1.b2be9",
+        "type": "server",
+        "name": "Home Assistant",
+        "version": 2,
+        "addon": true,
+        "rejectUnauthorizedCerts": true,
+        "ha_boolean": "y|yes|true|on|home|open",
+        "connectionDelay": true,
+        "cacheJson": true,
+        "heartbeat": false,
+        "heartbeatInterval": 30
+    }
 ]
 ```

package/docs/faq/README.md ADDED Viewed

@@ -0,0 +1,23 @@
+# FAQ
+## Why does the Best Save node not turn off the most expensive hours?
+Here is an example:
+![Mysterious saving](../images/mysterious-plan.png)
+The purple strokes shows the savings. The Best Save node is configured to save up to 5 hours in a sequence, and only when saving is more than 0.05 NOK.
+Why does it not save the most expensive period?
+If you move the saving-period 4-5 hours earlier, the most expensive hours would have been saved. Why is this not better?
+Remember that the power that is not used during the saving-period, will be used immediately after. At least, that is the idea, and the normal behaviour if the power consumer is a water heater or another heater controlled by a thermostat. So, then the power would be used one of the blue hours in stead of the green cheaper hour.
+Also remember that when saving, you do not save the full price. You only save what is the difference between the price during the saved hours and the price the hour immediately after.
+So the best saving is found where this difference is the largest, and that is not always by turning off the most expensive hours. In the case above, the difference is largest when you turn off the hours marked wit a purple stroke, so this is the best saving you can get.
+Of course, if you expand the saving period from 5 to 10 hours you would save even more, but that would be a different case, and you can do that if it is ok for you to turn off for that long time.
+Another alternative is to reduce the minimum saving from 0.05 to 0.001. Then the 3 first red hours would be turned off, but the last red would have to be on, in order to get one hour on until the next 5-hour period off. This would however not save you for much money, since the hour that is on is almost as expensive as the hours you would turn off.