@fa_yoshinobu/node-red-contrib-plc-comm-slmp 0.2.1

package/examples/flows/slmp-device-matrix.json

@@ -0,0 +1,514 @@
+[
+    {
+        "id":  "tab-slmp-device-matrix",
+        "type":  "tab",
+        "label":  "SLMP Device Matrix",
+        "disabled":  false,
+        "info":  "High-level one-by-one sample for every supported device code. Edit the catalog in the function node before deploy if your PLC uses different ranges."
+    },
+    {
+        "id":  "comment-slmp-device-matrix-main",
+        "type":  "comment",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "High-level one-by-one read/write sample with persistent JSONL logging and timeout tracking",
+        "info":  "",
+        "x":  350,
+        "y":  40,
+        "wires":  [
+
+                  ]
+    },
+    {
+        "id":  "comment-slmp-device-matrix-edit",
+        "type":  "comment",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Edit the catalog in \u0027Prepare next device sample\u0027 before deploy. Completed results append to logs/slmp-device-matrix-\u003csession\u003e.jsonl",
+        "info":  "",
+        "x":  400,
+        "y":  80,
+        "wires":  [
+
+                  ]
+    },
+    {
+        "id":  "inject-device-matrix-reset",
+        "type":  "inject",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Reset sequence + history",
+        "props":  [
+                      {
+                          "p":  "mode",
+                          "v":  "reset",
+                          "vt":  "str"
+                      }
+                  ],
+        "repeat":  "",
+        "crontab":  "",
+        "once":  false,
+        "onceDelay":  0.1,
+        "topic":  "",
+        "x":  140,
+        "y":  140,
+        "wires":  [
+                      [
+                          "function-device-matrix-router"
+                      ]
+                  ]
+    },
+    {
+        "id":  "inject-device-matrix-catalog",
+        "type":  "inject",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Show catalog",
+        "props":  [
+                      {
+                          "p":  "mode",
+                          "v":  "catalog",
+                          "vt":  "str"
+                      }
+                  ],
+        "repeat":  "",
+        "crontab":  "",
+        "once":  false,
+        "onceDelay":  0.1,
+        "topic":  "",
+        "x":  110,
+        "y":  180,
+        "wires":  [
+                      [
+                          "function-device-matrix-router"
+                      ]
+                  ]
+    },
+    {
+        "id":  "inject-device-matrix-read",
+        "type":  "inject",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Read next device",
+        "props":  [
+                      {
+                          "p":  "mode",
+                          "v":  "readNext",
+                          "vt":  "str"
+                      }
+                  ],
+        "repeat":  "",
+        "crontab":  "",
+        "once":  false,
+        "onceDelay":  0.1,
+        "topic":  "",
+        "x":  120,
+        "y":  220,
+        "wires":  [
+                      [
+                          "function-device-matrix-router"
+                      ]
+                  ]
+    },
+    {
+        "id":  "inject-device-matrix-write",
+        "type":  "inject",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Write next device",
+        "props":  [
+                      {
+                          "p":  "mode",
+                          "v":  "writeNext",
+                          "vt":  "str"
+                      }
+                  ],
+        "repeat":  "",
+        "crontab":  "",
+        "once":  false,
+        "onceDelay":  0.1,
+        "topic":  "",
+        "x":  120,
+        "y":  260,
+        "wires":  [
+                      [
+                          "function-device-matrix-router"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-router",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Prepare next device sample (edit catalog here)",
+        "func":  "const catalog = [\n    { code: \u0027SM\u0027, address: \u0027SM10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027SD\u0027, address: \u0027SD10\u0027, value: 1, note: \u0027word decimal\u0027 },\n    { code: \u0027X\u0027, address: \u0027X10\u0027, value: true, note: \u0027bit hexadecimal\u0027 },\n    { code: \u0027Y\u0027, address: \u0027Y10\u0027, value: true, note: \u0027bit hexadecimal\u0027 },\n    { code: \u0027M\u0027, address: \u0027M10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027L\u0027, address: \u0027L10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027F\u0027, address: \u0027F10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027V\u0027, address: \u0027V10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027B\u0027, address: \u0027B10\u0027, value: true, note: \u0027bit hexadecimal\u0027 },\n    { code: \u0027D\u0027, address: \u0027D30\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027W\u0027, address: \u0027W10\u0027, value: 123, note: \u0027word hexadecimal\u0027 },\n    { code: \u0027TS\u0027, address: \u0027TS10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027TC\u0027, address: \u0027TC10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027TN\u0027, address: \u0027TN10\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027LTS\u0027, address: \u0027LTS10\u0027, value: true, note: \u0027long timer contact\u0027 },\n    { code: \u0027LTC\u0027, address: \u0027LTC10\u0027, value: true, note: \u0027long timer coil\u0027 },\n    { code: \u0027LTN\u0027, address: \u0027LTN10\u0027, value: 123456, note: \u0027long timer current dword\u0027 },\n    { code: \u0027STS\u0027, address: \u0027STS10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027STC\u0027, address: \u0027STC10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027STN\u0027, address: \u0027STN10\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027LSTS\u0027, address: \u0027LSTS10\u0027, value: true, note: \u0027long retentive timer contact\u0027 },\n    { code: \u0027LSTC\u0027, address: \u0027LSTC10\u0027, value: true, note: \u0027long retentive timer coil\u0027 },\n    { code: \u0027LSTN\u0027, address: \u0027LSTN10\u0027, value: 123456, note: \u0027long retentive timer current dword\u0027 },\n    { code: \u0027CS\u0027, address: \u0027CS10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027CC\u0027, address: \u0027CC10\u0027, value: true, note: \u0027bit decimal\u0027 },\n    { code: \u0027CN\u0027, address: \u0027CN10\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027LCS\u0027, address: \u0027LCS10\u0027, value: true, note: \u0027long counter contact\u0027 },\n    { code: \u0027LCC\u0027, address: \u0027LCC10\u0027, value: true, note: \u0027long counter coil\u0027 },\n    { code: \u0027LCN\u0027, address: \u0027LCN10\u0027, value: 123456, note: \u0027long counter current dword\u0027 },\n    { code: \u0027SB\u0027, address: \u0027SB10\u0027, value: true, note: \u0027bit hexadecimal\u0027 },\n    { code: \u0027SW\u0027, address: \u0027SW10\u0027, value: 123, note: \u0027word hexadecimal\u0027 },\n    { code: \u0027DX\u0027, address: \u0027DX10\u0027, value: true, note: \u0027bit hexadecimal\u0027 },\n    { code: \u0027DY\u0027, address: \u0027DY10\u0027, value: true, note: \u0027bit hexadecimal\u0027 },\n    { code: \u0027Z\u0027, address: \u0027Z10\u0027, value: 1, note: \u0027word decimal\u0027 },\n    { code: \u0027LZ\u0027, address: \u0027LZ10\u0027, value: 1, note: \u0027word decimal\u0027 },\n    { code: \u0027R\u0027, address: \u0027R10\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027ZR\u0027, address: \u0027ZR10\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027RD\u0027, address: \u0027RD10\u0027, value: 123, note: \u0027word decimal\u0027 },\n    { code: \u0027G\u0027, address: \u0027G10\u0027, value: 123, note: \u0027word decimal via U0\\\\G10 equivalent target\u0027, target: { moduleIO: \u00270000\u0027 } },\n    { code: \u0027HG\u0027, address: \u0027HG20\u0027, value: 123, note: \u0027word decimal via U3E0\\\\HG20 equivalent target\u0027, target: { moduleIO: \u002703E0\u0027 } }\n];\n\nconst total = catalog.length;\nconst readKey = \u0027slmpDeviceMatrixReadIndex\u0027;\nconst writeKey = \u0027slmpDeviceMatrixWriteIndex\u0027;\nconst resultsKey = \u0027slmpDeviceMatrixResults\u0027;\nconst pendingKey = \u0027slmpDeviceMatrixPendingById\u0027;\nconst sessionKey = \u0027slmpDeviceMatrixSessionId\u0027;\nconst logPathKey = \u0027slmpDeviceMatrixLogPath\u0027;\nconst timeoutKey = \u0027slmpDeviceMatrixTimeoutMs\u0027;\nconst totalKey = \u0027slmpDeviceMatrixTotalCatalog\u0027;\nconst action = String(msg.mode || \u0027catalog\u0027);\n\nflow.set(totalKey, total);\nflow.set(\u0027slmpDeviceMatrixCatalog\u0027, catalog);\nif (!flow.get(timeoutKey)) {\n    flow.set(timeoutKey, 5000);\n}\n\nfunction makeSessionId() {\n    return new Date().toISOString().replace(/[:.]/g, \u0027-\u0027);\n}\n\nfunction ensureSessionId(reset) {\n    let sessionId = flow.get(sessionKey);\n    if (reset || !sessionId) {\n        sessionId = makeSessionId();\n        flow.set(sessionKey, sessionId);\n    }\n    return sessionId;\n}\n\nfunction ensureLogPath(sessionId, reset) {\n    let logPath = flow.get(logPathKey);\n    if (reset || !logPath) {\n        logPath = \u0027logs/slmp-device-matrix-\u0027 + sessionId + \u0027.jsonl\u0027;\n        flow.set(logPathKey, logPath);\n    }\n    return logPath;\n}\n\nfunction getPendingMap() {\n    return Object.assign({}, flow.get(pendingKey) || {});\n}\n\nfunction getResults() {\n    return Array.from(flow.get(resultsKey) || []);\n}\n\nfunction buildSummary() {\n    const results = getResults();\n    const pending = getPendingMap();\n    const summary = {\n        kind: \u0027summary\u0027,\n        sessionId: ensureSessionId(false),\n        logPath: ensureLogPath(ensureSessionId(false), false),\n        totalCatalog: total,\n        completed: results.length,\n        ok: 0,\n        ng: 0,\n        mismatch: 0,\n        timeout: 0,\n        pending: Object.keys(pending).length,\n        pendingIds: Object.keys(pending)\n    };\n    for (const entry of results) {\n        if (entry.status === \u0027OK\u0027) {\n            summary.ok += 1;\n        } else {\n            summary.ng += 1;\n            if (entry.status === \u0027MISMATCH\u0027) {\n                summary.mismatch += 1;\n            }\n            if (entry.status === \u0027TIMEOUT\u0027) {\n                summary.timeout += 1;\n            }\n        }\n    }\n    return summary;\n}\n\nfunction registerPending(kind, index, entry) {\n    const sessionId = ensureSessionId(false);\n    const logPath = ensureLogPath(sessionId, false);\n    const now = new Date().toISOString();\n    const requestId = kind + \u0027-\u0027 + entry.code + \u0027-\u0027 + String(index + 1) + \u0027-\u0027 + String(Date.now());\n    const pending = getPendingMap();\n    const record = {\n        kind: \u0027result\u0027,\n        requestId: requestId,\n        sessionId: sessionId,\n        logPath: logPath,\n        operation: kind,\n        action: kind === \u0027write\u0027 ? \u0027write-readback\u0027 : \u0027read\u0027,\n        deviceCode: entry.code,\n        address: entry.address,\n        target: entry.target || null,\n        note: entry.note,\n        sequence: {\n            index: index + 1,\n            total: total\n        },\n        status: \u0027PENDING\u0027,\n        phase: kind === \u0027write\u0027 ? \u0027WRITE_PENDING\u0027 : \u0027READ_PENDING\u0027,\n        ok: null,\n        expectedValue: kind === \u0027write\u0027 ? entry.value : null,\n        writeValue: kind === \u0027write\u0027 ? entry.value : null,\n        writeStatus: kind === \u0027write\u0027 ? \u0027PENDING\u0027 : \u0027SKIPPED\u0027,\n        readValue: null,\n        readStatus: \u0027PENDING\u0027,\n        readbackStatus: kind === \u0027write\u0027 ? \u0027PENDING\u0027 : \u0027SKIPPED\u0027,\n        error: null,\n        startedAt: now,\n        updatedAt: now,\n        finishedAt: null\n    };\n    pending[requestId] = record;\n    flow.set(pendingKey, pending);\n    return record;\n}\n\nif (action === \u0027reset\u0027) {\n    const sessionId = ensureSessionId(true);\n    const logPath = ensureLogPath(sessionId, true);\n    flow.set(readKey, 0);\n    flow.set(writeKey, 0);\n    flow.set(resultsKey, []);\n    flow.set(pendingKey, {});\n    return [null, null, {\n        payload: {\n            kind: \u0027reset\u0027,\n            sessionId: sessionId,\n            logPath: logPath,\n            totalCatalog: total,\n            timeoutMs: flow.get(timeoutKey),\n            note: \u0027In-memory history cleared. Completed results append to the JSONL log file.\u0027\n        }\n    }];\n}\n\nif (action === \u0027catalog\u0027) {\n    const sessionId = ensureSessionId(false);\n    const logPath = ensureLogPath(sessionId, false);\n    return [null, null, {\n        payload: {\n            kind: \u0027catalog\u0027,\n            sessionId: sessionId,\n            logPath: logPath,\n            totalCatalog: total,\n            timeoutMs: flow.get(timeoutKey),\n            entries: catalog,\n            summary: buildSummary()\n        }\n    }];\n}\n\nif (action === \u0027readNext\u0027) {\n    const index = Number(flow.get(readKey) || 0) % total;\n    const entry = catalog[index];\n    flow.set(readKey, index + 1);\n    const record = registerPending(\u0027read\u0027, index, entry);\n    return [\n        {\n            topic: \u0027read:\u0027 + entry.code,\n            action: \u0027read\u0027,\n            requestId: record.requestId,\n            deviceSample: entry,\n            sequence: record.sequence,\n            startedAt: record.startedAt,\n            addresses: [entry.address],\n            target: entry.target || undefined\n        },\n        null,\n        { payload: record }\n    ];\n}\n\nif (action === \u0027writeNext\u0027) {\n    const index = Number(flow.get(writeKey) || 0) % total;\n    const entry = catalog[index];\n    flow.set(writeKey, index + 1);\n    const record = registerPending(\u0027write\u0027, index, entry);\n    const updates = {};\n    updates[entry.address] = entry.value;\n    return [\n        null,\n        {\n            topic: \u0027write:\u0027 + entry.code,\n            action: \u0027write\u0027,\n            requestId: record.requestId,\n            deviceSample: entry,\n            sequence: record.sequence,\n            startedAt: record.startedAt,\n            payload: updates,\n            target: entry.target || undefined\n        },\n        { payload: record }\n    ];\n}\n\nnode.error(\u0027Unknown mode: \u0027 + action, msg);\nreturn null;",
+        "outputs":  3,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  450,
+        "y":  200,
+        "wires":  [
+                      [
+                          "read-device-matrix"
+                      ],
+                      [
+                          "write-device-matrix"
+                      ],
+                      [
+                          "debug-device-matrix-status"
+                      ]
+                  ]
+    },
+    {
+        "id":  "read-device-matrix",
+        "type":  "slmp-read",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Read one sample",
+        "connection":  "cfg-slmp-device-matrix",
+        "addresses":  "addresses",
+        "addressesType":  "msg",
+        "outputMode":  "value",
+        "errorHandling":  "output2",
+        "x":  760,
+        "y":  180,
+        "wires":  [
+                      [
+                          "function-device-matrix-format-read-ok"
+                      ],
+                      [
+                          "function-device-matrix-format-read-error"
+                      ]
+                  ]
+    },
+    {
+        "id":  "write-device-matrix",
+        "type":  "slmp-write",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Write one sample",
+        "connection":  "cfg-slmp-device-matrix",
+        "updates":  "payload",
+        "updatesType":  "msg",
+        "errorHandling":  "output2",
+        "x":  760,
+        "y":  280,
+        "wires":  [
+                      [
+                          "function-device-matrix-format-write-ok"
+                      ],
+                      [
+                          "function-device-matrix-format-write-error"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-format-read-ok",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Finalize read result",
+        "func":  "const resultsKey = \u0027slmpDeviceMatrixResults\u0027;\nconst pendingKey = \u0027slmpDeviceMatrixPendingById\u0027;\nconst totalKey = \u0027slmpDeviceMatrixTotalCatalog\u0027;\nconst sessionKey = \u0027slmpDeviceMatrixSessionId\u0027;\nconst logPathKey = \u0027slmpDeviceMatrixLogPath\u0027;\nconst sample = msg.deviceSample || {};\nconst pending = Object.assign({}, flow.get(pendingKey) || {});\nconst results = Array.from(flow.get(resultsKey) || []);\nconst total = Number(flow.get(totalKey) || 0);\nconst now = new Date().toISOString();\nconst address = sample.address || ((msg.slmp \u0026\u0026 Array.isArray(msg.slmp.addresses) \u0026\u0026 msg.slmp.addresses[0]) || null);\n\nfunction valuesMatch(expected, actual) {\n    if (typeof expected === \u0027boolean\u0027) {\n        if (typeof actual === \u0027boolean\u0027) {\n            return expected === actual;\n        }\n        if (actual === 0 || actual === 1) {\n            return Boolean(actual) === expected;\n        }\n        if (actual === \u0027true\u0027 || actual === \u0027false\u0027) {\n            return (actual === \u0027true\u0027) === expected;\n        }\n    }\n    return JSON.stringify(actual) === JSON.stringify(expected);\n}\n\nfunction buildSummary() {\n    const summary = {\n        kind: \u0027summary\u0027,\n        sessionId: flow.get(sessionKey) || null,\n        logPath: flow.get(logPathKey) || null,\n        totalCatalog: total,\n        completed: results.length,\n        ok: 0,\n        ng: 0,\n        mismatch: 0,\n        timeout: 0,\n        pending: Object.keys(pending).length,\n        pendingIds: Object.keys(pending)\n    };\n    for (const entry of results) {\n        if (entry.status === \u0027OK\u0027) {\n            summary.ok += 1;\n        } else {\n            summary.ng += 1;\n            if (entry.status === \u0027MISMATCH\u0027) {\n                summary.mismatch += 1;\n            }\n            if (entry.status === \u0027TIMEOUT\u0027) {\n                summary.timeout += 1;\n            }\n        }\n    }\n    return summary;\n}\n\nconst record = Object.assign({\n    kind: \u0027result\u0027,\n    requestId: msg.requestId || (\u0027read-\u0027 + (sample.code || \u0027unknown\u0027) + \u0027-\u0027 + String(Date.now())),\n    sessionId: flow.get(sessionKey) || null,\n    logPath: flow.get(logPathKey) || null,\n    operation: msg.action === \u0027write-readback\u0027 ? \u0027write\u0027 : \u0027read\u0027,\n    action: msg.action || \u0027read\u0027,\n    deviceCode: sample.code || null,\n    address: address,\n    note: sample.note || \u0027\u0027,\n    sequence: msg.sequence || null,\n    status: \u0027PENDING\u0027,\n    phase: \u0027DONE\u0027,\n    ok: null,\n    expectedValue: null,\n    writeValue: null,\n    writeStatus: msg.action === \u0027write-readback\u0027 ? \u0027UNKNOWN\u0027 : \u0027SKIPPED\u0027,\n    readValue: null,\n    readStatus: \u0027PENDING\u0027,\n    readbackStatus: msg.action === \u0027write-readback\u0027 ? \u0027PENDING\u0027 : \u0027SKIPPED\u0027,\n    error: null,\n    startedAt: msg.startedAt || now,\n    updatedAt: now,\n    finishedAt: now\n}, pending[msg.requestId] || {});\n\nrecord.updatedAt = now;\nrecord.finishedAt = now;\nrecord.phase = \u0027DONE\u0027;\nrecord.address = address;\nrecord.deviceCode = sample.code || record.deviceCode;\nrecord.note = sample.note || record.note || \u0027\u0027;\nrecord.sequence = msg.sequence || record.sequence || null;\nrecord.readValue = msg.payload;\nrecord.error = null;\n\nif (msg.action === \u0027write-readback\u0027) {\n    const matched = valuesMatch(record.expectedValue, msg.payload);\n    record.writeStatus = record.writeStatus === \u0027OK\u0027 ? \u0027OK\u0027 : \u0027UNKNOWN\u0027;\n    record.readStatus = matched ? \u0027OK\u0027 : \u0027MISMATCH\u0027;\n    record.readbackStatus = matched ? \u0027OK\u0027 : \u0027MISMATCH\u0027;\n    record.status = matched ? \u0027OK\u0027 : \u0027MISMATCH\u0027;\n    record.ok = matched;\n    if (!matched) {\n        record.error = \u0027Readback mismatch\u0027;\n    }\n} else {\n    record.writeStatus = \u0027SKIPPED\u0027;\n    record.readStatus = \u0027OK\u0027;\n    record.readbackStatus = \u0027SKIPPED\u0027;\n    record.status = \u0027OK\u0027;\n    record.ok = true;\n}\n\nif (record.requestId \u0026\u0026 Object.prototype.hasOwnProperty.call(pending, record.requestId)) {\n    delete pending[record.requestId];\n}\nresults.push(record);\nflow.set(pendingKey, pending);\nflow.set(resultsKey, results);\n\nreturn [\n    { payload: record },\n    { payload: results },\n    { payload: buildSummary() },\n    { filename: flow.get(logPathKey), payload: JSON.stringify(record) }\n];",
+        "outputs":  4,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  1030,
+        "y":  160,
+        "wires":  [
+                      [
+                          "debug-device-matrix-latest"
+                      ],
+                      [
+                          "debug-device-matrix-history"
+                      ],
+                      [
+                          "debug-device-matrix-summary"
+                      ],
+                      [
+                          "file-device-matrix-log"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-format-read-error",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Finalize read error",
+        "func":  "const resultsKey = \u0027slmpDeviceMatrixResults\u0027;\nconst pendingKey = \u0027slmpDeviceMatrixPendingById\u0027;\nconst totalKey = \u0027slmpDeviceMatrixTotalCatalog\u0027;\nconst sessionKey = \u0027slmpDeviceMatrixSessionId\u0027;\nconst logPathKey = \u0027slmpDeviceMatrixLogPath\u0027;\nconst sample = msg.deviceSample || {};\nconst pending = Object.assign({}, flow.get(pendingKey) || {});\nconst results = Array.from(flow.get(resultsKey) || []);\nconst total = Number(flow.get(totalKey) || 0);\nconst now = new Date().toISOString();\nconst address = sample.address || ((msg.slmp \u0026\u0026 Array.isArray(msg.slmp.addresses) \u0026\u0026 msg.slmp.addresses[0]) || null);\n\nfunction buildSummary() {\n    const summary = {\n        kind: \u0027summary\u0027,\n        sessionId: flow.get(sessionKey) || null,\n        logPath: flow.get(logPathKey) || null,\n        totalCatalog: total,\n        completed: results.length,\n        ok: 0,\n        ng: 0,\n        mismatch: 0,\n        timeout: 0,\n        pending: Object.keys(pending).length,\n        pendingIds: Object.keys(pending)\n    };\n    for (const entry of results) {\n        if (entry.status === \u0027OK\u0027) {\n            summary.ok += 1;\n        } else {\n            summary.ng += 1;\n            if (entry.status === \u0027MISMATCH\u0027) {\n                summary.mismatch += 1;\n            }\n            if (entry.status === \u0027TIMEOUT\u0027) {\n                summary.timeout += 1;\n            }\n        }\n    }\n    return summary;\n}\n\nconst record = Object.assign({\n    kind: \u0027result\u0027,\n    requestId: msg.requestId || (\u0027read-\u0027 + (sample.code || \u0027unknown\u0027) + \u0027-\u0027 + String(Date.now())),\n    sessionId: flow.get(sessionKey) || null,\n    logPath: flow.get(logPathKey) || null,\n    operation: msg.action === \u0027write-readback\u0027 ? \u0027write\u0027 : \u0027read\u0027,\n    action: msg.action || \u0027read\u0027,\n    deviceCode: sample.code || null,\n    address: address,\n    note: sample.note || \u0027\u0027,\n    sequence: msg.sequence || null,\n    status: \u0027NG\u0027,\n    phase: \u0027DONE\u0027,\n    ok: false,\n    expectedValue: null,\n    writeValue: null,\n    writeStatus: msg.action === \u0027write-readback\u0027 ? \u0027UNKNOWN\u0027 : \u0027SKIPPED\u0027,\n    readValue: null,\n    readStatus: \u0027NG\u0027,\n    readbackStatus: msg.action === \u0027write-readback\u0027 ? \u0027NG\u0027 : \u0027SKIPPED\u0027,\n    error: null,\n    startedAt: msg.startedAt || now,\n    updatedAt: now,\n    finishedAt: now\n}, pending[msg.requestId] || {});\n\nrecord.updatedAt = now;\nrecord.finishedAt = now;\nrecord.phase = \u0027DONE\u0027;\nrecord.address = address;\nrecord.deviceCode = sample.code || record.deviceCode;\nrecord.note = sample.note || record.note || \u0027\u0027;\nrecord.sequence = msg.sequence || record.sequence || null;\nrecord.ok = false;\nrecord.status = \u0027NG\u0027;\nrecord.readValue = null;\nrecord.error = msg.error \u0026\u0026 msg.error.message ? msg.error.message : String(msg.error || \u0027Unknown read error\u0027);\n\nif (msg.action === \u0027write-readback\u0027) {\n    record.writeStatus = record.writeStatus === \u0027OK\u0027 ? \u0027OK\u0027 : \u0027UNKNOWN\u0027;\n    record.readStatus = \u0027NG\u0027;\n    record.readbackStatus = \u0027NG\u0027;\n} else {\n    record.writeStatus = \u0027SKIPPED\u0027;\n    record.readStatus = \u0027NG\u0027;\n    record.readbackStatus = \u0027SKIPPED\u0027;\n}\n\nif (record.requestId \u0026\u0026 Object.prototype.hasOwnProperty.call(pending, record.requestId)) {\n    delete pending[record.requestId];\n}\nresults.push(record);\nflow.set(pendingKey, pending);\nflow.set(resultsKey, results);\n\nreturn [\n    { payload: record },\n    { payload: results },\n    { payload: buildSummary() },\n    { filename: flow.get(logPathKey), payload: JSON.stringify(record) }\n];",
+        "outputs":  4,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  1030,
+        "y":  200,
+        "wires":  [
+                      [
+                          "debug-device-matrix-latest"
+                      ],
+                      [
+                          "debug-device-matrix-history"
+                      ],
+                      [
+                          "debug-device-matrix-summary"
+                      ],
+                      [
+                          "file-device-matrix-log"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-format-write-ok",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Mark write ok + read back",
+        "func":  "const pendingKey = \u0027slmpDeviceMatrixPendingById\u0027;\nconst pending = Object.assign({}, flow.get(pendingKey) || {});\nconst now = new Date().toISOString();\nconst sample = msg.deviceSample || {};\nconst updates = (msg.slmp \u0026\u0026 msg.slmp.updates) || msg.payload || {};\nconst address = sample.address || Object.keys(updates)[0] || null;\nconst writeValue = address \u0026\u0026 Object.prototype.hasOwnProperty.call(updates, address) ? updates[address] : null;\nconst record = pending[msg.requestId];\n\nif (record) {\n    record.phase = \u0027READBACK_PENDING\u0027;\n    record.writeStatus = \u0027OK\u0027;\n    record.writeValue = writeValue;\n    record.expectedValue = writeValue;\n    record.updatedAt = now;\n    pending[msg.requestId] = record;\n    flow.set(pendingKey, pending);\n}\n\nmsg.writeRequest = updates;\nmsg.action = \u0027write-readback\u0027;\nmsg.addresses = [address];\ndelete msg.payload;\nreturn msg;",
+        "outputs":  1,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  1030,
+        "y":  240,
+        "wires":  [
+                      [
+                          "read-device-matrix"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-format-write-error",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Finalize write error",
+        "func":  "const resultsKey = \u0027slmpDeviceMatrixResults\u0027;\nconst pendingKey = \u0027slmpDeviceMatrixPendingById\u0027;\nconst totalKey = \u0027slmpDeviceMatrixTotalCatalog\u0027;\nconst sessionKey = \u0027slmpDeviceMatrixSessionId\u0027;\nconst logPathKey = \u0027slmpDeviceMatrixLogPath\u0027;\nconst sample = msg.deviceSample || {};\nconst pending = Object.assign({}, flow.get(pendingKey) || {});\nconst results = Array.from(flow.get(resultsKey) || []);\nconst total = Number(flow.get(totalKey) || 0);\nconst now = new Date().toISOString();\nconst updates = (msg.slmp \u0026\u0026 msg.slmp.updates) || msg.payload || {};\nconst address = sample.address || Object.keys(updates)[0] || null;\n\nfunction buildSummary() {\n    const summary = {\n        kind: \u0027summary\u0027,\n        sessionId: flow.get(sessionKey) || null,\n        logPath: flow.get(logPathKey) || null,\n        totalCatalog: total,\n        completed: results.length,\n        ok: 0,\n        ng: 0,\n        mismatch: 0,\n        timeout: 0,\n        pending: Object.keys(pending).length,\n        pendingIds: Object.keys(pending)\n    };\n    for (const entry of results) {\n        if (entry.status === \u0027OK\u0027) {\n            summary.ok += 1;\n        } else {\n            summary.ng += 1;\n            if (entry.status === \u0027MISMATCH\u0027) {\n                summary.mismatch += 1;\n            }\n            if (entry.status === \u0027TIMEOUT\u0027) {\n                summary.timeout += 1;\n            }\n        }\n    }\n    return summary;\n}\n\nconst record = Object.assign({\n    kind: \u0027result\u0027,\n    requestId: msg.requestId || (\u0027write-\u0027 + (sample.code || \u0027unknown\u0027) + \u0027-\u0027 + String(Date.now())),\n    sessionId: flow.get(sessionKey) || null,\n    logPath: flow.get(logPathKey) || null,\n    operation: \u0027write\u0027,\n    action: \u0027write-readback\u0027,\n    deviceCode: sample.code || null,\n    address: address,\n    note: sample.note || \u0027\u0027,\n    sequence: msg.sequence || null,\n    status: \u0027NG\u0027,\n    phase: \u0027DONE\u0027,\n    ok: false,\n    expectedValue: address \u0026\u0026 Object.prototype.hasOwnProperty.call(updates, address) ? updates[address] : null,\n    writeValue: address \u0026\u0026 Object.prototype.hasOwnProperty.call(updates, address) ? updates[address] : null,\n    writeStatus: \u0027NG\u0027,\n    readValue: null,\n    readStatus: \u0027SKIPPED\u0027,\n    readbackStatus: \u0027SKIPPED\u0027,\n    error: null,\n    startedAt: msg.startedAt || now,\n    updatedAt: now,\n    finishedAt: now\n}, pending[msg.requestId] || {});\n\nrecord.updatedAt = now;\nrecord.finishedAt = now;\nrecord.phase = \u0027DONE\u0027;\nrecord.address = address;\nrecord.deviceCode = sample.code || record.deviceCode;\nrecord.note = sample.note || record.note || \u0027\u0027;\nrecord.sequence = msg.sequence || record.sequence || null;\nrecord.ok = false;\nrecord.status = \u0027NG\u0027;\nrecord.writeStatus = \u0027NG\u0027;\nrecord.readStatus = \u0027SKIPPED\u0027;\nrecord.readbackStatus = \u0027SKIPPED\u0027;\nrecord.error = msg.error \u0026\u0026 msg.error.message ? msg.error.message : String(msg.error || \u0027Unknown write error\u0027);\n\nif (record.requestId \u0026\u0026 Object.prototype.hasOwnProperty.call(pending, record.requestId)) {\n    delete pending[record.requestId];\n}\nresults.push(record);\nflow.set(pendingKey, pending);\nflow.set(resultsKey, results);\n\nreturn [\n    { payload: record },\n    { payload: results },\n    { payload: buildSummary() },\n    { filename: flow.get(logPathKey), payload: JSON.stringify(record) }\n];",
+        "outputs":  4,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  1030,
+        "y":  320,
+        "wires":  [
+                      [
+                          "debug-device-matrix-latest"
+                      ],
+                      [
+                          "debug-device-matrix-history"
+                      ],
+                      [
+                          "debug-device-matrix-summary"
+                      ],
+                      [
+                          "file-device-matrix-log"
+                      ]
+                  ]
+    },
+    {
+        "id":  "debug-device-matrix-status",
+        "type":  "debug",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Catalog / pending",
+        "active":  true,
+        "tosidebar":  true,
+        "console":  false,
+        "tostatus":  false,
+        "complete":  "payload",
+        "targetType":  "msg",
+        "x":  780,
+        "y":  120,
+        "wires":  [
+
+                  ]
+    },
+    {
+        "id":  "debug-device-matrix-latest",
+        "type":  "debug",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Latest device result",
+        "active":  true,
+        "tosidebar":  true,
+        "console":  false,
+        "tostatus":  false,
+        "complete":  "payload",
+        "targetType":  "msg",
+        "x":  1300,
+        "y":  220,
+        "wires":  [
+
+                  ]
+    },
+    {
+        "id":  "debug-device-matrix-history",
+        "type":  "debug",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Completed result history",
+        "active":  true,
+        "tosidebar":  true,
+        "console":  false,
+        "tostatus":  false,
+        "complete":  "payload",
+        "targetType":  "msg",
+        "x":  1290,
+        "y":  280,
+        "wires":  [
+
+                  ]
+    },
+    {
+        "id":  "cfg-slmp-device-matrix",
+        "type":  "slmp-connection",
+        "name":  "PLC TCP 4E",
+        "host":  "192.168.250.100",
+        "port":  "1025",
+        "transport":  "tcp",
+        "timeout":  "3000",
+        "plcSeries":  "iqr",
+        "frameType":  "4e",
+        "monitoringTimer":  "16",
+        "network":  "0",
+        "station":  "255",
+        "moduleIO":  "03FF",
+        "multidrop":  "0"
+    },
+    {
+        "id":  "inject-device-matrix-summary",
+        "type":  "inject",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Show summary",
+        "props":  [
+                      {
+                          "p":  "mode",
+                          "v":  "summary",
+                          "vt":  "str"
+                      }
+                  ],
+        "repeat":  "",
+        "crontab":  "",
+        "once":  false,
+        "onceDelay":  0.1,
+        "topic":  "",
+        "x":  100,
+        "y":  300,
+        "wires":  [
+                      [
+                          "function-device-matrix-summary"
+                      ]
+                  ]
+    },
+    {
+        "id":  "inject-device-matrix-timeout",
+        "type":  "inject",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Timeout sweep (auto 1s)",
+        "props":  [
+                      {
+                          "p":  "mode",
+                          "v":  "timeoutSweep",
+                          "vt":  "str"
+                      }
+                  ],
+        "repeat":  "1",
+        "crontab":  "",
+        "once":  false,
+        "onceDelay":  0.1,
+        "topic":  "",
+        "x":  120,
+        "y":  340,
+        "wires":  [
+                      [
+                          "function-device-matrix-timeout"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-summary",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Show current matrix summary",
+        "func":  "const results = Array.from(flow.get(\u0027slmpDeviceMatrixResults\u0027) || []);\nconst pending = Object.assign({}, flow.get(\u0027slmpDeviceMatrixPendingById\u0027) || {});\nconst total = Number(flow.get(\u0027slmpDeviceMatrixTotalCatalog\u0027) || 0);\nconst summary = {\n    kind: \u0027summary\u0027,\n    sessionId: flow.get(\u0027slmpDeviceMatrixSessionId\u0027) || null,\n    logPath: flow.get(\u0027slmpDeviceMatrixLogPath\u0027) || null,\n    totalCatalog: total,\n    completed: results.length,\n    ok: 0,\n    ng: 0,\n    mismatch: 0,\n    timeout: 0,\n    pending: Object.keys(pending).length,\n    pendingIds: Object.keys(pending),\n    pendingEntries: Object.values(pending)\n};\nfor (const entry of results) {\n    if (entry.status === \u0027OK\u0027) {\n        summary.ok += 1;\n    } else {\n        summary.ng += 1;\n        if (entry.status === \u0027MISMATCH\u0027) {\n            summary.mismatch += 1;\n        }\n        if (entry.status === \u0027TIMEOUT\u0027) {\n            summary.timeout += 1;\n        }\n    }\n}\nmsg.payload = summary;\nreturn msg;",
+        "outputs":  1,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  360,
+        "y":  300,
+        "wires":  [
+                      [
+                          "debug-device-matrix-summary"
+                      ]
+                  ]
+    },
+    {
+        "id":  "function-device-matrix-timeout",
+        "type":  "function",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Finalize timed out operations",
+        "func":  "const resultsKey = \u0027slmpDeviceMatrixResults\u0027;\nconst pendingKey = \u0027slmpDeviceMatrixPendingById\u0027;\nconst totalKey = \u0027slmpDeviceMatrixTotalCatalog\u0027;\nconst sessionKey = \u0027slmpDeviceMatrixSessionId\u0027;\nconst logPathKey = \u0027slmpDeviceMatrixLogPath\u0027;\nconst timeoutMs = Number(flow.get(\u0027slmpDeviceMatrixTimeoutMs\u0027) || 5000);\nconst pending = Object.assign({}, flow.get(pendingKey) || {});\nconst results = Array.from(flow.get(resultsKey) || []);\nconst total = Number(flow.get(totalKey) || 0);\nconst nowMs = Date.now();\nconst timedOut = [];\n\nfunction buildSummary() {\n    const summary = {\n        kind: \u0027summary\u0027,\n        sessionId: flow.get(sessionKey) || null,\n        logPath: flow.get(logPathKey) || null,\n        totalCatalog: total,\n        completed: results.length,\n        ok: 0,\n        ng: 0,\n        mismatch: 0,\n        timeout: 0,\n        pending: Object.keys(pending).length,\n        pendingIds: Object.keys(pending)\n    };\n    for (const entry of results) {\n        if (entry.status === \u0027OK\u0027) {\n            summary.ok += 1;\n        } else {\n            summary.ng += 1;\n            if (entry.status === \u0027MISMATCH\u0027) {\n                summary.mismatch += 1;\n            }\n            if (entry.status === \u0027TIMEOUT\u0027) {\n                summary.timeout += 1;\n            }\n        }\n    }\n    return summary;\n}\n\nfor (const requestId of Object.keys(pending)) {\n    const record = pending[requestId];\n    const started = Date.parse(record.updatedAt || record.startedAt || \u0027\u0027);\n    if (!Number.isFinite(started)) {\n        continue;\n    }\n    if ((nowMs - started) \u003c timeoutMs) {\n        continue;\n    }\n\n    const finishedAt = new Date().toISOString();\n    const timedOutRecord = Object.assign({}, record, {\n        status: \u0027TIMEOUT\u0027,\n        phase: \u0027DONE\u0027,\n        ok: false,\n        error: \u0027No completion within \u0027 + String(timeoutMs) + \u0027 ms\u0027,\n        updatedAt: finishedAt,\n        finishedAt: finishedAt\n    });\n\n    if (timedOutRecord.operation === \u0027write\u0027) {\n        if (timedOutRecord.writeStatus === \u0027PENDING\u0027) {\n            timedOutRecord.writeStatus = \u0027TIMEOUT\u0027;\n            timedOutRecord.readStatus = \u0027SKIPPED\u0027;\n            timedOutRecord.readbackStatus = \u0027SKIPPED\u0027;\n        } else {\n            timedOutRecord.readStatus = \u0027TIMEOUT\u0027;\n            timedOutRecord.readbackStatus = \u0027TIMEOUT\u0027;\n        }\n    } else {\n        timedOutRecord.writeStatus = \u0027SKIPPED\u0027;\n        timedOutRecord.readStatus = \u0027TIMEOUT\u0027;\n        timedOutRecord.readbackStatus = \u0027SKIPPED\u0027;\n    }\n\n    delete pending[requestId];\n    results.push(timedOutRecord);\n    timedOut.push(timedOutRecord);\n}\n\nif (timedOut.length === 0) {\n    return null;\n}\n\nflow.set(pendingKey, pending);\nflow.set(resultsKey, results);\n\nreturn [\n    timedOut.map(function (entry) { return { payload: entry }; }),\n    [{ payload: results }],\n    [{ payload: buildSummary() }],\n    timedOut.map(function (entry) {\n        return {\n            filename: flow.get(logPathKey),\n            payload: JSON.stringify(entry)\n        };\n    })\n];",
+        "outputs":  4,
+        "noerr":  0,
+        "initialize":  "",
+        "finalize":  "",
+        "libs":  [
+
+                 ],
+        "x":  380,
+        "y":  340,
+        "wires":  [
+                      [
+                          "debug-device-matrix-latest"
+                      ],
+                      [
+                          "debug-device-matrix-history"
+                      ],
+                      [
+                          "debug-device-matrix-summary"
+                      ],
+                      [
+                          "file-device-matrix-log"
+                      ]
+                  ]
+    },
+    {
+        "id":  "debug-device-matrix-summary",
+        "type":  "debug",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Run summary",
+        "active":  true,
+        "tosidebar":  true,
+        "console":  false,
+        "tostatus":  false,
+        "complete":  "payload",
+        "targetType":  "msg",
+        "x":  1290,
+        "y":  340,
+        "wires":  [
+
+                  ]
+    },
+    {
+        "id":  "file-device-matrix-log",
+        "type":  "file",
+        "z":  "tab-slmp-device-matrix",
+        "name":  "Append JSONL result log",
+        "filename":  "filename",
+        "filenameType":  "msg",
+        "appendNewline":  true,
+        "createDir":  true,
+        "overwriteFile":  "false",
+        "encoding":  "none",
+        "x":  1310,
+        "y":  400,
+        "wires":  [
+
+                  ]
+    }
+]

package/examples/flows/slmp-routing.json

@@ -0,0 +1,118 @@
+[
+  {
+    "id": "tab-slmp-routing",
+    "type": "tab",
+    "label": "SLMP Per Request Routing",
+    "disabled": false,
+    "info": "Update the host, port, and route object before deploy."
+  },
+  {
+    "id": "comment-slmp-routing",
+    "type": "comment",
+    "z": "tab-slmp-routing",
+    "name": "Read with msg-provided addresses and per-request route target",
+    "info": "",
+    "x": 300,
+    "y": 40,
+    "wires": []
+  },
+  {
+    "id": "inject-routing-read",
+    "type": "inject",
+    "z": "tab-slmp-routing",
+    "name": "Read with route override",
+    "props": [
+      {
+        "p": "lookup",
+        "v": "D300,4\nDSTR320,10",
+        "vt": "str"
+      },
+      {
+        "p": "target",
+        "v": "{\"network\":0,\"station\":255,\"moduleIO\":\"03FF\",\"multidrop\":0}",
+        "vt": "json"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": 0.1,
+    "topic": "",
+    "x": 140,
+    "y": 140,
+    "wires": [
+      [
+        "read-routing"
+      ]
+    ]
+  },
+  {
+    "id": "read-routing",
+    "type": "slmp-read",
+    "z": "tab-slmp-routing",
+    "name": "Read from msg.lookup + msg.target",
+    "connection": "cfg-slmp-routing",
+    "addresses": "lookup",
+    "addressesType": "msg",
+    "routeTarget": "",
+    "routeTargetType": "str",
+    "outputMode": "array",
+    "errorHandling": "output2",
+    "x": 430,
+    "y": 140,
+    "wires": [
+      [
+        "debug-routing-ok"
+      ],
+      [
+        "debug-routing-error"
+      ]
+    ]
+  },
+  {
+    "id": "debug-routing-ok",
+    "type": "debug",
+    "z": "tab-slmp-routing",
+    "name": "Read OK",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 690,
+    "y": 120,
+    "wires": []
+  },
+  {
+    "id": "debug-routing-error",
+    "type": "debug",
+    "z": "tab-slmp-routing",
+    "name": "Read Error",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 700,
+    "y": 160,
+    "wires": []
+  },
+  {
+    "id": "cfg-slmp-routing",
+    "type": "slmp-connection",
+    "name": "PLC TCP 4E",
+    "host": "192.168.250.100",
+    "port": "1025",
+    "transport": "tcp",
+    "timeout": "3000",
+    "plcSeries": "iqr",
+    "frameType": "4e",
+    "monitoringTimer": "16",
+    "network": "0",
+    "station": "255",
+    "moduleIO": "03FF",
+    "multidrop": "0"
+  }
+]