Download Print this page
Keysight N7700 User Manual
Keysight N7700 User Manual

Keysight N7700 User Manual

Photonic application suite insertion loss measurement engine

Advertisement

Quick Links

Keysight N7700
Photonic Application Suite
Insertion Loss Measurement Engine
User's Guide

Advertisement

loading
Need help?

Need help?

Do you have a question about the N7700 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Keysight N7700

  • Page 1 Keysight N7700 Photonic Application Suite Insertion Loss Measurement Engine User’s Guide...
  • Page 2: Warranty

    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...
  • Page 3: Compliance And Environmental Information

    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.
  • Page 4 Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 5: Table Of Contents

    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 7 TLSOutputPort property TLSPower property NumberOfScans property RangeDecrement method StartReference method StartReferenceGlobal method ClearReference method LoadReference method SaveReference property MaxAllowedRefLoss method ValidateSettings method ValidateSettingsNoRefCheck property ChannelSetup method StartMeasurement method StartMeasurementRepeat Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 8 EventPropertiesChanged property EventMeasurementFinished property EventReferenceZeroFinished property ProtocolText property ProtocolMin property ProtocolMax method GetProtocolTextAt property UserInputWaiting property UserInputPrompt property UserInputChoice method UserInputResponse Alphabetical Automation Index 5 Troubleshooting Symptoms and Solutions 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.
  • Page 11: Multi-Channel Insertion Loss Setup

    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...
  • Page 12: Software User Interface

    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...
  • Page 13: Getting Started

    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...
  • Page 14: About This Manual

    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.
  • Page 15: System Requirements

    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 •...
  • Page 16: Software Installation

    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.
  • Page 17: Connecting The Instruments

    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.
  • Page 18: Run The Configuration Wizard

    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...
  • Page 22: General

    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...
  • Page 23: Wavelength-Swept Insertion Loss Application

    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...
  • Page 25: Application Setup Parameters

    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...
  • Page 27: Using The Port/Reference Manager

    • 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...
  • Page 28: Power Meter Zeroing

    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...
  • Page 29: Taking References

    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...
  • Page 30: Performing A Measurement

    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...
  • Page 31: Re-Evaluating Measurements

    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...
  • Page 32: 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. Alternatively, choose File > Save Measurement As. Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 33: Loading Measurements

    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...
  • Page 38: Exporting Measurement Data

    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...
  • Page 39: Tls Lambda Zeroing

    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...
  • Page 40: Measurement Setup

    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...
  • Page 43: Automation

    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”...
  • Page 44: Com Components

    % 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...
  • Page 46: Creating A New Engine

    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...
  • Page 48: Connecting To An Existing Engine

    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...
  • Page 49: Performing A Measurement

    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...
  • Page 50: Accessing The Measurement Result

    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...
  • Page 52: Reference: Interface "Ienginemgr

    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...
  • Page 53: Method Openengine

    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...
  • Page 54: Reference: Interface "Iengine

    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...
  • Page 55: Method Deactivate

    EmulationMode Type-Library: get: HRESULT EmulationMode([out, retval] BOOL* pVal); put: HRESULT EmulationMode([in] BOOL Val); Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 56: Method Loadconfiguration

    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...
  • Page 57: Property Wavelengthstart

    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...
  • Page 58: Property Sweeprates

    = Engine.PWMRanges; Returns a double array containing the available power meter ranges. property PWMSensitivity Type-Library: get: HRESULT PWMSensitivity([out, retval] DOUBLE* pVal); put: HRESULT PWMSensitivity([in] DOUBLE Val); MATLAB: d = Engine.PWMSensitivity; Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 59: Method Zeropwmchannels

    Engine.MethodName(int32([3 3)). method ZeroTLS Type-Library: HRESULT ZeroTLS(void); MATLAB: Engine.ZeroTLS; Performs a lambda zeroing operation on the tunable laser source in use. property TLSOutputPort Type-Library: Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 60: Property Tlspower

    (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...
  • Page 61: Property Rangedecrement

    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...
  • Page 62: Method Clearreference

    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...
  • Page 63: Method Validatesettings

    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...
  • Page 64: Method Startmeasurement

    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...
  • Page 65: Property Measurementresult

    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.
  • Page 66: Property Eventmeasurementfinished

    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...
  • Page 67: Property Protocolmax

    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...
  • Page 68: Property Userinputchoice

    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...
  • Page 69: Alphabetical Automation Index

    DeleteEngine, OpenEngine, ValidateSettings, EmulationMode, ValidateSettingsNoRefCheck, EngineIDs, Version, 52, EventMeasurementFinished, ProtocolMax, EventPropertiesChanged, ProtocolMin, EventReferenceZeroFinished, ProtocolText, PWMRanges, WavelengthStart, PWMSensitivity, WavelengthStep, WavelengthStop, FileSave, RangeDecrement, ZeroPWMChannels, GetProtocolTextAt, ZeroTLS, safety summary, SaveReference, SoftwareConfiguration, Interface “IEngine”, Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 70 Automation Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 71: Troubleshooting

    Keysight N7700 Photonic Application Suite User’s Guide Troubleshooting / 72 Symptoms and Solutions...
  • Page 72: Symptoms And Solutions

    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.
  • Page 74 Troubleshooting Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 75 Keysight N7700 Photonic Application Suite, Insertion Loss Engine, User’s Guide...
  • Page 76 This information is subject to change without notice. © Keysight Technologies 2021 Edition 13.0, August 2021 www.keysight.com...