Dll Function Descriptions; Initializing And Referencing The Sws; Insertion Loss Functions - JDS Uniphase SWS15100 User Manual

DLL Function Descriptions

The functions contained in the DLLs are listed in the following sections. For each function, the
calling sequence and parameters are provided for both C and Visual Basic (VB). In addition, a
short description of the function's purpose is provided.

Initializing and Referencing the SWS

The following functions are used to initialize and reference the SWS.
Note that a separate getPDLReference function is used to get zero loss references in PDL
mode. That function is documented under the section PDL Functions.
Function Name
initSWS
getDarkVoltage
IsDarkVoltage
Done
GetAverageDark
VoltagePower
isZeroLossDone
getReference
getAverageZeroLoss
Power

Insertion Loss Functions

The following functions are used to acquire Insertion Loss traces from the SWS. Follow the
programming flowcharts in the Programming Guide to tie these functions together.
Function Name
getTraceStatus
triggerTrace
isTraceDone ..................... Determines whether the trace has been completed
getTraces
getDataSize
getILTrace
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
Description
Initializes the DLL sub-system
Collects the dark voltage trace from the hardware
Checks if a dark voltage measurement has been performed for the
specified channel.
Finds average power measured during a dark voltage
measurement.
Checks if a zero loss reference has been done for a specified
polarization
Collects the zero loss reference trace data from the hardware. Call
this function after triggering a trace with the triggerTrace function.
Gets the average zero loss power for a specified channel and
polarization
Description
Gets the hardware trace status.
Triggers a new trace
Collects the trace data from the hardware
Determines the length of the trace from the start wavelength to the
maximum wavelength, defined by LambdaMax in the SWS15100.INI
file
Returns the IL trace from the last collection
Programming Guide – 125