Documentation Home Page HYPERSIM Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

OPC UA Server | Configuration

Accessing the I/O Interface Configuration

The OPC UA communication protocol can be configured in the I/O Interface Configuration tool that can be opened from the HYPERSIM ribbon.

For more information on the general use of the I/O Interface Configuration, see I/O Interface Configuration.

General Configuration

The section explains the generic configuration parameters of OPC UA Server driver

Network interfaceThe desired network interface name. The proper interface name should be selected based on the information given by the Linux command "ifconfig". By default, this parameter is configured with "eth0".
Use an RT core for asynchronous computation
  • If set to true, the driver reserves a real-time CPU core for its communication system and can handle a bigger amount of data.
  • If set to false, the communication system defaults to core 0.
TCP portSelect the TCP port on which the OPC UA Server will listen for an OPC UA client to connect and communicate with.
VerboseIf enabled, additional information is displayed while the model is loading.
Advanced optionsIf enabled, advanced configuration options of the OPC UA server is displayed.
Use external synchronizationIf enabled, two data points are provided to provide an external timestamp source for the simulation.
Enable virtual modeIn virtual mode, the model can be executed even if this I/O interface is not compatible with the hardware configuration of the system. The connections between the model and the I/O interface will be done during the initialization, but the I/O interface will not do anything.
The virtual mode can be used to troubleshoot problems on a system without having the required hardware, or to prepare a model with different I/O interfaces even if the final hardware platform is not available.

Server Configuration

The configuration parameters of the OPC UA Server are configured with default values. The server has configurations such as network interface and TCP port number, which are configured in the general section page and need to be specified by the user.

The server has more advanced configurations parameters that are not displayed by default. However, the user can modify these parameters after enabling the advanced option.

Advanced configuration options for OPC UA Server include the following. 

TCP binaryConfigures the TCP connection parameters such as message size, number of connections, and connection timeout.
Secure conversation
Configures the secure channel layer such as the number of revised channels and the maximum number of secure channels used in the OPC UA Server architecture.
SecurityConfigures the end security policy options utilized in the OPC UA Server architecture.
ServicesConfigures the session (used between server and client) parameters such as maximum no of sessions, session timeout, and queue size, etc.
Address space and profilesConfigures user-defined objects represented between server and client.
Server capabilitiesConfigures the server capabilities in terms of defining the number of browse contents, array length of point setup and length of the string, etc
Operation limitsConfigures the nodes implemented between the server and the client. It defines various parameters of the node architecture such as the maximum number of nodes per read and write, the maximum number of nodes per method call and the maximum number of monitored per item, etc.
InternalsConfigures the internal parameters such as buffer size, number of buckets for address space hash table, etc.
DiagnosticsConfigures the diagnostics options such as enabling info and error log
IntervalsIntervals contain an array of predefined cyclic rates that the server can implement very efficiently for sampling and reporting data changes. All intervals must be a multiple of the server cyclic rates. Minimum intervals should be less than or equal to index 0 of the intervals array. Maximum intervals should be greater than or equal to the last entry of the intervals array. CyclicRateMs is the cyclic rate at which the server executes and the rate at which the server is polled by the application. The default value is 100 ms. It is not recommended to increase the rate beyond 50 ms without very careful testing.

Points Setup Data Configuration

The data points to be monitored and controlled by the user are configured in the Points setup section. Each data point has the following configurable parameters

NameName of the data point
TypeData type of data point. The supported data types of this driver are displayed below in a table.
DirectionData communication direction.  It could either be "Server to client" or "Client to server"
Array LengthLength of the data, if it is '1' then its a single data point or else the data point is a vector of a specified length
PathFolder tree of the data. All the folders will be displayed in the OPC UA client, and different points can be added to the same folder.
Enable quality controlIf set, then quality control of the data point is enabled for monitoring with a separate connection point
Initial value(s)Initial value(s) of the data point which communicates in this direction "Client to server". It will define the value applied to the data point before the client decides to write something in it


The following snapshot shows the points setup data configuration of the OPC UA Server example model. It has several data points configured in both directions. Scalar and array data points with some quality control monitoring

enabled are also included.

The table below describes the different data types that can be used in the 'type' field of a point:

TypeDescription/range
booleanBoolean value. 0 or 1
int8Signed 8-bits integer (-128 to 127)
uint8Unsigned 8-bits integer (0 to 255)
int16Signed 16-bits integer (-32,768 to 32,767)
uint16Unsigned 16-bits integer (0 to 65,535)
int32Signed 32-bits integer (-2,147,483,648 to 2,147,483,647)
uint32Unsigned 32-bits integer (0 to 4,294,967,295)
int64Signed 64-bits integer (-(263) to 263 -1)
uint64Unsigned 64-bits integer (0 to 264 -1)
floatSingle precision floating point integer (3.4E +/- 38)
doubleDouble precision floating point integer (1.7E +/- 308)

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323