CHANTABILITY AND FITNESS FOR A PAR- the exclusive authority by which the U.S. TICULAR PURPOSE. KEYSIGHT SHALL NOT government may use, modify, distribute, or BE LIABLE FOR ERRORS OR FOR INCIDEN- Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Product Category: With reference to the equipment types in WEEE Directive Annex I, this product is classed as a “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.
2 Getting Started About this manual System Requirements Software Installation Connecting the instruments Install the software before you connect the hardware Run the Configuration Wizard 3 Insertion Loss Application General Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 6
Creating a New Engine Connecting to an Existing Engine Performing a Measurement Accessing the Measurement Result Reference: Interface “IEngineMgr” property Version method IsVersionGreaterOrEqual method NewEngine method OpenEngine property EngineIDs method DeleteEngine Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 9
Keysight N7700 Photonic Application Suite User’s Guide Quick Start Information / 11 Multi-Channel Insertion Loss Setup / 12 Software User Interface...
Page 10
Photonic Application Suite engines, they need to be configured in VISA, for example with the Connection Expert which is part of the IO Libraries Suite, if Keysight VISA is primary. After the instruments have been connected and recognized, start the Launch Pad located in the start menu.
If there are multiple tunable laser sources inside one mainframe, only the NOTE one in the slot with the smallest slot number can be used in this application. This is a legacy restriction from the 816x driver MFlambdascan functions. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Server Software. The server will be automatically started when you click on “Insertion Loss”. The presence of the server is indicated in the task bar: Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Keysight N7700 Photonic Application Suite User’s Guide Getting Started / 14 About this manual / 15 System Requirements / 16 Software Installation / 17 Connecting the instruments / 18 Run the Configuration Wizard...
About this manual This manual covers the swept-wavelength multi-channel Insertion loss Application that can be performed by combining one or more of Keysight’s optical power meters with one of 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.
System Requirements • One or more suitable mainframes (8163B, 8164B, or 8166B) • Keysight tunable laser source with continuous-sweep capability • One or more Keysight optical power meter(s) from the list below: • N7744A / N7745A • N7744C / N7745C •...
The Insertion Loss engine communicates with the instruments over a VISA software layer that should be installed before connecting the instruments. Keysight VISA is provided by installing the IO Libraries Suite, which also provides drivers that may be required by some devices, like GPIB interface adapters and instruments connected by USB.
PC. Refer to the user guides of all instruments used, to check how to connect those instruments. The Photonic Application Suite installs the Keysight IO Libraries, including the Keysight Connection Expert. Make sure that all instruments are shown in the Keysight Connection Expert, then start the Photonic Application Suite software.
Getting Started Run the Configuration Wizard If Keysight VISA is used, all the instruments need to be identified using NOTE the Keysight Connection Expert, before the Photonic Application Suite Configuration Wizard is used to configure the Insertion Loss application to use these instruments. The Connection Expert is part of the Keysight IO Libraries.
Page 19
Configuration Wizard in the File menu of the Insertion Loss Measurement Engine Client. Figure 4 Running Configuration Wizard from the File Menu Please follow the instructions shown in the dialog box. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 20
Getting Started Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 21
Keysight N7700 Photonic Application Suite User’s Guide Insertion Loss Application / 22 General / 23 Wavelength-Swept Insertion Loss Application...
COM interface for automation. This interface allows use of the MFlambdascan measurements from 64-bit programming environments that cannot directly use the 32-bit 816x driver. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
The browser tree to the left of the application window lists the current measurement and all open files and allows to configure, which measurements, which traces (e.g. IL) and which channels are displayed Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 24
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, Insertion Loss Engine, User’s Guide...
Parameter Description Start wavelength (nm): Defines the start of the wavelength sweep. Stop wavelength (nm): Defines the stop of the wavelength sweep. Step size (pm): Defines the wavelength step size. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 26
Range and the number of Dynamic Range Scans, the possible choices for Decrement are reduced automatically. Some additional parameters are located on the “Advanced” tab of the user interface. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
• to perform zeroing on individual channels, and • to 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, Insertion Loss Engine, User’s Guide...
In case of N774xA/C multiport power meters, there are buttons to zero sets of four channels each. The time of the last zeroing operation is displayed below the Zero button. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
NOTE range, TLS power, the reference is no longer valid. If you do not clear the reference manually, it is done automatically the next time you take a new reference. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
TLS power set in the measurement parameters. Maximum performance will be achieved if reference data has been stored for each channel. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
DWDM channel analysis filters. The plugins are listed in the measurement context menu in the browser tree. Which plugins are available depends on the license(s) that are installed on your Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
You can save measurement data using the Save as option from the measurement context menu in the browser tree and providing a filename. Alternatively, choose File > Save Measurement As. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
The files are named using the engine acronym followed by a timestamp. Use drag and drop to add any file(s) to the engine's browser tree or double-click any file(s) for display in the File Viewer application. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 34
Set the Number of measurements kept value to 0 to turn off automatic saves. When tuning a device or a component, or monitoring stability, it might be desirable to automatically have a certain number of most recent measurements displayed simultaneously. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 35
Number of measurements shown value. For each new measurement after that, the oldest history file will be closed automatically. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 36
Channel/File icon, this can be changed to indicate different measurements instead. 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, Insertion Loss Engine, User’s Guide...
Page 37
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, Insertion Loss Engine, User’s Guide...
You can switch to a lighter color theme for the File Viewer within the user interface of Insertion Loss Engine. Click the Settings icon and disable the Dark Mode check box in the Graphs section. Keysight N7700 Photonic Application Suite, Insertion 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 IL engine if it’s not running. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Connect the TLS and all power meters / mainframes to the PC using the GPIB, USB or LAN interface. • Connect the Trigger Output of the TLS with the Trigger Input of the first power meter (using a 50 Ohms BNC cable). Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 41
(angled / straight). • Connect any optical output of the DUT to the optical inputs of the power meters using the corresponding connector interfaces. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 42
Insertion Loss Application Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Keysight N7700 Photonic Application Suite User’s Guide Automation / 44 COM Components / 46 Creating a New Engine / 48 Connecting to an Existing Engine / 49 Performing a Measurement / 50 Accessing the Measurement Result / 52 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, Insertion Loss Engine, User’s Guide...
Page 45
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, Insertion 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, Insertion Loss Engine, User’s Guide...
Page 47
(i.e. the engine manager has been invoked): Left-click on the icon to bring the server window to the front. The server will display a protocol line when an engine has been created or deleted: Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Engine.StartMeasurement; % 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, Insertion Loss Engine, User’s Guide...
Engine.StartMeasurement; % 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, Insertion Loss Engine, User’s Guide...
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 General User’s Guide for a NOTE reference of the common interfaces, e.g. IOMRFile, IOMRGraph and IOMRProperty.
Page 51
N7700 engine server. This might especially be the case when using engine automation in addition to running the Keysight Client, which locks the OMRFile object in memory while updating measurement data in the GUI right after a...
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, Insertion Loss Engine, User’s Guide...
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, Insertion Loss Engine, User’s Guide...
This is done using the “LoadConfiguration” method. Activating an engine will cause the server to communicate with the instruments. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Engine.Configuration = xml; 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, Insertion Loss Engine, User’s Guide...
Engine.WavelengthStep = d; Sets or gets the wavelength step in m. The TLS will perform continuous sweeps, but the measurement results will be returned at wavelengths defined by WavelengthStart, WavelengthStop and WavelengthStep. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
(see property RangeDecrement on page 61) “property PWMSensitivity “property NumberOfScans The parameter set “property RangeDecrement must match the supported maximum and minimum power ranges of all attached power meters. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Pass a line array instead, with a dummy value as a second element, e.g., Engine.MethodName(int32([3 3)). method StartReferenceGlobal Type-Library: HRESULT StartReferenceGlobal([in] LONG Port); Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Saves the current reference to an omr file. Note that the file will be stored on the computer running the engine server, not the client. property MaxAllowedRefLoss Type-Library: get: HRESULT MaxAllowedRefLoss([out, retval] DOUBLE* pVal); Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
TLS used. Will not check whether the parameters match the current reference. Can be used before taking a new reference with changed parameters. property ChannelSetup Type-Library: get: HRESULT ChannelSetup([out, retval] BSTR* ChannelXML); Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Stops a measurement at the next possible time. This will, most of the times, mean between measurements, such as in repeat measurement mode. method FileSave Type-Library: HRESULT FileSave([in] BSTR Filename); Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
MATLAB: Result = Engine.MeasurementResult; Returns a reference to the underlying IOMRFile object which contains the measurement result. Refer to the N7700 Photonic Application Suite General User’s Guide for a NOTE reference of the common interfaces, e.g. IOMRFile, IOMRGraph and IOMRProperty.
If the number of messages exceeds 1000, the oldest message is deleted from the list for each new message. property ProtocolMin Type-Library: get: HRESULT ProtocolMin([out, retval] LONG* pVal) MATLAB: Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Returns 0 otherwise. Set to 0 after you have handled the user input (see method UserInputResponse on page 68) property UserInputPrompt Type-Library: get: HRESULT UserInputPrompt([out, retval] BSTR* pVal) Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Set the response to a user input request. Must be a number from the list obtained by Engine.UserInputChoice. Engine.UserInputWaiting to 0 after setting for the engine to continue Engine.UserInputResponse operation. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Register the COM API after later MCR been installed prior to measurement engine installation or re-register for any other installation. reasons, by running the Re-register all N7700 COM APIs program from the Start menu. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
Page 73
Troubleshooting A troubleshooting utility called Get N7700 System Information has been NOTE introduced to help Keysight technical support gather some vital details required to resolve problems with the software at the user end, engine startup problems, for instance. This utility is accessible from the Start menu and should be run to capture information that can be shared with Keysight technical support.
Need help?
Do you have a question about the N7700 and is the answer not in the manual?
Questions and answers