Keysight Technologies N7373C Manuel

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

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Keysight Technologies Instrument de mesure

Keysight Technologies

Keysight Technologies B1507A Manuel utilisateur

Keysight Technologies

Keysight Technologies U1401B Manuel utilisateur

Keysight Technologies

Keysight Technologies CXA Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies E4417A Manuel utilisateur

Keysight Technologies

Keysight Technologies U1731C Manuel utilisateur

Keysight Technologies

Keysight Technologies N437 Series Instructions d'installation et d'utilisation

Keysight Technologies

Keysight Technologies N9029AV01-V15 Manuel utilisateur

Keysight Technologies

Keysight Technologies M981 AS Series Manuel utilisateur

Keysight Technologies

Keysight Technologies N4373E Manuel utilisateur

Keysight Technologies

Keysight Technologies U5855A Manuel utilisateur

Keysight Technologies

Keysight Technologies X-Series Guide de démarrage rapide

Keysight Technologies

Keysight Technologies MXA N9020A Manuel utilisateur

Keysight Technologies

Keysight Technologies N9030A Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies N9030B Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies 16034G Manuel utilisateur

Keysight Technologies

Keysight Technologies M9602A Manuel utilisateur

Keysight Technologies

Keysight Technologies P939 A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies N5221B Manuel utilisateur

Keysight Technologies

Keysight Technologies E2655C Manuel utilisateur

Keysight Technologies

Keysight Technologies M9393A Guide de l'utilisateur

Keysight Technologies

Keysight Technologies E5055A SSA-X Manuel utilisateur

Keysight Technologies

Keysight Technologies N5224A Manuel utilisateur

Keysight Technologies

Keysight Technologies E5400-Pro Series Manuel utilisateur

Keysight Technologies

Keysight Technologies NFA X-Series Manuel utilisateur

Manuels Instrument de mesure populaires d'autres marques

Suaoki

Suaoki D40 Manuel utilisateur

Elster

Elster BK-G1.6 Manuel utilisateur

Endress+Hauser

Endress+Hauser Deltabar FMD71 Manuel

Duratool

Duratool D03128 Manuel utilisateur

Vega

Vega VEGAPULS 65 Manuel utilisateur

Tonghui

Tonghui TH2618B Manuel utilisateur

Tenmars

Tenmars TM-801 Manuel utilisateur

MSR

MSR 145 Manuel utilisateur

TPS

TPS WP-82 Manuel utilisateur

ELMETRON

ELMETRON CP-511 Manuel utilisateur

PCB Piezotronics

PCB Piezotronics 003C30 Manuel utilisateur

Tenma

Tenma 72-10465 Manuel utilisateur

Endress+Hauser

Endress+Hauser Proline Promag 50 Caractéristiques techniques

Siemens

Siemens SITRANS F Coriolis FCT030 Manuel de la liste des pièces

KLINGER

KLINGER CMF V Series Manuel utilisateur

EXFO

EXFO FTB-2 Manuel d'exploitation et d'entretien

Keysight

Keysight M8290A Manuel utilisateur

ADTEK

ADTEK MW-5 Manuel utilisateur