When configuring your devices, the OPC UA communication protocol is available.
1. Add an OPC UA Device
1.1. Add a Device
Access the box configuration web application, then go to the Data source menu :
Then, click on Add Device.
Select the "OpcUA" protocol.
OPC UA specificities for the server address :
The protocol used is opc.tcp
The address consists of the server's IP address or hostname, its port, and optionally a path
So you must enter in the field : serveropc:53530/OPCUA/SimulationServer
The various security modes are managed automatically.
1.2. Configuration Example
1.3. User Authentication Modes
1.3.1. Anonymous
Anonymous connection is allowed on the OPC UA server.
No additional configuration is required.
1.3.2. UserName
The username and password configured on the OPC UA server are required for the connection.
2. Certificate Management
In the OPC UA certificate management window, you will find the various server certificates as well as the client application certificate integrated into the Indabox.
To do so, go to the Data Source menu, then click on Manage OpcUA Certificates.
The following information is visible:
Certificate status:
own: client application certificate
rejected: rejected server certificate
trusted: authorized server certificate
Certificate name
Certificate details
Certificate validity start date
Certificate validity end date
2.1. Server Certificate
The server certificate can have two statuses : Rejected and Trusted.
2.1.1. Trust a server Certificate
The certificate with a rejected status appears with a red background color and a Rejected status.
To trust the certificate, click on the framed button below :
2.1.2. Reject a server Certificate
The certificate with a "trusted" status appears with a green background color and a Trusted status.
To reject the certificate, click on the button framed below :
2.2. Delete a Certificate
Click on the trash can icon of the server certificate to delete it.
Deleting the client application certificate (own status) allows the application to renew it.
3. OPC UA Server Namespace
When you first connect to the OPC UA server, the namespace file is generated.
It represents the data structure of the server.
Through this namespace, we can select multiple variables, export a complete equipment file for reimportation to configure a set of variables, add or edit a variable.
To access it, open the equipment editing page by clicking on Data Source then Edit device :
Next, click on the NameSpace button at the bottom right of the screen:
The namespace appears as follows (example) :
When variables are already configured in the selected equipment, they are checked in the tree view and visible in the table.
When hovering over a variable, a tooltip indicates its address, data type, and description if this information exists.
3.1. Search for Variables
It is possible to perform a search by entering a word in the dedicated area:
3.2. Refresh the Namespace
If the server structure has changed, it is possible to refresh the namespace in RevPi by clicking the Refresh Namespace button.
4. Variable Selection with the Namespace
4.1. Selecting a set of variables
Access the namespace screen as indicated previously (3. OPC UA Server Namespace).
Select one or more variables.
It is possible to select an entire node. To do this, expand the node by clicking on the small arrow :
Then click on the checkbox of the node.
All the visible variables within the node will be automatically selected.
All selected variables are visible in the table :
The last selected variable is on the first line of the table.
Click the Export device button.
The Excel file is exported. It is then possible to modify all the parameters, including variable names, before importation. The variable names are exported with their full path :
Note : To configure the device with the selected variables, return to the data source menu, then import the downloaded file.
4.2. Adding/Editing a Variable
Go to the device list (data source) and click on the button framed below to access the variable list.
4.2.1. Add a Variable
Click the Add a Variable button.
Click on the Select a Variable button.
Select a variable in the tree view by clicking on it. The variable is then visible in the table. To validate, click on the Validate Variable button.
The different fields are pre-filled. It is possible to modify them before validation.
By clicking on the Validate button, the variable is added to the equipment configuration.
4.2.2. Edit a Variable
Click on the edit button of the variable :
The variable settings will be manually editable.
Note : By clicking on the Select a Variable button, and selecting a variable in the server's namespace, you can automatically update the data type and address of a variable.
Click on the Update button to validate the changes.
5. Error Messages
5.1. Error establishing a connection: BadNotConnected
Incorrect server address.
5.2. Endpoint does not support the user identity type provided
Incorrect user configuration.
5.3. Certificate is not trusted
Server certificate rejected. It needs to be authorized: see 2.1.1. Authorize a Server Certificate.
5.4. Error establishing a connection: Error received from remote host: An error occurred verifying security
The Indabox certificate has not been approved on the OPC UA server. It must be authorized.
5.5. BadUserAccessDenied
Incorrect user authentication information.