@atelieruldetehnologii/node-red-custome-solutions 0.62.22

package/pylontech-write/pylontech-write.html

@@ -0,0 +1,405 @@
+<style>
+    .pylontech-write-editor {
+        --pw-border: #d7dde5;
+        --pw-muted: #667085;
+        --pw-surface: #f7fcfb;
+        --pw-head: #e8f5f3;
+    }
+
+    .pylontech-write-editor .pw-hero,
+    .pylontech-write-editor .pw-section {
+        margin: 0 0 18px;
+        padding: 14px 16px 16px;
+        border: 1px solid var(--pw-border);
+        border-radius: 12px;
+        background: var(--pw-surface);
+    }
+
+    .pylontech-write-editor .pw-hero {
+        background: linear-gradient(135deg, var(--pw-head), #f7fcfb);
+    }
+
+    .pylontech-write-editor .pw-title {
+        margin: 0 0 4px;
+        font-size: 15px;
+        font-weight: 700;
+        color: #243447;
+    }
+
+    .pylontech-write-editor .pw-note {
+        margin: 0 0 14px;
+        color: var(--pw-muted);
+        font-size: 12px;
+        line-height: 1.45;
+    }
+
+    .pylontech-write-editor .pw-grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+        gap: 12px 16px;
+    }
+
+    .pylontech-write-editor .form-row {
+        margin-bottom: 12px;
+    }
+
+    .pylontech-write-editor .pw-grid .form-row,
+    .pylontech-write-editor .form-row:last-child {
+        margin-bottom: 0;
+    }
+
+    .pylontech-write-editor .form-row > label {
+        width: 150px;
+        font-weight: 600;
+    }
+
+    .pylontech-write-editor .form-row > input[type="text"] {
+        width: calc(100% - 160px);
+    }
+</style>
+
+<script type="text/javascript">
+
+    RED.nodes.registerType("pylontech-write", {
+
+        category: "Atelierul de Tehnologii",
+
+        color: "#4db6ac",
+
+        defaults: {
+            license: { value: "", type: "atelier-license", required: true },
+
+            name: { value: "" },
+
+            host: { value: "", required: true },
+
+            port: { value: 502, required: true, validate: RED.validators.number() },
+
+            unitId: { value: 1, required: true, validate: RED.validators.number() },
+
+            externalControlRegister: { value: 3006, validate: RED.validators.number() },
+
+            externalControlEnabledValue: { value: 85, validate: RED.validators.number() },
+
+            externalControlDisabledValue: { value: 170, validate: RED.validators.number() },
+
+            powerRegister: { value: 3007, validate: RED.validators.number() },
+
+            powerScaleKw: {
+
+                value: 0.1,
+
+                validate: function (v) {
+
+                    const n = Number(v);
+
+                    return Number.isFinite(n) && n > 0;
+
+                }
+
+            }
+
+        },
+
+        inputs: 1,
+
+        outputs: 1,
+
+        icon: "font-awesome/fa-battery-three-quarters",
+
+        label: function () {
+
+            return this.name || this.host || "pylontech-write";
+
+        },
+
+        oneditprepare: function () {
+            $("#node-input-host").off(".pylontechWriteName").on("input.pylontechWriteName change.pylontechWriteName", function () {
+                $("#node-input-name").val(String($(this).val() || "").trim());
+            });
+        },
+
+        oneditsave: function () {
+            if (!String($("#node-input-name").val() || "").trim()) {
+                $("#node-input-name").val(String($("#node-input-host").val() || "").trim());
+            }
+            $("#node-input-host").off(".pylontechWriteName");
+        },
+
+        oneditcancel: function () {
+            $("#node-input-host").off(".pylontechWriteName");
+        }
+
+    });
+
+</script>
+
+
+<script type="text/html" data-template-name="pylontech-write">
+    <div class="form-row"><label for="node-input-license"><i class="fa fa-key"></i> License</label><input type="text" id="node-input-license"></div>
+    <div class="pylontech-write-editor">
+        <div class="pw-hero">
+            <p class="pw-title">Pylontech Command Writer</p>
+            <p class="pw-note">Nodul scrie comanda finala pe fiecare baterie. In fluxul recomandat primeste mesaje direct din <code>multi-battery</code>, deja pregatite cu <code>external_control</code> si <code>power_w</code>.</p>
+        </div>
+
+        <div class="pw-section">
+            <p class="pw-title">Connection</p>
+            <p class="pw-note">Setari Modbus TCP pentru bateria sau EMS-ul controlat de aceasta instanta.</p>
+            <div class="pw-grid">
+                <div class="form-row">
+                    <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+                    <input type="text" id="node-input-name" placeholder="pylontech-write">
+                </div>
+
+                <div class="form-row">
+                    <label for="node-input-host"><i class="fa fa-plug"></i> Host</label>
+                    <input type="text" id="node-input-host" placeholder="192.168.135.100">
+                </div>
+
+                <div class="form-row">
+                    <label for="node-input-port"><i class="fa fa-ellipsis-h"></i> Port</label>
+                    <input type="text" id="node-input-port" placeholder="502">
+                </div>
+
+                <div class="form-row">
+                    <label for="node-input-unitId"><i class="fa fa-hashtag"></i> Unit ID</label>
+                    <input type="text" id="node-input-unitId" placeholder="1">
+                </div>
+            </div>
+        </div>
+
+        <div class="pw-section">
+            <p class="pw-title">External Control Register</p>
+            <p class="pw-note">Valori implicite potrivite pentru majoritatea integrarilor Pylontech/EMS.</p>
+            <div class="pw-grid">
+                <div class="form-row">
+                    <label for="node-input-externalControlRegister"><i class="fa fa-toggle-on"></i> Register</label>
+                    <input type="text" id="node-input-externalControlRegister" placeholder="3006">
+                </div>
+
+                <div class="form-row">
+                    <label for="node-input-externalControlEnabledValue"><i class="fa fa-check"></i> Enable Value</label>
+                    <input type="text" id="node-input-externalControlEnabledValue" placeholder="85">
+                </div>
+
+                <div class="form-row">
+                    <label for="node-input-externalControlDisabledValue"><i class="fa fa-times"></i> Disable Value</label>
+                    <input type="text" id="node-input-externalControlDisabledValue" placeholder="170">
+                </div>
+            </div>
+        </div>
+
+        <div class="pw-section">
+            <p class="pw-title">Power Register</p>
+            <p class="pw-note">Nodul converteste automat <code>power_w</code> in kW si apoi in unitatile cerute de registrul Modbus.</p>
+            <div class="pw-grid">
+                <div class="form-row">
+                    <label for="node-input-powerRegister"><i class="fa fa-bolt"></i> Register</label>
+                    <input type="text" id="node-input-powerRegister" placeholder="3007">
+                </div>
+
+                <div class="form-row">
+                    <label for="node-input-powerScaleKw"><i class="fa fa-balance-scale"></i> Scale (kW/unit)</label>
+                    <input type="text" id="node-input-powerScaleKw" placeholder="0.1">
+                </div>
+            </div>
+        </div>
+    </div>
+
+</script>
+
+
+<script type="text/html" data-help-name="pylontech-write">
+
+    <p>
+
+        Nodul <b>pylontech-write</b> scrie prin Modbus TCP două comenzi către Pylontech / EMS:
+
+        activare-dezactivare control extern și limită de putere.
+
+    </p>
+
+
+    <h3>Registre implicite</h3>
+
+    <ul>
+
+        <li><code>3006</code> — control extern</li>
+
+        <li><code>3007</code> — putere în pași de <code>0.1 kW</code></li>
+
+    </ul>
+
+
+    <h3>Input acceptat</h3>
+
+    <p>Poți trimite doar puterea, doar controlul extern sau ambele în același mesaj.</p>
+    <p>În fluxul recomandat, nodul primește direct ieșirile din <code>multi-battery</code>.</p>
+
+
+    <pre>{
+
+  "payload": 5
+
+}</pre>
+
+    <p>Interpretare: scrie puterea <code>5 kW</code> în registrul de putere.</p>
+
+
+    <pre>{
+
+  "payload": {
+
+    "power_kw": -5
+
+  }
+
+}</pre>
+
+    <p>Interpretare: scrie <code>-5 kW</code> în two's complement pe registrul de putere.</p>
+
+
+    <pre>{
+
+  "payload": {
+
+    "power_w": 7500
+
+  }
+
+}</pre>
+
+    <p>Interpretare: convertește automat <code>7500 W</code> la <code>7.5 kW</code>.</p>
+
+
+    <pre>{
+
+  "payload": {
+
+    "external_control": true
+
+  }
+
+}</pre>
+
+    <p>Interpretare: scrie valoarea de activare pentru control extern.</p>
+
+
+    <pre>{
+
+  "payload": {
+
+    "external_control": false
+
+  }
+
+}</pre>
+
+    <p>Interpretare: scrie valoarea de dezactivare pentru control extern.</p>
+
+
+    <pre>{
+
+  "payload": {
+
+    "external_control": true,
+
+    "power_kw": 12.5
+
+  }
+
+}</pre>
+
+    <p>Interpretare: activează controlul extern și scrie apoi puterea.</p>
+
+
+    <h3>Chei acceptate</h3>
+
+    <ul>
+
+        <li>pentru control extern: <code>external_control</code>, <code>externalControl</code>, <code>enable_external_control</code>, <code>control_extern</code>, <code>enabled</code></li>
+
+        <li>pentru putere în kW: <code>power_kw</code>, <code>limit_kw</code>, <code>value_kw</code>, <code>kw</code>, <code>power</code></li>
+
+        <li>pentru putere în W: <code>power_w</code>, <code>limit_w</code>, <code>value_w</code>, <code>watts</code></li>
+
+        <li>pentru rescriere forțată: <code>force: true</code></li>
+
+    </ul>
+
+
+    <h3>Output</h3>
+
+    <p>Nodul emite un mesaj de confirmare sau eroare.</p>
+
+
+    <pre>{
+
+  "topic": "pylontech/write",
+
+  "payload": {
+
+    "status": "ok",
+
+    "external_control_written": true,
+
+    "external_control_enabled": true,
+
+    "external_control_raw": 85,
+
+    "power_written": true,
+
+    "power_kw": 12.5,
+
+    "power_raw": 125
+
+  }
+
+}</pre>
+
+
+    <h3>Observații</h3>
+
+    <ul>
+
+        <li>puterea este scrisă ca registru pe 16 biți unsigned, folosind two's complement pentru valori negative</li>
+
+        <li>în mod implicit, activarea controlului extern scrie <code>85</code>, iar dezactivarea scrie <code>170</code></li>
+
+        <li>dacă trimiți doar putere, controlul extern nu este modificat</li>
+
+        <li>dacă trimiți doar control extern, puterea nu este modificată</li>
+
+    </ul>
+
+
+    <h3>Referinta completa parametri</h3>
+
+    <ul>
+
+        <li><code>host</code>, <code>port</code>, <code>unitId</code>: conexiunea Modbus TCP catre baterie/EMS.</li>
+
+        <li><code>externalControlRegister</code>: registrul pentru activarea/dezactivarea controlului extern.</li>
+
+        <li><code>externalControlEnabledValue</code>: valoarea scrisa pentru activare.</li>
+
+        <li><code>externalControlDisabledValue</code>: valoarea scrisa pentru dezactivare.</li>
+
+        <li><code>powerRegister</code>: registrul pentru puterea comandata.</li>
+
+        <li><code>powerScaleKw</code>: factorul de conversie intre kW si valoarea bruta scrisa.</li>
+
+    </ul>
+
+
+    <h3>Model recomandat din multi-battery</h3>
+
+    <pre>{
+  "payload": {
+    "external_control": true,
+    "power_w": 9000
+  }
+}</pre>
+
+</script>