Table of Contents
Advertisement
Quick Links
Advertisement
Table of Contents
Related Manuals for Keysight N437 Series
Summary of Contents for Keysight N437 Series
- Page 1 Keysight N437x Series Lightwave Component Analyzer Programmer’s Guide...
- Page 2 THE IMPLIED WARRANTIES OF The license set forth in the EULA represents MERCHANTABILITY AND FITNESS FOR A the exclusive authority by which the U.S. PARTICULAR PURPOSE. KEYSIGHT SHALL government may use, modify, distribute, or Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 3: Table Of Contents
Contents 1 Remote Operation Overview Transferring code from the 8703A/B to the Keysight N437x Series Lightwave Component Analyzer LCA System Configuration How to configure the LCA for networking How to connect the LCA to your network How to change network settings... - Page 4 Start/Stop the LCA SCPI Module LCA SCPI Commands Overview Command Tree Command Details 2 Programming Examples 3 Warranty Information Warranty System Remove all doubt Keysight E-mail Updates myKeysight Keysight Open Phone or Fax Keysight Online Information Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 5: Remote Operation
Keysight N437x Series Lightwave Component Analyzer Programmer’s Guide Remote Operation Overview Transferring code from the 8703A/B to the Keysight N437x Series Lightwave Component Analyzer LCA System Configuration / 10 Install the LCA Remote Client / 13 How to use the LCA Remote Client / 14 Synchronous vs. -
Page 6: Overview
LCA. The LCA Remote Client layer consists of 3 files, named "RemoteClient.dll", "RemoteObjects.dll" and "RemoteClient.tlb". These files are installed as part of the the LCA Remote Client installation package, together with a number of programming examples. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 7 Examples are provided for VB.NET, C#, VBA and Keysight VEE, which can be extrapolated to most environments for controlling the LCA. After installing the LCA Remote Client on your computer, you can find these...
- Page 8 The Excel-VBA example pulls data directly from the LCA into Excel. This is very useful if you are setting up measurements manually, but want to analyze the results on your own computer. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 9: Transferring Code From The 8703A/B To The Keysight N437X Series Lightwave Component Analyzer
Remote Operation Transferring code from the 8703A/B to the Keysight N437x Series Lightwave Compo- nent Analyzer Tools are available to migrate code from the 8720 network analyzer to the new PNA network analyzer platform at www.keysight.com/find/nadisco The 8703A/B Lightwave Component Analyzers are based on the 8720 network analyzers, so you can use these code conversion tools to migrate existing code to the N437x Series LCA based on the PNA platform. -
Page 10: Lca System Configuration
The LCA LAN connector supports 10 Base-T and 100 Base-T Ethernet NOTE networks using TCP/IP and other Microsoft supported networking protocols. The LCA uses Microsoft Windows 7 or XP. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 11: How To Change Network Settings
Because your network settings are unique to your IT infrastructure, NOTE Keysight Technologies will not be able to assist you with connecting your instrument to your network. Please contact your network administrator or IT department for assistance. For more information, refer to the MS Windows resource kit (available from Microsoft) that is appropriate for your computer system. - Page 12 For more information, click Start > Help > Index, and search for “DNS” or NOTE “WINS” or “static” or “dynamic.” To configure TCP/IP for static or dynamic addressing • To get started, follow the same steps listed above. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 13: Install The Lca Remote Client
The LCA CD shipped with the LCA contains the Remote Client Installation Package to install the LCA specific DLLs and the programming examples. The most recent version of the LCA Remote Client Installation Package is available from the Keysight web site (www.keysight.com/find/lca). •... -
Page 14: How To Use The Lca Remote Client
For the differences, please check the VBA and C++ example projects, installed with the LCA Remote Client. From the “Project” menu, select “Add Reference”. Switch to the “Browse” tab. Browse to your LCA Remote Client installation folder. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 15 In environments which cannot work directly with .NET assemblies, you have to use the COM interface of the LCA Remote Client. In VBA, open the “Tools” menu and select “References”. You will see a dialog like the following: Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 16: Declare And Create The Required Objects
LCA Remote Client, you have to create objects from these classes. ‘ Declare the objects Private lcaClient As Agilent.LCA.RemoteClient.LCARemoteClient Private lcaMeasParams As Agilent.LCA.RemoteClient.LCAMeasParams Private lcaProperties As Agilent.LCA.RemoteClient.LCAProperties …. ‘Create the objects lcaClient = New Agilent.LCA.RemoteClient.LCARemoteClient() Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 17 True) ‘ now we connect to the remote PNA pnaClient = CType(System.Activator.CreateInstance(srvtype), AgilentPNA835x.IApplication9) End Sub For further details on programming the network analyzer, please refer to the relevant network analyzer documentation. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 18: Basic Structure Of An Lca Client Application
When finished with working on the LCA, close the session lcaClient.Close() Before leaving the application, make sure to call the Disconnect() command. This prevents unnecessary processing overhead on the LCA, needed to monitor and close inactive sessions. lcaClient.Disconnect() Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 19: Synchronous Vs. Asynchronous Method Calls
• The other method is named WaitForOPC(). This method blocks program execution on the calling thread until the operation on the instrument finishes. Here are two short examples in VB.NET syntax, showing the usage of asynchronous calls: Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 20 While oLCAClient.OperationComplete = False Using the WaitForOPC() command: oLCAClient.Init_OO(params, False) DoMyActionsAfterCallingInit() ‘ doing some other stuff ‘ When we are done with our own stuff, ‘ we need to wait for Init_OO to finish oLCAClient.WaitForOPC() Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 21: Troubleshooting
We recommend you only use these workarounds during development. NOTE Only use CloseAll() in environments where you are sure no other client could have a session opened. CloseAll() will close sessions from all the LCA clients. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 22: Lca Remote Programming
(on 64-bit systems) From version 3.1.4 onwards, remote control DLLs are generally installed NOTE in C:\Program Files (x86)\Agilent\Agilent LCA Remote Control\ Independent from that, they can be used within 32-bit and 64-bit processes. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 23: Specific Commands
Specify how often a modulator bias voltage optimization has to be NotSet performed. Once Once: only once when the laser is switched on. EverySweep EverySweep: prior to each measurement started by the LCA. Continuous Continuous: the optimization loop runs continuously. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 24: Class Lcameasparams
You also have are active additional Optical- and RF- path deembedding possibilities, or can apply additional deembedding on the receiver and the source side, independent of the measurement type. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 25 Set to True to use a laser source connected to the optional external Boolean False input (on the rear of the optical test set. Set to False to use the laser source in the optical test set. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 26 In default mode only evaluated for E/O and O/O measurements. OptSrcFile The name of the s2p file to use for additional adaptor deembedding String Empty string on the source side. In default mode only evaluated for O/E and O/O measurements. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 27 Name a Calset on the network analyzer which has to be used for the String Empty string user calibration measurement. If an empty string is passed, the current calset is used. If “NONE” is passed, no calset is applied for the user calibration measurement. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 28 These values are correlated to the wavelength values in “SourceWvl” at the same position. HasExternalInput True: LCA test head has external laser input Boolean False: LCA test head has no external input Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 29: Interface Ilcaremoteclient4
Function Open () As Boolean Opens an active session on the LCA. All commands that change the state of the LCA require an active session. The LCA server allows only one active session at any time. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 30 Closes passive session on the LCA. Parameters No parameters. Return value No return value. Sub CloseAll () Closes the active sessions on the LCA. Any measurements that are currently running are aborted. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 31 “Connect” command. If you want to set a timeout value, you have to do this before calling the “Connect” command. If you are using the LCA Remote Client .NET assembly directly, you can also specify the timeout value in the LCARemoteClient constructor. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 32: Measurement Commands
The measurement parameters for initialization Optional ByVal sync As Boolean True (default): the call is blocked until initialization is complete False: the call returns immediately. For synchronization use the synchronization methods WaitForOPC or OperationComplete Return value No return value. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 33 Use this command instead of Init_OE if you want the LCA to load and use previously saved user calibration data. The loaded user calibration data will be used by the LCA until the next initialization command is called. See also SaveUserCalData Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 34 Be careful when calling a continuous measurement in synchronous NOTE mode. Since the synchronous call blocks the program execution of the calling thread, you can't stop this measurement from the calling thread. It can only be stopped from another thread. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 35 This command is only allowed when OE or OO measurement mode is inititalized. Parameters ByVal filename As String The filename, where the data should be stored. Return value No return value. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 36: Properties
Get or set the current power of the LCA optical output in dBm Parameters No parameters. LaserState As RemoteClient.ELaserState Get or set the current state of the LCA optical output Parameters No parameters. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 37 Double.NaN or a value < - 200dBm. Parameters No parameters. ReadOnly OpticalDCPower_dBm As Double Get the actual optical DC power, measured by the optical powermeter built into the LCA testhead Parameters No parameters. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 38 ReadOnly OperationComplete As Boolean Get the operation status of the last asynchronously called command. Exceptions thrown during execution of an asynchronously called command could be caught when calling WaitForOPC() or OperationComplete(). Parameters No parameters. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 39: The Lca Scpi Interface
SCPI interface on different ports. Now the new LCA SCPI interface extends the existing LCA application. It is implemented with the Keysight Translator Framework and the LCA Remote Server. Each SCPI command is intercepted and linked to an LCA Remote Interface method. -
Page 40: Configuration
When done with configuration, click the “Save Config” button to store all settings. After saving the settings, the LCA SCPI module will adopt the modified configuration when you click on the “Start SCPI” button. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 41: Start/Stop The Lca Scpi Module
This is the same for the LCA Remote Client. It also connects to the LCA Server and therefore the SCPI interface cannot run at the same time. Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 42: Lca Scpi Commands
:PARameter:ADVAnced:MODE /? -> <0|1> as string :PARameter:ELECtrical:PATH:DEEMbedding /? -> <0|1> as string :PARameter:ELECtrical:PATH:DEEMbedding:75Ohm /? -> <0|1|ON|OFF> as string :PARameter:ELECtrical:RECeiver:S2PFile[n] /? <string> (index n = 1|2) :PARameter:ELECtrical:SOURce:S2PFile[n] /? -> <string > (index n = 1|2) Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 43 :SOURce:WAVelength /? -> <1310|1550> as string :SOURce:WAVelength:ALL? qonly -> <string> :THEAd:INPut:MODe /? ->< STD|HIGH> :THEAd:INPut:POWer? qonly <double> unit is dBm :THEAd:INPut:NUMBers? qonly -> <integer> :THEAd:SWITched:ARCHitecture? qonly -> <0|1> :THEAd:TYPE? qonly -> <Rx|Tx|TxRx> Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 44: Command Details
Syntax [:LCA]:SNUMber? Description The serial number of the LCA system Parameters none Response string (property) SerialNumber Example :SNUMber? ->,MY49151038 Command [:LCA]:SOFTware:VERSion? Syntax :[:LCA]:SOFTware:VERSion? Description The version of the LCA server software parameters:none Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 45 “<string>” path and file name enclosed in double quotes Response none (method) LoadOETxCalData Example :LOAD:OE:CAL:NAME “c:\temp\test.snp” Command :MEASurement:ABORt Syntax :MEASurement:ABORt Description Aborts a currently running measurement or initialization. Parameters none Response none (method) Abort() Example :MEAS:ABOR Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 46 Initializes the LCA for an EE measurement Parameters none Response none (method) Init_EE() Example :MEAS:INIT:EE Command :MEASurement:INITialize:EO Syntax :MEASurement:INITialize:EO Description Initializes the LCA for an EO measurement. parameters:none Response none (method) Init_EO() Example :MEAS:INIT:EO Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 47 Parameters <string> SINGle | CONTinuous none Response none (method) Measure() Example :MEAS:STAR CONT Command :NWA:MODel? Syntax :NWA:MODel? Description The model number of the network analyzer Parameters none Response string (property) NWAModel Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 48 Parameters none Response <string> 0 | 1 (property) Advanced Example :PAR:ADVA:MODE? -> 0 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 49 :PARameter:ELECtrical:PATH:DEEMbedding Syntax :PARameter:ELECtrical:PATH:DEEMbedding<wsp>ON|OFF|1|0 Description Sets the property which enables or disables the whole electrical path de- embedding. Parameters <string> ON | OFF | 1 | 0 Response none (property)UseElAdaptor Example :PAR:ELEC:PATH:DEEM OFF Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 50 Index 2 has to be used only for the receiver port with the higher number in differential measurements Parameters none Response <string> (property) ElRcv1File / ElRcv2File Example :PAR:ELEC:REC:S2PFile? -> c:\temp\test.s2p Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 51 Index 2 is the file for the source port with the higher number in differential measurements Parameters “<string>” path and file name Response none Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 52 (property) MeasMode Example :PAR:MEAS:MODE SING Command :PARameter:MODUlator:BIAS:MODE? Syntax :PARameter:MODUlator:BIAS:MODE? Description Returns how often a modulator bias voltage optimization will be performed Parameters <string> Continuous|EverySweep|Once Response none (property) ModBiasOptimization Example :PAR:MODU:BIAS:MODE? -> EverySweep Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 53 <string> ON | 1 enables high power input, OFF | 0 disables high power input Response none (property) HighPower_Input Example :PAR:OPT:INP:POWer:HIGH ON Command :PARameter:OPTical:OUTput:POWer? Syntax :PARameter:OPTical:OUTput:POWer? Description Returns the optical output power of the LCA in dBm. Parameters none Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 54 Switches the whole optical path de-embedding on or off. Parameters <string> ON | 1 = enabled optical path de-embedding, OFF | 0 = disable Response None (property) UseOpticalConnData Example :PAR:OPT:PATH:DEEM? -> 1 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 55 Returns whether the optical paths are described by transmission data stored in an s2p file. Only the S21 transmission data is used. Parameters none Response <string> 1 = s2p file use enabled, 0 = disabled (property) UseIOpticalS2PFile Example :PAR:OPT:S2PF:USE? -> 0 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 56 O/O measurements. Parameters “<string>” the file name and path enclosed in double quotes. Response <string> file name and path of the s2p file on the LCA system. (property) OptSrcFile Example :PAR:OPT:SOUR:S2PF “c:\temp\test1.s2p” Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 57 Retrieves the geometrical length of the receiver path in m. In default mode only evaluated for E/O and O/O measurements Parameters none Response <double> The path length value, default unit is meter. (property) RcvLengthOpt_m Example :PAR:REC:PATH:LENG? -> 0.3 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 58 Specifies the refractive index of the receiver path in dB. In default mode only evaluated for E/O and O/O measurements. Parameters index <double> the receiver refractive value, unit id dB. Response none (property) RcvRefIdx Example :PAR:REC:REFR:IND 1.3 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 59 Specifies whether to use the optional external input or the internal laser of the optical test set. Parameters <string> 0 | 1 | ON | OFF Response none (property) LCAMeasParams.ExternalInput Example :PAR:SOUR:EXT ON Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 60 In default mode the laser is switched on or off according to the measurement type Parameters <string> ON | 1 to switch the laser on, OFF | 0 to switch the laser off Response none (property) Laser_On Example :PAR:SOUR:POW:STAT ON Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 61 Retrieves the refractive index of the source path in dB. In default mode only evaluated for O/E and O/O measurements. Parameters none Response <double> the refractive index (property) SrcRefIdx Example :PAR:SOUR:REFR:IND? -> 0 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 62 Calset is used. If “NONE” is passed, no Calset is applied for the user calibration measurement. Parameters NONE| <string> |No argument, None or the path and file name surrounded by double quotes. Response none (property) CalSetUserCal Example :PAR:USER:CAL:CALS “c:\temp\calset1.s2p” Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 63 Command :RF:POWer:FWD? Syntax :RF:POWer:FWD? Description Gets the RF power on the network analyzer ports for forward measurements Parameters none Response <double> forward power value in dBm (property) RFPowerFwd_dBm Example :RF:POWer:FWD? -> -8 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 64 To set this property back to the factory defined default value, set it to Double.NaN or a value < -200dBm. Parameters power <double> RF reverse power value in dBm. Response none (property) RFPowerRev_dBm Example :RF:POW:REV -4 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 65 Response <double> The maximum power value in dBm. For an invalid index it returns -200 and there is an entry in the error queue. See :SYST:ERR?. (property) MaxPower_dBm Example :SOUR:MAXP? -> 6 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 66 :SOUR:POW? -> 5.00375 Command :SOURce:POWer Syntax :SOURce:POWer<wsp><power> Description Sets the current power of the LCA optical output in dBm Parameters power <double> Laser power value in dBm Response none (property) LaserPower_dBm Example :SOUR:POW 2.45 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 67 Sets the current wavelength of the LCA optical output. The available wavelengths can be retrieved with :SOUR:WAV:ALL? Parameters wavelength <string> the wavelength value as string, unit is nm e. g. 1550. Response none Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 68 <string> Standard | HighPower (property) OpticalInput Example THEA:INP:MODE? -> Standard Command :THEAd:INPut:MODe Syntax :THEAd:INPut:MODe<wsp>STAN|HIGH description:Sets the current optical input of the LCA test-head. parameters:<string> HIGH | STANdard Response none (property) OpticalInput Example THEA:INP:MODE HIGH Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 69 Description Gets the LCA test-head architecture. True: LCA test head has switched, False: non-switched architecture. Parameters none Response <string> 0 = false or 1 = true (property) SwtichedArchitecture Example :THEA:SWIT:ARCH? -> 0 Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
- Page 70 ‘Rx’: LCA testhead with receiver only, ‘Tx’: LCA testhead with transmitter only, ‘TxRx’: LCA testhead with transmitter and receiver. Parameters none Response <string> Rx or Tx or TxRx (property) TestHeadType Example :THEA:TYPE? -> TxRx Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide...
-
Page 71: Programming Examples
Keysight N437x Series Lightwave Component Analyzer Programmer’s Guide Programming Examples .NET and COM programming examples are installed with the LCA Remote Client in the folder: C:\Program Files\Agilent\Agilent LCA Remote Client\Examples (on 32-bit systems) C:\Program Files (x86)\Agilent\Agilent LCA Remote Client\ (on 64-bit systems) -
Page 73: Warranty Information
Keysight N437x Series Lightwave Component Analyzer Programmer’s Guide Warranty Information Warranty / 74 Phone or Fax / 76 Keysight Online Information / 77... -
Page 74: Warranty
Keysight Technologies may have to the purchaser. Please contact your local Keysight field engineer before embarking in any changes to the system. To check the warranty of your product, visit the following web page: www.keysight.com/find/warranty... -
Page 75: Keysight Open
Keysight Open simplifies the process of connecting and programming test systems to help engineers design, validate and manufacture electronic products. Keysight offers open connectivity for a broad range of system ready instruments, open industry software, PC-standard I/O and global support, which are combined to more easily integrate test system development. -
Page 76: Phone Or Fax
(fax) (080) 769 0900 Latin America: (tel) (305) 269 7500 Taiwan: (tel) 0800 047 866 (fax) 0800 286 331 Other Asia Pacific Countries: (tel) (65) 6375 8100 (fax) (65) 6755 0042 Email: tm_ap@keysight.com Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... -
Page 77: Keysight Online Information
Firmware and driver download www.keysight.com/comms/octfirmware Keysight photonic discussion forum http://www.keysight.com/find/photonic_forum For Network analyzer related literature, please visit: Keysight Network Analyzers: www.keysight.com/find/na Mechanical and Electronic Calibration Kits: www.keysight.com/find/ecal RF Test Accessories, Cabinets, Cables: ww.keysight.com/find/accessories Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide... - Page 78 This information is subject to change without notice. © Keysight Technologies 2018 Edition 3.0, July 2018 www.keysight.com...