@atelieruldetehnologii/node-red-custome-solutions 0.62.22

package/modbus-tcp-discover/modbus-tcp-discover.html

@@ -0,0 +1,190 @@
+<script type="text/javascript">
+    RED.nodes.registerType("modbus-tcp-discover", {
+        category: "Atelierul de Tehnologii",
+        color: "#4C9F70",
+        defaults: {
+            license: { value: "", type: "atelier-license", required: true },
+            name: { value: "" },
+            target: { value: "192.168.1.0/24", required: true },
+            scanProfile: { value: "custom" },
+            detailLevel: { value: "standard" },
+            ports: { value: "502", required: true },
+            timeout: { value: 800, required: true, validate: RED.validators.number() },
+            concurrency: { value: 32, required: true, validate: RED.validators.number() },
+            rateLimit: { value: 100, required: true, validate: RED.validators.number() },
+            discoveryMode: { value: "tcp" },
+            resolveHostnames: { value: false },
+            emitClosed: { value: false },
+            probeModbus: { value: true },
+            unitIds: { value: "1-10" },
+            allowPublic: { value: false },
+            outputFormat: { value: "json" },
+            emitMode: { value: "summary_only" },
+            deviceCollection: { value: "last_octet" },
+            onlyChanges: { value: false },
+            scanOnStart: { value: false },
+            interval: { value: 0, validate: RED.validators.number() }
+        },
+        inputs: 1,
+        outputs: 2,
+        icon: "font-awesome/fa-search",
+        outputLabels: ["dispozitiv", "sumar / eroare"],
+        label: function () { return this.name || "modbus-tcp-discover"; },
+        oneditprepare: function () {
+            function applyProfile() {
+                const value = $("#node-input-scanProfile").val();
+                const ports = { sunspec: "502", modbus: "502", mqtt: "1883,8883", web: "80,443,8080,8443", industrial: "102,502,1883,4840,20000,44818", full: "80,102,443,502,1883,4840,8080,8443,8883,20000,44818" };
+                if (ports[value]) $("#node-input-ports").val(ports[value]);
+                const usesModbus = ["sunspec", "modbus", "industrial", "full"].includes(value);
+                if (value !== "custom") $("#node-input-probeModbus").prop("checked", usesModbus);
+                $("#md-ports-row, #md-ports-note").toggle(value === "custom");
+                $("#md-modbus-section").toggle(usesModbus || value === "custom");
+                toggleModbus();
+            }
+            function applyDetail() {
+                const detailed = $("#node-input-detailLevel").val() === "detailed";
+                if (detailed) {
+                    $("#node-input-discoveryMode").val("full_discovery");
+                    $("#node-input-resolveHostnames").prop("checked", true);
+                }
+                $("#md-detailed-note").toggle(detailed);
+                $("#md-hostname-row").toggle(!detailed);
+            }
+            function toggleModbus() { $("#md-unit-row").toggle($("#node-input-probeModbus").prop("checked")); }
+            $("#node-input-probeModbus").on("change", toggleModbus);
+            $("#node-input-scanProfile").on("change", applyProfile);
+            $("#node-input-detailLevel").on("change", applyDetail);
+            applyProfile();
+            applyDetail();
+        },
+        oneditsave: function () {
+            this.target = String($("#node-input-target").val() || "").trim();
+            this.ports = String($("#node-input-ports").val() || "").trim();
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="modbus-tcp-discover">
+    <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="modbus-discover-editor">
+        <div class="md-section">
+            <div class="md-title"><i class="fa fa-search"></i> Scanare retea TCP</div>
+            <p class="md-note">Scaneaza numai reteaua pentru care ai autorizatie. Nodul testeaza conexiuni TCP si nu necesita ping sau privilegii speciale.</p>
+            <div class="form-row"><label for="node-input-name"><i class="fa fa-tag"></i> Nume</label><input type="text" id="node-input-name" placeholder="Descoperire Modbus"></div>
+            <div class="form-row"><label for="node-input-target"><i class="fa fa-sitemap"></i> Retea / interval</label><input type="text" id="node-input-target" placeholder="192.168.1.0/24"></div>
+            <div class="md-example">Accepta CIDR, interval complet, interval scurt sau IP unic: <code>10.0.0.0/24</code>, <code>10.0.0.10-10.0.0.50</code>, <code>10.0.0.10-50</code>.</div>
+            <div class="form-row"><label for="node-input-scanProfile"><i class="fa fa-magic"></i> Tip scanare</label><select id="node-input-scanProfile"><option value="sunspec">SunSpec</option><option value="modbus">Modbus TCP</option><option value="mqtt">MQTT</option><option value="web">Web</option><option value="industrial">Protocoale industriale</option><option value="full">Scanare completa</option><option value="custom">Personalizat</option></select></div>
+            <div class="form-row"><label for="node-input-detailLevel"><i class="fa fa-sliders"></i> Nivel detalii</label><select id="node-input-detailLevel"><option value="rapid">Rapid</option><option value="standard">Standard</option><option value="detailed">Detaliat</option></select></div>
+            <div class="md-info" id="md-detailed-note"><i class="fa fa-info-circle"></i> Modul Detaliat include automat Ping, ARP, TCP, identificarea numelui dispozitivelor si verificarile extinse ale profilului ales.</div>
+            <div class="form-row" id="md-ports-row"><label for="node-input-ports"><i class="fa fa-plug"></i> Porturi</label><input type="text" id="node-input-ports" placeholder="502,80,443"></div>
+            <div class="md-example" id="md-ports-note">Lista sau interval, maximum 32: <code>502</code>, <code>80,443,502</code>, <code>500-510</code>.</div>
+            <div class="form-row md-check"><input type="checkbox" id="node-input-allowPublic"><label for="node-input-allowPublic">Permite explicit scanarea adreselor publice autorizate</label></div>
+        </div>
+        <div class="md-section" id="md-modbus-section">
+            <div class="md-title"><i class="fa fa-exchange"></i> Validare Modbus</div>
+            <div class="form-row md-check"><input type="checkbox" id="node-input-probeModbus"><label for="node-input-probeModbus">Verifica protocolul Modbus si detecteaza SunSpec</label></div>
+            <div class="form-row" id="md-unit-row"><label for="node-input-unitIds"><i class="fa fa-list-ol"></i> Unit ID</label><input type="text" id="node-input-unitIds" placeholder="1-10"></div>
+        </div>
+        <details class="md-advanced"><summary><i class="fa fa-cog"></i> Setari avansate</summary><div class="md-section">
+            <div class="md-title"><i class="fa fa-sliders"></i> Descoperire si performanta</div>
+            <div class="form-row"><label for="node-input-discoveryMode"><i class="fa fa-wifi"></i> Metoda</label><select id="node-input-discoveryMode"><option value="tcp">TCP</option><option value="ping_tcp">Ping + TCP</option><option value="arp_tcp">ARP/neighbour + TCP</option><option value="full_discovery">Complet: Ping + ARP + TCP</option></select></div>
+            <div class="form-row"><label for="node-input-timeout"><i class="fa fa-clock-o"></i> Timeout (ms)</label><input type="number" id="node-input-timeout" min="100" max="10000"></div>
+            <div class="form-row"><label for="node-input-concurrency"><i class="fa fa-tasks"></i> Concurenta</label><input type="number" id="node-input-concurrency" min="1" max="100"></div>
+            <div class="form-row"><label for="node-input-rateLimit"><i class="fa fa-tachometer"></i> Conexiuni/sec</label><input type="number" id="node-input-rateLimit" min="1" max="1000"></div>
+            <div class="form-row md-check" id="md-hostname-row"><input type="checkbox" id="node-input-resolveHostnames"><label for="node-input-resolveHostnames">Identifica numele dispozitivelor gasite</label></div>
+            <div class="form-row md-check"><input type="checkbox" id="node-input-emitClosed"><label for="node-input-emitClosed">Emite si gazdele fara porturi deschise</label></div>
+        </div></details>
+        <div class="md-section">
+            <div class="md-title"><i class="fa fa-repeat"></i> Monitorizare si iesire</div>
+            <div class="form-row md-check"><input type="checkbox" id="node-input-scanOnStart"><label for="node-input-scanOnStart">Scaneaza automat la pornire</label></div>
+            <div class="form-row"><label for="node-input-interval"><i class="fa fa-clock-o"></i> Interval (ms)</label><input type="number" id="node-input-interval" min="0" placeholder="0 = dezactivat"></div>
+            <div class="form-row md-check"><input type="checkbox" id="node-input-onlyChanges"><label for="node-input-onlyChanges">Emite dispozitive numai cand starea se schimba</label></div>
+            <div class="form-row"><label for="node-input-emitMode"><i class="fa fa-list"></i> Emitere</label><select id="node-input-emitMode"><option value="summary_only">Doar lista finala</option><option value="device_and_summary">Dispozitive live + lista finala</option></select></div>
+            <div class="form-row"><label for="node-input-deviceCollection"><i class="fa fa-key"></i> Index dispozitive</label><select id="node-input-deviceCollection"><option value="last_octet">Ultimul octet IP (1, 88, 101)</option><option value="ip">IP complet</option><option value="array">Array clasic</option></select></div>
+            <div class="form-row"><label for="node-input-outputFormat"><i class="fa fa-file-code-o"></i> Format</label><select id="node-input-outputFormat"><option value="json">JSON</option><option value="csv">CSV</option><option value="influx">InfluxDB</option></select></div>
+        </div>
+    </div>
+    <style>
+        .modbus-discover-editor{--md-border:#d7dde5;--md-muted:#667085;--md-bg:#f8fafc}.modbus-discover-editor .md-section{margin:0 0 16px;padding:14px 16px;border:1px solid var(--md-border);border-radius:9px;background:var(--md-bg)}.modbus-discover-editor .md-title{margin-bottom:12px;font-size:15px;font-weight:600;color:#243447}.modbus-discover-editor .md-title i{margin-right:7px;color:#287a50}.modbus-discover-editor .md-note,.modbus-discover-editor .md-example{color:var(--md-muted);font-size:12px;line-height:1.45}.modbus-discover-editor .md-note{margin:0 0 14px}.modbus-discover-editor .md-example{margin:-6px 0 12px;padding-left:150px}.modbus-discover-editor .md-info{margin:-3px 0 13px 150px;padding:8px 10px;border-left:3px solid #287a50;background:#edf7f1;color:#315744;font-size:12px;line-height:1.4}.modbus-discover-editor .form-row label{width:140px}.modbus-discover-editor .form-row input:not([type=checkbox]){width:calc(100% - 150px)}.modbus-discover-editor .md-check{display:flex;align-items:center}.modbus-discover-editor .md-check input{width:auto;margin:0 10px 0 0}.modbus-discover-editor .md-check label{width:auto;margin:0}.modbus-discover-editor .md-advanced{margin:0 0 16px}.modbus-discover-editor .md-advanced>summary{cursor:pointer;padding:10px 14px;border:1px solid var(--md-border);border-radius:8px;background:#fff;font-weight:600;color:#344054}.modbus-discover-editor .md-advanced[open]>summary{margin-bottom:8px}.modbus-discover-editor .md-advanced .md-section{margin-bottom:0}
+    </style>
+</script>
+
+<script type="text/html" data-help-name="modbus-tcp-discover">
+    <p>Descopera dispozitive dintr-o retea IPv4, verifica porturile TCP si, in functie de profil, valideaza protocoale precum Modbus TCP, SunSpec sau MQTT. Pentru o utilizare obisnuita este suficient sa alegi reteaua, tipul scanarii si nivelul de detalii.</p>
+
+    <h3>Configurare rapida</h3>
+    <ol>
+        <li>Introdu reteaua, de exemplu <code>192.168.1.0/24</code>.</li>
+        <li>Alege <b>Tip scanare</b>: SunSpec, Modbus TCP, MQTT, Web sau Scanare completa.</li>
+        <li>Alege <b>Standard</b> pentru utilizarea curenta sau <b>Detaliat</b> pentru inventariere.</li>
+        <li>Conecteaza un nod Inject la intrare si un nod Debug la iesirea a doua.</li>
+    </ol>
+    <p>Setarile avansate pot ramane la valorile implicite. Modifica-le numai daca reteaua este lenta, filtrata sau necesita un comportament special.</p>
+
+    <h3>Tipuri de scanare</h3>
+    <ul>
+        <li><b>SunSpec</b> — verifica portul 502, cauta dispozitive compatibile SunSpec si citeste datele de identificare disponibile. Nu este limitat la un anumit producator.</li>
+        <li><b>Modbus TCP</b> — identifica servere Modbus TCP si Unit ID-urile care raspund, inclusiv dispozitive fara SunSpec.</li>
+        <li><b>MQTT</b> — verifica porturile MQTT uzuale si confirma protocolul prin raspunsul brokerului.</li>
+        <li><b>Web</b> — cauta interfete web pe porturile HTTP si HTTPS uzuale.</li>
+        <li><b>Protocoale industriale</b> — verifica un set de porturi utilizate frecvent in automatizari.</li>
+        <li><b>Scanare completa</b> — combina porturile presetate pentru o inventariere generala.</li>
+        <li><b>Personalizat</b> — permite introducerea manuala a porturilor si alegerea validarii Modbus.</li>
+    </ul>
+
+    <h3>Niveluri de detalii</h3>
+    <ul>
+        <li><b>Rapid</b> — prioritizeaza viteza si verifica informatiile esentiale.</li>
+        <li><b>Standard</b> — echilibru recomandat intre viteza si informatiile returnate.</li>
+        <li><b>Detaliat</b> — activeaza automat Ping + ARP + TCP, identifica numele dispozitivelor si executa verificarile extinse ale profilului. Nu trebuie activata separat optiunea pentru numele dispozitivelor.</li>
+    </ul>
+    <p>Identificarea numelui depinde de DNS-ul retelei. Lipsa unui nume nu inseamna ca dispozitivul este offline.</p>
+
+    <h3>Retea si adrese</h3>
+    <p>Sunt acceptate un IP unic (<code>192.168.1.20</code>), o retea CIDR (<code>192.168.1.0/24</code>), un interval complet (<code>192.168.1.20-192.168.1.50</code>) sau unul scurt (<code>192.168.1.20-50</code>). Adresele publice sunt blocate implicit; activeaza optiunea dedicata numai pentru adrese asupra carora ai autorizatie explicita.</p>
+    <p>ARP poate furniza adresa MAC numai pentru dispozitive aflate in acelasi segment local si vizibile sistemului pe care ruleaza Node-RED. Routerele nu transmit in mod normal informatia ARP intre subretele.</p>
+
+    <h3>Setari avansate</h3>
+    <ul>
+        <li><b>Metoda</b> stabileste daca descoperirea foloseste TCP, Ping, ARP sau combinatia lor. In modul Detaliat este folosita automat metoda completa.</li>
+        <li><b>Timeout</b> este timpul maxim asteptat pentru o verificare. Mareste-l pentru legaturi lente sau VPN.</li>
+        <li><b>Concurenta</b> stabileste cate verificari pot rula simultan. O valoare mare scurteaza scanarea, dar solicita mai mult reteaua.</li>
+        <li><b>Conexiuni/sec</b> limiteaza ritmul initiarii conexiunilor.</li>
+        <li><b>Emite gazdele fara porturi deschise</b> pastreaza in rezultat si dispozitivele observate prin Ping sau ARP.</li>
+        <li><b>Unit ID</b> stabileste adresele Modbus verificate. Exemplu: <code>1-10</code> sau <code>1,3,126</code>.</li>
+    </ul>
+
+    <h3>Intrare</h3>
+    <p>Orice mesaj porneste scanarea. Valorile configurate pot fi suprascrise din mesaj cu <code>msg.target</code>, <code>msg.scanProfile</code>, <code>msg.detailLevel</code>, <code>msg.ports</code>, <code>msg.timeout</code>, <code>msg.concurrency</code>, <code>msg.unitIds</code> si <code>msg.probeModbus</code>. Un mesaj cu <code>msg.cancel = true</code> opreste scanarea activa.</p>
+
+    <h3>Iesiri</h3>
+    <ol>
+        <li>Dispozitive individuale, numai cand este selectat <b>Dispozitive live + lista finala</b>.</li>
+        <li>Rezultatul final complet sau mesajul de eroare.</li>
+    </ol>
+    <p>Rezultatul final contine statistici despre scanare si colectia <code>msg.payload.devices</code>. Pentru fiecare dispozitiv pot fi incluse IP-ul, numele, MAC-ul, porturile deschise, producatorul, modelul, firmware-ul, seria, datele Modbus, Unit ID, SunSpec sau MQTT. Campurile pentru care nu exista date sunt eliminate automat.</p>
+    <p><code>open_ports</code> contine lista scurta a porturilor deschise. Campul <code>ports</code> este indexat direct dupa numarul portului, nu dupa pozitia intr-un array. De exemplu, rezultatul portului Modbus se acceseaza prin <code>msg.payload.devices["101"].ports["502"]</code>. Fiecare intrare contine starea, latenta si eventualul cod de eroare.</p>
+    <p>Rezultatele MQTT sunt organizate in acelasi mod: <code>mqtt["1883"]</code> si <code>mqtt["8883"]</code>. Astfel, informatia unui port poate fi gasita direct fara parcurgerea unui array.</p>
+
+    <h3>Organizarea dispozitivelor</h3>
+    <p>Varianta recomandata, <b>Ultimul octet IP</b>, permite accesul simplu prin <code>msg.payload.devices["101"]</code> pentru adresa <code>192.168.1.101</code>. Optiunea <b>IP complet</b> foloseste cheia <code>msg.payload.devices["192.168.1.101"]</code>, iar <b>Array clasic</b> produce o lista numerica. Daca ultimul octet se repeta intre subretele, nodul foloseste automat IP-ul complet pentru cheia duplicata.</p>
+    <p>Colectia <code>categories</code> ofera liste pregatite pentru utilizare: <code>modbus_devices</code>, <code>sunspec_devices</code>, <code>mqtt_devices</code> si <code>web_devices</code>. Fiecare foloseste acelasi mod de indexare ales pentru lista principala.</p>
+
+    <h3>Identificarea dispozitivului</h3>
+    <p>Campul <code>summary</code> combina intr-un text scurt identitatea si serviciile confirmate. <code>identification_confidence</code> poate fi <code>confirmed</code> cand identitatea sau protocolul a fost confirmat, <code>probable</code> cand exista indicii precum nume, producator MAC ori porturi deschise si <code>unknown</code> cand exista numai dovada ca adresa raspunde.</p>
+    <p><code>mac_vendor</code> este estimat din prefixul MAC folosind lista locala inclusa in nod. Informatia este orientativa: adresele MAC pot fi randomizate, virtualizate sau raportate prin Proxy ARP. Identificarea returnata direct prin Modbus/SunSpec are prioritate si un nivel de incredere mai mare.</p>
+
+    <h3>Optimizarea Modbus</h3>
+    <p>La o lista mare de Unit ID-uri, nodul testeaza mai intai adrese reprezentative. Daca raspunsurile arata ca serverul ignora sau oglindeste Unit ID-ul, scanarea se opreste inteligent. Daca raspunsurile sunt distincte sau lipsesc, verificarea continua pentru a descoperi dispozitive aflate la alte adrese. <code>tested_unit_ids</code> arata exact ce adrese au fost verificate efectiv.</p>
+
+    <h3>Recomandari</h3>
+    <ul>
+        <li>Pentru invertoare si contoare compatibile, incepe cu <b>SunSpec + Standard</b>.</li>
+        <li>Pentru dispozitive Modbus necunoscute, foloseste <b>Modbus TCP + Detaliat</b>.</li>
+        <li>Pentru inventarierea retelei, foloseste <b>Scanare completa + Detaliat</b>.</li>
+        <li>Daca scanarea produce prea mult trafic, redu Concurenta si Conexiuni/sec.</li>
+    </ul>
+
+    <h3>Limite si interpretare</h3>
+    <p>Sunt acceptate maximum 4096 de gazde, 32 de porturi, 247 Unit ID-uri si 100 de conexiuni concurente. Un raspuns Ping confirma accesibilitatea IP, nu existenta unui serviciu Modbus. Un port 502 deschis nu confirma singur protocolul Modbus; confirmarea apare numai dupa un raspuns Modbus valid. Unele dispozitive blocheaza Ping, dar raspund la TCP, motiv pentru care modul Detaliat combina mai multe metode.</p>
+</script>