Communication Interface OTDR

Embed Size (px)

Citation preview

  • 7/28/2019 Communication Interface OTDR

    1/69

    UsersManual AQ7270 Series OTDR

    Communication Interface

    IM 735020-17E

    5th Edition

  • 7/28/2019 Communication Interface OTDR

    2/69

    iIM 735020-17E

    ForewardThank you for purchasing YOKOGAWAs AQ7270 Series (AQ7270/AQ7275) OTDR.

    This Communication Interface Users Manual describes the functions and commands

    of USB and Ethernet (optional) interface. To ensure proper use of the USB/Ethernet

    (optional) interfaces, please read this manual thoroughly.Keep the manual in a safe place

    for quick reference whenever a question arises.Three manuals are provided with the

    AQ7270/AQ7275 including thisCommunication Interface Users Manual.

    Manual Name Manual No. Description

    AQ7270 Series OTDR IM 735020-01E Explains all functions except for the

    Users Manual communications functions and operation

    (CD-ROM) procedures of the instrument.

    AQ7270 Series TDR IM 735020-17E Describes the communications functions

    Communication Interface of the USB/Ethernet interfaces.

    Users Manual (CD-ROM) This manual.

    AQ727 Series OTDR IM 735020-02E Describes safety precautions and the

    Operation Guide basic operations.

    Notes The contents of this manual are subject to change without prior notice as a result of

    improvements in instruments performance and functions.

    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 representative.

    Copying or reproduction of all or any part of the contents of this manual without

    YOKOGAWAs permission is strictly prohibited.

    Trademarks The fiber Xplorer is the registered trademark of Yokogawa Electric Corporation.

    Microsoft, Internet Explorer, MS-DOS, Windows, Windows NT, and WindowsXP are

    either registered trademarks or trademarks of Microsoft Corporation in the United

    States and/or other countries.

    Adobe, Acrobat, and PostScript are either trademarks or registered trademarks of

    Adobe Systems incorporated.

    For purposes of this manual, the TM and symbols do not accompany their

    respective trademark names or registered trademark names.

    Other product names are trademarks or registered trademarks of their respective

    holders.

    Revisions1st Edition: December 2006

    2nd Edition: December 2007

    3rd Edition: February 2008

    4th Edition: December 2008

    5th Edition: September 2011

    5th Edition : September 2011 (YMI)

    All Rights Reserved, Copyright 2006, Yokogawa Electric Corporation

    All Rights Reserved, Copyright 2011, Yokogawa Meters & Instruments Corporation

  • 7/28/2019 Communication Interface OTDR

    3/69

    ii IM 735020-17E

    How to Use this Manual

    Structure of the Manual

    This Users Manual consists of the following sections:

    Chapter 1 Remote Control Function Overview

    Gives an overview of the various communication interfaces.

    Chapter 2 USB Interface

    Describes the functions and specifications of the USB interface used to

    control the AQ7270series from a PC.

    Chapter 3 Ethernet Interface (Option)

    Describes the functions and specifications of the Ethernet interface.

    Chapter 4 Before ProgrammingDescribes the syntax used to transmit commands.

    Chapter 5 Remote Commands

    Describes each command that is available.

    Appendix

    Explains the support for AQ7260 commands.

  • 7/28/2019 Communication Interface OTDR

    4/69

    iiiIM 735020-17E

    Conventions Used in This Manual

    Notations Used in the Procedural Explanations

    On pages that describe the operating procedures in each chapter, the following notationsare used to distinguish the procedure from their explanations.

    Procedure This subsection contains the operating procedure used to carry outthe function described in the current section. The procedures are

    written with inexperienced users in mind; experienced users may not

    need to carry out all the steps.

    Explanation This subsection describes the setup parameters and the limitationson the procedures.

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

    the instrument.

    Terms Used in Explanations of Procedures

    Panel Keys and Soft Keys

    Bold characters used in the procedural explanations indicate characters that are marked

    on the panel keys or the characters of the soft keys displayed on the screen menu.

    Units

    Symbol Description Example

    k 1000 400km

    K 1024 459KB (file size)

  • 7/28/2019 Communication Interface OTDR

    5/69

    iv IM 735020-17E

    Symbols Used in Syntax DescriptionsSymbols which are used in the syntax descriptions in Chapter 5 are shown below.

    These symbols are referred to as BNF notation (Backus-Naur Form).

    For detailed information, see section 4.4, Data.

    Symbol Description Example Example of Input

    Defined value SET:M=1,2,3 ->SET:M2

    {} One of the options LMTechnique{LSA|TPA} ->LMTechniqueTPA in {} is selected.

    | Exclusive OR

    Conventions Used in This Manual

  • 7/28/2019 Communication Interface OTDR

    6/69

    vIM 735020-17E

    1

    2

    3

    4

    5

    App

    Contents

    How to Use this Manual ....................................................................................................................ii

    Conventions Used in This Manual ................................................................................................... iii

    Chapter 1 Remote Control Function Overview1.1 Remote Interface .............................................................................................................. 1-1

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

    Chapter 2 USB Interface2.1 Connecting via the USB ................................................................................................... 2-1

    2.2 Setting the USB ................................................................................................................ 2-2

    Chapter 3 Ethernet Interface (Option)3.1 Connecting via the Ethernet Interface (Option) ................................................................ 3-1

    3.2 Setting the Ethernet Interface ........................................................................................... 3-3

    Chapter 4 Before Programming4.1 Messages ......................................................................................................................... 4-1

    4.2 Commands ....................................................................................................................... 4-3

    4.3 Response ......................................................................................................................... 4-6

    4.4 Data .................................................................................................................................. 4-7

    4.5 Synchronization with the Controller .................................................................................4-11

    Chapter 5 Commands5.1 A List of Commands ......................................................................................................... 5-1

    5.2 Common Commands ....................................................................................................... 5-65.3 Device-SpecifcCommands ............................................................................................. 5-8

    ACQuire Group ............................................................................................................ 5-8

    ANALysis Group .........................................................................................................5-11

    COMMunicate Group ................................................................................................. 5-16

    DISPlay Group ........................................................................................................... 5-17

    FILE Group ................................................................................................................ 5-19

    LABel Group .............................................................................................................. 5-21

    MENU Group ............................................................................................................. 5-22

    MISC Group ............................................................................................................... 5-23

    NETWork Group ........................................................................................................ 5-25

    PRINt Group .............................................................................................................. 5-26

    SETup Group ............................................................................................................. 5-27

    STATus Group ............................................................................................................ 5-27

    WAVedata Group ....................................................................................................... 5-28

    SYSTem Group .......................................................................................................... 5-28

    LIGHtsource Group .................................................................................................... 5-29

    VLS Group ................................................................................................................. 5-29

    PMONitor Group ........................................................................................................ 5-30

    5.4 Condition Register .......................................................................................................... 5-31

    5.5 Output Queue and Error Queue ..................................................................................... 5-32

    5.6 Error Messages .............................................................................................................. 5-33

    Appendix Correspondence with the AQ7260 CommandsA List of Supported AQ7260 Commands ..................................................................................App-1

  • 7/28/2019 Communication Interface OTDR

    7/69

    1-1IM 735020-17E

    Remote

    ControlFunctionOverview

    11.1 Remote Interface

    The AQ7270 series is equipped with the following remote interfaces.

    USB 1.1 Interface (Type B. See Chapter 2)This interface is used by a controller such as a PC to remotely control the AQ7270 series.

    A controller is connected to this interface.

    Remote commands are used to control the AQ7270 series.

    Dedicated commands for the AQ7270 series complying with SCPI (Standard Commands

    for Programmable Instruments) are available for the remote commands (see chapter 5).

    Ethernet Interface (See Chapter 3)This interface is used by a controller such as a PC to remotely control the AQ7270 series

    via the network.

    Downloading the Library and DriverThe items below are needed on the PC to use the communication functions via the USB

    interface.

    AQ7270 series Series Library

    USB connection device driver between the PC and AQ7270 series

    The items below are needed on the PC to use the communication functions via the

    Ethernet interface.

    AQ7270 series Series Library

    The library and driver above can be downloaded from the following Web page.http://www.yokogawa.com/tm/dl_driver.htm

    Chapter 1 Remote Control Function Overview

  • 7/28/2019 Communication Interface OTDR

    8/69

    1-2 IM 735020-17E

    1.2 Switching between Remote and Local Modes

    When Switching from Local to Remote Mode

    You can switch from local to remote mode by pressing the AQ7270 series keys.For the procedure, see section 2.2, "Setting the USB" or 3.2, "Setting the Ethernet

    Interface."

    All keys except the "Local" key are disabled.

    Settings entered in local mode are passed on even when the AQ7270 series switches

    to remote mode.

    When Switching from Remote to Local ModePressing the "Local" key when the instrument is in the remote mode causes the

    instrument to switch to the local mode.

    For the procedure, see section 2.2, "Setting the USB" or 3.2, "Setting the EthernetInterface."

    Key operations are enabled.

    Settings entered in remote mode are passed on even when the AQ7270 series

    switches to local mode.

  • 7/28/2019 Communication Interface OTDR

    9/69

    2-1IM 735020-17E

    USBInterface

    2

    2.1 Connecting via the USB

    You can control the AQ7270 series from a PC using the USB interface.

    USB Interface Functions and Specifications

    Reception Function

    You can specify the same settings as those specified by front panel key operations.

    Receives output requests for measured and computed data, setup data of the panel, and

    error codes.

    Transmission Function

    Outputs measured and computed data.

    Outputs panel setup data and the status byte.

    Outputs error codes that have occurred.

    USB Interface Specifications

    Electrical and mechanical specifications: Conforms to USB Rev.1.0

    Connector: Type B connector (receptacle)

    Number of ports: 1

    Power supply: Self-powered

    Compatible PC systems: PCs with standard USB ports running

    Windows 98 SE, Windows Me, Windows

    2000, or Windows XP. (A separate device

    driver is required to connect to a PC.)

    Connection ProcedureConnecting a USB Cable to Remotely Control the AQ7270 series or

    Accessing the Internal Memory

    1. Open the top cover.

    2. Connect a USB cable to the Type B connector.

    Precautions to Be Taken When Connecting the Cable

    Connect the USB cable by inserting the connector firmly into the USB connector.

    Do not connect or disconnect the USB cable after the power is turned ON until the

    AQ7270 series is ready for operation (approximately 20 s).

    Chapter 2 USB Interface

  • 7/28/2019 Communication Interface OTDR

    10/69

    2-2 IM 735020-17E

    2.2 Setting the USB

    Procedure

    Selecting the Detail Mode

    1. Press the OTDR soft key. The optical pulse measurement display appears.

    2. Press SETTING. Soft keys for the settings appear.

    3. Press the Mode soft key. A soft key menu for selecting the setup mode appears.

    4. Press the Detail soft key. Soft keys for the Detail mode appear.

    Displaying the System Setup Screen

    5. Press the System Setup soft key. The system setup screen appears.

    Select Remote I/F.

    Select Control I/F.

  • 7/28/2019 Communication Interface OTDR

    11/69

    2-3IM 735020-17E

    USBInterface

    2

    Selecting the USB Function

    6. Move the cursor to USB Function using the arrow keys orrotary knob.

    7. Press ENTER. The screen for selecting the USB function appears.

    8. Move the cursor to Control I/F using the arrow keys orrotary knob.

    9. Press ENTER. The screen for selecting the USB function closes.

    Note You cannot change the display while the AQ7270 series is being remotely controlled.

    Select Storage to read or write the measured results in the AQ7270 series internal memory

    from the PC.

    The AQ7270 series cannot be remotely controlled while the storage function is in operation.

    Remote control via the Ethernet interface is also not possible.

    Releasing the Remote Control from the USB

    Press the Local soft key.

    2.2 Setting the USB

  • 7/28/2019 Communication Interface OTDR

    12/69

    3-1IM 735020-17E

    EthernetInterface(O

    ption)

    3

    3.1 Connecting via the Ethernet Interface (Option)

    You can control the AQ7270 series from a PC by connecting the AQ7270 series to a LAN

    using the Ethernet interface.Ethernet Interface Functions and Specifications

    Reception Function

    You can specify the same settings as those specified by front panel key operations.

    Receives output requests for measured and computed data, setup data of the panel, and

    error codes.

    Transmission Function

    Outputs measured and computed data.

    Outputs panel setup data and the status byte.

    Outputs error codes that have occurred.

    Ethernet Interface Specifications

    Number of communication ports: 1

    Electrical and mechanical specifications: Conforms to IEEE802.3

    Transmission system: Ethernet (10BASE-T/100BASE-TX)

    Data rate: 10 Mbps/100 Mbps

    Communication protocol: TCP/IP

    Connector type: RJ45 connector

    Port number used: 10001/tcp

    NoteWhen using the Ethernet interface, a user name and password are required when connecting to

    the network. For the procedure to enter the user name and password, see section 3.2, "Setting

    the Ethernet Interface."

    Chapter 3 Ethernet Interface (Option)

  • 7/28/2019 Communication Interface OTDR

    13/69

    3-2 IM 735020-17E

    Connection ProcedureConnect a UTP (Unshielded Twisted-Pair) cable or an STP (Shielded Twisted-Pair) cable

    that is connected to a hub, for example, to the 100BASE-TX port on the rear panel of the

    AQ7270 series.

    Precautions to Be Taken When Connecting the Cable

    Be sure to use a straight cable via a hub for the connection between the AQ7270

    series and the PC.

    When using a UTP cable (straight cable), use a cable of category 5.

    3.1 Connecting via the Ethernet Interface (Option)

  • 7/28/2019 Communication Interface OTDR

    14/69

    3-3IM 735020-17E

    EthernetInterface(O

    ption)

    3

    3.2 Setting the Ethernet Interface

    Procedure

    NoteYou must restart the AQ7270 series if you change the Ethernet settings.

    Selecting the Mode

    1. Press the OTDR soft key. The optical pulse measurement display appears.

    2. Press SETTING. Soft keys for the settings appear.

    3. Press the Mode soft key. A soft key menu for selecting the setup mode appears.

    4. Press the Detail soft key. Soft keys for the Detail mode appear.

    Displaying the System Setup Screen

    5. Press the System Setup soft key. The system setup screen appears.

    Enters the LAN settings.(For details, see page 3-4)

  • 7/28/2019 Communication Interface OTDR

    15/69

    3-4 IM 735020-17E

    3.2 Setting the Ethernet Interface

    Displaying the Network Setup Screen

    6. Move the cursor to Network Setup using the arrow keys orrotary knob.

    7. Press ENTER. The Network Setup screen appears.

    Enter the user information.

    Select Use the Network.

    Enter the timeout value.

    Enters the LAN settings.

    Enabling the Network Setup

    8. Press ENTER. The cursor moves to Invalid. The item text color turns white.

    Entering the User Name

    9. Move the cursor to User Name using the arrow keys orrotary knob.

    10. Press ENTER. The screen for entering characters appears.

    11. Enter the user name.

    Note

    For details on entering characters, see section 18.6 in theAQ7270 series OTDR User'sManual.

    Entering the Password

    12. Move the cursor to Password using the arrow keys orrotary knob.

    13. Press ENTER. The screen for entering characters appears.

    14. Enter the password.

    NoteFor details on entering characters, see section 18.6 in theAQ7270 series OTDR User's

    Manual.

  • 7/28/2019 Communication Interface OTDR

    16/69

    3-5IM 735020-17E

    EthernetInterface(O

    ption)

    Setting the Timeout Value

    15. Move the cursor to Time Out using the arrow keys orrotary knob.

    16. Press ENTER. The screen for setting the timeout value appears.

    17. Use the rotary knob to set the value.

    18. Press ENTER. The screen for setting the timeout value closes.

    NoteThe selectable range is 1 to 7200 or OFF.

    Setting the Address (Auto)

    19. Move the cursor to DHCP using the arrow keys orrotary knob.

    20. Press ENTER and move the cursor to ON.

    Note You cannot set the address manually if the DHCP function is turned ON.

    A DHCP server is required on the network to use the DHCP function.

    Setting the Address (Manual)

    21. Move the cursor to IP address using the arrow keys orrotary knob.

    22. Press ENTER. The screen for setting the address appears.

    23. Use the rotary knob to set the value.

    24. Press ENTER. The screen for setting the address closes.

    25. Move the cursor to Subnet Mask using the arrow keys orrotary knob.

    26. Press ENTER. The screen for setting the address appears.

    27. Use the rotary knob to set the value.

    28. Press ENTER. The screen for setting the address closes.

    29. Move the cursor to Gate Way using the arrow keys orrotary knob.

    30. Press ENTER. The screen for setting the address appears.

    31. Use the rotary knob to set the value.

    32. Press ENTER. The screen for setting the address closes.

    NoteYou cannot change the display while the AQ7270 series is being remotely controlled.

    3.2 Setting the Ethernet Interface

    3

  • 7/28/2019 Communication Interface OTDR

    17/69

    3-6 IM 735020-17E

    Releasing the Remote Control from the Ethernet Interface

    Press the Local soft key.

    3.2 Setting the Ethernet Interface

  • 7/28/2019 Communication Interface OTDR

    18/69

    3-7IM 735020-17E

    EthernetInterface(O

    ption)

    3.2 Setting the Ethernet Interface

    3

    Explanation

    The IP address of the AQ7270 series must be set correctly to use Ethernet interface

    function correctly.

    If a DHCP server is available on the network to which the AQ7270 series is connected,

    the IP address is automatically assigned.

    In this case, turn ON DHCP on the AQ7270 series.

    For details on the network to which the AQ7270 series is connected, consult your

    network administrator.

    Carry out the following settings when using a controller to set information that can be

    specified through key operation on the AQ7270 series or when outputting setup data or

    output waveform data to the controller.

    Setting the User Name and Password

    The Ethernet interface has a user verification function.

    Set the user name and password for the AQ7270 series in advance.

    Setting the User Name

    Enter the name using up to 15 characters. The default setting is "anonymous."

    Setting the Password

    Enter the password using up to 15 characters.

    Setting the Timeout Value

    The connection to the network is automatically disconnected if there is no access to the

    AQ7270 series for the specified time.

    Setting the TCP/IP Parameters

    You must set the following TCP/IP parameters to use the Ethernet interface function.

    IP address

    Subnet mask

    Gateway

    Note If the user verification fails, the connection to the AQ7270 series is disconnected.

    A password is not required if the user name is "anonymous."

    If you change the user name, password, timeout value, or TCP/IP settings, power-cycle the

    AQ7270 series to activate the new settings.

    The AQ7270 series has an FTP function. You can transfer the data stored in the AQ7270series internal memory to the PC using FTP commands from the PC.

    However, you cannot transfer data from the PC to the AQ7270 series memory.

  • 7/28/2019 Communication Interface OTDR

    19/69

    4-1IM 735020-17E

    BeforeP

    rogramming

    4

    4.1 Messages

    Blocks of message data are transferred between the controller and this instrument during

    communications.Messages sent from the controller to this instrument are called programmessages, and messages sent back from this instrument to the controller are called

    response messages.

    If a program message contains a query command, i.e.a command which requests a

    response, this instrument returns a response message. A single response message is

    always returned in reply to a program message.

    Program Messages

    Program Message Unit

    A program message consists of one or more programmessage units; each unit

    corresponds to one command. This instrument executes commands one by one

    according to the order in which they are received.Program message units are delimited by a ";.

    "For a description of the format of the program message unit, refer to the explanation

    given furtherbelow.

    "$2VJSF"7&3BHF.0%&)*3&'-&$5*0/5*.&"6501.5

    Unit Unit

    Example

    PMT is a terminator used to terminate each program message. The following three typesof terminator are available.

    NL (New Line)

    Same as LF (Line Feed). ASCII code"0AH" is used.

    ^END

    END message defined in IEEE488.1. (EOI signal)

    (The data byte sent with an END message will be the final item of the program

    message unit.)

    NL^END

    NL with an END message attached(NL is not included in the program message unit.)

    A program header is used to indicate the command type. For details, refer to page 4-3.

    If certain conditions are required for the execution of a command, program data must

    be added. Program data must be separated from the header by a space (ASCII code

    "20H"). If multiple items of program data are included, they must be separated by a ","

    (comma). For details, refer to page 4-5.

    "$2VJSF"7&3BHF.0%&)*3&'-&$5*0/1.5

    Header Data

    Example

    Chapter 4 Before Programming

  • 7/28/2019 Communication Interface OTDR

    20/69

    4-2 IM 735020-17E

    Response Messages

    A response message consists of one or more response message units: each response

    message unit corresponds to one response.Response message units are delimited by a ";"

    (semicolon).

    "$2VJSF"7&3BHF.0%&)*3&'-&$5*0/5*.&"6501.5

    Unit Unit

    Example

    RMT is the terminator used for every responsemessage. Only one type of response

    message isavailable; NL^END.

    A response header sometimes precedes the response data. Response data must beseparated from the header by a space. For details, refer to page 4-5.

    Response data is used to define a response. If multiple items of response data are used,

    they must be separated by a "," (comma). For details, refer to page 4-5.

    "$2VJSF"7&3BHF.0%&)*3&'-&$5*0/1.5

    Header Data

    Example 3.5

    Data

    If a program message contains more than one query, responses are made in the same

    order as the queries. Normally, each query returns only one response message unit,

    but there are some queries which return more than one response message unit. The

    first response message unit always responds to the first query, but it is not always true

    that the 'n'th unit always responds to the 'n'th query. Therefore, if you want to make sure

    that a response is made to eachquery, the program message must be divided up into

    individual messages.

    Points to Note Concerning Message Transmission

    It is always possible to send a program message if the previous message which was

    sent did not contain any queries.

    If the previous message contained a query, it is not possible to send anotherprogram message until a response message has been received. An error will occur

    if a program message is sent before a response message has been received in its

    entirety. A response message which has not been receivedwill be discarded.

    If an attempt is made by the controller to receive a response message, even if there

    it no response message, an error will occur. An error will also occur if the controller

    makes an attempt to receive a response message before transmission of a program

    message has been completed.

    If a program message of more than one unit is sent and some of the units are

    incomplete, this instrument receives program message units which the instrument

    thinks complete and attempts to execute them. However, these attempts may

    not always be successful and a response may not always be returned, even if the

    program message contains queries.

    4.1 Messages

  • 7/28/2019 Communication Interface OTDR

    21/69

    4-3IM 735020-17E

    BeforeP

    rogramming

    4

    4.2 Commands

    There are two types of command (program header)which can be sent from the controller

    to this instrument. They differ in the format of their program headers.

    Common command headerCommon Command Header Commands defined in IEEE 488.2-1987 are called common

    commands.

    An asterisk (*) must always be attached to the beginning of a command.

    An example of a common command

    *CLS

    Compound headerCompound Header Commands designed to be used only with this instrument are

    classified and arranged in a hierarchy according to their function. The format of a

    compound header is below. A colon (:) must be used when specifying a lower-level

    header.

    An example of a compound header

    :ACQuire:AVERage:MODE

  • 7/28/2019 Communication Interface OTDR

    22/69

    4-4 IM 735020-17E

    When Concatenating Commands

    Command Group

    A command group is a group of commands which havethe same compound header.

    A command group maycontain sub-groups.

    Example Commands relating to acquisition settings

    :ACQuire:AVERage:MODE

    :ACQuire:ATTenuation

    :ACQuire:AVERage:TYPE

    :ACQuire:DRANge

    :ACQuire:PWIDth

    :ACQuire:REALtime:STARt

    :ACQuire:SETTing

    When Concatenating Commands of the SameGroupThis instrument stores the hierarchical level of the command which is currently being

    executed, andperforms analysis on the assumption that the nextcommand to be sent will

    also belong to the same level.Therefore, it is possible to omit the header if thecommands

    belong to the same group.

    Example

    :ACQuire:AVERage:MODEHIREFLECTION;TIMEAUTO

    When Concatenating Commands of DifferentGroups

    A colon (:) must be included before the header of a command, if the command does not

    belong to the same group as the preceding command. It is impossible to omit a colon (:).

    Example :ACQuire:AVERage:MODEHIREFLECTION;:DISPlay:CURSor

    :SECondON

    When Concatenating Common Commands

    Common commands defined in IEEE 488.2-1987 are independent of hierarchical level.

    Thus, it is not necessary to add a colon (:) before a commoncommand.

    Example

    :ACQuire:AVERage:MODEHIREFLECTION;*CLS;TIMEAUTO

    When Separating Commands with

    If a terminator is used to separate two commands,each command is a separate

    message. Therefore, thecommon header must be typed in for each commandeven when

    commands of the same command groupare being concatenated.

    Example

    :ACQuire:AVERage:MODEHIREFLECTION:ACQuire:AVERage

    :TIMEAUTO

    4.2 Commands

  • 7/28/2019 Communication Interface OTDR

    23/69

    4-5IM 735020-17E

    BeforeP

    rogramming

    4

    Upper-level QueryAn upper-level query is a compound header to which aquestion mark is appended.

    Execution of an upper-level query allows all a groups settings to be output atonce.

    Some query groups comprising more than threehierarchical levels can output all their

    lower level settings.

    Example

    :ANALysis:THReshold?

    ->:ANAL:THR:EOF3.0;FERL40.0;FESL1.00;RLOS70.0

    ;SLOS0.03

    Note In reply to a query, a response can be returned as a program message to this instrument.

    Transmitting a response can restore the settings made when the query was executed.

    Not all a groups information will necessarily be sent out as a response. Some upper-

    levelqueries will not return setup data which is not currently in use.

    Header Interpretation RulesThis instrument interprets the header receivedaccording to the following rules.

    Mnemonics are not case sensitive.

    Example

    "DRANge" can also be written as"drange" or "Drange."

    The lowercase part of a header can be omitted.

    Example

    "DRANge" can also be written as"DRANG" or "DRAN."

    If the header ends with a question mark, the command is a query. It is not possible to

    omit the question mark.Example

    "DRANge?" cannot be abbreviated to anything shorter than "DRAN?."

    If the "x" at the end of a mnemonic is omitted, it is assumed to be "1."

    ExampleIf "M" is written as "M,"this represents "M1."

    NoteA mnemonic is a character string made up of alphanumeric characters.)

    4.2 Commands

  • 7/28/2019 Communication Interface OTDR

    24/69

    4-6 IM 735020-17E

    4.3 Response

    Form

    On receiving a query from the controller, this instrument returns a response message tothe controller. A response message is sent in one of the following two forms.

    Response Consisting of a Header and Data

    If the query can be used as a program messagewithout any change, a command header

    is attachedto the query, which is then returned.

    Example:ACQUire:MODE? ->:ACQUire:MODE NORMAL

    Response Consisting of Data Only

    If the query cannot be used as a program messageunless changes are made to it (i.e.

    it is a query-onlycommand), no header is attached and only the datais returned. Some

    query-only commands can bereturned after a header is attached to them.Example:MEASure:CHANnel1:PTOPeak:VALue? -> 10.0E+00

    When Returning a Response without a Header

    It is possible to remove the header from a responseconsisting of a header and data.

    The"COMMunicate:HEADer" command is used to do this.

    Abbreviated FormNormally, the lowercase part is removed from are sponse header before the response

    is returned to the controller. Naturally, the full form of the header canalso be used. For

    this, the

    "COMMunicate:VERBose" command is used. The part enclosed by [ ] is also omitted inthe abbreviatedform.

  • 7/28/2019 Communication Interface OTDR

    25/69

    4-7IM 735020-17E

    BeforeP

    rogramming

    4

    4.4 Data

    A data section comes after the header. A space must be included between the header

    and the data. The data contains conditions and values. Data is classified as below.

    Data Description

    Value expressed as a decimal number

    (Example: Average time ->ACQuire:AVERage:TIME60 )

    Physical value

    (Example: Distance range ->ACQuire:DRANge500 )

    Register value expressed as either binary,octal, decimalor hexadecimal

    (Example: Extended event register value ->STATus:EESE#HFE )

    Specified character string (mnemonic). Can be selected from { }

    (Example: Setup mode

    ->ACQuire:SETTing{SIMPLE|DETAIL|WIZARD|MULTI} )

    Indicates ON/OFF. Set to ON or OFF

    (Example: Fault event display ->ANALysis:FEDetectionON )

    Arbitrary character string

    (Example: Comment to be saved

    ->FILE:SAVe:COMMent"ABCDEF" )

    Gives the name of a file.

    (Example: Name of file to be saved

    ->FILE:SAVE:WAVeform:NAME"CASE1" )

    Arbitrary 8-bit data

    (Example: Response to acquired waveform data

    ->#800000010ABCDEFGHIJ )

    indicates a value expressed as a decimalnumber, as shown in the table

    below. Decimal valuesare given in the NR form specified in ANSI X3. 42-1975.

    Symbol Description Example

    Integer 125 1 +1000

    Fixed point number 125.0 .90 +001.

    Floating point number 125.0E+0 9E1 +.1E4

    Any of the forms to is allowed.

    Decimal values which are sent from the controller tothis instrument can be sent in any

    of the forms to. In this case, appears.

    For response messages which are returned from this instrument to the controller,the form ( to to be used) is determined by the query. Thesame form is

    used, irrespective of whether the valueis large or small.

    In the case of , the "+" after the "E" can be omitted, but the "" cannot.

    If a value outside the setting range is entered, the value will be normalized so that it is

    just inside the range.

    If the value has more than the significant number of digits, the value will be rounded.

  • 7/28/2019 Communication Interface OTDR

    26/69

    4-8 IM 735020-17E

    , , , and , , , and indicate decimal values which have

    physical significance. or can be attached to. They can be

    entered in any of the following forms.

    Form Example

    0.85UM

    500m

    5M

    5E -3

    Multipliers which can be used are shown below.

    Symbol Word Description

    EX Exa 1018

    PE Peta 1015

    T Tera 1012

    G Giga 109

    MA Mega 106

    K Kilo 103

    M Milli 103

    U Micro 106

    N Nano 109

    P Pico 1012

    F Femto 1015

    A Atto 1018

    Units which can be used are shown below.

    Symbol Word Description

    M Meter Distance

    S Second Time

    dB Decibel Level

    UM Micro meter Wavelength

    and are not case sensitive.

    "U" is used to indicate "."

    "MA" is used for Mega (M) to distinguish it from Milli.

    If both and are omitted, thedefault unit will be used.

    4.4 Data

  • 7/28/2019 Communication Interface OTDR

    27/69

    4-9IM 735020-17E

    BeforeP

    rogramming

    4

    indicates an integer, and can be expressed in hexadecimal, octal, or binary

    as well as a decimal number. is used when each bit of a value has a

    particular meaning. is expressed in one of the following forms.

    Form Example

    1

    #H #H0F

    #Q #Q777

    #B #B001100

    is not case sensitive.

    Response messages are always expressed as.

    is a specified string of character data(a mnemonic). It is mainly usedto indicate options,and is chosen from the character strings given in { }.

    For interpretation rules, refer to Header Interpretation Rules on page 4-4.

    Form Example

    {SIMPLE|DETAIL|WIZARD|MULTI} DETAIL

    As with a header, the "COMMunicate:VERBose"command can be used to return a

    response message in its full form. Alternatively, the abbreviated form can be used.

    The "COMMunicate:HEADer" command does not affect .

    is data which indicates ON or OFF, and is expressed in one of the followingforms.

    Form Example

    {ON|OFF|} ON OFF 1 0

    When is expressed in form, OFF is selected if the rounded integer

    value is "0" and ON is selected if the rounded integer is "Not 0."

    A response message is always "1" if the value is ON and "0" if it is OFF.

    4.4 Data

  • 7/28/2019 Communication Interface OTDR

    28/69

    4-10 IM 735020-17E

    is not a specified character string like . It is

    an arbitrary character string. A character string must be enclosed in apostrophes (') or

    double quotation marks (").

    Form Example

    'ABC'"IEEE488.2-1987"

    Response messages are always enclosed in double quotation marks.

    I f a character string contains a double quotation mark ("), the double quotation mark

    will be replaced by two concatenated double quotation marks ("").This rule also

    applies to a single quotation mark within a character string.

    is an arbitrary character string, therefore this instrument

    assumes that the remaining program message units are part of the character string

    if no apostrophe (') or double quotation mark (") is encountered. As a result, no error

    will be detected if a quotation mark is omitted.

    Gives the name of a file. The format is as follows.

    Form Example

    {||} 1CASE"CASE"

    If you input an value, the system converts the value (after rounding to the

    nearest integer) to the corresponding 8-character ASCII string. (If you set the value to

    1, the name becomes "00000001".) Note that negative values are not allowed.

    The first 12 characters of are assigned as the file name.

    The first 14 characters of are assigned as the file name. Response messages always return filenames as arguments.

    is arbitrary 8-bit data. is only used for response messages.

    Response messages are expressed in the following form.

    Form Example

    #N #800000010ABCDEFGHIJ

    #NIndicates that the data is . "N" is an ASCII character string number (digits)

    which indicates the number of data bytes that follow.

    Indicates the number of bytes of data. (Example:00000010=10bytes)

    The actual data. (Example:ABCDEFGHIJ)

    Data is comprised of 8-bit values (0 to 255). This means that the ASCII code "0AH,"

    which stands for "NL," can also be a code used for data. Hence,care must be taken

    when programming thecontroller.

    4.4 Data

  • 7/28/2019 Communication Interface OTDR

    29/69

    4-11IM 735020-17E

    BeforeP

    rogramming

    4

    4.5 Synchronization with the Controller

    Achieving SynchronizationIf you send the following program message when receiving averaging measurement

    data, the data may be retrieved before the completion of the measurement.

    ACQuire:AVERage:STARt;:WAVedata:DISPlay:SEND:ASCii?

    In such case, the following method must be used to synchronize with the end of the

    acquisition.

    Using the STATus:CONDition? Query

    The "STATus:CONDition?" command is used to query the contents of the condition

    register.

    Whether averaging measurement waveforms are being retrieved can be determined by

    reading bit 1 of the condition register.

    If bit 1 of the condition register is "1", waveforms are being retrieved. Otherwise, it isstopped.(Bit 1 is "0".)

    NoteFor details on the condition register, see section 5.4, "Condition Register."

  • 7/28/2019 Communication Interface OTDR

    30/69

    5-1IM 735020-17E

    Commands

    5

    5.1 A List of Commands

    Command Function Page

    Common Command Group*CLS Clears the event register and error queue. 5-6

    *ESE Sets the standard event enable register or queries the currentsetting. 5-6

    *ESR? Queries the standard event register and clears the register. 5-6

    *IDN? Queries the instrument model. 5-6

    *RST Initializes the command groups settings. 5-6

    *SRE Sets the service request enable register or queries the currentsetting. 5-6

    *STB? Queries the status byte register. 5-7

    *TST? Executes self test and queries the result. 5-7

    *OPT? Retrieves the information of the mounted option. 5-7

    ACQuire Group

    :ACQuire:ADSave Sets the automatic data storage to the file or queries thecurrent setting. 5-8

    :ACQuire:AESearch Sets the automatic event detection or queries the currentsetting. 5-8

    :ACQuire:ATTenuation Sets the attenuation or queries the current setting. 5-8

    :ACQuire:AUTO:ATTenuation? Queries the attenuation for AUTO. 5-8

    :ACQuire:AUTO:DRANge? Queries the distance range for AUTO. 5-8

    :ACQuire:AUTO:PWIDth? Queries the pulse width for AUTO. 5-8

    :ACQuire:AVERage:CONTinue Sets the averaging measurement continue or queries thecurrent setting. 5-8

    :ACQuire:AVERage:COUNt? Queries the current average count. 5-8

    :ACQuire:AVERage:INDex Sets the average count or queries the current setting. 5-8

    :ACQuire:AVERage:MODE Sets the average mode or queries the current setting. 5-9

    :ACQuire:AVERage:STARt Executes the averaging measurement. 5-9

    :ACQuire:AVERage:STOP Stops the averaging measurement. 5-9:ACQuire:AVERage:TIME Sets the average time or queries the current setting. 5-9

    :ACQuire:AVERage:TYPE Sets the average unit or queries the current setting. 5-9

    :ACQuire:DRANge Sets the distance range or queries the current setting. 5-9

    :ACQuire:MWAVelength:WAVelength Sets a wavelength for multi wavelength measurement or

    queries the current setting. 5-9

    :ACQuire:OFFSet Sets the horizontal measurement start position or queries thecurrent setting. 5-9

    :ACQuire:PLUGcheck Sets the connection check of the optical plug or queries thecurrent setting. 5-10

    :ACQuire:PWIDth Sets the pulse width or queries the current setting. 5-10

    :ACQuire:REALtime:STARt Executes the realtime measurement. 5-10

    :ACQuire:REALtime:STOP Stops the realtime measurement. 5-10

    :ACQuire:SETTing Sets the setup mode or queries the current setting. 5-10:ACQuire:SMPinterval:DATA Sets the sampling interval or queries the current setting. 5-10

    :ACQuire:SMPinterval:VALue? Queries the sampling interval. 5-10

    :ACQuire:WAVelength Sets the measured wavelength or queries the current setting. 5-10

    ANALysis Group

    :ANALysis:ASEarch:EXECute Executes the auto detection. 5-11

    :ANALysis:ASEarch:NUMber? Queries the number of auto detection events. 5-11

    :ANALysis:BCOefficient Sets the backscattering light level of the current wavelength orqueries the current setting. 5-11

    :ANALysis:IOR Sets the group refraction index of the current wavelength orqueries the current setting. 5-11

    :ANALysis:CURSor:DELete Clears the cursor. 5-11

    :ANALysis:CURSor:DISTance Sets the cursor position or queries the current setting. 5-11

    :ANALysis:CURSor:DECibel? Queries the cursor dB (decibel). 5-11

    Chapter 5 Commands

  • 7/28/2019 Communication Interface OTDR

    31/69

    5-2 IM 735020-17E

    Command Function Page

    :ANALysis:EMARker:LMTechnique Sets the approximation method (event) or

    queries the current setting. 5-11

    :ANALysis:EMARker:SET:M1 Sets marker M1 of the current event or queries the currentsetting. 5-11

    :ANALysis:EMARker:SET:M2 Sets marker M2 of the current event or queries the currentsetting. 5-11

    :ANALysis:EMARker:SET:M3 Sets marker M3 of the current event or queries the currentsetting. 5-12

    :ANALysis:EMARker:SET:Y2 Sets marker Y2 of the current event or queries the currentsetting. 5-12

    :ANALysis:DUNit Sets the distance unit or queries the current setting. 5-12

    :ANALysis:EVENt:IOR Sets the section IOR of the current event or queries thecurrent setting. 5-12

    :ANALysis:EVENt:CURRent:CUMLoss? Retrieves the accumulated loss of the current event. 5-12

    :ANALysis:EVENt:CURRent:DISTance? Retrieves the distance of the current event. 5-12

    :ANALysis:EVENt:CURRent:INDex Moves the current event. 5-12

    :ANALysis:EVENt:CURRent:IOR? Retrieves the section IOR of the current event. 5-12

    :ANALysis:EVENt:CURRent:LOSS? Retrieves the splice loss of the current event. 5-12

    :ANALysis:EVENt:CURRent:NOTE Sets the event note or queries the current setting. 5-12:ANALysis:EVENt:CURRent:RETurnloss? Retrieves the return loss of the current event. 5-12

    :ANALysis:EVENt:CURRent:UNITloss? Retrieves the loss per unit (dB/m) of the current event. 5-13

    :ANALysis:EVENt:DELete Deletes the current event. 5-13

    :ANALysis:EVENt:INSert Inserts the event at the cursor position. 5-13

    :ANALysis:FEDetection Sets the fault event display or queries the current setting. 5-13

    :ANALysis:FMARker:DELete Deletes the marker. 5-13

    :ANALysis:FMARker:LMTechnique Sets the approximation method of the marker or queries thecurrent setting. 5-13

    :ANALysis:FMARker:LOSS? Queries the splice loss. 5-13

    :ANALysis:FMARker:RETurnloss:VALue? Queries the return loss. 5-13

    :ANALysis:FMARker:RETurnloss:SATurated? Queries the saturation of the return loss. 5-14

    :ANALysis:FMARker:REFLection:VALue? Queries the reflection level. 5-14

    :ANALysis:FMARker:REFLection:SATurated? Queries the saturation of the reflection level. 5-14:ANALysis:FMARker:LEFT:LOSS? Queries the loss between markers 1 and 2. 5-14

    :ANALysis:FMARker:LEFT:DISTance? Queries the distance between markers 1 and 2. 5-14

    :ANALysis:FMARker:LEFT:UNITloss? Queries the slope between markers 1 and 2. 5-14

    :ANALysis:FMARker:RIGHt:LOSS? Queries the loss between markers 2 and 3. 5-14

    :ANALysis:FMARker:RIGHt:DISTance? Queries the distance between markers 2 and 3. 5-14

    :ANALysis:FMARker:RIGHt:UNITloss? Queries the slope between markers 2 and 3. 5-14

    :ANALysis:FMARker:SET:M Sets the marker or queries the current setting. 5-14

    :ANALysis:FMARker:SET:Y Sets the auxiliary marker or queries the current setting. 5-14

    :ANALysis:MWAVelength:BCOefficient Sets a backscattering light level for multi wavelength

    measurement or queries the current setting. 5-14

    :ANALysis:MWAVelength:IOR Sets the group refraction index for multi wavelength

    measurement or queries the current setting. 5-14

    :ANALysis:REFerence:DELete Deletes the distance reference. 5-14:ANALysis:REFerence:DISTance Sets the distance reference or queries the current setting. 5-15

    :ANALysis:THReshold:EOFiber Sets the threshold level of the end of fiber or queries the currentsetting. 5-15

    :ANALysis:THReshold:FERLoss Sets the threshold level of the return loss of the fault event orqueries the current setting. 5-15

    :ANALysis:THReshold:FESLoss Sets the threshold level of the splice loss of the fault event orqueries the current setting. 5-15

    :ANALysis:THReshold:RLOSs Sets the threshold level of the return loss or queries the currentsetting. 5-15

    :ANALysis:THReshold:SLOSs Sets the threshold level of the splice loss or queries the currentsetting. 5-15

    :ANALysis:TRACefix:MODE Sets or queries the trace fix mode.

    :ANALysis:TRACefix:STATe Sets the tracefix or queries the current setting. 5-15

    5.1 A List of Commands

  • 7/28/2019 Communication Interface OTDR

    32/69

    5-3IM 735020-17E

    Commands

    5

    Command Function Page

    :ANALysis:SECTion:STARt Sets the start position of the section data or queries the currentsetting. 5-15

    :ANALysis:SECTion:END Sets the end position of the section data or queries the currentsetting. 5-15

    :ANALysis:SECTion:LOSS? Queries the loss in the section data. 5-15

    :ANALysis:SECTion:RETurnloss:VALue? Queries the return loss in the section data. 5-16

    :ANALysis:SECTion:RETurnloss:SATurated? Queries the saturation of the return loss in the section data. 5-16

    :ANALysis:SECTion:DISTance? Queries the distance of the section data. 5-16

    :ANALysis:SECTion:REFerence Sets the reference point of the section data. 5-16

    :ANALysis:SECTion:LMTechnique Sets the approximation method of the section analysis orqueries the current setting. 5-16

    :ANALysis:SECTion:DELete Clears the section analysis data. 5-16

    :ANALysis:SECTion:BASelevel? Queries the dB value of the reference point of the section data. 5-16

    COMMunicate Group

    :COMMunicate? Queries all settings related to communications. 5-16

    :COMMunicate:HEADer Sets whether to include a header to the response or queriesthe current setting. 5-16

    :COMMunicate:VERBose Sets whether to return the response in full or abbreviated formor queries the current setting. 5-16

    DISPlay Group

    :DISPlay:ALINe Sets the display of the approximation line or queries the currentsetting. 5-17

    :DISPlay:COLor Sets the screen color or queries the current setting. 5-17

    :DISPlay:CURSor:DBValue Sets the dB value of cursor or queries the current setting. 5-17

    :DISPlay:CURSor:SECond Sets the secondary cursor display or queries the current setting. 5-17

    :DISPlay:CURSor:TYPE Sets the cursor type or queries the current setting. 5-17

    :DISPlay:DECibel:UPPer Sets the display start level or queries the current setting. 5-17

    :DISPlay:DIGit:DECibel Sets dB display digit or queries the current setting. 5-17

    :DISPlay:DIGit:DISTance Sets the distance display unit or queries the current setting. 5-17

    :DISPlay:DISTance:LEFT Sets the display start distance or queries the current setting. 5-17

    :DISPlay:DIVide:DECibel Sets the vertical zoom rate or queries the current setting. 5-18:DISPlay:DIVide:DISTance Sets the horizontal zoom rate or queries the current setting. 5-18

    :DISPlay:GTYPe Sets grid display or queries the current setting. 5-18

    :DISPlay:IMARk Sets the marker information display or queries the currentsetting. 5-18

    :DISPlay:ISCale Initializes the display scale. 5-18

    :DISPlay:OVERview Sets overview display or queries the current setting. 5-18

    :DISPlay:WAVE:TYPE Sets the waveform type display format or queries the currentsetting. 5-18

    FILE Group

    :FILE:DELete:EXECute Deletes the file. 5-19

    :FILE:DRIVe:FREE? Queries the free space on the current drive. 5-19

    :FILE:DRIVe:SET Sets the current drive or queries the current setting. 5-19

    :FILE:FILE:GET? Retrieves the specified file. 5-19:FILE:FILE:NAME Specifies the file name. 5-19

    :FILE:FILE:SIZE? Retrieves the size of the specified file. 5-19

    :FILE:FOLDer:MAKE Creates a folder. 5-19

    :FILE:FOLDer:PATH Sets the current folder name or queries the current setting. 5-19

    :FILE:FOLDer:LIST? Retrieves the current folder list. 5-20

    :FILE:SUBFolder:LIST? Retrieves the sub folder list in the current folder. 5-20

    :FILE:LOAD:EXECute Loads the file. 5-20

    :FILE:SAVE:COMMent Sets the comment to be saved or queries the current setting. 5-20

    :FILE:SAVE:EXECute Saves the file. 5-20

    :FILE:SAVE:ID Sets the ID number to be saved or queries the current setting. 5-20

    :FILE:SAVE:TYPE Sets the file name type to be saved or queries the currentsetting. 5-20

    :FILE:SAVE:SUB Sets the sub number to be saved or queries the current setting. 5-20:FILE:TYPE Sets the file type to be saved or queries the current setting. 5-20

    5.1 A List of Commands

  • 7/28/2019 Communication Interface OTDR

    33/69

    5-4 IM 735020-17E

    Command Function Page

    LABel Group

    :LABel:CABLe:CODE Sets the cable code or queries the current setting. 5-21

    :LABel:CABLe:ID Sets the cable ID or queries the current setting. 5-21

    :LABel:COMPany Sets the company name or queries the current setting. 5-21

    :LABel:DFLag:CURRent Sets the current data flag or queries the current setting. 5-21

    :LABel:FIBer:ID Sets the fiber ID or queries the current setting. 5-21

    :LABel:FIBer:TYPE Sets the fiber type or queries the current setting. 5-21

    :LABel:LABel Sets the label or queries the current setting. 5-21

    :LABel:LOCation:ORIGinating Sets the start position label or queries the current setting. 5-21

    :LABel:LOCation:TERMinating Sets the stop position label or queries the current setting. 5-22

    :LABel:OPERator Sets the name or queries the current setting. 5-22

    MENU Group

    :MENU:ERRor:CLEar Deleting the error dialog display 5-22

    :MENU:FUNCtion Sets the function mode or queries the current setting. 5-22

    :MENU:MARKer Sets the marker mode or queries the current setting. 5-22

    MISC Group

    :MISC:DATE:MODE Sets the date display type to be saved or queries the current

    setting. 5-23:MISC:DATE:YEAR Sets the year or queries the current setting. 5-23

    :MISC:DATE:MONTh Sets the month or queries the current setting. 5-23

    :MISC:DATE:DAY Sets the day or queries the current setting. 5-23

    :MISC:DATE:HOUR Sets the hour or queries the current setting. 5-23

    :MISC:DATE:MINute Sets the minute or queries the current setting. 5-23

    :MISC:DATE:SET Applies the date and time change. 5-23

    :MISC:LANGuage Sets the language or queries the current setting. 5-23

    :MISC:LOCKout Sets local lockout or queries the current setting. 5-23

    :MISC:ARARmsound Sets the alarm sound or queries the current setting. 5-23

    :MISC:PSAVe Sets the power save mode when the AC adapter is connected

    or queries the current setting. 5-24

    :MISC:POWersave:AC Sets the power save using the AC adapter or queries

    the current setting 5-24:MISC:POWersave:BATTery Sets the power save using the battery pack or queries

    the current setting. 5-24

    :MISC:BRIGhtness:AC Sets the LCD Brightness using the AC adapter orqueries the current setting. 5-24

    :MISC:BRIGhtness:BATTery Sets the LCD Brightness using the battery pack orqueries the current setting. 5-24

    :MISC:LCD:BRIGhtness Sets the LCD brightness when the AC adapter is connected. or

    queries the current setting. 5-24

    :MISC:RLOSsmode Sets the reflection display or queries the current setting. 5-24

    NETWORK Group

    :NETWork:CONTrol:PASSword Sets the Password or queries the current setting. 5-25

    :NETWork:CONTrol:TIMeout Sets the Timeout Value or queries the current setting. 5-25

    :NETWork:CONTrol:USERname Sets the User Name or queries the current setting. 5-25

    :NETWork:DHCP Sets enabling or disabling the DHCP function or queriesthe current setting. 5-25

    :NETWork:GATeway Sets the gateway or queries the current setting. 5-25

    :NETWork:IPADdress Sets the IP address or queries the current setting. 5-25

    :NETWork:NETMask Sets the netmask or queries the current setting. 5-25

    :NETWork:STATe Sets enabling or disabling the Network or queries thecurrent setting. 5-26

    PRINt Group

    :PRINt:COLor Sets the print color or queries the current setting. 5-26

    :PRINt:DEVice Sets the printer port or queries the current setting. 5-26

    :PRINt:MAKer Sets the printer manufacturer or queries the current setting. 5-26

    :PRINt:EVENtlist Sets printing the event list or queries the current setting. 5-26

    5.1 A List of Commands

  • 7/28/2019 Communication Interface OTDR

    34/69

    5-5IM 735020-17E

    Commands

    5

    Command Function Page

    SETup Group

    :SETup:INITialize Initializes all the settings (factory default condition). 5-27

    STATus Group

    :STATus? Queries all settings related to the communication status. 5-27

    :STATus:CONDition? Queries the contents of the condition register. 5-27:STATus:ERRor? Queries the code and message of the error that occurred. 5-27

    :STATus:QENable Sets whether to store in the error queue or queries the currentsetting.(messages other than errors) 5-27

    :STATus:QMESsage Sets whether to attach the message to the response orqueries the current setting.(response to STATus:ERRor?) 5-27

    WAVedata Group

    :WAVedata:LENGth? Queries the number of waveform data values. 5-28

    :WAVedata:DISPlay:SEND:ASCii? Queries the display waveform data in ASCII format. 5-28

    :WAVedata:DISPlay:SEND:BINary? Queries the display waveform data in binary format. 5-28

    :WAVedata:OLDType:DISPlay:SEND? Queries the display waveform data in Dot 4 format. 5-28

    :WAVedata:OLDType:SEND? Queries the waveform data in Dot 4 format. 5-28

    :WAVedata:SEND:ASCii? Queries the waveform data in ASCII format. 5-28

    :WAVedata:SEND:BINary? Queries the waveform data in binary format. 5-28

    :WAVedata:SEND:STARt Sets the start distance of the wavedata or queries thecurrent setting. 5-28

    :WAVedata:SEND:SIZE Sets the number of waveform data to acquire or queriesthe current setting. 5-28

    SYSTem Group

    :SYSTem:REBoot Execution of restarting 5-28

    :SYSTem:SHUTdown Execution of shutdown 5-28

    LIGHtsource Group

    :LIGHtsource:ABORt Turns OFF the light source. 5-29

    :LIGHtsource:EXECute Turns ON the light source. 5-29

    :LIGHtsource:MODulation Sets the modulation frequency of the light source or queriesthe current setting. 5-29

    :LIGHtsource:WAVelength Sets the wavelength of the light source or queries the currentsetting. 5-29

    VLS Group

    :VLS:ABORt Turns OFF the visible light source. 5-29

    :VLS:EXECute Turns ON the visible light source. 5-29

    PMONitor Group

    :PMONitor:WAVelength Sets the wavelength of the power monitor or queries the currentsetting. 5-30

    :PMONitor:ZERoset Resets the power monitor to zero. 5-30

    :PMONitor:DREF Sets the reference value of the relative measurement of thepower monitor. 5-30

    :PMONitor:REFerence Sets the power monitor reference or queries the current setting. 5-30

    :PMONitor:OFFSet Sets the power monitor offset or queries the current setting. 5-30

    :PMONitor:THReshold Sets the threshold level of the power monitor or queries the

    current setting. 5-30

    :PMONitor:UNIT Sets the display unit of the power monitor or queries the currentsetting. 5-30

    :PMONitor:MEASurement:DATA? Queries the measured result of the power monitor. 5-30

    5.1 A List of Commands

  • 7/28/2019 Communication Interface OTDR

    35/69

    5-6 IM 735020-17E

    *CLS(Clear Status)

    Function Clears all event status registers, the summary

    of which is reflected in the status byte register.

    Syntax *CLS

    Example *CLS

    Description Clears all queues, with the exception of the

    output queue, and all event registers, with the

    exception of the MAV summary message.

    After executing this command, OCIS

    (Operation Complete Command Idle State)

    and OQIS (Operation Complete Query Idle

    State) are brought about.

    *ESE(Standard Event Status Enable)Function Sets/queries the standard event enable register.

    Syntax *ESE

    *ESE?

    = 0 to 255

    Example *ESE251

    *ESE?->251

    Description An item having had its bit set becomes

    enabled.

    Resets to the default value in the following

    cases:

    When power is ON

    When 0 is set The set value remains the same in the

    following cases:

    *RST

    *CLS

    Device clear (DCL, SDC)

    The default is 0.

    *ESR?(Standard Event Status Register)

    Function Queries the standard event status register and

    simultaneously clears it.

    Syntax *ESR?

    Example *ESR?->251

    Description The return value of this query is not affected by

    ESE (Event Status Enable Register).

    *IDN? (Identification)

    Function Queries the instrument type and firmware

    version.

    Syntax *IDN?

    Example *IDN?->YOKOGAWA,735026,

    SN123456789,F1.00

    SN123456789:Serialnumber

    (9digitstring)

    F1.00: Firmware version

    Description Outputs 4 field data delimited by a comma.

    Field 1: Manufacturer YOKOGAWA

    Field 2: Model 735026

    Field 3: Instrument serial number

    "SN123456789"

    Field 4: Software version "F1.00"

    *RST (Reset)

    Function Executes a device reset to return the instrument

    to the known (default) status.

    Syntax *RST

    Example *RST

    Description Stops operation being processed and returns

    the instrument to the known set value (default

    value) immediately.

    This units parameters are cleared.

    The following items will remain the same.Output queue

    SRE

    ESE

    Calibration data affecting the instruments

    specifications

    *SRE(Service Request Enable)

    Function Sets/queries the service request enable register.

    Syntax *SRE

    *SRE?

    = 0 to 255

    Example *SRE250

    *SRE?->250Description An item having had its bit set becomes

    enabled.

    Resets to the default value in the following

    cases:

    When power is ON

    When 0 is set

    The set value remains the same in the

    following cases:

    *RST

    *CLS

    Device clear (DCL, SDC)

    The default is 0.

    5.2 Common Commands

  • 7/28/2019 Communication Interface OTDR

    36/69

    5-7IM 735020-17E

    Commands

    5

    5.2 Common Commands

    *STB?(Read Status Byte)

    Function Queries the current value of the status byte

    register.

    Syntax *STB?

    Example *STB?->251

    Description STB will not be cleared even when the contentsof the register are read.

    *TST?(Self Test)

    Function Performs the instrument's self-test and queries

    the status.

    Syntax *TST?

    Example *TST?->0

    Description Executes the operations below among the

    initialization sequence at startup and outputs

    the results. The screen retains the waveform

    screen while the initialization is in progress.

    Internal battery checkInternal memory read check

    "0" is returned if both checks are successful, "1"

    if they are not.

    *OPT?

    Function Retrieves the information of the mounted option.

    Syntax *OPT?

    Example *OPT?->PM,LS,PL

    Description Outputs the data delimited by a comma.

    Optical power monitor function: PM

    Light source function: LS

    Internal printer and LAN: PL(Ethernet interface)

    Dummy fiber (SMF): DF

    Shoulder belt: SB

  • 7/28/2019 Communication Interface OTDR

    37/69

    5-8 IM 735020-17E

    5.3 Device-Specific Commands

    :ACQuire:AUTO:DRANge?

    Function Queries the distance range for AUTO.Syntax :ACQuire:AUTO:DRANge?

    Example :ACQuire:AUTO:DRANge?

    ->:ACQ:AUT:DRAN20000

    Description The unit is set to s. (second)

    :ACQuire:AUTO:PWIDth?

    Function Queries the pulse width for AUTO.

    Syntax :ACQuire:AUTO:PWIDth?

    Example :ACQuire:AUTO:PWIDth?

    ->:ACQ:AUT:PWID100E-09

    :ACQuire:AVERage:CONTinue

    Function Sets the averaging measurement continue orqueries the current setting.

    Syntax :ACQuire:AVERage

    :CONTinue{}

    :ACQuire:AVERage:CONTinue?

    Example :ACQuire:AVERage:CONTinueON

    :ACQuire:AVERage:CONTinue?

    ->:ACQ:AVER:CONT1

    :ACQuire:AVERage:COUNt?

    Function Queries the current average count.

    Syntax :ACQuire:AVERage:COUNt?

    Example :ACQuire:AVERage:COUNt?

    ->:ACQ:AVER:COUN0

    :ACQuire:AVERage:INDex

    Function Sets the average count or queries the current

    setting.

    Syntax :ACQuire:AVERage

    :INDex{AUTO|E2_10|E2_11.E2_20}

    :ACQuire:AVERage:INDex?

    Example :ACQuire:AVERage:INDexAUTO

    :ACQuire:AVERage:INDexE2_12

    :ACQuire:AVERage:INDex?

    ->:ACQ:AVER:INDE2_15

    Description Setting the averaging countAuto: AUTO

    2E+10: E2_10

    2E+11: E2_11

    2E+20: E2_20

    ACQuire Group

    The commands in this group deal with the waveform

    acquisition. You can make the same settings and inquiries

    as when the front panel is used. Change the measurement

    conditions through remote control while the measurement is

    stopped. You cannot change the measurement conditions

    while realtime or averaging measurement is in progress.

    Only :REALtime:STOP or AVERage:STOP is valid while the

    measurement is in progress.

    :ACQuire:ADSave

    Function Sets the automatic data storage to the file after

    the execution of the averaging measurement or

    queries the current setting.Syntax :ACQuire:ADSave{}

    :ACQuire:ADSave?

    Example :ACQuire:ADSaveON

    :ACQuire:ADSave?->:ACQ:ADS1

    :ACQuire:AESearch

    Function Sets the automatic event detection after the

    execution of the averaging measurement or

    queries the current setting.

    Syntax :ACQuire:AESearch{}

    :ACQuire:AESearch?

    Example :ACQuire:AESearchOFF

    :ACQuire:AESearch?->:ACQ:AES0

    :ACQuire:ATTenuation

    Function Sets the attenuation or queries the current

    setting.

    Syntax :ACQuire:ATTenuation{|AUTO}

    :ACQuire:ATTenuation?

    = 0.00to 27.50(steps of 2.5)

    Example :ACQuire:ATTenuation2.5

    :ACQuire:ATTenuationAUTO

    :ACQuire:ATTenuation?

    ->:ACQ:ATT25.00

    Description The selectable range varies depending on the

    wavelength, distance range, and pulse width.

    You cannot set the attenuation if the average

    mode is high reflection.

    You cannot set the pulse width if the distance

    range is set to auto.

    :ACQuire:AUTO:ATTenuation?

    Function Queries the attenuation for AUTO.

    Syntax :ACQuire:AUTO:ATTenuation?

    Example :ACQuire:AUTO:ATTenuation?

    ->:ACQ:AUT:ATT0.00

    Description The unit is set to m. (meter)

  • 7/28/2019 Communication Interface OTDR

    38/69

    5-9IM 735020-17E

    Commands

    :ACQuire:AVERage:MODE

    Function Sets the average mode or queries the current

    setting.

    Syntax :ACQuire:AVERage

    :MODE{HIREFLECTION|HISPEED}

    :ACQuire:AVERage:MODE?Example :ACQuire:AVERage:MODEHIREFLECTION

    :ACQuire:AVERage:MODE?

    ->:ACQ:AVER:MODEHISPEED

    Description High Reflection : HIREFLECTION

    High Speed : HISPEED

    :ACQuire:AVERage:STARt

    Function Executes the averaging measurement.

    Syntax :ACQuire:AVERage:STARt

    Example :ACQuire:AVERage:STARt

    Description This command is valid while the averaging

    measurement is only in progress.

    :ACQuire:AVERage:STOP

    Function Stops the averaging measurement.

    Syntax :ACQuire:AVERage:STOP

    Example :ACQuire:AVERage:STOP

    :ACQuire:AVERage:TIME

    Function Sets the average time or queries the current

    setting.

    Syntax :ACQuire:AVERage:TIME{|AUTO}

    :ACQuire:AVERage:TIME?

    = 2 to 1800

    Example :ACQuire:AVERage:TIMEAUTO :ACQuire:AVERage:TIME1200

    :ACQuire:AVERage:TIME?

    ->:ACQ:AVER:TIME60

    Description The following value can be set.

    Auto: AUTO

    2 sec: 2

    5 sec: 5

    10 sec: 10

    20 sec: 20

    30 sec: 30

    1 min: 60

    3 min: 180

    5 min: 300

    10 min: 60020 min: 1200

    30 min: 1800

    :ACQuire:AVERage:TYPE

    Function Sets the average unit or queries the current

    setting.

    Syntax :ACQuire:AVERage

    :TYPE{TIMES|DURATION}

    :ACQuire:AVERage:TYPE?

    Example :ACQuire:AVERage:TYPETIMES

    :ACQuire:AVERage:TYPEDURATION

    :ACQuire:AVERage:TYPE?

    ->:ACQ:AVER:TYPEDURATION

    Description Times : TIMES

    Duration: DURATION

    :ACQuire:DRANge

    Function Sets the distance range or queries the current

    setting.

    Syntax :ACQuire:DRANge{|AUTO}

    :ACQuire:DRANge?

    = 500m to 512000m(0.5km to 512km)Example :ACQuire:DRANgeAUTO

    :ACQuire:DRANge500

    :ACQuire:DRANge500m

    :ACQuire:DRANge5000

    :ACQuire:DRANge100km

    :ACQuire:DRANge?->:ACQ:DRAN1000

    Description The value that you can specify varies

    depending on the wavelength setting.

    The selectable distance range varies depending

    on the wavelength

    Setting the distance range

    Auto: AUTO

    500 m: 500

    1 km: 1000

    2 km: 2000

    5 km: 5000

    10 km : 10000

    20 km: 20000

    50 km : 50000

    100 km: 100000

    200 km: 200000

    300 km: 300000

    400 km: 400000

    512 km 512000

    :ACQuire:MWAVelength:WAVelength

    Function Sets a wavelength for multi wavelengthmeasurement or queries the current setting.

    Syntax :ACQuire:MWAVelength:

    WAVelength{}

    :ACQuire:MWAVelength:WAVelength?

    = 850E09to1650E09

    = 1to3

    Example :ACQUIRE:MWAVELENGTH:

    WAVELENGTH850E09

    :ACQUIRE:MWAVELENGTH:WAVELENGTH?->:

    ACQUIRE:MWAVELENGTH:

    WAVELENGTH850.0E09

    :ACQuire:OFFSet

    Function Sets the horizontal measurement start position

    or queries the current setting.

    Syntax :ACQuire:OFFSet{}

    :ACQuire:OFFSet?

    Example :ACQuire:OFFSet1000

    :ACQuire:OFFSet?

    ->:ACQ:OFFS999.99265E+00

    Description The unit is set to m. (meter)

    5

    5.3 Device-Specific Commands

  • 7/28/2019 Communication Interface OTDR

    39/69

    5-10 IM 735020-17E

    :ACQuire:PLUGcheck

    Function Sets the connection check of the optical plug or

    queries the current setting.

    Syntax :ACQuire:PLUGcheck{}

    :ACQuire:PLUGcheck?

    Example :ACQuire:PLUGcheckON :ACQuire:PLUGcheck?->:ACQ:PLUG0

    :ACQuire:PWIDth

    Function Sets the pulse width or queries the current

    setting.

    Syntax :ACQuire:PWIDth{|AUTO}

    :ACQuire:PWIDth?

    = 3ns to 20us(3E-9 to 20E-6)

    Example :ACQuire:PWIDthAUTO

    :ACQuire:PWIDth3

    :ACQuire:PWIDth3E-9

    :ACQuire:PWIDth3ns :ACQuire:PWIDth10us

    :ACQuire:PWIDth10E-6

    :ACQuire:PWIDth?

    ->:ACQ:PWID20.0E-06

    Description The value that you can specify varies

    depending on the wavelength and distance

    range.

    You cannot set the pulse width if the distance

    range is set to auto.

    The value that you can specify varies depending

    on the wavelength and distance range.

    You cannot set the pulse width if the distance

    range is set to auto.

    Auto: AUTO

    3 ns: 3E-09

    10 ns: 10E-09

    20 ns: 20E-09

    50 ns: 50E-09

    100 ns: 100E-09

    200 ns: 00E-09

    500 ns: 500E-09

    1 us: 1E-06

    2 us: 2E-06

    5 us: 5E-06

    10 us: 10E-06

    20 us: 20E-06

    :ACQuire:REALtime:STARt

    Function Executes the realtime measurement.

    Syntax :ACQuire:REALtime:STARt

    Example :ACQuire:REALtime:STARt

    Description This command is valid while the measurement

    is stopped.

    :ACQuire:REALtime:STOP

    Function Stops the realtime measurement.

    Syntax :ACQuire:REALtime:STOP

    Example :ACQuire:REALtime:STOP

    Description This command is valid while the realtime

    measurement is only in progress.

    :ACQuire:SETTing

    Function Sets the setup mode or queries the current

    setting.

    Syntax :ACQuire:SETTing{SIMPLE|DETAIL

    |WIZARD|MULTI}

    :ACQuire:SETTing?Example :ACQuire:SETTingDETAIL

    :ACQuire:SETTing?

    ->:ACQ:SETTSIMPLE

    Description Simple mode: SIMPLE

    Detail mode: DETAIL

    Detail wizard mode: WIZARD

    Multi-wavelength mode: MULTI

    :ACQuire:SMPinterval:DATA

    Function Sets the sampling interval or queries the current

    setting.

    Syntax :ACQuire:SMPinterval

    :DATA{|NORMAL|HI}

    :ACQuire:SMPinterval:DATA?

    Example :ACQuire:SMPinterval:DATA2.0

    :ACQuire:SMPinterval:DATANORMAL

    :ACQuire:SMPinterval:DATA?

    ->:ACQ:SMP:DATAHI

    Description You only set NORMAL or HI if the distance

    range is set to auto.

    You only set NORMAL or HI if the distance

    range is set to auto.

    Normal: NORMAL

    High resolution: HI

    5 cm: 0.05

    10 cm: 0.1020 cm : 0.20

    50 cm : 0.50

    1 m: 1.00

    2 m: 2.00

    4 m: 4.00

    8 m: 8.00

    16 m: 16.00

    32 m: 32.00

    :ACQuire:SMPinterval:VALue?

    Function Queries the sampling interval.

    Syntax :ACQuire:SMPinterval:VALue?

    Example :ACQuire:SMPinterval:VALue?

    ->:ACQ:SMP:VAL8.0

    :ACQuire:WAVelength

    Function Sets the measured wavelength or queries the

    current setting.

    Syntax :ACQuire:WAVelength{}

    :ACQuire:WAVelength?

    = 0.850um to 1.650um

    (850E-9 to 1650E-9)

    Example :ACQuire:WAVelength0.85um

    :ACQuire:WAVelength1650E-9

    :ACQuire:WAVelength1.650E-6

    :ACQuire:WAVelength?

    ->:ACQ:WAV1550E-09

    Description The wavelength that you can specify varies

    depending on the model.

    5.3 Device-Specific Commands

  • 7/28/2019 Communication Interface OTDR

    40/69

    5-11IM 735020-17E

    Commands

    ANALysis Group

    The commands in this group deal with waveform analysis.

    You can make the same settings and inquiries as when the

    front panel is used.

    :ANALysis:ASEarch:EXECute

    Function Executes auto detection.

    Syntax :ANALysis:ASEarch:EXECute

    Example :ANALysis:ASEarch:EXECute

    :ANALysis:ASEarch:NUMber?

    Function Queries the number of auto detection events.

    Syntax :ANALysis:ASEarch:NUMber?

    Example :ANALysis:ASEarch:NUMber?

    ->:ANAL:ASE:NUM2

    :ANALysis:BCOefficient

    Function Sets the backscattering light level of the current

    wavelength or queries the current setting.

    Syntax :ANALysis:BCOefficient{}

    :ANALysis:BCOefficient?

    = -10.00 to -64.99(stepsof0.01)

    Example :ANALysis:BCOefficient-25.00

    :ANALysis:BCOefficient?

    ->:ANAL:BCO-50.00

    :ANALysis:IOR

    Function Sets the group refraction index of the current

    wavelength or queries the current setting.

    Syntax :ANALysis:IOR{}

    :ANALysis:IOR? = 1.30000 to 1.79999

    (stepsof0.00001)

    Example :ANALysis:IOR1.48000

    :ANALysis:IOR?

    ->:ANAL:GIND1.48000

    :ANALysis:CURSor:DELete

    Function Clears the cursor.

    Syntax :ANALysis:CURSor:DELete

    Example :ANALysis:CURSor:DELete

    :ANALysis:CURSor:DISTance

    Function Sets the cursor position or queries the current

    setting.

    Syntax :ANALysis:CURSor:DISTance{}

    :ANALysis:CURSor:DISTance?

    =Dependondistancerange, distancereferenceandIOR.

    Example :ANALysis:CURSor:DISTance10.00

    :ANALysis:CURSor:DISTance?

    ->:ANAL:CURS:DIST11.529900E+00

    Description Depending on the distance range, distance

    reference and group refraction.

    :ANALysis:CURSor:DECibel?

    Function Queries the cursor dB (decibel).

    Syntax :ANALysis:CURSor:DECibel?

    Example :ANALysis:CURSor:DECibel?

    ->:ANAL:CURS:DEC32.878

    :ANALysis:EMARker:LMTechnique

    Function Sets the approximation method (event) or

    queries the current setting.

    Syntax :ANALysis:EMARker

    :LMTechnique{LSA|TPA}

    :ANALysis:EMARker:LMTechnique?

    Example :ANALysis:EMARker:LMTechniqueLSA

    :ANALysis:EMARker:LMTechnique?

    ->:ANAL:EMAR:LMTTPA

    :ANALysis:EMARker:SET:M1

    Function Sets marker M1 of the current event or queriesthe current setting.

    Syntax :ANALysis:EMARker:SET:M1

    :ANALysis:EMARker:SET:M1?

    Example :ANALysis:EMARker:SET:M1

    :ANALysis:EMARker:SET:M1?

    ->:ANAL:EMAR:SET:M15.0471900E+03

    Description The marker is set to the cursor position when

    you set the marker.

    :ANALysis:EMARker:SET:M2

    Function Sets marker M2 of the current event or queries

    the current setting.

    Syntax :ANALysis:EMARker:SET:M2

    :ANALysis:EMARker:SET:M2?

    Example :ANALysis:EMARker:SET:M2

    :ANALysis:EMARker:SET:M2?

    ->:ANAL:EMAR:SET:M27.2463500E+03

    Description The marker is set to the cursor position when

    you set the marker.

    5

    5.3 Device-Specific Commands

  • 7/28/2019 Communication Interface OTDR

    41/69

    5-12 IM 735020-17E

    :ANALysis:EMARker:SET:M3

    Function Sets marker M3 of the current event or queries

    the current setting.

    Syntax :ANALysis:EMARker:SET:M3

    :ANALysis:EMARker:SET:M3?

    Example :ANALysis:EMARker:SET:M3 :ANALysis:EMARker:SET:M3?

    ->:ANAL:EMAR:SET:M39.0471600E+03

    Description The marker is set to the cursor position when

    you set the marker.

    :ANALysis:EMARker:SET:Y2

    Function Sets marker Y2 of the current event or queries

    the current setting.

    Syntax :ANALysis:EMARker:SET:Y2

    :ANALysis:EMARker:SET:Y2?

    Example :ANALysis:EMARker:SET:Y2

    :ANALysis:EMARker:SET:Y2? ->:ANAL:EMAR:SET:Y27.3777700E+03

    Description The marker is set to the cursor position when

    you set the marker.

    :ANALysis:DUNit

    Function Sets the distance unit or queries the current

    setting.

    Syntax :ANALysis:DUNit{KM|MILE|KF}

    :ANALysis:DUNit?

    Example :ANALysis:DUNitKM

    :ANALysis:DUNit?->:ANAL:DUNMILE

    Description Setting the Distance Unit

    km: KM

    mile: MILE

    kf: KF

    :ANALysis:EVENt:CURRent:INDex

    Function Changes the current event.

    Syntax :ANALysis:EVENt:CURRent

    :INDex{}

    =Eventnumber

    Example :ANALysis:EVENt:CURRent:INDex5

    Description The event of the specified number is the current

    event.

    Event number: 1 to 100S point, R point: 1

    E point: 0

    :ANALysis:EVENt:CURRent:NOTE

    Function Sets the event note or queries the current

    setting.

    Syntax :ANALysis:EVENt:CURRent

    :NOTE{}

    :ANALysis:EVENt:CURRent:NOTE? =up to 36 characters

    Example :ANALysis:EVENt:CURRent:NOTE"aaa"

    :ANALysis:EVENt:CURRent:NOTE?

    ->:ANAL:EVEN:CURR:NOTE"123"

    Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    Enter a comment for the current event.

    You can enter the comment using up to 36

    characters.

    :ANALysis:EVENt:IOR

    Function Sets the section IOR of the current event or

    queries the current setting.

    Syntax :ANALysis:EVENt:IOR{}

    :ANALysis:EVENt:IOR?

    = 1.30000 to 1.79999

    (stepsof0.00001)

    Example :ANALysis:EVENt:IOR1.47:ANALysis

    :EVENt:IOR?

    ->:ANAL:EVEN:GIND1.46000

    :ANALysis:EVENt:CURRent:DISTance?

    Function Retrieves the distance of the current event.

    Syntax :ANALysis:EVENt:CURRent:DISTance?Example :ANALYSIS:EVENT:CURRENT:DISTANCE?

    ->987.000

    Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    :ANALysis:EVENt:CURRent:LOSS?

    Function Retrieves the splice loss of the current event.

    Syntax :ANALysis:EVENt:CURRent:LOSS?

    Example :ANALYSIS:EVENT:CURRENT:LOSS?

    ->2.000

    Description The index number must be set ahead of timewith the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    :ANALysis:EVENt:CURRent:RETurnloss?

    Function Retrieves the return loss of the current event.

    Syntax :ANALysis:EVENt:CURRent:RETurnloss?

    Example :ANALYSIS:EVENT:CURRENT:RETURNLOSS?

    ->2.000

    Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    5.3 Device-Specific Commands

  • 7/28/2019 Communication Interface OTDR

    42/69

    5-13IM 735020-17E

    Commands

    :ANALysis:EVENt:CURRent:CUMLoss?

    Function Retrieves the accumulated loss of the current

    event.

    Syntax :ANALysis:EVENt:CURRent:CUMLoss?

    Example :ANALYSIS:EVENT:CURRENT:CUMLOSS?

    ->1.810Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    :ANALysis:EVENt:CURRent:UNITloss?

    Function Retrieves the loss per unit (dB/m) of the current

    event.

    Syntax :ANALysis:EVENt:CURRent:UNITloss?

    Example :ANALYSIS:EVENT:CURRENT:UNITLOSS?

    ->2.000

    Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDexcommand before using this command.

    :ANALysis:EVENt:CURRent:TYPE?

    Function Retrieves the event type of the current event.

    Syntax :ANALysis:EVENt:CURRent:TYPE?

    Example :ANALYSIS:EVENT:CURRENT:TYPE?

    ->REFLECTANCE

    Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    Reflection: REFLectance

    Positive loss: SPLus

    Negative loss: SMINus

    Bending loss BENDing

    :ANALysis:EVENt:CURRent:IOR?

    Function Retrieves the section IOR of the current event.

    Syntax :ANALysis:EVENt:CURRent:IOR?

    Example :ANALYSIS:EVENT:CURRENT:IOR?

    ->1.46000

    Description The index number must be set ahead of time

    with the :ANALysis:EVENt:CURRent:INDex

    command before using this command.

    :ANALysis:EVENt:DELete

    Function Deletes the current event.

    Syntax :ANALysis:EVENt:DELete

    Example :ANALysis:EVENt:DELete

    :ANALysis:EVENt:INSert

    Function Inserts the event at the cursor position.

    Syntax :ANALysis:EVENt:INSert

    Example :ANALysis:EVENt:INSert

    :ANALysis:FEDetection

    Function Sets the fault event display or queries the

    current setting.

    Syntax :ANALysis:FEDetection{}

    :ANALysis:FEDetection?

    Example :ANALysis:FEDetectionON :ANALysis:FEDetection?

    ->:ANAL:FED0

    :ANALysis:FMARker:DELete

    Function Deletes the marker.

    Syntax :ANALysis:FMARker:DELete

    Example :ANALysis:FMARker:DELete

    :ANALysis:FMARker:LMTechnique

    Function Sets the approximation method of the marker or

    queries the current setting.

    Syntax :ANALysis:FMARker

    :LMTechnique{LSA|TPA}

    :ANALysis:FMARker:LMTechnique?

    Example :ANALysis:FMARker:LMTechniqueLSA

    :ANALysis:FMARker:LMTechnique?

    ->:ANAL:FMAR:LMTTPA

    Description Least squares approximation: LSA

    Two point approximation: TPA

    :ANALysis:FMARker:LOSS?

    Function Queries the splice loss.

    Syntax :ANALysis:FMARker:LOSS?

    Example :ANALysis:FMARker:LOSS?

    ->:ANAL:FMAR:LOSS162.00000E-03

    :ANALysis:FMARker:RETurnloss:VALue?

    Function Queries the return loss.

    Syntax :ANALysis:FMARker:RETurnloss:VALue?

    Example :ANALysis:FMARker:RETurnloss:VALue?

    ->:ANAL:FMAR:RET:VAL47.003000E+00

    :ANALysis:FMARker:RETurnloss:

    SATurated?

    Function Queries the saturation of the return loss.

    Syntax :ANALysis:FMARker:RETurnloss

    :SATurated?Example :ANALysis:FMARker:RETurnloss

    :SATurated?

    ->:ANAL:FMAR:RET:SAT1

    Description Unsaturated: 0

    Saturated: 1

    :ANALysis:FMARker:REFLection:VALue?

    Function Queries the reflection level.

    Syntax :ANALysis:FMARker:REFLection:VALue?

    Example :ANALysis:FMARker:REFLection:VALue?

    ->:ANAL:FMAR:REFL:VAL1.0640000E+00

    5

    5.3 Device-Specific Commands

  • 7/28/2019 Communication Interface OTDR

    43/69

    5-14 IM 735020-17E

    :ANALysis:FMARker:REFLection:

    SATurated?

    Function Queries the saturation of the reflection level.

    Syntax :ANALysis:FMARker:REFLection:

    SATurated?

    Example :ANALysis:FMARker:REFLection: SATurated?

    ->:ANAL:FMAR:REFL:SAT0

    Description Unsaturated: 0

    Saturated: 1

    :ANALysis:FMARker:LEFT:LOSS?

    Function Queries the loss between markers 1 and 2.

    Syntax :ANALysis:FMARker:LEFT:LOSS?

    Example :ANALysis:FMARker:LEFT:LOSS?

    ->:ANAL:FMAR:LEFT

    :LOSS137.00000E-03

    :ANALysis:FMARker:LEFT:DISTance?

    Function Queries the distance between markers 1 and 2.

    Syntax :ANALysis:FMARker:LEFT:DISTance?

    Example :ANALysis:FMARker:LEFT:DISTance?

    ->:ANAL:FMAR:LEFT

    :DIST490.20000E+00

    :ANALysis:FMARker:LEFT:UNITloss?

    Function Queries the slope between markers 1 and 2.

    Syntax :ANALysis:FMARker:LEFT:UNITloss?

    Example :ANALysis:FMARker:LEFT:UNITloss?

    ->:ANAL:FMAR:LEFT

    :UNIT279.00000E-03

    :ANALysis:FMARker:RIGHt:LOSS?

    Function Queries the loss between markers 2 and 3.

    Syntax :ANALysis:FMARker:RIGHt:LOSS?

    Example :ANALysis:FMARker:RIGHt:LOSS?

    ->:ANAL:FMAR:RIGH

    :LOSS-159.00000E-03

    :ANALysis:FMARker:RIGHt:DISTance?

    Function Queries the distance between markers 2 and 3.

    Syntax :ANALysis:FMARker:RIGHt:DISTance?

    Example :ANALysis:FMARker:RIGHt:DISTance? ->:ANAL:FMAR:RIGH

    :DIST232.95000E+00

    :ANALysis:FMARker:RIGHt:UNITloss?

    Function Queries the slope between markers 2 and 3.

    Syntax :ANALysis:FMARker:RIGHt:UNITloss?

    Example :ANALysis:FMARker:RIGHt:UNITloss?

    ->:ANAL:FMAR:RIGH

    :UNIT-683.00000E-03

    :ANALysis:FMARker:SET:M

    Function Sets the marker or queries the current setting.

    Syntax :ANALysis:FMARker:SET:M

    :ANALysis:FMARker:SET:M?

    = 1,2,3

    Example :ANALysis:FMARker:SET:M1 :ANALysis:FMARker:SET:M1?

    ->ANAL:FMAR:SET:M17.2648300E+03

    :ANALysis:FMARker:SET:Y

    Function Sets the auxiliary marker or queries the current

    setting.

    Syntax :ANALysis:FMARker:SET:Y

    :ANALysis:FMARker:SET:Y?

    = 1,2,3

    Example :ANALysis: