OPC UA Route

OPC UA Overview

The OPCUA route enables communication with OPC UA servers, providing a standardized, cross-platform protocol for industrial automation. It supports multiple authentication modes, security policies, and both NodeId and BrowsePath addressing.

OPC UA is vendor-neutral and widely supported by modern industrial equipment. Use it when you need secure, standardized communication across different manufacturer’s devices.

Basic Syntax

DEFINE ROUTE OPCServer WITH TYPE OPCUA
    ADD OPCUA_CONFIG
        WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
        WITH AUTH_MODE '0'
        WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"
    ADD MAPPING ProcessData
        WITH EVERY 1 SECOND
        ADD TAG Temperature
            WITH ADDRESS "ns=2;s=Channel1.Device1.Temperature"
            WITH DATA_TYPE "FLOAT"
            WITH SOURCE_TOPIC "opcua/temperature"

Connection Configuration

OPCUA_CONFIG Parameters

ENDPOINT_URL

string

required

OPC UA server endpoint URL (e.g., opc.tcp://localhost:4840).

AUTH_MODE

integer

Authentication mode:

0 - Anonymous (no authentication)
1 - Username/Password
2 - Certificate

Default: 0.

USER

string

Username for authentication (required if AUTH_MODE is 1).

PASSWORD

string

Password for authentication (required if AUTH_MODE is 1).

USE_SECURITY

boolean

Enable security mode. Default: false.

SECURITY_POLICY

integer

Security policy level:

0 - None
1 - Basic128Rsa15
2 - Basic256
3 - Basic256Sha256
4 - Aes128_Sha256_RsaOaep
5 - Aes256_Sha256_RsaPss

Default: 0.

MESSAGE_SECURITY

integer

Message security mode:

0 - None
1 - Sign
2 - SignAndEncrypt

Default: 0.

AUTO_ACCEPT_UNTRUSTED_CERTIFICATES

boolean

Automatically accept untrusted server certificates. Default: false.

SUPPRESS_NONCE_VALIDATION_ERRORS

boolean

Suppress nonce validation errors. Default: false.

TIMEOUT

integer

Connection timeout in milliseconds. Default: 90000.

BrowsePath Mode

For servers that support it, you can use symbolic paths instead of NodeIds:

USE_BROWSE_PATH

boolean

Enable BrowsePath mode - treat all TAG addresses as browse paths instead of NodeIds.

BROWSE_ROOT_PATH

string

Root path for browsing when USE_BROWSE_PATH is enabled. Default: Objects.

BrowsePath Example

ADD OPCUA_CONFIG
    WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
    WITH USE_BROWSE_PATH "true"
    WITH BROWSE_ROOT_PATH "Objects"
ADD MAPPING Tags
    WITH EVERY 1 SECOND
    ADD TAG Temperature
        WITH ADDRESS "Aliases/MyDevice/Temperature"
        WITH DATA_TYPE "FLOAT"
        WITH SOURCE_TOPIC "opcua/temperature"

Security Configuration

Anonymous (No Security)
Username/Password
Certificate Authentication

For development or trusted networks:

ADD OPCUA_CONFIG
    WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
    WITH AUTH_MODE '0'
    WITH USE_SECURITY "false"
    WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"

Basic authentication:

ADD OPCUA_CONFIG
    WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
    WITH AUTH_MODE '1'
    WITH USER "opcuser"
    WITH PASSWORD "secure_password"
    WITH USE_SECURITY "true"
    WITH SECURITY_POLICY '3'
    WITH MESSAGE_SECURITY '2'

For high-security environments:

ADD OPCUA_CONFIG
    WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
    WITH AUTH_MODE '2'
    WITH USE_SECURITY "true"
    WITH SECURITY_POLICY '5'
    WITH MESSAGE_SECURITY '2'

Certificate-based authentication requires proper PKI setup. Consult your OPC UA server documentation for certificate configuration.

NodeId Addressing

OPC UA uses NodeIds to identify variables. The format is: ns=<namespace>;s=<identifier> or ns=<namespace>;i=<numeric_id>

Format	Example	Description
String identifier	`ns=2;s=Channel1.Device1.Tag1`	Most common, human-readable
Numeric identifier	`ns=2;i=1234`	More efficient, used by some servers
GUID identifier	`ns=2;g=12345678-1234-1234-1234-123456789012`	Globally unique identifiers

Finding NodeIds

Use an OPC UA browser tool (like UaExpert, Prosys OPC UA Browser, or similar) to explore the server’s address space and find the correct NodeIds.

Data Types

Data Type	OPC UA Type	Description
`BOOLEAN`	Boolean	True/False value
`SBYTE`	SByte	Signed 8-bit integer
`BYTE`	Byte	Unsigned 8-bit integer
`INT16`	Int16	Signed 16-bit integer
`UINT16`	UInt16	Unsigned 16-bit integer
`INT32`	Int32	Signed 32-bit integer
`UINT32`	UInt32	Unsigned 32-bit integer
`INT64`	Int64	Signed 64-bit integer
`UINT64`	UInt64	Unsigned 64-bit integer
`FLOAT` / `FLOAT32`	Float	32-bit floating point
`DOUBLE` / `FLOAT64`	Double	64-bit floating point
`STRING`	String	Unicode string

TAG Configuration

Complete TAG Example

ADD TAG ProcessTemperature
    WITH ADDRESS "ns=2;s=Process.Temperature"
    WITH DATA_TYPE "FLOAT"
    WITH SOURCE_TOPIC "opcua/process/temperature"
    WITH SCALING "1"
    WITH OFFSET "0"
    WITH UNIT "°C"
    WITH DECIMAL_PLACES "2"
    WITH MIN_VALUE "-50"
    WITH MAX_VALUE "500"
    WITH DEADBAND "0.5"
    WITH PUBLISH_MODE "JSON"
    WITH WRITABLE "true"
    WITH DESTINATION_TOPIC "opcua/process/temperature/set"
    WITH IS_ARRAY "false"
    WITH DESCRIPTION "Main process temperature sensor"

TAG Parameters

Address Configuration

ADDRESS

string

required

OPC UA NodeId (e.g., ns=2;s=MyVariable or ns=2;i=1234) or BrowsePath if USE_BROWSE_PATH is enabled.

DATA_TYPE

string

required

OPC UA data type: BOOLEAN, BYTE, INT16, UINT16, INT32, UINT32, INT64, UINT64, FLOAT, DOUBLE, STRING.

IS_ARRAY

boolean

Indicates if the value is an array. Default: false.

Value Transformation

SCALING

double

Multiplier for value transformation. Default: 1.0.

OFFSET

double

Offset added after scaling. Default: 0.0.

DECIMAL_PLACES

integer

Decimal places in output. Default: 2.

Filtering

MIN_VALUE

double

Minimum allowed value.

MAX_VALUE

double

Maximum allowed value.

DEADBAND

double

Minimum change to trigger publish. Default: 0.0.

Publishing

SOURCE_TOPIC

string

MQTT topic for read values.

PUBLISH_MODE

string

Output format: VALUE_ONLY or JSON. Default: VALUE_ONLY.

UNIT

string

Engineering unit for documentation.

DESCRIPTION

string

Human-readable description.

Write Configuration

WRITABLE

boolean

Allow writing to this node. Default: false.

DESTINATION_TOPIC

string

MQTT topic for write commands.

Event-Based Operations

For on-demand read/write operations:

ADD EVENT ReadOnDemand
    WITH SOURCE_TOPIC "opcua/commands/read"
    WITH DESTINATION_TOPIC "opcua/responses/read"
    WITH QUERY '{"operation": "READ", "node_id": "ns=2;i=2", "data_type": "INT32"}'

Complete Examples

Basic Connection
Secure Connection
BrowsePath Mode
Array Values
Kepware Connection

Simple OPC UA connection with anonymous access:

DEFINE ROUTE OPCServer WITH TYPE OPCUA
    ADD OPCUA_CONFIG
        WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
        WITH AUTH_MODE '0'
        WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"
    ADD MAPPING ProcessData
        WITH EVERY 1 SECOND
        ADD TAG Temperature
            WITH ADDRESS "ns=2;s=Channel1.Device1.Temperature"
            WITH DATA_TYPE "FLOAT"
            WITH SOURCE_TOPIC "opcua/temperature"
            WITH UNIT "°C"
        ADD TAG Pressure
            WITH ADDRESS "ns=2;s=Channel1.Device1.Pressure"
            WITH DATA_TYPE "FLOAT"
            WITH SOURCE_TOPIC "opcua/pressure"
            WITH UNIT "bar"
        ADD TAG Status
            WITH ADDRESS "ns=2;s=Channel1.Device1.Status"
            WITH DATA_TYPE "INT32"
            WITH SOURCE_TOPIC "opcua/status"

Production setup with encryption:

DEFINE ROUTE SecureOPC WITH TYPE OPCUA
    ADD OPCUA_CONFIG
        WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
        WITH AUTH_MODE '1'
        WITH USER "operator"
        WITH PASSWORD "secure_password_here"
        WITH USE_SECURITY "true"
        WITH SECURITY_POLICY '3'
        WITH MESSAGE_SECURITY '2'
        WITH TIMEOUT '30000'
    ADD MAPPING SecureData
        WITH EVERY 500 MILLISECONDS
        ADD TAG CriticalValue
            WITH ADDRESS "ns=2;s=Safety.CriticalValue"
            WITH DATA_TYPE "FLOAT"
            WITH SOURCE_TOPIC "secure/critical"
            WITH PUBLISH_MODE "JSON"

Using symbolic paths:

DEFINE ROUTE BrowsePathOPC WITH TYPE OPCUA
    ADD OPCUA_CONFIG
        WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
        WITH AUTH_MODE '0'
        WITH USE_BROWSE_PATH "true"
        WITH BROWSE_ROOT_PATH "Objects"
        WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"
    ADD MAPPING ProcessTags
        WITH EVERY 1 SECOND
        ADD TAG Temperature
            WITH ADDRESS "DataAccess/AnalogItems/Temperature"
            WITH DATA_TYPE "DOUBLE"
            WITH SOURCE_TOPIC "opcua/temperature"
        ADD TAG Setpoint
            WITH ADDRESS "DataAccess/AnalogItems/Setpoint"
            WITH DATA_TYPE "DOUBLE"
            WITH SOURCE_TOPIC "opcua/setpoint"
            WITH WRITABLE "true"
            WITH DESTINATION_TOPIC "opcua/setpoint/write"

Reading array data:

DEFINE ROUTE ArrayOPC WITH TYPE OPCUA
    ADD OPCUA_CONFIG
        WITH ENDPOINT_URL "opc.tcp://192.168.1.100:4840"
        WITH AUTH_MODE '0'
        WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"
    ADD MAPPING ArrayData
        WITH EVERY 1 SECOND
        ADD TAG TemperatureArray
            WITH ADDRESS "ns=2;s=Process.TemperatureArray"
            WITH DATA_TYPE "FLOAT"
            WITH IS_ARRAY "true"
            WITH SOURCE_TOPIC "opcua/temperatures"
            WITH PUBLISH_MODE "JSON"
        ADD TAG StatusBits
            WITH ADDRESS "ns=2;s=Process.StatusBits"
            WITH DATA_TYPE "BOOLEAN"
            WITH IS_ARRAY "true"
            WITH SOURCE_TOPIC "opcua/status/bits"

Connecting to Kepware OPC UA server:

DEFINE ROUTE KepwareServer WITH TYPE OPCUA
    ADD OPCUA_CONFIG
        WITH ENDPOINT_URL "opc.tcp://192.168.1.50:49320"
        WITH AUTH_MODE '0'
        WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"
    ADD MAPPING KepwareTags
        WITH EVERY 500 MILLISECONDS
        ADD TAG Motor1Speed
            WITH ADDRESS "ns=2;s=Channel1.Device1.Motor1_Speed"
            WITH DATA_TYPE "FLOAT"
            WITH SOURCE_TOPIC "kepware/motor1/speed"
            WITH UNIT "RPM"
        ADD TAG Motor1Current
            WITH ADDRESS "ns=2;s=Channel1.Device1.Motor1_Current"
            WITH DATA_TYPE "FLOAT"
            WITH SOURCE_TOPIC "kepware/motor1/current"
            WITH UNIT "A"
        ADD TAG Motor1Running
            WITH ADDRESS "ns=2;s=Channel1.Device1.Motor1_Running"
            WITH DATA_TYPE "BOOLEAN"
            WITH SOURCE_TOPIC "kepware/motor1/running"

Security Best Practices

Use Encryption in Production

Always enable security for production deployments:

WITH USE_SECURITY "true"
WITH SECURITY_POLICY '3'  // Basic256Sha256
WITH MESSAGE_SECURITY '2'  // SignAndEncrypt

Don't Auto-Accept Certificates

In production, properly configure certificate trust:

WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "false"

Instead, exchange certificates between client and server during commissioning.

Use Strong Authentication

Prefer username/password or certificate authentication over anonymous:

WITH AUTH_MODE '1'  // or '2' for certificate
WITH USER "operator"
WITH PASSWORD "strong_password_here"

Troubleshooting

Connection Timeout

Verify endpoint URL is correct
Check firewall allows TCP port (usually 4840)
Ensure server is running and accessible
Try increasing TIMEOUT value

Security Rejection

Verify security policy matches server configuration
Check certificate trust (may need to accept in server)
For testing, try WITH AUTO_ACCEPT_UNTRUSTED_CERTIFICATES "true"
Ensure client certificates are properly configured

NodeId Not Found

Use OPC UA browser to verify correct NodeId
Check namespace index (ns=) is correct
Verify node exists in server’s address space
Try BrowsePath mode if NodeId is unclear

Authentication Failed

Verify username and password
Check user has appropriate permissions
Ensure AUTH_MODE matches server requirements

Incorrect Values

Verify DATA_TYPE matches server variable type
Check IS_ARRAY setting for array values
Verify SCALING and OFFSET calculations

Next Steps

Siemens S7

Direct connection to Siemens PLCs.

ADS (Beckhoff)

Connect to TwinCAT systems.

Quick Start

MQTT Broker

LoT Language

LoT Notebooks

Actions

Routes

Models

Rules

OPC UA Overview

Basic Syntax

Connection Configuration

OPCUA_CONFIG Parameters

BrowsePath Mode

BrowsePath Example

Security Configuration

NodeId Addressing

Finding NodeIds

Data Types

TAG Configuration

Complete TAG Example

TAG Parameters

Event-Based Operations

Complete Examples

Security Best Practices

Troubleshooting

Next Steps

Siemens S7

ADS (Beckhoff)

Quick Start

MQTT Broker

LoT Language

LoT Notebooks

Actions

Routes

Models

Rules

​OPC UA Overview

​Basic Syntax

​Connection Configuration

​OPCUA_CONFIG Parameters

​BrowsePath Mode

​BrowsePath Example

​Security Configuration

​NodeId Addressing

​Finding NodeIds

​Data Types

​TAG Configuration

​Complete TAG Example

​TAG Parameters

​Event-Based Operations

​Complete Examples

​Security Best Practices

​Troubleshooting

​Next Steps

Siemens S7

ADS (Beckhoff)

OPC UA Overview

Basic Syntax

Connection Configuration

OPCUA_CONFIG Parameters

BrowsePath Mode

BrowsePath Example

Security Configuration

NodeId Addressing

Finding NodeIds

Data Types

TAG Configuration

Complete TAG Example

TAG Parameters

Event-Based Operations

Complete Examples

Security Best Practices

Troubleshooting

Next Steps