7.2.3 Analog Output Channel Types

Figure 23 shows the block diagram for an analog Output Channel.

Figure 23 – Analog RIO Output Channel Block Diagram
7.2.3.1 RioPaAnalogOutputChannelType

The RioPaAnalogOutputChannelType provides access to the data of an analog RIO Output Channel according to RIOforPA.

Table 38 – RioPaAnalogOutputChannelType
Attribute Value
BrowseNameRioPaAnalogOutputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioPaAnalogProcessValueDataTypeRioPaAnalogProcessValueVariableTypeM, RO
0:HasComponentVariableProcessValueReadbackRioPaAnalogProcessValueDataTypeRioPaAnalogProcessValueVariableTypeO, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableSignalValueReadback0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableModeRioChannelModeEnumeration0:BaseDataVariableTypeM, RO
0:HasComponentVariable ManualOutValueRioAnalogDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableSimulationEnabled0:Boolean0:BaseDataVariableTypeM, RO
0:HasComponentVariableSimulationValueRioPaAnalogValueDataType0:BaseDataVariableTypeO, RO
0:HasComponentVariableConfigRioPaAnalogOutputConfigDataTypeRioPaAnalogOutputConfigVariableTypeM, RO
0:HasComponentMethodSetModeO
0:HasComponentMethodSetManualOutValueO
0:HasComponentMethodSetSimulationO
0:HasComponentMethodSetSimulationValueO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the current analog Output value for an automated process.

The ProcessValueReadback Variable contains the readback value obtained by reading the output signal back through the Transducer and the Function Block.

The SignalValue Variable contains the output signal value fed to the signal coupling in the Transducer.

The SignalValueReadback Variable contains the output signal read back through the signal coupling in the Transducer.

The Mode Variable contains the current mode of operation encoded as RioChannelModeEnumeration. If Mode has the Value MANUAL, the Value of the ManualOutValue Variable shall be used as Output value in place of the Process Value.

The ManualOutValue Variable contains the value used as Output value to an automated process in place of the Process Value if the Mode Variable of the channel contains the Value MANUAL.

The SimulationEnabled Variable contains True if the Value of the SimulationValue Variable shall be used as Output value in place of the Process Value, otherwise False.

The SimulationValue Variable contains the value used as Output value in place of the Process Value if the SimulationEnabled Variable contains True.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioPaAnalogOutputConfigVariableType (See chapter 9.4.7).

7.2.3.2 SetMode Method

This Method sets the Value of the Mode Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetMode (
		[in] RioChannelModeEnumeration	Mode	
		);
	
Argument Description
ModeDesired content of the Mode Variable.

The Method Result Codes (defined in Call Service) are defined in Table 39.

Table 39 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is currently not able to perform the demanded mode change.
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.

If the Mode Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.3.3 SetManualOutValue Method

This Method sets the Value of the ManualOutValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetManualOutValue (
		[in] RioAnalogDataType		ManualOutValue
		);
	
Argument Description
ManualOutValueDesired Value of the ManualOutValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 40.

Table 40 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value. For instance, the Server might reject manual values not within the channels value bounds.
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.

If the ManualOutValue Variable has already the same Value as the argument, the Method shall do nothing and return Good as result code.

7.2.3.4 SetSimulation Method

This Method sets the Value of the SimulationEnabled Variable to the desired value. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulation (
		[in] 0:Boolean	SimulationEnabled
	);
	
Argument Description
SimulationEnabledDesired content of the SimulationEnabled Variable.

The Method Result Codes (defined in Call Service) are defined in Table 41.

Table 41 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_NotSupportedThe Server is not able to change into target mode.
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.

If the SimulationEnabled Variable already has the value of the argument, the Method shall do nothing and return Good as result code.

7.2.3.5 SetSimulationValue Method

This Method sets the Value of the SimulationValue Variable. The security constraints defined in chapter 6.7 apply.

Signature

	SetSimulationValue (
		[in] 0:RioAnalogDataType	Value
		[in] 0:Byte		Qualifier
		);
	
Argument Description
ValueDesired content of the Value member of the SimulationValue Variable.
QualifierDesired content of the Qualifier member of the SimulationValue Variable.

The Method Result Codes (defined in Call Service) are defined in Table 42.

Table 42 – Possible Method result codes
Result Code Description
GoodThe Method execution was successful.
Bad_UserAccessDeniedThe user has not the right to execute the Method.
Bad_InvalidArgumentThe Server is not able to apply the argument value. For instance, the Server might reject simulation values not within the channels value bounds.
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.2.3.6 RioFaAnalogOutputChannelType

The RioFaAnalogOutputChannelType provides access to the data of an analog RIO Output Channel according to RIOforFA.

Table 43 – RioFaAnalogOutputChannelType
Attribute Value
BrowseNameRioFaAnalogOutputChannelType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Other
Subtype of the RioChannelType.
0:HasComponentVariableProcessValueRioFaAnalogProcessValueDataTypeRioFaAnalogProcessValueVariableTypeM, RO
0:HasComponentVariableProcessValueReadbackRioFaAnalogProcessValueDataTypeRioFaAnalogProcessValueVariableTypeO, RO
0:HasComponentVariableSignalValue0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableSignalValueReadback0:Double0:BaseAnalogTypeO, RO
0:HasComponentVariableConfigRioFaAnalogOutputConfigDataTypeRioFaAnalogOutputConfigVariableTypeM, RO
Conformance Units
PNRIO Channel Objects

The ProcessValue Variable contains the current analog Output value for an automated process.

The ProcessValueReadback Variable contains the readback value obtained by reading the output signal back through the Transducer and the Function Block.

The SignalValue Variable contains the output signal value fed to the signal coupling in the Transducer.

The SignalValueReadback Variable contains the output signal read back through the signal coupling in the Transducer.

The Config Variable contains the configuration properties available for the RIO Channel. See the definition of the RioFaAnalogOutputConfigVariableType (see chapter 9.4.8).