Summary of Contents for Keysight Technologies N7700
Page 1
Keysight N7700 Photonic Application Suite Fast Spectral Loss Measurement Engine User’s Guide...
Page 2
(EULA), a copy of which can be found HEREIN, INCLUDING BUT NOT LIMITED TO at http://www.keysight.com/find/sweula. THE IMPLIED WARRANTIES OF MER- The license set forth in the EULA represents CHANTABILITY AND FITNESS FOR A PAR- Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 3
“Monitoring and Control instrumentation” product. Do not dispose in domestic household waste. To return unwanted products, contact your local Keysight office, or see http://about.keysight.com/en/companyinfo/environment/takeback.shtml for more information. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 4
Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Fast Spectral Loss Measurement Setup Software User Interface 2 Getting Started About this manual System Requirements Software Installation Connecting the instruments Running the Configuration Wizard 3 Fast Spectral Loss Measurement Application General Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 6
Changing the Color Theme TLS Lambda Zeroing Configuration Handling Measurement Setup 4 Automation COM Components Creating a New Engine Connecting to an Existing Engine Performing a Measurement Accessing the Measurement Result Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 7
Contents Reference: Interface “IEngineMgr” property Version method IsVersionGreaterOrEqual method NewEngine method OpenEngine property EngineIDs method DeleteEngine Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 9
Measurement Status Box not visible Graphs are flickering when using high measurement repetition rates The list of values for a drop-down control appears invisible or displaced COM API registration fails Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 10
Contents Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 11
Keysight N7700 Photonic Application Suite User’s Guide Quick Start Information / 13 Fast Spectral Loss Measurement Setup / 14 Software User Interface This section demonstrates how to connect your instruments optically and electrically for fast wavelength-swept insertion loss measurements using the Photonic Application Suite.
Page 12
Wizard. After finishing the wizard, the application is displayed with all the configured instruments. If you change your hardware configuration, run the wizard again by clicking on File->Run Configuration Wizard. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Quick Start Information Fast Spectral Loss Measurement Setup Figure 1 Insertion Loss Setup Refer to on page 49 for more information on Measurement Setup NOTE measurement setup. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Server Software. The server will be automatically started when you click on “Fast Spectral Loss”. The presence of the server is indicated in the task bar: Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 15
Keysight N7700 Photonic Application Suite User’s Guide Getting Started / 16 About this manual / 17 System Requirements / 18 Software Installation / 19 Connecting the instruments / 20 Running the Configuration Wizard...
Keysight’s optical power meters with one of supported Keysight’s tunable laser sources. You might also refer to the N7700 Keysight Photonic Application Suite User's Guide to get information on the core Photonic Application Suite functionality including the File Viewer, Plugins, and the general COM API.
Depending on the instruments, PC interfaces to LAN, USB, and GPIB can be used. Using the TLS in an 8163B / 8164B mainframe will reduce data transfer NOTE time, thus increase the measurement repetition rate. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Suite installation package. The Package Manager will indicate if any required packages are missing and still need to be installed. Refer to the N7700 Photonic Application User’s Guide for information on how to install this software. Instruments connected via GPIB and often USB will usually be recognized automatically for VISA, for example by Connection Expert when using Keysight VISA.
The Fast Spectral Loss Measurement application requires the trigger NOTE output of the tunable laser source to be connected to the trigger input port of the power meter. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Once the software is installed and the instruments are connected and turned on, you can start the Fast Spectral Loss Engine and run the Configuration Wizard. On first startup the Configuration Wizard will come up automatically. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 21
Getting Started If you want to rerun the Configuration Wizard, you can select on Run Configuration Wizard from the File menu. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 22
Getting Started Please follow the instructions shown by the Configuration Wizard. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Keysight N7700 Photonic Application Suite User’s Guide Fast Spectral Loss Measurement Application / 24 General / 25 Fast Spectral Loss Measurement Application / 27 Application Setup Parameters / 31 Instrument Setup Parameters / 33 Using the Port/Reference Manager / 34...
Page 24
Launch pad that is found in the Start menu. Figure 2 The Launch Pad gives you access to the installed components. Click on “Fast Spectral Loss” to start the Fast Spectral Loss Engine. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
The measurement control buttons are displayed in the top left portion of the application window, the measurement parameters are shown to the right of these. Details on the parameters are given in the tables in the next section. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 26
Enable the Status sounds check box to receive auditory notifications (beeps) when the status of the engine operations change, for example, when a measurement completes or when an error is encountered. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 27
Defines the stop of the wavelength sweep. (right parameter of Wavelength Range) Sweep Rate (nm/s) Defines the sweep speed of the TLS. Choosing high sweep rates reduces the time required for each measurement. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 28
1us. The maximum allowed averaging time is defined by several parameters, such as the sweep rate and the step size. The software will automatically adjust this parameter, if it conflicts with other parameters. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
By default, all ports will use this setting. See Range Override on page 34” for details on how to use different settings for different power meter ports. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 30
The range will be adjusted individually for each port. The most sensitive range will be chosen for which no clipping will occur. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 31
Automatically: Whenever a zeroing operation is required, it is performed automatically right before the next measurement. This is the recommended setting for optimum lambda accuracy. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 32
(this period is 24h or 4h right after running the Configuration Wizard). Please note that the actual number of sweeps and sweep parameters of the TLS have no impact on this period of time. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 33
Configure what power range settings to be used. • Perform zeroing on individual channels. • Handle power references. You can access the Port/Reference Manager by clicking the Port/Ref. Manager button to the top-left. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
(RngSpc) as well as to reference sweep settings (RefSpc). For regular measurements, you may also set individual stitching settings (number of scans and range decrement per scan). Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
GUI and the Port/Reference Manager. Auto ranging can be used for reference sweeps as well as port-specific range settings (See “Range Override on page 34” for details on how to use different ranges for different power meter ports.). Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 36
You can load, save and delete reference files by clicking the Load Ref., Save Ref. and Delete Ref. buttons. By clicking either button, a list of reference files will be displayed to choose from. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
(refer to the power meter's specifications for further details). Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 38
You can use the Port/Reference Manager to check and modify those settings or click on the Port-Specific check box to reset all individual settings, so that all ports use the global settings from the main GUI once again. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
• Run Single: You can perform single measurements by clicking Run Single. • Run Repeat: By clicking Run Repeat the software will perform single measurements in a repeat mode. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Saving Measurements You can save measurement data using the Save As option from the measurement context menu in the browser tree and providing a filename. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
You may also load one or more files using drag and drop, dropping OMR files anywhere on the engine GUI except for the measurement trace / graph regions. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
On the other hand you may want to increase the number for obtaining many measurement files without having to perform manual saves, or having to use measurement automation. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 43
To do so, set the Number of measurements shown value in the options to the desired value or to 0 to disable this feature. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 44
Number of measurements shown value. For each new measurement after that, the oldest history file will be closed automatically. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 45
This is usually desired, when using automatic history file display with single-port devices, or devices, where individual ports are clearly distinguishable. See examples for both modes below. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 46
Workspace at once, click Close All from the context menu of the Workspace node in the tree on the left of the GUI. History files are stored in an engine specific subfolder of NOTE C:\Users\<username>\Documents\My Photonic Application Suite History\ Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
You can switch to a lighter color theme for the File Viewer within the user interface of Fast Spectral Loss Engine. Click the Settings icon and disable the Dark Mode check box in the Graphs section. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Save Configuration and Load Configuration. A saved configuration file (*.agconfig) can also be started from the Windows Explorer and will launch the appropriate engine if it’s not running. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Measurement Setup The general setup is illustrated in the following diagram: Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 50
(angled / straight). • Connect any optical output of the DUT to the optical inputs of the power meter using patchcords with appropriate connectors (angled / straight). Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Keysight N7700 Photonic Application Suite User’s Guide Automation / 52 COM Components / 54 Creating a New Engine / 56 Connecting to an Existing Engine / 57 Performing a Measurement / 58 Accessing the Measurement Result / 60 Reference: Interface “IEngineMgr”...
% Release the engine and the engine manager Engine.release; EngineMgr.release; This example assumes that you have already started the Client Software and thus a server is already running. Therefore, this example connects to an existing engine. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 53
Automation The next section explains how to create a new instance of the engine, in case the server has not yet been started. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
We recommend to configure your engine initially using the Client Software and store the configuration using the “Save Configuration” menu. This example uses the “LoadConfiguration” command to load an .agconfig-file which has been stored before by the client. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 55
The above screenshot is for illustrative purpose only. The message log in your server console might look different from what is displayed above. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
% Release the engine and the engine manager Engine.release; EngineMgr.release; In most of the following MATLAB examples, we assume that the engine NOTE has been created and activated before. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
% Wait for measurement to be finished while Engine.Busy; pause(1); end; % Get result object MeasurementResult = Engine.MeasurementResult; % Save as OMR file MeasurementResult.Write('c:\test.omr'); % Release measurement object MeasurementResult.release; Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
The measurement result is returned as reference to a file object. This file COM object represents an OMR file and wraps all methods to read and write these files (Interface: IOMRFile). Refer to the N7700 Photonic Application Suite User’s Guide for a NOTE reference of the common interfaces, e.g. IOMRFile, IOMRGraph and IOMRProperty.
Page 59
42 to learn how to disable automatic Automatic History Saves saves). To deal with this behavior, either implement retries or delays on affected operations or avoid connecting multiple instances to the same measurement engine server. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 60
NewEngine Type-Library: HRESULT NewEngine([out,retval] IEngine** aEngine); MATLAB: Engine=EngineMgr.NewEngine; Tells the engine manager to create a new engine and returns the corresponding handle. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 61
DeActivate method and before releasing the engine object. After that, either create a new engine or release the EngineMgr object. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 62
This is done using the “LoadConfiguration” method. Activating an engine will cause the server to communicate with the instruments. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 64
Transfers the contents of an .agconfig-file to or from the engine. An .agconfig-file contains XML formatted text. property SoftwareConfiguration Type-Library: put: HRESULT SoftwareConfiguration([in] BSTR ConfigXML); MATLAB: Engine.SoftwareConfiguration = xml; Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 65
WavelengthStop Type-Library: get: HRESULT WavelengthStop([out, retval] DOUBLE* pVal); put: HRESULT WavelengthStop([in] DOUBLE Val); MATLAB: d = Engine.WavelengthStop; Engine.WavelengthStop = d; Sets or gets the stop wavelength in nm. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 66
MATLAB: d = Engine.SweepRate; Engine.SweepRate = d; Sets or gets the sweep rate in nm/s. property UseTwoWay Type-Library: get: HRESULT UseTwoWay([out, retval] BOOL* pVal); put: HRESULT UseTwoWay([in] BOOL Val); Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 67
Please note that any port-specific settings will no longer be affected by the global PWMSensitivity setting. property NumberOfScans Type- Library: get: HRESULT NumberOfScans([out, retval] LONG* pVal); put: HRESULT NumberOfScans([in] LONG Val); Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 68
Engine.PWMSensitivityRef= d; Sets or gets the power meter sensitivity for the reference sweep in dBm. This property has to be set in multiples of 10dBm (- 20dBm to +10dBm). Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 69
= Engine.PWMAvgTime; Engine.PWMAvgTime = d; Sets or gets the power meter averaging time in us. This property has to be set in multiples of 1us with a minimum of 1us. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 70
Pass a line array instead, with a dummy value as a second element, e.g., Engine.MethodName(int32([3 3)). property TLSOutputPort Type-Library: get: HRESULT TLSOutputPort([out, retval] LONG* pVal); put: HRESULT TLSOutputPort([in] LONG Val); MATLAB: Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 71
Set to 0/1/2 for Automatically/Always Ask/Manual Only. Refer to Instrument Setup Parameters on page 31 for further details. method ZeroAllTLS Type-Library: HRESULT ZeroAllTLS(void); MATLAB: Engine.ZeroAllTLS; Performs a lambda zeroing operation on the tunable laser source. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 72
As a parameter an integer array of port numbers (starting at 0 for port 1) must be provided. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 73
Pass a line array instead, with a dummy value as a second element, e.g., Engine.MethodName(int32([3 3)). method UndoReferenceOperation Type-Library: HRESULT UndoReferenceOperation(void); MATLAB: Engine.UndoReferenceOperation; Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 74
HRESULT ReferenceList([out, retval] BSTR* pVal); MATLAB: s = Engine.ReferenceList; Returns an xml string containing the filenames and important parameters for all reference files available on the engine server. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 75
/ stitching settings for certain ports. Contains additional information for internal use. method StartMeasurement Type-Library: HRESULT StartMeasurement(void); MATLAB: Engine.StartMeasurement; Starts a measurement. method StartMeasurementRepeat Type-Library: HRESULT StartMeasurementRepeat(void); MATLAB: Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 76
Accessing the Measurement Result on page 58. property MeasurementResult Type-Library: HRESULT MeasurementResult([out, retval] IOMRFile** pVal); MATLAB: Result = Engine.MeasurementResult; Returns a reference to the underlying IOMRFile object which contains the measurement result. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 77
Automation Refer to the N7700 Photonic Application Suite User’s Guide for a NOTE reference of the common interfaces, e.g. IOMRFile, IOMRGraph and IOMRProperty. See the last Note in “Accessing the Measurement Result”. property EventPropertiesChanged Type-Library: get: HRESULT EventPropertiesChanged([out, retval] LONG* pVal);...
Page 78
ProtocolMin Type-Library: get: HRESULT ProtocolMin([out, retval] LONG* pVal) MATLAB: First = Engine.ProtocolMin; Returns the index to the first entry in the message list. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 79
Set to 0 after you have handled the user input (see method UserInputResponse on page 80) property UserInputPrompt Type-Library: get: HRESULT UserInputPrompt([out, retval] BSTR* pVal) MATLAB: Prompt = Engine.UserInputPrompt; Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 80
Set the response to a user input request. Must be a number from the list obtained by Engine.UserInputChoice. to 0 after setting Engine.UserInputWaiting for the engine to continue operation. Engine.UserInputResponse Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 82
Automation WavelengthStart, WavelengthStep, WavelengthStop, ZeroAllTLS, ZeroPWMChannels, Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 83
Keysight N7700 Photonic Application Suite User’s Guide Troubleshooting / 84 Symptoms and Solutions...
Page 84
Viewer and the engine GUIs, so it can happen that the graph types used by the current engine have been removed from the graph area from within another engine. See the N7700 User’s Guide for further details. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 85
X-Range and Lock Y-Range buttons. This will update of the axes then. freeze the x and y range, so no redraw of the axes themselves will occur and flickering should be reduced significantly. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 86
This utility is accessible from the Start menu and should be run to capture information that can be shared with Keysight technical support. Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...
Page 87
Keysight N7700 Photonic Application Suite, Fast Spectral Loss Engine, User’s Guide...