@tier0/node-red-contrib-opcda-client 1.0.33

Node-RED OPC DA Reading and Writing Node

npm install @tier0/node-red-contrib-opcda-client

@tier0/node-red-contrib-opcda-client

Node-RED nodes for browsing, reading, and writing data from classic OPC DA servers over DCOM.

This package supports OPC DA, not OPC UA. Before you begin, obtain the OPC server address, Windows/DCOM credentials, and CLSID.

Included nodes

Before you begin

• The Node-RED host or container can reach the OPC DA server.
• Remote DCOM access is enabled on the OPC DA server.
• TCP port 135 and the dynamic RPC ports used by the server are reachable.
• The Windows account has DCOM Launch, Activation, and Access permissions, as well as access to the OPC server.
• You know the CLSID of the target OPC DA server.

Installation

Online installation

Run the following command from the Node-RED user directory:

npm install @tier0/node-red-contrib-opcda-client

The Node-RED user directory is usually /data in Docker:

docker exec -it <node-red-container> sh
cd /data
npm install @tier0/node-red-contrib-opcda-client
exit
docker restart <node-red-container>

Offline Docker installation

The client .tgz contains all required runtime dependencies. Only this one file needs to be copied to an offline customer server.

docker cp tier0-node-red-contrib-opcda-client-1.0.33.tgz <node-red-container>:/data/
docker exec -it <node-red-container> sh
cd /data
npm install --offline --no-audit --no-fund ./tier0-node-red-contrib-opcda-client-1.0.33.tgz
exit
docker restart <node-red-container>

If online installation reports getaddrinfo EAI_AGAIN registry.npmjs.org, the container cannot reach the npm registry. Use the offline installation procedure instead.

Quick start

1. Add a tier0-opcda-read node to the flow.
2. Create a new tier0-opcda-server configuration.
3. Save and deploy the flow.
4. Open the server configuration and click Browse.
5. Click Export to download the item list.
6. Open the Read node and click Import to import the list.
7. Connect inject -> tier0-opcda-read -> debug.
8. Deploy again and wait for the Read node to show Ready.
9. Click Inject and inspect the result in the Debug sidebar.

[inject] -> [tier0-opcda-read] -> [debug / function / mqtt]

Server configuration

For a slow server or a large item list, start with a Timeout of 15000 or 20000 ms.

Browsing items

Open the tier0-opcda-server configuration:

1. Click Browse.
2. Wait for the number of discovered items to appear.
3. Click Export to download export.json.
4. Open the Read node and click Import to load the file.

Notes:

• Save and deploy the server configuration before the first Browse.
• Node-RED does not display a saved password again in the editor. This is expected.
• The same server configuration cannot run multiple Browse operations at the same time.
• When Node-RED permission control is enabled, the user needs the node-opc-da.list permission.

Read node

Settings

Cache Read

• Enabled: reads the current OPC server cache. This is usually faster and creates less load on field devices.
• Disabled: requests a Device read. Actual freshness depends on the OPC server and device communication state.

Triggering a read

Each input message triggers one read. The input payload is not used as a read parameter.

If the node is already Reading, another input message will not start a concurrent read.

Output

After a successful read, msg.payload is an array:

[
  {
    "itemID": "Channel1.Device1.Tag1",
    "errorCode": 0,
    "quality": "GOOD",
    "timestamp": "2026-08-05T08:00:00.000Z",
    "value": 123.45
  }
]

The current version only sends an output message when all returned values have GOOD quality. If the node shows Bad Quality, inspect the corresponding items in the OPC server.

Write node

Set msg.payload to a non-empty array of values to write:

[
  {
    "itemID": "Channel1.Device1.Setpoint",
    "type": "float",
    "value": 42.5
  },
  {
    "itemID": "Channel1.Device1.Enabled",
    "type": "boolean",
    "value": true
  }
]

Supported type values:

double, short, integer, float, byte, long, boolean,
uuid, string, char, date, currency, array

Output:

• Success: msg.payload is true.
• Failure: msg.payload is false.
• Input validation and server rejection errors may also include msg.error and msg.details.

Node status

Troubleshooting

The node shows Ready, but Inject produces no output

• Confirm that the Read node contains at least one item.
• Check whether the node changes to Bad Quality.
• Confirm that the previous read is not stuck in Reading.
• Connect a Debug node after the Read node.
• Add Catch and Status nodes to the flow.
• Inspect the Node-RED container log, not only the editor sidebar.

Browse reports an account, permission, or password error

• Save and deploy the Server configuration before browsing.
• Re-enter the username and password, then deploy again.
• Verify DCOM and OPC server permissions.
• Verify that the CLSID belongs to the target OPC DA server.
• Grant node-opc-da.list when Node-RED permission control is enabled.

HRESULT 0x1c00001b (469762075)

Check whether the OPC server has reached its client, Session, Group, COM object, memory, or handle limits. Also check whether other collectors are connected to the same server. The node displays Resource cooldown and automatically retries after the configured interval.

Received unexpected PDU from server, connection timeout, or connection closed

The node closes the affected connection and reconnects automatically. If the error occurs frequently, check:

• Whether other collectors are causing load fluctuations on the OPC server.
• OPC server and Windows DCOM logs.
• Firewall, NAT, and dynamic RPC port access.
• Whether Timeout is shorter than a complete read at the site.

Screenshots

Server

Read

Write

Changes

See CHANGELOG.md for implementation and compatibility changes.

License

Apache-2.0. This project is maintained from the original node-red-contrib-opcda-client project.