Keysight Technologies N778 C Series Mode d'emploi

Programming

Guide

Keysight N778xC Series

Polarization Instruments

N7781C Polarization Analyzer

N7785C Synchronous Scrambler

N7786C Polarization Synthesizer

N7788C Optical Component Analyzer

Notices

No part of this manual may be reproduced

in any form or by any means (including

electronic storage and retrieval or transla-

tion into a foreign language) without prior

agreement and written consent from

Keysight Technologies as governed by

United States and international copyright

laws.

Manual Part Number

N7780-90C02

Edition

Edition 1.0, December 2019

Keysight Technologies Deutschland GmbH

Herrenberger Strasse 130,

71034 Böblingen, Germany

Technology Licenses

The hardware and/or software described in

this document are furnished under a

license and may be used or copied only in

accordance with the terms of such license.

U.S. Government Rights

The Software is “commercial computer

software,” as defined by Federal Acquisition

Regulation (“FAR”) 2.101. Pursuant to FAR

12.212 and 27.405-3 and Department of

Defense FAR Supplement

(“DFARS”) 227.7202, the U.S. government

acquires commercial computer software

under the same terms by which the

software is customarily provided to the

public. Accordingly, Keysight provides the

Software to U.S. government customers

under its standard commercial license,

which is embodied in its End User License

Agreement (EULA), a copy of which can

be found at:

http://www.keysight.com/find/sweula.

The license set forth in the EULA represents

the exclusive authority by which the U.S.

government may use, modify, distribute, or

disclose the Software. The EULA and the

license set forth therein, does not require

or permit, among other things, that

Keysight: (1) Furnish technical information

related to commercial computer software

or commercial computer software

documentation that is not customarily

provided to the public; or (2) Relinquish to,

or otherwise provide, the government

rights in excess of these rights customarily

provided to the public to use, modify,

reproduce, release, perform, display, or

disclose commercial computer software or

commercial computer software documen-

tation. No additional government require-

ments beyond those set forth in the EULA

shall apply, except to the extent that those

terms, rights, or licenses are explicitly

required from all providers of commercial

computer software pursuant to the FAR and

the DFARS and are set forth specifically in

writing elsewhere in the EULA. Keysight

shall be under no obligation to update,

revise or otherwise modify the Software.

With respect to any technical data as

defined by FAR 2.101, pursuant to FAR

12.211 and 27.404.2 and DFARS 227.7102,

the U.S. government acquires no greater

than Limited Rights as defined in FAR

27.401 or DFAR 227.7103-5 (c), as

applicable in any technical data.

Warranty

THE MATERIAL CONTAINED IN THIS

DOCUMENT IS PROVIDED "AS IS," AND IS

SUBJECT TO BEING CHANGED, WITHOUT

NOTICE, IN FUTURE EDITIONS. FURTHER,

TO THE MAXIMUM EXTENT PERMITTED BY

APPLICABLE LAW, KEYSIGHT DISCLAIMS

ALL WARRANTIES, EITHER EXPRESS OR

IMPLIED WITH REGARD TO THIS MANUAL

AND ANY INFORMATION CONTAINED

HEREIN, INCLUDING BUT NOT LIMITED TO

THE IMPLIED WARRANTIES OF

MERCHANTABILITY AND FITNESS FOR A

PARTICULAR PURPOSE. KEYSIGHT SHALL

NOT BE LIABLE FOR ERRORS OR FOR

INCIDENTAL OR CONSEQUENTIAL

DAMAGES IN CONNECTION WITH THE

FURNISHING, USE, OR PERFORMANCE OF

THIS DOCUMENT OR ANY INFORMATION

CONTAINED HEREIN. SHOULD KEYSIGHT

AND THE USER HAVE A SEPARATE

WRITTEN AGREEMENT WITH WARRANTY

TERMS COVERING THE MATERIAL IN THIS

DOCUMENT THAT CONFLICT WITH THESE

TERMS, THE WARRANTY TERMS IN THE

SEPARATE AGREEMENT WILL CONTROL.

Safety Notices

CAUTION

A CAUTION notice denotes a hazard.

It calls attention to an operating

procedure, practice, or the like that,

if not correctly performed or adhered

to, could result in damage to the

product or loss of important data.

Do not proceed beyond a CAUTION

notice until the indicated conditions

are fully understood and met.

WARNING

A WARNING notice denotes a hazard.

It calls attention to an operating

procedure, practice, or the like that,

if not correctly performed or adhered

to, could result in personal injury or

death. Do not proceed beyond a

WARNING notice until the indicated

conditions are fully understood and

met.

2 Keysight N778xC Series Polarization Instruments Programming Guide

Keysight N778xC Series Polarization Instruments Programming Guide 3

Safety Summary

The following general safety precautions must be observed during all phases of operation

of this instrument. Failure to comply with these precautions or with specific warnings or

operating instructions in the product manuals violates safety standards of design,

manufacture, and intended use of the instrument. Keysight Technologies assumes no

liability for the customer's failure to comply with these requirements. Product manuals

are provided on the Web. Go to www.keysight.com and type in your product number in

the Search field at the top of the page.

General This product is a Protection Class 1 instrument (provided with a protective earth terminal)

and has been manufactured and tested according to international safety standards. The

protective features of this product may be impaired if it is used in a manner not specified

in the operation instructions.

All Light Emitting Diodes (LEDs) used in this product are Class 1 LEDs as per

IEC 60825-1:2014.

Environment Conditions This instrument is intended for indoor use in an Overvoltage Category II, pollution degree

2 environment. It is designed to operate at a maximum relative humidity of 85% RH,

non-condensing and at altitudes of up to 2000 meters. Refer to the specifications tables

for the AC mains voltage requirements and ambient operating temperature range.

Temperature The instrument should be protected from temperature extremes and changes in

temperature that may cause condensation within it.

The operating temperature is from 5 °C to +40 °C.

The storage temperature is from -40 °C to +70 °C.

Before Applying Power Verify that all safety precautions are taken. The power cable inlet of the instrument serves

as a device to disconnect from the mains in case of hazard. The instrument must be

positioned so that the operator can easily access the power cable inlet. When the

instrument is rack mounted the rack must be provided with an easily accessible mains

switch.

Ground the Instrument To minimize shock hazard, the instrument chassis and cover must be connected to an

electrical protective earth ground. The instrument must be connected to the AC power

mains through a grounded power cable, with the ground wire firmly connected to an

electrical ground (safety ground) at the power outlet. Any interruption of the protective

(grounding) conductor or disconnection of the protective earth terminal will cause a

potential shock hazard that could result in personal injury.

Do Not Operate in an

Explosive Atmosphere

Do not operate the instrument in the presence of flammable gases or fumes.

Do Not Remove the

Instrument Cover

Operating personnel must not remove instrument covers. Component replacement and

internal adjustments must be made only by qualified personnel.

Instruments that appear damaged or defective should be made inoperative and secured

against unintended operation until they can be repaired by qualified service personnel.

4 Keysight N778xC Series Polarization Instruments Programming Guide

Instrument Markings

Instrument Marking Description

The instruction manual symbol. The product is marked with this warning symbol when it

is necessary for the user to refer to the instructions in the manual.

Standby supply. Unit is not completely disconnected from AC mains when switch is

off.

The CE mark is a registered trademark of the European Community.

The CSA mark with the 'c' and 'us' subscript indicates the instrument is certified to the

applicable Canadian and United States of America standards respectively.

The RCM mark is a registered trademark of the Australian Communications and Media

Authority

The KC mark is the Korean certification mark. This equipment is Class A suitable for

professional use and is for use in electromagnetic environments outside of the home.

The recycling symbol indicates the general ease with which the instrument can be

recycled.

China Restricted Substance Product Label. The EPUP (environmental protection use

period) number in the center indicates the time period during which no hazardous

or toxic substances or elements are expected to leak or deteriorate during normal

use and generally reflects the expected useful life of the product.

Keysight N778xC Series Polarization Instruments Programming Guide 5

Compliance and Environmental Information

Table 1 Compliance and Environmental Information

Declaration of Conformity

Declarations of Conformity for this product and for the Keysight products may be

downloaded from the Web. Go to http://www.keysight.com/go/conformity.

You can then search by product number to find the latest Declaration of Conformity.

Safety Symbol Description

This product complies with WEEE Directive (2002/96/EC) marking requirements.

The affixed label indicates that you must not discard this electrical/electronic

product in domestic household waste.

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.

Keysight N778xC Series Polarization Instruments Programming Guide 7

Contents

Safety Summary 3

Instrument Markings 4

Compliance and Environmental Information 5

Declaration of Conformity 5

1 Introduction to Programming

Message Queues 10

How the Input Queue Works 10

Clearing the Input Queue 10

The Output Queue 10

The Error Queue 10

Programming and Syntax Diagram Conventions 12

Short Form and Long Form 12

Command and Query Syntax 12

Common Commands 15

Common Command Summary 15

Common Status Information 16

2 Command Summary

Command Summary 20

3 Instrument Setup and Status

IEEE-Common Commands 28

Interface/Instrument Behaviour Settings – The SYSTem

Subsystem 34

System Communicate - The :SYST:COMMunicate sub tree 38

8 Keysight N778xC Series Polarization Instruments Programming Guide

Contents

4 Measurement Operations & Settings

Configure Subsystem Commands 52

Triggering - The TRIGger Subsystem 55

5 Polarization Commands

Polarization Analyzer Commands 62

Polarization Synchronous Scrambler Commands 77

Polarization Synthesizer / Polarization Component Analyzer

Commands 89

6 Error Codes

Error Strings 92

Keysight N778xC Series Polarization Instruments

Programming Guide

1Introduction to

Programming

Message Queues / 10

Programming and Syntax Diagram Conventions / 12

Common Commands / 15

This chapter provides general information on how to control your

instrument remotely.

Descriptions for the actual commands for the instruments are given in the

following chapters. The information in these chapters is specific to the

N778xC polarization instruments.

10 Keysight N778xC Series Polarization Instruments Programming Guide

1 Introduction to Programming

Message Queues

The instrument exchanges messages using an input and an output queue.

Error messages are kept in a separate error queue.

How the Input Queue Works

The input queue is a FIFO queue (first-in first-out). Incoming bytes are

stored in the input queue. The parser starts if the LF character is received.

Clearing the Input Queue

Switching the power off, or sending a Device Interface Clear signal, causes

commands that are in the input queue, but have not been executed to be

lost.

The Output Queue

The output queue contains responses to query messages. The instrument

transmits any data from the output queue when a controller addresses the

instrument as a talker.

Each response message ends with a LF (0A16). If no query is received, or if

the query has an error, the output queue remains empty.

The Message Available bit (MAV, bit 4) is set in the Status Byte register

whenever there is data in the output queue.

The Error Queue

The error queue is 30 errors long. It is a FIFO queue (first-in first-out). That

is, the first error read is the oldest error to have occurred. For example:

1 If no error has occurred, the error queue contains:

+ 0, "No error"

2 After a command such as wav:pow, the error queue now contains:

+ 0, "No error"

-113, "Undefined header"

3 If the command is immediately repeated, the error queue now

contains:

+ 0, "No error"

-113, "Undefined header"

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Keysight Technologies Instrument de mesure

Keysight Technologies

Keysight Technologies 8990B Manuel utilisateur

Keysight Technologies

Keysight Technologies N778 B Series Manuel utilisateur

Keysight Technologies

Keysight Technologies B2900A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies N4960A Manuel utilisateur

Keysight Technologies

Keysight Technologies N432A Manuel utilisateur

Keysight Technologies

Keysight Technologies B1505A Manuel utilisateur

Keysight Technologies

Keysight Technologies M8131A Manuel utilisateur

Keysight Technologies

Keysight Technologies N9030B Guide de démarrage rapide

Keysight Technologies

Keysight Technologies P Series Mode d'emploi

Keysight Technologies

Keysight Technologies E4981A Manuel du propriétaire

Keysight Technologies

Keysight Technologies N9030B Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies B1505A Manuel utilisateur

Keysight Technologies

Keysight Technologies X8712A Manuel utilisateur

Keysight Technologies

Keysight Technologies X Series Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies N4373D Manuel utilisateur

Keysight Technologies

Keysight Technologies B2900A Series Manuel utilisateur

Keysight Technologies

Keysight Technologies PNA-L N5230A Manuel utilisateur

Keysight Technologies

Keysight Technologies C Series Manuel utilisateur

Keysight Technologies

Keysight Technologies U5303A Guide de l'utilisateur

Keysight Technologies

Keysight Technologies N5244/5B Manuel utilisateur

Keysight Technologies

Keysight Technologies M9370A Manuel utilisateur

Keysight Technologies

Keysight Technologies UXA Manuel d'installation et d'exploitation

Keysight Technologies

Keysight Technologies InfiniiMax III Series Manuel utilisateur

Keysight Technologies

Keysight Technologies U4164A 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