RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
293
innovators for industry
Ctrl Command get_values
Function
returns the current values of up to four specified signals
Call
get_values( SignalPtr, ResultPtr )
Parameters
SignalPtr
pointer (in C and C
++
data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to an array of four unsigned 32-bit values, where the desired signal
types are specified
ResultPtr
pointer (in C and C
++
data type ULONG_PTR, i.e. an unsigned 32-bit or 64-bit
value) to an array of four signed 32-bit values, where the current values of the
up to four specified signals should be stored
Comments
• Up to four desired signals can be simultaneously queried. The selectable signal types are
identical to those of the
command (refer to the comments there for the
allowable value range, signal types and other information). The desired signal types
must be specified via
SignalPtr
. The corresponding signal values will then be stored via
ResultPtr
. For storage of each queried data set, the application must make available
(at the address specified via
ResultPtr
) 4 · 4 bytes of PC memory.
•
get_values
functions similarly to the
command (see comments there).
get_values
will return 0 and perform no query on channels for which an invalid signal
type was specified via
SignalPtr
RTC5_PARAM_ERROR
will only be generated if all four specified signal types are invalid.
• If any of the pointer parameters are NULL, then the command will not be executed (all
return values are 0) and a
return code of
RTC5_PARAM_ERROR
will be
generated.
RTC
®
4
RTC
®
5 new command
Even in RTC
®
4 compatibility mode, the four returned values are in the RTC
®
5’s 20-bit
range, but get transferred to the PC as 32-bit data. Therefore, you must evaluate the values
accordingly (see comments for
Version info
• Available beginning with version DLL 516, OUT 515, RBF 512
• Last change (with version DLL 536, OUT 536): Additional selectable data signals (see
References
Ctrl Command get_wait_status
Function
returns the wait state of the RTC
®
5
Call
WaitStatus = get_wait_status()
Result
wait state as an unsigned 32-bit value
Comments
• If processing has stopped at a wait marker, the command
get_wait_status
returns the
number of this marker. See
• If no wait marker was reached, the command
get_wait_status
returns zero.
• Processing of the list can be resumed by calling the command
.
RTC
®
4
RTC
®
5 unchanged functionality
References