Defined terms of OPC UA specifications, types and their components defined in OPC UA specifications and in this specification are highlighted with italic in this document.
Certain Ethernet POWERLINK related terms and names are used together with POWERLINK, especially in cases where the terms might lead to naming conflicts with existing OPCUA terms. For instance the term Managing Node (a device role in POWERLINK) contains the word Node that has a different meaning in OPC UA.
Table 1 contains a list with the most prominent examples for common terms that have different meanings in OPC UA and POWERLINK.
Table 1 – Common terms with different meanings
Term |
OPC UA |
POWERLINK |
OPC 10000-1: The fundamental component of an AddressSpace.
|
Commonly used for physical devices in a POWERLINK network. Terms: |
|
OPC 10000-3: Nodes are unambiguously identified using a constructed identifier called the NodeId. |
Each POWERLINK Device (MN, CN and Router) is addressed by an 8 bit POWERLINK Node ID on the POWERLINK layer. This ID has only local significance (i.e. it is unique within a POWERLINK segment) and addresses a physical device whereas the NodeId of OPC UA addresses elements of the internal object dictionary. |
|
OPC 10000-3: Objects and their components are represented in the AddressSpace as a set of Nodes described by Attributes and interconnected by References. |
Data object: Element of the POWERLINK Object Dictionary Process data object: Object for isochronous data exchange between Service data object: Peer to peer communication with access to the POWERLINK Object Dictionary of a device. |
|
OPC 10000-6: Specifies how to implement an OPC UA feature with a specific technology.
Note: For example, the OPC UA Binary Encoding is a Mapping that specifies how to serialise OPC UA data structures as sequences of bytes. |
Selection of the POWERLINK Objects that are sent or received via PDOs. |
For the purposes of this document, the terms and definitions given in the referenced OPC UA Specifications as well as the following apply.
data in a POWERLINK network that is not time critical
Note 1 to entry: Within the POWERLINK cycle there is a specific period reserved for Asynchronous POWERLINK Data which is shared by all POWERLINK Devices. Each POWERLINK Device connected to the network can send asynchronous data by requesting it to the POWERLINK Managing Node. The POWERLINK Managing Node keeps a list of all asynchronous data requests and will subsequently grant the network access to one POWERLINK Device after the other.
communication process with predictable timing behaviour (I.e. the time when a message reaches the recipient is predictable)
data in a POWERLINK network which is to be transmitted every cycle (or every nth cycle in case of multiplexed isochronous data)
ethernet as standardised in IEEE 802.3 (non-deterministic operation in non-time-critical environments)
Network Management State of a POWERLINK Device
POWERLINK Device without the ability to manage the SCNM mechanism
standardised or vendor specific definition of an object model
POWERLINK Device capable to manage the SCNM mechanism in a POWERLINK network
device in a POWERLINK network
data object, addressed by Index and Sub-Index
repository of all POWERLINK Objects accessible over POWERLINK communications
record data type (as defined in the POWERLINK specification EPSG DS 301)
XML file for the description of the objects in a POWERLINK Object Dictionary (also called XDD)
Note 1 to entry: This description contains metadata about the POWERLINK Objects and about the POWERLINK Device.
A&EAlarms & Events
ANSIAmerican National Standards Institute
APIApplication Program Interface
CNPOWERLINK Controlled Node
CSMA/CDCarrier Sense Multiple Access/Collision Detection
DAData Access
EPSGEthernet POWERLINK Standardization Group
HDAHistorical Data Access
HMI Human-Machine Interface
IECInternational Electrotechnical Commission
IMOPC UA Information Model
IPInternet Protocol - RFC 791
ISOInternational Organization for Standardization
LANLocal Area Network
MESManufacturing Execution System
MNPOWERLINK Managing Node
NaN"Not a Number", a unique binary pattern representing an invalid number
(ANSI/IEEE 754-1985)
NATNetwork Address Translation - RFC 2663
NMTNetwork Management
ODPOWERLINK Object Dictionary
PDOPOWERLINK Process Data Object
RTEReal Time Ethernet
SCADASupervisory Control And Data Acquisition
SCNMSlot Communication Network Management
UA Unified Architecture
UTCUniversal Time Coordinated
XDDPOWERLINK XML device description
XMLExtensible Markup Language
Node definitions are specified using tables (See Table 2)
Table 2 – Type Definition table
Attribute |
Value |
||||
Attribute name |
Attribute value. If it is an optional Attribute that is not set “--“ will be used. |
||||
|
|
||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
ReferenceType name |
BrowseName of the target Node. If the Reference is to be instantiated by the server, then the value of the target Node’s BrowseName is “--“. |
Attributes of the referenced Node, only applicable for Variables and Objects.
|
Referenced ModellingRule of the referenced Object. |
||
Notes – Notes referencing footnotes of the table content. |
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. That implies that the referenced Node has a HasModelParent Reference with the Node defined in the Table as TargetNode (see OPC 10000-3 for the definition of ModelParents).
- 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. In Table 3 examples are given.
Table 3 – Examples of DataTypes
Notation |
DataType |
ValueRank |
ArrayDimensions |
Description |
Int32 |
Int32 |
-1 |
omitted or NULL |
A scalar Int32 |
Int32[] |
Int32 |
1 |
omitted or {0} |
Single-dimensional array of Int32 with an unknown size |
Int32[][] |
Int32 |
2 |
omitted or {0,0} |
Two-dimensional array of Int32 with unknown sizes for both dimensions |
Int32[3][] |
Int32 |
2 |
{3,0} |
Two-dimensional array of Int32 with a size of 3 for the first dimension and an unknown size for the second dimension |
Int32[5][3] |
Int32 |
2 |
{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 |
Int32{Any} |
Int32 |
-2 |
omitted or NULL |
An Int32 where it is unknown if it is scalar or array with any number of dimensions |
Int32{ScalarOrOneDimension} |
Int32 |
-3 |
omitted or NULL |
An 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 NodeId of a TypeDefinitionNode, i.e. the specified Node points with a HasTypeDefinition Reference to the corresponding TypeDefinitionNode. The symbolic name of the NodeId is used in the table.
- 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.
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 of this document points to their definition.
If no components are provided, the DataType, TypeDefinition and ModellingRule columns may be omitted and only a Comment column is introduced to point to the Node definition.
Components of Nodes can be complex, i.e. containing components by themselves. The TypeDefinition, NodeClass, DataType and ModellingRule can be derived from the type definitions, and the symbolic name can be created as defined in 3.4.2.1. Therefore those containing components are not explicitly specified; they are implicitly specified by the type definitions.
The NodeIds of all Nodes described in this document 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 namespace for this specification is defined in Annex A. The NamespaceIndex for all NodeIds defined in this specification is server specific and depends on the position of the namespace URI in the server namespace table.
Note: This specification does not only define concrete Nodes, but also requires that some Nodes have to be generated, for example one for each device type available in the frame application. 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 by this specification, because they are not defined by this specification but generated by the Server.
The text part of the BrowseNames for all Nodes defined in this specification is specified in the tables defining the Nodes. The NamespaceIndex for all BrowseNames defined in this specification is server specific and depends on the position of the namespace URI defined in this specification in the server namespace table.
If the BrowseName is not defined by this specification, a NamespaceIndex prefix like ‘0:EngineeringUnits’ is added to the BrowseName. This is typically necessary if a Property of another specification is overwritten or used in the OPC UA types defined in this specification. Table 56 provides a list of namespaces used in this specification.
For all Nodes specified in this specification, the Attributes named in Table 4 shall be set as specified in the table.
Table 4 – Common Node Attributes
Attribute |
Value |
DisplayName |
The 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 is vendor specific. |
Description |
Optionally a vendor specific description is provided |
NodeClass |
|
NodeId |
The NodeId is described by BrowseNames as defined in 3.4.2.1 and defined in Annex A. |
WriteMask |
Optionally the WriteMask Attribute can be provided. If the WriteMask Attribute is provided, it shall set all Attributes to not writeable that are not said to be vendor-specific. For example, the Description Attribute may be set to writeable since a Server may provide a server-specific description for the Node. The NodeId shall not be writeable, because it is defined for each Node in this specification. |
UserWriteMask |
Optionally the UserWriteMask Attribute can be provided. The same rules as for the WriteMask Attribute apply. |
For all Objects specified in this specification, the Attributes named in Table 5 shall be set as specified in the table.
Table 5 – Common Object Attributes
Attribute |
Value |
EventNotifier |
Whether the Node can be used to subscribe to Events or not is vendor specific |
For all Variables specified in this specification, the Attributes named in Table 6 shall be set as specified in the table.
Table 6 – Common Variable Attributes
Attribute |
Value |
MinimumSamplingInterval |
Optionally, a vendor-specific minimum sampling interval is provided |
AccessLevel |
The access level for Variables used for type definitions is vendor-specific, for all other Variables defined in this part, the access level shall allow a current read; other settings are vendor specific. |
UserAccessLevel |
The value for the UserAccessLevel Attribute is vendor-specific. It is assumed that all Variables can be accessed by at least one user. |
Value |
For Variables used as InstanceDeclarations, the value is vendor-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 vendor-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. |
For all VariableTypes specified in this specification, the Attributes named in Table 7 shall be set as specified in the table.
Table 7 – Common VariableType Attributes
Attributes |
Value |
Value |
Optionally a vendor-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 vendor-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. |