Use the OPC UA client
Use the OPC UA client to browse an OPC UA server, view the values, and add nodes as data points in Evolo.
Written By Evolo Support
Last updated 9 days ago
With the OPC UA client, you can browse an OPC UA server through the gateway, view the values, and add nodes (the variables on the server) as data points in Evolo.
Open the OPC UA client
Open the gateway
Go to Configuration → Gateway and click on the gateway.
Select the tab
Select the OPC UA Client tab.
You can also access this page by selecting Open in OPC UA Client on an OPC UA interface, or by selecting View in OPC UA Client from the menu on a data point.
Select a server
Under Servers, the OPC UA interfaces on the gateway are listed in the In Evolo group. Click on a server to open it.
For a server that hasn’t been set up in Evolo yet:
Enter the address
Click Connect to Server and enter the IP address, Port, and Path, for example /UA/Server.
Select an endpoint
Click Settings and Get Endpoints, then select an Endpoint. If the server requires a login, enter the Username and Password. Leaving the username blank allows for anonymous login.
Connect
Click "Connect." The server is now listed under "Manual." Click Add to assign it a device and an interface in Evolo.
Add data points
Select a folder
Select a folder in the tree. The table displays the variables with Value, Data Type, Access, and whether they are already in Evolo. Use Filter Variables and Number, Boolean, and Enum to narrow down the selection.
Select the variables
Select the variables you want as data points. Only numbers, Boolean values, and enums can be added. An array of numbers gets one row per element.
Select prefix and logging
A prefix (optional) is placed directly before the name, for example, 360.001_. Check Log values and select an Interval to start logging immediately.
Add to Evolo
Click “Add to Evolo,” review the data points, and click “Add.”
Name, description, unit, data type, and status texts are retrieved from the server. The node ID is stored with the namespace URI (nsu=), so the data point will work even if the server changes the order of the namespaces. If the server is not in Evolo, it must be added first.
View and Change a Value
Click a variable to view its value, status, source time, and all attributes. Read Again re-reads the value, and Change Value writes a new value to the server. If the server rejects the write, you’ll see the status code.
The Server
When no variable is selected, the panel on the right displays the server’s status, product, version, clock, endpoint, and certificates.
Clock: If the server’s clock is off by more than one minute, you’ll receive a warning. The timestamps the server applies to the values will then be incorrect.
Capacity: If the server allows more nodes per request than the interface uses, click Use N on the interface for faster reading.
Gateway certificate: For “Sign” or “Sign & Encrypt,” click Download Gateway Certificate and add it as a trusted certificate on the server.
Lock the server certificate
Enable Lock Server Certificate on the OPC UA interface to prevent the server from changing its certificate without your knowledge. The gateway will then only connect using the accepted certificate. If the server changes its certificate, a communication alert will appear with the text “Server certificate changed,” and the gateway will not connect until you click Accept new certificate on the interface or in the client.
The Status tab in the overview shows servers with new certificates and locked certificates that expire within 30 days.
Sync the Entire Server
For a server in Evolo, Sync Entire Server compares the data points with what the server reports about the nodes. Select which fields to compare, check the changes you want, and click “Apply.” Name is unchecked by default. Nothing is deleted.
The dialog also displays data points that no longer exist on the server, as well as variables with numeric or Boolean values that have not been added to Evolo.
Download Excel
Download Excel exports the variables in This Folder or "Entire Server." For a server in Evolo, the file can be imported under Configuration → Data Points → Excel Import → OPC UA.
Troubleshooting
The client cannot connect to the server
The client cannot connect to the server
Probable cause:
Incorrect path, or an endpoint the server does not offer.
Solution:
Click Settings and Retrieve Endpoints, then select an endpoint from the list. If using Sign or Sign & Encrypt, the gateway’s certificate must be added as trusted on the server.
The gateway does not connect after a certificate change
The gateway does not connect after a certificate change
Probable cause:
The certificate is locked, and the server has received a new one.
Solution:
Verify that the change is expected—for example, that the certificate has been renewed on the device. Then click Accept New Certificate.
Missing value
Missing value
Likely cause:
The node is read-only for the user the gateway logs in with. The client then displays “Read-only for the gateway user.”
Solution:
Grant the user write access to the server, or log in with a different user.
The entire server cannot be exported
The entire server cannot be exported
Likely cause:
The server has over 1,500 variables, or is responding too slowly.
Solution:
Export using “This Folder,” folder by folder.
Was this helpful?
More in Gateway
Add Evolo GatewayNetwork Requirements for the Evolo GatewaySet up Gateway on Balena OSSet Up Gateway on LinuxStill need help? Ask the team