node-red-contrib-modbus-modpackqt 1.1.0 โ 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -12,14 +12,14 @@
|
|
|
12
12
|
|
|
13
13
|
[ModPackQT](https://modpackqt.com) is an industrial Modbus Master/Slave platform for engineers and technicians. It provides:
|
|
14
14
|
|
|
15
|
-
- **Modbus TCP and RTU** communication via a local gateway app
|
|
15
|
+
- **Modbus TCP and RTU** communication via a local gateway app
|
|
16
16
|
- **Built-in slave simulator** โ simulate a PLC register map without hardware
|
|
17
17
|
- **Real-time data visualization**, profile management, and AI-assisted setup
|
|
18
18
|
- A **REST API** that this Node-RED palette talks to
|
|
19
19
|
|
|
20
20
|
๐ [Download ModPackQT](https://modpackqt.com/download) ยท [Modbus Tutorial](https://modpackqt.com/resources/tutorial) ยท [Resources Hub](https://modpackqt.com/resources)
|
|
21
21
|
|
|
22
|
-
> **Requires the ModPackQT
|
|
22
|
+
> **Requires the ModPackQT Gateway app to be running locally.**
|
|
23
23
|
> The gateway is what the nodes talk to โ not the cloud server directly.
|
|
24
24
|
|
|
25
25
|
---
|
|
@@ -45,12 +45,9 @@ npm install node-red-contrib-modbus-modpackqt
|
|
|
45
45
|
|
|
46
46
|
## Prerequisites
|
|
47
47
|
|
|
48
|
-
1. **
|
|
49
|
-
|
|
50
|
-
node modsim.js
|
|
51
|
-
```
|
|
48
|
+
1. **Download and start the ModPackQT Gateway app:**
|
|
49
|
+
Download it from [modpackqt.com/download](https://modpackqt.com/download) and run it.
|
|
52
50
|
By default it listens on **port 8502** (`localhost:8502`).
|
|
53
|
-
Download `modsim.js` from the ModPackQT app or [modpackqt.com/download](https://modpackqt.com/download).
|
|
54
51
|
|
|
55
52
|
2. For slave nodes, create and start at least one slave in the ModPackQT app first.
|
|
56
53
|
|
|
@@ -70,7 +67,7 @@ npm install node-red-contrib-modbus-modpackqt
|
|
|
70
67
|
|
|
71
68
|
## Node-RED Modbus Master โ Read Registers (FC1/FC2/FC3/FC4)
|
|
72
69
|
|
|
73
|
-
The `modpackqt-read` node reads registers from **any Modbus TCP slave device** by routing the request through the ModPackQT
|
|
70
|
+
The `modpackqt-read` node reads registers from **any Modbus TCP slave device** by routing the request through the ModPackQT Gateway app.
|
|
74
71
|
|
|
75
72
|
**Supported function codes:**
|
|
76
73
|
- **FC1** โ Read Coils
|
|
@@ -82,7 +79,7 @@ The `modpackqt-read` node reads registers from **any Modbus TCP slave device** b
|
|
|
82
79
|
|
|
83
80
|
| Property | Description |
|
|
84
81
|
|---|---|
|
|
85
|
-
| Gateway | Config node pointing at your running
|
|
82
|
+
| Gateway | Config node pointing at your running ModPackQT Gateway app |
|
|
86
83
|
| Target Host | IP/hostname of the Modbus TCP slave to read from |
|
|
87
84
|
| Target Port | Port of the Modbus TCP slave (default: 502) |
|
|
88
85
|
| Unit ID | Modbus unit ID of the slave (1โ247) |
|
|
@@ -173,8 +170,8 @@ Add one `modpackqt-config` node per gateway instance. All other nodes reference
|
|
|
173
170
|
|
|
174
171
|
| Property | Default | Description |
|
|
175
172
|
|---|---|---|
|
|
176
|
-
| Host | `localhost` | Hostname or IP of the machine running
|
|
177
|
-
| Port | `8502` | Port that
|
|
173
|
+
| Host | `localhost` | Hostname or IP of the machine running the ModPackQT Gateway app |
|
|
174
|
+
| Port | `8502` | Port that the ModPackQT Gateway app listens on |
|
|
178
175
|
| API Key | _(empty)_ | Optional โ sent as `x-api-key` header if set |
|
|
179
176
|
|
|
180
177
|
---
|
|
@@ -194,7 +191,7 @@ Add one `modpackqt-config` node per gateway instance. All other nodes reference
|
|
|
194
191
|
|
|
195
192
|
| Issue | Solution |
|
|
196
193
|
|---|---|
|
|
197
|
-
| `connect ECONNREFUSED localhost:8502` | Make sure
|
|
194
|
+
| `connect ECONNREFUSED localhost:8502` | Make sure the ModPackQT Gateway app is running. Check host/port in the config node. |
|
|
198
195
|
| `404 Slave not found` | Check the Slave ID โ find it in the ModPackQT app under your slave's settings. |
|
|
199
196
|
| `Slave not running` (slave-write) | Start the slave in the ModPackQT app before writing. |
|
|
200
197
|
| `Cannot find module 'axios'` | Run `npm install` in `~/.node-red`. |
|
|
@@ -210,7 +207,7 @@ Add one `modpackqt-config` node per gateway instance. All other nodes reference
|
|
|
210
207
|
- [Free Modbus Tutorial](https://modpackqt.com/resources/tutorial)
|
|
211
208
|
- [Modbus Resources Hub](https://modpackqt.com/resources)
|
|
212
209
|
- [Node-RED Docs](https://nodered.org/docs/)
|
|
213
|
-
- [Report an Issue](https://
|
|
210
|
+
- [Contact / Report an Issue](https://modpackqt.com/contact)
|
|
214
211
|
|
|
215
212
|
---
|
|
216
213
|
|
package/examples/basic-flow.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"type": "tab",
|
|
5
5
|
"label": "ModPackQT Demo",
|
|
6
6
|
"disabled": false,
|
|
7
|
-
"info": "Demonstrates ModPackQT Node-RED nodes against the
|
|
7
|
+
"info": "Demonstrates ModPackQT Node-RED nodes against the ModPackQT Gateway app (default port 8502).\n\nBefore deploying:\n1. Download and start the ModPackQT Gateway app from modpackqt.com/download\n2. Update the config node if the gateway runs on a different host/port\n3. For slave-read/slave-write: update slaveId to match a slave ID from your ModPackQT app"
|
|
8
8
|
},
|
|
9
9
|
{
|
|
10
10
|
"id": "config-modpackqt-local",
|
|
@@ -68,7 +68,7 @@
|
|
|
68
68
|
</script>
|
|
69
69
|
|
|
70
70
|
<script type="text/html" data-help-name="modpackqt-read">
|
|
71
|
-
<p>Reads Modbus registers from a remote device via the ModPackQT
|
|
71
|
+
<p>Reads Modbus registers from a remote device via the ModPackQT Gateway app.</p>
|
|
72
72
|
<p>Calls <code>POST /api/modbus/tcp/read</code> on the gateway, which opens a Modbus TCP connection to the target device.</p>
|
|
73
73
|
<h3>Inputs</h3>
|
|
74
74
|
<dl class="message-properties">
|
|
@@ -83,7 +83,7 @@
|
|
|
83
83
|
<dd><code>modbus/read/{targetHost}:{targetPort}</code></dd>
|
|
84
84
|
</dl>
|
|
85
85
|
<h3>Details</h3>
|
|
86
|
-
<p><b>Gateway</b> โ host and port of the running
|
|
86
|
+
<p><b>Gateway</b> โ host and port of the running ModPackQT Gateway app (default: <code>localhost:8502</code>).</p>
|
|
87
87
|
<p><b>Target Host / Target Port</b> โ the actual Modbus TCP slave device to read from.</p>
|
|
88
88
|
<p>Set <b>Poll Interval</b> > 0 to continuously poll on a timer.</p>
|
|
89
89
|
</script>
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
</div>
|
|
33
33
|
<div class="form-row">
|
|
34
34
|
<label for="node-input-slaveId"><i class="fa fa-id-card"></i> Slave ID</label>
|
|
35
|
-
<input type="text" id="node-input-slaveId" placeholder="Slave ID from
|
|
35
|
+
<input type="text" id="node-input-slaveId" placeholder="Slave ID from ModPackQT app">
|
|
36
36
|
</div>
|
|
37
37
|
<div class="form-row">
|
|
38
38
|
<label for="node-input-registerType"><i class="fa fa-list"></i> Register Type</label>
|
|
@@ -58,7 +58,7 @@
|
|
|
58
58
|
</script>
|
|
59
59
|
|
|
60
60
|
<script type="text/html" data-help-name="modpackqt-slave-read">
|
|
61
|
-
<p>Reads registers from a ModPackQT simulated slave via the
|
|
61
|
+
<p>Reads registers from a ModPackQT simulated slave via the ModPackQT Gateway app.</p>
|
|
62
62
|
<p>Calls <code>GET /api/slaves/:id/registers</code> on the gateway.</p>
|
|
63
63
|
<h3>Inputs</h3>
|
|
64
64
|
<dl class="message-properties">
|
|
@@ -73,5 +73,5 @@
|
|
|
73
73
|
<dd><code>slave/{slaveId}/{registerType}/{address}</code></dd>
|
|
74
74
|
</dl>
|
|
75
75
|
<h3>Details</h3>
|
|
76
|
-
<p><b>Slave ID</b> โ the ID of the slave as configured in
|
|
76
|
+
<p><b>Slave ID</b> โ the ID of the slave as configured in the ModPackQT app. Find it in the app or via <code>GET /api/slaves</code>.</p>
|
|
77
77
|
</script>
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
</div>
|
|
31
31
|
<div class="form-row">
|
|
32
32
|
<label for="node-input-slaveId"><i class="fa fa-id-card"></i> Slave ID</label>
|
|
33
|
-
<input type="text" id="node-input-slaveId" placeholder="Slave ID from
|
|
33
|
+
<input type="text" id="node-input-slaveId" placeholder="Slave ID from ModPackQT app">
|
|
34
34
|
</div>
|
|
35
35
|
<div class="form-row">
|
|
36
36
|
<label for="node-input-registerType"><i class="fa fa-list"></i> Register Type</label>
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
</script>
|
|
49
49
|
|
|
50
50
|
<script type="text/html" data-help-name="modpackqt-slave-write">
|
|
51
|
-
<p>Writes values into a ModPackQT simulated slave register table via the
|
|
51
|
+
<p>Writes values into a ModPackQT simulated slave register table via the ModPackQT Gateway app.</p>
|
|
52
52
|
<p>Calls <code>PATCH /api/slaves/:id/registers</code> on the gateway. The slave must be running.</p>
|
|
53
53
|
<h3>Inputs</h3>
|
|
54
54
|
<dl class="message-properties">
|
|
@@ -61,5 +61,5 @@
|
|
|
61
61
|
<dd>Original message passed through with <code>msg.success = true</code>.</dd>
|
|
62
62
|
</dl>
|
|
63
63
|
<h3>Details</h3>
|
|
64
|
-
<p><b>Slave ID</b> โ the ID of the slave as configured in
|
|
64
|
+
<p><b>Slave ID</b> โ the ID of the slave as configured in the ModPackQT app. The slave must be started before writing.</p>
|
|
65
65
|
</script>
|
|
@@ -58,7 +58,7 @@
|
|
|
58
58
|
</script>
|
|
59
59
|
|
|
60
60
|
<script type="text/html" data-help-name="modpackqt-write">
|
|
61
|
-
<p>Writes Modbus registers to a remote device via the ModPackQT
|
|
61
|
+
<p>Writes Modbus registers to a remote device via the ModPackQT Gateway app.</p>
|
|
62
62
|
<p>Calls <code>POST /api/modbus/tcp/write</code> on the gateway.</p>
|
|
63
63
|
<h3>Inputs</h3>
|
|
64
64
|
<dl class="message-properties">
|
|
@@ -71,6 +71,6 @@
|
|
|
71
71
|
<dd>Original message is passed through with <code>msg.success = true</code> on success.</dd>
|
|
72
72
|
</dl>
|
|
73
73
|
<h3>Details</h3>
|
|
74
|
-
<p><b>Gateway</b> โ host and port of the running
|
|
74
|
+
<p><b>Gateway</b> โ host and port of the running ModPackQT Gateway app (default: <code>localhost:8502</code>).</p>
|
|
75
75
|
<p><b>Target Host / Target Port</b> โ the actual Modbus TCP slave device to write to.</p>
|
|
76
76
|
</script>
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "node-red-contrib-modbus-modpackqt",
|
|
3
|
-
"version": "1.1.
|
|
4
|
-
"description": "Node-RED nodes for ModPackQT โ read/write Modbus TCP registers (master & slave) via the ModPackQT
|
|
3
|
+
"version": "1.1.2",
|
|
4
|
+
"description": "Node-RED nodes for ModPackQT โ read/write Modbus TCP registers (master & slave) via the ModPackQT Gateway app. Supports FC1/FC2/FC3/FC4 reads and FC5/FC6/FC15/FC16 writes.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"node-red",
|
|
7
7
|
"modbus",
|
|
@@ -20,12 +20,8 @@
|
|
|
20
20
|
"license": "MIT",
|
|
21
21
|
"author": "ModPackQT",
|
|
22
22
|
"homepage": "https://modpackqt.com",
|
|
23
|
-
"repository": {
|
|
24
|
-
"type": "git",
|
|
25
|
-
"url": "https://github.com/jomer0411/Modsimcontrol.git"
|
|
26
|
-
},
|
|
27
23
|
"bugs": {
|
|
28
|
-
"url": "https://
|
|
24
|
+
"url": "https://modpackqt.com/contact"
|
|
29
25
|
},
|
|
30
26
|
"engines": {
|
|
31
27
|
"node": ">=14"
|