The RioPaAnalogChannelGroupType aggregates RioPaAnalogInputChannelType Objects and RioPaAnalogOutputChannelType Objects.

Table 21 – RioPaAnalogChannelGroupType Definition

Attribute	Value
BrowseName	RioPaAnalogChannelGroupType
IsAbstract	False
References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the RioChannelGroupType.
HasRioProcessVariable	Variable	InputValues	RioPaAnalogValueDataType[]	0:BaseDataVariableType	O, RO
HasRioProcessVariable	Variable	OutputValues	RioPaAnalogValueDataType[]	0:BaseDataVariableType	O, RO
0:HasProperty	Variable	SimulationValues	RioPaAnalogValueDataType[]	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 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.

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 22.

Table 22 – 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 array Variable. The security constraints defined in chapter 6.7 apply.

Signature

SetSimulationValue (

[in] RioAnalogDataTypeValue

[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 23.

Table 23 – 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. The server might also reject invalid values outside the supported range.
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.