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.