Keysight Technologies N7373C Manual

Keysight N437x Series

Lightwave Component

Analyzer

Programmer’s

Guide

Notices

©Keysight Technologies2007, 2015

No part of this manual may be reproduced

in any form or by any means (including

electronic storage and retrieval or

translation into a foreign language) without

prior agreement and written consent from

Keysight Technologies,as governed by

United States and international copyright

laws.

Keysight Technologies, Deutschland GmbH

Herrenberger Straße 130

71034 Böblingen, Germany.

Manual Part Number

437xB-90A01

Edition

Edition 2.0,February 2015

Subject Matter

The material in this document is subject to

change without notice.

Keysight Technologies makes no warranty

of any kind with regard to this printed

material, including, but not limited to, the

implied warranties of merchantability and

fitness for a particular purpose.

Keysight Technologies shall not be liable

for errors contained herein or for incidental

or consequential damages in connection

with the furnishing, performance, or use of

this material.

Printing History

New editions are complete revisions of the

guide reflecting alterations in the

functionality of the instrument. Updates are

occasionally made to the guide between

editions. The date on the title page changes

when an updated guide is published. To find

out the current revision of the guide, or to

purchase an updated guide, contact your

Keysight Technologies representative.

Warranty

This Keysight Technologies instrument

product is warranted against defects in

material and workmanship for a period of one

year from date of shipment. During the

warranty period, Keysight will, at its option,

either repair or replace products that prove to

be defective.

For warranty service or repair, this product

must be returned to a service facility

designated by Keysight.Buyer shall prepay

shipping charges to Keysight and Keysight

shall pay shipping charges to return the

product to Buyer. However, Buyer shall pay

all shipping charges, duties, and taxes for

products returned to Keysight from another

country.

Keysight warrants that its software and

firmware designated by Keysight for use with

an instrument will execute its programming

instructions when properly installed on that

instrument. Keysight does not warrant that

the operation of the instrument, software, or

firmware will be uninterrupted or error free.

Limitation of Warranty

The foregoing warranty shall not apply to

defects resulting from improper or

inadequate maintenance by Buyer, Buyer-

supplied software or interfacing,

unauthorized modification or misuse,

operation outside of the environmental

specifications for the product, or improper

site preparation or maintenance.

No other warranty is expressed or implied.

Keysight Technologies specifically disclaims

the implied warranties of Merchantability

and Fitness for a Particular Purpose.

Exclusive Remedies

The remedies provided herein are Buyer’s

sole and exclusive remedies. Keysight

Technologies shall not be liable for any

direct, indirect, special, incidental, or

consequential damages whether based on

contract, tort, or any other legal theory.

Assistance

Product maintenance agreements and

other customer assistance agreements are

available for Keysight Technologies

products. For any assistance contact your

nearest Keysight Technologies Sales and

Service Office.

Certification

Keysight Technologies certifies that this

product met its published specifications at

the time of shipment from the factory.

Keysight Technologies further certifies that

its calibration measurements are traceable

to the United States National Institute of

Standards and Technology, NIST,to the

extent allowed by the Institutes’s

calibration facility, and to the calibration

facilities of other International Standards

Organization members.

ISO 9001 Certification

Produced to ISO 9001 international quality

system standard as part of our objective of

continually increasing customer satisfac-

tion through improved process control.

Remote Operation 5

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Transferring code from the 8703A/B to the Keysight N437x Series Lightwave Component

Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

LCA System Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

How to configure the LCA for networking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

How to connect the LCA to your network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

How to change network settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Install the LCA Remote Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

How to use the LCA Remote Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Adding references to your project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Declare and create the required objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Basic structure of an LCA client application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Synchronous vs. Asynchronous Method Calls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

LCA Remote Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

LCA remote control DLLs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Specific Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Interface structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Enumeration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Class LCAMeasParams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Class LCAProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Interface ILCARemoteClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

General commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Measurement commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

The LCA SCPI Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Port Types . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Configuration .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Start/Stop the LCA SCPI Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

The LCA SCPI commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Command Details .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide

System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Remove all doubt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Phone orFax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Keysight online information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ..82

Programming Examples 61

VEE Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...62

Getting started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Description of the VEE-example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

VBA/Excel Programming Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74

Warranty Information 79

Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide

Remote Operation

Overview 9

Transferring code from the Keysight 8703A/B to the Keysight

N437xB Series Lightwave Component Analyzer 11

LCA System Configuration 12

How to configure the LCA for networking 12

How to connect the LCA to your network 12

How to change network settings 12

Install the LCA Remote Client 15

Synchronous vs. Asynchronous Method Calls 21

How to use the LCA Remote Client 16

Adding references to your project 16

Declare and create the required objects 18

Basic structure of an LCA client application 19

Troubleshooting 23

LCA Remote Programming 24

LCA remote control DLLs 24

Specific Commands 25

Interface structure 25

Enumeration 26

Class LCAMeasParams 27

Class LCAProperties 30

Interface ILCARemoteClient 31

General commands 31

Measurement commands 34

Properties

The LCA SCPI Interface 43

Overview

Port Types

Configuration 45

Remote Operation

Start/Stop the LCA SCPI Module

LCA SCPI Commands

Command Details 48

Remote Operation

Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide

Overview

This chapter will help you control an LCA from your own

computer. The chapter covers how to write your own

applications. The next chapter explains examples based on

Keysight VEE and VBA/Excel in more detail. Note that

applications for remote control can also be run on the LCA

itself, which is useful for automated measurement procedures.

The LCA is a remoting enabled, Microsoft .NET instrument that

can be controlled across any LAN that can relay an http web

page. The provided remote control client has an Active X

interface and a .NET interface, so you can program the LCA

from many established programming environments such as

Visual Basic 6.0 and VBA, as well as from .NET enabled

programming environments such as C#.

The LCA uses .NET remoting as the foundation for its external

communications. Remoting is the process of programs or

distributed components interacting across different processes

or machines.

Beginning with the LCA software version 3.00.03 for Windows

XP systems or 3.01.00 with Window 7, an SCPI interface is

also available, which may be more comfortable for other

environments like Labview. The SCPI interface can be used

over either a LAN or USB port.

This programming guide supports LCA models beginning

with the B generation. These now include: N4373D, N7373C,

N4373B, N4374B, N4375D, N4375B, N4376D and N4376B.

Remote Operation

Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide

Figure 1 LCA Remoting Architecture

Since the LCA interface does not provide any methods to set

network analyzer related parameters or to retrieve

measurement data from the network analyzer, most

applications also need to program the network analyzer. The

network analyzer’s native functions can be controlled either

using SCPI or COM. We recommend using the COM interface.

This is reflected in the programming examples.

In .NET remoting, the server program publishes an object on a

network channel and the client program subscribes to that

channel when loading or connecting to that object. In the case of

the LCA, a RemoteObject object is published to an http channel

and the subscribing client program is the LCA RemoteClient. A

Remoting server is embedded in the LCA Server application.

The LCA RemoteClient is a layer of abstraction, which provides

an easy to use interface with methods to control the 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.

Remote Operation

Keysight N437x Series Lightwave Component Analyzer, Programmer’s Guide

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Instrumento de medición de Keysight Technologies

Keysight Technologies

Keysight Technologies B2981A Guía de instalación

Keysight Technologies

Keysight Technologies B2900A Series Manual de usuario

Keysight Technologies

Keysight Technologies E2655C Manual de usuario

Keysight Technologies

Keysight Technologies N4960A Manual de usuario

Keysight Technologies

Keysight Technologies B1507A Manual de usuario

Keysight Technologies

Keysight Technologies U5855A Manual de usuario

Keysight Technologies

Keysight Technologies PNA Series Manual de usuario

Keysight Technologies

Keysight Technologies X Series Manual de instalación y operación

Keysight Technologies

Keysight Technologies M9393A Instrucciones de funcionamiento

Keysight Technologies

Keysight Technologies N9030B Manual de instalación y operación

Keysight Technologies

Keysight Technologies E5260 Series Manual de usuario

Keysight Technologies

Keysight Technologies PNA Series Manual de usuario

Keysight Technologies

Keysight Technologies U5310A Guía del usuario

Keysight Technologies

Keysight Technologies B2900A Series Manual de usuario

Keysight Technologies

Keysight Technologies N99xxA Series Manual de usuario

Keysight Technologies

Keysight Technologies P Series Manual de usuario

Keysight Technologies

Keysight Technologies E5052B Manual del propietario

Keysight Technologies

Keysight Technologies N5221A Manual de usuario

Keysight Technologies

Keysight Technologies S9106AC-2IF Guía del usuario

Keysight Technologies

Keysight Technologies U3810A Manual de usuario

Keysight Technologies

Keysight Technologies E5072A Manual de usuario

Keysight Technologies

Keysight Technologies C Series Manual de usuario

Keysight Technologies

Keysight Technologies N9000B Manual de instalación y operación

Keysight Technologies

Keysight Technologies 34921A Manual de usuario

Manuales populares de Instrumento de medición de otras marcas

Suaoki

Suaoki D40 Manual de usuario

Elster

Elster BK-G1.6 Manual de usuario

Endress+Hauser

Endress+Hauser Deltabar FMD71 Manual

Duratool

Duratool D03128 Manual de usuario

Vega

Vega VEGAPULS 65 Manual de usuario

Tonghui

Tonghui TH2618B Manual de usuario

Tenmars

Tenmars TM-801 Manual de usuario

MSR

MSR 145 Manual de usuario

TPS

TPS WP-82 Manual de usuario

ELMETRON

ELMETRON CP-511 Manual de usuario

PCB Piezotronics

PCB Piezotronics 003C30 Manual de usuario

Tenma

Tenma 72-10465 Manual de usuario

Endress+Hauser

Endress+Hauser Proline Promag 50 Especificaciones técnicas

Siemens

Siemens SITRANS F Coriolis FCT030 Manual de lista de piezas

KLINGER

KLINGER CMF V Series Manual de usuario

EXFO

EXFO FTB-2 Manual de operación y mantenimiento

Keysight

Keysight M8290A Manual de usuario

ADTEK

ADTEK MW-5 Manual de usuario