1 Scope

This document specifies the OPC UA Information Model to represent the Objects and services that comprise Remote IO as defined in chapter 6. The Remote IO Information Model is based on Remote IO for FA [RIO FA] and Remote IO for PA [RIO PA].

OPC Foundation

OPC is the interoperability standard for the secure and reliable exchange of data and information in the industrial automation space and in other industries. It is platform independent and ensures the seamless flow of information among devices from multiple vendors. The OPC Foundation is responsible for the development and maintenance of this standard.

OPC UA is a platform independent service-oriented architecture that integrates all the functionality of the individual OPC Classic specifications into one extensible framework. This multi-layered approach accomplishes the original design specification goals of:

Platform independence: from an embedded microcontroller to cloud-based infrastructure

Secure: encryption, authentication, authorization and auditing

Extensible: ability to add new features including transports without affecting existing applications

Comprehensive information modelling capabilities: for defining any model from simple to complex

PROFINET Standardization Group (PNO)

The PROFIBUS and PROFINET user organization (PNO: Profibus Nutzerorganisation e. V.) was founded in 1989 and is the largest automation community in the world and responsible for PROFIBUS and PROFINET, the two most important enabling technologies in automation today. The PNO is member of PROFIBUS and PROFINET International (PI).

The common interest of the PNO global network of vendors, developers, system integrators and end users covering all industries lies in promoting, supporting and using PROFINET. Regionally and globally about 1,400 member companies are working closely together to the best automation possible. No other fieldbus organization in the world has the same kind of global influence and reach.

2 Normative references

The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments and errata) applies.

OPC 10000-1, OPC Unified Architecture - Part 1: Overview and Concepts

OPC 10000-1

OPC 10000-2, OPC Unified Architecture - Part 2: Security Model

OPC 10000-2

OPC 10000-3, OPC Unified Architecture V1.05 - Part 3: Address Space Model

OPC 10000-3

OPC 10000-4, OPC Unified Architecture - Part 4: Services

OPC 10000-4

OPC 10000-5, OPC Unified Architecture V1.05 - Part 5: Information Model

OPC 10000-5

OPC 10000-6, OPC Unified Architecture V1.05 - Part 6: Mappings

OPC 10000-6

OPC 10000-7, OPC Unified Architecture - Part 7: Profiles

OPC 10000-7

OPC 10000-9, OPC Unified Architecture V1.05 - Part 9: Alarms and Conditions

OPC 10000-9

OPC 10000-23, OP Unified Architecture V1.05 - Part 23: Common Reference Types

OPC 10000-23

OPC 10000-100, OPC Unified Architecture - Part 100: Devices

OPC 10000-100

RIO FA, Remote IO for Factory Automation – Version 1.10 – Date: August 2018 –

Order No.:3.242

RIO PA, Remote IO for Process Automation – Version 1.00 – Date: March 2022 –

Order No.:3.232

PCD PB, Profile for Process Control Devices – Version 3.02 – Date: April 2009 –

Order No.:3.042

PCD, Profile for Process Control Devices – Version 4.01 – Date: November 2020 –

Order No.:3.042

OPC PN, OPC UA for PROFINET – Release V1.0 – Date: January 2020 –

Order No.: 30140

PN Service IEC 61158-5-10, Industrial communication networks – Fieldbus specifications –

Part 5-10: Application layer service definition – Type 10 elements

3 Terms, abbreviated terms and conventions

3.1 Overview

It is assumed that basic concepts of OPC UA information modelling, Remote IO for Factory Automation [RIO FA] and Remote IO for Process Automation [RIO PA] are understood in this document. This document will use these concepts to describe the Remote IO Information Model. For the purposes of this document, the terms and definitions given in OPC 10000-1, OPC 10000-3, OPC 10000-4, OPC 10000-5, OPC 10000-7, OPC 10000-100, … as well as the following apply.

Note that OPC UA terms and terms defined in this document are italicized in the document.

3.2 OPC UA for PROFINET Remote IO terms

3.2.1 Untitled

A Controller is a host running a program which reads and writes the Process Values used to control an automated process. The control is usually done in cycles consisting of reading the Input Process Value, processing the Input, calculating the Output, and finally writing the Output Process Value.

3.2.2 Untitled

A Device is a stand-alone unit exchanging cyclic data with a Controller. Devices are usually configured by the Controller and may also generate acyclic data like alarms or diagnostic information. A Device may consist of several modules and Submodules.

3.2.3 Untitled

Remote IO is defined in this specification as accessing the Input Telegram data and the Output Telegram data of a PN Submodule from a remote host without interfering or interacting with cyclic data transfer.

3.2.4 Untitled

A RIO Channel comprises all Function Blocks, Functions and Variables used for processing of an analog or digital electric signal.

3.2.5 Untitled

A RIO Input Channel comprises all Function Blocks, Functions and Variables used for processing of an analog or digital electric input signal. Typically, the RIO Input Channel generates an Input Process Value from an electric signal.

3.2.6 A RIO Output Channel comprises all Function Blocks, Functions and Variables used for processing of an analog or digital electric output signal. Typically, a RIO Output Channel is used to transfer an Output Process Value to an electric signal. In addition, RIO Output Channels may process a Readback Value.

3.2.7 A RIO Channel Group is an aggregation of RIO Channels.

3.2.8 Untitled

Input is the data transferred from a monitored electrical sensor signal to the Controller.

3.2.9 Untitled

Output is the data transferred from the Controller to a remote-controlled actuator signal.

3.2.10 Untitled

A Transducer comprises all Functions used for the conversion of an electric signal into a digital representation and vice versa.

3.2.11 Untitled

An Input Transducer comprises all Functions used for the conversion of an electric signal into a digital representation.

3.2.12 Untitled

An Output Transducer comprises all Functions used for the conversion of a digital signal representation into an electric signal. As an option, an Output Transducer in addition can also convert the electric output signal back into a digital Readback Value representation.

3.2.13 Untitled

The Readback Value is the result of feeding the electric signal back into the RIO Output Channel within an Output Transducer.

3.2.14 Untitled

A Physical Value is the digital representation of the electrical signal or the physical value measured/controlled by the attached sensor/actor.

3.2.15 Untitled

3.2.16 Untitled

A Function Block comprises all Functions used for the conversion of the Physical Value into the Process Value and vice versa.

3.2.17 Untitled

The Process Value are all data variables which are intended to be part of cyclic data transfer with a Controller.

3.2.18 Untitled

3.2.19 Untitled

An Input Process Value contains the Input data used by a Controller.

3.2.20 Untitled

An Output Process Value contains a Controller’s Output data to an automated process.

3.2.21 Untitled

A Telegram represents the cyclic data of one PN Submodule. A Telegram consists at least of one Input Telegram or of one Output Telegram or of both.

3.2.22 Untitled

An Input Telegram represents the cyclic Input data of one PN Submodule. An Input Telegram consists of Signals.

3.2.23 Untitled

An Output Telegram represents the cyclic Output data of one PN Submodule. An Output Telegram consists of Signals.

3.2.24 Untitled

Signals are components of a Telegram. A Signal maps to a Variable in the Application Information Model.

3.2.25 Untitled

A PN Submodule is the consumer or the provider of one Telegram and the addressable endpoint for PROFINET access.

3.3 Abbreviated terms

IOCSIO Consumer Status, see [PN Service]
IOPSIO Provider Status, see [PN Service]
MESManufacturing Execution System
PAProcess Automation
PNPROFINET
RIORemote IO
RIOforFARemote IO for Factory Automation
RIOforPARemote IO for Process Automation
SCADASupervisory Control and Data Acquisition

3.4 Conventions used in this document

3.4.1 Conventions for Node descriptions

3.4.1.1 Node definitions

Node definitions are specified using tables (see Table 2).

Attributes are defined by providing the Attribute name and a value, or a description of the value.

References are defined by providing the ReferenceType name, the BrowseName of the TargetNode and its NodeClass.

  • If the TargetNode is a component of the Node being defined in the table the Attributes of the composed Node are defined in the same row of the table.

  • The DataType is only specified for Variables; “[<number>]” indicates a single-dimensional array, for multi-dimensional arrays the expression is repeated for each dimension (e.g. [2][3] for a two-dimensional array). For all arrays the ArrayDimensions is set as identified by <number> values. If no <number> is set, the corresponding dimension is set to 0, indicating an unknown size. If no number is provided at all the ArrayDimensions can be omitted. If no brackets are provided, it identifies a scalar DataType and the ValueRank is set to the corresponding value (see OPC 10000-3). In addition, ArrayDimensions is set to null or is omitted. If it can be Any or ScalarOrOneDimension, the value is put into “{<value>}”, so either “{Any}” or “{ScalarOrOneDimension}” and the ValueRank is set to the corresponding value (see OPC 10000-3) and the ArrayDimensions is set to null or is omitted. Examples are given in Table 1.

Table 1 – Examples of DataTypes
Notation Data­Type Value­Rank Array­Dimensions Description
0:Int320:Int32-1omitted or nullA scalar Int32.
0:Int32[]0:Int321omitted or {0}Single-dimensional array of Int32 with an unknown size.
0:Int32[][]0:Int322omitted or {0,0}Two-dimensional array of Int32 with unknown sizes for both dimensions.
0:Int32[3][]0:Int322{3,0}Two-dimensional array of Int32 with a size of 3 for the first dimension and an unknown size for the second dimension.
0:Int32[5][3]0:Int322{5,3}Two-dimensional array of Int32 with a size of 5 for the first dimension and a size of 3 for the second dimension.
0:Int32{Any}0:Int32-2omitted or nullAn Int32 where it is unknown if it is scalar or array with any number of dimensions.
0:Int32{ScalarOrOneDimension}0:Int32-3omitted or nullAn Int32 where it is either a single-dimensional array or a scalar.
  • The TypeDefinition is specified for Objects and Variables.

  • The TypeDefinition column specifies a symbolic name for a NodeId, i.e. the specified Node points with a HasTypeDefinition Reference to the corresponding Node.

  • The ModellingRule of the referenced component is provided by specifying the symbolic name of the rule in the ModellingRule column. In the AddressSpace, the Node shall use a HasModellingRule Reference to point to the corresponding ModellingRule Object.

If the NodeId of a DataType is provided, the symbolic name of the Node representing the DataType shall be used.

Note that if a symbolic name of a different namespace is used, it is prefixed by the NamespaceIndex (see 3.4.2.2).

Nodes of all other NodeClasses cannot be defined in the same table; therefore, only the used ReferenceType, their NodeClass and their BrowseName are specified. A reference to another part of this document points to their definition.

Table 2 illustrates the table. If no components are provided, the DataType, TypeDefinition and Other columns may be omitted and only a Comment column is introduced to point to the Node definition.

Table 2 – Type Definition Table
Attribute Value
Attribute nameAttribute value. If it is an optional Attribute that is not set “--” is used.
References NodeClass BrowseName DataType TypeDefinition Other
ReferenceType name NodeClass of the target Node. BrowseName of the target Node. DataType of the referenced Node, only applicable for Variables. TypeDefinition of the referenced Node, only applicable for Variables and Objects.Additional characteristics of the TargetNode such as the ModellingRule or AccessLevel.
NOTE Notes referencing footnotes of the table content.

Components of Nodes can be complex that is containing components by themselves. The TypeDefinition, NodeClass and DataType can be derived from the type definitions, and the symbolic name can be created as defined in 3.4.3.1. Therefore, those containing components are not explicitly specified; they are implicitly specified by the type definitions.

The Other column defines additional characteristics of the Node. Examples of characteristics that can appear in this column are show in Table 3.

Table 3 – Examples of Other Characteristics
Name Short Name Description
0:MandatoryMThe Node has the Mandatory ModellingRule.
0:OptionalOThe Node has the Optional ModellingRule.
0:MandatoryPlaceholderMPThe Node has the MandatoryPlaceholder ModellingRule.
0:OptionalPlaceholderOPThe Node has the OptionalPlaceholder ModellingRule.
ReadOnlyROThe Node AccessLevel has the CurrentRead bit set but not the CurrentWrite bit.
ReadWriteRWThe Node AccessLevel has the CurrentRead and CurrentWrite bits set.
WriteOnlyWOThe Node AccessLevel has the CurrentWrite bit set but not the CurrentRead bit.

If multiple characteristics are defined they are separated by commas. The name or the short name may be used.

3.4.1.2 Additional References

To provide information about additional References, the format as shown in Table 4 is used.

Table 4 – <some>Type Additional References
SourceBrowsePath Reference Type Is Forward TargetBrowsePath
SourceBrowsePath is always relative to the TypeDefinition. Multiple elements are defined as separate rows of a nested table. ReferenceType nameTrue = forward Reference.

TargetBrowsePath points to another Node, which can be a well-known instance or a TypeDefinition. You can use BrowsePaths here as well, which is either relative to the TypeDefinition or absolute.

If absolute, the first entry needs to refer to a type or well-known instance, uniquely identified within a namespace by the BrowseName.

References can be to any other Node.

3.4.1.3 Additional sub-components

To provide information about sub-components, the format as shown in Table 5 is used.

Table 5 – <some>Type Additional Subcomponents
BrowsePath References NodeClass BrowseName DataType TypeDefinition Others
BrowsePath is always relative to the TypeDefinition. Multiple elements are defined as separate rows of a nested tableNOTE Same as for Table 2
3.4.1.4 Additional Attribute values

The type definition table provides columns to specify the values for required Node Attributes for InstanceDeclarations. To provide information about additional Attributes, the format as shown in Table 6 is used.

Table 6 – <some>Type Attribute values for child Nodes
BrowsePath <Attribute name> Attribute
BrowsePath is always relative to the TypeDefinition. Multiple elements are defined as separate rows of a nested table

The values of attributes are converted to text by adapting the reversible JSON encoding rules defined in OPC 10000-6.

If the JSON encoding of a value is a JSON string or a JSON number then that value is entered in the value field. Double quotes are not included.

If the DataType includes a NamespaceIndex (QualifiedNames, NodeIds or ExpandedNodeIds) then the notation used for BrowseNames is used.

If the value is an Enumeration the name of the enumeration value is entered.

If the value is a Structure then a sequence of name and value pairs is entered. Each pair is followed by a newline. The name is followed by a colon. The names are the names of the fields in the DataTypeDefinition.

If the value is an array of non-structures then a sequence of values is entered where each value is followed by a newline.

If the value is an array of Structures or a Structure with fields that are arrays or with nested Structures then the complete JSON array or JSON object is entered. Double quotes are not included.

There can be multiple columns to define more than one Attribute.

3.4.2 NodeIds and BrowseNames

3.4.2.1 NodeIds

The NodeIds of all Nodes described in this standard are only symbolic names. Annex A defines the actual NodeIds.

The symbolic name of each Node defined in this document is its BrowseName, or, when it is part of another Node, the BrowseName of the other Node, a “.”, and the BrowseName of itself. In this case “part of” means that the whole has a HasProperty or HasComponent Reference to its part. Since all Nodes not being part of another Node have a unique name in this document, the symbolic name is unique.

The NamespaceUri for all NodeIds defined in this document is defined in Annex A. The NamespaceIndex for this NamespaceUri is vendor-specific and depends on the position of the NamespaceUri in the server namespace table.

Note that this document not only defines concrete Nodes, but also requires that some Nodes shall be generated, for example one for each Session running on the Server. The NodeIds of those Nodes are Server-specific, including the namespace. But the NamespaceIndex of those Nodes cannot be the NamespaceIndex used for the Nodes defined in this document, because they are not defined by this document but generated by the Server.

3.4.2.2 BrowseNames

The text part of the BrowseNames for all Nodes defined in this document is specified in the tables defining the Nodes. The NamespaceUri for all BrowseNames defined in this document is defined in 13.2.

For InstanceDeclarations of NodeClass Object and Variable that are placeholders (OptionalPlaceholder and MandatoryPlaceholder ModellingRule), the BrowseName and the DisplayName are enclosed in angle brackets (<>) as recommended in OPC 10000-3.If the BrowseName is not defined by this document, a namespace index prefix is added to the BrowseName (e.g., prefix '0' leading to ‘0:EngineeringUnits’ or prefix '2' leading to ‘2:DeviceRevision’). This is typically necessary if a Property of another specification is overwritten or used in the OPC UA types defined in this document. Table 145 provides a list of namespaces and their indexes as used in this document.

3.4.3 Common Attributes

3.4.3.1 General

The Attributes of Nodes, their DataTypes and descriptions are defined in OPC 10000-3. Attributes not marked as optional are mandatory and shall be provided by a Server. The following tables define if the Attribute value is defined by this document or if it is server-specific.

For all Nodes specified in this document, the Attributes named in Table 7 shall be set as specified in the table.

Table 7 – Common Node Attributes
Attribute Value
DisplayNameThe DisplayName is a LocalizedText. Each Server shall provide the DisplayName identical to the BrowseName of the Node for the LocaleId “en”. Whether the server provides translated names for other LocaleIds are server-specific.
DescriptionOptionally a server-specific description is provided.
NodeClassShall reflect the NodeClass of the Node.
NodeIdThe NodeId is described by BrowseNames as defined in 3.4.2.1.
WriteMaskOptionally the WriteMask Attribute can be provided. If the WriteMask Attribute is provided, it shall set all non-server-specific Attributes to not writable. For example, the Description Attribute may be set to writable since a Server may provide a server-specific description for the Node. The NodeId shall not be writable, because it is defined for each Node in this document.
UserWriteMaskOptionally the UserWriteMask Attribute can be provided. The same rules as for the WriteMask Attribute apply.
RolePermissionsOptionally server-specific role permissions can be provided.
UserRolePermissionsOptionally the role permissions of the current Session can be provided. The value is server-specific and depends on the RolePermissions Attribute (if provided) and the current Session.
AccessRestrictionsOptionally server-specific access restrictions can be provided.
3.4.3.2 Objects

For all Objects specified in this document, the Attributes named in Table 8 shall be set as specified in the Table 8. The definitions for the Attributes can be found in OPC 10000-3.

Table 8 – Common Object Attributes
Attribute Value
EventNotifierWhether the Node can be used to subscribe to Events or not is server-specific.
3.4.3.3 Variables

For all Variables specified in this document, the Attributes named in Table 9 shall be set as specified in the table. The definitions for the Attributes can be found in OPC 10000-3.

Table 9 – Common Variable Attributes
Attribute Value
MinimumSamplingIntervalOptionally, a server-specific minimum sampling interval is provided.
AccessLevelThe access level for Variables used for type definitions is server-specific, for all other Variables defined in this document, the access level shall allow reading; other settings are server-specific.
UserAccessLevelThe value for the UserAccessLevel Attribute is server-specific. It is assumed that all Variables can be accessed by at least one user.
ValueFor Variables used as InstanceDeclarations, the value is server-specific; otherwise it shall represent the value described in the text.
ArrayDimensions

If the ValueRank does not identify an array of a specific dimension (i.e. ValueRank <= 0) the ArrayDimensions can either be set to null or the Attribute is missing. This behaviour is server-specific.

If the ValueRank specifies an array of a specific dimension (i.e. ValueRank > 0) then the ArrayDimensions Attribute shall be specified in the table defining the Variable.

HistorizingThe value for the Historizing Attribute is server-specific.
AccessLevelExIf the AccessLevelEx Attribute is provided, it shall have the bits 8, 9, and 10 set to 0, meaning that read and write operations on an individual Variable are atomic, and arrays can be partly written.
3.4.3.4 VariableTypes

For all VariableTypes specified in this document, the Attributes named in Table 10 shall be set as specified in the table. The definitions for the Attributes can be found in OPC 10000-3.

Table 10 – Common VariableType Attributes
Attributes Value
ValueOptionally a server-specific default value can be provided.
ArrayDimensions

If the ValueRank does not identify an array of a specific dimension (i.e. ValueRank <= 0) the ArrayDimensions can either be set to null or the Attribute is missing. This behaviour is server-specific.

If the ValueRank specifies an array of a specific dimension (i.e. ValueRank > 0) then the ArrayDimensions Attribute shall be specified in the table defining the VariableType.

3.4.3.5 Methods

For all Methods specified in this document, the Attributes named in Table 11 shall be set as specified in the table. The definitions for the Attributes can be found in OPC 10000-3.

Table 11 – Common Method Attributes
Attributes Value
ExecutableAll Methods defined in this document shall be executable (Executable Attribute set to “True”), unless it is defined differently in the Method definition.
UserExecutableThe value of the UserExecutable Attribute is server-specific. It is assumed that all Methods can be executed by at least one user.

4 General information to PROFINET Remote IO and OPC UA

PROFINET Remote IO (RIO) as referred to in this document consists of the objects and services allowing clients to access the IO data of PROFINET submodules.

4.1 What is RIO for Factory Automation?

RIO for Factory Automation (RIOforFA) is a Common Profile Specification for PROFINET and PROFIBUS which defines the qualifier, behaviour, and representation of IO data for Remote IO (see [RIO FA]). RIOforFA defines the minimal and typical requirements for Remote IO.

RIOforFA has the following properties (excerpt, See [RIO FA], sec. 1.2):

Defines qualifiers for values of physical signals, to be able to communicate and use data access (Process Image) in the host in a standardized way.

Defines a RIOforFA channel for digital IO and for analog IO. One RIOforFA channel consists of value and qualifier. The qualifier shall be synchronous and consistent with the value.

A RIOforFA submodule uses RIOforFA channels only.

The profile does not add any definition to standard PROFINET diagnosis and I&M functions.

Figure 1 shows an example of an Input submodule according to RIOforFA. The RIOforFA channel provides the value and its qualifier, which both are available in the process image of the user program (see [RIO FA], sec. 1.3).

Figure 1 – RIOforFA Input Channel

4.2 What is RIO for Process Automation

RIO for Process Automation (RIOforPA) is a Common Application Profile for PROFINET and PROFIBUS defined in [RIO PA].

RIOforPA defines the following application classes (see [RIO PA], sec. 5.1):

Figure 2 – Application Classes for RIOforPA

“… The application class RIOforPA Digital Input defines functions for mapping of digital input signals from the process to input data transferred to the IO controller. The application class RIOforPA Analog Input defines functions for mapping of analog input signals from the process to input data transferred to the IO controller.

The application class RIOforPA Digital Output defines functions for mapping of output data transferred from the IO controller to digital output signals to the process. The application class RIOforPA Analog Output defines functions for mapping of output data transferred from the IO controller to analog output signals to the process.

Additional functions like fieldbus integration or HART mappings etc. are not in the scope of the profile.

Instances of the application classes will be realised as channels. A channel may have a connection to a sensor or actuator (physical channel) or not (logical channel). …” (see also [RIO PA] sec. 5.1).

4.3 Introduction to OPC Unified Architecture

4.3.1 What is OPC UA?

OPC UA is an open and royalty free set of standards designed as a universal communication protocol. While there are numerous communication solutions available, OPC UA has key advantages:

A state of art security model (see OPC 10000-2).

A fault tolerant communication protocol.

An information modelling framework that allows application developers to represent their data in a way that makes sense to them.

OPC UA has a broad scope which delivers for economies of scale for application developers. This means that a larger number of high-quality applications at a reasonable cost are available. When combined with semantic models such as OPC UA for PROFINET Remote IO, OPC UA makes it easier for end users to access data via generic commercial applications.

The OPC UA model is scalable from small devices to ERP systems. OPC UA Servers process information locally and then provide that data in a consistent format to any application requesting data - ERP, MES, PMS, Maintenance Systems, HMI, Smartphone or a standard Browser, for examples. For a more complete overview see OPC 10000-1.

4.3.2 Basics of OPC UA

As an open standard, OPC UA is based on standard internet technologies, like TCP/IP, HTTP, Web Sockets.

As an extensible standard, OPC UA provides a set of Services (see OPC 10000-4) and a basic information model framework. This framework provides an easy manner for creating and exposing vendor defined information in a standard way. More importantly all OPC UA Clients are expected to be able to discover and use vendor-defined information. This means OPC UA users can benefit from the economies of scale that come with generic visualization and historian applications. This specification is an example of an OPC UA Information Model designed to meet the needs of developers and users.

OPC UA Clients can be any consumer of data from another device on the network to browser based thin clients and ERP systems. The full scope of OPC UA applications is shown in Figure 3.

Figure 3 – The Scope of OPC UA within an Enterprise

OPC UA provides a robust and reliable communication infrastructure having mechanisms for handling lost messages, failover, heartbeat, etc. With its binary encoded data, it offers a high-performing data exchange solution. Security is built into OPC UA as security requirements become more and more important especially since environments are connected to the office network or the internet and attackers are starting to focus on automation systems.

4.3.3 Information modelling in OPC UA

4.3.3.1 Concepts

OPC UA provides a framework that can be used to represent complex information as Objects in an AddressSpace which can be accessed with standard services. These Objects consist of Nodes connected by References. Different classes of Nodes convey different semantics. For example, a Variable Node represents a value that can be read or written. The Variable Node has an associated DataType that can define the actual value, such as a string, float, structure etc. It can also describe the Variable value as a variant. A Method Node represents a function that can be called. Every Node has a number of Attributes including a unique identifier called a NodeId and non-localized name called as BrowseName. An Object representing a ‘Reservation’ is shown in Figure 4.

Figure 4 – A Basic Object in an OPC UA Address Space

Object and Variable Nodes represent instances and they always reference a TypeDefinition (ObjectType or VariableType) Node which describes their semantics and structure. Figure 5 illustrates the relationship between an instance and its TypeDefinition.

The type Nodes are templates that define all of the children that can be present in an instance of the type. In the example in Figure 5 the PersonType ObjectType defines two children: First Name and Last Name. All instances of PersonType are expected to have the same children with the same BrowseNames. Within a type the BrowseNames uniquely identify the children. This means Client applications can be designed to search for children based on the BrowseNames from the type instead of NodeIds. This eliminates the need for manual reconfiguration of systems if a Client uses types that multiple Servers implement.

OPC UA also supports the concept of sub-typing. This allows a modeller to take an existing type and extend it. There are rules regarding sub-typing defined in OPC 10000-3, but in general they allow the extension of a given type or the restriction of a DataType. For example, the modeller may decide that the existing ObjectType in some cases needs an additional Variable. The modeller can create a subtype of the ObjectType and add the Variable. A Client that is expecting the parent type can treat the new type as if it was of the parent type. Regarding DataTypes, subtypes can only restrict. If a Variable is defined to have a numeric value, a sub type could restrict it to a float.

Figure 5 – The Relationship between Type Definitions and Instances

References allow Nodes to be connected in ways that describe their relationships. All References have a ReferenceType that specifies the semantics of the relationship. References can be hierarchical or non-hierarchical. Hierarchical references are used to create the structure of Objects and Variables. Non-hierarchical are used to create arbitrary associations. Applications can define their own ReferenceType by creating subtypes of an existing ReferenceType. Subtypes inherit the semantics of the parent but may add additional restrictions. Figure 6 depicts several References, connecting different Objects.

Figure 6 – Examples of References between Objects

The figures above use a notation that was developed for the OPC UA specification. The notation is summarized in Figure 7. UML representations can also be used; however, the OPC UA notation is less ambiguous because there is a direct mapping from the elements in the figures to Nodes in the AddressSpace of an OPC UA Server.

Figure 7 – The OPC UA Information Model Notation

A complete description of the different types of Nodes and References can be found in OPC 10000-3 and the base structure is described in OPC 10000-5.

OPC UA specification defines a very wide range of functionality in its basic information model. It is not required that all Clients or Servers support all functionality in the OPC UA specifications. OPC UA includes the concept of Profiles, which segment the functionality into testable certifiable units. This allows the definition of functional subsets (that are expected to be implemented) within a companion specification. The Profiles do not restrict functionality, but generate requirements for a minimum set of functionality (see OPC 10000-7).

4.3.3.2 Namespaces

OPC UA allows information from many different sources to be combined into a single coherent AddressSpace. Namespaces are used to make this possible by eliminating naming and id conflicts between information from different sources. Each namespace in OPC UA has a globally unique string called a NamespaceUri which identifies a naming authority and a locally unique integer called a NamespaceIndex, which is an index into the Server's table of NamespaceUris. The NamespaceIndex is unique only within the context of a Session between an OPC UA Client and an OPC UA Server- the NamespaceIndex can change between Sessions and still identify the same item even though the NamespaceUri's location in the table has changed. The Services defined for OPC UA use the NamespaceIndex to specify the Namespace for qualified values.

There are two types of structured values in OPC UA that are qualified with NamespaceIndexes: NodeIds and QualifiedNames. NodeIds are locally unique (and sometimes globally unique) identifiers for Nodes. The same globally unique NodeId can be used as the identifier in a node in many Servers – the node's instance data may vary but its semantic meaning is the same regardless of the Server it appears in. This means Clients can have built-in knowledge of what the data means in these Nodes. OPC UA Information Models generally define globally unique NodeIds for the TypeDefinitions defined by the Information Model.

QualifiedNames are non-localized names qualified with a Namespace. They are used for the BrowseNames of Nodes and allow the same names to be used by different information models without conflict. TypeDefinitions are not allowed to have children with duplicate BrowseNames; however, instances do not have that restriction.

4.3.3.3 Companion Specifications

An OPC UA companion specification for an industry specific vertical market describes an Information Model by defining ObjectTypes, VariableTypes, DataTypes and ReferenceTypes that represent the concepts used in the vertical market, and potentially also well-defined Objects as entry points into the AddressSpace.

5 Use cases

Table 12 lists possible use cases of interest for OPC UA Clients. Typically, the use case consists of utilization of OPC UA standard mechanisms and data processing at the Client site.

6 OPC UA for RIO Information Model overview

6.1 Introduction to OPC UA for PROFINET Remote IO

The OPC UA for PROFINET Remote IO Information Model aims to offer Clients Objects and Services based on two RIO application profiles: Remote IO for Factory Automation (see [RIO FA]) and Remote IO for Process Automation (see [RIO PA]).

OPC UA for PROFINET Remote IO consists of all Objects and types provided by an OPC UA Server allowing OPC UA Clients to access the IO data of PN Submodules. The Information Model is divided into a PROFINET aspect offering detailed Telegram information and a functional aspect modelling Process Values as part of RIO Channel Objects. The two aspects offer different access paths for Clients and are connected by dedicated References to allow navigating to the preferred representation from either aspect.

6.2 OPC UA for RIO Channel Model

The “RIOChannel” Object in the functional aspect aggregates Process Value Objects optionally offering additional information like Process Value qualifiers associated with the IO data. Figure 8 shows the basic channel model for an analog RIO Input Channel according to RIOforPA.

Figure 8 – Analog Input Channel Model in Functional Aspect with RIOforPA

The functional aspect with RIO of the Information Model contains as many RIO Channel objects as needed to represent the IO’s associated with the PN Submodules of the Device.

The “ProcessValue” Variable in Figure 8 contains an analog Process Value. The VariableType used to represent analog Process Values is RioPaAnalogProcessValueVariableType, the data type used by this VariableType is RioPaAnalogProcessValueDataType.

Configuration properties of the RIO Channel are provided with the “Config” Variable. There are individual configuration VariableTypes defined for each channel type, the type used for analog Input Channels according to RIOforPA is RioPaAnalogInputConfigVariableType.

Figure 9 shows all RIO Channel ObjectTypes, Process Value VariableTypes and configuration ObjectTypes which are defined in this specification to cover digital and analog Input and Output for RIOforPA and RIOforFA.

Figure 9 – RioChannel ObjectTypes

The RIO Channel ObjectTypes provide additional components, Variables and configuration Properties available for access by the Client which substantially differ between the various types, see sections 7.2 and 9.4 for details.

6.3 PROFINET Cyclic IO Telegram Model

Figure 10 shows the Cyclic IO Telegram model accessible from the PN Submodule in the PROFINET aspect of the Information Model. If provided by the Server, the Telegram Object associated with one PN Submodule aggregates the Input and the Output Telegram Objects. The individual data points or variables within a Telegram are represented by Signal Objects. The Input Telegram and Output Telegram Objects aggregate the Signal Objects and provide additional information like provider status and consumer status.

Figure 10 – PROFINET Telegram Model

The Offset Property of the PnIoSignalType Object contains the position as byte offset of the signal from the start of the binary telegram.

The 0:RepresentsSameEntityAs Reference connects PnIoSignalType Objects with the “ProcessValue” Variables containing the Process Value provided by RIO Channel Objects in the functional aspect of the Information Model.

6.4 Connection of PROFINET Aspect and Functional Aspect

Figure 11 – 2 analog RIOforPA channels

Figure 11 shows the Channel model for analog Input according to RIOforPA to illustrate the relationship between the different aspects. The Process Values and their qualifiers are transmitted consecutively and are available for the user program in the Input section of the Process Image.

The connection of the PROFINET aspect and the functional aspect with two analog RIO Input Channels according to RIOforPA in the Information Model is shown in Figure 12.

Figure 12 – 2 analog RIOforPA Channels connected with Cyclic IO Telegram Model

The PnIoSignalType Objects “01_AI_1_Value” and “03_AI_2_Value” representing the Process Values in the PnIoTelegramType Object “Input” connect to the “ProcessValue” Variables which are components of the Input Channels “AI_1” and “AI_2” using a 0:RepresentsSameEntityAs Reference.

The PnIoSignalType Objects “02_AI_1_Q” and “04_AI_2_Q” representing the Process Value Qualifiers transmitted alongside the Process Values they belong to connect to the “QualifierValue” Variables also using a 0:RepresentsSameEntityAs Reference.

The direct connection of Signal Objects representing status data and qualifier Variables using 0:RepresentsSameEntityAs References in the way shown in Figure 12 is only possible for analog Input and analog Output according to RIOforPA, since only analog RIOforPA transmits the status data (= qualifiers) alongside to each Process Value as separate Signal in the Telegram.

Digital RIOforPA Input and Output Channels transmit value and status packed into one byte (see [RIO PA] sec. 7.3.1.2 “Discrete Values”). Figure 13 shows the digital Output Channel model according to RIOforPA.

Figure 13 – RIOforPA digital Output Channel Model

No separate qualifier Signal Objects and no 0:RepresentsSameEntityAs References to qualifier Variables exist for digital RIOforPA values, as shown in Figure 14.

Figure 14 – 2 digital RIOforPA Channels connected with Cyclic IO Telegram Model

6.5 OPC UA for RIO Channel Groups

The qualifiers in RIOforFA Channels are single bits transferred together in one or more bytes (see [RIO FA] sec. 7.2). Therefore, the Telegram contains an arbitrary number of qualifier bits distributed among several continuous bytes.

Figure 15 – FA Channel Group

Figure 15 shows the analog Output Channel model and a Channel Group according to RIOforFA. The qualifiers of the Output Process Values are transferred as single bits packed into one byte in the Input section of the process image.

Figure 16 shows the References from Signal Objects in the PROFINET aspect to their counterparts in the RIO aspect for analog RIO Output Channels according to RIOforFA. The qualifier Signal Object is connected to a RioBitFieldVariableType Variable containing a bit field. The bit field and the RIO Channel Objects are related using RIO Channel Group Objects.

The Output Signal Objects “01_AO_1_Value” and “02_AO_2_Value” are connected to the Process Value Variables with 0:RepresentsSameEntityAs References in the same way as described before.

The qualifiers of RIO Output Channels according to RIOforFA are transmitted separated from the values in an Input Signal since qualifiers of RIOforFA Output Channels are provided by the Channel and are part of the Input section of the process image. Therefore, the qualifier Signal Object “03_AO_1-AO_2_Q” containing the status information for both Output Channels is a component of the Input Signal Variable and relates to the “OutputImageQualifiers” Variable in the functional aspect of the Information Model using a 0:RepresentsSameEntityAs Reference.

The “SM1” PROFINET submodule Object connects to the RioFaAnalogChannelGroupType Object using a 0:RepresentsSameFunctionalityAs Reference. Since the RIO Channel Group types allow aggregating of Input and Output but are separated into different types for digital and analog IO, hybrid digital/analog submodules may reference a digital Channel Group type object and an analog Channel Group type object with 0:RepresentsSameFunctionalityAs References.

For analog RIOforFA Input Channels, the RIO Channel Group modelling is done in the same way as shown in Figure 16, but all Signal Objects are components of the Input Signal Variable.

Figure 16 – 2 analog RIOforFA Output Channels

The mapping of the bit number inside the RioBitFieldVariableType Variable to the RIO Channel the status bit belongs to is done in the following way: The Value of the RioChannelNumber Property of each Channel Object corresponds to the bit number of the status bit inside the bit field.

The Server may optionally provide additional RioFaProcessValueQualifierVariableType Variables as components of the Process Value Variables to make the status information directly accessible for Clients without decoding the value structure of the Process Value Variable.

Figure 17 – RIOforFA Digital Input Channel Model

Digital RIO Channels according to RIOforFA transmit the Process Values as single bits packed together into one or more bytes. One Telegram contains an arbitrary number of value bits which belong to separate RIO Channels distributed among continuous bytes, as shown in Figure 17.

Figure 18 shows the modelling of a digital RIOforFA Input Channel Group. The RIO Channel Group Object aggregates the value and status information for 32 digital RIOforFA Input Channels. The RioBitFieldVariableType Variable “InputImage” is a bit field representing the digital values of 32 Process Values. The “InputImageQualifier” Variable of the same type contains the status bits.

The optional “InputChannel” Objects may contain single RioFaDigitalInputChannelType Objects providing detailed information for each aggregated RIO Channel. The “01_DI_1-DI_32_Value” Object is connected to a RioBitFieldVariableType Variable containing a bit field which represents the digital values for more than one RIO Channel. The qualifier Signal Object is also connected with a bit field Variable containing the status bits.

Figure 18 – RIO FA Digital Input Channel Group

Figure 19 shows the modelling of a digital RIOforFA Output Channel Group. The “OutputImageQualifier” bit field Variable is connected to the qualifier Signal Object which is a component of the Input Telegram.

Figure 19 – RIO FA Digital Output Channel Group

Figure 20 shows an analog RIO Channel Group aggregating two RioPaAnalogInputChannelType Objects. The “InputValues” Variable containing an array of RioPaAnalogValueDataType structures is connected to the “Input” Telegram Variable in the PROFINET aspect using a 0:RepresentsSameEntityAs Reference.

Figure 20 – RIOforPA Analog Input Channel Group

Figure 21 shows a digital RIO Channel Group aggregating two RioPaDigitalOutputChannelType Objects. The “OutputImage” Variable containing an array of RioPaDigitalValueDataType structures is connected with the “Output” Telegram Variable in the PROFINET aspect using a 0:RepresentsSameEntityAs Reference.

Figure 21 – RIOforPA Digital Output Channel Group

6.6 RIO Channel Groups Summary

For RIO Channel Group Objects the following rules apply to Servers.

RIOforFA:
RIO Channel Group Objects shall be provided always if the Cyclic IO Telegram model is provided by the Server. RIO Channel Groups could be used for lightweight modelling of digital multichannel I/O submodules when the RIO Channel Objects are omitted and only the I/O image Variables are used.

RIOforPA:
RIO Channel Group Objects could be used if logical grouping of channels shall be done for asset relations on the RIO aspect side if the PROFINET aspect is omitted.

General:
Servers may always provide RIO Channel Group Objects, independent from the conditions mentioned above.

6.7 OPC UA for RIO Security

Servers shall allow Method invocation and write access to Variables only for Sessions using dedicated user accounts. There shall exist user accounts with restricted rights (that is, no Method invocation and read-only access to Variables) for Clients performing data acquisition or diagnosis also.

If well-known Roles are supported by the Server, role-based security shall be applied. Method invocation as well as write access shall only be possible if the well-known “Operator” Role is granted to the Client’s Session.

6.8 Process Value Qualifier and StatusCode Relationship

When returning the Value of Process Values, the Server shall set the StatusCode member of the DataValue structures returned by the Read Service and the Publish Service consistent with the Process Value Qualifier information defined for Process Value Variables and structures.

6.8.1 Process Value Qualifier and StatusCode Relationship for RIOforPA

RIOforPA status information is conveyed to the Client as copy of the original status transmitted in the telegram signal. The value of the RioPaProcessValueQualifierVariableType Variable and the Qualifier member of the RioPaAnalogValueDataType and the RioPaDigitalValueDataType shall contain the original status. In addition to this, the status can be encoded into additional qualifier values encoded as RioQualityEnumeration, RioSpecifierEnumeration and RioQualifierEnumeration enumeration values.

6.8.1.1 Condensed Status restricted to NE 107

If the Device generates condensed status codes restricted to NE 107 (See [PCD] chapter 5.4.3.2), the status information delivered for one Process Value and the OPC UA StatusCode shall be set consistent as defined in Table 13.

Table 13 – Condensed status restricted to NE 107
NE 107Status Byte Values Description according to ProfileOPC UA Status CodeRioQuality
Enumeration
RioSpecifier
Enumeration
RioQualifierEnumeration
Failure (F)0x24,
0x26
BAD - maintenance alarm, more diagnosis available Bad, 0x80000000BADFAILUREBAD_MAINTENANCE_ALARM
0x25, 0x27BAD_MAINTENANCE_ALARM_
SIMULATION_ACTIVE
Check(C)0x3C, 0x3EBAD - function check / local override Bad, 0x80000000BADFUNCTION_
CHECK
BAD_FUNCTION_CHECK
0x3D, 0x3FBAD_FUNCTION_CHECK_
SIMULATION_ACTIVE
Out of Specification (S)0x78, 0x7AUNCERTAIN - process related, no maintenance Uncertain, 0x40000000UNCERTAINOUT_OF_
SPECIFICATION
UNCERTAIN_NO_MAINTENANCE
0x79, 0x7BUNCERTAIN_NO_MAINTENANCE_
SIMULATION_ACTIVE
Maintenance (M)0xA4, 0xA6GOOD - maintenance required Good, 0x00000000GOODMAINTENANCE_
REQUEST
GOOD_MAINTENANCE_REQUIRED
0xA5, 0xA7GOOD_MAINTENANCE_REQUIRED_
SIMULATION_ACTIVE
0xA8, 0xAAGOOD - maintenance demanded Good, 0x00000000GOODMAINTENANCE_
REQUEST
GOOD_MAINTENANCE_DEMANDED
0xA9, 0xABGOOD_MAINTENANCE_DEMANDED_SIMULATION_ACTIVE
Good (G)0x80GOOD - ok Good, 0x00000000GOODNORMALGOOD
Check (C)0x81GOOD - simulation active GoodEdited, 0x00DC0000GOODFUNCTION_
CHECK
GOOD_SIMULATION_ACTIVE
Good (G)0x82GOOD - update event Good, 0x00000000GOODNORMALUPDATE

The two values for status bytes consider the possible appearance of the update bit as defined in [PCD]. The update bit is not mapped further into separate status values. In contrast, the appearance of the “simulation active” bit is mapped to special values of the RioQualifierEnumeration.

6.8.1.2 Status with detailed Information

If the Server generates status codes with detailed information (See [PCD] chapter 5.4.3.3), the status information delivered for one Process Value and the OPC UA StatusCode shall be set consistent as defined in Table 14.

Table 14 – Condensed status with detailed information
NE 107Status Byte RangeDescription according to ProfileOPC UA Status CodeRioQuality
Enumeration
RioSpecifier
Enumeration
RioQualifierEnumeration
Failure (F)0x00BAD - non specific

Bad,

0x80000000

BADFAILUREBAD_NON_SPECIFIC
Failure (F)0x08, 0x0ABAD - not connected

BadNotConnected,

0x808A0000

BADFAILUREBAD_NOT_CONNECTED
0x09, 0x0B

BAD_NOT_CONNECTED_

SIMULATION_ACTIVE

Failure (F)0x20, 0x22BAD - passivated

BadOutOfService,

0x808D0000

BADFAILUREBAD_PASSIVATED
0x21, 0x23BAD_PASSIVATED_SIMULATION_ACTIVE
Failure (F) 0x24, 0x26BAD - maintenance alarm, more diagnosis available

Bad,

0x80000000

BADFAILUREBAD_MAINTENANCE_ALARM
0x25, 0x27

BAD_MAINTENANCE_ALARM_

SIMULATION_ACTIVE

Failure (F)0x28, 0x2ABAD - process related, no maintenance

Bad,

0x80000000

BADFAILUREBAD_PROCESS
0x29, 0x2BBAD_PROCESS_SIMULATION_ACTIVE
Check(C) 0x3C, 0x3EBAD - function check / local override

Bad,

0x80000000

BADFUNCTION_
CHECK
BAD_FUNCTION_CHECK
0x3D, 0x3F

BAD_FUNCTION_CHECK_

SIMULATION_ACTIVE

Failure (F)0x48, 0x4AUNCERTAIN - substitute set UncertainSubstituteValue, 0x40910000UNCERTAINFAILUREUNCERTAIN_SUBSTITUTE_SET
0x49, 0x4B

UNCERTAIN_SUBSTITUTE_SET_

SIMULATION_ACTIVE

Check (C)0x4C, 0x4EUNCERTAIN - initial value UncertainInitialValue, 0x40920000UNCERTAINFUNCTION_
CHECK
UNCERTAIN_INITIAL_VALUE
0x4D, 0x4F

UNCERTAIN_INITIAL_VALUE_

SIMULATION_ACTIVE

Maintenance (M)0x68, 0x6AUNCERTAIN - maintenance demanded Uncertain, 0x40000000UNCERTAINMAINTENANCE_
REQUEST

UNCERTAIN_MAINTENANCE_

DEMANDED

0x69, 0x6B

UNCERTAIN_MAINTENANCE_

DEMANDED_SIMULATION_ACTIVE

Out of Specification (S) 0x78, 0x7AUNCERTAIN - process related, no maintenance Uncertain, 0x40000000UNCERTAINOUT_OF_
SPECIFICATION
UNCERTAIN_NO_MAINTENANCE
0x79, 0x7B

UNCERTAIN_NO_MAINTENANCE_

SIMULATION_ACTIVE

Good (G) 0x80, 0x82GOOD

Good,

0x00000000

GOODNORMALGOOD
0x81, 0x83GOOD_SIMULATION_ACTIVE
Good (G)0xA0GOOD - initiate fail safe

GoodInitiateFault

State, 0x04080000

GOODNORMALGOOD_INITIATE_FAULT_STATE
Maintenance (M) 0xA4, 0xA6GOOD - maintenance required

Good,

0x00000000

GOODMAINTENANCE_
REQUEST
GOOD_MAINTENANCE_REQUIRED
0xA5, 0xA7

GOOD_MAINTENANCE_REQUIRED_

SIMULATION_ACTIVE

0xA8, 0xAAGOOD - maintenance demanded

Good,

0x00000000

GOODMAINTENANCE_
REQUEST
GOOD_MAINTENANCE_DEMANDED
0xA9, 0xAB

GOOD_MAINTENANCE_DEMANDED_

SIMULATION_ACTIVE

Good (G)0x9C, 0x9EGOOD - local override GoodLocalOverride, 0x00960000GOODNORMALGOOD_LOCAL_OVERRIDE
0x9D, 0x9F

GOOD_LOCAL_OVERRIDE_

SIMULATION_ACTIVE

Good (G)0xBC, 0xBEGOOD - function check

Good,

0x00000000

GOODNORMALGOOD_FUNCTION_CHECK
0xBD, 0xBF

GOOD_FUNCTION_CHECK_

SIMULATION_ACTIVE

6.8.1.3 Classic Status

For Devices generating classic status codes, OPC UA Servers shall set the status information delivered for one Process Value and the OPC UA StatusCode consistent as defined in Table 15.

Table 15 – Classic status codes
Sub-
status
DescriptionOPC UA Status CodeStatus ByteRioQuality
Enumeration

RioSpecifier

Enumeration UNSPECIFIED

RioQualifierEnumeration
Quality BAD
0non-specific

Bad,

0x80000000

0x00.. 0x03BADBAD_NOT_SPECIFIC
1configuration error BadConfigurationError, 0x808900000x04.. 0x07BAD_NOT_SPECIFIC
2not connected BadNotConnected, 0x808A00000x08.. 0x0BBAD_NOT_CONNECTED
3device failure BadDeviceFailure, 0x808B00000x0C.. 0x0FBAD_NOT_SPECIFIC
4sensor failure BadSensorFailure, 0x808C00000x10.. 0x13BAD_NOT_SPECIFIC
5no communication (LUV) BadCommunicationError, 0x800500000x14.. 0x17BAD_NOT_SPECIFIC
6no communication (no LUV) BadNoCommunication, 0x803100000x18.. 0x1BBAD_NOT_SPECIFIC
7out of service

BadOutOfService,

0x808D0000

0x1C.. 0x1FBAD_PASSIVATED
Quality UNCERTAIN
0non specific

Uncertain,

0x40000000

0x40.. 0x43UNCERTAIN

UNCERTAIN_NO_

MAINTENANCE

1last usable value (LUV) UncertainLastUsableValue, 0x409000000x44.. 0x47

UNCERTAIN_NO_

MAINTENANCE

2substitute value UncertainSubstituteValue, 0x409100000x48.. 0x4BUNCERTAIN_SUBSTITUTE_SET
3initial value UncertainInitialValue, 0x409200000x4C.. 0x4FUNCERTAIN_INITIAL_VALUE
4sensor conversion not accurate UncertainSensorNotAccurate, 0x409300000x50.. 0x53

UNCERTAIN_NO_

MAINTENANCE

5engineering unit violation

UncertainEngineeringUnits

Exceeded, 0x40940000

0x54.. 0x57

UNCERTAIN_NO_

MAINTENANCE

6sub normal UncertainSubNormal, 0x409500000x58.. 0x5B

UNCERTAIN_NO_

MAINTENANCE

7configuration error UncertainConfigurationError, 0x420F00000x5C.. 0x5F

UNCERTAIN_NO_

MAINTENANCE

8simulated value UncertainSimulatedValue, 0x420900000x60.. 0x63

UNCERTAIN_NO_

MAINTENANCE_
SIMULATION_ACTIVE

9sensor calibration UncertainSensorCalibration, 0x420A00000x64.. 0x67

UNCERTAIN_NO_

MAINTENANCE

Quality GOOD (Non Cascade)
0ok

Good,

0x00000000

0x80.. 0x83GOODGOOD
1update event

Good,

0x00000000

0x84.. 0x87GOOD
2active advisory alarm GoodFaultStateActive, 0x040700000x88.. 0x8BGOOD
3active critical alarm GoodFaultStateActive, 0x040700000x8C.. 0x8FGOOD
4unacknowledged update event

Good,

0x00000000

0x90.. 0x93GOOD
5unacknowledged advisory alarm GoodFaultStateActive, 0x040700000x94.. 0x97GOOD
6unacknowledged critical alarm GoodFaultStateActive, 0x040700000x98.. 0x9BGOOD
7reserved -   
8initiate fail safe GoodInitiateFaultState, 0x040800000xA0GOOD

GOOD_INITIATE_

FAULT_STATE

9maintenance required

Good,

0x00000000

0xA4.. 0xA7

GOOD_MAINTENANCE_

REQUIRED

Quality GOOD (Cascade)
0ok

GoodCascade,

0x04090000

0xC0.. 0xC3GOODGOOD
1initialization acknowledged GoodCascadeInitialization
Acknowledged, 0x04010000
0xC4.. 0xC7GOOD
2initialization request GoodCascadeInitialization
Request, 0x04020000
0xC8.. 0xCBGOOD
3not invited GoodCascadeNotInvited, 0x040300000xCC.. 0xCFGOOD
4reserved-   
5do not select GoodCascadeNotSelected, 0x040400000xD4.. 0xD7GOODGOOD
6local override GoodLocalOverride, 0x009600000xD8.. 0xDBGOOD_LOCAL_OVERRIDE
7reserved- - 
8initial fail safe GoodInitiateFaultState, 0x040800000xE0GOOD

GOOD_INITIATE_

FAULT_STATE

According to [PCD PB] chapter 5.3.4.2.1, the classic status codes shall be supported for legacy Devices requiring backward compatibility only. Otherwise, only condensed status generation or condensed status with detailed information as defined in 6.8.1.1 and 6.8.1.2 is required.

6.8.2 Process Value Qualifier and StatusCode Relationship for RIOforFA

RIOforFA status information is conveyed to the Client as copy of the original status transmitted in the telegram signal. The value of the RioFaProcessValueQualifierVariableType Variable and the Qualifier member of the RioFaAnalogValueDataType and the RioFaDigitalValueDataType shall contain the original status. In addition to this, the status can be encoded into additional qualifier values encoded as RioQualityEnumeration.

The status information delivered for one Process Value and the OPC UA StatusCode shall be set consistent as defined in Table 16.

Table 16 – RIOforFA StatusCodes
Status Bit Value

Description according to Profile

(See [RIO FA] chapter 7.1)

OPC UA Status CodeRioQuality
Enumeration
1 (good)

Input: Process Value can be used by host application.

Output: Physical signal equals Process Value.

Good,

0x00000000

GOOD
0 (bad)

Input: Process Value should not be used by host application.

Output: Substitute Value applied by (Sub)Module.

Bad,

0x80000000

BAD

6.8.3 StatusCode of Arrays of Process Values

When returning arrays of Process Values, the Server shall set the Severity of the StatusCode to “Bad” if one or more Process Values in the returned array are “Bad”. If no Process Value in the array is “Bad”, the Severity returned shall be “Uncertain” if one or more Process Values in the returned array are “Uncertain”. The Severity returned shall be “Good” only if all Process Values in the array are “Good”.

7 OPC UA for RIO ObjectTypes

7.1 OPC UA for RIO Channel Group Types

The RIO Channel Group ObjectTypes are listed in Table 17. There are Channel Group types defined for digital and analog IO for RIOforFA and RIOforPA. There is no distinction regarding Input and Output, the Channel Group Objects aggregate Input and Output Channel Objects. All Channel Group types are derived from the RioChannelGroupType defined in chapter 7.1.1.

Table 17 – RIO Channel Group Types
Profile Channel Groups
Digital Analog
RIOforPA RioPaDigitalChannelGroupType RioPaAnalogChannelGroupType
RIOforFA RioFaDigitalChannelGroupType RioFaAnalogChannelGroupType

7.1.1 RioChannelGroupType

The RioChannelGroupType allows the aggregation of RIO Channels for diagnostic purposes and for asset relations. The RioChannelGroupType contains References to RioChannelType Objects. In addition, the server might provide configuration information common to all aggregated channels.

Table 18 – RioChannelGroupType Definition
Attribute Value
BrowseNameRioChannelGroupType
IsAbstractTrue
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the 0:BaseObjectType defined in OPC 10000-5.
0:HasPropertyVariable NumberOfChannels0:UInt16[5]0:PropertyTypeM, RO
0:HasPropertyVariableApplicationTag0:String0:PropertyTypeO, RO
0:HasComponentMethodSetApplicationTagO
0:HasPropertyVariable LastParameterChange0:DateTime0:PropertyTypeO, RO
HasRioInputChannelObject<RioInputChannel>RioChannelTypeOP
HasRioOutputChannelObject<RioOutputChannel>RioChannelTypeOP
HasRioConfigurationObjectChannelGroupConfigRioChannelGroupConfigTypeO, RO
0:GeneratesEventObjectTypeRioChannelDiagnosisEventType
0:GeneratesEventObjectTypeRioChannelDiagnosisAlarmType
0:HasComponentObjectLock2:LockingServicesTypeO
Conformance Units
PNRIO Channel Groups

The NumberOfChannels array Variable contains the number of channels of each supported type represented by the RIO Channel Group. The following table contains the relationship of array index and the channel number information stored at the respective index:

Index Content of NumberOfChannels [Index]
0Number of digital input channels
1Number of digital output channels
2Number of analog input channels
3Number of analog output channels
4Number of universal channels.

The ApplicationTag Variable contains application specific data which can be used by Clients to obtain additional semantic information. Clients can modify the content of this Variable by invoking the SetApplicationTag Method.

If no subordinated RIO Channel Objects are provided, the Channel Group level ApplicationTag Variable is the only possibility to store Client specific semantic information. Servers can support tagging on RIO Channel level by providing Channel Objects.

The <RioInputChannel> Reference links one aggregated Input Channel Object. For each aggregated Input Channel Object, one HasRioInputChannel Reference shall be part of the RioChannelGroupType Object.

The <RioOutputChannel> Reference links one aggregated Output Channel Object. For each aggregated Output Channel Object, one HasRioOutputChannel Reference shall be part of the RioChannelGroupType Object.

If provided, the ChannelGroupConfig Object contains an arbitrary subset of read-only configuration properties of the represented RIO Channel Objects.

The Server might provide diagnosis data by sending RioChannelDiagnosisEventType Events and / or RioChannelDiagnosisAlarmType Events. The diagnosis data of the RioChannelGroup Object includes the diagnosis information of all aggregated RIO Channel Objects.

The used cross-aspect ReferenceTypes 0:RepresentsSameFunctionalityAs and 0:RepresentsSameEntityAs (see below) can only exist if the Server provides the PROFINET aspect of the Information Model.

If the PROFINET aspect is provided by the Server, the RIO Channel Group Object shall be linked to the associated PN Submodule using a 0:RepresentsSameFunctionalityAs Reference. The associated submodule addresses the same IO data as the Channel Group Object provides.

The Lock Object ensures exclusive write access and Method call for one Client. The Client locks the Channel Group Object by invoking the InitLock Method of the Lock Object. The Client invokes ExitLock to release the lock.

Before invoking a Method of the Channel Group Object, Clients must gain exclusive write access (“lock” the Channel Group Object) using the Lock Object.

7.1.1.1 SetApplicationTag Method

This Method sets the Value of the ApplicationTag Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetApplicationTag (
		[in] 0:String	 ApplicationTag
		);
	
Argument Description
ApplicationTagString containing the desired content of the ApplicationTag Variable.

The Method Result Codes (defined in Call Service) are defined in Table 19.

Table 19 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe Client has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the name. The ApplicationTag string may be too long or may contain invalid characters. The server may also reject duplicates.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the SetApplicationTag Method is invoked or if configuration data provided by the subordinated RioChannelGroupConfigType Object is changed, the value of the LastParameterChange timestamp Variable shall be changed by the Server.

7.1.2 RioChannelGroupConfigType

The RioChannelGroupConfigType contains all configuration properties which are common to all RIO Channel configuration types. A Server may support an arbitrary subset of these properties. Each supported property applies to all represented channels of the RIO Channel Group.

The Server may provide only one of the PaDigitalSubstituteValue, FaDigitalSubstituteValue bit fields, as well as the PaAnalogSubstituteValue and FaAnalogSubstituteValue arrays. But these variables shall be provided only if individual RIO Channel Objects are not provided.

Table 20 – RioChannelGroupConfigType Definition
Attribute Value
BrowseNameRioChannelGroupConfigType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the 0:BaseObjectType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableInversionEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableShortCircuitCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSupplyVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableLoadVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasComponentVariablePaDigitalSubstituteValueRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
0:HasComponentVariable FaDigitalSubstituteValueRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
0:HasPropertyVariablePaAnalogSubstituteValueRioAnalogDataType[]0:PropertyTypeO, RO
0:HasPropertyVariable FaAnalogSubstituteValueRioAnalogDataType[]0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteTime0:Float0:PropertyTypeO, RO
0:HasPropertyVariableDamping0:Float0:PropertyTypeO, RO
0:HasPropertyVariableHighLimitRioAnalogDataType0:PropertyTypeO, RO
0:HasPropertyVariableLowLimitRioAnalogDataType0:PropertyTypeO, RO
Conformance Units
PNRIO Configuration

The SignalType Property contains the signal type encoded as RioSignalTypeEnumeration.

The InversionEnabled Property contains True if the digital signal is inverted in the Function Block, otherwise False.

The ShortCircuitCheckEnabled Property contains True if short circuit check is active for the channel, otherwise False.

The WireCheckEnabled Property contains True if wire check is active for the channel, otherwise False.

The SupplyVoltageCheckEnabled Property contains True if supply voltage check is active for the channel, otherwise False.

The LoadVoltageCheckEnabled Property contains True if load voltage check is active for the channel, otherwise False.

The SubstitutePolicy Property contains the substitute value setting of the channel encoded as RioSubstitutePolicyEnumeration.

The PaDigitalSubstituteValue bit field Property contains the substitute values for the Process Value of the represented digital RIOforPA channels which shall be used if a failure is detected. The usage of the substitute value depends on the actual value of the SubstitutePolicy Property.

The FaDigitalSubstituteValue bit field Property contains the substitute values for the Process Value of the represented digital RIOforFA channels which shall be used if a failure is detected. The usage of the substitute value depends on the actual value of the SubstitutePolicy Property.

If the number of RIOforFA Channels the RIO Channel Group represents exceeds the capacity of the RioBitFieldVariableType (which is 32), as many RioBitFieldVariableType Variables shall be part of the RIO Channel Group Object as are needed to represent the substitute values of all RIOforFA Channels. The BrowseNames of the RioBitFieldVariableType Variable shall be extended with a suffix ensuring uniqueness and indicating the section of the bitfield the variable represents in this case, e.g. “FaDigitalSubstituteValue_0_31”, “FaDigitalSubstituteValue _32_47”, and so on.

The optional Offset Property of the RioBitFieldVariableType Variables shall be provided in this case and contain the start of the range the RioBitFieldVariableType Variable represents. Possible Values for Offset are 0, 32, 64, and so on. The Offset Value added to the bit number shall be used as the RioChannelNumber Property Value of the corresponding RIO Channel Objects if these Objects are provided.

The PaAnalogSubstituteValue array Property contains the substitute values for the Process Value of the represented analog RIOforPA channels which shall be used if a failure is detected. The usage of the substitute value depends on the actual value of the SubstitutePolicy Property.

The FaAnalogSubstituteValue array Property contains the substitute values for the Process Value of the represented analog RIOforFA channels which shall be used if a failure is detected. The usage of the substitute value depends on the actual value of the SubstitutePolicy Property.

The bit numbers and array indexes in the range 0 to <number of Input Channels minus 1> constitute the RioChannelNumbers of the represented Input Channels. The bit numbers and array indexes in the range <number of Input Channels> to <number of Input Channels + number of Output Channels minus 1> constitute the RioChannelNumbers of the represented Output Channels.

The SubstituteTime Property contains the time in seconds from the detection of a failure to a reaction (substitute value is set for the Process Value).

The Damping Property contains the damping time (T63) in seconds applied to an analog signal in the Function Block.

The HighLimit Property contains the upper limit of an analog signal.

The LowLimit Property contains the lower limit of an analog signal.

7.1.3 RioPaAnalogChannelGroupType

The RioPaAnalogChannelGroupType aggregates RioPaAnalogInputChannelType Objects and RioPaAnalogOutputChannelType Objects.

Table 21 – RioPaAnalogChannelGroupType Definition
Attribute Value
BrowseNameRioPaAnalogChannelGroupType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelGroupType.
HasRioProcessVariableVariable InputValuesRioPaAnalogValueDataType[]0:BaseDataVariableTypeO, RO
HasRioProcessVariableVariable OutputValuesRioPaAnalogValueDataType[]0:BaseDataVariableTypeO, RO
0:HasPropertyVariableSimulationValuesRioPaAnalogValueDataType[]0:PropertyTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean[]0:BaseDataVariableTypeO, RO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Groups

The InputValues array Variable contains the Input Process Values of the Input Channels the RIO Channel Group Object represents. The InputValues Variable is linked to the associated PnIoTelegramType Object using a 0:RepresentsSameEntityAs Reference (see Figure 20).

The array indexes must be equal to the RioChannelNumber of the represented Input Channels. The RioChannelNumbers of the Input Channels shall have the value range 0 to <size of InputValues array> minus 1.

The OutputValues array Variable contains the Output Process Values of the Output Channels the RIO Channel Group Object represents. The OutputValues Variable is linked to the associated PnIoTelegramType Object using a 0:RepresentsSameEntityAs Reference.

The array indexes must be equal to the RioChannelNumber of the represented Output Channels minus <size of the InputValues array>. The RioChannelNumbers of the Output Channels shall have the value range <size of InputValues array> to <size of InputValues array + size of OutputValues array> minus 1.

The type of each array element is RioPaAnalogValueDataType which has two members: Value contains the Process Value and QualifierValue contains the status information associated with each value.

The SimulationValues array of RioPaAnalogValueDataType structures contains the values and qualifiers used as Process Value for each represented analog channel if simulation is active for the channel.

The SimulationEnabled array Variable contains True for each array element if simulation is enabled for the corresponding RIO Channel, otherwise False.

The array indexes of the SimulationValues and the SimulationEnabled arrays must be equal to the RioChannelNumber of the referenced RIO Channels.

7.1.3.1 SetSimulation Method

This Method sets the Value of array elements of the SimulationEnabled array Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean SimulationEnabled
		[in] 0:Int16 Index
		);
	
Argument Description
SimulationEnabledValue used to set the Value of one SimulationEnabled array element.
IndexIndex of array element to set. If -1, the SimulationEnabled parameter is assigned to all array elements.

The Method Result Codes (defined in Call Service) are defined in Table 22.

Table 22 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe Client has not the right to execute the Method since the Operator Role is not granted to the Client’s Session.
Bad_InvalidArgumentThe Server is not able to assign the value. Possible reason: Invalid index.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.
7.1.3.2 SetSimulationValue Method

This Method sets the Value of array elements of the SimulationValue array Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] RioAnalogDataType	Value
		[in] 0:Byte Qualifier
		[in] 0:Int16 Index
		);
	
Argument Description
ValueValue used to set the Value member of the array element.
QualifierValue used to set the Qualifier member of the array element.
IndexIndex of array element to set. If -1, the parameters are assigned to all array elements.

The Method Result Codes (defined in Call Service) are defined in Table 23.

Table 23 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe Client has not the right to execute the Method since the Operator Role is not granted to the Client’s Session
Bad_InvalidArgumentThe Server is not able to assign the values. Possible reasons: Invalid qualifier value, invalid index. The server might also reject invalid values outside the supported range.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

7.1.4 RioFaAnalogChannelGroupType

The RioFaAnalogChannelGroupType aggregates RioFaAnalogInputChannelType Objects and RioFaAnalogOutputChannelType Objects.

Table 24 – RioFaAnalogChannelGroupType Definition
Attribute Value
BrowseNameRioFaAnalogChannelGroupType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelGroupType.
HasRioProcessVariableVariable InputImageValuesRioAnalogDataType[]0:BaseDataVariableTypeO, RO
HasRioProcessVariableVariable InputImageQualifiersRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
HasRioProcessVariableVariable OutputImageValuesRioAnalogDataType[]0:BaseDataVariableTypeO, RO
HasRioProcessVariableVariable OutputImageQualifiersRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
Conformance Units
PNRIO Channel Groups

The InputImageValues array Variable contains the Input Process Values of the Input Channels the RIO Channel Group Object represents. The InputImageValues Variable is linked to the associated PnIoTelegramType Input Object using a 0:RepresentsSameEntityAs Reference.

The InputImageQualifiers RioBitFieldVariableType Variable contains a bit field representing the qualifier bits associated with each Input Process Value the RIO Channel Group Object represents. The InputImageQualifiers Variable is linked to the associated PnIoSignalType Input Object using a 0:RepresentsSameEntityAs Reference.

The OutputImageValues array Variable contains the Output Process Values of the Output Channels the RIO Channel Group Object represents. The OutputImageValues Variable is linked to the associated PnIoTelegramType Output Object using a 0:RepresentsSameEntityAs Reference.

The OutputImageQualifiers RioBitFieldVariableType Variable contains a bit field representing the qualifier bits associated with each Output Process Value the RIO Channel Group Object represents. The OutputImageQualifiers Variable is linked to the associated PnIoSignalType Input Object using a 0:RepresentsSameEntityAs Reference.

The array index is used as the unambiguous assignment of qualifier bit and value. The array indexes and the bit numbers of the InputImageValues array and the InputImageQualifiers bit field must be equal to the RioChannelNumber Property Values of the corresponding RIO Channel Objects. The OutputImageValues array indexes and OutputImageQualifiers bit numbers must be mapped to the value range of the RioChannelNumbers of the referenced Output Channels by adding the size of the InputImageValues array.

The RioChannelNumbers of the Input Channels shall have the value range 0 to <size of InputImageValues array> minus 1. The RioChannelNumbers of the Output Channels shall have the value range <size of InputImageValues array> to <size of InputImageValues array + size of OutputImageValues array> minus 1.

If the number of RIO Channels the RIO Channel Group represents exceeds the capacity of the RioBitFieldVariableType (which is 32), as many RioBitFieldVariableType Variables shall be part of the RIO Channel Group Object as are needed to represent the qualifiers of all RIO Channels.

The BrowseNames of the RioBitFieldVariableType Variables shall be extended with a suffix ensuring uniqueness and indicating the section of the bitfield the variable represents in this case, e.g. “_0_31”, “_32_47”, and so on.

The optional Offset Property of the RioBitFieldVariableType shall be provided in this case and contain the start of the range the RioBitFieldVariableType Variable represents. Possible Values for Offset are 0, 32, 64, and so on. The Offset Value added to the bit number is equal to the array index of the corresponding Process Value. For bit fields representing Output Channels the array index must be mapped to the value range of the RioChannelNumbers of the referenced Output Channels by adding the number of Input Channels (see above).

7.1.5 RioPaDigitalChannelGroupType

The RioPaDigitalChannelGroupType aggregates RioPaDigitalInputChannelType Objects and RioPaDigitalOutputChannelType Objects.

Table 25 – RioPaDigitalChannelGroupType Definition
Attribute Value
BrowseNameRioPaDigitalChannelGroupType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelGroupType.
HasRioProcessVariableVariable InputImageRioPaDigitalValueDataType[]0:BaseDataVariableTypeO, RO
HasRioProcessVariableVariable OutputImageRioPaDigitalValueDataType []0:BaseDataVariableTypeO, RO
0:HasPropertyVariableSimulationValuesRioPaDigitalValueDataType[]0:PropertyTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean[]0:BaseDataVariableTypeO, RO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Groups

The InputImage array Variable contains the Input Process Values of the Input Channels the RIO Channel Group Object represents. The InputImage Variable is linked to the associated PnIoTelegramType Input Object using a 0:RepresentsSameEntityAs Reference.

The array indexes must be equal to the RioChannelNumbers of the represented Input Channels. The RioChannelNumbers of the Input Channels shall have the value range 0 to <size of InputImage array> minus 1.

The OutputImage array Variable contains the Output Process Values of the Output Channels the RIO Channel Group Object represents. The OutputImage Variable is linked to the associated PnIoTelegramType Output Object using a 0:RepresentsSameEntityAs Reference (See Figure 21).

The array indexes must be equal to the RioChannelNumbers of the represented Output Channels minus <size of the InputImage array>. The RioChannelNumbers of the Output Channels shall have the value range <size of InputImage array> to <size of InputImage array + size of OutputImage array> minus 1.

The type of each array element is RioPaDigitalValueDataType which has two members: Value contains the Process Value and QualifierValue contains the status information associated with each value.

The SimulationValues array of RioPaDigitalValueDataType structures contains the values and qualifiers used as Process Value for each represented digital channel if simulation is active for the channel.

The SimulationEnabled array Variable contains True for each array element if simulation is enabled for the corresponding RIO Channel, otherwise False.

The array indexes of the SimulationValues and the SimulationEnabled arrays must be equal to the RioChannelNumber of the referenced RIO Channels.

7.1.5.1 SetSimulation Method

This Method sets the Value of array elements of the SimulationEnabled array Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean SimulationEnabled
		[in] 0:Int16 Index
		);
	
Argument Description
SimulationEnabledValue used to set the Value of one SimulationEnabled array element.
IndexIndex of array element to set. If -1, the SimulationEnabled parameter is assigned to all array elements.

The Method Result Codes (defined in Call Service) are defined in Table 26.

Table 26 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe Client has not the right to execute the Method since the Operator Role is not granted to the Client’s Session.
Bad_InvalidArgumentThe Server is not able to assign the value. Possible reason: Invalid index.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.
7.1.5.2 SetSimulationValue Method

This Method sets the Value of array elements of the SimulationValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] 0:Boolean Value
		[in] 0:Byte Qualifier
		[in] 0:Int16 Index
		);
	
Argument Description
ValueValue used to set the Value member of the array element.
QualifierValue used to set the Qualifier member of the array element.
IndexIndex of array element to set. If -1, the parameters are assigned to all array elements.

The Method Result Codes (defined in Call Service) are defined in Table 27.

Table 27 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe Client has not the right to execute the Method since the Operator Role is not granted to the Client’s Session
Bad_InvalidArgumentThe Server is not able to assign the values. Possible reasons: Invalid qualifier value, invalid index.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

7.1.6 RioFaDigitalChannelGroupType

The RioFaDigitalChannelGroupType aggregates RioFaDigitalInputChannelType Objects and RioFaDigitalOutputChannelType Objects. Alternatively, the server can omit the channel objects and provide Input- and Output image Variables only.

Table 28 – RioFaDigitalChannelGroupType Definition
Attribute Value
BrowseNameRioFaDigitalChannelGroupType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelGroupType.
HasRioProcessVariableVariable InputImageRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
HasRioProcessVariableVariable InputImageQualifiersRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
HasRioProcessVariableVariable OutputImageRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
HasRioProcessVariableVariable OutputImageQualifiersRioBitFieldDataTypeRioBitFieldVariableTypeO, RO
Conformance Units
PNRIO Channel Groups

The InputImage Variable contains a bit field. The bit field contains the copy of one Input Telegram’s memory image associated with one PnIoSignalType Object. The InputImage Variable is linked to the associated PnIoSignalType Object using a 0:RepresentsSameEntityAs Reference.

The InputImageQualifiers Variable contains a bit field containing the qualifier bits for each bit in the InputImage Variable. The InputImageQualifier Variable is linked to the associated PnIoSignalType Object using a 0:RepresentsSameEntityAs Reference.

The bit numbers must be equal to the RioChannelNumber of the represented Input Channels. The RioChannelNumbers of the Input Channels shall have the value range 0 to <number of Input Channels> minus 1.

The OutputImage Variable contains a bit field. The bit field contains the copy of one Output Telegram’s memory image associated with one PnIoSignalType Object. The OutputImage Variable is linked to the associated PnIoSignalType Object using a 0:RepresentsSameEntityAs Reference.

The OutputImageQualifiers Variable contains a bit field containing the qualifier bits for each bit in the OutputImage Variable. The OutputImageQualifier Variable is linked to the associated PnIoSignalType Object using a 0:RepresentsSameEntityAs Reference.

The bit numbers must be equal to the RioChannelNumber of the represented Output Channels minus the number of Input Channels. The RioChannelNumbers of the Output Channels shall have the value range <number of Input Channels> to <number of Input Channels + number of Output Channels > minus 1.

If the number of RIO Channels the RIO Channel Group represents exceeds the capacity of the RioBitFieldVariableType (which is 32), as many RioBitFieldVariableType Variables shall be part of the RIO Channel Group Object as are needed to represent the qualifiers of all RIO Channels.

The BrowseNames of the RioBitFieldVariableType Variables shall be extended with a suffix ensuring uniqueness and indicating the section of the bitfield the variable represents in this case, e.g. “_0_31”, “_32_47”, and so on.

The optional Offset Property of the RioBitFieldVariableType Variables shall be provided in this case and contain the start of the range the RioBitFieldVariableType Variable represents. Possible Values for Offset are 0, 32, 64, and so on. The Offset Value added to the bit number shall be used as the RioChannelNumber of the corresponding RIO Channels. For bit fields representing Output Channels the number of Input Channels must be added also to obtain the RioChannelNumber of the represented Output Channel (see above).

7.2 OPC UA for RIO Channel Types

There are different RIO Channel types defined for each profile for digital and analog Input as well as for digital and analog Output. Table 29 lists the RIO Channel types defined in this specification for the Common Application Profiles RIOforPA and RIOforFA. All RIO Channel types are subtypes of the RioChannelType defined in chapter 7.2.1.

Table 29 – RIO Channel Types
Profile Input Channels
Digital Analog
RIOforPA RioPaDigitalInputChannelType RioPaAnalogInputChannelType
RIOforFA RioFaDigitalInputChannelType RioFaAnalogInputChannelType
Output Channels
Digital Analog
RIOforPA RioPaDigitalOutputChannelType RioPaAnalogOutputChannelType
RIOforFA RioFaDigitalOutputChannelType RioFaAnalogOutputChannelType

7.2.1 RioChannelType

The RioChannelType is the base type for all RIO-channel types. The type shall not be used directly. Instead, only the subtypes shall be instantiated.

Table 30 – RioChannelType Definition
Attribute Value
BrowseNameRioChannelType
IsAbstractTrue
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseObjectType defined in OPC 10000-5.
0:HasPropertyVariableRioChannelNumber0:UInt160:PropertyTypeM, RO
0:HasPropertyVariableApplicationTag0:String0:PropertyTypeM, RO
0:HasComponentMethodSetApplicationTagO
0:HasPropertyVariable LastParameterChange0:DateTime0:PropertyTypeO, RO
0:HasComponentObjectLock2:LockingServicesTypeO
0:GeneratesEventObjectTypeRioChannelDiagnosisEventType
0:GeneratesEventObjectTypeRioChannelDiagnosisAlarmType
Conformance Units
PNRIO Channel Objects

The RioChannelNumber Property shall contain a unique channel number. Uniqueness shall be guaranteed for all RIO Channel Objects aggregated by a RIO Channel Group. The value range used for the RioChannelNumber Property Values shall be continuous and start with 0.

The ApplicationTag Variable contains information determined by configuration or by applications. The Client can change the content by invoking the SetApplicationTag Method.

7.2.1.1 SetApplicationTag Method

This Method sets the Value of the ApplicationTag Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetApplicationTag (
		[in] 0:String	 ApplicationTag
		);
	
Argument Description
ApplicationTagString containing the desired content of the ApplicationTag Variable.

The Method Result Codes (defined in Call Service) are defined in Table 31.

Table 31 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the name. The ApplicationTag string may be too long or may contain invalid characters. The server may also reject duplicates.
Bad_UnexpectedErrorThe server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

The Server might provide diagnosis data by sending RioChannelDiagnosisEventType Events and / or RioChannelDiagnosisAlarmType Events. The diagnosis data of the RioChannelGroup Object includes the diagnosis information of all aggregated RIO Channel Objects.

If the SetApplicationTag Method is invoked or if parameterization data provided by the subordinated RioChannelGroupConfigType Object is changed, the value of the LastParameterChange timestamp Variable shall be changed by the Server. This includes the EngineeringUnits and EURange Properties of Process Value Variables and any change of configuration data provided by the “Config” Objects.

The Lock Object ensures exclusive Method call for one Client. The Client locks the channel Object by invoking the InitLock Method of the Lock Object. The Client invokes ExitLock to release the lock.

Before invoking a Method of the channel Object, Clients must gain exclusive access (“lock” the channel Object) using the Lock Object.

7.2.2 Analog Input Channel Types

Figure 22 shows the block diagram for an analog Input Channel.

Figure 22 – Analog RIO Input Channel Block Diagram
7.2.2.1 RioPaAnalogInputChannelType

The RioPaAnalogInputChannelType provides access to the data of an analog Rio Input Channel according to RIOforPA.

Table 32 – RioPaAnalogInputChannelType
Attribute Value
BrowseNameRioPaAnalogInputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioPaAnalogProcessValueDataTypeRioPaAnalogProcessValueVariableTypeM, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableModeRioChannelModeEnumeration0:BaseDataVariableTypeM, RO
0:HasComponentVariable ManualProcessValueRioAnalogDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean0:BaseDataVariableTypeM, RO
0:HasComponentVariableSimulationValueRioPaAnalogValueDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableConfigRioPaAnalogInputConfigDataTypeRioPaAnalogInputConfigVariableTypeM, RO
0:HasComponentMethodSetModeO
0:HasComponentMethodSetManualProcessValueO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the current analog Input value for usage by a Controller.

The SignalValue Variable contains the input signal value obtained by reading the input signal through the signal coupling in the Transducer.

The Mode Variable contains the current mode of operation encoded as RioChannelModeEnumeration. If Mode has the Value MANUAL, the Value of the ManualProcessValue Variable shall be used as Process Value.

The ManualProcessValue Variable contains the value used as Process Value if the Mode Variable of the channel contains the Value MANUAL. The optional Variable is used for Devices according to the PA V3 profile and maps to the “manual out value” property defined by this profile.

The SimulationEnabled Variable contains True if the Value of the SimulationValue Variable shall be used as Process Value, otherwise False.

The SimulationValue Variable contains the value used as Process Value if the SimulationEnabled Variable contains the Value True.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioPaAnalogInputConfigVariableType (see chapter 9.4.5).

7.2.2.2 SetMode Method

This Method sets the Value of the Mode Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetMode (
		[in] RioChannelModeEnumeration	 Mode
		);
	
Argument Description
ModeDesired content of the Mode Variable.

The Method Result Codes (defined in Call Service) are defined in Table 33.

Table 33 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is currently not able to perform the demanded mode change.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the Mode Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.2.3 SetManualProcessValue Method

This Method sets the Value of the ManualProcessValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetManualProcessValue (
		[in] RioAnalogDataType		ManualProcessValue
		);
	
Argument Description
ManualProcessValueDesired Value of the ManualProcessValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 34.

Table 34 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value. For instance, the Server might reject manual values not within the channels value bounds.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the ManualProcessValue Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.2.4 SetSimulation Method

This Method sets the Value of the SimulationEnabled Variable to the desired value. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean 	SimulationEnabled
	);
	
Argument Description
SimulationEnabledDesired content of the SimulationEnabled Variable.

The Method Result Codes (defined in Call Service) are defined in Table 35.

Table 35 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is not able to change into target mode.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the SimulationEnabled Variable already has the Value of the argument, the Method shall do nothing and return Good as result code.

7.2.2.5 SetSimulationValue Method

This Method sets the Value of the SimulationValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] RioAnalogDataType		Value
		[in] 0:Byte		Qualifier
		);
	
Argument Description
ValueDesired content of the Value struct member of the SimulationValue Variable.
QualifierDesired content of the Qualifier struct member of the SimulationValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 36.

Table 36 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value. For instance, the Server might reject simulation values not within the channels value bounds.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.
7.2.2.6 RioFaAnalogInputChannelType

The RioFaAnalogInputChannelType provides access to the data of an analog RIO Input Channel according to RIOforFA.

Table 37 – RioFaAnalogInputChannelType
Attribute Value
BrowseNameRioFaAnalogInputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioFaAnalogProcessValueDataTypeRioFaAnalogProcessValueVariableTypeM, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableConfigRioFaAnalogInputConfigDataTypeRioFaAnalogInputConfigVariableTypeM, RO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the current analog Input value for usage by a Controller.

The SignalValue Variable contains the input signal value obtained by reading the input signal through the signal coupling in the Transducer.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioFaAnalogInputConfigVariableType (see chapter 9.4.6).

7.2.3 Analog Output Channel Types

Figure 23 shows the block diagram for an analog Output Channel.

Figure 23 – Analog RIO Output Channel Block Diagram
7.2.3.1 RioPaAnalogOutputChannelType

The RioPaAnalogOutputChannelType provides access to the data of an analog RIO Output Channel according to RIOforPA.

Table 38 – RioPaAnalogOutputChannelType
Attribute Value
BrowseNameRioPaAnalogOutputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioPaAnalogProcessValueDataTypeRioPaAnalogProcessValueVariableTypeM, RO
0:HasComponentVariableProcessValueReadbackRioPaAnalogProcessValueDataTypeRioPaAnalogProcessValueVariableTypeO, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableSignalValueReadback0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableModeRioChannelModeEnumeration0:BaseDataVariableTypeM, RO
0:HasComponentVariable ManualOutValueRioAnalogDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean0:BaseDataVariableTypeM, RO
0:HasComponentVariableSimulationValueRioPaAnalogValueDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableConfigRioPaAnalogOutputConfigDataTypeRioPaAnalogOutputConfigVariableTypeM, RO
0:HasComponentMethodSetModeO
0:HasComponentMethodSetManualOutValueO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the current analog Output value for an automated process.

The ProcessValueReadback Variable contains the readback value obtained by reading the output signal back through the Transducer and the Function Block.

The SignalValue Variable contains the output signal value fed to the signal coupling in the Transducer.

The SignalValueReadback Variable contains the output signal read back through the signal coupling in the Transducer.

The Mode Variable contains the current mode of operation encoded as RioChannelModeEnumeration. If Mode has the Value MANUAL, the Value of the ManualOutValue Variable shall be used as Output value in place of the Process Value.

The ManualOutValue Variable contains the value used as Output value to an automated process in place of the Process Value if the Mode Variable of the channel contains the Value MANUAL.

The SimulationEnabled Variable contains True if the Value of the SimulationValue Variable shall be used as Output value in place of the Process Value, otherwise False.

The SimulationValue Variable contains the value used as Output value in place of the Process Value if the SimulationEnabled Variable contains True.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioPaAnalogOutputConfigVariableType (See chapter 9.4.7).

7.2.3.2 SetMode Method

This Method sets the Value of the Mode Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetMode (
		[in] RioChannelModeEnumeration	Mode	
		);
	
Argument Description
ModeDesired content of the Mode Variable.

The Method Result Codes (defined in Call Service) are defined in Table 39.

Table 39 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is currently not able to perform the demanded mode change.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the Mode Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.3.3 SetManualOutValue Method

This Method sets the Value of the ManualOutValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetManualOutValue (
		[in] RioAnalogDataType		ManualOutValue
		);
	
Argument Description
ManualOutValueDesired Value of the ManualOutValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 40.

Table 40 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value. For instance, the Server might reject manual values not within the channels value bounds.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the ManualOutValue Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.3.4 SetSimulation Method

This Method sets the Value of the SimulationEnabled Variable to the desired value. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean	SimulationEnabled
	);
	
Argument Description
SimulationEnabledDesired content of the SimulationEnabled Variable.

The Method Result Codes (defined in Call Service) are defined in Table 41.

Table 41 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is not able to change into target mode.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the SimulationEnabled Variable already has the value of the argument, the Method shall do nothing and return Good as result code.

7.2.3.5 SetSimulationValue Method

This Method sets the Value of the SimulationValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] 0:RioAnalogDataType	Value
		[in] 0:Byte		Qualifier
		);
	
Argument Description
ValueDesired content of the Value member of the SimulationValue Variable.
QualifierDesired content of the Qualifier member of the SimulationValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 42.

Table 42 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value. For instance, the Server might reject simulation values not within the channels value bounds.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.
7.2.3.6 RioFaAnalogOutputChannelType

The RioFaAnalogOutputChannelType provides access to the data of an analog RIO Output Channel according to RIOforFA.

Table 43 – RioFaAnalogOutputChannelType
Attribute Value
BrowseNameRioFaAnalogOutputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioFaAnalogProcessValueDataTypeRioFaAnalogProcessValueVariableTypeM, RO
0:HasComponentVariableProcessValueReadbackRioFaAnalogProcessValueDataTypeRioFaAnalogProcessValueVariableTypeO, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableSignalValueReadback0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableConfigRioFaAnalogOutputConfigDataTypeRioFaAnalogOutputConfigVariableTypeM, RO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the current analog Output value for an automated process.

The ProcessValueReadback Variable contains the readback value obtained by reading the output signal back through the Transducer and the Function Block.

The SignalValue Variable contains the output signal value fed to the signal coupling in the Transducer.

The SignalValueReadback Variable contains the output signal read back through the signal coupling in the Transducer.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioFaAnalogOutputConfigVariableType (see chapter 9.4.8).

7.2.4 Digital Input Channel Types

Figure 24 shows the block diagram for a digital Input Channel.

Figure 24 – Digital RIO Input Channel Block Diagram
7.2.4.1 RioPaDigitalInputChannelType

The RioPaDigitalInputChannelType provides access to the data of a discrete RIO Input Channel according to RIOforPA.

Table 44 – RioPaDigitalInputChannelType
Attribute Value
BrowseNameRioPaDigitalInputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioPaDigitalProcessValueDataTypeRioPaDigitalProcessValueVariableTypeM, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableModeRioChannelModeEnumeration0:BaseDataVariableTypeM, RO
0:HasComponentVariable ManualProcessValue0:Boolean0:BaseDataVariableTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean0:BaseDataVariableTypeM, RO
0:HasComponentVariableSimulationValueRioPaDigitalValueDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableConfigRioPaDigitalInputConfigDataTypeRioPaDigitalInputConfigVariableTypeM, RO
0:HasComponentMethodSetModeO
0:HasComponentMethodSetManualProcessValueO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the digital Input value for a Controller.

The SignalValue Variable contains the input signal value obtained by reading the input signal through the signal coupling in the Transducer.

The Mode Variable contains the current mode of operation encoded as RioChannelModeEnumeration. If Mode has the Value MANUAL, the Value of the ManualProcessValue Variable shall be used as Process Value.

The ManualProcessValue Variable contains the value used as Process Value if the Mode Variable of the channel contains the Value MANUAL. The optional Variable is used for Devices according to the PA V3 profile and maps to the “manual out value” property defined by this profile.

The SimulationEnabled Variable contains True if the Value of the SimulationValue Variable shall be used as Process Value, otherwise False.

The SimulationValue Variable contains the value used as Process Value if the SimulationEnabled Variable contains the Value True.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioPaDigitalInputConfigVariableType (See 9.4.1)

7.2.4.2 SetMode Method

This Method sets the Value of the Mode Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetMode (
		[in] RioChannelModeEnumeration	Mode	
		);
	
Argument Description
ModeDesired content of the Mode Variable.

The Method Result Codes (defined in Call Service) are defined in Table 45.

Table 45 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is currently not able to perform the demanded mode change.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the Mode Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.4.3 SetManualProcessValue Method

This Method sets the Value of the ManualProcessValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetManualProcessValue (
		[in] 0:Boolean		ManualProcessValue
		);
	
Argument Description
ManualProcessValueDesired Value of the ManualProcessValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 46.

Table 46 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the ManualProcessValue Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.4.4 SetSimulation Method

This Method sets the Value of the SimulationEnabled Variable to the desired value. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean	SimulationEnabled
	);
	
Argument Description
SimulationEnabledDesired content of the SimulationEnabled Variable.

The Method Result Codes (defined in Call Service) are defined in Table 47.

Table 47 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is not able to change into target mode.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the SimulationEnabled Variable already has the value of the argument, the Method shall do nothing and return Good as result code.

7.2.4.5 SetSimulationValue Method

This Method sets the Value of the SimulationValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] 0:Boolean	Value
		[in] 0:Byte		Qualifier
		);
	
Argument Description
ValueDesired content of the Value member of the SimulationValue Variable.
QualifierDesired content of the Qualifier member of the SimulationValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 48.

Table 48 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.
7.2.4.6 RioFaDigitalInputChannelType

The RioFaDigitalInputChannelType provides access to the data of a discrete RIO Input Channel according to RIOforFA.

Table 49 – RioFaDigitalInputChannelType
Attribute Value
BrowseNameRioFaDigitalInputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioFaDigitalProcessValueDataTypeRioFaDigitalProcessValueVariableTypeM, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableConfigRioFaDigitalInputConfigDataTypeRioFaDigitalInputConfigVariableTypeM, RO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the digital Input value for a Controller.

The SignalValue Variable contains the input signal value obtained by reading the input signal through the signal coupling in the Transducer.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioFaDigitalInputConfigVariableType (see chapter 9.4.2).

7.2.5 Digital Output Channel Types

Figure 25 shows the block diagram for a digital Output Channel.

Figure 25 – Digital RIO Output Channel Block Diagram
7.2.5.1 RioPaDigitalOutputChannelType

The RioPaDigitalOutputChannelType provides access to the data of a discrete RIO Output Channel according to RIOforPA.

Table 50 – RioPaDigitalOutputChannelType
Attribute Value
BrowseNameRioPaDigitalOutputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioPaDigitalProcessValueDataTypeRioPaDigitalProcessValueVariableTypeM, RO
0:HasComponentVariableProcessValueReadbackRioPaDigitalProcessValueDataTypeRioPaDigitalProcessValueVariableTypeO, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableSignalValueReadback0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableModeRioChannelModeEnumeration0:BaseDataVariableTypeM, RO
0:HasComponentVariable ManualOutValue0:Boolean0:BaseDataVariableTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean0:BaseDataVariableTypeM, RO
0:HasComponentVariableSimulationValueRioPaDigitalValueDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableConfigRioPaDigitalOutputConfigDataTypeRioPaDigitalOutputConfigVariableTypeM, RO
0:HasComponentMethodSetModeO
0:HasComponentMethodSetManualOutValueO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains a Controller’s output data to an automated process.

The ProcessValueReadback Variable contains the readback value obtained by reading the output signal back through the Transducer and the Function Block.

The SignalValue Variable contains the output signal value fed to the signal coupling in the Transducer.

The SignalValueReadback Variable contains the output signal read back through the signal coupling in the Transducer.

The Mode Variable contains the current mode of operation encoded as RioChannelModeEnumeration. If Mode has the Value MANUAL, the Value of the ManualOutValue Variable shall be used as Output value in place of the Process Value.

The ManualOutValue Variable contains the value used as Output value to an automated process in place of the Process Value if the Mode Variable of the channel contains the Value MANUAL.

The SimulationEnabled Variable contains True if the Value of the SimulationValue Variable shall be used as Process Value, otherwise False.

The SimulationValue Variable contains the value used as Output value in place of the Process Value if the SimulationEnabled Variable contains True.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioPaDigitalOutputConfigVariableType (see chapter 9.4.3)

7.2.5.2 SetMode Method

This Method sets the Value of the Mode Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetMode (
		[in] RioChannelModeEnumeration	Mode	
		);
	
Argument Description
ModeDesired content of the Mode Variable.

The Method Result Codes (defined in Call Service) are defined in Table 51.

Table 51 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is currently not able to perform the demanded mode change.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the Mode Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.5.3 SetManualOutValue Method

This Method sets the Value of the ManualOutValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetManualOutValue (
		[in] 0:Boolean	ManualOutValue
		);
	
Argument Description
ManualOutValueDesired Value of the ManualOutValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 52.

Table 52 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the ManualOutValue Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.5.4 SetSimulation Method

This Method sets the Value of the SimulationEnabled Variable to the desired value. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean	SimulationEnabled
	);
	
Argument Description
SimulationEnabledDesired content of the SimulationEnabled Variable.

The Method Result Codes (defined in Call Service) are defined in Table 53.

Table 53 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is not able to change into target mode.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.

If the SimulationEnabled Variable already has the Value of the argument, the Method shall do nothing and return Good as result code.

7.2.5.5 SetSimulationValue Method

This Method sets the Value of the SimulationValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] 0:Boolean	Value
		[in] 0:Byte		Qualifier
		);
	
Argument Description
ValueDesired content of the Value member of the SimulationValue Variable.
QualifierDesired content of the Qualifier member of the SimulationValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 54.

Table 54 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value.
Bad_UnexpectedErrorThe Server is not able to execute the function because an unexpected error occurred. The Device might be temporarily unavailable or unreachable due to network failure.
7.2.5.6 RioFaDigitalOutputChannelType

The RioFaDigitalOutputChannelType provides access to the data of a discrete RIO Output Channel according to RIOforFA.

Table 55 – RioFaDigitalOutputChannelType
Attribute Value
BrowseNameRioFaDigitalOutputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioFaDigitalProcessValueDataTypeRioFaDigitalProcessValueVariableTypeM, RO
0:HasComponentVariableProcessValueReadbackRioFaDigitalProcessValueDataTypeRioFaDigitalProcessValueVariableTypeO, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableSignalValueReadback0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableConfigRioFaDigitalOutputConfigDataTypeRioFaDigitalOutputConfigVariableTypeM, RO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains a Controller’s output data to an automated process.

The ProcessValueReadback Variable contains the readback value obtained by reading the output signal back through the Transducer and the Function Block.

The SignalValue Variable contains the output signal value fed to the signal coupling in the Transducer.

The SignalValueReadback Variable contains the output signal read back through the signal coupling in the Transducer.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioFaDigitalOutputConfigVariableType (see chapter 9.4.4)

7.3 OPC UA for RIO Cyclic IO Types

7.3.1 PnTelegramType

The PnTelegramType represents a Telegram. The PnTelegramType can at least have one Input Telegram, one Output Telegram or both.

Table 56 – PnTelegramType Definition
Attribute Value
BrowseNamePnTelegramType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseObjectType defined in OPC 10000-5.
0:HasComponentObjectInputPnIoTelegramTypeO
0:HasComponentObjectOutputPnIoTelegramTypeO
Conformance Units
PNRIO Cyclic Telegrams

.

The Input Object shall contain the Input component of the Telegram.

The Output Object shall contain the Output component of the Telegram.

7.3.2 PnIoTelegramType

The PnIoTelegramType represents an Input Telegram as well as an Output Telegram and associated status information.

Table 57 – PnIoTelegramType Definition
Attribute Value
BrowseNamePnIoTelegramType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseObjectType defined in OPC 10000-5.
0:HasComponentObject<Nr_SignalName>PnIoSignalTypeMP
0:HasPropertyVariable IoTelegramImage0:ByteString0:PropertyTypeO, RO
0:HasPropertyVariableLength0:UInt160:PropertyTypeM, RO
0:HasPropertyVariableProviderStatusPnIoTelegramStatusEnumeration0:PropertyTypeM, RO
0:HasPropertyVariableConsumerStatusPnIoTelegramStatusEnumeration0:PropertyTypeO, RO
Conformance Units
PNRIO Cyclic Telegrams

The <Nr_SignalName> Object references one Signal associated with an Input- or an Output Telegram (IO Telegram). <Nr> shall reflect the order of the Signal in the IO Telegram, consistent with the Offset property of the PnIoSignalType Object.

There shall exist as many References to as many Signal Objects as are needed to map the content of the IO Telegram.

The IoTelegramImage Property shall contain an octet string representation of the IO Telegram. If consistency of the content cannot be guaranteed, the IoTelegramImage Property shall not be provided.

The Length Variable contains the length (the number of bytes) of the IO Telegram.

The ProviderStatus Variable contains the data provider’s Qualifier for the IO Telegram (IOPS according to [PN Service]) encoded as PnIoTelegramStatusEnumeration.

The ConsumerStatus Variable contains the data consumer’s Qualifier for the IO Telegram (IOCS according to [PN Service] is not relevant for RIOforFA, therefore ConsumerStatus is optional) encoded as PnIoTelegramStatusEnumeration.

7.3.3 PnIoSignalType

The PnIoSignalType gives access to the Variables containing the data of one Signal.

Table 58 – PnIoSignalType Definition
Attribute Value
BrowseNamePnIoSignalType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the 0:BaseObjectType defined in OPC 10000-5.
0:HasPropertyVariableSignalId0:UInt160:PropertyTypeO, RO
0:HasPropertyVariableOffset0:UInt160:PropertyTypeM, RO
Conformance Units
PNRIO Cyclic Telegrams

The SignalId Variable contains an optional unique identifier for the IO signal.

The Offset Variable contains the number of the first byte of the IO data in the IO Telegram. The numbering shall start with 0.

A Signal Object shall only be provided if it relates to the functional aspect using a 0:RepresentsSameEntityAs Reference.

8 OPC UA EventTypes

The OPC UA for RIO EventTypes are used for Rio Channel and Rio Channel Group related diagnosis events. OPC UA for RIO supports limited diagnosis information as defined in RIO FA and RIO PA which is not a subset of diagnosis information defined by PROFINET. Extensive channel related diagnosis information is available via the submodule the affected channel belongs to in the PROFINET aspect of the Information Model (see OPC PN).

Both EventTypes defined in the following sections inherit the Severity Property from 0:BaseEventType. Servers shall provide a Value in the range of 1 to 1000, where 1 indicates a mere informational Event, whereas 1000 indicates Events with potentially catastrophic consequences (OPC 10000-5, section 6.4.2). Therefore, this Property shall have a Value which fits in the 4 categories shown in the following table:

Category Severity Range
Fault750 – 1000
Maintenance demanded500 – 749
Maintenance required250 – 499
Advise2 – 249

8.1 RioChannelDiagnosisAlarmType

The RioChannelDiagnosisAlarmType is a subtype of 0:AlarmConditionType adding, among other states, an Active state to a Condition. In contrast to EventTypes derived from 0:BaseEventType, Alarm and Condition Types offer an Alarm state machine model enabling the implementation of an Alarm timeline (see OPC 10000-9).

Table 59 – RioChannelDiagnosisAlarmType Definition
Attribute Value
BrowseNameRioChannelDiagnosisAlarmType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of 0:AlarmConditionType defined in [OPC 10000-9].
0:HasPropertyVariableRioChannelNumber0:UInt160:PropertyTypeM, RO
0:HasPropertyVariable PnChannelNumber0:UInt320:PropertyTypeO, RO
0:HasPropertyVariable Status RioChannelDiagnosisStatusEnumeration0:PropertyTypeM, RO
0:HasPropertyVariable ReasonRioChannelDiagnosisReasonEnumeration0:PropertyTypeM, RO
0:HasPropertyVariable ApplicationTag0:String0:PropertyTypeO, RO
0:HasPropertyVariableManufacturerData0:ByteString0:PropertyTypeO, RO
0:HasPropertyVariableHelpText0:LocalizedText0:PropertyTypeO, RO
Conformance Units
PNRIO Alarms

The RioChannelNumber Property contains the Value of the RioChannelNumber Property of the RioChannelType Object which is the Alarm source.

The PnChannelNumber Property contains the PROFINET channel number which has a value range 0 to 0x7FFF (see [PN Service]). The PROFINET channel number shall be provided only if differing from the RIO Channel number.

The Status Property contains information about the status of the channel as defined in RIO FA section 7.1 table 6 and RIO PA section 7.6.1 tables 7-24 and 7-25. The status information is encoded as RioChannelDiagnosisStatusEnumeration (see section 10.4.8).

The Reason Property contains information about the persistence of the status indicated with the Status Property encoded as RioChannelDiagnosisReasonEnumeration (see section 10.4.9)

The ApplicationTag Property contains the Value of the ApplicationTag Property of the RioChannelType object which is the Alarm source.

The ManufacturerData Property contains manufacturer specific diagnosis information.

The HelpText Property shall contain a brief error description for the reason of the Alarm.

8.2 RioChannelDiagnosisEventType

The RioChannelDiagnosisEventType is a subtype of 0:BaseEventType. The Server may support durable mode for Subscriptions (see section 12.1). MonitoredItem data are delivered and event queues are stored if a Client was disconnected for a longer time or the Server was restarted if the Client has set the Subscription into durable mode (See OPC 10000-5 section 9.3).

Table 60 – RioChannelDiagnosisEventType Definition
Attribute Value
BrowseNameRioChannelDiagnosisEventType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of BaseEventType defined in [OPC 10000-5].
0:HasPropertyVariableRioChannelNumber0:UInt160:PropertyTypeM, RO
0:HasPropertyVariable PnChannelNumber0:UInt320:PropertyTypeO, RO
0:HasPropertyVariable Status RioChannelDiagnosisStatusEnumeration0:PropertyTypeM, RO
0:HasPropertyVariable ReasonRioChannelDiagnosisReasonEnumeration0:PropertyTypeM, RO
0:HasPropertyVariable ApplicationTag0:String0:PropertyTypeO, RO
0:HasPropertyVariableManufacturerData0:ByteString0:PropertyTypeO, RO
0:HasPropertyVariableHelpText0:LocalizedText0:PropertyTypeO, RO
Conformance Units
PNRIO Events

The RioChannelNumber Property contains the Value of the RioChannelNumber Property of the RioChannelType object which is the Event source.

The PnChannelNumber Property contains the PROFINET channel number which has a value range 0 to 0x7FFF (see [PN Service]). The PROFINET channel number shall be provided only if differing from the RIO Channel number.

The Status Property contains information about the status of the cannel as defined in RIO FA section 7.1 table 6 and RIO PA section 7.6.1 tables 7-24 and 7-25. The status information is encoded as RioChannelDiagnosisStatusEnumeration (see section 10.4.8).

The Reason Property contains information about the persistence of the status indicated with the Status Property encoded as RioChannelDiagnosisReasonEnumeration (see section 10.4.9)

The ApplicationTag Property contains the Value of the ApplicationTag Property of the RioChannelType object which is the Event source.

The ManufacturerData Property contains manufacturer specific diagnosis information.

The HelpText Property shall contain a brief error description for the reason of the Event.

9 OPC UA VariableTypes

9.1 RioBitFieldVariableType

The RioBitFieldVariableType contains a bit field used to store qualifier information as well as digital values for RIOforFA Channel Groups. The bit field is represented by the RioBitFieldDataType structure.

Table 61 – RioBitFieldVariableType Definition
Attribute Value
BrowseNameRioBitFieldVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioBitFieldDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the 0:BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableOffset0:UInt160:PropertyTypeO, RO
Conformance Units
PNRIO Process Variables

The Offset Property contains the start position of the range the bit field represents.

9.2 Process Value VariableTypes

Table 62 lists the Process Value VariableTypes and their DataTypes defined for RIOforPA and RIOforFA. There are different VariableTypes together with their DataTypes defined for each profile for digital and analog Process Values.

Table 62 – RIO Process Value VariableTypes and DataTypes
Profile Digital Channel Types
Process Value VariableType DataType
RIOforPA RioPaDigitalProcessValueVariableType RioPaDigitalProcessValueDataType
RIOforFA RioFaDigitalProcessValueVariableType RioFaDigitalProcessValueDataType
Analog Channel Types
Process Value VariableType DataType
RIOforPA RioPaAnalogProcessValueVariableType RioPaAnalogProcessValueDataType
RIOforFA RioFaAnalogProcessValueVariableType RioFaAnalogProcessValueDataType

There is no distinction regarding Input and Output, RIO Input Channel as well as RIO Output Channel Objects use the same Process Value VariableType. For example, the RioPaDigitalProcessValueVariableType is used as Process Value VariableType by the RioPaDigitalInputChannelType and by the RioPaDigitalOutputChannelType.

9.2.1 RioPaDigitalProcessValueVariableType

The RioPaDigitalProcessValueVariableType represents the Process Value of a digital RIO Channel according to RIOforPA.

Table 63 – RioPaDigitalProcessValueVariableType Definition
Attribute Value
BrowseNameRioPaDigitalProcessValueVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioPaDigitalProcessValueDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponentVariableDataValue0:Boolean0:BaseDataVariableTypeO, RO
0:HasComponentVariableQualifierValue0:ByteRioPaProcessValueQualifierVariableTypeO, RO
Conformance Units
PNRIO Channel Objects

The DataValue Variable contains the Process Value as transmitted in the telegram signal.

The Value of the QualifierValue Variable contains the status information as transmitted in the telegram signal. The optional components of the QualifierValue Variable contain refined status information encoded as RioQualityEnumeration, RioSpecifierEnumeration and RioQualifierEnumeration.

RioPaDigitalProcessValueVariableType Variables are linked to the associated PnIoSignalType Object in the PROFINET aspect using a 0:RepresentsSameEntityAs Reference.

9.2.2 RioFaDigitalProcessValueVariableType

The RioFaDigitalProcessValueVariableType represents the Process Value of a digital RIO Channel according to RIO FA.

Table 64 – RioFaDigitalProcessValueVariableType Definition
Attribute Value
BrowseNameRioFaDigitalProcessValueVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioFaDigitalProcessValueDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponentVariableDataValue0:Boolean0:BaseDataVariableTypeO, RO
0:HasComponentVariableQualifierValue0:BooleanRioFaProcessValueQualifierVariableTypeO, RO
Conformance Units
PNRIO Channel Objects

The DataValue Variable contains the Process Value bit as transmitted in the telegram signal.

The Value of the QualifierValue Variable contains the qualifier bit. The optional Quality component of the QualifierValue Variable contains the status information encoded as RioQualityEnumeration.

9.2.3 RioPaAnalogProcessValueVariableType

The RioPaAnalogProcessValueVariableType represents the Process Value of an analog RIO Channel according to RIOforPA.

Table 65 – RioPaAnalogProcessValueVariableType Definition
Attribute Value
BrowseNameRioPaAnalogProcessValueVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioPaAnalogProcessValueDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponentVariableDataValue0:Number0:BaseAnalogTypeO, RO
0:HasComponentVariableQualifierValue0:ByteRioPaProcessValueQualifierVariableTypeO, RO
Conformance Units
PNRIO Channel Objects

The DataValue Variable contains the analog Process Value as transmitted in the telegram signal.

The optional EngineeringUnits Property of the DataValue Variable shall be provided if possible and meaningful. If not, as in case for direct raw A/D conversion values and similar, the EngineeringUnits Property shall not be provided.

The optional EURange Property of the DataValue Variable shall be provided only if the EngineeringUnits property is provided. The optional InstrumentRange and ValuePrecision Properties of the DataValue Variable may be provided if possible and meaningful. This may be the case if the Server is running directly on the Device.

The Value of the QualifierValue Variable contains the status information as transmitted in the telegram signal. The optional components of the QualifierValue Variable contain refined status information encoded as RioQualityEnumeration, RioSpecifierEnumeration and RioQualifierEnumeration.

The QualifierValue Variable is linked to the associated PnIoSignalType Object in the PROFINET aspect using a 0:RepresentsSameEntityAs Reference.

RioPaAnalogProcessValueVariableType Variables are linked to the associated PnIoSignalType Object in the PROFINET aspect using a 0:RepresentsSameEntityAs Reference.

9.2.4 RioFaAnalogProcessValueVariableType

The RioFaAnalogProcessValueVariableType represents the Process Value of an analog RIO Channel according to RIO FA.

Table 66 – RioFaAnalogProcessValueVariableType Definition
Attribute Value
BrowseNameRioFaAnalogProcessValueVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioFaAnalogProcessValueDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponentVariableDataValue0:Number0:BaseAnalogTypeO, RO
0:HasComponentVariableQualifierValue0:BooleanRioFaProcessValueQualifierVariableTypeO, RO
Conformance Units
PNRIO Channel Objects

The DataValue Variable contains the analog Process Value as transmitted in the telegram signal.

The optional EngineeringUnits Property of the DataValue Variable shall be provided if possible and meaningful. If not, as in case for direct raw A/D conversion values and similar, the EngineeringUnits Property shall not be provided.

The optional EURange Property of the DataValue Variable shall be provided only if the EngineeringUnits property is provided. The optional InstrumentRange and ValuePrecision Properties of the DataValue Variable may be provided if possible and meaningful. This may be the case if the Server is running directly on the Device.

The Value of the QualifierValue Variable contains the qualifier bit. The optional Quality component of the QualifierValue Variable contains the status information encoded as RioQualityEnumeration.

RioFaAnalogProcessValueDataType Variables are linked to the associated PnIoSignalType Object in the PROFINET aspect using a 0:RepresentsSameEntityAs Reference.

9.3 Process Value Qualifier VariableTypes

9.3.1 RioPaProcessValueQualifierVariableType

The RioPaProcessValueQualifierVariableType contains qualifier information for a Process Value of RIO Channels according to RIOforPA.

Table 67 – RioPaProcessValueQualifierVariableType Definition
Attribute Value
BrowseNameRioPaProcessValueQualifierVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataType0:Byte
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponentVariableQualityRioQualityEnumeration0:BaseDataVariableTypeO, RO
0:HasComponentVariableNE_107RioSpecifierEnumeration0:BaseDataVariableTypeO, RO
0:HasComponentVariableStatus_fullRioQualifierEnumeration0:BaseDataVariableTypeO, RO
Conformance Units
PNRIO Qualifiers

The Quality Variable contains status information encoded as RioQualityEnumeration.

The NE_107 Variable contains status information according to NAMUR encoded as RioSpecifierEnumeration.

The Status_full Variable contains full status information encoded as RioQualifierEnumeration.

9.3.2 RioFaProcessValueQualifierVariableType

The RioFaProcessValueQualifierVariableType contains qualifier information for a Process Value of RIO Channels according to RIOforFA.

Table 68 – RioFaProcessValueQualifierVariableType Definition
Attribute Value
BrowseNameRioFaProcessValueQualifierVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataType0:Boolean
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponentVariableQualityRioQualityEnumeration0:BaseDataVariableTypeO, RO
Conformance Units
PNRIO Qualifiers

The Quality Variable contains status information encoded as RioQualityEnumeration. For RIOforFA, only the values GOOD or BAD are permissible.

9.4 Channel Configuration VariableTypes

The VariableTypes in this section aggregate RIO Channel Properties which do not change unless the configuration changes or some other condition arises which is not typical for normal operation, e.g. a diagnosis event occurs, write access during commissioning or temporary value changes for testing purposes.

For a description of the Variables of each individual VariableType refer to the definition of the RioChannelGroupConfigType in chapter 7.1.2. This ObjectType contains all Variables defined by all RIO Channel configuration VariableTypes in this section.

9.4.1 RioPaDigitalInputConfigVariableType

The RioPaDigitalInputConfigVariableType represents the configuration of a digital RIO Input Channel according to RIO PA.

Table 69 – RioPaDigitalInputConfigVariableType Definition
Attribute Value
BrowseNameRioPaDigitalInputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioPaDigitalInputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableInversionEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValue0:Boolean0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.2 RioFaDigitalInputConfigVariableType

The RioFaDigitalInputConfigVariableType represents the configuration of a digital RIO Input Channel according to RIO FA.

Table 70 – RioFaDigitalInputConfigVariableType Definition
Attribute Value
BrowseNameRioFaDigitalInputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioFaDigitalInputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSupplyVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValue0:Boolean0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.3 RioPaDigitalOutputConfigVariableType

The RioPaDigitalOutputConfigVariableType represents the configuration of a digital RIO Output Channel according to RIO PA.

Table 71 – RioPaDigitalOutputConfigVariableType Definition
Attribute Value
BrowseNameRioPaDigitalOutputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioPaDigitalOutputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableInversionEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValue0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteTime0:Float0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.4 RioFaDigitalOutputConfigVariableType

The RioFaDigitalOutputConfigVariableType represents the configuration of a digital RIO Output Channel according to RIO FA.

Table 72 – RioFaDigitalOutputConfigVariableType Definition
Attribute Value
BrowseNameRioFaDigitalOutputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioFaDigitalOutputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSupplyVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableLoadVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValue0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteTime0:Float0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.5 RioPaAnalogInputConfigVariableType

The RioPaAnalogInputConfigVariableType represents the configuration of an analog RIO Input Channel according to RIO PA.

Table 73 – RioPaAnalogInputConfigVariableType Definition
Attribute Value
BrowseNameRioPaAnalogInputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioPaAnalogInputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableDamping0:Float0:PropertyTypeO, RO
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValueRioAnalogDataType0:PropertyTypeO, RO
0:HasPropertyVariableHighLimitRioAnalogDataType0:PropertyTypeO, RO
0:HasPropertyVariableLowLimitRioAnalogDataType0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.6 RioFaAnalogInputConfigVariableType

The RioFaAnalogInputConfigVariableType represents the configuration of an analog RIO Input Channel according to RIO FA.

Table 74 – RioFaAnalogInputConfigVariableType Definition
Attribute Value
BrowseNameRioFaAnalogInputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioFaAnalogInputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableDamping0:Float0:PropertyTypeO, RO
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSupplyVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValueRioAnalogDataType0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.7 RioPaAnalogOutputConfigVariableType

The RioPaAnalogOutputConfigVariableType represents the configuration of an analog RIO Output Channel according to RIO PA.

Table 75 – RioPaAnalogOutputConfigVariableType Definition
Attribute Value
BrowseNameRioPaAnalogOutputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioPaAnalogOutputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValueRioAnalogDataType0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteTime0:Float0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

9.4.8 RioFaAnalogOutputConfigVariableType

The RioFaAnalogOutputConfigVariableType represents the configuration of an analog RIO Output Channel according to RIO FA.

Table 76 – RioFaAnalogOutputConfigVariableType Definition
Attribute Value
BrowseNameRioFaAnalogOutputConfigVariableType
IsAbstractFalse
ValueRank-1 (-1 = Scalar)
DataTypeRioFaAnalogOutputConfigDataType
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasPropertyVariableSignalTypeRioSignalTypeEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableWireCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSupplyVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableLoadVoltageCheckEnabled0:Boolean0:PropertyTypeO, RO
0:HasPropertyVariableSubstitutePolicyRioSubstitutePolicyEnumeration0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteValueRioAnalogDataType0:PropertyTypeO, RO
0:HasPropertyVariableSubstituteTime0:Float0:PropertyTypeO, RO
Conformance Units
PNRIO Channel Objects

10 OPC UA DataTypes

10.1 Channel Configuration DataTypes

10.1.1 RioPaDigitalInputConfigDataType

The RioPaDigitalInputConfigDataType represents the configuration of a digital RIO Input Channel according to RIO PA.

Table 77 – RioPaDigitalInputConfigDataType Structure
NameTypeDescription
RioPaDigitalInputConfigDataTypestructure
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
InversionEnabled0:BooleanTrue if the digital signal is inverted in the Function Block, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValue0:BooleanSubstitute value for the Process Value.

Its representation in the AddressSpace is defined in Table 78.

Table 78 – RioPaDigitalInputConfigDataType Definition
Attribute Value
BrowseNameRioPaDigitalInputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.2 RioFaDigitalInputConfigDataType

The RioFaDigitalInputConfigDataType represents the configuration of a digital RIO Input Channel according to RIO FA.

Table 79 – RioFaDigitalInputConfigDataType Structure
NameTypeDescription
RioFaDigitalInputConfigDataTypestructure
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
SupplyVoltageCheckEnabled0:BooleanTrue if supply voltage check is active for the channel, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValue0:BooleanSubstitute value for the Process Value.

Its representation in the AddressSpace is defined in Table 80.

Table 80 – RioFaDigitalInputConfigDataType Definition
Attribute Value
BrowseNameRioFaDigitalInputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.3 RioPaDigitalOutputConfigDataType

The RioPaDigitalOutputConfigDataType represents the configuration of a digital RIO Output Channel according to RIO PA.

Table 81 – RioPaDigitalOutputConfigDataType Structure
NameTypeDescription
RioPaDigitalOutputConfigDataTypestructure
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
InversionEnabled0:BooleanTrue if the digital signal is inverted in the Function Block, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValue0:BooleanSubstitute value for the Process Value.
SubstituteTime0:FloatTime in seconds from the detection of a failure to the application of the SubstitutePolicy.

Its representation in the AddressSpace is defined in Table 82.

Table 82 – RioPaDigitalOutputConfigDataType Definition
Attribute Value
BrowseNameRioPaDigitalOutputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.4 RioFaDigitalOutputConfigDataType

The RioFaDigitalOutputConfigDataType represents the configuration of a digital RIO Output Channel according to RIO FA.

Table 83 – RioFaDigitalOutputConfigDataType Structure
NameTypeDescription
RioFaDigitalOutputConfigDataTypestructure
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
SupplyVoltageCheckEnabled0:BooleanTrue if supply voltage check is active for the channel, otherwise False.
LoadVoltageCheckEnabled0:BooleanTrue if load voltage check is active for the channel, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValue0:BooleanSubstitute value for the Process Value.
SubstituteTime0:FloatTime in seconds from the detection of a failure to the application of the SubstitutePolicy.

Its representation in the AddressSpace is defined in Table 84.

Table 84 – RioFaDigitalOutputConfigDataType Definition
Attribute Value
BrowseNameRioFaDigitalOutputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.5 RioPaAnalogInputConfigDataType

The RioPaAnalogInputConfigDataType represents the configuration of an analog RIO Input Channel according to RIO PA.

Table 85 – RioPaAnalogInputConfigDataType Structure
NameTypeDescription
RioPaAnalogInputConfigDataTypestructure
Damping0:FloatDamping time (T63) in seconds applied to an analog signal in the Function Block.
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValueRioAnalogDataTypeSubstitute value for the Process Value.
HighLimitRioAnalogDataTypeUpper limit of an analog signal.
LowLimitRioAnalogDataTypeLower limit of an analog signal.

Its representation in the AddressSpace is defined in Table 86.

Table 86 – RioPaAnalogInputConfigDataType Definition
Attribute Value
BrowseNameRioPaAnalogInputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.6 RioFaAnalogInputConfigDataType

The RioFaAnalogInputConfigDataType represents the configuration of an analog RIO Input Channel according to RIO FA.

Table 87 – RioFaAnalogInputConfigDataType Structure
NameTypeDescription
RioFaAnalogInputConfigDataTypestructureDamping time (T63) in seconds applied to an analog signal in the Function Block.
Damping0:FloatDamping time (T63) in seconds applied to an analog signal in the Function Block.
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
SupplyVoltageCheckEnabled0:BooleanTrue if supply voltage check is active for the channel, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValueRioAnalogDataTypeSubstitute value for the Process Value.

Its representation in the AddressSpace is defined in Table 88.

Table 88 – RioFaAnalogInputConfigDataType Definition
Attribute Value
BrowseNameRioFaAnalogInputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.7 RioPaAnalogOutputConfigDataType

The RioPaAnalogOutputConfigDataType represents the configuration of an analog RIO Output Channel according to RIO PA.

Table 89 – RioPaAnalogOutputConfigDataType Structure
NameTypeDescription
RioPaAnalogOutputConfigDataTypestructure
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValueRioAnalogDataTypeSubstitute value for the Process Value.
SubstituteTime0:FloatTime in seconds from the detection of a failure to the application of the SubstitutePolicy.

Its representation in the AddressSpace is defined in Table 90.

Table 90 – RioPaAnalogOutputConfigDataType Definition
Attribute Value
BrowseNameRioPaAnalogOutputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.1.8 RioFaAnalogOutputConfigDataType

The RioFaAnalogOutputConfigDataType represents the configuration of an analog RIO Output Channel according to RIO FA.

Table 91 – RioFaAnalogOutputConfigDataType Structure
NameTypeDescription
RioFaAnalogOutputConfigDataTypestructure
SignalTypeRioSignalTypeEnumerationSignal Type.
WireCheckEnabled0:BooleanTrue if wire check is active for the channel, otherwise False.
SupplyVoltageCheckEnabled0:BooleanTrue if supply voltage check is active for the channel, otherwise False.
LoadVoltageCheckEnabled0:BooleanTrue if load voltage check is active for the channel, otherwise False.
SubstitutePolicyRioSubstitutePolicyEnumerationSubstitute value setting of the channel.
SubstituteValueRioAnalogDataTypeSubstitute value for the Process Value.
SubstituteTime0:FloatTime in seconds from the detection of a failure to the application of the SubstitutePolicy.

Its representation in the AddressSpace is defined in Table 92.

Table 92 – RioFaAnalogOutputConfigDataType Definition
Attribute Value
BrowseNameRioFaAnalogOutputConfigDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.2 Process Value DataTypes

10.2.1 RioPaDigitalValueDataType

This structure contains the Process Value and the qualifier of a digital RIO Channel according to RIOforPA.

Table 93 – RioPaDigitalValueDataType Structure
NameTypeDescription
RioPaDigitalValueDataTypestructureSubtype of 0:Structure defined in OPC 10000-3.

Value

0:BooleanCurrent value.

Qualifier

0:ByteCurrent status.

Its representation in the AddressSpace is defined in Table 94.

Table 94 – RioPaDigitalValueDataType Definition
Attribute Value
BrowseNameRioPaDigitalValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.2.2 RioFaDigitalValueDataType

This structure contains the Process Value and the qualifier of a digital RIO Channel according to RIOforFA.

Table 95 – RioFaDigitalValueDataType Structure
NameTypeDescription
RioFaDigitalValueDataTypestructureSubtype of 0:Structure defined in OPC 10000-3.

Value

0:BooleanCurrent value.

Qualifier

0:BooleanCurrent status.

Its representation in the AddressSpace is defined in Table 96.

Table 96 – RioFaDigitalValueDataType Definition
Attribute Value
BrowseNameRioFaDigitalValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure type defined in OPC 10000-3
Conformance Units
PNRIO Channel Objects

10.2.3 RioPaDigitalProcessValueDataType

This structure contains the Process Value of a digital RIO Channel according to RIOforPA. In addition to value and qualifier, the numeric values of the Quality, NE_107 and Status_full members of the RioProcessValueQualifierType Variable are part of the structure.

Table 97 – RioPaDigitalProcessValueDataType Structure
NameTypeDescription
RioPaDigitalProcessValueDataTypestructureSubtype of RioPaDigitalValueDataType.

Value

0:BooleanCurrent value consisting of the Boolean representation of the 2 lowest order bits in the telegram signal.

Qualifier

0:ByteCurrent status representing the 6 high order bits of the digital value byte as transmitted in the telegram signal.

Quality

0:ByteStatus information encoded as RioQualityEnumeration

NE_107

0:ByteStatus information according to NAMUR 107 encoded as RioSpecifierEnumeration.

Status_full

0:ByteStatus information according to PA-Profile V3 and PA-Profile V4 encoded as RioQualifierEnumeration.

Its representation in the AddressSpace is defined in Table 98.

Table 98 – RioPaDigitalProcessValueDataType Definition
Attribute Value
BrowseNameRioPaDigitalProcessValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the RioPaDigitalValueDataType.
Conformance Units
PNRIO Channel Objects

10.2.4 RioFaDigitalProcessValueDataType

This structure contains the Process Value of a digital RIO Channel according to RIOforFA. In addition to value and qualifier, the numeric value of the Quality member of the RioProcessValueQualifierType Variable is part of the structure.

Table 99 – RioFaDigitalProcessValueDataType Structure
NameTypeDescription
RioFaDigitalProcessValueDataTypestructureSubtype of RioFaDigitalValueDataType.

Value

0:BooleanCurrent value consisting of the Boolean representation of the value bit in the telegram signal.

Qualifier

0:BooleanQualifier value consisting of the Boolean representation of the qualifier bit in the telegram signal.

Quality

0:ByteValue of RioQualityEnumeration.

Its representation in the AddressSpace is defined in Table 100.

Table 100 – RioFaDigitalProcessValueDataType Definition
Attribute Value
BrowseNameRioFaDigitalProcessValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the RioFaDigitalValueDataType.
Conformance Units
PNRIO Channel Objects

10.2.5 RioAnalogDataType

This union contains fields of the data types used for analog Values in analog RIO Channels.

Table 101 – RioAnalogDataType Union
Name Type Description
RioAnalogDataTypeunion

Float_32

0:Float32-bit floating point number

Int_16

0:Int1616-bit integer number

Int_32

0:Int3232-bit integer number

UInt_16

0:UInt1616-bit unsigned integer number

UInt_32

0:UInt3232-bit unsigned integer number

Its representation in the AddressSpace is defined in Table 102.

Table 102 – RioAnalogDataType definition
Attributes Value
BrowseNameRioAnalogDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of Union defined in OPC 10000-5.
Conformance Units
PNRIO Channel Objects

10.2.6 RioPaAnalogValueDataType

This structure contains the Process Value and the qualifier of an analog RIO Channel according to RIOforPA.

Table 103 – RioPaAnalogValueDataType Structure
NameTypeDescription
RioPaAnalogValueDataTypestructureSubtype of 0:Structure defined in OPC 10000-3.

Value

RioAnalogDataTypeCurrent value.

Qualifier

0:ByteCurrent status.

Its representation in the AddressSpace is defined in Table 104.

Table 104 – RioPaAnalogValueDataType Definition
Attribute Value
BrowseNameRioPaAnalogValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure defined in OPC 10000-3.
Conformance Units
PNRIO Channel Objects

10.2.7 RioFaAnalogValueDataType

This structure contains the Process Value and the qualifier of an analog RIO Channel according to RIOforFA.

Table 105 – RioFaAnalogValueDataType Structure
NameTypeDescription
RioFaAnalogValueDataTypestructureSubtype of 0:Structure defined in OPC 10000-3.

Value

RioAnalogDataTypeCurrent value.

Qualifier

0:BooleanCurrent status.

Its representation in the AddressSpace is defined in Table 106.

Table 106 – RioFaAnalogValueDataType Definition
Attribute Value
BrowseNameRioFaAnalogValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the 0:Structure defined in OPC 10000-3.
Conformance Units
PNRIO Channel Objects

10.2.8 RioPaAnalogProcessValueDataType

This structure contains the Process Value of an analog RIO Channel according to RIOforPA. In addition to value and qualifier, the numeric values of the Quality, NE_107 and Status_full members of the RioProcessValueQualifierType Variable are part of the structure.

Table 107 – RioPaAnalogProcessValueDataType Structure
NameTypeDescription
RioPaAnalogProcessValueDataTypestructureSubtype of RioPaAnalogValueDataType.

Value

RioAnalogDataTypeCurrent value.

Qualifier

0:ByteCurrent status.

Quality

0:ByteStatus information encoded as RioQualityEnumeration.

NE_107

0:ByteStatus information according to NAMUR 107 encoded as RioSpecifierEnumeration.

Status_full

0:ByteStatus information according to PA-Profile V3 and PA-Profile V4 encoded as RioQualifierEnumeration.

Its representation in the AddressSpace is defined in Table 108.

Table 108 – RioPaAnalogProcessValueDataType Definition
Attribute Value
BrowseNameRioPaAnalogProcessValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the RioPaAnalogValueDataType.
Conformance Units
PNRIO Channel Objects

10.2.9 RioFaAnalogProcessValueDataType

This structure contains the Process Value of an analog RIO Channel according to RIOforFA. In addition to value and qualifier, the numeric value of the Quality member of the RioProcessValueQualifierType Variable is part of the structure.

Table 109 – RioFaAnalogProcessValueDataType Structure
NameTypeDescription
RioFaAnalogProcessValueDataTypestructureSubtype of RioFaAnalogValueDataType.

Value

RioAnalogDataTypeCurrent value.

Qualifier

0:BooleanQualifier for Value member.

Quality

0:ByteStatus encoded as RioQualityEnumeration.

Its representation in the AddressSpace is defined in Table 110.

Table 110 – RioFaAnalogProcessValueDataType Definition
Attribute Value
BrowseNameRioFaAnalogProcessValueDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the RioFaAnalogValueDataType.
Conformance Units
PNRIO Channel Objects

10.3 RioBitFieldDataType

This structure represents a bit field containing 32 bits.

Table 111 – RioBitFieldDataType Structure
NameTypeDescription
RioBitFieldDataTypestructureSubtype of 0:Structure defined in OPC 10000-3.

BitData

0:UInt3232-bit unsigned representing 32 bits.

BitUsed

0:UInt3232-bit unsigned indicating the usage of each of the 32 bits of the BitData field.

The RioBitFieldDataType is used for read-only variables only. Its representation in the AddressSpace is defined in Table 112.

Table 112 – RioBitFieldDataType Definition
Attribute Value
BrowseNameRioBitFieldDataType
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of 0:Structure defined in OPC 10000-3.
Conformance Units
PNRIO Channel Objects

The bit numbers of the BitData field are according to the significance of the bit within the 0:UInt32 data type. The bit numbering method applied is LSB 0, which means that bit numbering starts at zero for the least significant bit. If bit number 0 is set only, this corresponds to the numeric value 1, if bit number 1 is set, this corresponds to the numeric value 2, bit number 2 corresponds to the numeric value 4 and so on. The position of the bit in the memory allocated by the 0:UInt32 field depends on the byte order of the underlying platform.

Bits set to 1 in the BitUsed field indicate the validity of the corresponding bits in the BitData field. For bits set to 0 in this field, the corresponding bit in the BitData field shall be considered as unused by a Client. The same convention for bit numbers as described for the BitData field applies.

10.4 Enumeration Types

10.4.1 PnIoTelegramStatusEnumeration

This enumeration defines the possible values of the ProviderStatus and ConsumerStatus Variables of the PnIoTelegramType (see [PN Service], Sec. 7.3.1.4.4).

Table 113 – PnIoTelegramStatusEnumeration Items
NameValueDescription
GOOD0For ConsumerStatus: The submodule’s IO data object could be successfully processed by the application process. For ProviderStatus: The content of the submodule’s IO data object is valid.
BAD_BY_SUBSLOT1For ConsumerStatus: not used. For ProviderStatus: The content of the submodule’s IO data object is invalid. The condition was detected by the submodule.
BAD_BY_SLOT2For ConsumerStatus: not used. For ProviderStatus: The content of the submodule’s IO data object is invalid. The condition was detected by the module.
BAD_BY_DEVICE3For ConsumerStatus: The IO device has locally detected problems to convey data. For ProviderStatus: The content of the submodule’s IO data object is invalid. The condition was detected by the device.
BAD_BY_CONTROLLER4For ConsumerStatus: The submodule’s IO data object could not be successfully processed by the application of the Controller (e.g. because of the operation state “stop”). For ProviderStatus: The content of the submodule’s IO data object is invalid. The condition was only locally detected by the Controller.

Its representation in the AddressSpace is defined in Table 114.

Table 114 – PnIoTelegramStatusEnumeration Definition
Attribute Value
BrowseNamePnIoTelegramStatusEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Cyclic Telegrams

10.4.2 RioSignalTypeEnumeration

Table 115 – RioSignalTypeEnumeration Items
NameValueDescription
CURRENT-4-20_mA0Current, 4 to 20 mA
CURRENT-0-20_mA1Current, 0 to 20 mA
VOLTAGE-0-10_V2Voltage, 0 to 10 V
VOLTAGE-10-10_V3Voltage, -10 to 10 V
HART4HART Communication (this includes 4 to 20 mA)
DIGITAL-0/24V5Digital, 0/24 V (discrete input or output only)
NAMUR6See NAMUR NE 107.
MANUFACTURER_SPECIFIC7None of the above.

Its representation in the AddressSpace is defined in Table 116.

Table 116 – RioSignalTypeEnumeration Definition
Attribute Value
BrowseNameRioSignalTypeEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Channel Objects

10.4.3 RioSubstitutePolicyEnumeration

Table 117 – RioSubstitutePolicyEnumeration Items
NameValueDescription
USE_SUBSTITUTE_VALUE0The value of the SubstituteValue configuration property is used as substitute value if an error condition is detected.
USE_LAST_VALID_VALUE1The last valid value is used as substitute value if an error condition is detected.
USE_ACTUAL_VALUE2No substitute value is used, the process value can have the wrong calculated value and status even if the error condition is detected.
UNSPECIFIED255No information about the status is given.

Its representation in the AddressSpace is defined in Table 118.

Table 118 – RioSubstitutePolicyEnumeration Definition
Attribute Value
BrowseNameRioSubstitutePolicyEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Channel Objects

10.4.4 RioChannelModeEnumeration

Table 119 – RioChannelModeEnumeration Items
NameValueDescription
AUTO0Do not use the value of the ManualProcessValue variable as Process Value of the RIO Channel.
MANUAL1Use the value of the ManualProcessValue variable as Process Value of the RIO Channel.
OUT_OF_SERVICE2The RIO Channel is out of service.

Its representation in the AddressSpace is defined in Table 120.

Table 120 – RioChannelModeEnumeration Definition
Attribute Value
BrowseNameRioChannelModeEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Channel Objects

10.4.5 RioQualityEnumeration

Table 121 – RioQualityEnumeration Items
NameValueDescription
GOOD0 Input: The Process Value can be used by the Controller. Output: The Signal was generated from the Process Value.
UNCERTAIN1An error condition could compromise the Process Value (Input) or the Signal (Output).
BAD2 Input: The Process Value cannot be used by the Controller. Output: The Signal may not be generated from the Process Value.
UNSPECIFIED255No information about the status is given.

Its representation in the AddressSpace is defined in Table 122.

Table 122 – RioQualityEnumeration Definition
Attribute Value
BrowseNameRioQualityEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Channel Objects

10.4.6 RioSpecifierEnumeration

Table 123 – RioSpecifierEnumeration Items
NameValueDescription
NORMAL0Good signal.
FAILURE1Invalid signal due to malfunction of a sensor or actuator.
FUNCTION_CHECK2Temporarily invalid signal.
MAINTENANCE_REQUEST3Valid signal, but function could drop or cease soon.
OUT_OF_SPECIFICATION4Device is running beyond permissible range of some other parameter.
UNSPECIFIED255No information about the status is given.

Its representation in the AddressSpace is defined in Table 124.

Table 124 – RioSpecifierEnumeration Definition
Attribute Value
BrowseNameRioSpecifierEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Channel Objects

10.4.7 RioQualifierEnumeration

Table 125 – RioQualifierEnumeration Items
NameValueDescription
BAD_NOT_SPECIFIC0Proxy determines that a device does not communicate.
BAD_NOT_CONNECTED8Some communication error: the device is currently unavailable.
BAD_NOT_CONNECTED_SIMULATION_ACTIVE9Same as BAD_NOT_CONNECTED but with simulate flag set.
BAD_PASSIVATED32The channel is passivated.
BAD_PASSIVATED_SIMULATION_ACTIVE33Same as BAD_PASSIVATED but with simulate flag set.
BAD_MAINTENANCE_ALARM36No measurement available because of a failure.
BAD_MAINTENANCE_ALARM_SIMULATION_ACTIVE37Same as BAD_MAINTENANCE_ALARM but with simulate flag set.
BAD_PROCESS40No measurement available because of invalid process conditions.
BAD_PROCESS_SIMULATION_ACTIVE41Same as BAD_PROCESS but with simulate flag set.
BAD_FUNCTION_CHECK60Local override, value not usable.
BAD_FUNCTION_CHECK_SIMULATION_ACTIVE61Same as BAD_FUNCTION_CHECK but with simulate flag set.
UNCERTAIN_SUBSTITUTE_SET72The configured substitute value (see SubstituteValue) is used as Process Value.
UNCERTAIN_SUBSTITUTE_SET_SIMULATION_ACTIVE73Same as UNCERTAIN_SUBSTITUTE_SET but with simulate flag set.
UNCERTAIN_INITIAL_VALUE76Default value since no measured value is available.
UNCERTAIN_INITIAL_VALUE_SIMULATION_ACTIVE77Same as UNCERTAIN_INITIAL_VALUE but with simulate flag set.
UNCERTAIN_MAINTENANCE_DEMANDED104Value is potentially invalid.
UNCERTAIN_MAINTENANCE_DEMANDED_SIMULATION_ACTIVE105Same as UNCERTAIN_MAINTENANCE_DEMANDED but with simulate flag set.
UNCERTAIN_NO_MAINTENANCE120The process conditions are out of the specified operating range of the device.
UNCERTAIN_NO_MAINTENANCE_SIMULATION_ACTIVE121Same as UNCERTAIN_NO_MAINTENANCE but with simulate flag set.
GOOD128No error or special condition is associated with this value.
GOOD_SIMULATION_ACTIVE129Same as GOOD but with simulate flag set.
UPDATE130IM_Revision_Counter changed.
GOOD_INITIATE_FAULT_STATE160The value is from a block that wants its following output block (e.g. Actuator FB) to go to Fail Safe.
GOOD_MAINTENANCE_REQUIRED164Value is usable. Maintenance is recommended within a medium-term period.
GOOD_MAINTENANCE_REQUIRED_SIMULATION_ACTIVE165Same as GOOD_MAINTENANCE_REQUIRED but with simulate flag set.
GOOD_MAINTENANCE_DEMANDED168Value is usable. Maintenance is strongly recommended within a short-term period.
GOOD_MAINTENANCE_DEMANDED_SIMULATION_ACTIVE169Same as GOOD_MAINTENANCE_DEMANDED but with simulate flag set.
GOOD_LOCAL_OVERRIDE156The value is from a block that has been locked out.
GOOD_LOCAL_OVERRIDE_SIMULATION_ACTIVE157Same as GOOD_LOCAL_OVERRIDE_SIMULATED but with simulate flag set.
GOOD_FUNCTION_CHECK188Function check is being executed.
GOOD_FUNCTION_CHECK_SIMULATION_ACTIVE189Same as GOOD_FUNCTION_CHECK but with simulate flag set.
UNSPECIFIED255No information about the status is given.

Its representation in the AddressSpace is defined in Table 126.

Table 126 – RioQualifierEnumeration Definition
Attribute Value
BrowseNameRioQualifierEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Channel Objects

10.4.8 RioChannelDiagnosisStatusEnumeration

Table 127 – RioChannelDiagnosisStatusEnumeration Items
NameValueDescription
HI_LIM_EXCEEDED0Upper limit value exceeded. Only supported by RIOforPA channels.
LO_LIM_EXCEEDED1Lower limit value underrun. Only supported by RIOforPA channels.
SIMULATION_ACTIVE2Simulation is active. Only supported by RIOforPA channels.
MODE_CHANGED3Mode of block has changed. Only supported by RIOforPA channels.
SUBSTITUTE_VALUE_USED4Substitute value used. Only supported by RIOforPA channels.
Q_BAD_SUBSTITUTE_VALUE_USED5Process Image Qualifier = 0. Substitute value used by (Sub)Module. Only supported by RIOforFA channels.
OUT_OF_SERVICE6The channel has ceased operation.

Its representation in the AddressSpace is defined in Table 128.

Table 128 – RioChannelDiagnosisStatusEnumeration Definition
Attribute Value
BrowseNameRioChannelDiagnosisStatusEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Alarms
PNRIO Events

10.4.9 RioChannelDiagnosisReasonEnumeration

Table 129 – RioChannelDiagnosisReasonEnumeration Items
NameValueDescription
ALL_DISAPPEARS0No diagnosis condition of any severity is persisting.
APPEARS1The diagnosis condition indicated arises and/or persists.
DISAPPEARS2The diagnosis condition indicated does not longer persist. No diagnosis condition of the same severity is persisting for the affected channel.
DISAPPEARS_OTHER_REMAIN3The diagnosis condition indicated does not longer persist. Other diagnosis conditions of the same severity are persisting.

Its representation in the AddressSpace is defined in Table 128.

Table 130 – RioChannelDiagnosisReasonEnumeration Definition
Attribute Value
BrowseNameRioChannelDiagnosisReasonEnumeration
IsAbstractFalse
References NodeClass BrowseName DataType TypeDefinition Other
Subtype of the Enumeration type defined in OPC 10000-5
0:HasPropertyVariable0:EnumValues0:EnumValueType []0:PropertyType
Conformance Units
PNRIO Alarms
PNRIO Events

11 OPC UA ReferenceTypes

11.1 HasRioInputChannel

The HasRioInputChannel ReferenceType is a concrete ReferenceType and can be used directly. It is a subtype of 0:HasComponent defined in OPC 10000-5.

The semantic of this ReferenceType is to connect RioChannelGroup Objects with Input Channel Objects.

The HasRioInputChannel Reference is formally defined in Table 131.

Table 131 – HasRioInputChannel Definition
Attributes Value
BrowseNameHasRioInputChannel
InverseNameIsRioInputChannelOf
SymmetricFalse
IsAbstractFalse
References NodeClass BrowseName Comment
Subtype of HasComponent from OPC 10000-5.
Conformance Units
PNRIO Channel Objects

11.2 HasRioOutputChannel

The HasRioOutputChannel ReferenceType is a concrete ReferenceType and can be used directly. It is a subtype of 0:HasComponent defined in OPC 10000-5.

The semantic of this ReferenceType is to connect RioChannelGroup Objects with Output Channel Objects.

The HasRioOutputChannel Reference is formally defined in Table 132.

Table 132 – HasRioOutputChannel Definition
Attributes Value
BrowseNameHasRioOutputChannel
InverseNameIsRioOutputChannelOf
SymmetricFalse
IsAbstractFalse
References NodeClass BrowseName Comment
Subtype of HasComponent from OPC 10000-5.
Conformance Units
PNRIO Channel Objects

11.3 HasRioProcessVariable

The HasRioProcessVariable ReferenceType is a concrete ReferenceType and can be used directly. It is a subtype of 0:HasComponent defined in OPC 10000-5.

The semantic of this ReferenceType is to connect RioChannelGroup Objects with bit field and array Variables containing Process Values.

The HasRioProcessVariable Reference is formally defined in Table 133.

Table 133 – HasRioProcessVariable Definition
Attributes Value
BrowseNameHasRioProcessVariable
InverseNameIsRioProcessVariableOf
SymmetricFalse
IsAbstractFalse
References NodeClass BrowseName Comment
Subtype of HasComponent from OPC 10000-5.
Conformance Units
PNRIO Process Variables

11.4 HasRioConfiguration

The HasRioConfiguration ReferenceType is a concrete ReferenceType and can be used directly. It is a subtype of 0:HasComponent defined in OPC 10000-5.

The semantic of this ReferenceType is to connect RioChannelGroup Objects with RioChannelGroupConfigType Objects.

The HasRioConfiguration Reference is formally defined in Table 134.

Table 134 – HasRioConfiguration Definition
Attributes Value
BrowseNameHasRioConfiguration
InverseNameIsRioConfigurationOf
SymmetricFalse
IsAbstractFalse
References NodeClass BrowseName Comment
Subtype of HasComponent from OPC 10000-5.
Conformance Units
PNRIO Process Variables

12 Profiles and Conformance Units

12.1 Conformance Units

Table 135 defines the corresponding Conformance Units for the OPC UA Information Model for OPC UA for PROFINET Remote IO.

Table 135 – Conformance Units for OPC UA for PROFINET Remote IO
Category Title Description
ServerPNRIO Channel Groups Server supports Channel Group Objects.
Server PNRIO Channel Objects Server supports Channel Objects.
ServerPNRIO Process Variables Channel Group Objects contain bitmask and/or array Variables.
ServerPNRIO Configuration Channel Group Objects contain a RioChannelGroupConfigType Object.
ServerPNRIO Alarms Server supports diagnosis Alarms and Conditions. This includes support of the OPC UA “A&C Alarm Server Facet”.
ServerPNRIO Events Server supports diagnosis Event Notifications. This includes support of the OPC UA “Standard Event Subscription Server Facet”.
ServerPNRIO Durable SubscriptionsServer supports diagnosis Event Notifications and supports the OPC UA “Durable Subscriptions Server Facet”.
ServerPNRIO Cyclic Telegrams Server supports PN aspect Objects for cyclic telegram mapping. The cross-aspect References are provided.
ServerPNRIO Operator Mode Channel Group Objects and/or Channel Objects contain at least one Method and the Lock Object.
ServerPNRIO Security Roles Server supports role-based security and restricts write access and method invocation to Sessions with granted “Operator” role. This includes support of the OPC UA “Security User Access Control Base Facet”.
Server PNRIO Qualifiers Server supports optional qualifier components for Process Value Variables.

12.2 Profiles

12.2.1 Profile list

Table 136 lists all Profiles defined in this document and defines their URIs.

Table 136 – Profile URIs for OPC UA for PROFINET Remote IO
Profile URI
PNRIO Common Server Facethttp://opcfoundation.org/UA-Profile/PNRIO/Server/Common
PNRIO Base Server Profile http://opcfoundation.org/UA-Profile/PNRIO/Server/Base
PNRIO Group Server Profile http://opcfoundation.org/UA-Profile/PNRIO/Server/Group
PNRIO Grouped Channels Server Profile http://opcfoundation.org/UA-Profile/PNRIO/Server/GroupedChannels
PNRIO Full Grouped Channels Server Profile http://opcfoundation.org/UA-Profile/PNRIO/Server/FullGroupedChannels

12.2.2 Server Facets

12.2.2.1 Overview

The following sections specify the Facets available for Servers that implement the OPC UA for PROFINET Remote IO companion specification. Each section defines and describes a Facet or Profile.

12.2.2.2 PNRIO Common Server Facet

The PNRIO Common Server Facet contains all Conformance Units and Profiles which are used by the other Profiles. It is intended to be used only as part of the subsequent defined Profiles.

Table 137 – PNRIO Common Server Facet
Group Conformance Unit / Profile Title Mandatory / Optional
PNRIOPNRIO AlarmsO
PNRIOPNRIO EventsO
PNRIOPNRIO Durable SubscriptionsO
PNRIOPNRIO Cyclic TelegramsO
PNRIOPNRIO Operator ModeO
PNRIOPNRIO QualifiersO
Profile0:Nano Embedded Device 2017 Server Profile
http://opcfoundation.org/UA-Profile/Server/NanoEmbeddedDevice2017
M
Profile0:ComplexType 2017 Server Facet
http://opcfoundation.org/UA-Profile/Server/ComplexTypes2017
M
Profile0:UA-TCP UA-SC UA Binary
http://opcfoundation.org/UA-Profile/Transport/uatcp-uasc-uabinary
M
Profile0:Data Access Server Facet
http://opcfoundation.org/UA-Profile/Server/DataAccess
M
12.2.2.3 PNRIO Base Server Profile

From the PNRIO Conformance Units, the PNRIO Base Server Profile demands the PNRIO Channel Objects Conformance Unit only. Servers implementing this Profile provide Channel Objects, but do not offer Channel Group Objects or any component of the later, as Process Variables or a RioChannelGroupConfigType Object.

Table 138 – PNRIO Base Server Profile
Group Conformance Unit / Profile Title Mandatory / Optional
PNRIO PNRIO Common Server FacetM
PNRIOPNRIO Channel ObjectsM
12.2.2.4 PNRIO Group Server Profile

From the PNRIO Conformance Units, the PNRIO Group Server Profile demands the PNRIO Channel Groups and the PNRIO Process Variables Conformance Units. Servers implementing this Profile do not provide Channel Objects. Optionally RioChannelGroupConfigType Objects may be provided as components of Channel Group Objects.

Table 139 – PNRIO Group Server Profile
Group Conformance Unit / Profile Title Mandatory / Optional
PNRIOPNRIO Common Server FacetM
PNRIOPNRIO Channel GroupsM
PNRIOPNRIO Process VariablesM
PNRIOPNRIO ConfigurationO
12.2.2.5 PNRIO Grouped Channels Server Profile

From the PNRIO Conformance Units, the PNRIO Grouped Channels Server Profile demands the PNRIO Channel Groups and the PNRIO Channel Objects Conformance Units. Servers implementing this Profile do not provide Process Variables. Optionally RioChannelGroupConfigType Objects may be provided as components of Channel Group Objects.

Table 140 – PNRIO Grouped Channels Server Profile
Group Conformance Unit / Profile Title Mandatory / Optional
PNRIOPNRIO Common Server FacetM
PNRIOPNRIO Channel GroupsM
PNRIOPNRIO Channel ObjectsM
PNRIOPNRIO ConfigurationO
12.2.2.6 PNRIO Full Grouped Channels Server Profile

From the PNRIO Conformance Units, the PNRIO Grouped Channels Server Profile demands the PNRIO Channel Groups, the PNRIO Channel Objects and the PNRIO Process Variables Conformance Units. Optionally RioChannelGroupConfigType Objects may be provided as components of Channel Group Objects.

Table 141 – PNRIO Full Grouped Channels Server Profile
Group Conformance Unit / Profile Title Mandatory / Optional
PNRIOPNRIO Common Server FacetM
PNRIOPNRIO Channel GroupsM
PNRIOPNRIO Channel ObjectsM
PNRIOPNRIO Process VariablesM
PNRIOPNRIO ConfigurationO
12.2.2.7 PNRIO Channel Operator Server Facet
Table 142 – PNRIO Channel Operator Server Facet
Group Conformance Unit / Profile Title Mandatory / Optional
PNRIOPNRIO Operator ModeM
Profile2:Locking_Server_FacetM
PNRIOPNRIO Security RolesO
12.2.2.8 Untitled

12.2.3 Client Facets

This specification does not define Client Facets.

13 Namespaces

13.1 Namespace Metadata

Table 143 defines the namespace metadata for this document. The Object is used to provide version information for the namespace and an indication about static Nodes. Static Nodes are identical for all Attributes in all Servers, including the Value Attribute. See OPC 10000-5 for more details.

The information is provided as Object of type NamespaceMetadataType. This Object is a component of the Namespaces Object that is part of the Server Object. The NamespaceMetadataType ObjectType and its Properties are defined in OPC 10000-5.

The version information is also provided as part of the ModelTableEntry in the UANodeSet XML file. The UANodeSet XML schema is defined in OPC 10000-6.

Table 143 – NamespaceMetadata Object for this Document
Attribute Value
BrowseName http://opcfoundation.org/UA/PNRIO/
Property DataType Value
NamespaceUriString http://opcfoundation.org/UA/PNRIO/
NamespaceVersionString1.00.1
NamespacePublicationDateDateTime2022-07-11
IsNamespaceSubsetBooleanFalse
StaticNodeIdTypesIdType []0
StaticNumericNodeIdRangeNumericRange []
StaticStringNodeIdPatternString

Note: The IsNamespaceSubset Property is set to False as the UANodeSet XML file contains the complete Namespace. Servers only exposing a subset of the Namespace need to change the value to True.

13.2 Handling of OPC UA Namespaces

Namespaces are used by OPC UA to create unique identifiers across different naming authorities. The Attributes NodeId and BrowseName are identifiers. A Node in the UA AddressSpace is unambiguously identified using a NodeId. Unlike NodeIds, the BrowseName cannot be used to unambiguously identify a Node. Different Nodes may have the same BrowseName. They are used to build a browse path between two Nodes or to define a standard Property.

Servers may often choose to use the same namespace for the NodeId and the BrowseName. However, if they want to provide a standard Property, its BrowseName shall have the namespace of the standards body although the namespace of the NodeId reflects something else, for example the EngineeringUnits Property. All NodeIds of Nodes not defined in this document shall not use the standard namespaces.

Table 144 provides a list of mandatory and optional namespaces used in an OPC UA for PROFINET Remote IO OPC UA Server.

Table 144 – Namespaces used in a OPC UA for PROFINET Remote IO Server
NamespaceURI Description Use
http://opcfoundation.org/UA/Namespace for NodeIds and BrowseNames defined in the OPC UA specification. This namespace shall have namespace index 0.Mandatory
Local Server URINamespace for nodes defined in the local server. This namespace shall have namespace index 1.Mandatory
http://opcfoundation.org/UA/DI/Namespace for NodeIds and BrowseNames defined in OPC 10000-100. The namespace index is Server specific.Mandatory
http://opcfoundation.org/UA/PNRIO/Namespace for NodeIds and BrowseNames defined in this document. The namespace index is Server specific.Mandatory
Vendor specific typesA Server may provide vendor-specific types like types derived from ObjectTypes defined in this document in a vendor-specific namespace.Optional
Vendor specific instances

A Server provides vendor-specific instances of the standard types or vendor-specific instances of vendor-specific types in a vendor-specific namespace.

It is recommended to separate vendor specific types and vendor specific instances into two or more namespaces.

Mandatory

Table 145 provides a list of namespaces and their indices used for BrowseNames in this document. The default namespace of this document is not listed since all BrowseNames without prefix use this default namespace.

Table 145 – Namespaces used in this document
NamespaceURI Namespace Index Example
http://opcfoundation.org/UA/00:EngineeringUnits
http://opcfoundation.org/UA/DI/22:LockingServicesType

Annex A OPC UA for PROFINET Remote IO Namespace and mappings (Normative)

A.1 Namespace and identifiers for OPC UA for PROFINET Remote IO Information Model

This appendix defines the numeric identifiers for all of the numeric NodeIds defined in this document. The identifiers are specified in a CSV file with the following syntax:

<SymbolName>, <Identifier>, <NodeClass>

Where the SymbolName is either the BrowseName of a Type Node or the BrowsePath for an Instance Node that appears in the specification and the Identifier is the numeric value for the NodeId.

The BrowsePath for an Instance Node is constructed by appending the BrowseName of the instance Node to the BrowseName for the containing instance or type. An underscore character is used to separate each BrowseName in the path. Let’s take for example, the <type> ObjectType Node which has the <property> Property. The Name for the <property> InstanceDeclaration within the <type> declaration is: <type>_<property>.

The NamespaceUri for all NodeIds defined here is http://opcfoundation.org/UA/PNRIO/

The CSV released with this version of the specification can be found here:

http://www.opcfoundation.org/UA/schemas/PNRIO/1.0/NodeIds.csv

http://www.opcfoundation.org/UA/schemas/PNRIO/NodeIds.csv

A computer processible version of the complete Information Model defined in this document is also provided. It follows the XML Information Model schema syntax defined in OPC 10000-6.

The Information Model Schema for this version of the document (including any revisions, amendments or errata) can be found here:

http://www.opcfoundation.org/UA/schemas/PNRIO/1.0/Opc.Ua.PNRIO.NodeSet2.xml

http://www.opcfoundation.org/UA/schemas/PNRIO/Opc.Ua.PNRIO.NodeSet2.xml

_____________

Agreement of Use

COPYRIGHT RESTRICTIONS

This document is provided "as is" by the OPC Foundation and the PROFIBUS Nutzerorganisation e.V..

Right of use for this specification is restricted to this specification and does not grant rights of use for referred documents.

Right of use for this specification will be granted without cost.

This document may be distributed through computer systems, printed or copied as long as the content remains unchanged and the document is not modified.

OPC Foundation and PROFIBUS Nutzerorganisation e.V. do not guarantee usability for any purpose and shall not be made liable for any case using the content of this document.

The user of the document agrees to indemnify OPC Foundation and PROFIBUS Nutzerorganisation e.V. and their officers, directors and agents harmless from all demands, claims, actions, losses, damages (including damages from personal injuries), costs and expenses (including attorneys' fees) which are in any way related to activities associated with its use of content from this specification.

The document shall not be used in conjunction with company advertising, shall not be sold or licensed to any party.

The intellectual property and copyright is solely owned by the OPC Foundation and the PROFIBUS Nutzerorganisation e.V..

PATENTS

The attention of adopters is directed to the possibility that compliance with or adoption of OPC or PROFIBUS Nutzerorganisation e.V. specifications may require use of an invention covered by patent rights. OPC Foundation or PROFIBUS Nutzerorganisation e.V. shall not be responsible for identifying patents for which a license may be required by any OPC or PROFIBUS Nutzerorganisation e.V. specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. OPC or PROFIBUS Nutzerorganisation e.V. specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents.

WARRANTY AND LIABILITY DISCLAIMERS

WHILE THIS PUBLICATION IS BELIEVED TO BE ACCURATE, IT IS PROVIDED "AS IS" AND MAY CONTAIN ERRORS OR MISPRINTS. THE OPC FOUDATION NOR PROFIBUS Nutzerorganisation e.V. MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, WITH REGARD TO THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF TITLE OR OWNERSHIP, IMPLIED WARRANTY OF MERCHANTABILITY OR WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE. IN NO EVENT SHALL THE OPC FOUNDATION NOR PROFIBUS Nutzerorganisation e.V. BE LIABLE FOR ERRORS CONTAINED HEREIN OR FOR DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, RELIANCE OR COVER DAMAGES, INCLUDING LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY ANY USER OR ANY THIRD PARTY IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The entire risk as to the quality and performance of software developed using this specification is borne by you.

RESTRICTED RIGHTS LEGEND

This Specification is provided with Restricted Rights. Use, duplication or disclosure by the U.S. government is subject to restrictions as set forth in (a) this Agreement pursuant to DFARs 227.7202-3(a); (b) subparagraph (c)(1)(i) of the Rights in Technical Data and Computer Software clause at DFARs 252.227-7013; or (c) the Commercial Computer Software Restricted Rights clause at FAR 52.227-19 subdivision (c)(1) and (2), as applicable. Contractor / manufacturer are the OPC Foundation, 16101 N. 82nd Street, Suite 3B, Scottsdale, AZ, 85260-1830.

COMPLIANCE

The combination of PROFIBUS Nutzerorganisation e.V. and OPC Foundation shall at all times be the sole entities that may authorize developers, suppliers and sellers of hardware and software to use certification marks, trademarks or other special designations to indicate compliance with these materials as specified within this document. Products developed using this specification may claim compliance or conformance with this specification if and only if the software satisfactorily meets the certification requirements set by PROFIBUS Nutzerorganisation e.V. or the OPC Foundation. Products that do not meet these requirements may claim only that the product was based on this specification and must not claim compliance or conformance with this specification.

Trademarks

Most computer and software brand names have trademarks or registered trademarks. The individual trademarks have not been listed here.

GENERAL PROVISIONS

Should any provision of this Agreement be held to be void, invalid, unenforceable or illegal by a court, the validity and enforceability of the other provisions shall not be affected thereby.

This Agreement shall be governed by and construed under the laws of Germany.

This Agreement embodies the entire understanding between the parties with respect to, and supersedes any prior understanding or agreement (oral or written) relating to, this specification.

Revision 1.00.1 Highlights

The following table includes the Mantis issues resolved with this revision.

Mantis ID Scope Summary Resolution
8078 Documentation ErrataTelegram length property more convenient for input and output telegram objectsRemoved 'TelegramLength' property from PnTelegramType. Replaced 'Offset' Property of PnIoTelegramType with 'Length' property.
8079 Documentation ErrataRioChannelDiagnosisReasonEnumeration item names deviating from naming convention 'APPEARED' changed to 'APPEARS', 'DISAPPEARED' changed to 'DISAPPEARS', 'DISAPPEARED_OTHER_REMAIN' changed to 'DISAPPEARS_OTHER_REMAIN'.
8102Documentation ErrataMethod Argument missing in NodeSetString Argument added in NodeSet for SetApplicationTag Methods.