Yokogawa AQ6380 User Manual

Download

Page 1

User ’s Manual

AQ6380 Optical Spectrum Analyzer Remote Control

IM AQ6380-17EN

2nd Edition

Page 2

Thank you for purchasing the AQ6380 Optical Spectrum Analyzer. This remote control user’s manual covers the AQ6380. It describes the following and.

• GP-IB Interface

• Ethernet Interface and Communication Commands To ensure correct use, please read this manual thoroughly before beginning operation. After reading this manual, keep it in a convenient location for quick reference in the event a question arises during operation. In addition to this manual, There are four manuals for the AQ6380 including this one. Read them along with this manual.

Contact information of Yokogawa offices worldwide is provided on the following sheet.

Document No. Description

PIM 113-01Z2 List of worldwide contacts

Notes

• The contents of this manual are subject to change without prior notice as a result of improvements in the instrument’s performance and functions. Display contents illustrated in this manual may differ slightly from what actually appears on your screen.

• Every effort has been made in the preparation of this manual to ensure the accuracy of its contents. However, should you have any questions or find any errors, please contact your nearest YOKOGAWA dealer.

• Copying or reproducing all or any part of the contents of this manual without the permission of YOKOGAWA is strictly prohibited.

Trademarks

• Microsoft and Windows are registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

• Adobe and Acrobat are registered trademarks or trademarks of Adobe Systems incorporated.

• The company and product names used in this manual are not accompanied by the registered trademark or trademark symbols (® and TM).

• Other company and product names are registered trademarks or trademarks of their respective companies.

Revisions

• 1st Edition: October 2021

• 2nd Edition: February 2024

IM AQ6380-17EN

Page 3

Manuals

The following manuals, including this one, are provided as manuals for this instrument. Please read all manuals.

Manuals Included with the Product

Manual Title Manual No. Description

AQ6380 Optical Spectrum Analyzer Getting Started Guide

Request to Download AQ6380 Manuals IM AQ6380-73Z2 Describes the manuals provided on the

Optical Spectrum Analyzer IM AQ6360-92Z1 A document for China. Safety Instruction Manual IM 00C01C01-01Z1 A document for the EU.

IM AQ6380-02EN This manual is provided in print. This

guide explains the handling precautions, installation procedure, basic operations, and specifications of this instrument.

website.

Manuals Provided on the Website

Download the following manuals from our website.

Manual Title Manual No. Description

AQ6380 Optical Spectrum Analyzer User’s Manual

AQ6380 Optical Spectrum Analyzer Remote Control User’s Manual

For details on downloading manuals, see Request to Download AQ6380 Manuals (IM AQ638073EN). The “EN”, “Z1”, and “Z2” in the manual numbers are the language codes.

IM AQ6380-01EN This manual. Explains all functions and

operating procedures of the AQ6380 except remote control and program functions.

IM AQ6380-17EN Explains functions for controlling

the instrument with communication commands and program functions.

Online Help

A help document in PDF format stored in the instrument. The contents of this document are the same as the User's Manual (IM AQ6380-01EN). For the operating procedure, see section

9.7.

IM AQ6380-17EN

Page 4

How to Use This Manual

Structure of the Manual

This manual contains seven chapters and an appendix.

Chapter 1 Remote Control Functions

This section describes the various types of communication interfaces.

Chapter 2 GP-IB Interface

Describes the functions and lists the specifications of the GP-IB port.

Chapter 3 Ethernet Interface

Describes the functions and lists the specifications of the Ethernet interface.

Chapter 4 Programming Overview

Describes command syntax and other programming information.

Chapter 5 Commands

Describes every command individually.

Chapter 6 Status Registers

Explains the status byte and describes the various kinds of registers, cues, and other items.

Chapter 7 Program Function

Describes a program function that sets various measurement conditions and executes automated measurement, including , measurement, analysis, and data storage, without the use of an external controller.

Appendix

Provides a table of commands for the setting menu and analysis parameters for each function and explains the compatibility of commands and programs with older models such as the AQ6317/AQ6370D.

IM AQ6380-17EN

iii

Page 5

Sympols and Notation Used in This Manual

Prefixes k and K

Prefixes k and K used before units are distinguished as follows:

··········

Displayed Characters

Bold characters in procedural explanations indicate panel keys and on-screen menu items that are used in the procedure.

Notes and Cautions

The notes and cautions in this manual are categorized using the following symbols.

Denotes 1000. Example: 12 kg, 100 kHz

Denotes 1024. Example: 720 KB (file size)

WARNING

CAUTION

French

Calls attention to actions or conditions that could cause light injury to the user or

AVERTISSEMENT

ATTENTION

Calls attention to information that is important for proper operation of the

Note

Calls attention to actions or conditions that could cause serious or fatal injury to

the user, and precautions that can be taken to prevent such occurrences.

damage to the instrument or user’s data, and precautions that can be taken to prevent such occurrences.

Attire l’attention sur des gestes ou des conditions susceptibles de

provoquer des blessures graves (voire mortelles), et sur les précautions de sécurité pouvant prévenir de tels accidents.

Attire l’attention sur des gestes ou des conditions susceptibles de

provoquer des blessures légères ou d’endommager l’instrument ou les données de l’utilisateur, et sur les précautions de sécurité susceptibles de prévenir de tels accidents.

instrument.

IM AQ6380-17EN

Page 6

IM AQ6380-17EN

Page 7

Manuals ........................................................................................................................................... ii

How to Use This Manual .................................................................................................................. iii

Sympols and Notation Used in This Manual .................................................................................... iv

Chapter 1 Remote Control Functions

1.1 Remote Interfaces .......................................................................................................... 1-1

1.2 Switching between Local and Remote ........................................................................... 1-2

1.3 Sending/Receiving Remote Commands ........................................................................ 1-3

Chapter 2 GP-IB Interface

2.1 Connecting via GP-IB ..................................................................................................... 2-1

2.2 GP-IB Interface Function ................................................................................................ 2-3

2.3 GP-IB Interface Specifications ....................................................................................... 2-4

2.4 Setting the GP-IB Address ............................................................................................. 2-5

2.5 Responses to Interface Messages ................................................................................. 2-7

Chapter 3 Ethernet Interface

3.1 Connecting via Ethernet ................................................................................................. 3-1

3.2 Setting Up Ethernet ........................................................................................................ 3-2

Chapter 4 Programming Overview

4.1 Rules of Syntax and Command Types ........................................................................... 4-1

4.2 Types of Commands ...................................................................................................... 4-3

Chapter 5 Commands

5.1 List of Commands .......................................................................................................... 5-1

5.2 ABORt Group ................................................................................................................. 5-9

5.3 APPLication Group ....................................................................................................... 5-10

5.4 CALCulate Group ......................................................................................................... 5-13

5.5 CALibration Group ....................................................................................................... 5-37

5.6 DISPlay Group ............................................................................................................. 5-39

5.7 FORMat Group ............................................................................................................. 5-44

5.8 INITiate Group .............................................................................................................. 5-45

5.9 MMEMory Group .......................................................................................................... 5-46

5.10 SENSe Group .............................................................................................................. 5-50

5.11 STATus Group .............................................................................................................. 5-54

5.12 SYStem Group ............................................................................................................. 5-55

5.13 TRACe Group .............................................................................................................. 5-58

5.14 TRIGger Group ............................................................................................................ 5-61

5.15 UNIT Group .................................................................................................................. 5-63

5.16 Common Commands Group ........................................................................................ 5-64

5.17 Sample Program .......................................................................................................... 5-67

Chapter 6 Status Registers

6.1 Status Registers ............................................................................................................. 6-1

6.2 Status Byte Registers ..................................................................................................... 6-3

6.3 Standard Event Status Registers ................................................................................... 6-5

6.4 Operation Status Registers ............................................................................................ 6-7

6.5 Questionable Status Registers ..................................................................................... 6-10

IM AQ6380-17EN

Page 8

Contents

Chapter 7 Program Function

7.1 Editing a Program .......................................................................................................... 7-1

7.2 Executing a Program .................................................................................................... 7-13

7.3 Saving/Loading Program Data ..................................................................................... 7-18

7.4 Program Function Commands ..................................................................................... 7-23

7.5 Controlling an External Instrument with the Program Function .................................... 7-52

7.6 Sample Program .......................................................................................................... 7-53

Appendix

Appendix 1 Table of Correspondence between Soft Keys and Remote Commands ............ App-1

Appendix 2 ANALYSIS Setting Parameters ........................................................................ App-12

Appendix 3 Output Format for Analysis Results .................................................................. App-23

Appendix 4 List of the AQ6317-Compatible Commands ..................................................... App-27

Appendix 5 HIGH1, HIGH2, HIGH3 of Measurement Sensitivity ........................................ App-40

Compatibility of Remote Commands of Legacy Models (AQ6370D, etc.) .............................. App-41

Appendix 7 Compatibility of Program Commands and Variables of Legacy Models

(AQ6370D, etc.) ...............................................................................................App-42

App

Index

IM AQ6380-17EN

vii

Page 9

Chapter 1 Remote Control Functions

1.1 Remote Interfaces

This instrument is equipped with the following remote interfaces.

GP-IB (IEEE 488.2, See Chapter 2)

This port is used to connect a controller such as a PC to remote control this instrument. Connect a controller or another device controlled by the controller to this port. This instrument is controlled using remote commands. Two types of remote commands are provided: the instrument’s native commands complying with SCPI (Standard Commands for Programmable Instruments), and commands compatible with the conventional model AQ6317 (see the appendix).

Ethernet (See Chapter 3)

This port is used to connect a controller such as a PC to control the instrument remotely via network.

Remote Control Functions

IM AQ6380-17EN

1-1

Page 10

1.2 Switching between Local and Remote

Switching from Local to Remote

When in Local mode, if a listen address is sent from the controller that sets REN (remote enable) and ATN to “True,” the instrument enters Remote mode.

• When in Remote mode, the REMOTE indicator lights.

• Keys other than the LOCAL key are disabled.

• Settings entered in Local mode are held even if switching to Remote mode.

• When an LLO (Local Lock Out) message is received from the controller, the instrument enters local lockout status. In LLO status, the LOCAL key is disabled and does not return the instrument to Local mode even when pressed. After cancelling the local lockout status, press the LOCAL key. To cancel the local lockout status, set REN to “False” from the controller.

Switching from Remote to Local

If you press the LOCAL key when in Remote mode the instrument enters Local mode. However, it does not return to Local mode if in the local lockout state.

• The REMOTE indicator turns off.

• All keys are enabled.

• Settings entered in Remote mode are held even if switching to Local mode.

• When a GTL (Go to Local) message is received from the controller, the instrument enters Local mode even if REN is set to False.

1-2

IM AQ6380-17EN

Page 11

1.3 Sending/Receiving Remote Commands

Buffers

Input Buffer

The instrument’s input buffer is a single stage 4 MB buffer. When receiving data that exceeds the buffer size, the data after the first megabyte is discarded. The remote command after the last command separator of the 4 MB of data is deleted.

Output Buffer

The instrument’s output buffer is a single stage 4 MB buffer. Only the most recent data is held. (When a talker command is received while there is data in the buffer, the old data in the buffer is replaced with the incoming data.) When talker commands are combined and executed resulting in generation of talker data that exceeds the buffer size, the following process is carried out.

• The query error bit (QYE) of the standard event status register is set to 1.

• The talker output buffer is cleared.

• Commands received even after the buffer overflow are processed. Note, however, that talker data by talker commands is not stored at the output buffer.

Remote Control Functions

Error Buffer

This instrument’s error buffer is of a single stage and stores only the latest error information.

Message Terminators

This instrument allows the following message terminators to be used.

Program Message Terminators

• Assertion of EOI (End-Of-Identify) signal

• LF (line feed) character

• LF+EOI

Here, LF is a line feed (0Ah) in ASCII. For CR + LF, because CR (0Dh) is recognized as “wsp,” CR + LF can consequently also be used as a message terminator. Also, for waveform binary transfer, only EOI is used as a message terminator.

Response Message Terminator

LF+EOI is used as the response message terminator.

IM AQ6380-17EN

1-3

Page 12

1.3 Sending/Receiving Remote Commands

Receiving Remote Commands

• When completing receipt of a remote command, the instrument releases the GP-IB bus.

• When receiving the next command while a command action is being executed, the instrument captures that command to store it in the receive buffer, and then releases the GP-IB bus.

• When there is a remote command in the receive buffer, the instrument does not capture a successive command even if there are commands on the GP-IB bus.

• When the action of the preceding command is complete, the instrument executes the command stored in the receive buffer and clears the buffer. Then it captures the next command into the receive buffer if there is one on the bus.

• When an output statement contains multiple remote commands, this instrument captures them all and services them in the order they were written. In this case, unless the last command in the statement has started to be executed, this instrument cannot capture the next command.

Data Inquiry

• Inquiry of data by the external controller is made using a query command or a data output request from the controller.

• Query commands end with a question mark (?).

• For query commands with an argument, the argument is specified in the form of <wsp> + <argument> at the end of the “?”.

• When a query command is received, the instrument prepares a reply to the query command in the output buffer.

• Data in the output buffer will be retained until the instrument receives an input statement or a new query command from the controller.

• If multiple query commands are specified and written in succession using a semicolon “;”, the instrument prepares replies to all of them in the output buffer. In this case, the instrument will collectively output all of the prepared data when receiving the next data output request.

Setting the timeout time

A timeout time setting of 30 seconds or more is recommended. This instrument performs auto offset and auto wavelength calibration for about 30 seconds each every about 10 minutes. The communication timeout of the external controller should be set to 30 seconds or more so that a timeout does not occur during the execution of the offset. See the user’s manual of your remote interface card for instructions on how to set the communication timeout time.

By default, the auto offset function and auto wavelength calibration function are turned on in this instrument. The instrument performs offset adjustment and wavelength calibration of the analog circuits every about 10 minutes. Each process takes about 30 seconds.

1-4

IM AQ6380-17EN

Page 13

1.3 Sending/Receiving Remote Commands

If you do not want to set the communication timeout to 30 seconds or less

To avoid remote malfunctions due to communication timeouts, offset processing can be performed manually. Turn off the auto offset function and auto wavelength calibration function in advance, and then execute these functions manually between measurement sequences. Wait approximately 30 seconds until the offset process and auto wavelength calibration are finished. After the offset is complete, restart the measurement sequence.

The remote commands are as follows.

• Turn OFF the auto offset function :CALibration:ZERO off

• Perform a manual offset :CALibration:ZERO once

• Turn OFF the auto wavelength calibration function :CALibration:WAVelength:INTernal:AUTO OFF

• Perform a wavelength calibration :CALibration:WAVelength:INTernal

Note

• An offset interval of 10 minutes is recommended.

• If the AUTO OFFSET key is OFF, the offset can fluctuate over time, and the level axis performance can

degrade. Always have it turned ON.

• When the AUTO OFFSET key is set to ON,

is displayed at the bottom of the screen.

Remote Control Functions

• When the AUTO CALIBRATION key is set to ON,

is displayed at the bottom of the screen.

Device Trigger Function

When GET (Group Execute Trigger) is received, the instrument will perform a single sweep.

IM AQ6380-17EN

1-5

Page 14

Chapter 2 GP-IB Interface

AQ6380

2.1 Connecting via GP-IB

GP-IB Cable

This instrument is equipped with an IEEE standard 488-1978 24-pin GP-IB connector. Use a GP-IB cable that conforms to the IEEE standard 488-1978.

Connections

Can be connected to a PC for remote control of the instrument from the PC. Turn OFF all the power switches of the AQ6380 and any devices to be connected to it. Connect a cable to the GP-IB port on the rear panel of the instrument.

CAUTION

Always turn OFF the power to the instrument and the PC when connecting or disconnecting communication cables. Failure to turn OFF the power can result in malfunction or damage to internal circuitry.

French

ATTENTION

GP-IB Interface

Veillez à mettre le PC et l’oscilloscope AQ6380 hors tension lorsque vous branchez ou débranchez les câbles de communication, car cela risquerait de provoquer des dysfonctionnements ou des courts-circuits internes.

IM AQ6380-17EN

2-1

Page 15

2.1 Connecting via GP-IB

Precautions When Making Connections

• Securely fasten the screw that is attached to the GP-IB cable connector.

• You can connect several cables to connect to several devices. However, fifteen or more devices including the controller cannot be connected to a single bus.

• When connecting several devices, you cannot specify the same address for more than one.

• Use a cable of two meters or longer to connect between devices.

• Ensure that the total length in cables does not exceed twenty meters.

• When carrying out communications, make sure that at least two-thirds of all connected devices are turned ON.

• To connect multiple devices, wire them in a daisy-chain or star configuration as shown below. You can also mix these configurations. Loop configuration is not allowed.

2-2

IM AQ6380-17EN

Page 16

2.2 GP-IB Interface Function

GP-IB Interface Function

Listener Function

• All of the same settings can be performed using the interface (except for power ON/OFF and communication settings) as when using the instrument’s panel keys.

• Settings, waveforms, and other data can be received through output commands from the controller.

• Additionally, you can also receive commands regarding status reports and other data.

Talker Function

• Settings, waveforms, and other data can be output.

Note

Listen only, talk only, and controller functions are not available.

Switching between Remote and Local

Switching from Local to Remote

When in Local mode, if the instrument received a listen address from the controller that sets REN (remote enable) and ATN to “True,” the instrument enters Remote mode.

• When in Remote mode, the REMOTE indicator lights.

• Keys other than the LOCAL key are disabled.

• Settings entered in Local mode are held even if switching to Remote mode.

• When an LLO (Local Lock Out) message is received from the controller, the instrument enters local lockout status. In LLO status, the LOCAL key is disabled and does not return this instrument to Local mode even when pressed. After cancelling the local lockout status, press the LOCAL key. To cancel the local lockout status, set REN to “False” from the controller.

GP-IB Interface

Switching from Remote to Local

If you press the LOCAL key when in Remote mode the instrument enters Local mode. However, it does not return to Local mode if in the local lockout state.

• The REMOTE indicator turns off.

• All keys are enabled.

• Settings entered in Remote mode are held even if switching to Local mode.

• When a GTL (Go to Local) message is received from the controller, the instrument enters Local mode even if REN is set to False.

Note

The GP-IB interface cannot be used simultaneously with other communication interfaces (Ethernet).

IM AQ6380-17EN

2-3

Page 17

2.3 GP-IB Interface Specifications

GP-IB Interface Specifications

Electromechanical specifications: Conforms to IEEE std. 488-1978 Functional specifications: See table below Protocols: Conforms to IEEE std. 488.2-1992 Encoding: ISO (ASCII) Mode: Addressable mode Address setting: Addresses 0-30 can be set in the GP-IB setting screen in the SYSTEM

menu.

Remote mode cancel: Press LOCAL to cancel Remote mode. Note that this is disabled when

under Local Lockout by the controller.

Functional Specifications

Function Subset Description

Source handshake SH1 All capabilities of send handshake Acceptor handshake AH1 All capabilities of receive handshake Talker T6 Basic talker function, serial polling, and talker cancel function through

MLA (my listen address). Talker only not provided.

Listener L4 Basic listener function, serial polling, and listener cancel function

through MLA (my listen address). Listener only not provided. Service request SR1 All service request functions Remote local RL1 All Remote/Local functions Parallel port PP0 Parallel polling function not provided Device clear DC1 All device clear functions

Output buffer clear

Input buffer clear (clearing of an unexecuted commands)

Error buffer clear

STB, ESR clear Device trigger DT0 Device trigger function Controller C0 Controller function not provided Electrical characteristics E1 Open collector

2-4

IM AQ6380-17EN

Page 18

2.4 Setting the GP-IB Address

Procedure

Selecting the Communication Interface

Press SYSTEM. The SYSTEM menu is displayed.

Tap the More repeatedly until the More 2/4 menu is displayed.

Tap the Remote Interface. The Remote Interface menu is displayed.

Tap the GP-IB to specify GP-IB as the communication interface.

GP-IB address setting

GP-IB Interface

Setting the Address

Tap the GP-IB Setting. The GP-IB Setting menu is displayed.

Tap the My Address. The GP-IB address setting screen is displayed.

Set the GP-IB address using the rotary knob or the arrow keys, and press ENTER.

GP-IB address setting

Command format

IM AQ6380-17EN

2-5

Page 19

2.4 Setting the GP-IB Address

Setting the Command Format

Perform these steps if you will use AQ6317 commands. Tap the Command Format. The

command format setting menu is displayed.

Normally, you will enter AQ6380. If you wish to use AQ6317 commands, enter AQ6317.

Explanation

The settings below are used when entering the settings that can be entered using the instrument’s panel keys from a controller, or when outputting settings or waveform data to the controller.

GP-IB Address Settings

When in Addressable mode, set the instrument’s address within the following range. 0–30 Each device that can be connected via GP-IB has its own unique GP-IB address. This address allows each device to be distinguished from other devices. Therefore, when connecting the instrument to a PC or other device, make sure not to set the same address on the instrument as any of the other devices.

Note

Do not change an address while the controller or other devices are using GP-IB.

Command Format Settings

Normally, you will enter AQ6380 mode. If you wish to use the commands of the AQ6317 (another product in the series), enter AQ6317. See the appendix for AQ6317 commands that are compatible with the AQ6317.

2-6

IM AQ6380-17EN

Page 20

2.5 Responses to Interface Messages

Responses to Interface Messages

Responses to Uniline Messages

• IFC (Interface Clear)

Clears talker and listener. Output is cancelled if outputting data.

• REN (Remote Enable)

Switches between Local and Remote.

IDY (Identify) is not supported.

Responses to Multiline Messages (Address Commands)

• GTL (Go To Local)

Switches to Local mode.

• SDC (Selected Device Clear)

• Clears program messages (commands) being received, and the output queue.

• The *OPC and *OPC? commands are invalid during execution.

• The *WAI command closes immediately.

PPC (parallel poll configure) and TCT (take control) are not supported.

Responses to Multiline Messages (Universal Commands)

• LLO (Local Lockout)

Disables the front panel UNDO/LOCAL operation, and prohibits switching to Local mode.

• DCL (Device Clear)

Same operation as SDC.

• SPE (Serial Poll Enable)

Places the talker function of all devices on the bus in Serial poll mode. The controller polls each device in order.

• SPD (Serial Poll Disable)

Cancels Serial poll mode for the talker function of all devices on the bus.

GP-IB Interface

PPU (Parallel Poll Unconfigure) is not supported.

Definition of Interface Messages

Interface messages are also called interface commands or bus commands, and are commands that are issued from the controller. Interface messages come in the following categories.

Uniline Messages

A message is sent through a single command line. The following are the three types of uniline messages.

• IFC (Interface Clear)

• REN (Remote Enable)

• IDY (Identify)

IM AQ6380-17EN

2-7

Page 21

2.5 Responses to Interface Messages

Interface Messages

Multiline Messages

A message is sent through eight data lines. Multiline messages come in the following categories.

• Address Commands

These commands are valid when the device is specified as the listener or the talker. The following are the five types of address commands. Commands valid for devices specified as listeners

GTL (Go To Local)

・

SDC (Selected Device Clear)

・

PPC (Parallel Poll Configure)

・

GET (Group Execute Trigger)

・

Commands valid for devices specified as talkers

TCT (Take Control)

・

• Universal Commands

These commands are valid for all devices regardless of whether they are specified as listeners, talkers, or neither. The following are the three types of universal commands.

LLO (Local Lockout)

・

DCL (Device Clear)

・

PPU (Parallel Poll Unconfigure)

・

Additionally, an interface message can consist of a listener address, talker address, or secondary command.

Multiline messages

Uniline

messages

IFC REN IDY

Listener

address

Address

commands

GTL SDC PPC GET TCT

Talker

address

Universal

commands

LLO DCL PPU SPE SPD

Secondary

command

2-8

IM AQ6380-17EN

Page 22

Chapter 3 Ethernet Interface

3.1 Connecting via Ethernet

You can connect to a LAN using the Ethernet interface for control of the instrument from a PC.

Ethernet Interface Specifications

Communication ports: 1 Electromechanical specifications: Conforms to IEEE802.3 Transmission method: Ethernet (10BASE-T/100BASE-TX/1000BASE-T) Transmission speed: 10 Mbps/100 Mbps/1000 Mbps Communication protocol: TCP/IP Connector type: RJ45 Port number used: 10001/tcp (default)

Connections

Connect a UTP (unshielded twisted-pair) cable or an STP (shielded twisted-pair) cable that is connected to another device to the ETHERNET port on the rear panel of the instrument.

Ethernet Interface

AQ6380

Precautions When Making Connections

• Be sure to use a straight cable through a hub when connecting a PC to the instrument. Performance cannot be guaranteed if a 1-to-1 connection is made with a cross cable.

• Use a network cable that supports the data rate of your network.

IM AQ6380-17EN

3-1

Page 23

3.2 Setting Up Ethernet

Procedure

Configuring the communication interface

1.

Press SYSTEM. The SYSTEM menu appears.

2.

Tap More to display the More 2/4 menu.

Tap Remote Interface. The Remote Interface menu appears.

Tap NETWORK (SOCKET) or NETWORK (VXI-11) to set the communication interface to

Ethernet.

Socket communication

VXI-11 communication

3-2

IM AQ6380-17EN

Page 24

Configuring the network settings

1.

Press SYSTEM. The SYSTEM menu appears.

2.

Tap More to display the More 2/4 menu.

Tap Network Setting. The Network Setting menu appears.

3.2 Setting Up Ethernet

Set the TCP/IP parameters.

Set the port number.

Set the command format.

Set the user account.

Setting the TCP/IP parameters

Tap TCP/IP Setting. The TCP/IP setting menu appears.

Tap AUTO (DHCP) or MANUAL.

To use a DHCP server, select AUTO (DHCP).

If you select MANUAL, set the IP address, subnet mask, and default gateway. If you select

AUTO, proceed to step 10.

Configure the remote monitor.

Set folder sharing.

Set the timeout.

Ethernet Interface

Tap the IP address, subnet mask, and default gateway input boxes. A setting window appears.

Set the IP address, subnet mask, and default gateway on the setting window.

When you finish setting all the items, tap Done.

IM AQ6380-17EN

3-3

Page 25

3.2 Setting Up Ethernet

Setting the port number (not used with the VXI-11)

Continuing from step 3, tap Remote Port No. A window appears for setting the port number.

Set the port number on the setting window.

Setting the user account (not used with the VXI-11)

Continuing from step 3, tap Remote User Account. The Remote User Account menu

appears.

Tap User Name. A keyboard appears.

The default value is anonymous.

Enter the user name using up to 11 alphanumeric characters. If the user name is set to

anonymous, you do not have to set a password.

Tap Password. A keyboard appears.

Enter the password using up to 11 alphanumeric characters.

Set the user name.

Set the password.

3-4

IM AQ6380-17EN

Page 26

3.2 Setting Up Ethernet

Configuring the Remote Monitor

This function can be used to monitor the instrument’s screen and control the instrument from a remote PC that is connected over TCP/IP.

Continuing from step 3, tap Remote Monitor. The remote monitor setting menu appears.

Tap Monitor Port. The value toggles between On and Off. A remote monitor can be connected

when the setting is on.

To disconnect the remote monitor, tap Disconnect. The monitor will be disconnected from the

PC.

Turns monitor port on or off

Port number (fixed to 20001)

Disconnects remote monitoring

Setting folder sharing

The user area folder of the instrument’s internal memory can be shared with a PC.

Continuing from step 3, tap Folder Sharing. The Folder Sharing menu appears.

Tap Read Only. The user area folder of the instrument is shared over the network (read only).

Tapping Disable will disable folder sharing.

Ethernet Interface

The user name and password needed to access the shared folder are as follows:

User name: user

Password: yokogawa

Setting the remote timeout (not used with the VXI-11)

Continuing from step 3, tap Time Out. A setting window appears.

Set the timeout value on the setting window.

IM AQ6380-17EN

3-5

Page 27

3.2 Setting Up Ethernet

Explanation

Configuring the network settings

Setting the TCP/IP parameters

If a DHCP server is available on the network that the instrument is connected to, an IP address is automatically assigned to the instrument. In this case, select AUTO (DHCP) in the TCP/IP settings. For details about the network that you intend to connect the instrument to, contact your network administrator.

REMOTE PORT NO. (not used with the VXI-11)

Set the port number to use to control the instrument remotely over the network (socket). (Default value: 10001)

User authentication (not used with the VXI-11)

If you want to connect to the instrument from your PC over an Ethernet network, user authentication is required. If the user name is anonymous, you do not have to enter a password. The instrument supports plaintext authentication and the MD5 algorithm (RSA Data Security, Inc. MD5 Message DigestAlgorithm).

Remote monitoring

This function can be used to monitor the instrument's screen and control the instrument from a remote PC that is connected to the instrument through a TCP/IP port. To use this feature, you need remote monitoring software (not included). You cannot use the remote monitoring port to perform remote control with normal remote commands. For information on remote monitoring software, contact your nearest YOKOGAWA dealer.

User name and password

A user name and password are required to access the instrument using this function. Enter the user name using up to 11 alphanumeric characters. If the user name is set to anonymous, you do not have to set a password. Enter the password using up to 11 alphanumeric characters.

MONITOR PORT

Enables and disables the remote monitor TCP/IP port. If you set this to Off, the remote monitor will be disabled.

PORT NO.

This is the remote monitor TCP/IP port number. It is fixed to 20001. You cannot use this port to perform remote control with normal remote commands.

DISCONNECT

If you tap this menu while remote monitoring is connected, remote monitoring with the external PC will be disconnected. This menu can only be used when remote monitoring is connected.

3-6

IM AQ6380-17EN

Page 28

3.2 Setting Up Ethernet

Folder sharing

The user area folder of the instrument’s internal memory can be shared with a PC. When the user area folder is shared, files in the folder can be copied to the PC over a network. Note that you cannot save files to the instrument. If you are prompted to enter a user name and password when accessing the instrument’s shared folder from the PC, enter the following information. User name: user Password: yokogawa

Timeout period (not used with the VXI-11)

If no communication takes place for the specified time in remote mode, the communication is automatically disconnected, and the mode changes to local. When you change the timeout period, the elapsed time is reset. You can set the time to Infinite (0 s) or between 1 and 21600 s (6 hours).

Ethernet Interface

IM AQ6380-17EN

3-7

Page 29

3.2 Setting Up Ethernet

Remote Control Using Commands

The AQ6380 can be remote controlled using the LAN port. For remote commands, use the same commands as those for control via the GP-IB interface. The instrument also supports VXI-11 control.

Switching Interfaces

Select GP-IB, NETWORK (SOCKET), or NETWORK (VXI-11) as an interface to use for remote control. When you change the interface, the connection status is reset. In addition, the UNDO/ LOCAL key disconnects the connection. Otherwise, the connection is kept open unless closed by the controller.

Remote Commands

As with GP-IB-based remote control, you can select the command format from the AQ6380 mode or from the AQ6317-compatible mode.

Interrupt by SRQ

An SRQ interrupt does not occur during NETWORK(SOCKET)-based remote control.

Status Register

The status registers operate in the same manner as in remote control via the GP-IB interface. Using the “*SPOOL?” command dedicated for remote control using the LAN port allows you to read the status registers, as in the case with serial polling via the GP-IB interface.

• *STB?: When AQ6380 is the setting of the COMMAND FORMAT key

• SPOLL?: When AQ6317 is the setting of the COMMAND FORMAT key

Delimiter

The delimiter for LAN-based remote control is fixed to CR + LF.

Transmission of Talker Data

When NETWORK (SOCKET) is in use, if the instrument receives talker data from the controller PC, the instrument sends the data to the controller PC’s buffer. It receives the external PC's buffer data and stores the query data.

Connection

The instrument can only be connected to one controller (an external PC or other device). If the instrument receives a connection request from a controller while already connected to another controller, the new connection is not opened and the existing connection is kept open.

Computer Name

The instrument’s computer name is as follows. For the AQ6380 “6380@@@@@@@@@” (where “@@@@@@@@@” is the serial number)

3-8

IM AQ6380-17EN

Page 30

3.2 Setting Up Ethernet

Commands that are Necessary for Remote Control over the LAN

The authentication by OPEN command is required to remote control over the NETWORK(SOCKET). Both the OPEN and CLOSE commands are also valid in AQ6317 mode.

OPEN

Function Sends the user name and starts user authentication. Syntax username = the user name Example Explanation Authentication is carried out with the OPEN command as follows.

• For Plain Text Authentication

Send OPEN "username" to the AQ6380. The response message is received from the AQ6380.

Confirm that the received message is "AUTHENTICATE CRAM-MD5."

Send the password to the AQ6380 (anything can be input if the user name is anonymous).

If the message, "READY" is received from the AQ6380, authentication was successful. The

AQ6380's REMOTE indicator lights, and sending of remote commands is enabled. If the user name and password are incorrect, authentication fails and the connections is closed.

OPEN<wsp>"username"

OPEN "yokogawa"

-> AUTHENTICATE CRAM-MD5.

Ethernet Interface

• For Encrypted Authentication

Send OPEN "username" to the AQ6380. The response message is received from the AQ6380.

Confirm that the received message is "AUTHENTICATE CRAM-MD5."

Send "AUTHENTICATE CRAM-MD5 OK" to the AQ6380. The response message (challenge

string) is received from the AQ6380.

The received challenge string and password are processed with an MD5 hash algorithm

(anything can be input if the user name is anonymous).

Send the returned hash data (as a 32-character hexadecimal string in lower case) to the

AQ6380, and receive the response message.

If the message, "READY" is received from the AQ6380, authentication was successful. The

AQ6380's REMOTE indicator lights, and sending of remote commands is enabled. If the user name and password are incorrect, authentication fails and the connection is closed.

Function Closes the connection (turns it OFF), and switches to local mode. Syntax Example

IM AQ6380-17EN

3-9

Page 31

Chapter 4 Programming Overview

4.1 Rules of Syntax and Command Types

The following information is intended for the common commands and instrument-specific commands contained in this manual. Measured values and parameters are all sent and received using ASCII characters, not including special commands.

Description of Rules of Syntax

Rule Description

| Indicates that one of the elements in a list should be selected.

A|B|C

E.g.: [ ] An item in square brackets is specified as desired. <wsp>¹ Space <integer> Integer <NRf> Exponent indicating value <"file name"> A file name can be a maximum of 56 characters, including

extensions, excluding the directory part. Enclose a character string

using double quotations (" "). <trace name> Trace name (TRA|TRB|TRC|TRD|TRE|TRF|TRG) <marker> Marker number (0: moving marker, 1 to 1024: fixed markers) <"string"> Character string

Enclose a character string using double quotations (" ").

1. Regarding white space (<wsp>): White space is defined as a character corresponding to 00h to 20h (not including 0Ah (LF)) of the ASCII character sets.

Aside from inserting it between a command and parameters (when specifying parameters) or using it as space in a character string such as a file name in a parameter, white space can be inserted as desired to make a program legible.

= A, B, or C is used

Programming Overview

Collective Transmission of Multiple Commands

You can create a command string using the commands described in chapter 5, “Commands” and send it to the instrument. If multiple commands are written in a single output statement by using a semicolon “;” to delimit each command, the commands will be executed in the order in which they have been written.

Format of a Remote Command

• Short and Long Forms

The instrument’s commands support both short and long forms. For the commands contained in this manual, the part written in capital letters is the short form of the command concerned. The short form of the INITiate command is INIT.

• Upper- and Lower-Case Letters

The instrument does not distinguish between upper- and lower-case letters. Return values are all in upper-case letters.

IM AQ6380-17EN

4-1

Page 32

4.1 Rules of Syntax and Command Types

• Grouping of SCPI Commands Using a Subsystem

The instrument supports the subsystem-based grouping of the SCPI commands. Commands belonging to the same sub-system and existing at the same tree of the hierarchical structure of the subsystem can be sent in combination. In this case, each command should be delimited by a semicolon. List of GP-IB commands used in examples :SENSe :SETTing :SMOothing :WAVelength :STOP :STARt :SENSe:WAVelength:STARt 1500NM;STOP 1600NM (Y) :SENSe:WAVelength:STARt 1500NM;SMOothing ON (X) (Reason: They are not in the same hierarchy.) :SENSe:WAVelength:STARt 1500NM;:STOP 1600NM (X) (Reason: A colon “:” is unnecessary after a semicolon “;”.)

• Numerics

This instrument supports multiple notation methods when receiving a numeric(s). This instrument uses only the basic units when transmitting a numeric(s). The number of digits for the real part is fixed to a one digit integer (with a sign) and eight digits for decimal places. The number of digits for the exponential part is fixed to 3. Ex.: Receivable numerics (in case of 1550 nm) 1550 nm, 1.55 um, 1550E-9, 1.55E-6, and others Ex.: Transmittable numerics (in case of 1550 nm) +1.55000000E-006 only If a received numeric has a precision higher than the range of numerics handled

inside this unit, lower decimal places will be rounded off rather than being discarded.

This instrument can handle the following multiplier suffixes:

Multiplier Mnemonic Multiplier Mnemonic

1E18 EX (exa) 1E-3 M (milli) 1E15 PE (peta) 1E-6 U (micro) 1E12 T (tera) 1E-9 N (nano) 1E9 G (giga) 1E-12 P (pico) 1E6 MA (mega) 1E-15 F (femto) 1E3 K (kilo) 1E-18 A (atto)

• Specification of Parameters in a Command

To use parameters in a command, a space must be placed between the command and parameters. Each parameter is delimited by a comma “,”. A space may also be placed before and after a comma to make the command legible.

4-2

IM AQ6380-17EN

Page 33

4.2 Types of Commands

This unit’s commands can be classified into the following three types:

Types of Commands

Sequential Commands

• These commands are the most general commands.

• The action of another command is not performed until the running of a sequential command is complete.

• Another action is not started until the running of the other command is complete.

Overlappable Commands

• An overlappable command allows execution of an overlapping command while it is being run. Ex. of command: :INITialte Makes a sweep.

Overlapping Commands

• An overlapping command can be executed while an overlappable command is being run.

• These commands cannot be executed while a sequential command is being executed or if it has not yet been processed. Ex. of command: :ABORt Stops measurement or calibration action.

*STB? Reads status byte.

Programming Overview

AQ6317-Compatible Commands

The instrument supports AQ6317-compatible commands. When using AQ6317-compatible commands, call up the SYSTEM menu using the SYSTEM key and place the instrument in AQ6317-compatible mode.

IM AQ6380-17EN

4-3

Page 34

Chapter 5 Commands

5.1 List of Commands

Command Function Page

ABORt Group

:ABORt

APPLication Group

:APPLication:DLOGging:ETIMe? :APPLication:DLOGging:LPARamete r:INTerval :APPLication:DLOGging:LPARamete r:ITEM :APPLication:DLOGging:LPARamete r:LMODe :APPLication:DLOGging:LPARamete r:MEMory :APPLication:DLOGging:LPARamete r:MTHResh :APPLication:DLOGging:LPARamete r:PDETect:ATHResh :APPLication:DLOGging:LPARamete r:PDETect:RTHResh :APPLication:DLOGging:LPARamete r:PDETect:TTYPe :APPLication:DLOGging:LPARamete r:TDURation :APPLication:DLOGging:LPARamete r:TLOGging :APPLication:DLOGging:STATe :APPLication:PROGram:EXECute

CALCulate Group

:CALCulate:ARESolution? :CALCulate:CATegory :CALCulate:DATA? :CALCulate:DATA:CGAin? :CALCulate:DATA:CNF? :CALCulate:DATA:CPOWers?

:CALCulate:DATA:CSNR? :CALCulate:DATA:CWAVelengths?

:CALCulate:DATA:DFBLd? :CALCulate:DATA:NCHannels?

:CALCulate:DATA:OSLope?

:CALCulate:DISPlay :CALCulate:DISPlay:GRAPh:LMARKe r:Y :CALCulate[:IMMediate]

:CALCulate[:IMMediate]:AUTO :CALCulate:LMARker:AOFF :CALCulate:LMARker:SRANge

:CALCulate:LMARker:SSPan :CALCulate:LMARker:SZSPan :CALCulate:LMARker:X :CALCulate:LMARker:Y

Stops operations such as measurements and calibration. 5-9

Queries the elapsed time of data logging (in seconds). 5-10 Sets or queries the measurement interval of data logging. 5-10

Sets or queries the data logging source. 5-10

Sets or queries the data logging mode (maximum channel mode or maximum logging mode). Sets or queries the temporary area for saving waveform files of data logging. 5-10

Sets or queries the threshold of the channel-matching wavelength λ for data

logging. Sets or queries the threshold (absolute value) for detecting the data logging mode. Sets or queries the threshold (relative value) for detecting the data logging mode. Sets or queries how the threshold for detecting the data logging mode (peak or bottom) is specified. Sets or queries the measurement duration of data logging (in seconds). 5-11

Sets or queries whether waveforms will be logged during data logging. 5-11

Starts, stops, or queries data logging. 5-12 Executes a program that has been specified. 5-12

Queries the actual resolution data of the specified trace. 5-13 Sets or queries the type of analysis. 5-14 Queries the analysis results. 5-14 Queries the gain value of the EDFA-NF analysis results. 5-14 Queries the NF value of the EDFA-NF analysis results. 5-14 Queries the level value of the OSNR(WDM), WDM, EDFA-NF, WDM FIL-PK, or WDM FIL-BTM analysis results. Queries the SNR value from the last time WDM analysis was executed. 5-15 Queries the wavelength value of the OSNR(WDM), WDM, EDFA-NF, WDM FIL-PK, or WDM FIL-BTM analysis results. Queries the DFB-LD analysis results. 5-15 Queries the number of channels of the OSNR(WDM), WDM, EDFA-NF, WDM FIL-PK, WDM FIL-BTM, or WDM SMSR analysis results. Queries the OUTPUT SLOPE value of the OSNR (WDM) and WDM analysis results. Sets or queries the display format of analysis results. 5-16 Sets or queries the position of line marker Y1 or Y2 on the graph display of analysis results. Executes analysis. Queries the result of whether analysis has been performed. Sets or queries the automatic analysis function. 5-16 Clears all line markers. 5-16 Sets or queries whether to limit an analytical range to the spacing between line markers L1 and L2. Sets spacing between line markers L1 and L2 for span. 5-17 Sets spacing between line markers L1 and L2 for zoom span. 5-17 Sets or queries the position of line markers L1 and L2. 5-17 Sets or queries the position of line markers L3 and L4. 5-17

5-10

5-11

5-15

5-16

5-17

Commands

IM AQ6380-17EN

5-1

Page 35

5.1 List of Commands

Command Function Page

:CALCulate:MARKer:AOFF :CALCulate:MARKer:AUTO :CALCulate:MARKer:FUNCtion:FORM at :CALCulate:MARKer:FUNCtion:UPDa te :CALCulate:MARKer:IRANge

:CALCulate:MARKer:MAXimum :CALCulate:MARKer:MAXimum:LEFT

:CALCulate:MARKer:MAXimum:NEXT

:CALCulate:MARKer:MAXimum:RIGHt

:CALCulate:MARKer:MAXimum:SCENt er :CALCulate:MARKer:MAXimum:SCENt er:AUTO :CALCulate:MARKer:MAXimum:SRLev el :CALCulate:MARKer:MAXimum:SRLev el:AUTO :CALCulate:MARKer:MAXimum:SZCen ter :CALCulate:MARKer:MINimum :CALCulate:MARKer:MINimum:LEFT

:CALCulate:MARKer:MINimum:NEXT

:CALCulate:MARKer:MINimum:RIGHt

:CALCulate:MARKer:MSEarch :CALCulate:MARKer:MSEarch:SORT :CALCulate:MARKer:MSEarch:THRe sh :CALCulate:MARKer{:PDENsity|:NO ISe}{:BWIDth|:BANDwidth} :CALCulate:MARKer:SCENter

:CALCulate:MARKer:SRLevel :CALCulate:MARKer[:STATe]

:CALCulate:MARKer:SZCenter

:CALCulate:MARKer:TYPE :CALCulate:MARKer:UNIT :CALCulate:MARKer:X

:CALCulate:MARKer:Y? :CALCulate:MATH:TRC :CALCulate:MATH:TRC:K :CALCulate:MATH:TRF :CALCulate:MATH:TRF:PNBW:BWIDth |BANDwidth :CALCulate:MATH:TRG :CALCulate:MATH:TRG:CVFT:FALGo

:CALCulate:MATH:TRG:CVFT:OPARea :CALCulate:MATH:TRG:CVFT:THResh :CALCulate:MATH:TRG:PCVFt:THRe sh

Clears all markers. 5-17 Sets or queries the auto search function. 5-17 Sets the format of a difference value displayed in the area marker and queries the format set. Sets or queries ON/OFF of the automatic update function of fixed markers used when updating an active trace. Sets or queries the integration frequency range of the specified integral marker. Detects a peak and places the moving marker on that peak. 5-18 Detects the nearest peak existing on the left side of the current position of the moving marker and places the moving marker on that peak. Detects the highest peak that is below the level of the current position of the moving marker and places the moving marker on that peak. Detects the nearest peak existing on the right side of the current position of the moving marker and places the moving marker on that peak. Detects the peak wavelength and sets it as the measurement center waveform. Sets or queries ON/OFF of the function to automatically detect the peak wavelength and set it as the measurement center wavelength. Detects the peak level and sets it for the reference level. 5-18

Sets or queries ON/OFF of the function to automatically detect the peak level and sets it as the reference level. Detects the peak wavelength and sets it as the display center wavelength. 5-19

Detects the bottom and places the moving marker on that bottom. 5-19 Detects the nearest bottom existing on the left side of the current position of the moving marker and places the moving marker on that bottom. Detects the lowest bottom that is above the level of the current position of the moving marker and places the moving marker on that bottom. Detects the nearest bottom existing on the right side of the current position of the moving marker and places the moving marker on that side. Sets or queries the type of the search function. 5-19 Sets or queries the sort order of the multi search detection list. 5-19 Sets or queries the multi search threshold. 5-19

Sets or queries the normalization bandwidth of the specified power spectral density marker. Sets the wavelength of the current moving marker as the measurement center waveform. Sets the current level of the moving marker for the reference level. 5-20 Specified marker is positioned or deleted in the position of the moving marker. Also, queries the status of the specified marker. Sets the current wavelength of the moving marker for the display center wavelength. Sets or queries the marker type. 5-20 Sets or queries the units of display for the marker values. 5-21 Sets the specified marker at the specified position.Queries the X value of the specified marker. Queries the Y value of the specified marker. 5-21 Sets or queries the TRACE C calculation function. 5-21 Sets or queries parameter K of the TRACE C calculation function. 5-21 Sets or queries the TRACE F calculation function. 5-21 Sets or queries the normalization bandwidth of the power spectral density trace. Sets or queries the TRACE G calculation function. 5-22 Sets or queries the fitting curve function of the TRACE G fitting curve function. Sets or queries a calculation area during curve fit and peak curve fit. 5-22 Sets or queries the threshold value for curve fitting. 5-22 Sets or queries the threshold value for peak curve fitting. 5-22

5-17

5-18

5-19

5-20

5-21

5-22

5-2

IM AQ6380-17EN

Page 36

5.1 List of Commands

Command Function Page

:CALCulate:PARameter[:CATegory] :DFBLd :CALCulate:PARameter[:CATegory] :FILBtm :CALCulate:PARameter[:CATegory] :FILPk :CALCulate:PARameter[:CATegory] :FPLD :CALCulate:PARameter[:CATegory] :ITLa :CALCulate:PARameter[:CATegory] :LED :CALCulate:PARameter[:CATegory] :NF:AALGo :CALCulate:PARameter[:CATegory] :NF:FALGo :CALCulate:PARameter[:CATegory] :NF:FARea :CALCulate:PARameter[:CATegory] :NF:IOFFset :CALCulate:PARameter[:CATegory] :NF:IRANge :CALCulate:PARameter[:CATegory] :NF:MARea :CALCulate:PARameter[:CATegory] :NF:MDIFf :CALCulate:PARameter[:CATegory] :NF:OOFFset :CALCulate:PARameter[:CATegory] :NF:PDISplay :CALCulate:PARameter[:CATegory] :NF:TH :CALCulate:PARameter[:CATegory] :NF:RBWidth :CALCulate:PARameter[:CATegory] :NF:SNOise :CALCulate:PARameter[:CATegory] :NF:SPOWer :CALCulate:PARameter[:CATegory] :NOTCh:K :CALCulate:PARameter[:CATegory] :NOTCh:TH :CALCulate:PARameter[:CATegory] :NOTCh:TYPE :CALCulate:PARameter[:CATegory] :POWer:OFFSet :CALCulate:PARameter[:CATegory] :SMSR:BANDwidth|:BWIDth :CALCulate:PARameter[:CATegory] :SMSR :CALCulate:PARameter[:CATegory] :SMSR:MODE :CALCulate:PARameter[:CATegory] :SMSR:SMPower :CALCulate:PARameter[:CATegory] :SWENvelope:K :CALCulate:PARameter[:CATegory] :SWENvelope:TH1 :CALCulate:PARameter[:CATegory] :SWENvelope:TH2 :CALCulate:PARameter[:CATegory] :SWPKrms:K :CALCulate:PARameter[:CATegory] :SWPKrms:TH

Sets or queries parameters for the DFB-LD analysis function. 5-23

Sets or queries parameters for the FILTER-BTM analysis function. 5-23

Sets or queries parameters for the FILTER PEAK analysis function. 5-24

Sets or queries parameters for the FP-LD analysis function. 5-24

Sets or queries parameters for the ITLA analysis function. 5-25

Sets or queries parameters for the LED analysis function. 5-25

Sets or queries the measurement algorithm applied to ASE level measurements made by the NF analysis function. Sets or queries the fitting function during level measurement applied to ASE level measurements made by the NF analysis function. Sets or queries the fitting range for level measurement applied to ASE level measurements made by the NF analysis function. Sets or queries level offset values (signal light) for the NF analysis function. 5-26

Sets or queries the integration frequency range for when the EDFA-NF analysis feature calculates the signal optical power. Sets or queries the mask range for level measurement applied to ASE level measurements made by the NF analysis function. Sets or queries the peak bottom difference of channel detection for the NF analysis function. Sets or queries level offset values (output light) for the NF analysis function. 5-27

Sets or queries whether to display data used for fitting of the NF analysis function on the waveform screen. Sets or queries the threshold level of channel detection for the NF analysis function. Sets or queries the method for calculating the resolution value of the NF computation. Sets or queries whether Shot Noise is included in the NF computation 5-28

Sets or queries the signal optical power calculation method of the EDFA-NF analysis feature. Sets or queries the magnification of the notch width analysis function. 5-28

Sets or queries the threshold value for the notch width analysis function. 5-28

Sets or queries the analysis direction of the notch width analysis function. 5-28

Sets or queries the offset value for the POWER analysis function. 5-28

Sets or queries the resolution bandwidth used for side mode power normalization of the SMSR analysis function. Sets or queries the mask value for the SMSR analysis function. 5-29

Sets or queries the analysis mode for the SMSR analysis function. 5-29

Sets or queries the side mode power calculation method of the SMSR analysis function. Sets or queries the magnification of the ENVELOPE method–based spectrum width analysis function. Sets or queries the search threshold level of the ENVELOPE method–based spectrum width analysis function. Sets or queries the threshold level of the ENVELOPE method–based spectrum width analysis function. Sets or queries the magnification of the PEAK-RMS method–based spectrum width analysis function. Sets or queries the threshold level of the PEAK-RMS method–based spectrum width analysis function.

5-26

5-27

5-28

5-29

5-30

Commands

IM AQ6380-17EN

5-3

Page 37

5.1 List of Commands

Command Function Page

:CALCulate:PARameter[:CATegory] :SWRMs:K :CALCulate:PARameter[:CATegory] :SWRMs:TH :CALCulate:PARameter[:CATegory] :SWTHresh:K :CALCulate:PARameter[:CATegory] :SWTHresh:MFIT :CALCulate:PARameter[:CATegory] :SWTHresh:TH :CALCulate:PARameter[:CATegory] :WDM:DMASk :CALCulate:PARameter[:CATegory] :WDM:DTYPe :CALCulate:PARameter[:CATegory] :WDM:DUAL :CALCulate:PARameter[:CATegory] :WDM:FALGo :CALCulate:PARameter[:CATegory] :WDM:IRANge :CALCulate:PARameter[:CATegory] :WDM:IRANge:TH :CALCulate:PARameter[:CATegory] :WDM:MARea :CALCulate:PARameter[:CATegory] :WDM:MDIFf :CALCulate:PARameter[:CATegory] :WDM:MMReset :CALCulate:PARameter[:CATegory] :WDM:NALGo :CALCulate:PARameter[:CATegory] :WDM:NARea :CALCulate:PARameter[:CATegory] :WDM:NBW :CALCulate:PARameter[:CATegory] :WDM:ODISplay :CALCulate:PARameter[:CATegory] :WDM:OSLope :CALCulate:PARameter[:CATegory] :WDM:PDISplay :CALCulate:PARameter[:CATegory] :WDM:RCH :CALCulate:PARameter[:CATegory] :WDM:RELation :CALCulate:PARameter[:CATegory] :WDM:SPOWer :CALCulate:PARameter[:CATegory] :WDM:TH :CALCulate:PARameter[:CATegory] :WDMSmsr:DMASk :CALCulate:PARameter[:CATegory] :WDMSmsr:MASK :CALCulate:PARameter[:CATegory] :WDMSmsr:MDIFf :CALCulate:PARameter[:CATegory] :WDMSmsr:MODE :CALCulate:PARameter[:CATegory] :WDMSmsr:SARea :CALCulate:PARameter[:CATegory] :WDMSmsr:TH: :CALCulate:PARameter[:CATegory] :WFBottom :CALCulate:PARameter[:CATegory] :WFPeak

Sets or queries the magnification of the RMS method–based spectrum width analysis function. Sets or queries the threshold level of the RMS method–based spectrum width analysis function. Sets or queries the magnification of the THRESH method–based spectrum width analysis function. Sets or queries whether to enable the mode fit of the THRESH methodbased spectrum width analysis function. Sets or queries the threshold level of the THRESH method–based spectrum width analysis function. Sets or queries the channel mask threshold level for the WDM analysis function. Sets or queries the displayed waveforms of the analysis results for the WDM analysis function. Sets or queries the SNR calculation mode for the WDM analysis function. 5-31

Sets or queries the fitting function during level measurement applied to noise level measurements made by the WDM analysis function. Sets or queries the integral frequency range during signal light power calculation by the WDM analysis function Sets or queries the signal optical power calculation threshold of the WDM analysis function. Sets or queries the mask range during level measurement applied to noise level measurements made by the WDM analysis function. Sets or queries the peak bottom difference of channel detection for the WDM analysis function. Resets the maximum and minimum of the drift values of the WDM analysis function. Sets or queries the measurement algorithm applied to noise level measurements made by the WDM analysis function. Sets or queries the measuring range applied to noise level measurements made by the WDM analysis function. Sets or queries the noise bandwidth for the WDM analysis function. 5-33

Sets or queries whether the OSNR analysis results of the WDM analysis function are shown. Sets or queries whether to enable the function of obtaining the least square approximation line in the WDM analysis function. Sets or queries whether to display data used for fitting of the WDM analysis function on the waveform screen. Sets or queries the reference channel used in calculating the offset wavelength/level of the WDM analysis function. Sets or queries the display format of the wavelength/level relative values for the WDM analysis function. Sets or queries the signal light power calculation method of the WDM analysis function. Sets or queries the threshold level of channel detection for the WDM analysis function. Sets or queries the channel mask threshold of the WDM SMSR analysis function. Sets or queries the threshold of the WDM SMSR analysis function. 5-35

Sets or queries the channel detection peak/bottom difference of the WDM SMSR analysis function. Sets or queries the SMSR analysis mode of the WDM SMSR analysis function. Sets or queries each channel’s SMSR analysis range of the WDM SMSR analysis function. Sets or queries the channel detection threshold of the WDM SMSR analysis function. Sets or queries parameters for the WDM FILTER-BTM analysis function. 5-36

Sets or queries parameters for the WDM FILTER-PEAK analysis function. 5-36

5-30

5-31

5-32

5-33

5-34

5-35

5-4

IM AQ6380-17EN

Page 38

5.1 List of Commands

Command Function Page

:CALCulate:PARameter:COMMon:MDI Ff

Sets or queries the peak-bottom difference parameter of channel detection used in the analysis function.

5-36

CALibration Group

:CALibration:ALIGn[:IMMediate]

:CALibration:ALIGn:INTernal[:IM Mediate] :CALibration:BANDwidth|:BWIDth[ :IMMediate] :CALibration:BANDwidth|:BWIDth: INITialize :CALibration:BANDwidth|:BWIDth: WAVelength? :CALibration:WAVelength:EXTerna l[:IMMediate] :CALibration:WAVelength:EXTerna l:SOURce :CALibration:WAVelength:EXTerna l:WAVelength :CALibration:WAVelength:INTerna l:AUTO :CALibration:WAVelength:INTerna l:AUTO:INTerval :CALibration:WAVelength:INTerna l[:IMMediate] :CALibration:ZERO[:AUTO] :CALibration:ZERO[:AUTO]:INTerv al :CALibration:ZERO[:AUTO]:STAT us?

Executes optical axis adjustment of the monochromator using the internal reference light source. Executes optical axis adjustment of the monochromator using the internal reference light source. Executes an resolution calibration. 5-37

Clears the rms resolution calibration value. 5-37

Queries the wavelength of the light source used to perform resolution calibration. Performs wavelength calibration using an external reference light source. 5-37

Sets or queries the type of the light source used for external reference light source-based wavelength calibration. Sets or queries the wavelength of the light source used for external reference light source-based wavelength calibration. Sets or queries whether wavelength calibration is automatically executed using the internal reference light source. Sets or queries the interval at which wavelength calibration is executed automatically using the internal reference light source. Performs wavelength calibration using an internal reference light source. 5-38

Sets or queries whether to enable the auto offset function of the level. 5-38 Sets or queries the time interval for executing the Auto Offset function for the level. Queries the offset adjustment status. 5-38

5-37

5-38

Commands

DISPlay Group

:DISPlay:COLor :DISPlay[:WINDow] :DISPlay[:WINDow]:OVIew:POSiti on :DISPlay[:WINDow]:TEXT:CLEar :DISPlay[:WINDow]:TEXT:DATA :DISPlay[:WINDow]:TRACe:X[:SCAL e]:CENTer :DISPlay[:WINDow]:TRACe:X[:SCAL e]:INITialize :DISPlay[:WINDow]:TRACe:X[:SCAL e]:SMSCale :DISPlay[:WINDow]:TRACe:X[:SCAL e]:SPAN :DISPlay[:WINDow]:TRACe:X[:SCAL e]:SRANge :DISPlay[:WINDow]:TRACe:X[:SCAL e]:STARt :DISPlay[:WINDow]:TRACe:X[:SCAL e]:STOP :DISPlay[:WINDow]:TRACe:Y:NMASk

:DISPlay[:WINDow]:TRACe:Y:NMASk :TYPE :DISPlay[:WINDow]:TRACe:Y[:SCAL e]:DNUMber :DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:BLEVel

Sets or queries the screen color mode. 5-39 Sets or queries whether the display is enabled. 5-39 Sets or queries the ON/OFF and position of the OVERVIEW display shown during zoom operation. Clears labels. 5-39 Sets or queries the labels. 5-39 Sets or queries the center wavelength of the X-axis of the display scale. 5-39

Initializes the X-axis parameters of the display scale. 5-39

Sets parameters of the current display scale to the measurement scale. 5-40

Sets or queries the span of the X-axis of the display scale. 5-40

Sets or queries whether to limit an analytical range to the display scale range. Sets or queries the start wavelength of the X-axis of the display scale. 5-40

Sets or queries the stop wavelength of the X-axis of the display scale. 5-40

Sets whether to mask the display of waveforms the level of which is at or below a set threshold level or queries the condition of whether the relevant waveform display is masked. Sets or queries the display method when a waveform display at or below a threshold level is masked. Sets or queries the number of display divisions of the level axis. 5-41

Sets or queries the base level applied when the main scale of the level axis is linear.

5-39

5-40

5-41

IM AQ6380-17EN

5-5

Page 39

5.1 List of Commands

Command Function Page

:DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:PDIVision :DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:RLEVel :DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:RPOSition :DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:SPACing :DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:UNIT :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:AUTO :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:LENGth :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:OLEVel :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:PDIVision :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:RPOSition :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:SMINimum :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:UNIT :DISPlay[:WINDow]:TRACe:Y1[:SCA Le]:INITialize :DISPlay[:WINDow]:TRACe:Y2[:SCA Le]:INITialize

Sets or queries the main scale of the level axis. 5-41

Sets or queries the reference level of the main scale of the level axis. 5-41

Sets or queries the position of the reference level of the main scale of the level axis. Sets or queries the scale mode of the main scale of the level axis. 5-41

Sets or queries the units of the main scale of the level axis. 5-42

Sets or queries the automatic setting function of the sub scale of the level axis. Sets or queries the parameter of the optical fiber length used when the unit of the subscale of the level axis is dB/km. Sets or queries the offset level of the sub scale of the level axis. 5-42

Sets or queries the sub scale of the level axis. 5-42

Sets or queries the position of the reference level of the sub scale of the level axis. Sets or queries the value of the bottom of the scale applied when the subscale of the level axis is set to the linear or % mode. Sets or queries the units of the sub scale of the level axis. 5-43

Initializes the display zoom condition of the main level scale. 5-43

Initializes the display zoom condition of the sub level scale. 5-43

FORMat Group

:FORMat[:DATA]

Sets or queries the format used for data transfer. 5-44

INITiate Group

:INITiate[:IMMediate] :INITiate:SMODe

Makes a sweep. 5-45 Sets or queries the sweep mode. 5-45

MMEMory Group

:MMEMory:ANAMe :MMEMory:CATalog? :MMEMory:CDRive :MMEMory:COPY :MMEMory:DATA? :MMEMory:DELete :MMEMory:LOAD:ATRace :MMEMory:LOAD:DLOGging :MMEMory:LOAD:PROGram :MMEMory:LOAD:SETTing :MMEMory:LOAD:TRACe :MMEMory:MDIRectory :MMEMory:REMove :MMEMory:REName :MMEMory:STORe:ARESult :MMEMory:STORe:ATRace :MMEMory:STORe:ATRace:TYPE :MMEMory:STORe:DATA :MMEMory:STORe:DATA:ITEM :MMEMory:STORe:DATA:MODE

:MMEMory:STORe:DLOGging :MMEMory:STORe:DLOGging:CSAVe

Sets or queries the naming rule for automatic file names. 5-46 Queries a list of all files in the current directory. 5-46 Sets or queries the current drive. 5-46 Copies a specified file. 5-46 Queries the data in the specified file. 5-46 Deletes a specified file. 5-47 Loads the specified waveform files (all traces) into traces. 5-47 Loads the specified data logging file. 5-47 Loads a specified program file into a specified program number. 5-47 Loads a specified setting file. 5-47 Loads a specified waveform file into a specified trace. 5-47 Creates a new directory. 5-47 Readies the USB storage media for removal or queries the readiness status. 5-47 Renames a specified file. 5-47 Stores a variety of analysis results to a specified file. 5-47 Stores the specified waveform files (all traces) into traces. 5-48 Sets or queries the file type for saving all trace waveform data. 5-48 Stores a variety of data to a specified file. 5-48 Sets or queries an item to be used when storing data. 5-48 Sets whether to insert data into or overwrite an existing file with the data when storing it or queries the condition of whether data is inserted or overwritten. Saves the data logging results to a specified file. 5-48 Sets or queries whether data logging results will be saved to a file in CSV format.

5-41

5-42

5-43

5-48

5-6

IM AQ6380-17EN

Page 40

5.1 List of Commands

Command Function Page

:MMEMory:STORe:DLOGging:TSAVe

:MMEMory:STORe:GRAPhics :MMEMory:STORe:PROGram :MMEMory:STORe:SETTing :MMEMory:STORe:TRACe

Sets or queries whether temporary saved waveform files will be saved when data logging results is saved. Stores a waveform screen to a specified graphic file. 5-49 Stores a specified program to a specified file. 5-49 Stores setting information to a specified file. 5-49 Stores a specified trace to a specified waveform file. 5-49

5-48

SENSe Group

:SENSe:AVERage:COUNt :SENSe:BANDwidth|:BWIDth[:RESol ution] :SENSe:BANDwidth|:BWIDth[:RESol ution]:CUSTom[:STATe] :SENSe:CHOPper :SENSe:CORRection:LEVel:SHIFt :SENSe:CORRection:RVELocity:MED ium :SENSe:CORRection:WAVelength:SH IFt :SENSe:SENSe :SENSe:SENSe:LEVel

:SENSe:SETTing:SMOothing :SENSe:SWEep:POINts :SENSe:SWEep:POINts:AUTO

:SENSe:SWEep:SPEed :SENSe:SWEep:STEP :SENSe:SWEep:TIME:0NM

:SENSe:SWEep:TIME:INTerval

:SENSe:WAVelength:CENTer :SENSe:WAVelength:SPAN :SENSe:WAVelength:SRANge

:SENSe:WAVelength:STARt :SENSe:WAVelength:STOP

Sets or queries the number of times averaging for each measured point. 5-50 Sets or queries the measurment resolution. 5-50

Sets or queries the on/off status of the custom resolution function. 5-50

Sets or queries chopper mode. 5-50 Sets or queries the offset value for the level. 5-50 Sets or queries whether air or vacuum is used as the wavelength reference. 5-50

Sets or queries the offset value for the levelwavelength. 5-51

Sets or queries the measurement sensitivity. 5-51 Sets or queries the sensitivity based on the sensitivity level you want to measure at. Sets or queries the Smoothing function. 5-51 Sets or queries the number of samples measured. 5-51 Sets or queries the function of automatically setting the sampling number to be measured. Sets or queries the sweep speed. 5-52 Sets or queries the sampling interval for measurements. 5-52 Sets or queries the time taken from the start to the end of measurements when measurement is made in the 0-nm sweep mode. Sets or queries the time taken from the start of a sweep to that of the next sweep when repeat sweeps are made. Sets or queries the measurement condition center wavelength. 5-52 Sets or queries the measurement condition measurement span. 5-52 Sets or queries whether to limit a sweep range to the spacing between line markers L1 and L2. Sets or queries the measurement condition measurement start wavelength. 5-53 Sets or queries the measurement condition measurement stop wavelength. 5-53

5-51

5-52

5-53

Commands

STATus Group

:STATus:OPERation:CONDition? :STATus:OPERation:ENABle :STATus:OPERation[:EVENt]? :STATus:PRESet :STATus:QUEStionable:CONDition? :STATus:QUEStionable:ENABle

:STATus:QUEStionable[:EVENt]?

Queries the contents of the operation status condition register. 5-54 Queries the contents of the operation status Enable register. 5-54 Queries the contents of the operation status Event register. 5-54 Clears the event register and sets all bits of the enable register. 5-54 Queries the contents of the qestionable status condition register. 5-54 Reads the contents of the questionable status enable register or writes data to this register. Reads the contents of the questionable status event register. 5-54

5-54

SYStem Group

:SYSTem:BUZZer:CLICk :SYSTem:BUZZer:WARNing :SYSTem:COMMunicate:CFORmat :SYSTem:COMMunicate:LOCKout :SYSTem:COMMunicate:RMONitor :SYSTem:DATE :SYSTem:DISPlay:UNCal :SYSTem:ERRor[:NEXT]? :SYSTem:GRID :SYSTem:GRID:CUSTom:SPACing :SYSTem:GRID:CUSTom:STARt :SYSTem:GRID:CUSTom:STOP

Sets or queries whether to sound the buzzer when clicked the key. 5-55 Sets or queries whether to sound the buzzer during an alarm. 5-55 Sets or queries the command format of this unit. 5-55 Sets/cancels local lockout. 5-56 Sets or queries whether the remote monitor function is enabled. 5-56 Sets or queries the system data. 5-56 Sets or queries whether to display an alarm message in the event of UNCAL. 5-56 Queries data in an error queue and deletes it from the queue. 5-56 Sets or queries the instrument’s grid setting. 5-56 Sets or queries the grid spacing of the custom grid. 5-56 Sets or queries the custom grid start wavelength. 5-56 Sets or queries the custom grid stop wavelength. 5-57

IM AQ6380-17EN

5-7

Page 41

5.1 List of Commands

Command Function Page

:SYSTem:GRID:REFerence :SYSTem:INFormation? :SYSTem:OLOCk :SYSTem:PRESet :SYSTem:TIME :SYSTem:VERSion?

Sets or queries the reference frequency of the instrument’s grid setting. 5-57 Queries model-specific information (the model code and special code) 5-57 Sets or queries whether keys are locked. 5-57 Initializes the unit status. 5-57 Sets or queries the system time. 5-57 Queries the SCPI compatibility version of this unit. 5-57

TRACe Group

:TRACe:ACTive :TRACe:ATTRibute[:<trace name>] :TRACe:ATTRibute:RAVG[:<trace name>] :TRACe:COPY :TRACe[:DATA]:SNUMber? :TRACe[:DATA]:X? :TRACe[:DATA]:Y? :TRACe[:DATA]:Y:PDENsity? :TRACe:DELete :TRACe:DELete:ALL :TRACe:STATe[:<trace name>]

Sets or queries the active trace. 5-58 Sets or queries the attributes of the specified trace. 5-58 Sets or queries the number of times for averaging of the specified trace. 5-58

Copies the data of a specified trace to another trace. 5-58 Sets or queries the number of number of data sampled of the specified trace. 5-58 Queries the wavelength axis data of the specified trace. 5-59 Queries the level axis data of specified trace. 5-59 Queries the power spectral density trace data. 5-60 Deletes the data of a specified trace. 5-60 Clears the data for all traces. 5-60 Sets or queries the display status of the specified trace. 5-60

TRIGger Group

:TRIGger[:SEQuence]:DELay :TRIGger[:SEQuence]:GATE:ITIMe :TRIGger[:SEQuence]:GATE:LOGic :TRIGger[:SEQuence]:GATE:MDELay :TRIGger[:SEQuence]:SLOPe :TRIGger[:SEQuence]:STATe :TRIGger[:SEQuence]:INPut :TRIGger[:SEQuence]:OUTPut :TRIGger[:SEQuence]:PHOLd:HTIMe

Sets or queries the trigger delay. 5-61 Sets or queries sampling interval for gate sampling. 5-61 Sets or queries the gate signal logic of gate sampling. 5-61 Sets or queries the measure delay of gate sampling. 5-61 Sets or queries the trigger edge. 5-61 Sets or queries the external trigger mode. 5-61 Sets or queries the signal of the input trigger. 5-61 Sets or queries the signal of the output trigger. 5-62 Sets or queries the hold time of peak hold mode. 5-62

UNIT Group

:UNIT:POWer:DIGit :UNIT:X

Sets or queries the number of decimal places displayed for the level value. 5-63 Sets or queries the units for the X axis. 5-63

Common Commands Group

*CLS(Clear Status)

*ESE(Standard Event Status Enable) *ESR?(Standard Event Status Register) *IDN? (Identification) *OPC(Operation Complete)

*RST (Reset)

*SRE(Service Request Enable) *STB?(Read Status Byte) *TRG(Trigger)

*TST?(Self Test) *WAI(Wait to Continue)

Clears all event status registers, the summary of which is reflected in the status byte register. Sets or queries the standard event enable register. 5-65

Queries the standard event status register and simultaneously clears it. 5-65

Queries the instrument type and firmware version. 5-65 Sets or queries bit 0 (OPC) of the standard event status register (ESR) if operations waiting to be processed have all been completed. Executes a device reset to return the instrument to the known (default) status. Sets or queries the service request enable register. 5-66 Queries the current value of the status byte register. 5-66 Performs a <SINGLE> sweep under the sweep conditions established immediately before receiving the command. Performs the instrument’s self-test and queries the status. 5-66 Prevents the instrument from executing another command until the execution of the current command is complete.

5-65

5-66

5-8

IM AQ6380-17EN

Page 42

5.1 ABORt Group

:ABORt

Function Stops operations such as measurements and

calibration.

:ABORt

Syntax Example Description • Operations to be stopped are as follows: :APPLication:DLOGging:STATe :APPLication:PROGram:EXECute :CALibration:ALIGn[:IMMediate] :CALibration:ALIGn:INTernal[:IMMediate] :CALibration:BANDwidth|BWIDth[:IMMediate] :CALibration:WAVelength:EXTernal

:CALibration:WAVelength:INTernal[:IMMediate] *TRG :INITiate

• This is an overlapping command.

:ABORT

[:IMMediate]

Commands

IM AQ6380-17EN

5-9

Page 43

5.2 APPLication Group

:APPLication:DLOGging:ETIMe?

Function Queries the elapsed time of data logging (in

seconds).

:APPLication:DLOGging:ETIMe?

Syntax Response <integer> <integer> = Elapsed time [sec] Example Description • This is an overlap command.

• This command is invalid when data logging is

:APPLICATIO N:DLOGGING:ETIME? -> 10220

paused.

:APPLication:DLOGging:LPARa m eter:INTe rval

Function Sets or queries the measurement interval of data

logging.

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

INTerval<wsp><integer>[SEC]

:APPL ic ation:DLO G g ing:LPA R a meter:

IN T e r v a l?

<integer> = Measurement interval [sec]

(0 = SWEEP TIME)

Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

INTERVAL 10

INTERVAL? -> 10

in progress.

:APPLication:DLOGging:LPARa m eter:ITEM

Function Sets or queries the data logging source.

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

IT E M < w s p > 0|1|2|3

:APPL ic ation:DLO G g ing:LPA R a meter:

ITEM?

0|1|2|3: Data logging source 0 = WDM, 1 = PEAK, 2 = MULTI-PEAK,

3 = DFB-LD

Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

ITEM 0

ITEM? -> 0

in progress.

:APPLication:DLOGging:LPARa m eter:LMO De

Function Sets or queries the data logging mode (maximum

channel mode or maximum logging mode).

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

L M O D e < w s p >1|2

:APPL ic ation:DLO G g ing:LPA R a meter:

LMOD e?

1|2: Mode 1 = Maximum channel mode (MODE1: MAX

1024ch, 2001 entries)

2 = Maximum logging mode (MODE2: MAX

256ch, 10001 entries)

Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

LMODE 1

LMODE -> 1

in progress.

:APPLication:DLOGging:LPARa m eter:MEM o ry

Function Sets or queries the temporary area for saving

waveform files of data logging.

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

MEMory<wsp>INTernal|EXTernal

:APPL ic ation:DLO G g ing:LPA R a meter:

MEMory?

INTernal = Internal memory EXTernal = USB storage media Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

MEMORY INTERNAL

MEMORY? -> INT

in progress.

5-10

IM AQ6380-17EN

Page 44

5.2 APPLication Group

:APPLication:DLOGging:LPARa m eter:MTHR esh

Function Sets or queries the threshold of the channel-

matching wavelength λ for data logging.

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

MTHResh<wsp><NRf>[M]

:APPL ic ation:DLO G g ing:LPA R a meter:

MT HResh?

<NRf>[M] = Threshold of wavelength λ [m]

Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

M T H R e s h 0.1n m

MTHResh? -> +1.00000000E-010

in progress.

:APPLication:DLOGging:LPARa m eter:PDET ect:ATHResh

Function Sets or queries the threshold (absolute value) for

detecting the data logging mode.

:APPL ic ation:DLO G g ing:LPA R a meter:PD ET

Syntax

ect:ATHResh<NRf>[DBM]

:APPL ic ation:DLO G g ing:LPA R a meter:PD ET

ec t:A THRes h?

<NRf>[DBM] = Peak detection threshold (absolute

value) [dBm]

Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

PD E T EC T:A T H R E SH -20.0d b m

PDETECT:ATHRESH? -> -2.00000000E+001

in progress.

:APPLication:DLOGging:LPARa m eter:PDET ec t:TT Y P e

Function Sets or queries how the threshold for detecting

the data logging mode (peak or bottom) is specified.

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

PDETect:TTYPe<wsp>ABSolute|RELative

:APPL ic ation:DLO G g ing:LPA R a meter:

PD ETe c t:T T Y Pe?

ABSolute = Absolute value RELative = Relative value Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

PD ETEC T:T TYPE A BS OLU T E

PD ETEC T:T TYPE? -> A BS

in progress.

:APPLication:DLOGging:LPARa m eter:TDUR atio n

Function Sets or queries the measurement duration of data

logging (in seconds).

:APPL ic ation:DLO G g ing:LPA R a meter:

Syntax

TDURation<wsp><integer>[sec]

:APPL ic ation:DLO G g ing:LPA R a meter:

TDURat io n?

<integer> = Measurement duration [sec] Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

TDURation 3600

TDURation? -> 3600

in progress.

Commands

:APPLication:DLOGging:LPARa m eter:PDET ect:RTHResh

Function Sets or queries the threshold (relative value) for

detecting the data logging mode.

:APPL ic ation:DLO G g ing:LPA R a meter:PD ET

Syntax

ect:RTHResh<NRf>[DB]

:APPL ic ation:DLO G g ing:LPA R a meter:PD ET

ec t:R THRe sh?

<NRf>[DB] = Peak detection threshold (relative

value) [dB]

Example

:APPLICATION:DLOGGING:LPARA METER:

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARA METER:

PD E T EC T:R T H R ESH 30.0 d b

PDETECT:RTHRESH? -> +3.00000000E+001

in progress.

:APPLication:DLOGging:LPARa m eter:TLOG ging

Function Sets or queries whether waveforms will be logged

during data logging.

:APPL ic ation:DLO G g ing:LPA R a meter:TLOG

Syntax

gi n g < w s p> OFF|O N|0|1

:APPL ic ation:DLO G g ing:LPA R a meter:TLOG

ging?

OFF = Waveform data save function off ON = Waveform data save function on Example

:APPLICATION:DLOGGING:LPARAMETER:TLOG

Description • This command is invalid when data logging is

• This is a sequential command.

:APPLICATION:DLOGGING:LPARAMETER:TLOG

GING OFF

GING? -> 0

in progress.

IM AQ6380-17EN

5-11

Page 45

5.2 APPLication Group

:APPLication:DLOGging:STATe

Function Starts, stops, or queries data logging.

:APPLication:DLOGging:STATe<wsp>STOP|

Syntax

ST A Rt|0|1

:APPLication:DLOGging:STATe?

START = Starts data logging STOP = Stops data logging Response 0 = Stopped, 1 = Running Example

:A PPLICA TION:DLOGGI NG:STATE? -> 1

Description • Only the following commands are valid when

• Common commands (excluding *TRG and

• All query commands

• ABORt

• This is an overlappable command.

:APPLICATION:DLOGGING:STATE 1

data logging is in progress.

*TST)

:APPLication:PROGram:EXECute

Function Executes a program that has been specified.

:APPLication:PROGram:

Syntax

EXECute<wsp><integer>

<integer> = Number of a program to execute Example Explanation This is an overlapable command.

:APPLICATION:PROGRAM:EXECUTE 1

5-12

IM AQ6380-17EN

Page 46

5.3 CALCulate Group

Commands about the following functions are summarized in this sub system.

• Analysis function (Spectrum Width, ANALYSIS1 , ANALYSIS2)

• Peak/Bottom search function

• Marker function (Δ marker, line marker)

• Calculation function of trace

• Advanced marker function (moving marker, power spectral density marker, integrated power marker)

The following procedure is performed in order to carry out remote control of the Analysis function.

Select the analysis algorithm (:CALCulate:CATegory command)

Set the Analysis Parameter (:CALCulate:PARameter command)

Execute the analysis function (:CALCulate[:IMMediate] command)

Get the analysis results (:CALCulate:DATA? command)

The following command is used in order to carry out remote control of the Peak/Bottom search function. :CALCulate:MARKer:MAXimum|MINimum command

The following command is used to in order to carry out remote control of the Marker function.

Δ marker :CALCulate:MARKer command

Line marker :CALCulate:LMARker command

Commands

The following command is used to in order to carry out remote control of the trace Calculation function. :CALCulate:MATH command

:CALCulate:ARESolution?

Function Queries the actual resolution data of the specified

trace.

:CALCulate:ARESolution?<wsp>

Syntax

<trace name>,[<start point>,

<s t o p point>]

<trace name> = Target trace

(TRA|TRB|TRC|TRD|TRE|TRF|TRG)

<start point> = Sample range to transfer (start

point) (1 to 200001)

<stop point> = Sample range to transfer (stop

point) (1 to 200001)

Example

-> +1.89 75914 5E-009,+1.89 74476 2 E -009,

Description • The function outputs a wavelength value.

• If the <start point> and <stop point>

• The data is output in ASCII or BINARY format

• This is a sequential command.

CALCULATE:ARESOLUTION? TRA

+1.8973 03 4 6 E- 0 0 9,....

parameters are omitted, the entire sample data of the specified trace will be output.

according to the :FORMat[:DATA] setting.

IM AQ6380-17EN

5-13

Page 47

5.3 CALCulate Group

:CA LC u lat e:C A T e g o r y

Function Sets or queries the type of analysis.

:CA L C u lat e:CATe g or y <wsp>{SWTH r esh|

Syntax

3|4|5|6|7|8|9|11|12|13|14|1 5|16|18|19}

:CA L C u lat e:CATe g or y ?

SWTHresh|0 Spectrum width analysis

(THRESH)

SWENvelope|1 Spectrum width analysis

(ENVELOPE) SWRMs|2 Spectrum width analysis (RMS) SWPKrms|3 Spectrum width analysis

:C A L C UL ATE:C ATe g ory? -> 0

Description • Even when this command is executed,

• This is a sequential command.

:CALC U L ATE:CA Tegor y SWT H r esh

no analysis is performed unless the :CALCulate[:IMMediate] command is executed.

:CALCulate:DATA?

Function Queries the analysis results.

:CALCulate:DATA?

Syntax Example Description • Queries the analysis results from the last time

• If the analysis function has not been executed,

• For a response example, see chapter

• This is a sequential command.

:CALCULATE:DATA?

analysis was executed.

a query error occurs.

appendix 3.

:CALCulate:DATA:CGAin?

Function Queries the gain value of the EDFA-NF analysis

results.

:CA L C u lat e:DATA:CGAin?

Syntax Example

-> +1.00000000E+001,+1.00000000E+001

Description • If the analysis function has not been executed,

• “0” is returned if there is no relevant return

• The number of channels to be output can be

• Data is output in either ASCII or binary form,

• This is a sequential command.

:CA L C U L ATE:DATA:CG A i n?

a query error occurs.

value (such as if the analysis executed was not EDFA-NF analysis)

acquired by the :CALCulate:DATA: NCHannels? command.

depending on the setting of :FORMat[: DATA].

:CA LC u lat e:DATA:C N F?

Function Queries the NF value of the EDFA-NF analysis

results.

:CALCulate:DATA:CNF?

Syntax Example

+1.00000000E+001,+1.00000000E+001

Description • If :CALCulate[:IMMediate] has not been

• “0” is returned if there is no relevant return

• The number of channels to be output can be

• Data is output in either ASCII or binary form,

• This is a sequential command.

:CALC U L ATE:DATA:CNF ? ->

executed, a query error occurs.

value (such as if the analysis executed was not EDFA-NF analysis)

acquired by the :CALCulate:DATA: NCHannels? command.

depending on the setting of :FORMat[: DATA].

5-14

IM AQ6380-17EN

Page 48

5.3 CALCulate Group

:CALCulate:DATA:CPOWers?

Function Queries the level value of the OSNR(WDM),

WDM, EDFA-NF, WDM FIL-PK, or WDM FIL-BTM analysis results.

:CA L C u lat e:DATA:CPOW e rs?

Syntax Example

+1.00000000E+001,+1.00000000E+001

Description • If the analysis function has not been executed,

• “0” is returned if there is no relevant return

• The number of channels to be output can be

• The value to be output depends on the analysis

OSNR(WDM): LEVEL or MEAS LEVEL EDFA-NF: INPUT LEVEL WDM FIL-PK: PEAK LEVEL

WDM FIL-BTM: PEAK LEVEL

• Data is output in either ASCII or binary form,

• This is a sequential command.

:CALCULATE:DATA:CPOWERS? ->

a query error occurs.

value.

acquired by the :CALCulate:DATA: NCHannels? command.

performed.

(output even if SW is OFF)

depending on the setting of :FORMat[:DATA].

:CA LC u lat e:DATA:C WAVe l e ng t h s?

Function Queries the wavelength value of the

OSNR(WDM), WDM, EDFA-NF, WDM FIL-PK, or WDM FIL-BTM analysis results.

:CALCulate:DATA:CWAVelengths?

Syntax Example

Description • If the analysis function has not been executed,

• “0” is returned if there is no relevant return

• The number of channels to be output can be

• The value to be output depends on the analysis

OSNR(WDM) : WAVELENGTH or MEAS WL WDM : WAVELENGTH or MEAS WL EDFA-NF: WAVELENGTH WDM FIL-PK: NOMINAL WAVELENGTH WDM FIL-BTM: NOMINAL

• Data is output in either ASCII or binary form,

• This is a sequential command.

:CALCULATE:DATA:CWAVELENGTHS? ->

+1.55000000E-006,+1.56000000E-006

a query error occurs.

value.

acquired by the :CALCulate:DATA:NCHannels? command.

performed.

WAVELENGTH

depending on the setting of :FORMat[:DATA].

Commands

:CA LC u lat e:DATA:C S N R?

Function Queries the SNR value from the last time WDM

analysis was executed.

:CA L C u lat e:DATA:CSN R?

Syntax Example

Description • If the analysis function has not been executed,

• “0” is returned if there is no relevant return

• The number of channels to be output can be

• Data is output in either ASCII or binary form,

• This is a sequential command.

:CALCULATE:DATA:CSNR? ->

+4.00000000E+001,+4.00000000E+001

a query error occurs.

value (for example, if analysis made is other than WDM analysis).

acquired by the :CALCulate:DATA: NCHannels? command.

depending on the setting of :FORMat[: DATA].

:CA LCu l at e:DA T A:DF BL d?

Function Queries the DFB-LD analysis results.

:CALCu lat e:D A TA:DF BLd?

Syntax Example Description • If the :CALCulate[:IMMediate] command has

• “0” is returned if there is no relevant return

(for example, if the analysis that was executed

• This command returns analysis results that

<peak wl>,<peak lvl>,<center wl>,<spec

• This is a sequential command.

:CALCULATE:DATA:DFBLD? ->

not been executed, a query error occurs.

value

was not a DFB-LD analysis).

are not returned from the “:CALCulate:DATA?” command, such as the OSNR value. The following items are returned. The items are listed here as abbreviations. For the meaning of these abbreviations, see chapter appendix 3.

wd>,<smsr(L)>,<smsr(R)>,<mode ofst(L)>,<mode ofst(R)>,<snr>,<power>,<rms> ,<Krms>

IM AQ6380-17EN

5-15

Page 49

5.3 CALCulate Group

:CALCulate:DATA:NCHannels?

Function Queries the number of channels of the

OSNR(WDM), WDM, EDFA-NF, WDM FIL-PK, WDM FIL-BTM, or WDM SMSR analysis results.

:CALCulate:DATA:NCHannels?

Syntax Example Description • If the analysis function has not been executed,

• “0” is returned if there is no relevant return

• The value is output as ASCII data, regardless

• This is a sequential command.

:CALCULATE:DATA:NCHANNELS? -> 16

a query error occurs.

value.

of the setting of FORMat[:DATA].

:CA LCu l at e:DA T A:OSL o p e?

Function Queries the OUTPUT SLOPE value of the OSNR

(WDM) and WDM analysis results.

:CALCulate:DATA:OSLope?

Syntax Response <NRf> = Output slope value [dB/nm]

or [dB/THz]

Example

Description • A query error will occur if the analysis function

• “0” is returned if there is no relevant return

• Analysis results can be queried even if the

• ASCII data is returned regardless of the setting

• This is a sequential command.

:CALCULATE:DATA:OSLOPE? ->

+2.4 5 3 526 2 3 E - 0 01

is not implemented.

value (for example, if the analysis that was executed was not a WDM analysis).

output of the OUTPUT SLOPE value is set to OFF.

specified by the :FORMat:[DATA] command.

:CALCulate:DISPlay

Function Sets or queries the display format of analysis

results.

:C A L C u l at e:DISPl ay < w s p > 0|1|2|3|4

Syntax

:CALCulate:DISPlay?

0: TRACE&TABLE 1: TABLE 2: TRACE 3: GRAPH&TABLE 4: GRAPH Example

:CALCULATE:DISPLAY? -> 1

Description This is a sequential command.

:CALCULATE:DISPLAY 1

:CA L C u lat e:DISPlay:GR APh:LM A R Ker:Y

Function Sets or queries the position of line marker Y1 or

Y2 on the graph display of analysis results.

:CA L C u lat e:DISPlay:G R A P h:L M ARker:Y

Syntax

<w s p>1|2,<N R f >[DB]

:CA L C u lat e:DISPlay:G R A P h:L M ARker:Y?

<w s p>1|2

1: Line marker Y1. 2: Line marker Y2. <NRf>: Line marker position Example

:CALCULATE:DISPLAY:GRAPH:LMARKER:Y? 1

Description • This command is valid when the EDFA-NF

• This is a sequential command.

:CALCULATE:DISPLAY:GRAPH:LMARKER:

Y 1,3.4

-> +3.40000000E+000

analysis results are being displayed on a graph.

:CALCulate[:IMMe d iate]

Function Executes analysis. Queries the result of whether

analysis has been performed.

:CA L C u l ate[:IM M e d i ate]

Syntax

:CA L C u l ate[:IM M e d i ate]?

0: Not performed 1: Performed Example

:CALCULATE? -> 1

Description • Analysis is performed according to the latest

• Analysis is performed on the following

• When :CALCulate[:IMMediate] command is

• When :CALCulatePARameter: command is

• This is a sequential command.

:CA L C U L ATE

analysis settings.

occasions:

executed.

executed, or parameter settings changed

:CALCulate[:IMMe d iate]:AUTO

Function Sets or queries the automatic analysis function.

:CA L C u l ate[:IM M e d i ate]:AU T O <wsp>

Syntax

OF F|O N|0|1

:CA L C u l ate[:IM M e d i ate]:AU T O?

0: OFF 1: ON Example

:CALCULATE AUTO? -> 1

Description • When the automatic analysis function is ON,

• This is a sequential command.

:CA LCUL ATE:AUTO O N

automatically activates an analysis function that is active after a sweep has ended.

5-16

:CALCulate:LMARker:AOFF

Function Clears all line markers.

:CALCulate:LMA Rker:AOFFExample

Syntax

:CALCULATE:LMARKER:AOFF

Description This is a sequential command.

IM AQ6380-17EN

Page 50

5.3 CALCulate Group

:CALCulate:LMARker:SRANge

Function Sets or queries whether to limit an analytical

range to the spacing between line markers L1 and L2.

:CALCulate:LMARker:SRANge<wsp>OFF|

Syntax

ON|0|1

:CALCulate:LMARker:SRANge?

0: OFF 1: ON Example

:CALCULATE:LMARKER:SRANGE? -> 1

Description This is a sequential command.

:CALCULATE:LMARKER:SRANGE ON

:CALCulate:LMARker:SSPan

Function Sets spacing between line markers L1 and L2 for

span.

:CALCulate:LMARker:SSPan

Syntax Example Description This is a sequential command.

:CALCULATE:LMARKER:SSPAN

:CALCulate:MARKer:AOFF

Function Clears all markers.

:CALCulate:MARKer:AOFF

Syntax Example Description This is a sequential command.

:CALCULATE:MARKER:AOFF

:CALCulate:MARKer:AUTO

Function Sets or queries the auto search function.

:CALCulate:MARKer:AUTO<wsp>

Syntax

OF F|O N|0|1

:CALCulate:MARKer:AUTO?

0 = OFF 1 = ON Example

:CALCULATE:M A R K ER:AUTO? -> 1

Description • When the auto search function is ON, this

• This is a sequential command.

:CA LCULATE:MAR K ER:AU TO ON

instrument automatically performs a peak/ bottom search through an active trace after a sweep has ended.

Commands

:CALCulate:LMARker:SZSPan

Function Sets spacing between line markers L1 and L2 for

zoom span.

:CALCulate:LMARker:SZSPan

Syntax Example Description This is a sequential command.

:CALCULATE:LMARKER:SZSPAN

:CALCulate:LMARker:X

Function Sets or queries the position of line markers L1

and L2.

:CALCulate:LMARker:X<wsp>1|2,<NRf>

Syntax

[M|HZ]

:CALCulate:LMARker:X?<wsp>1|2

1, 2 = Line marker numbers <NRf> = Position of a line marker Response <NRf> [m|Hz] Example

:CALCULATE:LMARKER:X? 1 ->

Description • If the specified line marker is not located, a

• This is a sequential command.

:CALCULATE:LMARKER:X 1,1550.000nm

+1.55000000E-006

query error occurs.

:CALCulate:LMARker:Y

Function Sets or queries the position of line markers L3

and L4.

:CALCulate:LMARker:Y<wsp>3|4,<NRf>

Syntax

[DBM|DB|%]

:CALCulate:LMARker:Y?<wsp>3|4

3, 4 = Line marker numbers <NRf> = Position of a line marker Example

:CALCULATE:LMARKER:Y? 3 ->

Description • If the specified line marker is not located, a

• This is a sequential command.

:CALCULATE:LMARKER:Y 3,-10dBm

-1.00000000E+001

query error occurs.

:C A L Cu lat e:M A R K e r:F U N Ct i o n:F OR M at

Function Sets the format of a difference value displayed in

the area marker and queries the format set.

:CALCu lat e:M A RKer:FU N Ctio n:FOR M at<ws

Syntax

p>OFFS et|SPA C i ng|0|1

:CALCu lat e:M A RKer:FU N Ctio n:FOR M at?

OFFSet = Displays the difference of each marker

relative to the moving marker.

SPACing = Displays the difference of each

marker relative to a neighboring

marker. Response 0 = OFFSet, 1 = SPACing Example

:CALCUL ATE:M AR K E R:FU N CTION:FOR M A T?

Description This is a sequential command.

:CALCULATE:MARKER:FUNCTION:

FORMAT SPACING

-> 1

:CALCulate:M ARKer:FUNCtion:UPDate

Function Sets or queries ON/OFF of the automatic update

function of fixed markers used when updating an active trace.

:CALCulate:MARKer:FUNCtion:UPDate<ws

Syntax

p>OFF|O N|0|1

:CALCulate:MARKer:FUNCtion:UPDate?

Response 0 = OFF, 1 = ON Example

:CALC ULATE:MA R K ER:FU NCTION:UPDATE?

Description • When the automatic update function is ON and

• This is a sequential command.

:CALCULATE:MARKER:FUNCTION:

UPDATE ON

-> 1

the active trace is updated, the level positions of fixed markers automatically follow the waveform.

IM AQ6380-17EN

5-17

Page 51

5.3 CALCulate Group

:CALCulate:MARKer:IRANge

Function Sets or queries the integration frequency range of

the specified integral marker.

:CALCulate:MARKer:IRANge<wsp>

Syntax

< m a rk e r>,< N R f >[ H Z]

:CALCulate:MARKer:IRANge?<wsp>

<marker> = Marker number <NRf> = Integral range in Hz. The setting is valid only when the type is

set to Integral.

Example

:CALCULATE:MARKER:IRANGE? 1 ->

Description • This command is valid only when the specified

To specify an integral marker, use the

An error will occur if the specified marker is not

• This is a sequential command.

:CALCULATE:MARKER:IRANGE 1,40GHZ

+4.00000000E+013

marker is an integral marker.

CALC:MARK:TYPE or :CALC:MARK command.

an integral marker.

:CALCulat e:MA R Ker:M A Xim u m

Function Detects a peak and places the moving marker on

that peak.

:CALC ulate:M A R Ke r:M A Ximum

Syntax Example Description This is a sequential command.

:CALC ULATE:MAR K E R:M A XIM U M

:CALCulat e:MA R Ker:M A Xim u m:LEFT

Function Detects the nearest peak existing on the left side

of the current position of the moving marker and places the moving marker on that peak.

:CALC ulate:M A R Ke r:M A Ximum:LEFT

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALC ULATE:MAR K E R:M A XIM U M:LEFT

occurs.

:CALCulat e:MA R Ker:M A Xim u m:N E X T

Function Detects the highest peak that is below the level

of the current position of the moving marker and places the moving marker on that peak.

:CALC ulate:M A R Ke r:M A Ximum:NE XT

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALC ULATE:MAR K E R:M A XIM U M:NEXT

occurs.

:CALCulat e:MA R Ker:M A Xim u m:RIG Ht

Function Detects the nearest peak existing on the right

side of the current position of the moving marker and places the moving marker on that peak.

:CALC ulate:M A R Ke r:M A Ximum:RIGHt

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALC ULATE:MAR K E R:M A XIM U M:RIGHT

occurs.

:CALCulate:MARKer:MAXimum:SCENter

Function Detects the peak wavelength and sets it as the

measurement center waveform.

:CALCulate:MARKer:MAXimum:SCENter

Syntax Example Description This is a sequential command.

:CALCULATE:MARKER:MAXIMUM:SCENTER

:CALCulate:MARKer:MAXimum:SCENter:AU TO

Function Sets or queries ON/OFF of the function to

automatically detect the peak wavelength and set it as the measurement center wavelength.

:CALCulate:MARKer:MAXimum:SCENter:

Syntax

AUTO < w s p> OF F|O N|0|1

:CALCulate:MARKer:MAXimum:SCENter:

AUT O?

Response 0 = OFF, 1 = ON Example

:CALCULATE:MARKER:MAXIMUM:SCENTER:

Description • When this function is ON, this instrument

• This is a sequential command.

:CALCULATE:MARKER:MAXIMUM:SCENTER:

AUTO ON

AUTO? -> 1

automatically detects the peak wavelength of an active trace wavelength each time a sweep has ended, and sets it as the measurement center wavelength.

:CALCulat e:MA R Ker:M A Xim u m:SRLe v e l

Function Detects the peak level and sets it for the

reference level.

:CALC ulate:M A R Ke r:M A Ximum:SRLe vel

Syntax Example Description This is a sequential command.

:CALCULATE:MARKER:MAXIMUM:SRLEVEL

5-18

IM AQ6380-17EN

Page 52

5.3 CALCulate Group

:C A L C u l at e:M A R K er:M A Xi m u m:S R L ev e l:A U TO

Function Sets or queries ON/OFF of the function to

automatically detect the peak level and sets it as the reference level.

:CALC ulate:M A R Ke r:M A Ximum:SRLe vel:AU

Syntax

TO < w s p > OF F|O N|0|1

:CALC ulate:M A R Ke r:M A Ximum:SRLe vel:

AUT O?

Response 0 = OFF, 1 = ON Example

:CALCULATE:MARKER:MAXIMUM:SRLEVEL:

Description • When this function is ON, the instrument

• This is a sequential command.

:CALCULATE:MARKER:MAXIMUM:SRLEVEL:

AUTO ON

AUTO? -> 1

automatically detects the peak level of an active trace wavelength each time a sweep has ended, and sets it as the reference level.

:CALCulate:MARKer:MAXimum:SZCenter

Function Detects the peak wavelength and sets it as the

display center wavelength.

:CALC ulate:M A R Ke r:M A Ximum:SZCenter

Syntax Example Description This is a sequential command.

:CALCULATE:MARKER:MAXIMUM:SZCENTER

:CALCulat e:MA R Ker:MIN i mu m

Function Detects the bottom and places the moving marker

on that bottom.

:CALC ulate:M A R Ke r:MINi m u m

Syntax Example Description This is a sequential command.

:CALC ULATE:MAR K E R:MINIM U M

:CALCulat e:MA R Ker:MIN i mu m:LE F T

Function Detects the nearest bottom existing on the left

side of the current position of the moving marker and places the moving marker on that bottom.

:CALC ulate:M A R Ke r:MINi m u m:L EF T

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALC ULATE:MAR K E R:MINIM U M:LEFT

occurs.

:CALCulate:MARKer:MINimum:RIGHt

Function Detects the nearest bottom existing on the right

side of the current position of the moving marker and places the moving marker on that side.

:CALC ulate:M A R Ke r:MINi m u m:R IGHt

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALCULATE:MARKER:MINIMUM:RIGHT

occurs.

:CALCulat e:MA R Ker:MSEarch

Function Sets or queries the type of the search function.

:CALC ulate:M A R Ke r:MSEar ch<w sp>

Syntax

OF F|O N|0|1

:CALC ulate:M A R Ke r:MSEar ch?

OFF|0: Sets the search function to single search. ON|1: Sets the search function to multi search. Response 0 = OFF, 1 = ON Example

:CALC ULA TE:MA R K ER:MSEARCH? -> 1

Description • The search is executed as soon as you set the

• This is a sequential command.

:CA LCULATE:MARKE R:MSE A RCH o n

search function.

:CALCulat e:MA R Ker:MSEarch:SO RT

Function Sets or queries the sort order of the multi search

detection list.

:CALC ulate:M A R Ke r:MSEar ch:SORT<wsp>

Syntax

WAV e l e n g t h|L EVel|0|1

:CALC ulate:M A R Ke r:MSEar ch:SORT?

WAVelength|0: Wavelengths are displayed in

order starting from the shortest wavelength.

LEVel|1: For the peak search, levels are

displayed in order starting from the highest level. For the bottom search, levels are displayed in order starting

from the lowest level. Response 0 = WAVelength, 1 = LEVel Example

:CALC ULA TE:MA R K ER:MSEARCH:SORT? -> 0

Description This is a sequential command.

:CALCULATE:MARKER:MSEARCH:SORT WAV

Commands

:CALCulat e:MA R Ker:MSEarch:TH R es h

:CALCulate:MARKer:MINimum:NEXT

Function Detects the lowest bottom that is above the level

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

of the current position of the moving marker and places the moving marker on that bottom.

:CALC ulate:M A R Ke r:MINi m u m:N EXT

:CALCULATE:MARKER:MINIMUM:NEXT

occurs.

Function Sets or queries the multi search threshold.

:CALCulate:MARKer:MSEarch:THResh

Syntax

<w s p> <N R f >[D B]

:CALCulate:MARKer:MSEarch:THResh?

<NRf>: Threshold (dB) Example

:CALCULATE:MARKER:MSEARCH:THRESH?

Description This is a sequential command.

:CALC ULATE:MAR K E R:MSEARCH:

THRESH 50DB

-> +5.00000000E+001

IM AQ6380-17EN

5-19

Page 53

5.3 CALCulate Group

:C A LC u lat e:M A R K er{:PD E Nsit y|:NOISe} {:BWIDt h|:B A N D widt h}

Function Sets or queries the normalization bandwidth of

the specified power spectral density marker.

:CA L C u l ate:M A R K e r{:PD E N sity|:NOIS e}

Syntax

{:B W IDt h|:BA ND wid t h}<w s p > < N R f >[m]

:CA L C u l ate:M A R K e r{:PD E N sity|:NOIS e}

{:B W IDt h|:BA ND wid t h}?

<NRf> = Normalization bandwidth of the DENSity

marker in units of m.

Example

:CALCULATE:MARKER:PDENSITY:BWIDTH? ->

:CALCULATE:MARKER:PDENSITY:BWIDTH

0.1N M

+1.00000000E-013

:CALCulate:MARKer:SCENter

Function Sets the wavelength of the current moving marker

as the measurement center waveform.

:CALCulate:MARKer:SCENter

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALCULATE:MARKER:SCENTER

occurs.

:CALCulate:MARKer:SRLevel

Function Sets the current level of the moving marker for

the reference level.

:CALCulate:MARKer:SRLevel

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALCULATE:MARKER:SRLEVEL

occurs.

:CALCulate:MARKer[:STATe]

Function Specified marker is positioned or deleted in the

position of the moving marker. Also, queries the status of the specified marker.

:CA L C u l ate:M A R K er[:STA T e]<wsp>

Syntax

< m a r ke r >,OF F|O N||DE N S i t y |I N Te g r a l|0|1|2

|3[,<integra range>]

:CA L C u l ate:M A R K er[:STA T e]?<wsp>

<marker>: Marker number 1|NORMal Normal marker 2|DENSity Power spectral density marker 3|INTegral Integral marker <integra range> = <NRf>[Hz] Setting is possible when the marker type is

set to INTegral(3). Response 0 = OFF, 1 = NORMal 2 = DENSity, 3 = INTegral,<integra range> Example

:CALCULATE:MARKER:STATE 1 -> 1

Description • When the moving marker is not active and

• If moving marker is specified, it is placed in the

• This is a sequential command.

:CALCULATE:MARKER:STATE 1,ON

an attempt is made to set a fixed marker, an execution error occurs.

center of measurment display.

:CALCulate:MARKer:SZCenter

Function Sets the current wavelength of the moving marker

for the display center wavelength.

:CALCulate:MARKer:SZCenter

Syntax Example Description • If the moving marker is OFF, an execution error

• This is a sequential command.

:CALCULATE:MARKER:SZCENTER

occurs.

5-20

:CALCulate:M ARKer:TYPE

Function Sets or queries the marker type.

:CALCulate:MARKer:TYPE<wsp><marker>,

Syntax

<type>

:CALCulate:MARKer:TYPE?<wsp><marker>

<marker>: Marker number <type>: 1|NORMAL Normal marker 2|DENSity Power spectral density marker 3|INTegral Integral marker Example

:CALCULATE:MARKER:TYPE? 1 -> 2

Description This is a sequential command.

:CALCULATE:MARKER:TYPE 1,DENS

IM AQ6380-17EN

Page 54

5.3 CALCulate Group

:CALCulate:MARKer:UNIT

Function Sets or queries the units of display for the marker

values.

:CALCulate:MARKer:UNIT<wsp>WAVelength

Syntax

|FR E Q u e n c y|0|1

:CALCulate:MARKer:UNIT?

Parameter WAVelength|0 FREQuency|1 Response 0=WAVelength, 1= FREQuency Example

:CALCULATE:MARKER:UNIT? -> 1

Description This is a sequential command.

:CALCULATE:MARKER:UNIT FREQUENCY

:CALCulate:MARKer:X

Function Sets the specified marker at the specified

position.Queries the X value of the specified marker.

:CALCulate:MARKer:TYPE<wsp><marker>,

Syntax

<type>

:CALCulate:MARKer:TYPE?<wsp><marker>

<marker>: Marker number (0 = Moving marker) <type>: 1|NORMAL Normal marker 2|DENSity Power spectral density

marker 3|INTegral Integral marker If omitted, the Normal marker is set. <integra range> = <NRf>[Hz] Setting is possible when the marker type is

set to INTegral(3). Response <NRf>[m|Hz]( Example

:CALCULATE:MARKER:TYPE? 1 -> 2

Description This is a sequential command.

:CALCULATE:MARKER:TYPE 1,DENS

:CALCulate:MARKer:Y?

Function Queries the Y value of the specified marker.

:CALCulate:MARKer:Y?<wsp><marker>|

Syntax

ALL

<marker> : Marker number (0: moveing marker) ALL = All assigned markers If <marker> is specified <NRf>= Marker level If ALL is specified <integer>, <NRf>, <NRf>, ..., <NRf> Example

Description • This unit of the marker level to be queried

• If the specified marker is not located, a query

• If ALL is specified (e.g., :CALC:MARK:Y? ALL),

• This is a sequential command.

:CALCULATE:MARKER:Y? 0

-> -1.00000000E+001

is dependent on the Y-axis unit of the active trace.

error occurs.

the Y values of all assigned markers will be returned.

:CALCulate:M ATH:TRC

Function Sets or queries the TRACE C calculation function.

:CALCulate:MATH:TRC<wsp>A-B(LOG)|

Syntax

B - A ( L O G )| A + B( L O G )| A + B( L I N )|

A - B ( L I N )| B - A ( L I N )|1 - K ( A / B )|

1- K ( B / A )|

:CALCulate:MATH:TRC?

Example

:CALCULATE:MATH:TRC? -> A-B(LOG)

Description • When the calculation function of trace C is set

• If trace C is not a calculation trace, “NONE” is

• This is a sequential command.

:CALCULATE:MATH:TRC A-B(LOG)

using this command, the attribute of trace C automatically becomes attribute “CALC”.

returned.

:C A L C u l at e:M A TH:T R C:K

Function Sets or queries parameter K of the TRACE C

calculation function.

:CALCulate:MATH:TRC:K<wsp><NRf>

Syntax

:CALCulat e:M AT H:T R C:K?

<NRf> = Parameter K Example

:CALCULATE:M A TH:TRC:K?

Description This is a sequential command.

:CA LCUL ATE:M A T H:T RC:K 0.1

-> +1.00000000E-001

:CALCulate:MATH:TRF

Function Sets or queries the TRACE F calculation function.

:CALCu late:MATH:TRF<wsp>C-D(LOG)|

Syntax

D - C( L O G )|C + D ( L O G )|D - E( L O G )|

E-D(LOG)|D+E(LOG)|C+D(LIN)|

C-D(LIN)|D-C(LIN)|D+E(LIN)|

D-E(LIN)|E-D(LIN)|PWRNBWA|PWRNBWB|

PWRNBWC|PWRNBWD|PWRNBWE

:CALCulate:MATH:TRF?

Example

:CALCULATE:MATH:TRF? -> C-D(LOG)

Description • When the calculation function of trace F is set

• If trace F is not a calculation trace, “NONE” is

Example :calc:math:trf c-d(log) :calc:math:trf? -> C-D(LOG)

• This is a sequential command.

:CALCU LATE:MATH:TRF C-D(LOG)

using this command, the attribute of trace F automatically becomes attribute “CALC”.

returned.

Commands

IM AQ6380-17EN

5-21

Page 55

5.3 CALCulate Group

:CALCulate:MATH:TRF:PNBW:BWIDth|BANDwi dth

Function Sets or queries the normalization bandwidth of

the power spectral density trace.

:CALCulate:MATH:TRF:PNBW:BWIDth|

Syntax

BANDwidth<wsp><NRf>[m]

:CALCulate:MATH:TRF:PNBW:BWIDth|

BANDwidth?

<NRf>=Nor malization ba ndwidth[m m]

Example

:CALCULATE:MATH:TRF:PNBW:BAND?

Description This is a sequential command.

:CALCULATE:MATH:TRF:PNBW:BAND 0.1nm

-> 1.00000000E-010

:CALCulate:MATH:TRG

Function Sets or queries the TRACE G calculation

function.

:CALCulate:MATH:TRG<wsp>C-F(LOG)|

Syntax

F-C(LO G)|C+F(LOG)|E-F(LOG)|

F-E(LOG)|E+F(LOG)|C+F(LIN)|

C - F( L I N )| F - C( L I N )| E + F( L I N )|

PKCVFTB|PKCVFTC

:CALCulate:MATH:TRG?

Example

:CALCULATE:MATH:TRG? -> C-F(LOG)

Description • When the calculation function of trace G is set

• If trace G is not a calculation trace, “NONE” is

• This is a sequential command.

:CALCULATE:MATH:TRG C-F(LOG)

using this command, the attribute of trace G automatically becomes attribute “CALC”.

returned.

:CA LC u lat e:M ATH:TR G:C V F T:F A LG o

Function Sets or queries the fitting curve function of the

TRACE G fitting curve function.

:CALCulat e:M AT H:T R G:C V F T:F A L G o

Syntax

:CALCulat e:M AT H:T R G:C V F T:F A L G o?

<algorithm> GAUSs = GAUSS LORENz = LORENZ 3RD = 3RD POLY 4TH = 4TH POLY 5TH = 5TH POLY Response 0 = GAUSS 1 = LORENZ, 2 = 3RD POLY 3 = 4TH POLY 4 = 5TH POLY Example

:CALCULATE:MATH:TRG:CVFT:FALG? -> 0

Description • Setting of calculation area is common to curve

• This is a sequential command.

:CALCULATE:MATH:TRG:CVFT:

FALGO GAUSS

fit and peak curve fit.

:CA LC u lat e:M ATH:TR G:C V F T:O PA R e a

Function Sets or queries a calculation area during curve fit

and peak curve fit.

:CALCulat e:M AT H:T R G:C V F T:O PA Rea

Syntax

<w s p>A L L|I N L 1-L 2|O U T L1-L 2|0|1|2

:CALCulat e:M AT H:T R G:C V F T:O PA Rea?

ALL = all of the set wavelength range INL1-L2 = range surrounding line marker 1 and 2 OUTL1-L2 = range outisde line markers 1 and 2 Response 0 = ALL, 1 = INL1-L2, 2 = OUTL1-L2 Example

:CALCULATE:MATH:TRG:CVFT:OPAREA?-> 1

Description • Setting of calculation area is common to curve

• This is a sequential command.

:CALCULATE:MATH:TRG:CVFT:

OPAREA INl1-l2

fit and peak curve fit.

:C A L C u l at e:M A TH:T R G:C V F T:T HR es h

Function Sets or queries the threshold value for curve

fitting.

:CALCulat e:M AT H:T R G:C V F T:T H R e sh

Syntax

<wsp><integer>[DB]

:CALCulat e:M AT H:T R G:C V F T:T H R e sh?

<NRf> = Threshold level [dB] Example

:CALCULATE:M A TH:TRG:CV F T:THR ESH ?

Description This is a sequential command.

:CA LCUL ATE:M A T H:T RG:C V F T:TH R E SH 10 d b

-> +1.00000000E+001

:C A L C u l at e:M A TH:T R G:PC V F t:TH Re s h

Function Sets or queries the threshold value for peak curve

fitting.

:CALCulat e:M AT H:T R G:P C V F t:T H R e sh

Syntax

<wsp><integer>[DB]

:CALCulat e:M AT H:T R G:P C V F t:T H R e sh?

<NRf> = Threshold level [dB] Example

:CALCULATE:M A TH:TRG:PC VFT:TH R ES H?

Description This is a sequential command.

:CALCULATE:MATH:TRG:PCVFT:

THRESH 10db

-> +1.00000000E+001

5-22

IM AQ6380-17EN

Page 56

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:DFB L d

Function Sets or queries parameters for the DFB-LD

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:DF BL d

Syntax

:CA L C u l ate:PA R a m et e r[:CATe g or y]:DF BL d

?<wsp><item>,<para mater>

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Setting data

SWIDth ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf>[DB] TH2 <NRf>[DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

SMSR SMODe SMSR1|SMSR2|

SMSR3|SMSR4 SMASk <NRf>[M] MDIFf <NRf>[DB] SMPower TDATa|

NORMalized BWIDth <NRf>[M]

RMS ALGO RMS|PKRMs

TH <NRf>[DB] K <NRf> MDIFf <NRf> [DB]

POWer SPAN <NRf>[M] OSNR MDIFf <NRf>[DB]

NALGo AFIX|MFIX|

ACENter|MCENter|

PIT|0|1|2|3|4 NARea <NRf>[M] MARea <NRf>[M] FALGo LINear|GAUSs|

LORenz|3RD|4TH|

5TH|0|1|2|3|4|5 NBW <NRf>[M] SPOWer PEAK|INTegral|0|1 IRANge <NRf>

Example

:CALCUL ATE:PARA METER:DFBLD? SWIDTH,

:CALCUL ATE:PARA METER:DFBLD SMSR,

Description • If a non-existing parameter is used for a

(such as combinations of SWIDth and SMODe)

• This is a sequential command.

:CALCULATE:PARAMETER:

DFBLD SWIDTH,ALGO,THRESH

ALGO -> THR

SM A S K ,0.5N M

:CALCULATE:PARAMETER:DFBLD?

SMSR,SMASK -> +5.00000000E-010

combination, an execution error occurs.

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:FIL B t m

Function Sets or queries parameters for the FILTER-BTM

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

FI L B t m < w s p> < it e m >,,< d at a >

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

FILBtm?<wsp><item>,<para mater>

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Data to be set

BLEVel SW OFF|ON|0|1 BWAVelength SW OFF|ON|0|1 CWAVelength SW OFF|ON|0|1

ALGO PEAK|BOTTom TH <NRf>[DB] MDIFf <NRf>[DB]

NWIDth SW OFF|ON|0|1

ALGO PEAK|BOTTom TH <NRf>[DB] MDIFf <NRf>[DB]

XTALk SW OFF|ON|0|1

ALGO PEAK|BOTTom|

BLEVel|GRID TH <NRf>[DB] MDIFf <NRf>[DB] CSPace <NRf>[M] SARea <NRf>[M]

Example

:CALCULATE:PARAMETER:

:CALCULATE:PARAM ETER:FILBTM XTALK,

:CALCULATE:PARAMETER:FILBTM?

Description • If a non-existing parameter is used for a

(a combination of CWAVelength and SARea,

• This is a sequential command.

:CALCULATE:PARAMETER:

FILBTM CWAVELENGTH,ALGO,BOTTOM

FILBTM?CWAVELENGTH,ALGO -> BOTT

CSPA CE,0.2 N M

XTALK,CSPACEe -> +2.00000000E-010

combination, an execution error occurs

etc.).

Commands

IM AQ6380-17EN

5-23

Page 57

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:FILPk

Function Sets or queries parameters for the FILTER PEAK

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:FIL Pk

Syntax

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

FILPk?<wsp><item>,<paramater>

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Data to be set

PLEVel SW OFF|ON|0|1 PWAVelength SW OFF|ON|0|1 MWAVelength SW OFF|ON|0|1

ALGO THResh|RMS TH <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

SWIDth SW OFF|ON|0|1

ALGO THResh|RMS TH <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

XTALk SW OFF|ON|0|1

ALGO THResh|PLEVel|

GRID TH <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB] CSPace <NRf> [M] SARea <NRf> [M]

RWIDth SW OFF|ON|0|1

TH <NRf> [DB] MDIFf <NRf> [DB]

Example

:CALCULATE:PARAMETER:FILPK? SWIDTH,

:CALCULATE:PARAM ETER:FILPK XTALK,

Description • If a non-existing parameter is used for a

(a combination of SWIDth and CSPace, etc.).

• This is a sequential command.

:CALCULATE:PARAMETER:FILPK SWIDTH,

ALGO,THRESH

ALGO -> THR

CSPACE,0.5NM :CALCULATE:PARAMETER:

FILPK? XTALK,CSPACE

-> +5.00000000E-010

combination, an execution error occurs

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:F P L D

Function Sets or queries parameters for the FP-LD

analysis function.

:CALCulate:PARameter[:CATegory]:FPLD

Syntax

:CALCulate:PARameter[:CATegory]:FPLD?

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Setting data

SWIDth ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf> [DB] TH2 <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

MWAVelength ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf> [DB] TH2 <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

TPOWer OFFSet <NRf> [DB] MNUMber ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf> [DB] TH2 <NRf> [DB] K <NRf> MFIT OFF|ON|0|11 MDIFf <NRf> [DB]

Example

:CALCULATE:PAR AMETER:FPLD? SWIDTH,

:CALCULATE:PARAMETER:FPLD TPOWER,

:CALCULATE:PARAMETER:FPLD? TPOWER,

Description • If a non-existing parameter is used for a

(a combination of SWIDth and OFFSET, etc.)

• This is a sequential command.

:CALCULATE:PARAMETER:FPLD SWIDTH,

ALGO,THRESH

ALGO -> THR

OFFSET,1.0DB

OFFSET -> +1.00000000E+000

combination, an execution error occurs.

5-24

IM AQ6380-17EN

Page 58

5.3 CALCulate Group

:CALCulate:PARameter[:CATegory]:ITLa

Function Sets or queries parameters for the ITLA analysis

function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:IT L a

Syntax

:CA L C u l ate:PA R a m et e r[:CATe g or y]:IT L a?

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Setting data

SWIDth ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf>[DB] TH2 <NRf>[DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

SMSR SMODe SMSR1|SMSR2|

SMSR3|SMSR4 SMASk <NRf>[M] MDIFf <NRf>[DB] SMPower TDATa|NORMalized BWIDth <NRf>[M]

POWer SPAN <NRf>[M] SSER ALGO IEC|CURVefit

MDIFf <NRf>[DB] AARea <NRf>[M] FARea <NRf>[M] MARea <NRf>[M] FALGo GAUSs|LORenz|3RD|4TH|

5TH|1|2|3|4|5 NBW <NRf>[M] SPOWer PEAK|INTegral|0|1 IRANge <NRf>

Example

:CALCULATE:PARAMETER:ITLA?

:CALCULATE:PAR AMETER:ITLA SWIDTH,

:CALCULATE:PAR AMETER:ITLA? SWIDTH,

Description This is a sequential command.

:CALCULATE:PARAMETER:ITLA SWIDTH,

ALGO,THRESH

SWIDTH,ALGO -> THR

TH, 20.00D B

TH -> +2.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:L ED

Function Sets or queries parameters for the LED analysis

function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:L ED

Syntax

:CA L C u l ate:PA R a m et e r[:CATe g or y]:L ED?

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Setting data

SWIDth ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf> [DB] TH2 <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

MWAVelength ALGO ENVelope|THResh|

RMS|PKRMs TH <NRf> [DB] TH2 <NRf> [DB] K <NRf> MFIT OFF|ON|0|1 MDIFf <NRf> [DB]

TPOWer OFFSet <NRf> [DB]

Example

:CALCULATE:PAR AMETER:LED? SWIDTH,ALGO

:CALCULATE:PARAMETER:LED TPOWER,

Description • If a non-existing parameter is used for a

(a combination of SWIDth and OFFSet, etc.).

• This is a sequential command.

:CALCULATE:PAR AMETER:LED SWIDTH,ALGO,

THRESH

-> T H R

OFFSET,1.0DB :CALCULATE:PARAMETER:

LED? TPOW ER,OFFSET -> +1.00000000E+000

combination, an execution error occurs

Commands

IM AQ6380-17EN

5-25

Page 59

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:A A L Go

Function Sets or queries the measurement algorithm

applied to ASE level measurements made by the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:A A

Syntax

LGo<wsp><algorithm>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:A A

LG o?

<algorithm> = Measurement algorithm AFIX: AUTO FIX MFIX: MANUAL FIX ACENter: AUTO CENTER MCENter: MANUAL CENTER Response 0 = AUTO FIX 1 = MANUAL FIX 2 = AUTO CENTER 3 = MANUAL CENTER Example

:CALCULATE:PARAMETER:NF:AALGO? -> 1

Description This is a sequential command.

:CALCULATE:PAR AMETER:NF:AALGO MFIX

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:FA L Go

Function Sets or queries the fitting function during level

measurement applied to ASE level measurements made by the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

FALGo<wsp><algorithm>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

FA L G o?

<algorithm> = Fitting function LINear: LINEAR GAUSs: GAUSS LORenz: LORENZ 3RD: 3RD POLY 4TH: 4TH POLY 5TH: 5TH POLY Response 0 =LINEAR 1 = GAUSS 2 = LORENZ 3 = 3RD POLY 4 = 4TH POLY 5 = 5TH POLY Example

:CALCULATE:PARAMETER:NF:FALGO? -> 1

Description This is a sequential command.

:CALCULATE:PAR AMETER:NF:FALGO GAUSS

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:FA R ea

Function Sets or queries the fitting range for level

measurement applied to ASE level measurements made by the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

FARea<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

FA R ea?

<NRf>= fitting range [m] Example

:CALCULATE:PARAMETER:NF:FAREA?

Description • When the fitting range is set to “Between CH”

• This is a sequential command.

:CALCULATE:PARA METER:NF:

FAREA 0.80NM

-> +8.00000000E-010

(and ASE measurement algorithm is set to “AUTO-CTR” or “MANUAL-CTR”), then the command returns 0.

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:IO F Fset

Function Sets or queries level offset values (signal light)

for the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

IOFFset<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

IOFFset?

<NRf> = Level offset value of signal light [dB] Example

:CALCULATE:PARAMETER:NF:IOFFSET?

Description This is a sequential command.

:CALCULATE:PARA METER:NF:

IOF F S ET 10.0 0

-> +1.00000000E+001

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:IR A Nge

Function Sets or queries the integration frequency range

for when the EDFA-NF analysis feature calculates the signal optical power.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

IRA Nge<wsp><NRf>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

IR ANge?

<NRf> = Integration range [GHz] Example

:CALCulate:PARameter:NF:IRANGE?

Description This is a sequential command.

:CALCulate:PARameter:NF:IRANGE 40

-> +4.00000000E+001

5-26

IM AQ6380-17EN

Page 60

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:M A R ea

Function Sets or queries the mask range for level

measurement applied to ASE level measurements made by the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

MA Rea<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

MA Rea?

<NRf> = mask range [m] Example

:CALCULATE:PARAMETER:NF:MAREA?

Description • When the mask range is set to “---” (and ASE

• This is a sequential command.

:CALCULATE:PARA METER:NF:

MAREA 0.40NM

-> +4.00000000E-010

level measurement function is set to “LINEAR”), the command returns 0.

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:M DI Ff

Function Sets or queries the peak bottom difference of

channel detection for the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

MDI F f< w s p> <NR f >[D B]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

MDIFf?

<NRf> = Peak bottom difference [dB] Example

:CALCULATE:PARAMETER:NF:MDIFF?

Description This is a sequential command.

:CALCULATE:PARA METER:NF:

M DI F F 3.00 D B

-> +3.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:O OF Fset

Function Sets or queries level offset values (output light)

for the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

OOFFset<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

OOFFset?

<NRf> = Level offset value of output light [dB] Example

:CALCULATE:PARAMETER:NF:OOFFSET?

Description This is a sequential command.

:CALCULATE:PARA METER:NF:

OOFFSET 10.00

-> +1.00000000E+001

:C A L C u l a t e:P A R a m e t e r[:C A T e g o r y]:NF:P DI Splay

Function Sets or queries whether to display data used for

fitting of the NF analysis function on the waveform screen.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:PDI

Syntax

Splay<ws p > O F F|ON|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:PDI

Splay?

Response 0 = OFF, 1 = ON Example

:CA L C U L A T E:PA R A M E T E R:N F:PDISP L A Y?-> 1

Description • When this set value is 1 (ON), data used for

• This is a sequential command.

:CALCULATE:PARAMETER:NF:PDISPLAY ON

fitting is displayed on the waveform screen.

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:TH

Function Sets or queries the threshold level of channel

detection for the NF analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

TH<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

TH?

<NRf> = Threshold level [dB] Example

:CALCULATE:PARA METER:NF:TH->

Description This is a sequential command.

:CALCULATE:PARAMETER:NF:TH 20.00DB

+2.00000000E+001

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:R BW idth

Function Sets or queries the method for calculating the

resolution value of the NF computation.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

R B W i d t h< w sp>M E A S u r ed|C A L|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

RBWidth?

MEASured|0 Use the value determined from the

waveform using THRESH 3dB analysis.

CAL|1 Use the actual resolution value stored in

the instrument . Response 0=MEASURED, 1=CAL Example

:CALCULATE:PARA METER:NF:RBWIDTH?

Description This is a sequential command.

:CALCULATE:PARA METER:NF:RBWIDTH

MEASURED

-> 0

Commands

IM AQ6380-17EN

5-27

Page 61

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:S N O ise

Function Sets or queries whether Shot Noise is included in

the NF computation

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

SNOise<wsp>OFF|ON|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

SN Ois e?

OFF|0 Shot Noise not included in the NF

computation

ON|1 Shot Noise included in the NF

computation Response 0=OFF, 1=ON Example

:CALCULATE:PARAMETER:NF:SNOISE?-> 0

Description This is a sequential command.

:CALCULATE:PAR AMETER:NF:SNOISE OFF

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NF:SPO Wer

Function Sets or queries the signal optical power

calculation method of the EDFA-NF analysis feature.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

Syntax

SP O W e r < w s p >P E A K|I N T e g r a l|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:N F:

SPOWer?

PEAK|0: The signal optical power is set to the

level of the mode peak. INTegral|1: The signal optical power is set to the

power obtained by integrating the

spectrum. Example

:CALCulate:PARameter:NF:SPOWer?

Description This is a sequential command.

:CALCulate:PARameter:NF:SPOWer PEAK

-> 0

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NO T C h :K

Function Sets or queries the magnification of the notch

width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

NOTCh:K<wsp><NRf>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

NOTCh:K?

<NRf> = Magnification Example

:CA L CULAT E:PA R AM ET E R:N OTC H:K?

Description This is a sequential command.

:CA L C UL ATE:PA R A M ETE R:N OTC H:K 2.00

-> +2.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NO T C h: TH

Function Sets or queries the threshold value for the notch

width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

NOTCh:TH<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

NOTCh:TH?

<NRf> = Threshold level [dB] Example

:CA L C U L A T E:P A R A M ET E R:N O TCH:TH?->

Description This is a sequential command.

:CALCULATE:PARAMETER:NOTCH:

TH 3.00D B

+3.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:NO T C h: TYPE

Function Sets or queries the analysis direction of the notch

width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

NOTCh:TYPE<wsp>PEAK|BOTTom|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

NOTCh:TYPE?

PEAK|0: Performs analysis using the peak

level of a waveform as a reference.

BOTTom|1: Performs analysis using the bottom

level of a waveform as a reference. Response 0 = PEAK, 1 = BOTTom Example

:CALCULATE:PARA METER:NOTCH:TYPE? -> 1

Description This is a sequential command.

:CALCULATE:PARAMETER:NOTCH:

TYPE BOTTOM

:CALCulate:PARameter[:CATegory]:POWer: OFFSet

Function Sets or queries the offset value for the POWER

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:POWer

Syntax

:OFFSet<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:POWer

:OFFS et?

<NRf> = Offset value [dB] Example

:CALCULATE:PARAMETER:POWER:OFFSET?->

:CALCULATE:PARA METER:POWER:

OFFSET 1.00DB

+1.00000000E+000

5-28

IM AQ6380-17EN

Page 62

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S M SR:B ANDwidth|:BWIDth

Function Sets or queries the resolution bandwidth used

for side mode power normalization of the SMSR analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

Syntax

BANDwidth|:BWIDth<wsp><nrf>[nm]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

BANDwidth|:BWIDth?

Example

:CALCULATE:PARA METER:SMSR:BANDWIDTH?

Description Setting is possible when the side mode power

Use the :CALC:PAR:SMSR:SPOW command to

:CALC ULATE:PAR A M ET ER:SMSR:

BA N D WID TH0.1 N M

-> +1.00000000E-010

calculation is set to Normalized.

set the side mode power calculation method.

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S M SR

:MASK Function Sets or queries the mask value for the SMSR

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

Syntax

MASK<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

MASK?

<NRf> = Mask value [m] Example :CALCULATE:PARAMETER:SMSR:MASK 2.0nm :CALCULATE:PARAMETER:SMSR:MASK?

->+2.00000000E-009

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S M SR:M ODE

Function Sets or queries the analysis mode for the SMSR

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

Syntax

MODE<wsp>SMSR1|SMSR2|SMSR3|SMSR4

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

MODE?

Example

:CALC ULATE:PAR A M ET ER:SMSR:MODE?

:CA LCULATE:PAR A M ETER:SMSR:M ODE S MSR1

->S M S R 1

:C A L C u l at e:PA R a m e t e r[:CA T e g o r y]:S M S R:S MPower

Function Sets or queries the side mode power calculation

method of the SMSR analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

Syntax

SMPower<wsp>0|1|TDATa|NORMalized

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SMSR:

SMPower?

0|TDATa: The side mode power is set to the peak

level of the side mode. 1|NORMalized: The side mode power is set to the value

obtained by normalizing the peak level of

the side mode by the resolution bandwidth. Example

:CALCULATE:PARAMETER:SMSR:SMPOWER? ->

Description Use the :CALC:PAR:SMSR:BAND command to

:CALC ULATE:PAR A M ET ER:SMSR:

SMPOWER TDAT

set the resolution bandwidth.

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W E N v e lop e:K

Function Sets or queries the magnification of the

ENVELOPE method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SWENvelope:K<wsp><NRf>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SW E N v elo p e:K?

<NRf> = Magnification Example

:CALCULATE:PARAMETER:SWENVELOPE:K? ->

Description This is a sequential command.

:CALCULATE:PARAMETER:SWENVELOPE:

K 2.00

+2.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W E N v e lo p e:T H 1

Function Sets or queries the search threshold level of

the ENVELOPE method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SW E N v

Syntax

elo p e:T H 1<ws p> < N R f>[ D B]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SW E N v

elo p e:TH1?

<NRf> = Search threshold level [dB] Example

:CALCULATE:PARAMETER:SWENVELOPE:

Description This is a sequential command.

:CALCULATE:PARAMETER:SWENVELOPE:

TH1 3.00

TH1?-> +3.00000000E+000

Commands

IM AQ6380-17EN

5-29

Page 63

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W E N v e lo p e:T H 2

Function Sets or queries the threshold level of the

ENVELOPE method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SW E N v

Syntax

elope:TH2<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:SW E N v

el o p e:T H 2?

<NRf> = Threshold level [dB] Example

:CALCULATE:PARAMETER:SWENVELOPE:

Description This is a sequential command.

:CALCULATE:PARAMETER:SWENVELOPE:

TH2 10.00 d b

TH2?-> +1.00000000E+001

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W PK r m s:K

Function Sets or queries the magnification of the PEAK-

RMS method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SW P K r m s:K< w s p><N R f>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SW P K r m s:K?

<NRf> = Magnification Example

:CA L C U L A T E:P A R A M ET E R:SWPK R M S:K?->

Description This is a sequential command.

:CALCULATE:PARAMETER:SWPKRMS:K 2.00

+2.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W PK r m s:TH

Function Sets or queries the threshold level of the PEAK-

RMS method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SWPKrms:TH<wsp><N Rf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SW P K r m s:TH?

<NRf> = Threshold level [dB] Example

:CA L C U L A T E:P A R A M ET E R:SWPK R M S:TH ?->

Description This is a sequential command.

:CALCULATE:PARAM ETER:SWPKRMS:

TH 3.00db

+3.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W R M s :K

Function Sets or queries the magnification of the RMS

method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SWRMS:K<wsp><NRf>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SW R MS:K?

<NRf> = Magnification Example

:CA L C U L A T E:PA R A M E T E R:SW R M S;K? ->

+2.00000000E+000

Description This is a sequential command.

:CALCULATE:PARAMETER:SWRMS:K2.00

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W R M s: TH

Function Sets or queries the threshold level of the RMS

method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SW R MS:TH<w s p> <N R f >[D B]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SW R MS:TH?

<NRf> = Threshold level [dB] Example

:CA L C U L A T E:P A R A M ET E R:SW R MS:TH?->

Description This is a sequential command.

:CALCULATE:PARAMETER:SWRMS:

TH 3.00db

+3.00000000E+000

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W THr e sh:K

Function Sets or queries the magnification of the THRESH

method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SWTHresh:K<wsp><NRf>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SWTHresh:K?

<NRf> = Magnification Example

:CALCULATE:PARAMETER:SWTHRESH:K?->

Description This is a sequential command.

:CALCULATE:PARAMETER:SWTHRESH:

K 2.00

+2.00000000E+000

5-30

IM AQ6380-17EN

Page 64

5.3 CALCulate Group

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W THr e sh:M FIT

Function Sets or queries whether to enable the mode fit

of the THRESH method-based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SW T H r esh:M F IT<ws p > O F F|ON|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SWTHresh:MFIT?

Response 0 = OFF, 1 = ON Example

:CALCULATE:PARAMETER:SWTHRESH:MFIT?->

Description This is a sequential command.

:CALCULATE:PARAMETER:SWTHRESH:

MFIT ON

:C A LC u lat e:PA R a m et er[:C A T eg o r y]:S W THr e sh:T H

Function Sets or queries the threshold level of the

THRESH method–based spectrum width analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

SWTHresh:TH<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

SWTHresh:TH?

<NRf> = Threshold level [dB] Response ex. Same as above Example

:CALCULATE:PARAMETER:SWTHRESH:TH?->

Description This is a sequential command.

:CALCULATE:PARAMETER:SWTHRESH:

TH 3.00D B

+3.00000000E+000

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:D M ASk

Function Sets or queries the channel mask threshold level

for the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

DMASk<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

DM ASk?

<NRf> = Threshold level [dB] (–999: Mask OFF) Example

:CA L C U L A T E:PA R A M E T E R:W D M:DM A S K? ->

Description • Channels the level of which are below this

• To turn off the channel mask function, set the

• This is a sequential command.

:CALC ULATE:PAR A M ETER:WDM:DM ASK -999

-9.99000000E+002

parameter will not be detected as a channel.

threshold level to –999.

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:D T YPe

Function Sets or queries the displayed waveforms of the

analysis results for the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:D

Syntax

TYPe<wsp><display type>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:D

TY P e?

<display type>=Type of display ABSolute = Absolute value display RELative = Relative value display MDRift = Drift value display based on the past

measurement wavelength

GDRift = Drift value display based on the grid

wavelength Response 0 = Absolute value display 1 = Relative value display 2 = Display drift value using previously

measured waveforms as a reference

3 = Display drift value using grid wavelength

as a reference

Example

:CA L C U L A T E:PA R A M E T E R:W D M:DTYP E? -> 0

Description This is a sequential command.

:CALCULATE:PARAMETER:WDM:

DTYPE ABSOLUTE

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:D U AL

Function Sets or queries the SNR calculation mode for the

WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

DUA L < w s p> OF F|O N|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

DU A L?

Response 0 = OFF, 1 = ON Example

:CALCULATE:PARA METER:WDM:DUAL ON? ->

Description • When this set value is 1 (ON), SNR calculation

• When this set value is 0 (OFF), SNR calculation

• This is a sequential command.

:CALCULATE:PAR AMETER:WDM:DUAL ON

uses both traces A and B data.

uses active trace data.

Commands

IM AQ6380-17EN

5-31

Page 65

5.3 CALCulate Group

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:F A LGo

Function Sets or queries the fitting function during

level measurement applied to noise level measurements made by the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:F

Syntax

ALGo<wsp><algorithm>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:F

ALG o?

<algorithm> = Fitting function LINear = LINEAR GAUSs = GAUSS LORenz = LORENZ 3RD = 3RD POLY 4TH = 4TH POLY 5TH = 5TH POLY Response 0 = LINEAR 1 = GAUSS 2 = LORENZ 3 = 3RD POLY 4 = 4TH POLY 5 = 5TH POLY Example:

:CALCULATE:PARAMETER:WDM:FALGO? -> 1

Description This is a sequential command.

CALCULATE:PARAMETER:WDM:FALGO GAUSS

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:IR ANge

Function Sets or queries the integral frequency range

during signal light power calculation by the WDM analysis function

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

IRA Nge<wsp><NRf>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

IR ANge?

<NRf> Integral frequency range [GHz] Example

c alc:par:wdm:iran? -> +4.00000000E+001

Description This is a sequential command.

calc:par:w d m:i r a n 40

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:IR A N g e:TH

Function Sets or queries the signal optical power

calculation threshold of the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

IRA Nge:TH<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

IR A Nge:TH?

<NRf> = Threshold [dB] Example

:CALCulate:PARameter:WDM:IRANge:TH?

Description This is a sequential command.

:CALCulate:PARameter:WDM:IRANge:TH

3.00d b

-> +3.00000000E+000

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:M A Rea

Function Sets or queries the mask range during

level measurement applied to noise level measurements made by the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

MA Rea<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

MA Rea?

Example

:CALCULATE:PARAMETER:WDM:MAREA? ->

Description This is a sequential command.

:CALCULATE:PARAMETER:WDM:

MAREA 0.40NM

+4.00000000E-010

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:M D IFf

Function Sets or queries the peak bottom difference of

channel detection for the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

MDI F f< w s p> <NR f >[D B]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

MDIFf?

<NRf> = Peak bottom difference [dB] Example

:CALCULATE:PARAMETER:WDM:MDIFF? ->

Description This is a sequential command.

:CALCULATE:PARAMETER:WDM:

M DI F F 3.00 D B

+3.00000000E+000

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:M M Reset

Function Resets the maximum and minimum of the drift

values of the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

MM Reset

Example Description • When "DISPLAY TYPE" (set by the :CALC

• This is a sequential command.

:CALCULATE:PARAMETER:WDM:MMRESET

ulate:PARameter[:CATegory]:WDM:DTYPe command is set to other than “DRIFT”, an execution error occurs.

5-32

IM AQ6380-17EN

Page 66

5.3 CALCulate Group

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:N A LGo

Function Sets or queries the measurement algorithm

applied to noise level measurements made by the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

NALGo<wsp><algorithm>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

NA LG o?

:CALCULATE:PARAMETER:WDM:NALGO?-> 2

Description This is a sequential command.

:CALCULATE:PARAMETER:WDM:

NALGO ACENTER

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:N A Rea

Function Sets or queries the measuring range applied to

noise level measurements made by the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

NARea<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

NA R e a?

<NRf> = NOISE AREA [m] Example

:CALCULATE:PARAMETER:WDM:NAREA? ->

Description This is a sequential command.

:CALCULATE:PARAMETER:WDM:

NAREA 0.80NM

+8.00000000E-010

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:N BW

Function Sets or queries the noise bandwidth for the WDM

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

<NRf> = Noise bandwidth [m] Example

:CA L C U L A T E:P A R A M ET E R:W D M:N B W?->

Description This is a sequential command.

NBW<wsp><NRf>[M]

NBW?

:CALCULATE:PAR AMETER:WDM:NBW 0.10NM

+1.00000000E-010

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:O D ISplay

Function Sets or queries whether the OSNR analysis

results of the WDM analysis function are shown.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

ODIS pl ay<w s p > O F F|O N|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

ODIS play?

OFF|0: Hide ON|1: Show Example

:CALCulate:PARameter:WDM:ODISplay? ->

Description This is a sequential command.

:CALCulate:PARameter:WDM:ODISplay ON

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:O S Lope

Function Sets or queries whether to enable the function of

obtaining the least square approximation line in the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

OSL o p e <w sp> OF F|O N|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

OSLope?

Response 0 = OFF, 1 = ON Example

:CA L C U L A T E:PA R A M E T E R:W D M:OSL O PE? -> 1

Description • When this set value is 1 (ON), this instrument

• This is a sequential command.

:CALCULATE:PARAMETER:WDM:OSLOPE ON

calculates the least square approximation line of the peak of each channel and draws it on the waveform screen.

:C A L C u l a t e:P A R a m e t e r[:C A T e g o r y]:W D M:P D ISplay

Function Sets or queries whether to display data used

for fitting of the WDM analysis function on the waveform screen.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:P

Syntax

DIS pl ay<w s p > O F F|O N|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:P

DISplay?

Response 0 = OFF, 1 = ON Example

:CA L C U L A T E:P A R A M ET E R:W D M:PDISPL AY ?

Description • When this set value is 1 (ON), data used for

• This is a sequential command.

:CALCULATE:PARAMETER:WDM:

PDISPLAY ON

-> 1

fitting is displayed on the waveform screen.

Commands

IM AQ6380-17EN

5-33

Page 67

5.3 CALCulate Group

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:R CH

Function Sets or queries the reference channel used in

calculating the offset wavelength/level of the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

RCH<wsp><integer>

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

RCH?

<integer> = Reference channel number (0: channel with the highest level) Example

:CA L C U L A T E:PA R A M E T E R:RCH? -> 10

Description • When this set value is “0,” the channel with

• This is a sequential command.

:CALCULATE:PAR AMETER:RCH 10

the highest level is regarded as the reference channel.

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:R E Lation

Function Sets or queries the display format of the

wavelength/level relative values for the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

R E L a t i o n < w sp> OF F S e t|S PACi ng|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

REL ation?

OFFSet|0 = Displays an offset value based on

any channel.

SPACing|1 = Displays an offset value relative to a

neighboring channel. Response 0 = OFFSET, 1 = SPACING Example

:CALCULATE:PARAMETER:WDM:RELATION?

Description • When "DISPLAY TYPE" (set by the :CALC

• This is a sequential command.

:CALCULATE:PARAMETER:WDM:

RELATION SPACING

-> 1

ulate:PARameter[:CATegory]:WDM:DTYPe command is set to other than “ABSOLUTE”, an execution error occurs.

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:SP OWer

Function Sets or queries the signal light power calculation

method of the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

SP O W e r < w s p >P E A K|I N T e g r a l|0|1

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

SPOWer?

PEAK|0 = Sets the mode peak to the signal light

power

INTegral|1 = Sets the power that integrates the

spectrum to the signal light power Response 0 = PEAK, 1 = INTegral Example

:CALCULATE:PARA METER:WDM:SPOWer?

-> 0

Description This is a sequential command.

:CALCULATE:PARAMETER:WDM:SPOwer PEAK

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W DM:T H

Function Sets or queries the threshold level of channel

detection for the WDM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

Syntax

TH<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WD M:

TH?

<NRf> = Threshold level [dB] Example

:CA L C U L A T E:P A R A M ET E R:W D M:TH->

Description This is a sequential command.

:C A LCU L A T E:PA R A M ET E R:W D M :T H 20.00D B

+2.00000000E+001

:CALCulate:PARameter[:CATegory]:WDMSms r:DM ASk

Function Sets or queries the channel mask threshold of the

WDM SMSR analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

WDMSmsr:DMASk<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

WDMSmsr:DMASk?

<NRf> = Threshold [dB](-999: mask OFF) Example

:CALCulate:PARameter:WDMSmsr:DMASk?

Description • Channels whose level is less than or equal to

• To turn off the channel mask function, set the

• This is a sequential command.

:CALCulate:PARameter:WDMSmsr:

DM A Sk -999

-> -9.99000000E+002

this parameter are not detected as channels.

threshold to -999.

5-34

IM AQ6380-17EN

Page 68

5.3 CALCulate Group

:CALCulate:PARameter[:CATegory]:WDMSms r:M ASK

Function Sets or queries the threshold of the WDM SMSR

analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

WDMSmsr:MASK<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

WDMSmsr:MASK?

<NRf> = Mask value [m] Example

:CALCulate:PARameter:WDMSmsr:MASK? ->

Description This is a sequential command.

:CALCulate:PARameter:WDMSmsr:

M A SK 2.0n m

+2.00000000E-009

:CALCulate:PARameter[:CATegory]:WDMSms r:M DIF f

Function Sets or queries the channel detection peak/

bottom difference of the WDM SMSR analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

WDMSmsr:MDIFf<wsp><NRf>[DB]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

WDMSmsr:MDIFf?

<NRf> = Peak/bottom difference [dB] Example

:CALCulate:PARameter:WDMSmsr:MDIFf?

Description This is a sequential command.

:CALCulate:PARameter:WDMSmsr:

MDIFf 3.00db

-> +3.00000000E+000

:CALCulate:PARameter[:CATegory]:WDMSms r:S A R ea

Function Sets or queries each channel’s SMSR analysis

range of the WDM SMSR analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

WDMSmsr:SARea<wsp><NRf>[M]

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

WDMSmsr:SARea?

<NRf> = Analysis range [m] Example

:CALCulate:PARameter:WDMSmsr:SARea?

Description This is a sequential command.

:CALCulate:PARameter:WDMSmsr:

SA Rea 2.20n m

-> +2.20000000E-009

:CALCulate:PARameter[:CATegory]:WDMSms r:TH

Function: Sets or queries the channel detection threshold of

the WDM SMSR analysis function.

:CALCulate:PARameter[:CATegory]:WDMSm

Syntax

sr:TH<wsp><NRf>[DB]

:CALCulate:PARameter[:CATegory]:WDMSm

sr:T H?

<NRf> = Threshold [dB] Example

:CALCulate:PARameter:WDMSmsr:TH? ->

Description This is a sequential command.

:CALCulate:PARameter:WDMSmsr:

TH 20.0 0 d b

+2.00000000E+001

Commands

:CALCulate:PARameter[:CATegory]:WDMSms r:M O D E

Function Sets or queries the SMSR analysis mode of the

WDM SMSR analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

WDMSmsr:MODE<wsp>SMSR1|SMSR2

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

WDMSmsr:MODE?

SMSR1: Analysis mode is set to SMSR1. SMSR2: Analysis mode is set to SMSR2. Example

:CALCulate:PARameter:WDMSmsr:MODE? ->

Description This is a sequential command.

:CALCulate:PARameter:WDMSmsr:MODE

SMSR1

IM AQ6380-17EN

5-35

Page 69

5.3 CALCulate Group

:CALCulate:PARameter[:CATegory]:WFBott om

Function Sets or queries parameters for the WDM FILTER-

BTM analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WF B o t

Syntax

t o m < w s p> < it e m >,,< d at a >

:CA L C u l ate:PA R a m et e r[:CATe g or y]:WF B o t

tom?<wsp><item>,<para mater>

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Data to be set

NWAVelength ALGO BOTTom|NPEak|

NBOTtom|

GFIT|GRID MDIFf <NRf>[DB] TH <NRf>[DB] TBANd <NRf>[M]

BWAVelength SW OFF|ON|0|1 CWAVelength SW OFF|ON|0|1

ALGO NPEak|NBOTtom TH <NRf>[DB]

SBANd SW OFF|ON|0|1

TH <NRf>[DB]

EBANd SW OFF|ON|0|1

TH <NRf>[DB] TBANd <NRf>[M]

RIPPle SW OFF|ON|0|1

TBANd <NRf>[M]

XTALk SW OFF|ON|0|1

SPACing <NRf>[M] TBANd <NRf>[M]

Example

:CALCULATE:PARAMETER:WFBOTTOM?

Description • If a non-existing parameter is used for a

• This is a sequential command.

:CALCULATE:PAR AMETER:WFBOTTOM NWAV,

ALG O,N P E A K

NWAV,ALGO -> NPE:CALCULATE:

PARAMETER:WFBOTTOM BWAVELENGTH,SW,

OFF

BWAV E L E N G T H,S W -> 0

combination, an execution error occurs (a combination of NWAVelength and SPACing, etc.).

:C A LC u lat e:P A R a m et er[:C ATe g or y]:W F Pe a k

Function Sets or queries parameters for the WDM FILTER-

PEAK analysis function.

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

Syntax

W F P e a k < w s p > < it e m >,,< d a t a >

:CA L C u l ate:PA R a m et e r[:CATe g or y]:

WFPeak?<wsp><item>,<paramater>

<item> = Analytical item that sets parameter(s) <parameter> = Parameter to be set <data> = Data to be set

NWAVelength ALGO PEAK|MEAN|GFIT|

GRID MDIFf <NRf>[DB] TH <NRf>[DB] TBANd <NRf>[M]

PWAVelength SW OFF|ON|0|1 CWAVelength SW OFF|ON|0|1

TH <NRf>[DB]

SBANd SW OFF|ON|0|1

TH <NRf>[DB]

PBANd SW OFF|ON|0|1

TH <NRf>[DB] TBANd <NRf>[M]

RIPPle SW OFF|ON|0|1

TBANd <NRf>[M]

XTALk SW OFF|ON|0|1

SPACing <NRf>[M] TBANd <NRf>[M]

Example

:CALCULATE:PARAMETER:WFPEAK? NWAV,

:CALCULATE:PARAMETER:

:CALCULATE:PARAMETERWFPEAK?

Description • If a non-existing parameter is used for a

• This is a sequential command.

:CALCULATE:PAR AMETER:WFPEAK NWAV,

A L G O,P E A K

ALGO -> PEAK

WFPEAK PWAVELENGTH,SW,OFF

PWAV E L E N G T H,S W -> 0

combination, an execution error occurs (a combination of NWAVelength and SPACing, etc.).

:CA LC u lat e:PA R a m et e r:CO M M on:M DI F f

Function Sets or queries the peak-bottom difference

parameter of channel detection used in the analysis function.

:CA L C u lat e:PA R a met er:COM M on:M DIFf

Syntax

<w s p> <N R f >[D B]

:CA L C u lat e:PA R a met er:COM M on:M DIFf?

Example

:CALCULATE:PARAMETER:COMMON:MDIFF->

Description This is a sequential command.

:CA L C U L ATE:PAR A MET ER:COM M ON:

M DI F F 3.00 D B

+3.00000000E+000

5-36

IM AQ6380-17EN

Page 70

5.4 CALibration Group

:CALibration:ALIGn[:IMMediate]

Function Executes optical axis adjustment of the

monochromator using the internal reference light source.

:CALi bration:ALIGn[:IMMediate]

Syntax Example Description This is an overlapable command.

:CA LIBR ATION:ALIGN

:C A L i b r a t i o n:A LIG n:I N T e r n a l[:IM M e d i a te]

Function Executes optical axis adjustment of the

monochromator using the internal reference light source.

:C A L ibration:A LIG n:I N T e r n al[:IM M e d ia

Syntax

te]

Example Description This is an overlappable command.

:CALIBRATION:ALIGN:INTERNAL

:CA L i bratio n:B A N D widt h|:BW IDt h[:IM M e d i at e]

Function Executes an resolution calibration.

:CALibration:BANDwidth|:BWIDth

Syntax

[:I M M e d i a t e ]

Example Description • When the resolution calibration finishes, bit 3

• This is an overlappable command.

:CALIBRATION:BANDWIDTH:IMMEDIATE

(Cal/Alignment) of the operation status register is set to 1. For details, see section 6.4.

:CA Li b r a t io n:B A N D widt h|:BW I D t h:INIT i a l ize

Function Clears the rms resolution calibration value.

:CALibration:BANDwidth|:BWIDth:

Syntax

INITialize

Example Description This is a sequential command.

:CALIBR ATION:BANDWIDTH:INITIALIZE

:CALibration:WAVelength:EXTernal[:IMMe d i at e]

Function Performs wavelength calibration using an external

reference light source.

:CALibration:WAVelength:EXTernal

Syntax

[:I M M e d i a t e ]

Example Description • The type of the external reference light source

• The wavelength of the external reference light

• This is an overlapable command.

:CALIBRATION:WAVELENGTH:EXTERNALl

to be used for calibration is set using the CA Libration:WAVelength:EXTernal:SOURce command.

source to be used for calibration is set using the :CALibration:WAVelength:EXTernal:WAVele ngth command.

:C A L i b r at i o n:W AVe l e n gt h:E XT e r n a l:S OU R ce

Function Sets or queries the type of the light source

used for external reference light source-based wavelength calibration.

:CALibration:WAVelength:EXTernal:

Syntax

SOURce<wsp>LASer|GASCell|0|1|

:CALibration:WAVelength:EXTernal:

SO U R ce?

LASer = An external reference light source is

used for the laser

GASCell = A gas cell is used as the external

reference light source. Response 0 = Laser, 1 = Gas cell, Example

:CALIBRATION:WAVELENGTH:EXTERNALl:

Description This is a sequential command.

:CALIBRATION:WAVELENGTH:EXTERNALl:

SOURCE LASER

SOURCEe? -> 0

Commands

:CALibration:BANDwidth|:BWIDth:WAVelen gt h?

Function Queries the wavelength of the light source used

to perform resolution calibration.

:CALibration:BANDwidth|:BWIDth:

Syntax

Response

Example

Description • If resolution calibration has not been executed,

• This is a sequential command.

WAVelen g t h?

<NRf> = Light source wavelength in meters

:CALIBRATION:BANDWIDTH:WAVELENGTH? ->

1.55000000E-006

this command returns 0.

IM AQ6380-17EN

5-37

Page 71

5.4 CALibration Group

:CALibration:WAVelength:EXTernal:WAVel ength

Function Sets or queries the wavelength of the light source

used for external reference light source-based wavelength calibration.

:CALibration:WAVelength:EXTernal:

Syntax

WAVelength<wsp><NRf>[M]

:CALibration:WAVelength:EXTernal:

WAVelen g t h?

<NRf> = Wavelength of the external reference

light source [nm]

Example

:CALIBRATION:WAVELENGTH:EXTERNALl:WAV

Description This is a sequential command.

:CALIBRATION:WAVELENGTH:EXTERNALl:WAV

ELE N G T H 155 0.000N M

ELENGTH? -> +1.55000000E-006

:CALibration:WAVelength:INTernal:AUTO

Function Sets or queries whether wavelength calibration

is automatically executed using the internal reference light source.

:CA Libration:WAVe le ngth:INTerna l:AU TO

Syntax

<ws p> O F F|ON|0|1

:CA Libration:WAVe le ngth:INTerna l:

AUT O?

Response 0=OFF 1=ON Example

:CALIBRATION:WAVELENGTH:INTERNAL:

Description This is a sequential command.

:CALIBRATION:WAVELENGTH:INTERNAL:

AUTO ON

AUTO? -> 1

:CALibration:WAVelength:INTernal:AUTO: INTerval

Function Sets or queries the interval at which wavelength

calibration is executed automatically using the internal reference light source.

:CA Libration:WAVe le ngth:INTerna l:

Syntax

AUTO:INTerval<wsp><integer>

:CA Libration:WAVe le ngth:INTerna l:

AU TO:I N T e r v a l?

<integer> = Execution interval (specified in

minutes)

Example

:CALIBRATION:WAVELENGTH:INTERVAL:

Description This is a sequential command.

:CALIBRATION:WAVELENGTH:INTERVAL:

AUTO:INTERVAL 20

AUTO:INTERVAL? -> 20

:C A L i b r a t i o n:W AVe le n g t h:I N T e r n a l[:IM M e d i at e]

Function Performs wavelength calibration using an internal

reference light source.

:CA Libration:WAVe le ngth:INTerna l

Syntax

[:I M M e d i a t e ]

Example Description This is an overlapable command.

:CALIBRATION:WAVELENGTH:INTERNALl

:CALibration:ZERO[:AUTO]

Function Sets or queries whether to enable the auto offset

function of the level.

:CALibration:ZERO[:AUTO]<wsp>OFF|ON|0|

Syntax

1|O N C E

:CALibration:ZERO[:AUTO]?

Response 0 = OFF, 1 = ON Example

:CALIBR ATION:ZERO? -> 1

Description • If you send this command with the parameter

• The operation of this command is complete

• This is a sequential command.

:CALIBRATION:ZERO ONCE

“ONCE” when the sweep is stopped, offset adjustment is performed once. In this case, ON/OFF of this setting does not change.

at the instant the offset adjustment starts. Therefore, the AQ6380 can execute the next command even while offset adjustment is being performed. You can use :CALibration:ZERO[:A UTO]:STATus? to query the execution status of the offset adjustment.

:CALibration:ZERO[:AUTO]:INTerval

Function Sets or queries the time interval for executing the

Auto Offset function for the level.

:CALibration:ZERO[:AUTO]:INTerval

Syntax

:CALibration:ZERO[:AUTO]:INTerval?

<integer>= Interval of execution (specified in units

of minutes)

Example

:CALIBR ATION:ZERO:INTERVAL? -> 20

Description • When a time is set for this parameter, the auto

• This is a sequential command.

:CALIBRATION:ZERO:INTERVAL 20

offset adjustment is performed at the specified time interval starting from the moment of execution.

:CALibration:ZERO[:AUTO]:STATus?

Function Queries the offset adjustment status.

:CA Li brat i o n:Z E RO[:AU T O]:STAT u s?

Syntax 0: The offset adjustment is not being executed. 1: The offset adjustment is being executed. Example Description This is a sequential command.

:CALIBRATION:ZERO:STATUS? -> 1

5-38

IM AQ6380-17EN

Page 72

5.5 DISPlay Group

:DISPlay:COLor

Function Sets or queries the screen color mode.

:DIS Pl ay:C OL or <wsp> < mo d e >

Syntax

:DIS Pl ay:C OL or?

0 = Black and white mode 1–5 = Modes 1–5 Example

:DISPLAY:COLOR? -> 1

Description This is a sequential command.

:DISP L A Y:COL O R 1

:DISPlay[:WINDow]

Function Sets or queries whether the display is enabled.

:DI SPl a y[:W I N D o w]< w s p>OF F|O N|0|1

Syntax

:DISPlay[:WINDow]?

Response 0 = OFF, 1 = ON Example

:DISPLAY? -> 0

Description This is a sequential command.

:DISPL AY OF F

:DISPlay[:WI N Dow]:OV Ie w:P O S it ion

Function Sets or queries the ON/OFF and position of

the OVERVIEW display shown during zoom operation.

:DISPlay[:WINDow]:OVIew:POSition<wsp>O

Syntax

F F|L E F T|R IG Ht|0|1|2

:DISPlay[:WINDow]:OVIew:POSition?

OFF = Display OFF LEFT = The overview display is on the left of the

screen.

RIGHt = The overview display is on the right of

the screen. Response 0 = OFF, 1 = LEFT, 2 = RIGHt Example

:DIS PL AY:OVIE W:POSITION? -> 2

Description This is a sequential command.

:DISPLA Y:OVIEW:POSITION RIGHT

:DISPlay[:WI N Dow]:T E XT:DA T A

Function Sets or queries the labels.

:DIS Pl ay[:WINDow]:TEXT:DAT A<w s p >

Syntax

:DIS Pl ay[:WINDow]:TEXT:DAT A?

<string> = Label character string (56 characters

max.)

Example

:DIS PLAY:TE X T:D ATA?->

Description • A label character string has a maximum length

• If there is no label, one space character is

• This is a sequential command.

:DISPL AY:TEXT:

DATA "Optical Spectrum A nalyzer"

Optical Spectrum Analyzer

of 56 characters.If a label of more than 56 characters is specified, characters from and exceeding the 57th will be ignored.

returned.

:DISPlay[:WINDow]:TRACe:X[:SCALe]:CENT er

Function Sets or queries the center wavelength of the

X-axis of the display scale.

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

Syntax

CENTer<wsp><NRf>[M|HZ]

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

CENTer?

<NRf> = Center wavelength [m|Hz] Response <NRf> [m|Hz] Example

:DISPLAY:TRACE:X:CENTER?->

Description This is a sequential command.

:DISPLAY:TR ACE:X:CENTER 1550.000NM

+1.55000000E-006

:DISPlay[:WINDow]:TRACe:X[:SCALe]:INITia

Commands

lize

:DISPl a y[:WI N Do w]:TE X T:CLE a r

Function Clears labels.

:DISPlay[:WI N D o w]:TE X T:C L E a r

Syntax Example Description This is a sequential command.

:DISPL AY:TEXT:CLEA R

Function Initializes the X-axis parameters of the display

scale.

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

Syntax

INITialize

Example Description • The following parameters are initialized based

ZOOM CENTER, ZOOM SPAN, ZOOM START,

• This is a sequential command.

:DISPLAY:TRACE:X:INITIALIZE

on the measurement scale after this command has been executed.

ZOOM STOP

IM AQ6380-17EN

5-39

Page 73

5.5 DISPlay Group

:D I S P l a y [:W I N D o w ]:T R A C e : X [: S C A L e ]: S M S C a le

Function Sets parameters of the current display scale to

the measurement scale.

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

Syntax

SMSCale

Example Description • The following parameters are initialized based

CENTER, SPAN, START, STOP

• This is a sequential command.

:DIS P L A Y:T R A C E:X:S M S C A L E

on the display scale after this command has been executed.

:D I S P l a y [:W I N D o w ]:T R A C e : X [: S C A L e ]: S P A N

Function Sets or queries the span of the X-axis of the

display scale.

:DIS Pl ay[:WIND o w]:TR ACe:X[:SCA L e]:SPA N

Syntax

<w s p> <N R f >[M|H Z]

:DIS Pl ay[:WIND o w]:TR ACe:X[:SCA L e]:SPA N?

<NRf> = Span [m|Hz] Response <NRf> [m|Hz] Example

:DISPLAY:TR ACE:X:SPAN? ->

Description This is a sequential command.

:DI SPL A Y:T R A C E:X:S PA N 20.0N M

+2.00000000E-008

:D I S P l a y [:W I N D o w ]:T R A C e : X [: S C A L e ]: S R A N ge

Function Sets or queries whether to limit an analytical

range to the display scale range.

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

Syntax

SR A N g e < w s p>OF F|O N|0|1

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

SR ANge?

Response 0 = OFF, 1 = ON Example

:DISPLAY:TR ACE:X:SRA NGE? -> 1

Description This is a sequential command.

:DISPLAY:TR ACE:X:SRANGE on

:D I S P l a y [:W I N D o w ]:T R A C e : X [: S C A L e ]: S T A R t

Function Sets or queries the start wavelength of the X-axis

of the display scale.

:DIS Pl ay[:WIND o w]:TR ACe:X[:SCA L e]:STA Rt

Syntax

<w s p> <N R f >[M|H Z]

:D I S P l a y[:W I N D o w]:T R A C e : X [: S C A L e]:

STARt?

<NRf> = Start wavelength [m|Hz] Response <NRf> [m|Hz] Example

:DISPLAY:TRACE:X:START?->

Description This is a sequential command.

:DI SPL A Y:T R A C E:X:S T A RT 1540.0 00N M

+1.54000000E-006

:D I S P l a y [:W I N D o w ]:T R A C e : X [: S C A L e ]: S T O P

Function Sets or queries the stop wavelength of the X-axis

of the display scale.

:DIS Pl ay[:WIND o w]:TR ACe:X[:SCA L e]:STOP <

Syntax

wsp> < N R f>[ M|H Z]

:DIS Pl ay[:WIND o w]:TR ACe:X[:SCA L e]:STOP ?

<NRf> = Stop wavelength [m|Hz] Response <NRf> [m|Hz] Example

:DIS P L A Y:T R A C E:X:S T OP ? ->

Description This is a sequential command.

:DI SPL A Y:T R A C E:X:S T O P 1560.000 N M

+1.56000000E-006

:DISPlay[:WINDow]:TRACe:Y:NMASk

Function Sets whether to mask the display of waveforms

the level of which is at or below a set threshold level or queries the condition of whether the relevant waveform display is masked.

:DISPlay[:WINDow]:TR ACe:Y:NMA Sk<ws p>

Syntax

<N R f >[DB]

:DISPlay[:WINDow]:TR ACe:Y:NMA Sk?

<NRf> = Threshold level [dB] (–999: Masking

function OFF)

Example

:DI S P L AY:T R A C E:Y:N M A S K ? ->

Description • The display of waveforms the level of which is

To turn off the mask function, set the threshold

• This is a sequential command.

:DISP L A Y:T R AC E:Y:N M A S K -9 99

-9.99000000E+002

at or below this parameter will be masked.

level to –999.

:DISPlay[:WINDow]:TRACe:Y:NMASk:TYPE

Function Sets or queries the display method when a

waveform display at or below a threshold level is masked.

:DISPlay[:WI N D o w]:TR AC e:Y:N M A S k:T Y PE

Syntax

<ws p >V E R T i c a l|HOR Izo n t a l|0|1

:DISPlay[:WI N D o w]:TR AC e:Y:N M A S k:T Y PE?

VERTical = Waveform display with zero as the

mask value or lower

HORizontal = Waveform display with the mask

value as the mask value or lower Response 0 = VERTical, 1 = HORizontal Example

:DI S P L AY:T R A C E:Y:N M A S K:T Y PE? -> 0

Description This is a sequential command.

:DISPLAY:TRACE:Y:NM ASK:TYPE VERTICAL

5-40

IM AQ6380-17EN

Page 74

5.5 DISPlay Group

:D I S P l a y [:W I N D o w ]:T R A C e :Y [:S C A L e ]:D N U M b er

Function Sets or queries the number of display divisions of

the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y[:S C A L e]:

Syntax

D N U M b e r < w s p >8|10|1 2

:D I S P l a y[:W I N D o w]:T R A C e :Y[:S C A L e]:

DNUMbe r?

8, 10, 12 = Number of display divisions Example

:DI S P L AY:T R A C E:Y:D N U M B E R? -> 10

Description This is a sequential command.

:DISP L A Y:T R AC E:Y:D N U M B E R 10

:D I S P l a y [:W I N D o w ]:T R A C e :Y 1[: S C A L e]: B L E V el

Function Sets or queries the base level applied when the

main scale of the level axis is linear.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

Syntax

BLEVel<wsp><NRf>[W]

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

BL E Vel?

<NRf> = Base level value [W] Example

:DIS P L A Y:T R A CE:Y 1: B L E V E L?->

Description • If a instrument other than W is specified, an

• This is a sequential command.

:DI SPL A Y:T R ACE:Y1:B L E V EL 1.0M W

+1.00000000E-003

execution error occurs.

:DISPlay[:WINDow]:TRACe:Y1[:SCALe]:PDIVi sion

Function Sets or queries the main scale of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

Syntax

PDIVision<wsp><NRf>[DB]

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

PDIVision?

<NRf> = Level scale [dB] Example

:DISPL A Y:TR A C E:Y1:PDIV?->

Description • If a instrument other than dB is specified, an

• This is a sequential command.

:DISPL AY:TRACE:Y1:PDI V 5.0DB

+5.00000000E+000

execution error occurs.

:D I S P l a y [:W I N D o w ]:T R A C e :Y 1[: S C A L e]: R L E V el

Function Sets or queries the reference level of the main

scale of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

Syntax

R L E Vel<ws p> < N Rf>[ D B M|W]

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

RLEVe l?

<NRf> = Reference level [dB|W] Example

:DIS P L A Y:T R A CE:Y 1: R LE V E L? ->

Description • When the unit is omitted in the parameter, the

• If the setting condition of the LOG/linear mode

• This is a sequential command.

:DISPLAY:TRACE:Y1:RLEVEL -30dbm

-3.00000000E+001

reference level is set in dBm if the main scale of the level axis is in the LOG mode or is set in W if it is in the linear mode.

of the level axis’ main scale does not match the unit specified in the parameter of the command, the parameter of this command is translated matching the LOG/linear mode of the main scale. For example, when the main scale is LOG and you set the reference level to 1m with this command, the reference level is set to 0 dB.

:D I S P l a y [:W I N D o w ]:T R A C e :Y 1[: S C A L e]: R P O S i tion

Function Sets or queries the position of the reference level

of the main scale of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

Syntax

RPOSition<wsp><integer>[DIV]

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

RPOSition?

<integer> = Position of the reference level Example

:DISPLAY:TRACE:Y1:RPOSITION? -> 10

Description • If a value greater than the number of display

• This is a sequential command.

:DISPL AY:TRACE:Y1:RPOSITION 10DIV

divisions of the level axis is specified for the position of the reference level, the position of this level is treated as the top of the scale.

Commands

:D I S P l a y [:W I N D o w ]:T R A C e :Y 1[: S C A L e]: S P A C i ng

Function Sets or queries the scale mode of the main scale

Syntax

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

LOGarithmic = LOG scale LINear = Linear scale Response 0 = LOGarithmic, 1 = LINear Example

:DISPLAY:TR ACE:Y1:SPACING? -> 1

Description This is a sequential command.

of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

SPACing<wsp>LOGarighmic|LINear|0|1

SPACing?

:DISPLAY:TRACE:Y1:SPACING LINIER

IM AQ6380-17EN

5-41

Page 75

5.5 DISPlay Group

:D I S P l a y [:W I N D o w ]:T R A C e :Y 1[: S C A L e]: U N I T

Function Sets or queries the units of the main scale of the

level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]: U N I T

Syntax

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

UNIT?

DBM = dBm W = W DBM/NM = dBm/nm or dBm/THz W/NM = W/nm or W/THz Response 0 = dBm 1 = W 2 = DBM/NM 3 = W/NM Example

:DISPLAY:TR ACE:Y1:UNIT? -> 2

Description This is a sequential command.

:DISP L A Y:TR AC E:Y 1:U NIT D B M /N M

:D I S P l a y [:W I N D o w ]:T R A C e :Y 2[: S C A L e ]: A U T O

Function Sets or queries the automatic setting function of

the sub scale of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]: A U T O

Syntax

<ws p> O F F|ON|0|1

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

AUT O?

Response 0 = OFF, 1 = ON Example

:DISPLAY:TRACE:Y2:AUTO? -> 1

Description This is a sequential command.

:DISPLAY:TR ACE:Y2:AUTO ON

:DISPlay[:WINDow]:TRACe:Y2[:SCALe]:LENG th

Function Sets or queries the parameter of the optical fiber

length used when the unit of the subscale of the level axis is dB/km.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

Syntax

LENGth<wsp><NRf>[KM]

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

LE NGt h?

<NRf> = Length of optical fiber [km] Example

:DISPLAY:TRACE:Y2:LENGTH?->

Explanation • When the unit of the subscale is set to other

• This is a sequential command.

:DISPLAY:TRACE:Y2:LENGTH 99.999K M

+9.99990000E+001

than “dB/km”, an execution error occurs.

:D I S P l a y [:W I N D o w ]:T R A C e :Y 2[: S C A L e ]: O L E V el

Function Sets or queries the offset level of the sub scale of

the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

Syntax

OLEVel<wsp><NRf>[DB|DB/KM]

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

OL E Vel?

<NRf> = Offset level [dB|dB/km] Example

:DISPLAY:TR ACE:Y2:OLEVEL? ->

Description • When the unit of the subscale is set to other

• If the unit is not specified in the parameter, dB

• If a unit different from the current set unit (:DIS

• This is a sequential command.

:DISPLAY:TRACE:Y2:OLEV EL 10DB

+1.00000000E+001

than “dB” or “dB/km”, an execution error occurs.

is set if the subscale of the level axis is in the dB mode or dB/km is set if it is in the dB/km mode.

Play[:WINDow]:TRACe:Y2[:SCALe]:UNIT) of the subscale is specified, an execution error occurs.

:DISPlay[:WINDow]:TRACe:Y2[:SCALe]:PDIVi sion

Function Sets or queries the sub scale of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

Syntax

PDIVision<wsp><NRf>[DB|DB/KM|%]

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

PDIVision?

<NRf> = Level scale [dB|%] Example

:DIS PL AY:TR A C E:Y2:P DI V I SION? ->

Description • If the unit is not specified in the parameter, the

• If a unit different from the current set unit (:DI

• This is a sequential command.

:DISPL AY:TRACE:Y2:PDI VISION 5.0%

+5.00000000E+000

set unit of the subscale of the level axis is used as the set unit of this parameter.

SPlay[:WINDow]:TRACe:Y2[:SCALe]:UNIT) of the subscale is specified, an execution error occurs.

5-42

IM AQ6380-17EN

Page 76

5.5 DISPlay Group

:D I S P l a y [:W I N D o w ]:T R A C e :Y 2[: S C A L e ]: R P O S i tion

Function Sets or queries the position of the reference level

of the sub scale of the level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

Syntax

RPOSition<wsp><integer>[DIV]

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

RPOSition?

<integer> = Position of the reference level Example

:DISPLAY:TRACE:Y2:RPOSITION? -> 10

Description • If a value greater than the number of display

• This is a sequential command.

:DISPL AY:TRACE:Y2:RPOSITIO N 10DIV

divisions of the level axis is specified for the position of the reference level, the position of this level is treated as the top of the scale.

:D I S P l a y [:W I N D o w ]:T R A C e :Y 2[: S C A L e ]: S M I N i mum

Function Sets or queries the value of the bottom of the

scale applied when the subscale of the level axis is set to the linear or % mode.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

Syntax

SMINimu m<wsp><NRf>[%]

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

SMINi mum?

<NRf> = Value of the bottom of the scale [%] Example

:DISPLAY:TR ACE:Y2:SMINIMUM? ->

Description • If the unit is not specified in the parameter, the

• If a unit different from the current set unit (:DI

• This is a sequential command.

:DISPLAY:TRACE:Y2:SMINIMUM 0%

+0.00000000E+000

set unit of the subscale of the level axis is used as the set unit of this parameter.

SPlay[:WINDow]:TRACe:Y2[:SCALe]:UNIT) of the subscale is specified, an execution error occurs.

:D I S P l a y [:W I N D o w ]:T R A C e :Y 2[: S C A L e ]: U N I T

Function Sets or queries the units of the sub scale of the

level axis.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]: U N I T

Syntax

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

UNIT?

<unit> = Units DB = dB display LINear = Linear display DB/KM = dB/km display % = % display Response 0 = DB 1 = LINear 2 = DB/KM 3 = % Example

:DISPLAY:TR ACE:Y2:UNIT? -> 0

Description This is a sequential command.

:DISP L A Y:TR AC E:Y 2:U N IT D B

:D I S P l a y [:W I N D o w ]:T R A C e :Y 1[: S C A L e]:I N I T i alize

Function Initializes the display zoom condition of the main

level scale.

:D I S P l a y[:W I N D o w]:T R A C e :Y 1[:S C A L e ]:

Syntax

INITialize

Example Description • A execution error will occur if the main scale is

• This is a sequential command.

:DI SPL AY:T R AC E:Y1:I N I T I A LI Z E

not displayed.

:D I S P l a y [:W I N D o w ]:T R A C e :Y 2[: S C A L e ]: I N I T i alize

Function Initializes the display zoom condition of the sub

level scale.

:D I S P l a y[:W I N D o w]:T R A C e :Y 2 [: S C A L e ]:

Syntax

INITialize

Example Description • A execution error will occur if the sub scale is

• This is a sequential command.

:DISPLAY:TR ACE:Y2:INITIALIZE

not displayed.

Commands

IM AQ6380-17EN

5-43

Page 77

5.6 FORMat Group

:FO R M at[:DATA]

Function Sets or queries the format used for data transfer.

:FOR M at[:DA T A]< w s p > R E A L[,64|,32]|ASC i i

Syntax

:FOR M at[:DATA]?

ASCii = ASCII format (default) REAL[,64] = REAL format (64bits) REAL,32 = REAL format (32bits) Example

FORM AT:DATA? -> REAL,64

FORM AT:DATA REAL,32 FORM AT:DATA? ->

FORM AT:DATA ASCII

FORM AT:DATA? -> ASCII

Description • When the format is set to REAL (binary) using

:CALCulate:DATA:CGAin? :CALCulate:DATA:CNF? :CALCulate:DATA:CPOWers? :CALCulate:DATA:CSNR? :CALCulate:DATA:CWAVelengths? :TRACe[:DATA]:X? :TRACe[:DATA]:Y?

• The default is ASCII mode.

• When the *RST command is executed, the

• The ASCII format outputs a list of numerics

Example: 12345,12345,....

• By default, the REAL format outputs data in

• If “REAL,32” is specified in the parameter, data

• The fixed length block is defined by IEEE

E.g.: #18 [eight <byte data>] #280[80 <byte data>] #48008[8008 <byte data>]

• For data output in the 32-bit floating-point

• This is a sequential command.

FORMAT:DATA REAL,64

R E A L,32

this command, the output data of the following commands are produced in the REAL format.

format is reset to the ASCII mode.

each of which is delimited by a comma (,).

fixed length blocks of 64 bits, floating-point binary numerics.

is output in the 32-bit, floating-point binary form.

488.2 and consists of “#” (ASCII), one numeric (ASCII) indicating the number of bytes that specifies the length after #, length designation (ASCII), and binary data of a specified length in this order. Binary data consists of a floatingpoint data string of 8 bytes (64 bits) or 4 bytes (32 bits). Floating-point data consists of lowerorder bytes to higher-order bytes.

binary form, cancellation of significant digits is more likely to occur in comparison with transfer of data in the 64-bit, floating-point binary form.

5-44

IM AQ6380-17EN

Page 78

5.7 INITiate Group

:I N ITi at e[:IM M e d i a t e]

Function Makes a sweep.

:INITiate[:IMMediate]

Syntax Example Description • You can stop sweep with the :ABORt

• The sweep mode (AUTO, SINGLE, or

• If this command is executed while the sweep

:INIT I A T E

command.

REPEAT) is set using the :INITiate:SMODe command.

mode is in REPEAT (:INITiate:SMODe REPeat), the operation of the command is complete at the instant a sweep starts. In this case, this command is regarded as a sequential command.

mode is one of AUTO and SINGLE, the operation of the command is complete at the instant a sweep ends. In this case, this command is regarded as a command subject to overlapping.

Commands

:INITiate:SMODe

Function Sets or queries the sweep mode.

:INITiate:SMODe<wsp><sweep m od e>

Syntax

:INITiate:SMODe?

<sweep mode> = Sweep mode SINGle = SINGLE sweep mode REPeat = REPEAT sweep mode AUTO = AUTO sweep mode Response 1 = SINGle 2 = REPeat 3 = AUTO Example

:INITIATE:SMODE? -> 2

Description This is a sequential command.

:INITIATE:SMODE REPEAT

IM AQ6380-17EN

5-45

Page 79

5.8 MMEMory Group

Common Items

• To include a directory name in <"filename">, specify the path in the following manner.

• Specification of an absolute path When the head of <"file name"> is character “\”, specify the absolute path.

• Relative path specification When the head of <"file name"> is any character other than “\”, specify the relative path from the current directory. The current directory is specified using the :MMEMory:CDIRectory command.

• If INTernal|EXTernal is not specified, access is made to the current drive. The current drive is specified using the :MMEMory:CDRive command.

• If a file name extension is omitted when storing a file, an extension corresponding to the data type will be appended to the file name.

• When loading a file, the file name extension can be omitted.

:MMEMory:ANAMe

Function Sets or queries the naming rule for automatic file

names.

:MMEMory:ANAMe<wsp>NUMBer|DATE|0|1

Syntax

:MMEMory:ANAMe?

NUMBer|0 Number DATE|1 Timestamp Example

:MMEMORY:ANAME? -> 1

Description This is a sequential command.

:MMEMORY:ANAME DATE

:MMEMory:CATalog?

Function Queries a list of all files in the current directory.

:MMEMory:CATalog?<wsp>[INTernal|

Syntax

EXTernal][,<directory name>]

INTernal = Acquires a file list in the current

directory of the internal memory.

EXTernal = Acquires a file list in the current

directory of the external USB storage. directory name = Default name Response <free size>,<file number>,<file

name>,<file name>, … ,<file name>

<free size> = <NRf> Disk’s free size [KB]

(1KB=1024 bytes)) <file number>= <integer> number of files <file name> = File name Example

-> +1.91176800E+006,2,

Description This is a sequential command.

:MMEMory:CDIRectory Function Sets or queries the current directory. Syntax :MMEMory:CDIRectory<wsp><directory name> :MMEMory:CDIRectory? <directory name> = Directory name to be changed Example :MMEMORY:CDIRECTORY "\test\sample" :MMEMORY:CDIRECTORY? -> \test\sample Description This is a sequential command.

:MMEMORY:CATALOG? INTERNAL,"\TEST\

SAMPLE"

test0001.w v6,test0002.wv6

:MMEMory:CDRive

Function Sets or queries the current drive.

:MMEMory:CDRive<wsp>INTernal|

Syntax

EXTernal

:MMEMory:CDRive?

INTernal = Makes the current drive the internal

memory.

EXTernal = Makes the current drive the external

USB storage.

Example

:MMEMORY:CDRIVE -> INT

Description This is a sequential command.

:MMEMORY:CDRIVE INTERNAL

:M M E M o r y:C O P Y

Function Copies a specified file.

:MMEMory:COPY<wsp>

Syntax

<"source file name">,INTernal|

EXTer nal,<"destin ation file name">

[,INTe r n al| E X T e r n a l]

<"source file name"> = File name at the copy

source

<"destination file name"> = File name at the copy

destination

Example

Description This is a sequential command.

:MMEMORY:COPY "test001.wxa",INTERNAL,

"t est002.w x a"

:M M E M o r y:DATA?

Function Queries the data in the specified file.

:M M E M or y:DATA?<wsp> <"file na m e">

Syntax

[,INTe r n al| E X T e r n a l]

<"file name">= Name of the file to be read Response The data that was read (binary block

data of fixed length starting with “#”)

Example

Description • Maximum file size that can be sent is 4 MB.

• For the data format of the fixed length blocks,

• This is a sequential command.

:MMEMORY:DATA? "test.csv",internal ->

#18ABCDEFGH

see :FORMat Command.

5-46

IM AQ6380-17EN

Page 80

5.9 MMEMory Group

:MMEMory:DELete

Function Deletes a specified file.

:M M EMory:DEL ete<wsp><"file n a me">

Syntax

[,INTe r n al|E X T e r n a l]

<"file name"> = Name of a file to be deleted Example

Description This is a sequential command.

:M MEM ORY:DE L ETE "t est002.w x a",

internal

:MMEMory:LOAD:ATRace

Function Loads the specified waveform files (all traces)

into traces.

:MMEMory:LOAD:ATRace<wsp>

Syntax

<”file name”> [,INTernal|EXTernal]

<"file name"> = Name of file to load INTernal|EXTernal = Source drive for loading Example:

Description This is a sequential command.

MMEMORY:LOAD:ATRACE "test001.csv",

internal

:MMEMory:LOAD:DLOGging

Function Loads the specified data logging file.

:MMEMory:LOAD:DLOGging<wsp><"filenam

Syntax

e" >[,I N T e r n a l|E XTer n a l]

<"filename"> = Name of the file to load INTernal|EXTernal = Source drive to load from Example

Description • This command is invalid when data logging is

• This is a sequential command.

:M M E M O RY:L O A D:

DLOGGING "test001.LG8",INTERNAL

in progress.

:MMEMory:LOAD:PROGram

Function Loads a specified program file into a specified

program number.

:MMEMory:LOAD:PROGra m<wsp><integer>,<

Syntax

"file name">[,INTernal|EXTernal]

<trace name> = Number of the program into

which a file is loaded <"file name"> = Name of a file to be loaded INTernal|EXTernal = Drive of source file to be

loaded

Example

Explanation This is a sequential command.

M M E M O R Y:L OA D:

PROGRAM 1,"test001.pg6",INTERNAL

:MMEMory:LOAD:TRACe

Function Loads a specified waveform file into a specified

trace.

:MMEMory:LOAD:TRACe<wsp>

Syntax

[,INTe r n al|E X T e r n a l]

<trace name> = Trace to be loaded <"file name"> = Name of file to be loaded INTernal|EXTernal = Drive of source file to load Example

Description This is a sequential command.

:MMEMORY:LOAD:TRACE TRA,"test001.

wxa",INTERNAL

:M M EM or y:M DIR ect or y

Function Creates a new directory.

:MMEMory:MDIRectory<wsp><"directory

Syntax

name">[,INTernal|EXTernal]

<directory name> = Directory name to be created INTernal|EXTernal = Destination drive for created

5.9 SENSe Group

:SENS e:AV ER ag e:C OU N t

Function Sets or queries the number of times averaging for

each measured point.

:SENSe:AVERage:COUNt<wsp><integer>

Syntax

:SE NSe:AVERage:C OU Nt?

<integer> = Number of times averaging Example:

:SENSE:AVERAGE:COUNT? -> 100

Description This is a sequential command.

:SENSE:AVERAGE:COUNT 100

:SE NSe:B A N D widt h|:BWIDt h[:R E S o lut i o n]

Function Sets or queries the measurment resolution.

:SENS e:BANDwidth|:BWIDth[:R ESo lu tio n]<

Syntax

ws p > < NR f >[ M|Hz]

:SENS e:BANDwidth|:BWIDth

[:R E S o l u t i o n]?

<NRf> = Measurement resolution [m|Hz] Response <NRf>[m|Hz] Example

:SENSE:BANDWIDTH? -> +1.50000000E-013

Description • This is a sequential command.

• If the unit is omitted, the value is set using the

• If the custom resolution function

• If the custom resolution function is off, the

The instrument’s preset resolutions are 0.05

:SENS E:BANDW IDT H:R ESOLU TION 1.5N M

display unit set on the instrument.

(:SENSE:BANDWIDTH:CUSTOM) is on, the resolution can be set to any value.

resolution is rounded to the closest preset resolution.

nm, 0.01 nm, 0.02 nm, 0.05 nm, 0.1 nm, 0.2 nm, 0.5 nm, 1 nm, and 2 nm.

:SE NSe:B A N D widt h|:BWIDt h[:R E S o lut i o n]:C USTom[:STATe]

Function Sets or queries the on/off status of the custom

resolution function.

:SENS e:BANDwidth|:BWIDth[:R ESo lu tio n]:

Syntax

C U S T o m[:ST A T e]< w s p > 0|1|O F F|O N

:SENS e:BANDwidth|:BWIDth[:R ESo lu tio n]:

CUS Tom[:STAT e]?

0|OFF: The custom resolution function is turned

off.

1|ON: The custom resolution function is turned

on.

Example

:SENSE:BANDWIDTH:CUSTOM? -> 0

Description This is a sequential command.

:SENSE:BAND W ID TH:R ESOLU TIO N:CUSTOM:

STATE ON

:SENSe:CHOPper

Function Sets or queries chopper mode.

:SENSe:CHOPper<wsp>OFF|SWITch|0|2

Syntax

:SE N S e:C H OPp e r?

Response 0 = OFF, 2 = SWITCH Example

:SENSE:CHOPPER? -> 2

Description • When the measurement sensitivity setting

• This is a sequential command.

:SENSE:CHOPPER SWITCH

(:SENSe:SENSe command) is NORMAL HOLD or NORMAL AUTO, RAPID1, RAPID2, RAPID3, Chopper does not function even if chopper mode is turned on with this command.

:SE N Se:C O R R e ct i o n:L E Ve l:S HIFt

Function Sets or queries the offset value for the level.

:SE N S e:C O R R e c t ion:L E Vel:SHI F t< w s p>

Syntax

<N R f >[DB]

:SE N S e:C O R R e c t ion:L E Vel:SHI F t?

<NRf> = Level offset value [dB] Example

:SENSE:CORRECTION:LEVEL:SHIFT?->

Description This is a sequential command.

:SENSE:CORRECTION:LEVEL:SHIFT 0.2DB

+2.00000000E-001

:SENSe:CORRection:RVELocity:MEDium

Function Sets or queries whether air or vacuum is used as

the wavelength reference.

:SENSe:CORRection:RVELocity:MEDium

Syntax

<ws p>AIR|V ACu u m|0|1

:SENSe:CORRection:RVELocity:MEDium?

AIR = Air is assumed to be the reference. VACuum = Vacuum is assumed to be the

reference. Response 0 = AIR 1 = VACuum Example

:SENSE:CORRECTION:RVELOCITY:MEDIUM?->

Description This is a sequential command.

:SENSE:CORRECTION:RVELOCITY:

MEDIUM VACUUM

5-50

IM AQ6380-17EN

Page 84

5.10 SENSe Group

:SE N Se:C O R R e ct i o n:W AV e le n g t h:S HIFt

Function Sets or queries the offset value for the

levelwavelength.

:SE N S e:C O R R e c t ion:W AV e leng t h:S HIF t

Syntax

<w s p> <N R f >[M]

:SE N S e:C O R R e c t ion:W AV e leng t h:S HIF t?

<NRf>= Wavelength offset value [m] Example

:SENSE:CORRECTION:WANELENGTH:SHIFT?->

Description This is a sequential command.

:SENSE:CORRECTION:WANELENGTH:

SH I F T 0.0 5 N M

+5.00000000E-011

:SE N Se:S E NS e

Function Sets or queries the measurement sensitivity.

:SENSe:SENSe<wsp><sense>

Syntax

:SE N S e:S ENSe?

<sense>= Sensitivity setting parameters NHLD = NORMAL HOLD NAUT = NORMAL AUTO NORMal = NORMAL MID = MID HIGH1 = HIGH1 or HIGH1 HIGH2 = HIGH2 or HIGH2 HIGH3 = HIGH3 or HIGH3 RAPID1=RAPID1 RAPID2=RAPID2 RAPID3=RAPID3 RAPID4=RAPID4 RAPID5=RAPID5 RAPID6=RAPID6 Response 0 = NHLD 1 = NAUT 2 = MID 3 = HIGH1 4 = HIGH2 5 = HIGH3 6 = NORMAL 7=RAPID1 8=RAPID2 9=RAPID3 10=RAPID4 11=RAPID5 12=RAPID6 Example

:SENSE:SENSE? -> 2

Description This is a sequential command.

:SENSE:SENSE MID

:SE N Se:S E NS e:L E V e l

Function Sets or queries the sensitivity based on the

sensitivity level you want to measure at.

:SENSe:SENSe:LEVel<wsp><nrf>[DBM]

Syntax

:SENSe:SENSe:LEVel?

Example

:SENSE:SENSE:LEVEL? ->

Description • By setting the sensitivity level that you want to

If the current sensitivity is set to RAPID (RAPID1

If the current sensitivity is set to TRADITIONAL

• This is a sequential command.

:SENSE:SENSE:LEVEL -55DBM

-5.50000000E-001

measure at, the sensitivity closest to that level is automatically selected.

to RAPID6), the most suitable sensitivity is selected from these options.

(not RAPID), the sensitivity is automatically selected from the TRADITIONAL options, and SPEED is also automatically selected.

:SE N Se:S E T Ti n g:S M O ot h i n g

Function Sets or queries the Smoothing function.

:SE N S e:S ETT i n g:SMOot hing<w s p > OFF|

Syntax

ON|0|1

:SE N S e:S ETT i n g:SMOot hing?

Response 0 = OFF, 1 = ON Example

:S E N SE:SET TING:SMOoth i n g? -> 1

Description This is a sequential command.

:SEN S E:SETT I NG:S M O o t h i n g O N

:SE N Se:S W E e p:P OI Nt s

Function Sets or queries the number of samples measured.

:SE N S e:S W E e p:POINt s <ws p><int e g e r >

Syntax

:SE N S e:S W E e p:POINt s?

<integer> = The number of samples to be

measured

Example

:S E N S E:S W E E P:P OIN TS? -> 200 01

Description • When the function of automatically setting

• When the function of automatically setting

• When the sampling number to be measured is

• This is a sequential command.

:SEN S E:S W E E P:P OI N TS 20001

the sampling number to be measured (:SENSe:SWEep:POINts:AUTO command) is ON, the sampling number to be measured that has been set can be queried.

the sampling number to be measured (:SENSe:SWEep:POINts:AUTO command) is ON, this command will be automatically set to OFF.

set using this command, the sampling intervals for measurements (:SENSe:SWEep:STEP) will be automatically set.

Commands

IM AQ6380-17EN

5-51

Page 85

5.10 SENSe Group

:SENSe:SWEep:POINts:AUTO

Function Sets or queries the function of automatically

setting the sampling number to be measured.

:SENSe:SWEep:POINts:AUTO<wsp>OFF|

Syntax

ON|0|1

:SE N S e:S W E e p:POINt s:AUTO ?

Response 0 = OFF, 1 = ON Example

:S E N S E:S W E E P:P OIN TS:A U T O? -> 1

Description • When the capability to automatically set the

• This is a sequential command.

:SEN S E:S W E E P:P OI N TS:AU TO ON

sampling number to be measured is set to ON using this command, the sampling number to be measured and the sampling intervals for measurements (:SENSe:SWEep:STEP) will be automatically set.

:SE N Se:S W E e p:S P E e d

Function Sets or queries the sweep speed.

:SE N S e:S W E e p:SPEe d<wsp>1 x|2x|0|1

Syntax

:SE N S e:S W E e p:SPEe d?

1x|0: Standard 2x|1: Twice as fast as standard Response 0 = 1x, 1 = 2x Example

:S E N SE:SW E EP:SP E ED? -> 1

Description This is a sequential command.

:SEN S E:S W E E P:SPE E D 2x

:SE N Se:S W E e p:S T EP

Function Sets or queries the sampling interval for

measurements.

:SE N S e:S W E e p:ST EP<w s p> < N R f>[M]

Syntax

:SE N S e:S W E e p:ST EP?

<NRf> = The sampling interval for measurement

[m]

Example

:SENSE:SWEEP:STEP?-> +1.00000000E-012

Description • When the function of automatically setting

• When the function of automatically setting

• When the sampling interval for measurement is

• This is a sequential command.

:SEN S E:S W E E P:STEP 1PM

the sampling interval for measurement (:SENSe:SWEep:POINts:AUTO command) is ON, the sampling number to be measured that has been set can be queried.

the sampling number to be measured (:SENSe:SWEep:POINts:AUTO command) is ON, this command will be automatically set to OFF.

set using this command, the sampling intervals for measurements (:SENSe:SWEep:POINts) will be automatically set.

:SE N Se:S W E e p:T I M E:0 N M

Function Sets or queries the time taken from the start to

the end of measurements when measurement is

made in the 0-nm sweep mode.

:SE N S e:S W E e p:TI M E:0N M< w s p >

Syntax

[SEC]

:SE N S e:S W E e p:TI M E:0N M?

<integer> = Measurement time [sec] (0 =

MINIMUM)

Example

:S E N SE:SW E EP:TI M E:0N M? -> 10

Description This is a sequential command.

:SENSE:SWEEP:TIME:0NM 10SEC

:SE N Se:S W E e p:T I M E:I N Te r v a l

Function Sets or queries the time taken from the start of

a sweep to that of the next sweep when repeat

sweeps are made.

:SE N S e:S W E e p:TI M E:IN T e r v a l<w s p >

Syntax

<integer>[SEC]

:SE N S e:S W E e p:TI M E:IN T e r v a l?

<integer> = Measurement time [sec] (0 =

MINIMUM)

Example

:SENSE:SWEEP:TIME:INTERVAL? -> 100

Description This is a sequential command.

:SENSE:SWEEP:TIME:INTERVAL 100sec

:SENSe:WAVelength:CENTer

Function Sets or queries the measurement condition

center wavelength.

:SENSe:WAVelength:CENTer<wsp><NRf>[M|

Syntax

HZ]

:SENSe:WAVelength:CENTer?

<NRf> = Measurement center wavelength [m] Response <NRf>[m|Hz] Example

:SENSE:WAVELENGTH:CENTER?->

Description This is a sequential command.

:SENSE:WAVELENGTH:CENTER 1550.000NM

+1.55000000E-006

:SE N Se:W A V e l e n g t h:S P A N

Function Sets or queries the measurement condition

measurement span.

:SENSe:WAVelengthSPAN<wsp><NRf>

Syntax

[M|HZ]

:SE N S e:W AV e leng t h:S PA N?

<NRf> = Measurement span [m] Response <NRf>[m|Hz] Example

:SENSE:WAVELENGTH:SPAN?->

Description This is a sequential command.

:SENSE:WAVELENGTH:SPAN 20.0NM

+2.00000000E-008

5-52

IM AQ6380-17EN

Page 86

:SE N Se:W A V e l e n g t h:S R A N g e

Function Sets or queries whether to limit a sweep range to

the spacing between line markers L1 and L2.

:SENSe:WAVelength:SRANge<wsp>OFF|

Syntax

ON|0|1

:SE N S e:W AV e leng t h:S R A N g e?

Response 0 = OFF, 1 = ON Example

:SENSE:WAVELENGTH:SRANGE? -> 1

Description This is a sequential command.

:SENSE:WAVELENGTH:SRANGE ON

:SE N Se:W A V e l e n g t h:S T A R t

Function Sets or queries the measurement condition

measurement start wavelength.

:SENSe:WAVelength:STARt<wsp><NRf>

Syntax

[M|HZ]

:SE N S e:W AV e leng t h:S TA R t?

<NRf>=Measurement center wavelength [m] Response <NRf> [m|Hz] Example

:SENSE:WAVELENGTH:START?->

Description This is a sequential command.

:SENSE:WAVELENGTH:START 1540.000NM

+1.54000000E-006

5.10 SENSe Group

Commands

:SE N Se:W A V e l e n g t h:S T OP

Function Sets or queries the measurement condition

measurement stop wavelength.

:SENSe:WAVelengthSTOP<wsp><NRf>

Syntax

[M|HZ]

:SE N S e:W AV e leng t h:S T OP?

<NRf> = Measurement stop wavelength [m] Response <NRf> [m|Hz] Example

:SENSE:WAVELENGTH:STOP?->

Description This is a sequential command.

:SENSE:WAVELENGTH:STOP 1560.000NM

+1.56000000E-006

IM AQ6380-17EN

5-53

Page 87

5.10 STATus Group

:STATus:OPERation:CONDition?

Function Queries the contents of the operation status

condition register.

:STATus:OPERation:CONDiton?

Syntax Example Description This is a sequential command.

:STATUS:OPERATION:CONDITION? -> 1

:ST A T u s:OP E R at io n:ENA Ble

Function Queries the contents of the operation status

Enable register.

:STATus:OPERation:ENABle<wsp>

Syntax

:STATus:OPERation:ENABle?

<integer> = Contents of the operation status

enable register

Example

:STATUS:OPERATION:ENABLE? -> 8

Description This is a sequential command.

:STATUS:OPERATION:ENABLE 8

:ST A T u s:OP E R at io n[:EV E Nt]?

Function Queries the contents of the operation status

Event register.

:STATus:OPERation[:EVENt]?

Syntax Example Description This is a sequential command.

:STATUS:OPERATION? -> 1

:STATus:QUEStionable:ENABle

Function Reads the contents of the questionable status

enable register or writes data to this register.

:STATus:QUEStiona ble:ENABle<wsp>

Syntax

:STATus:QUEStiona ble:ENABle?

<integer> = Contents of the questionable status

enable register

Example

:STATUS:QUESTIONABLE:ENABLE? -> 8

Description This is a sequential command.

:STATUS:QUESTIONA BLE:ENABLE 8

:ST A T u s:QUESt io n a bl e[:EV ENt]?

Function Reads the contents of the questionable status

event register.

:ST AT u s:Q U E Stio n a bl e[:EV ENt]?

Syntax Example Description This is a sequential command.

:STATUS:QUESTIONA BLE? -> 1

:STA T u s:PR E S et

Function Clears the event register and sets all bits of the

enable register.

:STATus:PRESet

Syntax Example Description • When this command is executed, the registers

• The operation status event register is cleared

• All bits of the operation status enable register

• The questionable status event register is

• All bits of the questionable status enable

• Even when this command is executed, the

• This is a sequential command.

:STATUS:PRESET

will be affected as follows.

to “0.”

are set to “0.”

cleared to “0.”

standard event status register and standard event status enable register do not change.

:STATus:QUEStiona ble:CONDition?

Function Queries the contents of the qestionable status

condition register.

:STATus:QUEStionable:CONDiton?

Syntax Example Description This is a sequential command.

:STATUS:QUESTIONA BLE:CONDITION? -> 1

5-54

IM AQ6380-17EN

Page 88

5.11 SYStem Group

:SYSTe m:BUZZer:CLICk

Function Sets or queries whether to sound the buzzer

when clicked the key.

:SYS T e m:BUZZer:CLIC k<w s p > O F F|O N|0|1

Syntax

:SYSTem:BUZZer:CLICk?

Response 0 = OFF, 1 = ON Example

:SYSTEM:BUZZER:CLICK? -> 1

Description This is a sequential command.

:SYSTEM:BUZZER:CLICK ON

:SYSTe m:BUZZer:WARNing

Function Sets or queries whether to sound the buzzer

during an alarm.

:SYSTem:BUZZer:WARNing<wsp>OFF|ON|

Syntax

0|1

:SYSTem:BUZZer:WARNing?

Response 0 = OFF, 1 = ON Example

:SYSTEM:BUZZER:WAR NING? -> 1

Description This is a sequential command.

:SYSTEM:BUZZER:WARNING ON

:SY STe m:C O M M u nic a t e:CFOR m at

Function Sets or queries the command format of this unit.

:SYS Tem:COM M u n ic a te:CF OR m a t<ws p >

Syntax

<mode>

:SYS Tem:COM M u n ic a te:CF OR m a t?

<mode> = Command format AQ6317 = AQ6317 compatible mode AQ6380 = AQ6380 mode Response 0 = AQ6317, 1 = AQ6380 Example

:SYSTEM:COMMUNICATE:CFORMAT? -> 1

Description • This command is valid when in AQ6380 mode.

• To set the command format while this unit

Control command CFORM* (*: 0 = AQ6317 compatible mode,

Query command CFORM? (return value: 0 = AQ6317-

• To use a command to place this unit into the

:SYSTem:COMMunicate:CFORmat<wsp>

• To use a command to place this unit into

CFORM1

• This is a sequential command.

:SYSTEM:COMMUNICATE:CFORMAT AQ6380

This command results in an error when in AQ6317 compatible mode.

is in the AQ6317-compatible mode, use the following commands.

1 = AQ6380 mode)

compatible mode, 1 = AQ6380 mode)

AQ6317-compatible mode, regardless of the status during execution of the command, execute the following command. Note that if this unit has already been in the AQ6317compatible mode at the time of executing this command, a command error occurs, but you can ignore it.

AQ6317

the AQ6380 mode, regardless of the status during execution of the command, execute the following command. Note that if this unit has already been in the AQ6380 mode at the time of executing this command, a command error occurs, but you can ignore it.

Commands

IM AQ6380-17EN

5-55

Page 89

5.12 SYStem Group

:SYSTe m:COM M unicate:LOCKout

Function Sets/cancels local lockout.

:SYSTe m:C O M Mu n icat e:LOCKo u t< w s p >

Syntax

OF F|O N|0|1

:SYSTe m:C O M Mu n icat e:LOCKo u t?

OFF|0: Cancels local lockout ON|1: Sets local lockout Example

:SYSTEM:COMMUNICATE:LOCKOUT? -> 0

Description • This command is valid when the remote

• During local lockout, if the Ethernet connection

• This is a sequential command.

:SYSTEM:COMMUNICATE:LOCKOUT OFF

interface is the Ethernet interface. An interface message is available for the GP-IB interface.

is lost, the instrument switches to local mode, regardless of the local lockout status.

:SYSTe m:COM M unicate:RMONitor

Function Sets or queries whether the remote monitor

function is enabled.

:SYSTem:COMMunicate:RMONitor<wsp>

Syntax

OF F|O N|0|1

:SYSTem:COMMunicate:R MONitor?

OFF|0: Disables the remote monitor function ON|1: Enables the remote monitor function Example

:SYSTEM:COM MUNICATE:RMONITOR? -> 0

Description This is a sequential command.

:SYSTEM:COMMUNICATE:RMONITOR OFF

:SYSTe m:DATE

Function Sets or queries the system data.

:S Y S Te m:D AT E < w s p> < y e a r >,< m o n t h >,< d a y >

Syntax

:SYSTe m:D ATE?

<year> = Year <month> = Month <day> = Day Example

:SYSTE M:DATE? -> 2021,10,01

Description This is a sequential command.

:SYSTEM:DATE 2021,10,01

:SYSTe m:DISPlay:U NCal

Function Sets or queries whether to display an alarm

message in the event of UNCAL.

:SYS T e m:DI SPl a y:U N C al<w s p > OF F|O N|0|1

Syntax

:SYSTem:DISPlay:UNCal?

Response 0 = OFF, 1 = ON Example

:SYSTEM:DISPLAY:UNCAL? -> 0

Description This is a sequential command.

:S Y S T E M:DI S P L AY:U NC A L OF F

:SYSTe m:GRID

Function Sets or queries the instrument’s grid setting.

:SYSTem:GRID<wsp><grid>

Syntax

:SYSTe m:G R ID?

<grid> = Grid setting

12.5 GHZ = 12.5 GHz Spacing 25 GHZ = 25 GHz Spacing 50 GHZ = 50 GHz Spacing 100 GHZ = 100 GHz Spacing 200 GHZ = 200 GHz Spacing CUSTom = User setting Response 0 = 12.5GHz 1 = 25GHz 2 = 50GHz 3 = 100GHz 4 = 200GHz 5 = CUSTom Example

:SYSTEM:GRID? -> 2

Description This is a sequential command.

:SY STEM:G R I D 50 G HZ

:SYSTe m:GRID:CUSTom:SPACing

Function Sets or queries the grid spacing of the custom

grid.

:SYSTem:GRID:CUSTom:SPACing<ws p><N Rf>

Syntax

[GHZ]

:SYSTem:GRID:CUSTom:SPACing?

<NRf> = Grid spacing [GHz] Example

:SYSTe m:G R ID:C UST O M:SP ACI N G?->

Description • When :SYSTem:GRID is CUSTom, an

• This is a sequential command.

:SY STe m:G R I D:C U STOM:SPACI N G 12.5

+1.25000000E+001

execution error occurs.

:SYSTe m:GRID:CUSTom:STARt

Function Sets or queries the custom grid start wavelength.

:SYSTem:GRID:CUSTom:STARt<wsp><NRf>

Syntax

[M|HZ]

:SYSTem:GRID:CUSTom:STARt?

<NRf> = Grid start wavelength [m|Hz] Example

:SYSTem:GRID:CUSTOM:START?->

Description • When :SYSTem:GRID is CUSTom, an

• This is a sequential command.

:SYSTem:GRID:CUSTOM:START 1550.000NM

+1.55000000E-006

execution error occurs.

:SYSTe m:ERRor[:NEXT]?

Function Queries data in an error queue and deletes it

from the queue.

:SYSTe m:ERRor[:N EXT]?

Syntax <integer> = Error number Example Description This is a sequential command.

5-56

:SYSTEM:ERROR? -> 100

IM AQ6380-17EN

Page 90

5.12 SYStem Group

:SYSTe m:GRID:CUSTom:STOP

Function Sets or queries the custom grid stop wavelength.

:SYSTem:GRID:CUSTom:STOP<wsp><N Rf>

Syntax

[M|HZ]

:SYSTem:GRID:CUSTom:STOP?

<NRf> = Grid stop wavelength [m|Hz] Example

:SYSTEM:GRID:CUSTOM:STOP?->

Description • When :SYSTem:GRID is something other than

• This is a sequential command.

:SYSTEM:GRID:CUST OM:STOP 1560.000NM

+1.56000000E-006

CUSTom, an execution error occurs.

:SYSTe m:GRID:REFerence

Function Sets or queries the reference frequency of the

instrument’s grid setting.

:SYSTem:GRID:REFerence<wsp><NRf>

Syntax

[HZ]

:SYSTe m:G R ID:R EF ere n c e?

<NRf> = Grid’s reference frequency [Hz] Example

:SYSTEM:GRID:REFERENCE?->

Description This is a sequential command.

:SYSTEM:GRID:REFERENCE 193.1000HZ

+1.93000000E+014

:SYSTe m:INFormation?

Function Queries model-specific information (the model

code and special code)

:SYSTem:INForm ation?<wsp><integer>

Syntax <integer> = The type of instrument specific

information to obtain 0 = MODEL code 1 = SPECIAL code Example

:SYSTEM:INFOR MATION? 1 -> NONE

Description • Outputs model-specific information (the model

• If no SPECIAL mode is present, "NONE" is

• This is a sequential command.

:SYSTEM:INFORMATION? 0 ->

AQ6 3 80-10 -L 1- F C C-D

code and special code)

returned.

:SYSTe m:OLOCk

Function Sets or queries whether keys are locked.

:SYS T e m:OLO C k<w s p > O F F|O N|0|1,

Syntax

<"pa ss word">

:SYSTe m:OLOCk?

OFF = Not locked (release the lock) ON = Locked <"password"> = 4-digit password string The characters that can be used are numbers

from 0 to 9. Response 0=OFF, 1=ON Example

:SYST:OLOC? -> 1

Description This is a sequential command.

:S Y S T :O L O C O N ," 1 234"

:SYSTe m:PRESet

Function Initializes the unit status.

:SY STe m:P R E S e t

Syntax Example Description This is a sequential command.

:SY STEM:P R E S E T

:SYSTe m:TIME

Function Sets or queries the system time.

:S YST e m:TI M E< ws p > < h o u r>,< m i n u te >,

Syntax

:SYSTem:TIME?

<hour> = Hour <minute> = Minute <second> = Second Example

: S Y S T E M:T I M E? -> 2 2,10 ,1

Description This is a sequential command.

:SYST E M:TI M E 22,10,01

:SYSTe m:VERSion?

Function Queries the SCPI compatibility version of this

unit.

:SYSTem:VERSion?

Syntax Example Description This is a sequential command.

:SYSTEM:VER SION? -> 1999.0

Commands

IM AQ6380-17EN

5-57

Page 91

5.12 TRACe Group

:TRACe:ACTive

Function Sets or queries the active trace.

:TRACe:ACTive<wsp><trace na me>

Syntax

:TRACe:ACTive?

<trace name> = Active trace (TRA|TRB|TRC|TRD|TRE|TRF|TRG) Example

:TRACE:ACTIV E? -> TR A

Description This is a sequential command.

:TRACE:ACTIVE TR A

:TRACe:ATTRibute[:<trace name>]

Function Sets or queries the attributes of the specified

trace.

:TRACe:ATTRibute[:<trace na me>]

Syntax

:TRACe:ATTRibute[:<trace na me>]?

<trace name> = trace (TRA|TRB|TRC|TRD|TRE|TRF|TRG) <attribute> = Attribute WRITe = WRITE FIX = FIX MAX = MAX HOLD MIN = MIN HOLD RAVG = ROLL AVG CALC = CALC Response 0 = WRITe 1 = FIX 2 = MAX 3 = MIN 4 = RAVG 5 = CALC Example

:TRACE:ATTRIBUTE:TRA? -> 0

Description • If <trace name> is omitted, the command is

• If <trace name> is specified, the specified trace

• When the attribute is set to a CALC trace, the

• This is a sequential command.

:TRACE:ATTRIBUTE:TRA WRITE

executed with respect to the active trace.

is set as the active trace after the command is exeucted.

expression is set using the :CALCulate: MATH command.

:TRACe:ATTRibute:RAVG[:<trace name>]

Function Sets or queries the number of times for averaging

of the specified trace.

:TR AC e:A TTRibut e:R AVG[:<tr ace

Syntax

name>]<wsp><integer>

:T R AC e:ATTR i bu te:R AV G[:<trac e n a m e>]?

<trace name> = trace (TRA|TRB|TRC|TRD|TRE|TRF|TRG) <integer> = Number of times averaging of ROLL

AVG

Example

:TRACE:ATTRIBUTE:RAVG:TRA? -> 10

Description • When this command is executed, the attribute

• If <trace name> is omitted, the command is

• If <trace name> is specified, the specified trace

• This is a sequential command.

:TRACE:ATTRIBUTE:R AVG:TRA 10

of the set trace goes to ROLL AVG.

executed with respect to the active trace.

is set as the active trace after the command is exeucted.

:TRACe:COPY

Function Copies the data of a specified trace to another

trace.

:TRACe:COPY<wsp><source trace

Syntax

name>,<destination trace name>

<source trace name> = Copy source trace <destination trace name> = Copy trace destination Example Description This is a sequential command.

:TRACE:COPY TRA,TRB

:TRACe[:DATA]:SNUMber?

Function Sets or queries the number of number of data

sampled of the specified trace.

:TR ACe[:DATA]:SNU M ber?<w s p >

Syntax

<trace name> = Trace from which to acquire data Example Description This is a sequential command.

:TRACE:DATA:SNUMBER? -> 50001

5-58

IM AQ6380-17EN

Page 92

5.13 TRACe Group

:TRACe[:DATA]:X?

Function Queries the wavelength axis data of the specified

trace.

:TRACe[:DATA]:X?<wsp><trace name>

Syntax

[,<start point>,<stop point>]

<trace name>= Trace to be transferred (TRA|TRB|TRC|TRD|TRE|TRF|TRG) <start point> = A range of samples to be transferred

(starting point) (1 to 200001) <stop point> = A range of samples to be transferred

(stopping point) (1 to 200001) Example

Description • Data is output in the unit of wavelength value

• If the parameter <start point> or <stop point> is

The number of output data can be acquired by

• Data is output in either ASCII or binary form,

• This is a sequential command.

:TRACE:X? TRA ->

+1.55000000E-006,+1.55001000E-

006,+1.55002000E-006,.....

(m), regardless of whether this unit is in the wavelength mode or in the frequency mode.

omitted, all sampling data of a specified trace will be output.

executing :TRACe[:DATA]:SNUMber?.

depending on the setting of :FORMat[:DATA].

:TRACe[:DATA]:Y?

Function Queries the level axis data of specified trace.

:TRACe[:DATA]:Y?<wsp><trace name>

Syntax

[,<start point>,<stop point>]

<trace name> = Trace to be transferred (TRA|TRB|TRC|TRD|TRE|TRF|TRG) <start point> = A range of samples to be transferred

(starting point) (1 to 200001) <stop point> = A range of samples to be transferred

(stopping point) (1 to 200001) Response

For ASCII data: <NRf>,<NRf>,.....<NRf>

For BINARY data: ’#’<integer><byte num><data byte> Example

Description • The data is output in order of its wavelength

• When the level scale is LOG, data is output in

• When the level scale is Linear, data is output in

• If the parameter <start point> or <stop point> is

The number of output data can be acquired by

• Data is output in either ASCII or binary form,

• This is a sequential command.

:TRACE:Y? TRA -> -1.00000000E+001,

-1.00000000E+001,

-1.00000000E+001,....

from the shortest level to the longest, irrespective of the wavelength/frequency mode.

LOG values.

linear values.

omitted, all sampling data of a specified trace will be output.

executing :TRACe[:DATA]:SNUMber?.

depending on the setting of :FORMat[:DATA].

Commands

IM AQ6380-17EN

5-59

Page 93

5.13 TRACe Group

:TRACe[:DATA]:Y:PDENsity?

Function Queries the power spectral density trace data.

:TRACe[:DATA]:Y:PDENsity? <wsp>

Syntax

<trace name>,<NRf>[m][,<start point>,

<trace name> = Computation source trace <NRF> = Normalization bandwidth [m] <start point> = Sample range to transfer (start point) (1

to 200001)

<stop point> = Sample range to transfer (stop

point) (1 to 200001)

Example

-> -5.36017335E+001,-5.36143380E+001,

Description • When the level scale is set to LOG, LOG

• When the level scale is set to linear, linear

• If the <start point> and <stop point>

• The data is output in ASCII or BINARY format

• This is a sequential command.

:T R ACE:Y:PD E N ? T R A ,0.1N M

-5 .344416 3 9 E + 0 01 ,....

values will be output.

parameters are omitted, the entire sample data of the specified trace will be output.

according to the :FORMat[:DATA] setting.

:TRACe:STATe[:<trace name>]

Function Sets or queries the display status of the specified

trace.

:T R ACe:ST A Te[:<tr a c e n a me>]<w s p >

Syntax

OF F|O N|0|1

:TR ACe:STA T e?

<trace name> = Trace to be transferred (TRA|TRB|TRC|TRD|TRE|TRF|TRG) OFF = Hide trace (BLANK) ON = Makes trace visible (DISP). Response 0 = OFF, 1 = ON Example

:TRACE:STATE? -> 0

Description • If <trace name> is omitted, the command is

• If <trace name> is specified, the specified trace

• This is a sequential command.

:TRACE:STATE OFF

executed with respect to the active trace.

is set as the active trace after the command is exeucted.

:TRACe:DELete

Function Deletes the data of a specified trace.

:TRACe:DELete<wsp><trace name>

Syntax <trace name> = Trace to be transferred (TRA|TRB|TRC|TRD|TRE|TRF|TRG) Example Description This is a sequential command.

:TRACE:DELETE TRA

:TR ACe:D E L ete:A L L

Function Clears the data for all traces.

:TR AC e:DEL e te:A LL

Syntax Example Description This is a sequential command.

:TR ACE:DE L E T E:A L L

5-60

IM AQ6380-17EN

Page 94

5.13 TRIGger Group

:TRIGger[:SEQuence]:DELay

Function Sets or queries the trigger delay.

:TRIG g e r[:SEQ u e n c e]:DE L ay<w s p > < N R f>

Syntax

[S]

:TRIG g e r[:SEQ u e n c e]:DE L ay?

<NRf> = delay [sec] Example

:TRIGGER:DELAY? -> +1.00000000E-004

Description • When this command is executed, the external

(TRIGger[:SEQuence]:STATe ON)

• This is a sequential command.

:T R IG G E R:D E L AY 100.0U S

trigger mode becomes enabled.

:TRIGger[:SEQuence]:GATE:ITIMe

Function Sets or queries sampling interval for gate

sampling.

:TRIG g e r[:SEQ u e n c e]:GAT E:ITIM e<w s p > < N

Syntax

Rf>[S]

:TRIG g e r[:SEQ u e n c e]:GAT E:ITIM e?

<NRf> = Sampling interval Response <NRf> = Sampling interval[S] Example

:TRIGGER:SEQUENCE:GATE:ITIME? ->

Description This is a sequential command.

:TRIGGER:SEQUENCE:GATE:ITIME 100ms

+1.00000000E-001

:TRIGger[:SEQuence]:GATE:LOGic

Function Sets or queries the gate signal logic of gate

sampling.

:TRIGger[:SEQuence]:GATE:LOGic<wsp>PO

Syntax

SI|N EG A|0|1

:TRIG g e r[:SEQ u e n c e]:GAT E:L O Gic?

POSI = Sampling is performed when the gate

signal is at high level

NEGA = Sampling is performed when the gate

signal is at low level Response 0 = POSI, 1 = NEGA Example

:TRIGGER:SEQUENCE:GATE:LOGIC? -> 0

Description This is a sequential command.

:TRIGGER:SEQUENCE:GATE:LOGIC POSI

:TRIGger[:SEQuence]:GATE:MDELay

Function Sets or queries the measure delay of gate

sampling.

:TRIG g e r[:SEQ u e n c e]:GAT E:M DELay < w s p><

Syntax

N R f >[S]

:TRIG g e r[:SEQ u e n c e]:GAT E:M DELay ?

<NRf> = Measure delay [sec] Response <NRf> = Measure delay[S] Example

:TRIGGER:SEQUENCE:GATE:MDELay?

Description This is a sequential command.

TRIGGER:SEQUENCE:GATE:MDELay 100ms

->+1.00000000E-001

:TR I G g e r[:S E Q u e n c e]:SL O P e

Function Sets or queries the trigger edge.

:TRIG g e r[:SEQ u e n c e]:SL OPe < w s p >RIS E|

Syntax

FA L L|0|1

:TRIG g e r[:SEQ u e n c e]:SL OPe?

RISE|0 = RISE FALL|1 = FALL Response 0 = RISE, 1 = FALL Example

:TRIG GER:SLOPE? -> 0

Description • When this command is executed, the external

• This is a sequential command.

:TRIGGER:SLOPE RISE

trigger mode becomes enabled.

:TR I G g e r[:S E Q u e n c e]:STA T e

Function Sets or queries the external trigger mode.

:TRIG g e r[:SEQ u e n c e]:STAT e < w s p>OFF|O N|P

Syntax

HO L d |G A T E|0|1|2|3

:TRIGger[:SEQuence]:STATe? OFF|0: External Trigger OFF ON|1: External trigger mode PHOLd|2: Peak hold mode GATE|3: Gate sampling Response 0 = OFF, 1 = ON, 2 = PHOLd,

3 = GATE

Example

:TRIG GER:STATE? -> 1

Description This is a sequential command.

:TRIGGER:STATE ON

Commands

IM AQ6380-17EN

:TRIGger[:SEQuence]:INPut

Function Sets or queries the signal of the input trigger.

:TRIG g e r[:SEQ u e n c e]:IN P u t< w s p>

Syntax

ETRigger|STRigger|SENable|0|1|2

:TRIG g e r[:SEQ u e n c e]:IN P u t?

ETRigger|0: Sampling trigger STRigger|1: Sweep trigger SENable|2: Sample enable Example

:TRIGGER:INPUT? -> 1

Description This is a sequential command.

:TRIGGER:INPUT STRIGGER

5-61

Page 95

5.14 TRIGger Group

:TRIGger[:SEQuence]:OUTPut

Function Sets or queries the signal of the output trigger.

:TRIG g e r[:SEQ u e n c e]:OU T P u t< w s p > OFF|SST

Syntax

at u s|0|1

:TRIG g e r[:SEQ u e n c e]:OU T P u t?

OFF|0: OFF SSTatus|1: Sweep status Response 0 = OFF, 1 = SSTatus Example

:TRIGGER:OUTPUT? -> 1

Description This is a sequential command.

:TRIGGER:OUTPUT SSTATUS

:TRIGger[:SEQuence]:PHOLd:HTIMe

Function Sets or queries the hold time of peak hold mode.

:TRIG g e r[:SE Q u e nc e]:PHO L d:HTI M e

Syntax

<w sp>< N R f >[s]

:TRIG g e r[:SE Q u e nc e]:PHO L d:HTI M e?

<NRf> = Hold time [s] Example

:TRIGGER:PHOLD:HTIME? ->

Description This is a sequential command.

:TRIGGER:PHOLD:HTIME 100MS

+1.00000000E-001

5-62

IM AQ6380-17EN

Page 96

5.14 UNIT Group

:UNIT:POWer:DIGit

Function Sets or queries the number of decimal places

displayed for the level value.

:UNIT:POWer:DIGit<wsp>1|2|3

Syntax

:UNIT:POWer:DIGit?

1, 2, 3 = Number of displayed digits Example

:U NIT:P O W ER:DIGI T? -> 3

Description This is a sequential command.

:U N IT:X

Function Sets or queries the units for the X axis. Syntax

Response WAVelength = Wavelength FREQuency = Frequency Example

:UNIT:X? -> 1

Description This is a sequential command.

:UNIT:POWER:DIGIT 3

:UNIT:X<wsp>WAVelength|FR EQuency|

W N U M b e r|0|1|2:U N I T:X?

:UNIT:X FREQUENCY

Commands

IM AQ6380-17EN

5-63

Page 97

5.15 Common Commands Group

The instrument supports the “Required” common commands listed in the table below.

Cmd Name IEEE 488.2 Std. Commands supported

*AAD Accept Address Command Option *CAL? Calibration Query Option *CLS Clear Status Command Required Y *DDT Define Device Trigger Command *DT1 option *DDT? Define Device Trigger Query DT1 option *DLF Disable Listener Function Command Option *DMC Define Macro Command Option *EMC Enable Macro Command Option *EMC? Enable Macro Query Option *ESE Standard Event Status Enable Command Required Y *ESE? Standard Event Status Enable Query Required Y *ESR? Standard Event Status Register Query Required Y *GMC? Get Macro Contents Query Option *IDN? Identification Query Required Y *IST? Individual Status Query Required for PP1 *LMC? Learn Macro Query Option *LRN? Learn Device Setup Query Option *OPC Operation Complete Command Required Y *OPC? Operation Complete Query Required Y *OPT Option Identification Query Option *PCB Pass Control Back Command Required if not C0 *PMC Purge Macro Command Option *PRE Parallel Poll Register Enable Command Required for PP1 *PRE? Parallel Poll Register Enable Query Required for PP1 *PSC Power On Status Clear Command Option *PSC? Power On Status Clear Query Option *PUD Protected User Data Command Option *PUD? Protected User Data Query Option *RCL Recall Command Option *RDT Resource DescriptionTransfer Command Option *RDT? Resource Description Transfer Query Option *RST Reset Command Required Y *SAV Save Command Option *SRE Service Request Enable Command Required Y *SRE? Service Request Enable Query Required Y *STB? Read Status Byte Query Required Y *TRG Trigger Command Required if DT1 Y *TST? Self-Test Query Required Y *WAI Wait-to-Continue Command Required Y

by the AQ6380

5-64

IM AQ6380-17EN

Page 98

5.16 Common Commands Group

*CLS(Clear Status)

Function Clears all event status registers, the summary of

which is reflected in the status byte register.

*CLS

Syntax Example

• After executing this command, OCIS (Operation

• This is a sequential command.

*CLS

output queue, and all event registers, with the exception of the MAV summary message.

Complete Command Idle State) and OQIS (Operation Complete Query Idle State) are brought about.

*ESE(Stand ard Event Status Enable)

Function Sets or queries the standard event enable

*ESE<wsp><integer>

Syntax

*ESE?

<integer> = 0–255 Example

*ESE? -> 251

Description • An item having had its bit set becomes

• Resets to the default value in the following

When power is ON When “0” is set

• The set value remains the same in the

*RST *CLS Device clear (DCL, SDC)

• The default is 0.

• This is a sequential command.

*ES E 251

enabled.

cases:

following cases:

*IDN? (Identification)

Function Queries the instrument type and firmware version.

*ID N ?

Syntax Example

aaaaaaaaa: Serial number (9 digit string) bb.bb: Firmware version Description • Outputs 4 field data delimited by a comma. Field 1: Manufacturer “YOKOGAWA” Field 2: Model “AQ6380” Field 3: Instrument serial number Field 4: Firmware version

• This is a sequential command.

*IDN? -> YOKOGAWA,AQ6380,aaaaaaaaa,

bb.bb

*OP C(O p e r a t i o n Co m p l et e)

Function Sets or queries bit 0 (OPC) of the standard event

status register (ESR) if operations waiting to be processed have all been completed.

*OPC

Syntax

*OPC?

Example

*OPC? -> 1

Description • At the time this command is recognized, the

• If any of the following conditions are

Power ON Device clear *CLS, *RST command

• This is an overlapping command.

*OPC

command changes from OCIS (Operation Complete Command Idle State) to OCAS (Operation Complete Command Active State). When the no-operation pending flag is set to “True,” it sets bit 0 (OCR) of ESR and returns to OCIS.

established, this command is disabled and is forced to return to OCIS.

Commands

*ESR?(Sta ndard Event St atus Regist er)

Function Queries the standard event status register and

simultaneously clears it.

*ESR?

Syntax Example Description

• This is an overlapping command.

*ESR? -> 251

• The return value of this query

is not affected by ESE (Event Status

Enable Register).

*RST (Reset)

Function Executes a device reset to return the instrument

to the known (default) status.

*RST

Syntax Example Description • Stops operation being processed and returns

• This unit’s parameters are cleared.

• The following items will remain the same. GP-IB interface status GP-IB address Output queue SRE ESE Calibration data affecting the instrument’s

• This is an overlapping command.

*RST

the instrument to the known set value (default value) immediately.

specifications

IM AQ6380-17EN

5-65

Page 99

5.16 Common Commands Group

*SRE(Service Request Enable)

Function Sets or queries the service request enable

*SRE <wsp><integer>

Syntax

*SR E?

<integer> = 0–255 Example

*SRE? -> 250

Description • An item having had its bit set becomes

• Resets to the default value in the following

When power is ON When “0” is set

• The set value remains the same in the

*RST *CLS Device clear (DCL, SDC)

• The default is 0.

• This is a sequential command.

*SR E 250

enabled.

cases:

following cases:

*STB?(Read Status Byte)

Function Queries the current value of the status byte

*STB?

Syntax Example Description • STB will not be cleared even when the contents

• This is an overlapable command.

*STB? -> 251

of the register are read.

*WAI(Wait to Continue)

Function Prevents the instrument from executing another

command until the execution of the current command is complete.

*WAI

Syntax Example Description • Becomes invalid by device clear.

• Meaningful if subsequent commands

• This is a sequential command.

*WAI

are overlapping. Meaningless with other commands.

*TRG(Trigger)

Function Performs a <SINGLE> sweep under the sweep

conditions established immediately before receiving the command.

*TRG

Syntax Example Description • Performs a <SINGLE> sweep regardless of

• This is an overlapable command.

*TRG

the setting condition of the :INITiate:SMODe command.

*TST?(Self Test)

Function Performs the instrument’s self-test and queries

the status.

*TST?

Syntax Example Description • Of the initialization sequence to be run at

AMP offset

• Normally returns 0, or 2 for AMP offset error.

• This is a sequential command.

*TST? -> 0

startup, this command executes the following operations to output their results. During initialization, the screen maintains the waveform display.

5-66

IM AQ6380-17EN

Page 100

5.16 Sample Program

This is an example of remotely controlling this instrument.

Language : Python Environment : Environment in which remote control is possible using the PyVISA library

or VISA library

Supported interfaces : GPIB, ETHERNET (SOCKET), ETHERNET (VXI-11)

The interface used for control can be changed by changing the value of the “iftype” variable in the following program.

Sample Program 1

The program sets the measurement conditions (center wavelength, span, sensitivity, and the sampling number) and then performs a sweep. After completing this sweep, the program executes a thresh-based spectrum width analysis and then outputs the results to the screen.

import pyvisa

rm = pyvisa.ResourceManager()

Commands

iftype = 0

if iftype == 0:

# === Connect(GP-IB) ===

board_id = '0'

osa_adr = '1'

osa = rm.open_resource('GPIB' + board_id + '::' + osa_adr + '::INSTR')

elif iftype == 1:

# === Connect(Socket) ===

osa_adr = '192.168.1.100'

port = '10001'

osa = rm.open_resource('TCPIP0::' + osa_adr + '::' + port + '::SOCKET')

# === Set termination ===

osa.read_termination = '\n'

osa.write_termination = '\n'

# === Authentication by OPEN Command ===

osa.write('open "anonymous"')

osa.write('')

out = osa.query("open \"anonymous\"")

print(out)

out = osa.query('')

print(out)

elif iftype == 2:

# === Connect(VXI-11) ===

osa_adr = '192.168.1.100'

osa = rm.open_resource('TCPIP0::' + osa_adr + '::inst0::INSTR')

# 0: GPIB, 1:SOCKET, 2:VXI-11

# GP-IB Interface card Address

# OSA GP-IB Address

# OSA IP Address # OSA remote port num

# OSA IP Address

IM AQ6380-17EN

5-67

Yokogawa AQ6380 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Manuals

How to Use This Manual

Sympols and Notation Used in This Manual

Contents

Chapter 1 Remote Control Functions

1.1 Remote Interfaces

1.2 Switching between Local and Remote

1.3 Sending/Receiving Remote Commands

Chapter 2 GP-IB Interface

2.1 Connecting via GP-IB

2.2 GP-IB Interface Function

2.3 GP-IB Interface Specifications

2.4 Setting the GP-IB Address

2.5 Responses to Interface Messages

Chapter 3 Ethernet Interface

3.1 Connecting via Ethernet

3.2 Setting Up Ethernet

Chapter 4 Programming Overview

4.1 Rules of Syntax and Command Types

4.2 Types of Commands

Chapter 5 Commands

5.1 List of Commands

5.1 ABORt Group

5.2 APPLication Group

5.3 CALCulate Group

5.4 CALibration Group

5.5 DISPlay Group

5.6 FORMat Group

5.7 INITiate Group

5.8 MMEMory Group

5.9 SENSe Group

5.10 STATus Group

5.11 SYStem Group

5.12 TRACe Group

5.13 TRIGger Group

5.14 UNIT Group

5.15 Common Commands Group

5.16 Sample Program