Wiki mirrorView source
The information in this page is updated in accordance with firmware version RUTX_R_00.07.22.1.
OPC UA Client
OPC Unified Architecture (OPC UA) is a cross-platform, open-source, IEC62541 standard for data exchange from sensors to cloud applications developed by the OPC Foundation. The UA in OPC UA stands for “Unified Architecture” and refers to the latest specification of the standard. It differs from its predecessor in that it is platform-independent, moving away from COM/DCOM to purely binary TCP/IP or alternatively SOAP.
This manual page provides an overview of the OPC UA Client functionality in RUTX11 devices.
Note: OPC UA Client is additional software that can be installed from the System → Package Manager page.
General status
This section displays OPC UA Client general status information.
OPC UA Servers
The OPC Server is the basis of OPC communication. It is a software that implements the OPC standard and thus provides the standardized OPC interfaces to the outside world.
Notice the Global section config. It is used to outright turn the service off or on if any active configurations are present.
Clicking the Cog icon opens a modal window. The global configuration slider can be set and it's state saved.
To add a new server, enter an instance name and click the 'Add' button.
Note: A maximum of 10 servers is allowed.
After clicking 'Add' you will be redirected to the newly added server's configuration page.
OPC UA Server Configuration
The OPC UA Server Configuration section is used to configure the parameters of an OPC UA Server.
| Field | Value | Description |
|---|---|---|
| Enable | off | on; default: off | Enables specific OPC UA server instance. |
| Name | string; default: none | Name of the server, used for management purposes only. |
| URL | url; default: none | Specifies OPC UA endpoint URL. |
| Timeout | integer [10..3600000]; default: 5000 | Specifies server timeout in ms. |
| Identity | Anonymous | Credentials ; default: Anonymous | Specifies client identity. |
| Username | string ; default: empty | Specifies client username. |
| Password | string; default: empty | Specifies client password. |
| Security mode | None | Sign | Sign & encrypt; default: None | OPC UA security mode. |
| Application URI | string; default: empty | Should match SubjectAlternativeName in client certificate. |
| Certificate | .ca file; default: none | Client certificate. |
| Key | .key file; default: none | Client key. |
| TCL | file; default: none | Trusted certificate list. A TCL is a list of hashes of certificates or a list of file names. |
OPC UA Server Nodes
A node is the basic unit of data in the OPC UA address space, which provides a standard way for OPC UA servers to represent objects to OPC UA clients. Nodes are pieces of information (for example, a unique temperature) and consist of attributes, the actual data value, and one or more references to other nodes, each in its own address space. A unique temperature will therefore take up multiple addresses in an address space.
By default, there are no nodes configured. To add a new server node, enter an instance name and click the 'Add' button.
Note: A maximum of 50 nodes per server are allowed.
After clicking 'Add' you will be redirected to the newly added server node's configuration page.
OPC UA Server Node Configuration
The OPC UA Server node Configuration section is used to configure the parameters of an OPC UA Server Node.
| Field | Value | Description |
|---|---|---|
| Name | string; default: none | Name of the node instance, used for management purposes only. |
| ID namespace | integer [0..65535]; default: none | Specifies node ID namespace. |
| ID type | Numeric | String | GUID | Bytestring; default: Numeric | Specifies node ID type. |
| ID | dynamic; default: none | Specifies node ID (validation varies depending on ID type). |
OPC UA Value Groups
A Value Group is a collection of different specific group values. Each value configured under this group will be returned inside the same group array.
By default, there are no value groups configured. To add a new group, enter an instance name and click the 'Add' button.
Note: A maximum of 20 value groups are allowed.
After clicking 'Add' you will be redirected to the newly added value group's configuration page.
OPC UA Value Group Configuration
The OPC UA Value Group Configuration section is used to configure the parameters of an OPC UA Value Group.
| Field | Value | Description |
|---|---|---|
| Enable | off | on; default: off | Enables specific OPC UA value group instance. |
| Name | string; default: none | Name of the value group instance, used for management purposes only. |
| Scheduling type | Period; default: Period | Specifies method of scheduling data retrievals. |
| Period | integer [1..86400]; default: none | Specifies time duration between data retrievals in seconds. |
| Failure mode | None | Any | All; default: None | When to consider retrieval a failure. |
| Failure storage | off | on; default: off | Whether to store results of a failure. |
| Failure replacement | string; default: none | Results of a failure will be replaced by this string |
| Prefix | string; default: none | String going before all the values. |
| Midfix | string; default: none | String going between all the values. |
| Postfix | string; default: none | String going after all the values. |
OPC UA Group Values
A Group Value is a specific value retrieved from a defined server node.
By default, there are no group values configured. To add a new value, enter an instance name and click the 'Add' button.
Note: A maximum of 50 values per value group is allowed.
After clicking 'Add' you will be redirected to the newly added group value's configuration page.
OPC UA Group Value Configuration
The OPC UA Group Value Configuration section is used to configure the parameters of an OPC UA Group Value.
| Field | Value | Description |
|---|---|---|
| Enable | off | on; default: off | Enables specific OPC UA value instance. |
| Name | string; default: none | Name of the group value instance, used for management purposes only. |
| Prefix | string; default: none | String before the value. |
| Postfix | string; default: none | String after the value. |
| Replacement | string; default: none | String to replace everything in case of failure. |
| Server to retrieve data from | OPC UA server instance; default: none | Specifies which server to retrieve data from. |
| Server node | OPC UA server node instance; default: none | Specifies which server node to retrieve data from. |
OPC UA Server
This manual page provides an overview of the OPC UA Server in RUTX11 devices.
Note: OPC UA Server is additional software that can be installed from the System → Package Manager page.
Status
This section displays OPC UA Server status information.
OPC UA Server Configuration
The OPC UA Server Configuration section is used to enable the local OPC UA server.
| Field | Value | Description |
|---|---|---|
| Enable | off | on; default: off | Enables OPC UA server. |
| Port | integer [1..65535]; default: none | Service port. |
OPC UA Server variables
All RUTOS device variables are described in the table below:
Note: All the variables have these qualities in common:
- Namespace index is 1
- Node ID type is string
- Read-only
- Updated upon request
| ID | Type | Description |
|---|---|---|
| sys_uptime | UINT32 | System uptime in seconds. |
| sys_serial | String | Device serial number. |
| sys_devname | String | Device name. |
| sys_devcode | String | Device code. |
| sys_version | String | Firmware version. |
| sys_hostname | String | Hostname. |
| lan_mac | String | LAN MAC address. |
| lan_ip | String | IP address of LAN interface. |
| lan_mask | String | Subnet mask of LAN interface. |
| lan_gateway | String | Gateway IP address of LAN interface. |
| lan_dns | Array of String | IP addresses of LAN interface DNS servers. |
| rut_wan_ip | String | IP address if WAN is connected. |
| rut_wan_type | String | Values of WAN type. |
| io_din | Array of BOOL | Values of digital input pins. |
| io_dout | Array of BOOL | Values of digital output pins. |
| gps_fix_status | UINT32 | Whether a GPS connection has been acquired. |
| gps_timestamp | UINT64 | UTC timestamp. |
| gps_longitude | DOUBLE | Longitude. |
| gps_latitude | DOUBLE | Latitude. |
| gps_altitude | DOUBLE | Altitude. |
| gps_angle | DOUBLE | Angle. |
| gps_speed | DOUBLE | Speed. |
| gps_accuracy | DOUBLE | Accuracy. |
| gps_sat_count | UINT32 | Satellite count. |
| mob_modem_count | UINT32 | Modem count. |
| mob_modem_imei | Array of String | Modem IMEI. |
| mob_modem_serial | Array of String | Modem serial number. |
| mob_modem_mnf | Array of String | Modem manufacturer name. |
| mob_modem_model | Array of String | Modem model name. |
| mob_modem_fw | Array of String | Modem firmware version string. |
| mob_modem_temp | Array of FLOAT | Modem temperature. |
| mob_sim_count | Array of UINT32 | SIM count. |
| mob_sim | Array of UINT32 | Selected SIM. |
| mob_sim_state | Array of String | SIM state. |
| mob_sim_iccid | Array of String | SIM ICCID. |
| mob_rssi | Array of INT32 | RSSI. |
| mob_conn_type | Array of String | Data carrier type. |
| mob_conn_state | Array of String | Connection state. |
| mob_net_state | Array of String | Network link state. |
| mob_operator | Array of String | Operator name. |
Data Sources
Data sources transmit data from one or more data sources (Modbus cliet and etc..) and write it to OPC UA nodes.
To add new nodes, press `Add` button:
Node configuration:
| Field | Value | Description |
|---|---|---|
| Enable | off | on; default: off | Turns server node configuration on or off. |
| Name | string; default: none | Name of the server node. |
| Node ID type | Numeric | String | GUID | Byte string; default: Numeric | Node ID type. |
| Node ID | integer [2..2147483647]; default: none | Node ID. |
| Source | list; default: OPC UA Server | Source service name. |
| Value from source | Uptime | Device serial number | Device name | Device code | Firmware version | Hostname | LAN IP address | LAN subnet mask | LAN gateway | LAN DNS servers | LAN MAC address | GPS fix status | GPS timestamp | GPS latitude | GPS altitude | GPS angle | GPS speed | GPS accuracy | GPS satellite count | Modem count | Modem IMEI | Modem serial number | Modem manufacturer name | Modem model name | Modem firmware version | Modem temperature | Modem SIM count | Modem active SIM slot | Modem SIM state | Modem SIM ICCID | Modem SIM RSSI | Modem connection type | Modem connection state | Modem network state | Modem operator name | WAN IP address | WAN type | WAN | I/O; default: Uptime | Note: different types of sources have different values. |