The RioPaDigitalChannelGroupType aggregates RioPaDigitalInputChannelType Objects and RioPaDigitalOutputChannelType Objects.

Table 25 – RioPaDigitalChannelGroupType Definition

Attribute	Value
BrowseName	RioPaDigitalChannelGroupType
IsAbstract	False
References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the RioChannelGroupType.
HasRioProcessVariable	Variable	InputImage	RioPaDigitalValueDataType[]	0:BaseDataVariableType	O, RO
HasRioProcessVariable	Variable	OutputImage	RioPaDigitalValueDataType []	0:BaseDataVariableType	O, RO
0:HasProperty	Variable	SimulationValues	RioPaDigitalValueDataType[]	0:PropertyType	O, RO
0:HasComponent	Variable	SimulationEnabled	0:Boolean[]	0:BaseDataVariableType	O, RO
0:HasComponent	Method	SetSimulation			O
0:HasComponent	Method	SetSimulationValue			O
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.

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
SimulationEnabled	Value used to set the Value of one SimulationEnabled array element.
Index	Index 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
Good	The Method execution was successful.
Bad_UserAccessDenied	The Client has not the right to execute the Method since the Operator Role is not granted to the Client’s Session.
Bad_InvalidArgument	The Server is not able to assign the value. Possible reason: Invalid index.
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.

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
Value	Value used to set the Value member of the array element.
Qualifier	Value used to set the Qualifier member of the array element.
Index	Index 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
Good	The Method execution was successful.
Bad_UserAccessDenied	The Client has not the right to execute the Method since the Operator Role is not granted to the Client’s Session
Bad_InvalidArgument	The Server is not able to assign the values. Possible reasons: Invalid qualifier value, invalid index.
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.