7.1.3 RioPaAnalogChannelGroupType
The RioPaAnalogChannelGroupType aggregates RioPaAnalogInputChannelType Objects and RioPaAnalogOutputChannelType Objects.
| 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.
7.1.3.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 |
| 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.
| 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. |
7.1.3.2 SetSimulationValue Method
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] RioAnalogDataType 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 23.
| 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. |