smart-nodes 0.3.36 → 0.4.0

package/scheduler/locales/en-US/scheduler.html

@@ -0,0 +1,30 @@
+<script type="text/html" data-help-name="smart_scheduler">
+    <p>
+        This node sends the corresponding messages to the output at the specified times.
+    </p>
+    <p>
+        The following topics are accepted:
+        <table>
+            <thead>
+                <tr>
+                    <th>Topic</th>
+                    <th>Description</th>
+                </tr>
+            </thead>
+            <tbody>
+                <tr>
+                    <td><code>enable</code></td>
+                    <td>Enables the scheduler.</td>
+                </tr>
+                <tr>
+                    <td><code>disable</code></td>
+                    <td>Disables the scheduler.</td>
+                </tr>
+                <tr>
+                    <td><code>set_state</code></td>
+                    <td>Enables the scheduler if <code>msg.payload = true</code> or disables the scheduler if <code>msg.payload = false</code>.</td>
+                </tr>
+            </tbody>
+        </table>
+    </p>
+</script>

package/scheduler/locales/en-US/scheduler.json

@@ -0,0 +1,21 @@
+{
+    "scheduler": {
+        "ui": {
+            "name": "Name",
+            "scheduler_enabled": "Scheduler enabled",
+            "schedules": "Schedules",
+
+            "system_start": "System start",
+            "save_state": "Save state",
+            "send_after_start": "Send last message 10 seconds after start",
+
+            "monday": "Monday",
+            "tuesday": "Tuesday",
+            "wednesday": "Wednesday",
+            "thursday": "Thursday",
+            "friday": "Friday",
+            "saturday": "Saturday",
+            "sunday": "Sunday"
+        }
+    }
+}

package/scheduler/scheduler.html

@@ -1,31 +1,3 @@
-<script type="text/html" data-template-name="smart_scheduler">
-    <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
-        <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name" />
-    </div>
-    <div class="form-row">
-        <label for="node-input-enabled"></label>
-        <input type="checkbox" id="node-input-enabled" style="width: 20px;" />
-        <label for="node-input-enabled" style="width: 200px;">Scheduler aktiviert</label>
-    </div>
-    <div class="form-row" style="margin-bottom: 2px;">
-        <p class="text-center"><i class="fa fa-list"></i>&nbsp;<strong>Schedules</strong></p>
-    </div>
-    <div class="form-row node-scheduler-schedules-row">
-        <ol id="node-scheduler-schedules"></ol>
-    </div>
-    <hr/>
-    <h4 style="margin: 0.5rem 0;">Systemstart</h4>
-    <div class="form-row">
-        <input type="checkbox" id="node-input-save_state" style="width: 20px;" />
-        <label for="node-input-save_state" style="width: calc(100% - 30px);">Zustand speichern</label>
-    </div>
-    <div class="form-row" id="resend_on_start_row">
-        <input type="checkbox" id="node-input-resend_on_start" style="width: 20px;" />
-        <label for="node-input-resend_on_start" style="width: calc(100% - 30px);">Letze Nachricht 10 Sekunden nach dem Start senden</label>
-    </div>
-</script>
-
 <script type="text/html" data-template-scheduler-row="">
     <div>
         <div style="display: inline-block; width: 30px; margin-left: 10px;">
@@ -224,13 +196,13 @@
                                 default: "",
                                 multiple: true,
                                 options: [
-                                    { value: "1", label: "Montag" },
-                                    { value: "2", label: "Dienstag" },
-                                    { value: "3", label: "Mittwoch" },
-                                    { value: "4", label: "Donnerstag" },
-                                    { value: "5", label: "Freitag" },
-                                    { value: "6", label: "Samstag" },
-                                    { value: "0", label: "Sonntag" }
+                                    { value: "1", label: node._("scheduler.ui.monday") },
+                                    { value: "2", label: node._("scheduler.ui.tuesday") },
+                                    { value: "3", label: node._("scheduler.ui.wednesday") },
+                                    { value: "4", label: node._("scheduler.ui.thursday") },
+                                    { value: "5", label: node._("scheduler.ui.friday") },
+                                    { value: "6", label: node._("scheduler.ui.saturday") },
+                                    { value: "0", label: node._("scheduler.ui.sunday") }
                                 ],
                             },
                         ],
@@ -296,6 +268,7 @@
         oneditsave: function ()
         {
             let node = this;
+            
             node.schedules = [];
 
             let scheduleList = $("#node-scheduler-schedules");
@@ -327,33 +300,30 @@
     });
 </script>
 
-<script type="text/html" data-help-name="smart_scheduler">
-    <p>
-        Diese Node sendet zu den angegebenen Zeitpunkten die entsprechenden Nachrichten an den Ausgang.
-        <p>
-            Folgende topics werden akzeptiert:
-            <table>
-                <thead>
-                    <tr>
-                        <th>Topic</th>
-                        <th>Beschreibung</th>
-                    </tr>
-                </thead>
-                <tbody>
-                    <tr>
-                        <td><code>enable</code></td>
-                        <td>Aktiviert den Scheduler.</td>
-                    </tr>
-                    <tr>
-                        <td><code>disable</code></td>
-                        <td>Deaktiviert den Scheduler.</td>
-                    </tr>
-                    <tr>
-                        <td><code>set_state</code></td>
-                        <td>Aktiviert den Scheduler, wenn <code>msg.payload = true</code> oder deaktiviert den Scheduler, wenn <code>msg.payload = false</code>.</td>
-                    </tr>
-                </tbody>
-            </table>
-        </p>
-        </p>
+<script type="text/html" data-template-name="smart_scheduler">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="scheduler.ui.name"></span></label>
+        <input type="text" id="node-input-name" data-i18n="[placeholder]scheduler.ui.name" />
+    </div>
+    <div class="form-row">
+        <label for="node-input-enabled"></label>
+        <input type="checkbox" id="node-input-enabled" style="width: 20px;" />
+        <label for="node-input-enabled" style="width: 200px;" data-i18n="scheduler.ui.scheduler_enabled"></label>
+    </div>
+    <div class="form-row" style="margin-bottom: 2px;">
+        <p class="text-center"><i class="fa fa-list"></i> <strong data-i18n="scheduler.ui.schedules"></strong></p>
+    </div>
+    <div class="form-row node-scheduler-schedules-row">
+        <ol id="node-scheduler-schedules"></ol>
+    </div>
+    <hr/>
+    <h4 style="margin: 0.5rem 0;" data-i18n="scheduler.ui.system_start"></h4>
+    <div class="form-row">
+        <input type="checkbox" id="node-input-save_state" style="width: 20px;" />
+        <label for="node-input-save_state" style="width: calc(100% - 30px);" data-i18n="scheduler.ui.save_state"></label>
+    </div>
+    <div class="form-row" id="resend_on_start_row">
+        <input type="checkbox" id="node-input-resend_on_start" style="width: 20px;" />
+        <label for="node-input-resend_on_start" style="width: calc(100% - 30px);" data-i18n="scheduler.ui.send_after_start"></label>
+    </div>
 </script>

package/scheduler/scheduler.js

@@ -7,29 +7,52 @@ module.exports = function (RED)
         const node = this;
         RED.nodes.createNode(node, config);
 
+
+        // ###################
+        // # Class constants #
+        // ###################
+
+
+        // #######################
+        // # Global help objects #
+        // #######################
         const smart_context = require("../persistence.js")(RED);
         const helper = require("../smart_helper.js");
 
+
+        // #####################
+        // # persistent values #
+        // #####################
         var node_settings = {
             enabled: config.enabled,
-            lastMessage: null,
+            last_message: null,
         };
 
+
+        // load or delete saved values
         if (config.save_state)
-        {
-            // load old saved values
             node_settings = Object.assign(node_settings, smart_context.get(node.id));
-        }
         else
-        {
-            // delete old saved values
             smart_context.del(node.id);
-        }
 
+
+        // ##################
+        // # Dynamic config #
+        // ##################
+
+
+        // ##################
+        // # Runtime values #
+        // ##################
+
+        // Here the setTimeout return value is stored when the next timeout should happen
         let timeout = null;
+
+        // This is date when the next event schould be raised
         let nextEvent = null;
 
-        // prepare schedules
+
+        // Initially prepare schedules config object
         setTimeout(() =>
         {
             for (let i = 0; i < config.schedules.length; i++)
@@ -47,48 +70,17 @@ module.exports = function (RED)
         }, 1000);
 
 
+        // ###############
+        // # Node events #
+        // ###############
         node.on("input", function (msg)
         {
-            switch (helper.getTopicName(msg.topic))
-            {
-                case "enable":
-                    if (node_settings.enabled)
-                        return;
-
-                    node_settings.enabled = true;
-                    if (config.save_state)
-                        smart_context.set(node.id, node_settings);
-                    break;
-
-                case "disable":
-                    if (!node_settings.enabled)
-                        return;
-
-                    node_settings.enabled = false;
-                    if (config.save_state)
-                        smart_context.set(node.id, node_settings);
-                    break;
-
-                case "set_state":
-                    if (node_settings.enabled == !!msg.payload)
-                        return;
-
-                    node_settings.enabled = !!msg.payload;
-                    if (config.save_state)
-                        smart_context.set(node.id, node_settings);
-                    break;
-
-                default:
-                    return;
-            }
-
-            if (node_settings.enabled)
-                initTimeouts();
-            else
-                clearTimeouts();
+            handleTopic(msg);
 
             setStatus();
-            smart_context.set(node.id, node_settings);
+
+            if (config.save_state)
+                smart_context.set(node.id, node_settings);
         });
 
         node.on("close", function ()
@@ -100,6 +92,33 @@ module.exports = function (RED)
             }
         });
 
+
+        // #####################
+        // # Private functions #
+        // #####################
+
+        // This is the main function which handles all topics that was received.
+        let handleTopic = msg =>
+        {
+            let real_topic = helper.getTopicName(msg.topic);
+
+            if (real_topic == "set_state")
+                real_topic = (!!msg.payload) ? "enable" : "disable";
+
+            switch (real_topic)
+            {
+                case "enable":
+                    node_settings.enabled = true;
+                    initNextTimeout();
+                    break;
+
+                case "disable":
+                    node_settings.enabled = false;
+                    break;
+            }
+        }
+
+        // calculate which event should occur nect
         let initNextTimeout = () =>
         {
             let minIndex = null;
@@ -120,16 +139,28 @@ module.exports = function (RED)
                 return;
             }
 
+            // Stop timeout if any
+            if (timeout != null)
+            {
+                clearTimeout(timeout);
+                timeout = null;
+            }
+
             nextEvent = config.schedules[minIndex].nextEvent;
             let waitTime = nextEvent.getTime() - (new Date()).getTime();
-            timeout = setTimeout(raiseEvent, waitTime, minIndex);
+            timeout = setTimeout(() =>
+            {
+                timeout = null;
+                raiseEvent(minIndex);
+            }, waitTime);
         }
 
+        // calculates the next time when the scheduled i-th entry should run.
         let calcNextEvent = i =>
         {
             const schedule = config.schedules[i];
 
-            // If no day is checked then we cannot it is never raised
+            // If no day is checked it is never raised
             if (!schedule.days || schedule.days.length == 0)
                 return null;
 
@@ -174,7 +205,7 @@ module.exports = function (RED)
                 schedule.second
             );
 
-            // console.log({
+            // helper.log({
             //     i,
             //     findNextDay,
             //     nextEvent
@@ -183,6 +214,7 @@ module.exports = function (RED)
             return nextEvent;
         }
 
+        // Send the i-th entry to the output
         let raiseEvent = i =>
         {
             const schedule = config.schedules[i];
@@ -191,8 +223,8 @@ module.exports = function (RED)
                 return;
 
             timeout = null;
-            node.send(schedule.message);
-            node_settings.lastMessage = schedule.message;
+            node.send(helper.cloneObject(schedule.message));
+            node_settings.last_message = schedule.message;
 
             if (config.save_state)
                 smart_context.set(node.id, node_settings);
@@ -233,11 +265,11 @@ module.exports = function (RED)
             }
         }
 
-        if (config.save_state && config.resend_on_start && node_settings.lastMessage != null)
+        if (config.save_state && config.resend_on_start && node_settings.last_message != null)
         {
             setTimeout(() =>
             {
-                node.send(node_settings.lastMessage);
+                node.send(helper.cloneObject(node_settings.last_message));
             }, 10000);
         }
     }

package/shutter/locales/de-DE/shutter.html

@@ -0,0 +1,127 @@
+
+<script type="text/html" data-help-name="smart_shutter-control">
+    <p>
+        <b>Hinweis:</b> Smart Nodes verwenden Topics im Format <code>name#nummer</code>, damit können verschiedene Smart Nodes mit dem gleichen Topic angesteuert werden.<br/>
+        Diese Node verwendet nur den Teil <code>name</code>. <code>#</code> und <code>nummer</code> sind dabei optional.
+    </p>
+    <p>
+        Diese Node steuert Rollladen oder Jalousien.
+        Es gibt 3 Ausgänge die angesteuert werden können:
+        <ol>
+            <li><b>Auf/Ab:</b> <code>msg.payload = false</code> lässt den Rollladen nach oben fahren und <code>msg.payload = true</code> lässt den Rollladen nach unten fahren.</li>
+            <li><b>Stop:</b> <code>msg.payload = true</code> lässt den Rollladen stoppen.</li>
+            <li><b>Position:</b> <code>msg.payload = 42</code> Lässt den Rollladen auf 42% fahren.</li>
+        </ol>
+        Die Ausgänge sind den jeweiligen KNX Gruppenadressen zuzuordnen.
+    </p>
+    <p>
+        Diese Node erwartet folgende Topics als Eingang:<br/>
+        <table>
+            <thead>
+                <tr>
+                    <th>Topic</th>
+                    <th>Beschreibung</th>
+                    <th>msg.payload == false wird ignoriert</th>
+                </tr>
+            </thead>
+            <tbody>
+                <tr>
+                    <td><code>status</code> oder <code>status_position</code></td>
+                    <td>
+                        Meldet der Node die aktuelle Position.
+                        Dadurch kann die Node feststellen in welche Richtung ein Rollladen als letztes gefahren ist.
+                        Dies wird für das topic <b>toggle</b> benötigt um die nächste Laufrichtung bei einer 1-Tasten Bedienung zu ermitteln.
+                    </td>
+                </tr>
+                <tr>
+                    <td><code>up_down</code></td>
+                    <td>
+                        Nimmt einen Befehl von Home Assistant entgegen um informiert zu werden ob der Rollladen läuft und in welche Richtung.<br/>
+                        <strong>Wichtig:</strong> Dieses Topic startet den Rollladen <u>nicht</u>, da die Gruppenadresse direkt mit dem Jalousiemodul verbunden sein muss.
+                    </td>
+                    <td>Nein</td>
+                </tr>
+                <tr>
+                    <td><code>short_up_down</code></td>
+                    <td>
+                        Sendet bei <code>msg.payload = false</code> einen kurzen Hochfahrbefehl und bei <code>msg.payload = true</code> einen kurzen Runterfahrbefehl.<br/>
+                        Es wird dabei die im Baustein hinterlegte Zeit verwendet. Diese kann aber durch setzen von <code>msg.time_on = 1500</code> oder <code>msg.time_on = "1.5s"</code> einmalig überschrieben werden.
+                    </td>
+                    <td>Nein</td>
+                </tr>
+                <tr>
+                    <td><code>up</code></td>
+                    <td>Sendet einen Hochfahrbefehl, falls der Rollladen nicht bereits nach oben fährt. Ggf. wird vorher noch ein Stop-Befehl gesendet.</td>
+                    <td>Ja</td>
+                </tr>
+                <tr>
+                    <td><code>up_stop</code></td>
+                    <td>Sendet abwechselnd einen Stop- und einen Hochfahrbefehl.</td>
+                    <td>Ja</td>
+                </tr>
+                <tr>
+                    <td><code>down</code></td>
+                    <td>Sendet einen Runterfahrbefehl, falls der Rollladen nicht bereits nach unten fährt. Ggf. wird vorher noch ein Stop-Befehl gesendet.</td>
+                    <td>Ja</td>
+                </tr>
+                <tr>
+                    <td><code>down_stop</code></td>
+                    <td>Sendet abwechselnd einen Stop- und einen Runterfahrbefehl.</td>
+                    <td>Ja</td>
+                </tr>
+                <tr>
+                    <td><code>stop</code></td>
+                    <td>Sendet einen Stopbefehl.</td>
+                    <td>Ja</td>
+                </tr>
+                <tr>
+                    <td><code>position</code></td>
+                    <td>Sendet einen Positionsbefehl. <code>msg.payload</code> sollte ein Wert zwischen 0 (offen) und 100 (geschlossen) haben.</td>
+                    <td>Nein</td>
+                </tr>
+                <tr>
+                    <td><code>toggle</code> (default)</td>
+                    <td>Schaltet den Rollladen abwechselnd auf hoch, stop, runter, stop.</td>
+                    <td>Ja</td>
+                </tr>
+            </tbody>
+        </table>
+    </p>
+    <p>
+        Diese Node verwaltet keine Laufzeit für den Rollladen selbst. Diese muss über ETS für den Ausgang konfiguriert werden.
+        Es ist jedoch möglich, den Rollladen nach einer definierten Zeit automatisch abzuschalten.
+        Es ist jedoch möglich, den Rollladen nach einer definierten Zeit automatisch abzuschalten.
+        Beispiel: <code>msg = { "topic": "up", "time_on": 5000 }</code> oder <code>msg = { "topic": "up", "time_on": "5s" }</code><br/>
+        Diese Nachricht lässt den Rollladen für 5000 Millisekunden / 5 Sekunden nach oben fahren. Sollte es sich um eine Jalousie halten, werden die Lamellen entsprechend gedreht.
+        Als Einheit für die Zeit können folgende Werte verwendet werden:
+        <table>
+            <thead>
+                <tr>
+                    <th>Einheit</th>
+                    <th>Beschreibung</th>
+                </tr>
+            </thead>
+            <tbody>
+                <tr>
+                    <td><code>ms</code> (default)</td>
+                    <td>Millisekunden</td>
+                </tr>
+                <tr>
+                    <td><code>s</code> oder <code>sec</code></td>
+                    <td>Sekunden</td>
+                </tr>
+                <tr>
+                    <td><code>m</code> oder <code>min</code></td>
+                    <td>Mintun.</td>
+                </tr>
+                <tr>
+                    <td><code>h</code></td>
+                    <td>Stunden</td>
+                </tr>
+            </tbody>
+        </table>
+    </p>
+    <p>
+        Die Angabe einer Zeit funktioniert nicht mit dem topic <b>position</b>.
+    </p>
+</script>

package/shutter/locales/de-DE/shutter.json

@@ -0,0 +1,11 @@
+{
+    "shutter": {
+        "ui": {
+            "name": "Name",
+            "text": "Text",
+            "controlled_by_words": "Diese Node kann über die eingegebenen Wörter gesteuert werden. Mehrere Wörter werden durch ein Komma getrennt.",
+            "time_short": "Zeit kurz",
+            "controlled_by_central": "Dieser Baustein wird von folgenden Zentralbausteinen gesteuert:"
+        }
+    }
+}