node-red-contrib-me-vplc 1.0.0

package/README.md

@@ -0,0 +1,42 @@
+# ME vPLC Node-RED Offline-Installer
+
+Version 1.0.5 enthält ein integriertes Python-Wheelhouse. Dadurch installiert der Node die Python-Abhängigkeiten beim ersten Start automatisch offline in eine lokale `.venv`.
+
+## Installation Windows
+
+```cmd
+install_node_red_node_windows.cmd
+```
+
+## Installation Linux / Raspberry Pi
+
+```bash
+chmod +x *.sh
+./install_node_red_node_linux.sh
+```
+
+## Ablauf beim ersten Deploy
+
+1. Runtime-Kopie nach `.node-red/me-vplc-runtime/<node-id>`
+2. Python erkennen
+3. `.venv` erzeugen
+4. Requirements mit `pip --no-index --find-links wheelhouse` installieren
+5. Flask-Backend auf Port 5000 starten
+
+## Enthaltene Wheels
+
+Das Wheelhouse enthält die Projekt-Requirements und die nötigen Abhängigkeiten für typische Windows-x64-, Linux-x64- und Raspberry-Pi-aarch64-Installationen mit Python 3.10 bis 3.13.
+
+## Wheelhouse neu erzeugen
+
+Windows:
+
+```cmd
+prepare_offline_wheelhouse_windows.cmd
+```
+
+Linux:
+
+```bash
+./prepare_offline_wheelhouse_linux.sh
+```

package/me-vplc.html

@@ -0,0 +1,64 @@
+<script type="text/javascript">
+  RED.nodes.registerType("me-vplc", {
+    category: "ME vPLC",
+    color: "#8cc8ff",
+    defaults: {
+      name: { value: "ME vPLC" },
+      backendPort: { value: 5000, required: true, validate: RED.validators.number() },
+      pythonPath: { value: "", required: false },
+      autoStart: { value: true },
+      copyOnStart: { value: false },
+      autoInstallDeps: { value: true }
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: "font-awesome/fa-microchip",
+    label: function () { return this.name || "ME vPLC"; }
+  });
+</script>
+
+<script type="text/html" data-template-name="me-vplc">
+  <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="ME vPLC">
+  </div>
+  <div class="form-row">
+    <label for="node-input-backendPort"><i class="fa fa-plug"></i> Backend-Port</label>
+    <input type="number" id="node-input-backendPort" placeholder="5000">
+  </div>
+  <div class="form-row">
+    <label for="node-input-pythonPath"><i class="fa fa-terminal"></i> Python</label>
+    <input type="text" id="node-input-pythonPath" placeholder="leer = Auto-Erkennung: Windows python/py -3, Linux python3">
+  </div>
+  <div class="form-row">
+    <label for="node-input-autoStart"><i class="fa fa-play"></i> Autostart</label>
+    <input type="checkbox" id="node-input-autoStart" style="display:inline-block; width:auto; vertical-align:top;">
+    <span>Backend beim Deploy automatisch starten</span>
+  </div>
+  <div class="form-row">
+    <label for="node-input-copyOnStart"><i class="fa fa-copy"></i> Projekt kopieren</label>
+    <input type="checkbox" id="node-input-copyOnStart" style="display:inline-block; width:auto; vertical-align:top;">
+    <span>Runtime-Projekt bei jedem Start neu aus dem Node-Paket kopieren</span>
+  </div>
+  <div class="form-row">
+    <label for="node-input-autoInstallDeps"><i class="fa fa-download"></i> Python Pakete</label>
+    <input type="checkbox" id="node-input-autoInstallDeps" style="display:inline-block; width:auto; vertical-align:top;">
+    <span>fehlende Python-Abhängigkeiten beim ersten Start automatisch installieren</span>
+  </div>
+</script>
+
+<script type="text/html" data-help-name="me-vplc">
+  <p><b>ME vPLC</b> startet das integrierte Flask/React/ST-Projekt als lokale Runtime aus Node-RED heraus.</p>
+  <h3>Voraussetzungen</h3>
+  <p>Python muss installiert sein. Leer gelassener Python-Pfad nutzt eine Auto-Erkennung: unter Windows werden <code>python</code>, <code>py -3</code>, <code>py</code> und <code>python3</code> getestet; unter Linux/Raspberry Pi <code>python3</code> und <code>python</code>. Der Node erstellt beim ersten Start automatisch eine lokale Python-Umgebung unter <code>~/.node-red/me-vplc-runtime/&lt;node-id&gt;/.venv</code> und installiert fehlende Python-Pakete aus <code>project/backend/requirements.txt</code>. Für echte Offline-Installationen müssen die passenden Wheels im <code>wheelhouse</code> liegen oder vorher über den Offline-Installer installiert werden.</p>
+  <h3>Inputs</h3>
+  <ul>
+    <li><code>msg.payload = "status"</code> oder leer: Status von <code>/api/status</code></li>
+    <li><code>msg.payload = "start"</code>: PLC starten</li>
+    <li><code>msg.payload = "stop"</code>: PLC stoppen</li>
+    <li><code>msg.payload = "start-backend"</code>: Flask-Backend starten</li>
+    <li><code>msg.payload = "stop-backend"</code>: Flask-Backend stoppen</li>
+  </ul>
+  <h3>Ausgänge</h3>
+  <p><code>msg.payload</code> enthält die JSON-Antwort des ME-vPLC-Backends. <code>msg.meVplc.runtimeDir</code> zeigt auf die schreibbare Runtime-Kopie im Node-RED User-Verzeichnis.</p>
+</script>