@jsgorana/node-red-opcua 0.1.0

package/examples/client-quickstart.json

@@ -0,0 +1,146 @@
+[
+    {
+        "id": "cq_tab",
+        "type": "tab",
+        "label": "OPC-UA · Client Quickstart",
+        "disabled": false,
+        "info": "# OPC-UA Client Quickstart\n\nRead, write, browse and subscribe against an OPC-UA server.\n\n## Set up the Endpoint first\n1. Double-click any OPC-UA node → open the **Endpoint** config (pencil icon).\n2. **URL**: `opc.tcp://HOST:PORT[/path]`, e.g. `opc.tcp://localhost:4840`.\n   - Use `localhost` only if the server runs on the **same machine** as Node-RED.\n   - Otherwise use the server's **hostname or IP address**. (If Node-RED runs in a\n     container/VM, `localhost` points at that container — use the server's reachable address.)\n3. **Security / Authentication** must match the server (default: None / Anonymous).\n   For Sign/SignAndEncrypt, see the endpoint node's help for certificate trust.\n4. **Deploy**, then click the inject buttons and watch the **Debug** sidebar.\n\n> If the endpoint is wrong, the nodes show a red **error** status and read/write\n> time out. Fix the URL/security and redeploy.\n\nEach coloured group is one independent pattern — use what you need."
+    },
+
+    {
+        "id": "cq_help",
+        "type": "comment",
+        "z": "cq_tab",
+        "name": "⚠ Configure the Endpoint first — opc.tcp://HOST:PORT  (HOST = localhost only if the server is on this machine, else its hostname/IP). Wrong endpoint = red 'error' on nodes.",
+        "info": "Open any OPC-UA node and edit its Endpoint config:\n- URL: opc.tcp://HOST:PORT[/path]\n- HOST = localhost if the server runs on the same machine as Node-RED; otherwise the server's hostname or IP\n- Security/Auth must match the server (default None/Anonymous)\nThen Deploy.",
+        "x": 320,
+        "y": 30,
+        "wires": []
+    },
+
+    {
+        "id": "cq_g_read",
+        "type": "group",
+        "z": "cq_tab",
+        "name": "READ  —  get a value on demand",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#bdd7e7", "fill-opacity": "0.4" },
+        "nodes": ["cq_read_c", "cq_read_in", "cq_read", "cq_read_dbg"],
+        "x": 74, "y": 70, "w": 762, "h": 132
+    },
+    {
+        "id": "cq_read_c", "type": "comment", "z": "cq_tab", "g": "cq_g_read",
+        "name": "Inject → opcua-read → debug. Edit the node's Node ID (e.g. ns=1;s=Temperature).",
+        "x": 340, "y": 110, "wires": []
+    },
+    {
+        "id": "cq_read_in", "type": "inject", "z": "cq_tab", "g": "cq_g_read",
+        "name": "Read", "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "", "payloadType": "date",
+        "x": 170, "y": 160, "wires": [["cq_read"]]
+    },
+    {
+        "id": "cq_read", "type": "opcua-read", "z": "cq_tab", "g": "cq_g_read",
+        "name": "", "endpoint": "cq_endpoint", "nodeId": "ns=1;s=Temperature",
+        "x": 410, "y": 160, "wires": [["cq_read_dbg"]]
+    },
+    {
+        "id": "cq_read_dbg", "type": "debug", "z": "cq_tab", "g": "cq_g_read",
+        "name": "value", "active": true, "complete": "payload", "targetType": "msg",
+        "x": 650, "y": 160, "wires": []
+    },
+
+    {
+        "id": "cq_g_write",
+        "type": "group",
+        "z": "cq_tab",
+        "name": "WRITE  —  send a value (msg.payload), type set on the node",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#c7e9c0", "fill-opacity": "0.4" },
+        "nodes": ["cq_write_c", "cq_write_in", "cq_write", "cq_write_dbg"],
+        "x": 74, "y": 222, "w": 762, "h": 132
+    },
+    {
+        "id": "cq_write_c", "type": "comment", "z": "cq_tab", "g": "cq_g_write",
+        "name": "Inject payload 42.5 → opcua-write (Double) → debug shows the write status code.",
+        "x": 350, "y": 262, "wires": []
+    },
+    {
+        "id": "cq_write_in", "type": "inject", "z": "cq_tab", "g": "cq_g_write",
+        "name": "Write 42.5", "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "42.5", "payloadType": "num",
+        "x": 180, "y": 312, "wires": [["cq_write"]]
+    },
+    {
+        "id": "cq_write", "type": "opcua-write", "z": "cq_tab", "g": "cq_g_write",
+        "name": "", "endpoint": "cq_endpoint", "nodeId": "ns=1;s=Setpoint", "dataType": "Double",
+        "x": 410, "y": 312, "wires": [["cq_write_dbg"]]
+    },
+    {
+        "id": "cq_write_dbg", "type": "debug", "z": "cq_tab", "g": "cq_g_write",
+        "name": "status", "active": true, "complete": "statusCode", "targetType": "msg",
+        "x": 650, "y": 312, "wires": []
+    },
+
+    {
+        "id": "cq_g_browse",
+        "type": "group",
+        "z": "cq_tab",
+        "name": "BROWSE  —  discover the address space",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#fdd0a2", "fill-opacity": "0.4" },
+        "nodes": ["cq_browse_c", "cq_browse_in", "cq_browse", "cq_browse_dbg"],
+        "x": 74, "y": 374, "w": 762, "h": 132
+    },
+    {
+        "id": "cq_browse_c", "type": "comment", "z": "cq_tab", "g": "cq_g_browse",
+        "name": "Returns an array of child references. Start at ObjectsFolder, then drill into a Node ID.",
+        "x": 360, "y": 414, "wires": []
+    },
+    {
+        "id": "cq_browse_in", "type": "inject", "z": "cq_tab", "g": "cq_g_browse",
+        "name": "Browse", "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "", "payloadType": "date",
+        "x": 170, "y": 464, "wires": [["cq_browse"]]
+    },
+    {
+        "id": "cq_browse", "type": "opcua-browse", "z": "cq_tab", "g": "cq_g_browse",
+        "name": "", "endpoint": "cq_endpoint", "nodeId": "ObjectsFolder",
+        "x": 410, "y": 464, "wires": [["cq_browse_dbg"]]
+    },
+    {
+        "id": "cq_browse_dbg", "type": "debug", "z": "cq_tab", "g": "cq_g_browse",
+        "name": "references", "active": true, "complete": "payload", "targetType": "msg",
+        "x": 660, "y": 464, "wires": []
+    },
+
+    {
+        "id": "cq_g_sub",
+        "type": "group",
+        "z": "cq_tab",
+        "name": "SUBSCRIBE  —  stream value changes (no input needed)",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#d6c9f1", "fill-opacity": "0.4" },
+        "nodes": ["cq_sub_c", "cq_sub", "cq_sub_dbg"],
+        "x": 74, "y": 526, "w": 762, "h": 132
+    },
+    {
+        "id": "cq_sub_c", "type": "comment", "z": "cq_tab", "g": "cq_g_sub",
+        "name": "Arms automatically on deploy and re-arms after a reconnect. Emits on every change.",
+        "x": 350, "y": 566, "wires": []
+    },
+    {
+        "id": "cq_sub", "type": "opcua-subscribe", "z": "cq_tab", "g": "cq_g_sub",
+        "name": "", "endpoint": "cq_endpoint", "nodeId": "ns=1;s=Temperature",
+        "samplingInterval": 1000, "publishingInterval": 1000,
+        "x": 200, "y": 616, "wires": [["cq_sub_dbg"]]
+    },
+    {
+        "id": "cq_sub_dbg", "type": "debug", "z": "cq_tab", "g": "cq_g_sub",
+        "name": "live value", "active": true, "complete": "payload", "targetType": "msg",
+        "x": 470, "y": 616, "wires": []
+    },
+
+    {
+        "id": "cq_endpoint",
+        "type": "opcua-endpoint",
+        "name": "OPC-UA Server",
+        "endpointUrl": "opc.tcp://localhost:4840",
+        "securityMode": "None",
+        "securityPolicy": "None",
+        "authType": "anonymous"
+    }
+]

package/examples/server-and-client-demo.json

@@ -0,0 +1,197 @@
+[
+    {
+        "id": "demo_tab",
+        "type": "tab",
+        "label": "OPC-UA · Server + Client Demo",
+        "disabled": false,
+        "info": "# OPC-UA Server + Client — self-contained demo\n\nThis flow runs **both** an OPC-UA server and a client in the same Node-RED, so it\nworks the moment you **Deploy** — no external server needed.\n\n## How it works\n1. **Server** (orange): click **Simulate sensor** to push a random temperature\n   into the `Temperature` variable the server exposes.\n2. **Client** (blue): reads + subscribes to that same server on\n   `opc.tcp://localhost:4840/UA/NodeRED`, and can write the `Setpoint`.\n3. When the client writes `Setpoint`, the **server's output** reports it.\n\n## Try it\n- Click **Deploy**, then open the **Debug** sidebar.\n- Click **Simulate sensor** a few times — *Live temperature* (subscription) and\n  *Read once* both reflect the new value.\n- Click **Write Setpoint = 50** and see the server report the client write.\n\n## Endpoint note\nThe client Endpoint here is `opc.tcp://localhost:4840/UA/NodeRED`, which works because\nthe server and client run in the **same** Node-RED. To connect to a server elsewhere,\nuse that server's **hostname or IP** instead of `localhost` (and make sure the port is\nreachable). A wrong endpoint makes the client nodes show a red **error** status."
+    },
+
+    {
+        "id": "demo_help",
+        "type": "comment",
+        "z": "demo_tab",
+        "name": "Self-contained: the client talks to the server on opc.tcp://localhost:4840/UA/NodeRED. Click 'Simulate sensor' to drive it. (For a remote server, use its hostname/IP.)",
+        "info": "Client Endpoint = opc.tcp://localhost:4840/UA/NodeRED.\nlocalhost works because server+client share this Node-RED.\nTo connect to a server elsewhere, use that server's hostname or IP.\nWrong endpoint = red 'error' on client nodes.",
+        "x": 360,
+        "y": 30,
+        "wires": []
+    },
+
+    {
+        "id": "demo_g_server",
+        "type": "group",
+        "z": "demo_tab",
+        "name": "1 · OPC-UA SERVER  —  exposes Node-RED data",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#fdd0a2", "fill-opacity": "0.4" },
+        "nodes": ["demo_s_note", "demo_s_tick", "demo_s_fn", "demo_s_server", "demo_s_dbg"],
+        "x": 74, "y": 60, "w": 752, "h": 212
+    },
+    {
+        "id": "demo_s_note",
+        "type": "comment",
+        "z": "demo_tab",
+        "g": "demo_g_server",
+        "name": "Click 'Simulate sensor' to push a value into the served 'Temperature' variable",
+        "x": 360, "y": 100, "wires": []
+    },
+    {
+        "id": "demo_s_tick",
+        "type": "inject",
+        "z": "demo_tab",
+        "g": "demo_g_server",
+        "name": "Simulate sensor",
+        "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "", "payloadType": "date",
+        "x": 180, "y": 150,
+        "wires": [["demo_s_fn"]]
+    },
+    {
+        "id": "demo_s_fn",
+        "type": "function",
+        "z": "demo_tab",
+        "g": "demo_g_server",
+        "name": "Random 20–25 °C",
+        "func": "msg.topic = 'Temperature';\nmsg.payload = Math.round((20 + Math.random() * 5) * 100) / 100;\nreturn msg;",
+        "outputs": 1,
+        "x": 410, "y": 150,
+        "wires": [["demo_s_server"]]
+    },
+    {
+        "id": "demo_s_server",
+        "type": "opcua-server",
+        "z": "demo_tab",
+        "g": "demo_g_server",
+        "name": "Node-RED OPC-UA Server",
+        "port": 4840,
+        "resourcePath": "/UA/NodeRED",
+        "serverName": "Node-RED OPC-UA Server",
+        "folderName": "NodeRED",
+        "allowAnonymous": true,
+        "variables": [
+            { "name": "Temperature", "dataType": "Double", "value": "20" },
+            { "name": "Setpoint", "dataType": "Double", "value": "0" }
+        ],
+        "x": 640, "y": 150,
+        "wires": [["demo_s_dbg"]]
+    },
+    {
+        "id": "demo_s_dbg",
+        "type": "debug",
+        "z": "demo_tab",
+        "g": "demo_g_server",
+        "name": "Client wrote →",
+        "active": true, "complete": "true", "targetType": "full",
+        "x": 650, "y": 220, "wires": []
+    },
+
+    {
+        "id": "demo_g_client",
+        "type": "group",
+        "z": "demo_tab",
+        "name": "2 · OPC-UA CLIENT  —  reads from the server above",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#bdd7e7", "fill-opacity": "0.4" },
+        "nodes": ["demo_c_note", "demo_c_read_tick", "demo_c_read", "demo_c_read_dbg", "demo_c_sub", "demo_c_sub_dbg", "demo_c_write_tick", "demo_c_write", "demo_c_write_dbg"],
+        "x": 74, "y": 300, "w": 752, "h": 300
+    },
+    {
+        "id": "demo_c_note",
+        "type": "comment",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "Connects to opc.tcp://localhost:4840/UA/NodeRED (the server above)",
+        "x": 290, "y": 340, "wires": []
+    },
+    {
+        "id": "demo_c_read_tick",
+        "type": "inject",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "Read once",
+        "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "", "payloadType": "date",
+        "x": 180, "y": 390,
+        "wires": [["demo_c_read"]]
+    },
+    {
+        "id": "demo_c_read",
+        "type": "opcua-read",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "read Temperature",
+        "endpoint": "demo_endpoint",
+        "nodeId": "ns=1;s=Temperature",
+        "x": 410, "y": 390,
+        "wires": [["demo_c_read_dbg"]]
+    },
+    {
+        "id": "demo_c_read_dbg",
+        "type": "debug",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "Read value",
+        "active": true, "complete": "payload", "targetType": "msg",
+        "x": 650, "y": 390, "wires": []
+    },
+    {
+        "id": "demo_c_sub",
+        "type": "opcua-subscribe",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "subscribe Temperature",
+        "endpoint": "demo_endpoint",
+        "nodeId": "ns=1;s=Temperature",
+        "samplingInterval": 1000,
+        "publishingInterval": 1000,
+        "x": 200, "y": 460,
+        "wires": [["demo_c_sub_dbg"]]
+    },
+    {
+        "id": "demo_c_sub_dbg",
+        "type": "debug",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "Live temperature",
+        "active": true, "complete": "payload", "targetType": "msg",
+        "x": 470, "y": 460, "wires": []
+    },
+    {
+        "id": "demo_c_write_tick",
+        "type": "inject",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "Write Setpoint = 50",
+        "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "50", "payloadType": "num",
+        "x": 190, "y": 540,
+        "wires": [["demo_c_write"]]
+    },
+    {
+        "id": "demo_c_write",
+        "type": "opcua-write",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "write Setpoint",
+        "endpoint": "demo_endpoint",
+        "nodeId": "ns=1;s=Setpoint",
+        "dataType": "Double",
+        "x": 410, "y": 540,
+        "wires": [["demo_c_write_dbg"]]
+    },
+    {
+        "id": "demo_c_write_dbg",
+        "type": "debug",
+        "z": "demo_tab",
+        "g": "demo_g_client",
+        "name": "Write status",
+        "active": true, "complete": "statusCode", "targetType": "msg",
+        "x": 650, "y": 540, "wires": []
+    },
+
+    {
+        "id": "demo_endpoint",
+        "type": "opcua-endpoint",
+        "name": "Local Node-RED Server",
+        "endpointUrl": "opc.tcp://localhost:4840/UA/NodeRED",
+        "securityMode": "None",
+        "securityPolicy": "None",
+        "authType": "anonymous"
+    }
+]

package/examples/server-quickstart.json

@@ -0,0 +1,83 @@
+[
+    {
+        "id": "sq_tab",
+        "type": "tab",
+        "label": "OPC-UA · Server Quickstart",
+        "disabled": false,
+        "info": "# OPC-UA Server Quickstart\n\nExpose Node-RED data as an OPC-UA server that external clients (SCADA, MES,\nother Node-RED instances) can read, subscribe to, and write.\n\n## Setup\n1. The **opcua-server** node is preconfigured on port `4840`, path `/UA/NodeRED`,\n   with two variables: `Temperature` and `Setpoint`.\n2. **Deploy.** The node badge shows `running :4840`.\n3. Click **Update Temperature** to push a value into the server.\n4. The right group reports values **written by clients**.\n\n## Connect a client to this server\nFrom any OPC-UA client (incl. the *Client Quickstart* example) set the endpoint to:\n```\nopc.tcp://localhost:4840/UA/NodeRED\n```\n- Use `localhost` only if the client runs on the **same machine** as this server;\n  otherwise use this machine's **hostname or IP** (and ensure the port is reachable).\n- Security None / Anonymous matches the defaults here.\n- A wrong URL/port/path makes the client show a red **error** status.\n\n## Update / add variables\nSend `msg.topic = \"<name>\"`, `msg.payload = <value>`. Unknown names are created\non the fly (set `msg.dataType` to choose the type, default Double)."
+    },
+
+    {
+        "id": "sq_help",
+        "type": "comment",
+        "z": "sq_tab",
+        "name": "Clients connect to  opc.tcp://HOST:4840/UA/NodeRED  (HOST = localhost if on this machine, else this machine's hostname/IP). Wrong URL/port/path = red 'error' on the client.",
+        "info": "This node IS the server. Point a client's Endpoint at:\nopc.tcp://HOST:4840/UA/NodeRED\n- HOST = localhost if the client is on the same machine, otherwise this machine's hostname or IP\n- Security None / Anonymous by default",
+        "x": 360,
+        "y": 30,
+        "wires": []
+    },
+
+    {
+        "id": "sq_g_in",
+        "type": "group",
+        "z": "sq_tab",
+        "name": "FEED DATA IN  —  Node-RED → served variables",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#c7e9c0", "fill-opacity": "0.4" },
+        "nodes": ["sq_in_c", "sq_tick", "sq_fn"],
+        "x": 74, "y": 70, "w": 472, "h": 132
+    },
+    {
+        "id": "sq_in_c", "type": "comment", "z": "sq_tab", "g": "sq_g_in",
+        "name": "Push a Temperature value the server exposes (click to send)",
+        "x": 270, "y": 110, "wires": []
+    },
+    {
+        "id": "sq_tick", "type": "inject", "z": "sq_tab", "g": "sq_g_in",
+        "name": "Update Temperature", "props": [{ "p": "payload" }], "repeat": "", "crontab": "", "once": false, "onceDelay": 0.1, "topic": "", "payload": "", "payloadType": "date",
+        "x": 180, "y": 160, "wires": [["sq_fn"]]
+    },
+    {
+        "id": "sq_fn", "type": "function", "z": "sq_tab", "g": "sq_g_in",
+        "name": "Temperature 20–25", "func": "msg.topic = 'Temperature';\nmsg.payload = Math.round((20 + Math.random() * 5) * 100) / 100;\nreturn msg;",
+        "outputs": 1, "x": 400, "y": 160, "wires": [["sq_server"]]
+    },
+
+    {
+        "id": "sq_server",
+        "type": "opcua-server",
+        "z": "sq_tab",
+        "name": "Node-RED OPC-UA Server",
+        "port": 4840,
+        "resourcePath": "/UA/NodeRED",
+        "serverName": "Node-RED OPC-UA Server",
+        "folderName": "NodeRED",
+        "allowAnonymous": true,
+        "variables": [
+            { "name": "Temperature", "dataType": "Double", "value": "20" },
+            { "name": "Setpoint", "dataType": "Double", "value": "0" }
+        ],
+        "x": 400, "y": 270,
+        "wires": [["sq_out"]]
+    },
+
+    {
+        "id": "sq_g_out",
+        "type": "group",
+        "z": "sq_tab",
+        "name": "CLIENT WRITES OUT  —  react when a client changes a variable",
+        "style": { "label": true, "label-position": "nw", "color": "#3b3b3b", "fill": "#bdd7e7", "fill-opacity": "0.4" },
+        "nodes": ["sq_out_c", "sq_out"],
+        "x": 74, "y": 360, "w": 472, "h": 132
+    },
+    {
+        "id": "sq_out_c", "type": "comment", "z": "sq_tab", "g": "sq_g_out",
+        "name": "Emitted on every client write: {topic, payload, nodeId, source}",
+        "x": 280, "y": 400, "wires": []
+    },
+    {
+        "id": "sq_out", "type": "debug", "z": "sq_tab", "g": "sq_g_out",
+        "name": "client wrote", "active": true, "complete": "true", "targetType": "full",
+        "x": 250, "y": 450, "wires": []
+    }
+]