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 |
||||
|
BrowseName |
RioChannelType |
||||
|
IsAbstract |
True |
||||
|
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
|
Subtype of the BaseObjectType defined in OPC 10000-5. |
|||||
|
0:HasProperty |
Variable |
RioChannelNumber |
0:UInt16 |
0:PropertyType |
M, RO |
|
0:HasProperty |
Variable |
ApplicationTag |
0:String |
0:PropertyType |
M, RO |
|
0:HasComponent |
Method |
SetApplicationTag |
|
|
O |
|
0:HasProperty |
Variable |
LastParameterChange |
0:DateTime |
0:PropertyType |
O, RO |
|
0:HasComponent |
Object |
Lock |
|
2:LockingServicesType |
O |
|
0:GeneratesEvent |
ObjectType |
RioChannelDiagnosisEventType |
|
|
|
|
0:GeneratesEvent |
ObjectType |
RioChannelDiagnosisAlarmType |
|
|
|
|
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.
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 |
|
ApplicationTag |
String 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 |
|
Good |
The Method execution was successful. |
|
Bad_UserAccessDenied |
The user has not the right to execute the Method. |
|
Bad_InvalidArgument |
The 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_UnexpectedError |
The 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.