Agilent Technologies VXI E1439 - Manual (Page 126)

116
Agilent E1439 Programmer's Reference
Functions listed alphabetically
age1439_fiber_verify
This function verifies the operational condition of the fiber interface.
VXIplug&play Syntax
#include "age1439".h
ViStatus age1439_fiber_verify(ViSession id, ViInt16 verifyPath, ViInt16 sec);
Description
This function performs a verification of the fiber interface using either an internal or an external
signal path. The internal signal path cannot test the actual RX/TX ports but does test the internal
connections of the fiber interface to the rest of the module. The external signal path does test the
RX/TX ports but requires connecting an optical short between the RX and TX fiber ports.
Note
No fiber optic cables should be connected or disconnected during verification.
Parameter
id is the VXI instrument session pointer returned by the age1439_init function.
verifyPath indicates which path, internal or external, is being tested by age1439_fiber_verify.
AGE1439_FIBER_VERIFY_INTERNAL verifies the internal fiber interface connections to the
rest of the module.
Note
age1439_self_test performs five-second internal fiber verification.
AGE1439_FIBER_VERIFY_EXTERNAL verifies the operational condition of the RX and TX
fiber ports by connecting an optical short between them.
sec sets the number of seconds the verification procedure will last based on this argument.
AGE1439_FIBER_VERIFY_MIN sets minimum fiber verification time in seconds.
AGE1439_FIBER_VERIFY_MAX sets maximum fiber verification time in seconds.
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
“age1439_error_message” on
page 102
See Also
“age1439_init” on page 132 , “age1439_self_test” on page 170