Agilent Technologies E1439 User Manual page 192

Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_trigger_phase_actual_get
Returns a representation of the phase value of the LO at the most recent trigger point.
VXIplug&play Syntax
ViStatus age1439_trigger_phase_actual_get(ViSession id, ViPInt16 actualPhasePtr);
Parameters
id is the VXI instrument session pointer returned by the age1439_init function.
points to the returned value which is an integer from − 32768 to 32767 and should be interpreted as
actualPhasePtr
follows:
In other words, each count represents 360/65536 degrees of phase.
To convert the returned phase value to degrees, multiply the returned value by 360/65536.
In multiple module systems, the actual phase of the triggering module should be used to correct
data from other modules in the system.
The returned phase value represents the digital LO's phase at the time of the actual trigger. This
time may vary from the time of the desired trigger by the value returned by
delay_actual_get.
The LO phase could be used in time domain averaging of blocks, or other operations involving
zoomed blocks of data, so that the varying phase of the LO can be removed from the calculation.
Return Value
AGE1439_SUCCESS indicates that a function was successful.
Values other than AGE1439_SUCCESS indicate an error condition or other important status
condition. To determine the error message, pass the return value to
page
See Also
"age1439_init" on page
actual_get" on page
measurements" in chapter
182
#include "age1439".h
AGE1439_TRIG_PHASE_0 represents 0 degrees (or 0)
AGE1439_TRIG_PHASE_90 represents 90 degrees (or 16384)
AGE1439_TRIG_PHASE_180 represents ±180 degrees (or -32768)
AGE1439_TRIG_PHASE_270 represents +270 (-90) degrees (or -16384)
102.
132, "age1439_trigger_setup" on page
181, "age1439_frequency_setup" on page
3, "Trigger and phase in multi-module systems" in chapter 3
age1439_trigger_
"age1439_error_message" on
183, "age1439_trigger_delay_
128, "Delay and phase in triggered