Tektronix FCA3000, FCA3003, FCA3103, FCA3120, MCA3027 Programmer's Manual

...

Download

FCA3000, FCA3100, MCA3000 Series

ZZZ

Timer/Counter/Analyzers

Programmer Manual

*P077049400*

077-0494-00

FCA3000, FCA3100, MCA3000 Series

ZZZ

Timer/Counter/Analyzers

Programmer Manual

Revision A

www.tektronix.com

077-0494-00

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions.

Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Speciﬁcations and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

Contacting

Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 50 Beaverton, OR 97077 USA

For product information, sales, service, and technical support:

In North America, call 1-800-833-9200. Worl dwi

Tektronix

de, visit www.tektronix.com to ﬁnd contacts in your area.

Preface .............................................................................................................. iii

Getting Started

Setting Up the Instrument ... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ... . . . .... . . .... . ..... . 1-1

Interface Functions .... ................................ ................................ ........................... 1-2

Using the USB Interface.............. ................................ .................................. ......... 1-3

Syntax and Commands

Command Syntax.................... ................................ .................................. ........... 2-1

Command and Query Structure ............................................................................ 2-1

Clearing the Instrument ..................................................................................... 2-2

Command Entry.............................................................................................. 2-3

Argument Types..................................... ................................ ......................... 2-4

Macros ........................................................................................................ 2-6

Command Groups .............................................................................................. 2-11

Arming Subsystem ....... ................................ .................................. ............... 2-11

Calculate Subsystem...................... .................................. ............................... 2-11

Calibration Subsystem ........... ................................ ................................ ......... 2-13

Conﬁgure Function ............................... ................................ ......................... 2-13

Display Subsystem ........................................................................................ 2-14

Fetch Function ............................................................................................. 2-14

Format Subsystem ......................................................................................... 2-15

Hard Copy .................................................................................................. 2-15

Initiate Subsystem ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ... . . . .... . ..... . ..... . ..... . 2-16

Input Subsystem ........................................................................................... 2-16

Measurement Subsystem..... ................................ ................................ ............. 2-17

Memory Subsystem ....................................................................................... 2-19

Output Subsystem ......................................................................................... 2-20

Read Function ......................... ................................ .................................. ... 2-20

Sense Command Subsystem........... .................................. ................................ . 2-20

Status Subsystem ............. ................................ .................................. ........... 2-21

System Subsystem ......................................................................................... 2-22

Test Subsystem............................................................................................. 2-23

Trigger Subs

Common Commands...................................................................................... 2-27

ystem ......................................................................................... 2-23

FCA3000, FCA3100, MCA3000 Series Programmer Manual i

Table of Contents

Command Descri

Status and Eve

Status and Events ................................................................................................. 3-1

Registers ..................... ................................ .................................. ............... 3-1

Queues ........................................................................................................ 3-4

Event Handling Sequence................................................................................... 3-5

Synchronization Methods.......... ................................ ................................ ......... 3-6

Error Messages............................................................................................. 3-10

ptions ........................................................................................ 2-29

nts

Programming Examples

Programming Examples .......... ................................ .................................. ............. 4-1

Introduction................................................................................................... 4-1

Individual Measurements (Example #1) .................................................................. 4-2

Block Measurements (Example #2) .......... ................................ ............................. 4-4

Fast Measurements (Example #3).......................................................................... 4-6

USB Co

Continuous Measurements (Example #5)...... ................................ ......................... 4-11

mmunication (Example #4)................ ................................ ....................... 4-9

Appendices

Appendix A: Character Set ..................................................................................... A-1

endix B: Default Command Settings..................................................................... B-1

App

Appendix C: Instrument Settings After *RST. ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ..... . ... C-1

Appendix D: Reserved Words.................................................................................. D-1

ii FCA3000, FCA3100, MCA3000 Series Programmer Manual

Preface

This programmer manual covers the Tektronix FCA3000, FCA3100, and MCA3000 Series Timer/Counter/Analyzer instruments. It provides information on operating or USB interface.

your instrument using the General Purpose Interface Bus (GPIB)

The program

Getting Started. This section introduces you to the programming information and provid control.

Syntax an provides tables that list all the commands by functional groups, and describes all commands in alphabetical order.

Status and Events. This section discusses the status and event reporting system for the GPIB interfaces. This system informs you of certain signiﬁcant events that occur within the instrument. Topics that are discussed include registers, queues, event handling sequences, synchronization methods, and messages that the instrument may return, including error messages.

Programming examples. This section provides example s of C code used to take measurements with the instruments.

Appendices. The appendices contain miscellaneous information such as a list of reserved words, a table of the factory initialization (default) settings, and

mer m anual contains the following sections:

es basic information about setting up your instrument for remote

d Commands. This section describes the command syntax structure,

interface speciﬁcations.

FCA3000, FCA3100, MCA3000 Series Programmer Manual iii

Preface

iv FCA3000, FCA3100, MCA3000 Series Programmer Manual

Getting Started

Setting Up the Instrument

Setting the GPIB Address

Standby Power and

Remote Access

Testing the Bus

The default GPIB address of the instrument is 10. Push USER OPT > Interface to see the active address above the soft key button labeled GPIB address.

To change the instrument GPIB address, push GPIB address and enter a new address value between 0 and 30. The GPIB address is stored in nonvolatile memory and remains until you change it.

You can also set the GPIB address remotely by using a GPIB command.

When the instrument is in REMOTE mode, you cannot power it off from the power button. You must ﬁrst push the Esc button to enter Local mode, and then push the Power button.

To test that the instrument is operational over the bus, send the *IDN? command to identify the instrument and the *OPT? command to identify which features are available.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 1-1

Interface Functions

Interface Fun

ctions

Table 1-1: In

Code Description

SH1 Source handshake: The instrument can exchange data with other instruments or

AH1 Acceptor handshake: The instrument can exchange data with other instruments

C0 Control function: The instrument does not function as a controller. T6

terface function summary

a controller using the bus handshake lines DAV, NRFD, and NADC.

or a controller using the bus handshake lines DAV, NRFD, and NADC.

Talker function: The instrument can send responses and the results of its measurem

Listen controller. L4 has the following functions:

ents to other devices or to the controller. T6 has the following functions:

Basic tal

No talke

Send out

Automat

Basic listener

No listen only

ker

r only

a status byte as response to a serial poll from the controller

ic unaddressing as a talker when it is addressed as a listener

er function: The instrument can receive programming instructions from the

Automatic unaddressing as listener when addressed as a talker

SR1 Service request: The instrument can call for attention from the controller, such as

when a measurement is complete d and a result is available.

RL1

PP0 DC1 Device clear function: The controller can reset the instrument by sending the

DT1

Remote/local function: You can control the instrument manually (locally) from the

nt panel or remotely from the controller. The LLO, local-lock-out function, can

fro disable the LOCAL button on the front panel.

Parallel poll: The instrument does not have any parallel poll facility.

interface message DCL (Device clear) or SDC (Selective Device Clear). Device trigger function: You can start a new measurement from the controller by

ending the interface message GET (Group Execute Trigger).

us drivers: The GPIB interfa ce has tri-state bus drivers.

1-2 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Using the USB Interface

Using the USB I

nterface

The instrume same command set as the GPIB interface.

The USB inte standard USBTMC (Universal Serial Bus Test and Measurement Class) revision

1.0, with the subclass USB488, revision 1.0. The full speciﬁcation for this protocol is at www.usb.org.

A valid driver for this protocol must be installed to be able to communicate over USB. We recommend NI-VISA version 3.2 or above, which is available from National Instruments (www.ni.com) for several operating systems. The Windows version is supplied on the product CD.

In order to test the communication and send single commands, use the National Instruments utility supplied with the NI-VISA drivers to open a VISA session to send an Remote or Local.

party application programs, such as LabView, normally support USB

Third communication directly, for example through the Instrument I/O Assistant.

om speciﬁc programs using USB communication can be written in C/C++,

Cust supported by libraries and lib-ﬁles supplied w ith the NI-VISA driver (default location C:\VXIPNP\WinNT\). A sample program is in included in the Examples section. (See page 4-9, USB Communication (Example #4).)

nt is equipped with a USB full speed interface, which supports the

rface is a full speed interface (12 Mbit/s), supporting the industry

d receive data from the instrument, and also set control signals such as

Instruments connected to the USB bus are identiﬁed by a unique vendor identiﬁer, the instrument model number and the instrument serial number. The structure of the instrument identiﬁer string is:

“USB0::0x0699::0x3003::######::INSTR”

Where:

0x0699 is the vendor identiﬁer code for Tektronix instruments

0x3003 is the instrument model (based on the last four digits of the model

number)

###### is the instrument serial number

Use this string to identify the instrument vendor, model, or serial number when searching for or connecting to a speciﬁc instrument.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 1-3

Using the USB Interface

1-4 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Syntax and Commands

Command Syntax

You can control the operations and functions of the instrument through the GPIB port or the USB 2.0 device port using commands and queries. The related topics listed below also describe the conventions that the instrument uses to process them. See the Command Groups topic in the table of contents for a listing of the commands by command group, or use the index to locate a speciﬁc command.

describe the syntax of these commands and queries. The topics

Backus-Naur Form

Notation

This documentation describes the commands and queries using Backus-Naur Form (BNF) notation. The following table lists the BNF notation symbols.

Table 2-1: Symbols for B ackus-Naur form

Symbol Meaning

<> =

| Exclusive OR { } Group; one element is required [] .. .

( ) Comment

Command and Query Structure

mmands consist of set commands and query commands (usually called

Co commands and queries). Commands modify instrument settings or tell the instrument to perform a speciﬁc action. Queries cause the instrument to return data and status information.

Deﬁned element Is deﬁned as

Optional; can be omitted Previous element(s) may be repeated

Most commands have both a set form and a query form. The query form of the command differs from the set form by its question mark at the end. For example, the set command Not all commands have both a set and a query form. Some commands have set only and some have query only.

Messages

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-1

A command message is a command or query name followed by any information the instrument needs to execute the command or query. Command messages may contain ﬁve element types, deﬁned in the following table.

ACQuisition:HOFF has a query form ACQuisition:HOFF?.

Command Syntax

Commands

Table 2-2: Comm

Symbol Meaning

<Argument

<Comma> A single c

<Space>

and message elements

This is the basic command name. If the header ends with a question mark, the command is a query. The header may begin with a colon (:) characte the beginning colon is required. Never use the beginning colon with command headers beginning with a star (*).

This is a header subfunction. Some command headers have only one mnemonic. I character always separates them from each other.

This is a qu Some commands have no arguments while others have multiple arguments. A <space> separates arguments from the header. A <comma> se

commands. Optionally, there may be white space characters before and after the comma.

A white space character is used between a command header and the related argument. Optionally, a white space may consist of multiple white sp

r. If the command is concatenated with other commands,

f a command header has multiple mnemonics, a colon (:)

antity, quality, restriction, or limit associated with the header.

parates arguments from each other.

omma is used between arguments of multiple-argument

ace characters.

Commands cause the instrument to perform a speciﬁc function or change one of the settings. Commands have the structure:

Queries

Clearing the Instrument

[:]<Header>[<Space><Argument>[<Comma> <Argument>]...]

A command header consists of one or more mnemonics arranged in a hierarchical or tree structure. The ﬁrst mnemonic is the base or root of the tree and each subsequent mnemonic is a level or branch off the previous one. Commands at a higher level in the tree may affect those at a lower level. The leading colon (:) always returns you to the base of the command tree.

Queries cause the instrument to return status o

r setting information. Queries

have the structure:

[:]<Header>

[:]<Header>[<Space><Argument> [<Comma><Argument>]...]

You can specify a query command at any level within the command tree unless otherwise noted. These branch queries return information about all the mnemonics below the speciﬁed branch or level.

You can clear the Output Queue and reset the instrument to accept a new command or query by using the selected Device Clear (DCL) function.

2-2 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Entry

Command Syntax

The following rules apply when entering commands:

You can enter commands in upper or lower case.

You can precede any command with white space characters. White space characters include any combination of the ASCII control characters 00 through 09 and 0B through 20 hexadecimal (0 through 9 and 11 through 32 decimal).

The instrument ignores commands consisting of any combination of white space characters and line feeds.

Abbreviating

tenating

Conca

You can abbreviate many instrument commands. The syntax of each command shows the minimum acceptable abbreviations in capitals. For example, you can enter the command or calc:aver:coun.

Abbreviation rules may change over time as new instrument models are introduced. Thus, for the most robust code, use the full spelling.

You can concatenate any combination of set commands and queries using a semicolon (;). The instrument executes concatenated commands in t he order received.

CALCulate:AVERage:COUNt as CALC:AVER:COUN

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-3

Command Syntax

When concatena

ting commands and queries, you must follow these rules:

1. Separate completely different headers by a semicolon and by the beginning colononallco the commands

into the following single command:

CALCULATE:AVERAGE:COUNT 20;INPUT:ATTENUATION 10

2. If concaten

mmands except the ﬁrst one. For example, you can concatenate

CALCULATE:AVERAGE:COUNT 20 and INPUT:ATTENUATION

ated commands have headers that differ by only the last mnemonic, you can abbreviate the second command and eliminate the beginning colon. For example, you can concatenate the commands

INPUT:ATTENUATION 10

and INPUT:COUPLING DC into a single command:

INPUT:ATTENUATION 10; COUPLING DC

The longer version works equally well:

INPUT:A

TTENUATION 10;INPUT:COUPLING DC

3. Never precede a star (*) command with a colon:

INPUT:ATTENUATION 10;*OPC

Any commands that follow are processed as if the star command was not there. For example, the commands

10;*OPC;INPUT:COUPLING DC

t coupling to DC.

inpu

set the input attenuation to 10X and set the

INPUT:ATTENUATION

Message Terminator

Argument Types

Enumeration

This documentation uses <EOM> (End of Message) to represent a message terminator. An incoming end of message terminator can be one of the following:

END message (EOI asserted concurrently with the last data byte). The last data byte may be an ASCII line feed (LF) character.

Combining LF and EOI.

The instrument always terminates outgoing messages with LF and EOI.

Commands use arguments such as enumeration, numeric, quoted string and block. Each of these arguments are listed in detail below.

Enter these arguments as unquoted text words. Like key words, enumeration arguments follow the same convention where the portion indicated in uppercase is required and that in lowercase is optional.

For example:

INPUT:COUPLING DC

2-4 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Syntax

Numeric

Quoted String

Many instrumen

t commands require numeric arguments. The syntax shows the format that the instrument returns in response to a query. This is also the preferred format when sending the command to the instrument though any of the formats will be accepted. This documentation represents these arguments as described below.

Table 2-3: Numeric arguments

Symbol Meaning

<Integer> <Decimal data> Floating point value with or without an exponent

Most nume

ric arguments are automatically forced to a valid setting, by either

Signed integer value

rounding or truncating, when an invalid number is input, unless otherwise noted in the command description.

Some co

mmands accept or return data in the form of a quoted string, which is simply a group of ASCII characters enclosed by a single quote (') or double quote ("). The following is an example of a quoted string:

string"

"This is a quoted

A quoted string can include any character deﬁned in the 7-bit ASCII character set. Follow these rules when you use quoted strings:

1. Use the same type of quote character to open and close the string. For

example:

"this is a valid string".

2. You can mix quotation marks within a string if you follow the previous rule.

For example:

"this is an 'acceptable' string".

3. You can include a quote character within a string by repeating the quote. For

example:

"here is a "" mark".

4. Strings can have upper or lower case characters.

5. If you use a GPIB network, you cannot terminate a quoted string with the

END message before the closing delimiter.

6. A carriage return or line feed embedded in a quoted string does not terminate

the string. The return is treated as another character in the string.

7. The maximum length of a quoted string returned from a query is 1000

characters.

Here are some invalid strings:

"Invalid string argument' (quotes are not of the same type)

"test<EOI>" (termination character is embedded in the string)

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-5

Command Syntax

Macros

Block

Several instru

ment commands use a block argument form, as deﬁnedinthe

following table:

Table 2-4: Block argument

Symbol Meaning

<NZDig> <Dig> <DChar> A character with the hexadecimal equivalent of 00 through FF (0

<Block>

A nonzero digit character in the range of 1-9 A digit character, in the range of 0-9

through 25 Ablockof

{#<NZDig><Dig>[<Dig>...][<DChar>...] |#0[<DChar>...]<terminator>}

5 decimal)

data bytes deﬁned as: <Block>::=

<NZDig> speciﬁes the number of <Dig> elements that follow. Taken together, the <NZDig> and <Dig> elements form a decimal integer that speciﬁes how many <DChar> elements follow.

A macro is a single command, that represents one or several other commands,

ding on your deﬁnition. You can deﬁne 25 macros of 40 characters in the

depen instrument. One macro can address other macros, but you cannot call a macro from within itself (recursion). You can use variable parameters that modify the macro.

Macro Names

Data Types Within Macros

Usemacrostodothefollowing:

Provide a shorthand for complex commands.

tdownonbustrafﬁc.

You can use both commands and queries as macro labels. The label cannot be the same as common commands or queries. If a macro label is the same as an

nstrument command, the instrument will execute the macro when macros are

i enabled ( *EMC 1), and it will execute the instrument command when macros are disabled (*EMC 0).

The commands to be performed by the macro can be sent both as block and string data.

String data is the easiest to use since you don’t have to count the number of characters in the m acro. However, there are some things you must keep in mind:

Both double quote (“) and single quote (‘) can be used to identify the string data. If you use a controller language that uses double quotation marks to deﬁne strings

2-6 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Syntax

Deﬁne Macro Command

within the lang and use single quotes as string identiﬁers within the macro.

When using str different type of string data identiﬁers for strings within the macro. If the macro should for instance set the input slope to positive and select the period function, you must type:

“:Inp:slope pos; :Func ’PER 1’”

‘:Inp:slo

*DMC assigns a sequence of commands to a macro label. Late r when you use the macro label as a command, the instrument will execute the sequence of commands.

Use the following syntax:

*DMC <macro-label>, <commands>

Simple macro example. *DMC ‘FREQUENCY?’,":FUNC ‘FREQ

NP:LEV:AUTO ON ;:ARM:START:LAY2:SOURCE BUS;:INIT:CONT

1’;:I ON;*TRG"

uage (like BASIC) we recommend that you use block data instead,

ing data for the commands in a macro, remember to use a

pe pos; :Func "PER 1"’

example deﬁnes a macro “FREQUENCY?” that takes a single frequency

This measurement with an automatic trigger level setting and places the result in the output queue.

Macros with arguments. You can pass arguments (variable parameters) with the macro. Insert a dollar sign ($) followed by a single digit in the range 1 to 9 where

u want to insert the parameter. See the example below.

When a macro with deﬁned arguments is used, the ﬁrst argument sent will replace

ny occurrence of $1 in the deﬁnition; the second argument will replace $2, and

a so on.

Example. *DMC ‘AUTOFILT’,":INP:LEV:AUTO $1;:INP:FILT $1;:INP2:LEV:AUTO $1;:INP2:FILT $1"

This example deﬁnes a macro called AUTOFILT that takes one B oolea n argument such as ON or OFF for ($1).

AUTOFILT OFF

Turns off both the auto function and the analog lowpass ﬁlteronbothinput channels.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-7

Command Syntax

Deleting Macros

Enabling and Disabling

Macros

How to Execute a Macro

Use the *PMC ( pu with the*DMC command. This removes all macro l abels and sequences from the memory. To delete only one macro in the memory, use the:MEMory:DELete:MACRo command.

NOTE. You cannot overwrite a macro; you must delete it before you can use the

same name for a new macro.

*EMC Enable Macro Command. When you want to execute an instrument command or query with the same name as a deﬁned macro, you need to disable macro execution. Disabling macros does not delete stored macros; it just hides them from execution.

Disabling: *EMC0 disables all macros.

Enabling: *EMC1.

*EMC? Enable Macro Query. Use this query to determine if m acros are enabled.

Possible response: 1 = macros are enabled, 0 = macros are disabled

Macros are disabled after *RST, so to be sure, start by enabling macros with *EMC 1. Now macros can be executed by using the macro labels as commands.

rge macro) command to delete all macros deﬁned

Retrieve a Macro

Example:

*DMC ‘LIMITMON’,’ :CALC:STAT ON; :CALC:LIM:STAT ON; :CALC:LIM:LOW:DATA $1;STAT ON; :CALC:LIM:UPP:DATA $2;STAT ON’

*EMC 1

w sending the command

LIMITMON 1E6,1.1E6

will switch on the limit monitoring to alarm between the limits 1MHz and 1.1MHz.

GMC? Get Macro Contents query. This query sets a response containing the deﬁnition of the macro you speciﬁed when sending the query.

Example using the above deﬁned macro:

*GMC? ‘LIMITMON’

#292:CALC:STAT ON;:CALC:LIM:STAT ON; :CALC:LIM:LOW:DATA $1;STAT ON; :CALC:LIM:UPP:DATA $2;STAT ON’

2-8 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Syntax

LMC? Learn Macr

all the macros stored in the Timer/instrument.

Example:

*LMC? might return "MYINPSETTING","LIMITMON"

Now there are two macros in memory, and they have the following labels: “MYINPSETTING” and “LIMITMON”.

oquery. This query returns a response containing the labels of

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-9

Command Syntax

2-10 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Arming Subsystem

Table 2-5: Arming commands

Command Description

ARM:COUNt Sets or returns the upward exit of the wait-for-bus-arm

ARM:DELay

ARM:LAYer2

ARM:LAYer2:SOURce Sets or returns the m ode for the wait-for-bus-arm

ARM:SLOPe Sets or returns the slope for the start arming condition. ARM:SOURce Selects START arming input or switches off the start

ARM:STOP:SLOPe Sets or returns the slope for the stop arming condition. ARM:STOP:SOURce Selects STOP arming input or switches off the STOP

ARM:STOP:TIMer Sets or returns a delay between a pulse on the

state. Sets or returns a delay between the pulse on

the selected arming input and the time when the instrument starts measuring.

Overrides the waiting for bus arm, provided the source is set to bus.

function,

arming function.

selected start arming input and the point of time when totalizing stops (FCA3100 Series only, Totalize mode only).

Calculate Subsystem

The calculate subsystem processes the measuring results. Here you can recalculate the result using mathematics, make statistics and set upper and lower limits for the measurement result. The instrument itself monitors the result and alerts you when the limits are exceeded.

Limit monitoring makes it is possible to get a service request when the measurement value falls below a lower limit or rises above an upper limit. Two status bits are deﬁned to support limit monitoring. One is set when the results are greater than the UPPer limit, the other is set when the result is less than the LOWer limit. Enable the bits by using the standard *SRE command and :STAT:DREG0:ENAB. Using both these bits, it is possible to get a service request when a value passes out of a band ( UPPer is set at the upper band border and LOWer at the lower border) OR when a measurement value enters a band (LOWer set at the upper band border and UPPer set at the lower border). Turning the limit monitoring calculations on or off will not inﬂuence the status register mask bits which determine whether or not to generate a service request when a limit is reached. Note that the calculate subsystem is automatically enabled when limit

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-11

Command Groups

monitoring is s

witched on. This means that other enabled calculate sub-blocks are

indirectly switched on.

Table 2-6: Calculate commands

Command Description

CALCulate:AVERage:ALL?

CALCulate:AVERage:COUNt Sets or returns the number of samples to use in

CALCulate CURRent?

CALCulate:AVERage:STATe Switches the statistical function on and off or returns

CALCulate:AVERage:TYPE Sets or returns the statistical function to be performed. CALCulate:DATA? CALCulate:IMMediate Causes the calculate subsystem to reprocess

CALCulate:LIMit Turns On/Off the limit-monitoring calculations. CALCulate:LIMit:CLEar

CALCulate:LIMit:CLEar:AUTO

CAL CAL

CALCulate:LIMit:FCOunt:LOWer? Returns the number of times the set lower limit was

ALCulate:LIMit:FCOunt:UPPer?

CALCulate:LIMit:LOWer Sets or returns the value of the lower limit. CALCulate:LIMit:LOWer:STATe Sets whether the measured value should be checked

CALCulate:LIMit:PCOunt? Returns the number of measurement results between

CALCulate:LIMit:UPPer Sets or returns the value of the upper limit. CALCulate:LIMit:UPPer:STATe Sets whether the measured value should be checked

CALCulate:MATH Deﬁnes the mathematical expression used for

:AVERage:COUNt:

Culate:LIMit:FAIL? Culate:LIMit:FCOunt?

Returns mean value, standard deviation, min and max value from the current statistics sampling.

statistics Returns th

sampling.

the state.

Fetches data calculated in the post processing block.

the sta reacquiring the data. Query returns this reprocessed data.

Resets the instrument that reports its result using the CALCulate:LIMit:FCOunt? query.

Activates or deactivates automatic reset by INIT of the instrument that reports its result using the CALC

Ret Ret

upper limits have been passed since the instrument was last reset.

p R

passed since the instrument was l ast reset

against the lower limit.

the set lower and upper limits since the instrument was last reset

against the upper limit.

mathematical operations.

sampling.

e number of samples in the current statistics

tistical function on the sense data without

ulate:LIMit:FCOunt? query. urns the result of limit testing. urns the total number of times the set lower and

assed since the instrument was last reset.

eturns the number of times the set upper limit was

2-12 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Calibration Subsystem

Command Groups

Table 2-6: C alculate commands (cont.)

Command Description

CALCulate:MATH:STATe Switches on/off the mathematical function. CALCulate:STATe Switches on/off the complete post-processing block. CALCulate:TOTalize:TYPE Selects postprocessing for totalize.

This subsystem controls the calibration of the interpolators used to increase the resolution of the instrument.

Table 2-7: Calibration commands

Command Description

CALibration:INTerpolator:AUTO Sets or returns whether the instrument calibrates the

time interpolators for every measurement.

Conﬁgure Function

CONFigure; READ?

The CONFigure command sets up the instrument to make the same measurements as the MEASure query, but without initiating the measurement and fetching the result. Use conﬁgure when you want to change any parameters before making

measurement.

the

The CONFigure command causes the instrument to choose an optimal setting for the speciﬁed measurement. CONFigure may cause any device setting to change.

EAD? starts the acquisition and returns the result.

This sequence operates in the same way as the MEASure command, but now it is

ossible to insert commands between CONFigure and READ ? to ﬁne-tune the

p setting of a particular function. For example, you can change the input impedance from 1M Ω to 50Ω.

Start with the command CONFigure:FREQ 2E6,1, where 2E6 is the expected value 1 is the required resolution (1Hz).

Then send INPut:IMPedance 50 to set input impedance to 50 Ω.

Then send READ? to start the measurement and returns the result.

CONFigure;INITiate;FETCh?

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-13

The READ? command can be divided into the INITiate command, which starts the m easurement, and the FETCh? command, which requests the instrument to return the measuring results to the controller.

Command Groups

Start with the c

ommand CONFigure:FREQ 20E6,1, where 20E6 is the expected

signal value 1 is the required resolution.

Then send INPu

t:IMPedance 1E6 to set input impedance to 1 MΩ.

Then send INITiate to start the measurement.

Then send FETCh? to fetch the result.

Table 2-8: Comparison of ways to take a measurement

Command Advantage

MEASure? Simple to use, few additional possibilities. CONFigure READ? Somewhat more difﬁcult, but some extra

possibilities.

CONFigure INITiate FETCh? Most difﬁcult to use, but many extra features.

Table 2

Command Description

CONFigure:ARRay: <MeasuringFunction>

CONFigure:<MeasuringFunction> Sets up the instrument to perform one measurement. CONFigure:TOTalize[:

CONT

-9: Conﬁgure commands

Sets up the instrument to perform the number of measurements you choose.

Set up the instrument to take repeated measurements.

inuous]

Display Subsystem

Fetch Function

Commands in this subsystem control what data is to be present on the display and whether the display is on or off.

Table 2-10: Display command

mmand

ISPlay:ENABle

scription

urns On/Off the updating of the screen.

Table 2-11: Fetch commands

Command Description

FETCh:ARRay? FETCh[:SCALar]?

Fetches multiple measurements. Fetches a single measurement.

2-14 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Format Subsys

Time Stamp Readout

tem

Format

The Format subsystem converts the internal data representation to the data transferred over the external GPIB interface. Commands in this block control the data type to b

When FORMat:TINFormation is set to ON, the readout contains two values instead of one for FETCh:SCALar?, READ:SCALar? and MEASure:SCALar?.

The ﬁrst is the measured value, expressed in the basic unit of the measurement function, and the second value is the timestamp value in seconds.

In FORMat ASCII mode, the result is given as a ﬂoating-point number, followed by a ﬂoating point timestamp value.

In FORMat REAL mode, the result is given as an eight-byte block containing the

ﬂoating-point measured value, followed by an eight-byte block containing the ﬂoating-point timestamp value.

When doing readouts in array form, with FETCh:ARRay?, READ:ARRay? or MEASure:ARRay?, the response consists of alternating measurement values and timestamp values, formatted in a similar way as for scalar readout. All values are

ated by commas.

separ

e sent over the external interface.

Hard Copy

Table 2-12: Format commands

Command Description

FORMat Sets or returns the format in which the result is sent

on the bus.

FORMat:BORDer Sets or returns the order in which response data bytes

formatted.

FORMat:SMAX Sets or queries the upper limit for FETCh:ARRay? FORMat:TINFormation Turns on/off the time stamping of measurements.

Table 2-13: Hard copy command

Command Description

HCOPy:SDUMp:DATA?

Returns block data containing a screen image in

Windows BMP format.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-15

Command Groups

Initiate Subs

ystem

Input Subsystem

Table 2-14: Initiate commands

Command Description

INITiate Initiate the trigger system to take a measurement. INITiate:CONTinuous

The Input s before it is converted into data by the Sense subsystem. The Input subsystem includes coupling, impedance, ﬁltering, and so forth.

ubsystem performs all the signal c onditioning of the input signal

Initiate the trigger system to take continuous measurements.

2-16 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Meas

Table 2-15: Inp

Command Description

AUTO Performs the same task as the front panel button

INPut{[1]|2}:ATTenuation Sets or returns the input attenuation. INPut{[1]|2}:COUPling Sets or returns the input coupling. INPut{[1]|2}:FILTer Switches on or off the analog low pass ﬁlter. INPut{[1]|2}:FILTer:DIGital Switches on or off the digital low pass ﬁlter. INPut{[1]|2}:FILTer:DIGital:

FREQuenc INPut{[ INPut{[ INPut{ INPut{

INPut{[1]|2}:SLOPe Sets or returns the slope for certain measurements.

urement Subsystem

ut commands

y 1]|2}:IMPedance 1]|2}:LEVel

[1]|2}:LEVel:AUTO [1]|2}:LEVel:RELative

AUTO SET.

Sets or returns the digital ﬁlter cutoff frequency.

Sets or r Sets or r Switch Sets or

measurements.

eturns the input impedance. eturns the input threshold level.

es autotrigger level on or off.

returns speciﬁc trigger levels for different

MEASure?

The Measure function group has a different level of compatibility and ﬂexibility than other commands. The parameters used w ith commands from the Measure

up describe the signal you are going to measure. This means that the Measure

gro functions give compatibility between instruments, since you don’t need to know anything about the instrument you are using.

his is the most simple query to use, but it does not offer much ﬂexibility. The

T MEASure? query lets the instrument conﬁgure itself for an optimal measurement, starts the data acquisition, and returns the result.

MEASure:FREQ? example. This will execute a frequency measurement a nd the result is sent to the controller. The instrument will select a setting for this purpose by itself, and will carry out the required measurement as “well” as possible; moreover, it will automatically start the measurement and send the result to the controller. You may add parameters to give more details about the signal you are going to measure, for example:

Send the query MEASure:FREQ? 20 MHz,1, where: 20 MHz is the expected value, which can, of course, also be sent as 20E6, and 1 is the required resolution. (1Hz)

Also the channel numbers can be speciﬁed , for example: MEASure:FREQ? (@3) or MEASure:FREQ? 20E6, 1,(@1)

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-17

Command Groups

Table 2-16: Com

Command Advantage

MEASure? Simple to use, few additional possibilities. CONFigure READ? Somewhat more difﬁcult, but some extra

CONFigure INITiate FETCh? Most difﬁcult to use, but many extra features.

parison of ways to take a measurement

possibilities.

Table 2-17: Measurement commands

Command Description

ABORt MEASure:ARRay:FREQuency:

BTBack? MEASure:ARRay:

<MeasuringFunction>? MEASure:ARRay:PERiod:

BTBack? MEASure:ARRay:STSTamp? Takes a series of back-to-back time-stamp

MEASure:ARRay:TIError? Takes a series of back-to-back relative frequency

MEASure:ARRay:TSTAmp? Takes a series of back-to-back time-stamp

MEASure{:FALL:TIME|:FTIM}? Takes a fall time measurement. MEASure:FREQuency? Takes a frequency measurement. MEASure:FREQuency:BURSt? Takes a measurement of the carrier frequency of a

MEASure:FREQuency:POWer[: AC]?

MEASure:FREQuency:PRF? Takes a pulse-repetition frequency measurement. MEASure:FREQuency:RATio? Takes a frequency ratio measurement. MEASure:<MeasuringFunction>? Sets up a single measurement with the result returned

MEASure:MEMory?

MEASure:MEMory<N>?

MEASure:NDUTycycle? MEASure:NWIDth? MEASure{:PDUTycycle|:DCYCle}? MEASure:PERiod? MEASure:PERiod:AVERage? Returns an average of multiple period measurements.

Terminates a measurement. Takes a series of back-to-back frequency

measurements. Sets up a series of m easurements with the results

returned in a single string. Takes a series of back-to-back period m easurements.

measurements.

measurements taken at all positive and negative trigger level crossings.

burst. Takes a power measurement.

inastring. Recalls an instrument setting stored in memory and

returns a measurement value. Recalls an instrument setting stored in memory and

returns a measurement value. Takes a negative duty cycle measurement. Takes a negative pulse width measurement. Takes a positive duty cycle measurement. Takes a period measurement.

2-18 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Table 2-17: Measurement commands (cont.)

Command Description

MEASure:PHASe? MEASure:PWIDth? MEASure{:RISE:TIME|:RTIM}? MEASure:TINTerval? MEASure[:VOLT]:MAXimum? MEASure[:VOLT]:MINimum? MEASure[:VOLT]:NCYCles? Measures the number of cycles in a burst. MEASure[:VOLT]:NSLEwrate? MEASure[:VOLT]:PSLEwrate? MEASure[:VOLT]:PTPeak? MEASure[:VOLT]:RATio? TOTalize:GATE Opens and closes the gate for continuous

Takes a phase measurement. Takes a positive pulse width measurement. Takes a rise time measurement. Takes a time interval measurement. Takes a positive peak voltage measurement. Takes a negative peak voltage measurement.

Takes a negative slew rate measurement. Takes a positive slew rate measurement. Takes a peak-to-peak voltage measurement. Takes a peak-to-peak voltage ratio measurement.

measurements.

Memory Subsystem

The Memory subsystem holds macro and instrument state data inside the instrument.

Table 2-18: Memory commands

Command Description

MEMory:DATA:RECord:COUNt? Returns the number of samples in a given memory

location.

MEMory:DATA:RECord:DELete MEMory:DATA:RECord:FETCh? Returns one sample from a given memory location. MEMory:DATA:RECord:FETCh:

ARRay? MEMory:DATA:RECord:FETCh:

STARt MEMory:DATA:RECord:NAME? Returns the name of a given memory location. MEMory:DATA:RECord:SAVE Saves samples in a given memory location. MEMory:DATA:RECord:SETTings?

MEMory:DELete:MACRo MEMory:FREE:MACRo? Returns the bytes used and available for macros. MEMory:NSTates? Returns (one greater than) the number of available

Erases a given memory location.

Returns multiple samples from a given memory

location.

Sets the pointer to the ﬁrst sample in a given memory

location.

Returns the instrument settings used when the

speciﬁed <Dataset> was saved.

Deletes an individual macro.

memory locations for instrument settings.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-19

Command Groups

Output Subsys

Read Function

tem

Table 2-19: Output commands

Command Description

OUTPut:POLa OUTPut:TYP SOURce:PU SOURce:PU

rity

E LSe:PERiod LSe:WIDTh

Sets or retur Sets or retu Sets the pe Sets the pu

ns the polarity of the pulse output.

rns the function of the pulse output. riod for the pulse output. lse width for the pulse output.

Table 2-20: Read commands

Command Description

READ? Performs a new measurement and reads out a

measuring result.

READ:ARRay? Performs multiple measurements and reads out the

measuring results.

Sense Command Subsystem

The Sense subsystem converts the signals into internal data that can be processed by the Calculate subsystem. The SENSe commands c ontrol various characteristics of the measurement and acquisition process. These include gate time, measurement function, resolution, and so on.

Depending on application, you can select different input channels and input characteristics.

Switchbox. In au you need to measure on several measuring points. The FCA3000 series lets you switch between input A and B to take measurements directly without the need for external switching devices.

Prescaling. For all measuring functions except time interval , rise/fall time , phase and time stamping , the maximum input A or B frequency is 300 MHz.

For the measuring functions explicitly mentioned above, the instrument has a max repetition rate of 160MHz.

For the measuring functions Frequency and Period Input A or Input B is prescaled by a factor of 2. For Frequency in Burst , PRF and Number of Cycles in Burst , the signal is prescaled by a factor of 2 if the command :SENSe:FREQuency:BURSt:PREScaleris set to ON. This is also the default condition.

tomatic test systems, it is difﬁcult to swap BNC cables when

Average , the signal to

2-20 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Table 2-21: Sen

Command Description

ACQuisition:APERture Sets or returns the gate time for a measurement. ACQuisition:HOFF Switches the holdoff function on or off. ACQuisition:HOFF:TIME Sets or returns the holfoff time value. FREQuency:BURSt:APERture Sets the time length within a burst during which the

FREQuency:BURSt:PREScaler[: STATe]

FREQuenc

FREQuency:BURSt:SYNC:PERiod Sets the synchronization delay time used in burst

FREQuency:POWer:UNIT Sets or returns the measurement unit for power

FREQue

FREQuency:REGRession Switches the linear regression function on and off. FUNCtion Sets the measuring function to be performed and input

HF:ACQuisition[:STATe] Switches the automatic acquisition system on or off. HF:FREQuency:CENTer Sets the center frequency value for the RF input. ROSCillator:SOURce Selects the source for the time base. TIError:FREQuency Sets a reference frequency for relative frequency

TINTerval:AUTO Sets the instrument to automatically detect the start

ncy:RANGe:LOWer

IError:FREQuency:AUTO

se commands

y:BURSt:STARt:DELay

burst frequency is measured. Switches the frequency burst prescaler on and off.

Sets or re and the actual start of the burst measuring time.

measurements.

measur Sets a l

autotrigger function.

channel.

ets the instrument to use a relative frequency that is

S listed for automatic recognition.

channel in a time interval m easurement.

turns the time length between the burst start

ements. ower-limit frequency for certain voltage and

asurements.

Status Subsystem

This subsystem can be used to get information about what is happening in the instrument at the moment.

Table 2-22: Status commands

Command Description

STATus:DREGister0? Returns the contents of the Device Event Register. STATus:DREGister0:ENABle Sets the enable bit of the Device Register 0. STATus:OPERation? Returns the contents of the operation event status

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-21

Command Groups

System Subsystem

Table 2-22: Status commands (cont.)

Command Description

STATus:OPERation:CONDition? Returns the contents of the operation status condition

STATus:OPERation:ENABle Sets the enable bits of the operation status enable

STATus:PRESet Sets or clears all other enable registers other than the

IEEE-488.2 enable registers.

STATus:QUEStionable? Returns the contents of the status questionable event

STATus:QUEStionable: CONDition?

STATus:QUEStionable:ENABle Sets the enable bits of the status questionable enable

Returns the contents of the status questionable condition register.

This subsystem controls some system parameters like timeout.

Table 2-23: System commands

Command Description

SYSTem:COMMunicate:GPIB:

Ress

ADD

STem:ERRor?

SYSTem:LANGuage Selects one of two command sets. SYSTem:PRESet Recalls the default settings for the instrument. SYSTem:SE T Returns the complete current state of the instrument. SYSTem:TALKonly Sets the instrument to talk-only mode. SYSTem:TEMPerature? Returns the temperature in degrees C at the fan

SYSTem:TOUT Switches the time-out on or off. SYSTem:TOUT:AUTO Sets an automatic time out after the ﬁrst start trigger. SYSTem:TOUT:TIME Sets or returns the time-out time. SYSTem:UNPRotect Unprotects the user data set or read by the *PUD

Sets or returns the GPIB address.

eries for an ASCII text description of an error that

Qu occurred.

control sensor inside the instrument housing.

command.

2-22 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Test Subsyste

Trigger Subsystem

Instrument Action

This subsystem tests the hardware and software of the instrument and reports errors.

Table 2-24:

Command Description

TEST:SELect Selects which internal self-tests shall be used when

The Trigg speciﬁed internal or external events.

Some examples of events to synchronize with are as follows:

Measurement

Bus trigger

Test command

self-test is requested by the *TST? command.

er subsystem enables synchronization of instrument actions with

External signal level or pulse

Ten occurrences of a pulse on the external trigger input

r instrument ready

Othe

Signal switching

Input signal present

One second after input signal is present

Sourcing output signal

Switching system ready

he ARM-TRIG Trigger Conﬁguration gives a typical trigger conﬁguration, the

T ARM-TRIG model. The conﬁguration contains two event-detection layers: the ‘Wait for ARM’ and ‘Wait for TRIG’ states.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-23

Command Groups

Structure of the IDLE and

INITIATED States

This trigger conﬁguration is sufﬁcient for most instruments. More complex instruments, such as the FCA3000 a nd MCA3000 Series, have more ARM layers.

The ‘Wait for TRIG’ event-detection layer is always the last to be crossed before instrument actions can take place.

When you turn on the power or send *RST or ABORT to the instrument, it sets the trigger system in the IDLE state.

The trigger system will exit from the IDLE state when the instrument receives an INITiate:IMMediate. The instrument will pass directly through the INITIATED state downward to the next event-detection layers (if the instrument contains any more layers).

The trigger system will return to the INITIATED state when all events required by the detection layers have occurred and the instrument has made the intended measurement. When you program the trigger system to INITiate:CONTinuous

N, the instrument will directly exit the INITIATED state moving downward and

O will repeat the whole ﬂow described above. When INITiate:CONTinuous is OFF, the trigger system will return to the IDLE state.

2-24 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Figure 2-1: Flow diagram of IDLE and INITIATED layers.

Structure of an event-detection layer. The general structure of all event-detection

layers is identical. (See Figure 2 -1.)

In each layer there are several programmable conditions, which must be satisﬁed to pass by the layer in a downward direction:

Triggering

Forward traversing an event-detection layer. After initiating the loop instruments,

strument waits for the event to be detected. You can select the event

the in to be detected by using the <layer>:SOURce command. For example: ARM:LAYer2:SOURce BUS

You can specify a more precise characteristic of the event to occur. For example: ARM:LAYer:DELay 0.1

You may program a certain delay between the occurrence of the event and entering into the next layer (or starting the device actions when in the TRIGger layer). This delay can be programmed by u sing the <layer>:DELay command.

Backward traversing an event-detection layer. The number of times a layer event

s to initiate a device action can be programmed by using the <layer>:COUNt

ha command. For example: :TRIGger:COUNt 3 causes the instrument to measure three times, each measurement being triggered by the speciﬁed events.

*TRG trigger command. The trigger command has the same function as the Group Execute Trigger command GET, deﬁned by IEEE488.1.

When to use * TRG and GET

The *TRGand the GET commands have the same effect on the instrument. If the instrument is in idle (not parsing or executing any commands), GET will execute much faster than *TRG since the instrument must always parse *TRG.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-25

Command Groups

Figure 2-2: Structure of event detection layers.

Table 2-25: Trigger commands

Command Description

TRIGger:COUNt Sets or returns how many measurements the

instrument should make for each arm condition.

TRIGger:SOURce TRIGger:TIMer Sets the sample rate fur use with the statistics

Enables or disables the sample rate control.

functions.

2-26 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Groups

Common Comman

Table 2-26: IEEE common commands

Command Description

*CLS Clears the st

registers and the error queue.

*DDT Sets or queries the command that the device will

execute on receiving the GET interface message or

the *TRG co

*DMC Deﬁnes a ne *EMC *ESE Sets the

*ESR? Returns the contents of the standard event status

*GMC? Returns the deﬁnition of a existing macro. *IDN? Reads out the manufacturer, model, serial number,

*LMC? Retur

*LRN

*OPC Generates the operation complete message in the

*OPT? Return all detectable features present in the

PSC

PUD

* *RCL Recalls one of the previously stored complete

*RMC *RST *SAV Saves the settings of the instrument in an internal

*SRE Sets or returns the service request enable register bits. *STB? Returns the value of the Status Byte. *TRG Starts the measurement and places the result in the

Enables macros.

and ﬁr

Returns a message that can be sent to the instrument

to re

was made.

Standard Event Status Register.

strument.

letes all macro deﬁnitions.

nables/disables automatic power-on clearing.

ets or returns protected user data.

instrument settings from the internal nonvolatile

memory of the instrument.

Deletes an individual macro.

Resets the instrument.

nonvolatile memory.

output queue.

atus data structures by clearing all event

mmon command.

wmacro.

enable bits of the standard event enable

mware level in an ASCII response data element.

ns the labels of all deﬁned macros.

turn it to the state it was in when the *LRN? query

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-27

Command Groups

Table 2-26: IEEE common commands (cont.)

Command Description

*TST? Starts an internal self-test and generates a response

indicating whether or not the instrument completed the self-test without any detected errors.

*WAI Prevents the instrument from executing any further

commands or queries until execution of all previous commands or queries is completed.

2-28 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

ABORt (No Query Form)

The ABORt command terminates a measurement. The trigger subsystem state is set to idle-state. The command does not invalidate already ﬁnished results when breaking an array measurement. This means that you can fetch a partial result after an abort.

Aborts all previous measurements if *WAI is not used.

Group

Syntax

ACQuisition:APERture

Group

Syntax

Arguments

Returns

Measurement

ABORt

Sets the gate time for one measurement.

Sense

ACQuisition:APERture {<Decimal value > | MIN | MAX } ACQuisition:APERture?

<DECIMAL VALUE> is 20 ns to 1000s. MIN sets 20 ns and MAX sets 1000 s.

200 ms after SYST:PRES

10 ms after *RST

ACQuisition:HOFF

Sets the Hold Off function On or Off.

Group

Syntax

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-29

Sense

ACQuisition:HOFF <boolean> ACQuisition:HOFF?

Command Descriptions

Arguments

Returns

ACQuisition:HOFF:TIME

Group

Syntax

Arguments

Returns

<BOOLEAN> = 1 | O

1|0

Sets the Hold Off time value.

Sense

ACQuisition:HOFF:TIME {<Decimal value> | MIN | MAX} ACQuisition:HOFF:TIME?

<DECIMAL DATA>= a number between 20E–9 and 2.0

N|0|OFF

ARM:COUNt

Group

Syntax

Arguments

This count variable controls the upward exit of the wait-for-bus-arm state. The instrument loops the trigger subsystem downwards COUNt number of times before it exits to the idle state.

This means that a COUNt number of measurements can be done for each Bus arming or INITiate.

NOTE. The actual number of measurements made on each INIT is equal to

(ARM:COUNT)*(TRIG:START:COUNT).

Arming

ARM:COUNt <Numeric value>| MIN | MAX | INFinity ARM:COUNt?

<Numeric value> is an integer between 1 and 2,147,483,647 (2

integer 1 switches the function OFF.

MIN sets 1.

-1). The

MAX sets 2147483647.

2-30 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

ARM:DELay

Group

Syntax

Arguments

INFinity makes

device-dependent parameters set limits.

This command sets a delay between the pulse on the selected arming input and the time when the instrument starts measuring.

Range: 20ns to 2s, with 10 ns resolution.

Arming

ARM:DELay <Numeric value> | MIN | MAX ARM:DELay?

<Numeric value> is a number between 20*10

MIN sets 0 whi

MAX sets 2 s.

the arm loop continue indeﬁnitely, or until other

–9

and 2.

ch switches the delay OFF.

Returns

Examples

ARM:DELAY 0.1

ARM:LAYer2 (No Query Form)

This command overrides the waiting for bus arm, provided the source is set to bus. When this command is issued, the instrument will immediately exit the wait-for-bus-arm state.

The instrument generates an error if it receives this command when the trigger subsystem is not in the wait-for-bus-arm state.

IftheArmingsourceissettoImmediate, this command is ignored.

Group

Syntax

Examples

Arming

ARM:LAYer2

ARM:LAYER2

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-31

Command Descriptions

ARM:LAYer2:S

Arguments

Examples

OURce

Group

Syntax

Switches between Bus and Immediate mode for the wait-for-bus-arm function, (layer 2). GETand *TRG triggers the instrument if Bus is selected as source.

If the instrument receives GET/*TRG when not in wait-for-bus-arm state, it ignores the trigger and generates an error.

It also generates an error if it receives GET/*TRG and bus arming is switched off (set to IMMediate).

Arming

ARM:LAYer2:SOURce {BUS | IMMediate} ARM:LAYer2:SOURce?

BUS

IMMediate

ARM:LAYER2:SOURCE BUS

ARM:SLOPe

Arguments

ARM:SOURce

Group

Syntax

Examples

Sets the slope for the start arming condition.

Arming

ARM:SLOPe {POSitive | NEGative} ARM:SLOPe?

POS

NEG

ARM:SLOPE NEG

Selects START arming input or switches off the start arming function. When switched off the DELay is inactive.

2-32 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Group

Syntax

Arguments

Returns

Examples

Arming

ARM:SOURce {EXTernal1 | EXTernal2 | EXTernal4 | IMMe diate} ARM:SOURce?

EXTernal1 is input A

EXTernal2 is input B

EXTernal4 is input E

IMMediate is Start arming OFF

NOTE. For the Totalize function in the FCA3100 Series, IMM means manual

start-stop using the commands TOT:GATEON|OFF.

EXT1 | EXT2 | EXT4 | IMM

ARM:SOURCE EXT4

ARM:STOP:SLOPe

Group

Syntax

Returns

Examples

ARM:STOP:SOURce

Sets the slope for the stop arming condition.

Arming

ARM:STOP:SLOPe {POSitive | NEGative} ARM:STOP:SLOPe?

POS|NEG

ARM:STOP:SLOPE NEG

Selects STOP arming input or switches off the STOP arming function. The FCA3100 Series has also a programmable timer that is accessible in Totalize mode.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-33

Command Descriptions

Group

Syntax

Arguments

Returns

Examples

Arming

ARM:STOP:SOURce {EXTernal1 | EXTernal2 | EXTernal4 | TIMer | IMMediate} ARM:STOP:SOURce?

EXTernal1 is input A

EXTernal2 is input B

EXTernal4 is input E

TIMer is timed STOP in Totalize measurements (FCA3100 Series only). The

time is set with the command ARM:STOP:TIMer.

IMMediate sets Stop arming OFF

EXT1 | EXT2 | EXT4 | TIM | IMM

ARM:STOP:SOURCE EXT4

ARM:STOP:TIMer

Group

Syntax

Arguments

Returns

Examples

This command sets a delay between a pulse on the selected start arming input (when totalizing starts) and the point of time when totalizing stops.

Range: 20 ns to 2 s, with 10 ns resolution.

Arming

ARM:STOP:TIMer <Numeric value> | MIN | MAX ARM:STOP:TIMer?

<Numeric value> is a number between 20 * 10

MIN sets 20 * 10

MAX sets 2 s.

-9

and2s.

ARM:STOP:TIMER 0.1

2-34 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

AUTO (No Query

Arguments

Form)

Group

Syntax

Performs the same task as the front panel button AUTO SET.

Input

AUTO ONCE | PRESet

ONCE corresponds to pressing AUTO SET once.

PRESet corresponds to double-clicking AUTO SET.

CALCulate:AVERage:ALL? (Query Only)

Returns mean value, standard deviation, min and max value from the current statistics sampling.

Group

Calculate

Syntax

Returns

CALCulate:AVERage:ALL?

CALCulate:AVERage:COUNt

Sets the number of samples to use in statistics sampling.

Group

Syntax

Arguments

Returns

Calculate

CALCulate:AVERage:COUNt <number of samples> CALCulate:AVERage:COUNt?

<number of samples> is an integer in the range 2 to 2*10

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-35

Command Descriptions

CALCulate:AV

ERage:COUNt:CURRent? (Query Only)

Returns the number of samples in the current statistics s ampling.

Group

Syntax

Returns

Calculate

CALCulate:AVERage:COUNt:CURRent?

CALCulate:AVERage:STATe

This command switches the statistical function on and off.

The CALCulate subsystem is automatically enabled when the statistical functions are switched on. This means that other enabled calculate sub-blocks are indirectly switched on. The statistics must be enabled before the m easurements are performed. When the statistical functi the trigger subsystem initiated until the CALCulate:AVERage:COUNt variable is reached. This is done without any change in the trigger subsystem settings. Consider that the trigger subsystem is programmed to perform 1000 measurements when initiated. In such a case, the instrument must make 10000 measurements if the statistical function requires 9500 measurements because the number of measurements must be a multiple of the trigger subsystem (1000 in this example).

on is enabled, the instrument will keep

number of measurements programmed in

Group

Syntax

Arguments

Returns

2-36 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Calculate

CALCulate:AVERage:STATe < Boolean > CALCulate:AVER

<BOOLEAN>=(1|ON|0|OFF)

1|0

NOTE. Statistics with array readouts cannot be combined. To store and

fetch individual values in a block measurement, use the default command

CALCulate:AVERage:STATe is OFF.

age:STATe?

Command Descriptions

CALCulate:AV

Arguments

ERage:TYPE

Selects the statistical function to be performed.

NOTE. Use CALCulate:DATA? to read the result of statistical operations. READ?

and FETCh[: is based on.

Group

Syntax

Calculate

CALCulate:AVERage:TYPE { MAX | MIN | MEAN | SD EViation | ADEViation} CALCulate:AVERage:TYPE?

MAX returns the maximum value of all samples taken under CALC:AVERcontrol.

MIN returns the minimum value of all samples taken under CALC:AVERcontrol.

MEAN returns the mean value of the samples taken:

SCALar]? will only send the results that the statistical operation

SDEV returns the standard deviation of the samples taken:

ADEV returns the Allan deviation of the samples taken:

Returns

MAX | MIN | MEAN | SDEV | ADEV

CALCulate:DATA? (Query Only)

Returns data calculate d in the post processing block.

NOTE. Use this command to return the calculated result without making a new

measurement.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-37

Command Descriptions

Group

Syntax

Returns

Examples

CALCulate:IMMediate

Calculate

CALCulate:DATA?

CALCULATE:DATA? might return CALC:MATH:STAT ON;:CALC:MATH(((1*X)-10.7E6)/1) ;:INIT; *OPC

Wait for operation complete

CALCULATE:DATA?

<Measurement result> – 10.7E6

This event causes the calculate subsystem to reprocess the statistical function on the sense data without reacquiring the data. Query returns this reprocessed data.

Group

Syntax

Returns

Examples

Calculate

CALCulate:IMMediate CALCulate:IMMediate?

Where: <Decimal data> is the recalculated data.

CALCULATE:IMMEDIATE CALC:AVER:STAT ON;TYPES DEV;:INIT;*OPC

Wait for operation complete

CALC:DATA?

CALC:AVER:TYPE MEAN

CALC:IMM?

2-38 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

CALCulate:LI

Mit

Group

Turns On/Off the limit-monitoring calculations. Limit monitoring generates a service request when the measurement value falls below a lower limit, or rises above an uppe

Two status bits are deﬁned to support limit-monitoring. O ne is set when the results are than the LOWer limit. The bits are enabled using the standard * SREcommand and:STAT:DREG0:ENAB. Using both these bits, it is possible to get a service request when a value passes out of a band ( UPPer is set at the upper band border and LOWer at the lower border) OR when a measurement value enters a band (LOWer set at the upper band border and UPPer set at the lower border). Turning the limi mask bits, which determine whether or not a service request is generated when a limit is reached.

NOTE. The calculate subsystem is automatically enabled when limit-monitoring is

switched on. This means that other enabled calculate sub-blocks are indirectly switched on.

Calculate

t-monitoring calculations On/Off will not inﬂuence the status register

r limit.

greater than the UPPer limit, the other is set when the result is less

ulate:LIMit <Boolean>

Syntax

Related Commands

Arguments

Returns

CALC CALCulate:LIMit?

Example 1 in Chapter 4 deals with limit-monitoring.

<BOOLEAN> =(1|ON|0|OFF)

1|0

CALCulate:LIMit:CLEar (No Query Form)

The command resets the instrument that reports its result using the

CALCulate:LIMit:FCOunt? query.

Group

Syntax

Calculate

CALCulate:LIMit:CLEar

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-39

Command Descriptions

CALCulate:LI

Mit:CLEar:AUTO

The command activates (ON) or deactivates (OFF) automatic reset by INIT of the instrument that reports its result using the CALCulate:LIMit:FCOunt? query.

Group

Syntax

Arguments

Calculate

CALCulate:LIMit:CLEar:AUTO <Boolean> CALCulate:LIMit:CLEar:AUTO?

<Boolean> =(1|ON|0|OFF)

CALCulate:LIMit:FAIL? (Query Only)

Returns a 1 if the limit testing has failed (the measurement result has passed the limit), and a 0 if the limit testing has passed.

The following events reset the fail ﬂag:

Power-on

*RST

A:CALC:LIM:STATOFF:CALC:LIM:STATONtransition

Reading a 1 with this command

Group

Syntax

Returns

Examples

Calculate

CALCulate:LIMit:FAIL?

1| 0

SENS:FUNC 'FREQ';:CALC:LIM:STATON;:CALC:LIM:UPPER 1E3;READ?;*WAI;:CALC:LIM:FAIL?

1kHz,and

0 otherwise.

CALCulate:LIMit:FCOunt? (Query Only)

The c ommand returns the total number of times the set lower and upper limits have been passed since the instrument was last reset by CALCulate:LIMit:CLEar or automatically by INITiate if CALCulate:LIMit:CLEar:AUTO is set to ON.

might return 1 if frequency is above

2-40 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

the returned value is the sum of the values returned by

Group

Syntax

Returns

In other words,

CALCulate:LIMit:FCOunt:LOWer? and CALCulate:LIMit:FCOunt:UPPer?.

Calculate

CALCulate:LIMit:FCOunt?

CALCulate:LIMit:FCOunt:LOWer? (Query Only)

The command returns the number of times the set lower limit was passed since the instrument wa s last reset by CALCulate:LIMit:CLEar or automatically by

INITiate if CALCulate:LIMit:CLEar:AUTO is set to ON.

Group

Calculate

Syntax

Returns

CALCulate:LIMit:FCOunt:LOWer?

CALCulate:LIMit:FCOunt:UPPer? (Query Only)

The command returns the number of times the set upper limit was passed since the instrument wa s last reset by CALCulate:LIMit:CLEar or automatically by

INITiate if CALCulate:LIMit:CLEar:AUTO is set to ON.

Group

Syntax

Returns

Calculate

CALCulate:LIMit:FCOunt:UPPer?

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-41

Command Descriptions

CALCulate:LI

Mit:LOWer

Group

Syntax

Arguments

Returns

Sets the value of the lower limit, that is, the lowest measurement result allowed before the instrument generates a 1 that can be read with CALCulate:LIMit:FAIL?, or by reading

Calculate

CALCulate:LIMit:LOWer {<Decimal data>| MAX | MIN } CALCulate:LIMit:LOWer?

PARAMETER RANGE: -9.9*10

CALCulate:LIMit:LOWer:STATe

Selects if the measured value should be checked against the lower limit.

the corresponding status byte.

+37

to +9.9*10

+37

Group

Syntax

Arguments

Returns

Calculate

CALCulate:LIMit:LOWer:STATe <Boolean> CALCulate:LIMit:LOWer:STATe?

<BOOLEAN> =(1/ON|0/OFF)

1| 0

CALCulate:LIMit:PCOunt?

The command returns the number of measurement results between the set lower and upper limits since the instrument was last reset by CALCulate:LIMit:CLEar or automatically by INITiate if CALCulate:LIMit:CLEar:AUTO is set to ON.

Group

Syntax

Calculate

CALCulate:LIMit:PCOunt?

2-42 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Returns

<numberofcoun

CALCulate:LIMit:UPPer

Sets the value of the upper limit (the highest measurement result allowed) before the instrument generates a 1 that can be read with CALCulate:LIMit:FAIL?,orby reading the corresponding status byte.

Group

Syntax

Arguments

Returns

Calculate

CALCulate:LIMit:UPPer {<Decimal data>| MAX | MIN } CALCulate:LIMit:UPPer?

RANGE: -9.9*10

CALCulate:LIMit:UPPer:STATe

ts>

+37

to +9.9*10

+37

Group

Syntax

Arguments

Returns

CALCulate:MATH

Group

Selects if the measured value should be checked against the upper limit.

Calculate

CALCulate:LIMit:UPPer:STATe <Boolean> CALCulate:LIMit:UPPer:STATe?

<BOOLEAN> =(1/ON|0/OFF)

1| 0

Deﬁnes the mathematical expression used for mathematical operations.

NOTE. The data type <expression data> must be enclosed within parentheses.

Calculate

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-43

Command Descriptions

Syntax

Arguments

Returns

Examples

CALCulate:MATH:STATe

CALCulate:MAT CALCulate:MATH?

<EXPRESSION> is one of the following ﬁve mathematical expressions:

((K * X) + L)

(((K * X) + L) / M)

(((K / X) + L) / M)

((X / M) - 1)

NOTE. No deviations are allowed. K, L and M can be any positive or negative

numerical constant. Each operator must be surrounded by space characters.

CALCULATE:MATH (((64 * X) + -1.07E7) / 1E6)

H (<expression>)

Group

Syntax

Arguments

Returns

Examples

Switches on/off the mathematical function.

NOTE. The CALCulate subsystem is automatically enabled when MATH

operations are switched on. This means that other enabled calculate sub-blocks are indirectly switched on. Switching off mathematics, however, does not switch off the CALCulate subsystem.

Calculate

CALCulate:MATH:STATe <Boolean> CALCulate:MATH:STATe?

<BOOLEAN> =(1/ON|0/OFF)

1|0

CALCULATE:MATH:STATE 1

This example switches on mathematics.

2-44 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

CALCulate:ST

Arguments

ATe

Group

Syntax

Returns

Examples

Switches on/off the complete post-processing block. If disabled, neither mathematics or limit-monitoring can be done.

Calculate

CALCulate:STATe <Boolean> CALCulate:STATe?

<BOOLEAN> =(1/ON|0/OFF)

1|0

OFF

CALCULATE:STATE

CALC:STAT 1

Switches on Post Processing.

CALCulate:TOTalize:TYPE

Selects postprocessing for totalize.

NOTE. If both counting registers (primary and secondary channel) are being

used, you can manipulate the measurement results before presentation by selecting one of three postprocessing formulas that operate directly on the raw data.

Group

Syntax

Arguments

Calculate

CALCulate:TOTalize:TYPE APLUSB|AMINUSB|ADIVB CALCulate:TOTalize:TYPE?

APLUSB selects the expression A + B to add the results in the two registers.

AMINUSB selects the expression A - B to s ubtract the value in registe r B from

the value in register A.

ADIVB selects the expression A / B to calculate the ratio of the contents in

registers A and B.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-45

Command Descriptions

Returns

Examples

APLUSB|AMINUS

CALCULATE:TOTALIZE:TYPE ADIVB selects the formula A / B.

CALibration:INTerpolator:AUTO

The FCA3000, FCA3100, and MCA3000 Series are reciprocal instruments that use an interpolating technique to increase the measurement resolution. In tim e measurements, for example, interpolation increases the resolution from 10 ns to 0.1 ns.

The instrument calibrates the interpolators automatically once for every measurement when this command is ON. When this command is OFF, the instrument does no calibrations but uses the values from the last preceding calibration. The intention of this command is to turn off the auto calibration for applications that dump measurements into the internal memory. This will increase the measurement speed.

Group

Calibration

B|ADIVB

Syntax

Arguments

Returns

*CLS (No Query Form)

Group

Syntax

CALibration:INTerpolator:AUTO <Boolean> CALibration:INTerpolator:AUTO?

<BOOLEAN> =(1|ON/0|OFF)

1|0

The *CLS common command clears the status data structures by clearing all event registers and the error queue. It does not clear enable registers and transition ﬁlters. It clears any pending *WAI, *OPC, and *OPC?.

Common

*CLS

Examples

2-46 FCA3000, FCA3100, MCA3000 Series Programmer Manual

*CLS

Command Descriptions

CONFigure:AR

Ray:<MeasuringFunction>

The CONFigure:ARRay command differs from the CONFigure command in that it sets up the instrument to perform the number of measurements you choose in the <array si

ze>.

To perform the selected function, you must trigger the instrument with the READ:ARRay

Group

Syntax

Arguments

Conﬁgure

CONFigure:ARRay:<MeasuringFunction> (<array size>)[,<parameters> [,(<channels>)]] CONFigure:ARRay:<MeasuringFunction>?

<ARRAY SIZE> sets the number of measurements in the array.

ASURING FUNCTION>, <PARAMETERS>

<ME

each measuring function in the following table.

Table 2-27: Measuring functions and parameters

? or INITiate;:FETCh:ARRay? queries.

and <CHANNELS> are deﬁned for

Measuring functions Parameters

FREQuency [<expected value>[,<resolution>],][(@1|@2|@3|@4|@6)] FREQuency:BURSt [<expected v alue>[,<resolution>],][(@1|@2|@ 3)] FREQuency:POWer (@3) FREQuency:PRF [<expected value>[,<resolution>],][(@1|@2|@3)] FREQuency:RATio [<expected value>[,<resolution>],][(@ 1 |@ 2|@3),(@1|@2|@3)] NCYCles (@1|@2|@3) PDUTycycle|DCYCle [<reference>],[(@1|@2)] NDUTycycle PERiod PERiod:AVERage PHASe [<expected value>[,<resolution>],][(@1|@2),(@1|@2)] PSLEwrate (@1|@2) NSLEwrate (@1|@2) RISE:TIME|RTIM [<lo threshold>[,<hi threshold>[,<expected value[,<resolution>]]],][(@1|@2)] FALL:TIME|FTIM [<lo threshold>[,<hi threshold>[,<expected value[,<resolution>]]],][(@1|@2)] PWIDth NWIDth TINTerval TSTAmp (@1|@2)

[<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2|@3)] [<expected value>[,<resolution>],][(@1|@2|@3)]

[<reference>],[(@1|@2)] [<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2),(@1|@ 2)]

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-47

Command Descriptions

Table 2-27: Measuring functions and parameters (cont.)

Measuring functions Parameters

Examples

<(@{1|2|

(@1) means input A

(@2) means input B

(@3) means input C (RF input option),

(@4) means input E (Rear panel arming input)

(@6) means the internal reference

3|4|6})> is the channel to measure on, where:

NOTE. The channel is expression data and it must be in parentheses ( ).

CONF:ARR:PER (7),5E3,1E6,(@4)

e channels are prescaled by 2 when measuring frequency, and prescaled by 1 for all other

Thes

functions. An exception is burst frequency measurements, where you can choose between thetwofactors. SeetheMEASure:FREQuency:BURSt? command and the command

FREQuency:BURSt:PREScaler[:STATe]. There is a tradeoff between the minimum number of

pulses in a burst and t he frequency range.

This example sets up the instrument to make seven period mea surements. The expected result is 5 ms, and the required resolution is 1 ms. The EXT ARM input is the measuring input.

To make the measurements and fetch the seven measurement results:

READ:ARRAY? 7 might return 5.23421E-3,5.12311E-3,5.87526E-3,

5.50345E-3,5.33901E-3,5.25501E-3,5.03571E-3

CONFigure:<MeasuringFunction>

Use the conﬁgure command instead of the measure query when you want to change other settings, for instance, the input settings before making the measurement and fetching the result.

The CONFigure command controls the settings of the Input, Sense and Trigger subsystems in the instrument in order to make the best possible measurement. It also switches off any calculations with CALC:STATE OFF.

2-48 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

READ? or INITia

te:FETCh? will make the measurement and read the resulting

measured value.

Since you may n

ot know exactly what settings the instrument has chosen to conﬁgure itself for the measurement, send an * RST before doing other manual set up measurements.

Group

Syntax

Arguments

Conﬁgure

CONFigure:<MeasuringFunction>[ <parameters>[,(<channels>)]] CONFigure:<MeasuringFunction>?

<MEASURING FUNCTION>, <PARAMETERS> and <CHANNELS> are deﬁned for

each measuring function in the following table.

Table 2-28: Measuring functions and parameters

Measuring functions Parameters

[<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2|@3)] [<expected value>[,<resolution>],][(@1|@2|@3)]

[<reference>],[(@1|@2)] [<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2),(@1|@ 2)]

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-49

Command Descriptions

Returns

<String> conta

ins the current measuring function and channel. The response is a

<String data element> containing the same answer as for [:SENSe]:FUNCtion?.

CONFigure:TOTalize[:CONTinuous]

Postprocessing of two-channel results is done with the CALCulate command. Arming is used for realizing non-manual functions like TOTalize:GATE or

ARM:STOP:TIMer.

This is a count/totalize function controlled from the GPIB interface using the command TOTalize:GATE ON|OFF.

The instrument counts up for each event on the primary input channel. The same applies to the secondary channel if it is activated. The result is one or two values depen selecting totalizing, the CONFigure:TOTalize[:CONTinuous] command also selects positive trigger slope. If you want to count negative slopes on input A, send INPut{[1]|2}:SLOPe NEG after the CONFigure:TOTalize[:CONTinuous] command. The results of successive ON-OFF periods are accumula ted.

Group

Conﬁgure

ding on the presence of the secondary channel. In addition to

Syntax

Arguments

Examples

CONFigure:TOTalize[:CONTinuous][ (@{1|2})][,(@{1|2})] CONFigure:TOTalize[:CONTinuous]?

(@{1|2}) is the primary channel: (@{1|2}) is the secondary channel:

(@1) stands for input A (@2) stands for input B

ThismeasurementcannotbemadeasaMEASure,itmustbemadeasa CONFigure followed by INIT:CONT ON, gate control with SENS:TOT:GATE {ON|OFF} and completed with a FETCh:ARR? <array size>.

CONF:TOT;:INP:SLOPE NEG

This example sets up the instrument to totalize the negative slopes on Input A and disable the secondary channel. (Same as (@1))

Normal Program Sequence for Totalizing o n A

CONFIGURE:TOTALIZE[: CONTINUOUS]

INIT:CONT ON TOT:GATE ON Start totalizing FETC:ARR? -1

(@1)

Set up the instrument for totalize on A, reset registers

Initiate the instrument continuously

Read the most recent intermediate result without stopping the totalizing

2-50 FCA3000, FCA3100, MCA3000 Series Programmer Manual

*DDT

Command Descriptions

Normal Program Sequence for Totalizing on A

TOT:G ATE OFF Stop totalizing FETC:ARR? -1 Fetch the ﬁnal result from the totalizing

NOTE. When totalizing you often want to read intermediate results without

stopping th register value.

Sets or queries the command that the device will execute on receiving the GET interfac

e totalizing process. FETC:ARR? -1 always outputs the current

e message or the *TRG common command.

Arguments

Examples

DISPlay:ENABle

Group

Syntax

Common

*DDT <arbitrary block> *DDT?

<arbitrary block> is one of six accepted blocks:

#14INIT #15FETC?

#15READ? #18ARM:LAY2 #19INIT;*OPC #215ARM:LAY2;:FETC?

*DDT #19INIT; *OPC?

Turns On/Off the updating of the screen. This can be used for security reasons or to improve the GPIB speed when the screen does not need to be updated.

Group

Syntax

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-51

Display

DISPlay:ENABle < Boolean > DISPlay:ENABle?

Command Descriptions

*DMC

Arguments

Returns

Group

<BOOLEAN> =(1/

1|0

Allows you to assign a sequence of one or more program message units to a macro label. The sequence is executed when the macro label is received as a command or query. Twenty-ﬁve macros can be deﬁned at the same time, and each macro can contain an average of 40 characters.

If a macro has the same name as a command, it masks out the real command with thesamenamewhenmacrosareenabled. Ifmacrosaredisabled,theoriginal command is executed.

If you deﬁne macros when macro execution is disabled, the instrument executes the * DMC command fast, but if macros are enabled, the execution time for this command is longer.

Common

ON | 0 / OFF)

*EMC

Syntax

Arguments

Examples

Group

*DMC <Macro label>, <Program messages>

<MACRO LABEL> is a 1- to 12-character macro label. Enclose string data in quotes

(“ ”or ' '), as shown in the example.

<PROGRAM MESSAGES> the commands to be executed when the macro label is

received, both block data and string data formats can be used.

*DMC 'FREQUENCY?', "FUNC 'FREQ 1'; INP:LEV:AUTO ON; ARM:SOURCE BUS; INIT:CONT ON; *TRG"

This command enables and disables expansion and execution of macros. If macros are disabled, the instrument will not recognize a macro although it is deﬁned in the instrument. (The Enable Macro command takes a long time to execute.)

Common

2-52 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Syntax

Arguments

Returns

Examples

*ESE (No Query Form)

*EMC <Decimal d *EMC?

<DECIMAL DATA> = is 0 or 1. A value which rounds to 0 turns off macro

ata>

execution. Any other value turns macro execution on.

NOTE. 1 or 0 is <Decimal data>, not <Boolean>! ON and OFF are not valid

arguments for this command.

{1 | 0}

1 means that macro expansion is enabled. 0 means that macro expansion is disabled.

*EMC 1

Enables macro expansion and execution.

Group

Syntax

Arguments

Sets the enable bits of the standard event enable register. This enable register contains a mask value for the bits to be enabled in the standard event status register. A bit that is set true in the enable register enables the corresponding bit in the status register. An enabled bit will set the ESB ( Event Status Bit) in the Status Byte Register if the enabled event occurs. (See page 3-3, The Event Status Enable Register (ESER).)

Common

*ESE <Decimal data>

<DEC.DATA> = the sum (between 0 and 255) of all bits that are true.

Table2-29:Eventstatusenableregister(1=enable)

Bit Weight Enables

7 664 5 4 16 EXE, Execution Error

128

PON, Power-on occurred URQ, User Request CME, Command Error

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-53

Command Descriptions

Table 2-29: Event status enable register (1 = enable) (cont.)

Bit Weight Enables

3 8 DDE, Device Dependent

Error 24 12

QYE, Query Error

RQC, Request Control (not

used)

Operation Complete

*ESR?

Returns

Examples

Group

Syntax

Returns

*ESE 36

In this example, command error bit 5, and query error bit 2, will set the ESB-bit of the Status Byte if these errors occur.

Reads out the contents of the standard event status register. Reading the Standard Event Status Register clears the register.

Common

*ESR?

<dec.data> = the sum (between 0 and 255) of all bits that are true. (See Table 2-29 on page 2-53.)

FETCh:ARRay? (Query Only)

FETCh:ARRay? query differs from the FETCh[:SCALar]? querybyfetching

several measuring results at once.

An array of measurements must ﬁrst be made by the commands: INITiate,

MEASure:ARRay:<MeasuringFunction>? or CONFigure:ARRay: <MeasuringFunction>; READ:ARRay?.

If the array size is set to a positive value, the ﬁrst measurement made is the ﬁrst result to be fetched.

2-54 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

When the instru 10 fetches the ﬁrst 10 measuring results from the output queue. The second

FETCh:ARRay? 10 fetches the result 11 to 20, and so on. When the last measuring

result is fetched,

In totalizing for instance, you may want to read the last measurement result instead of the ﬁrst one. This is possible if you set the array size to a negative number. Example: queue pointer is not altered when the array size is negative. That is, the example above always returns the last ﬁve results every time the command is sent.

FETCh:ARRay? -1 is useful to fetch intermediate results in free-running or array

measurements without interrupting the measurement.

Group

Syntax

Fetch

FETCh:ARRay? <fetch array size>|MAX

FETCh[:SCALar]? (Query Only)

The fetch query retrieves one measuring result from the measurement result buffer of the instrument without making new measurements. Fetch does not work unless a measurement was taken by the INITiate, MEASure:<MeasuringFunction>?, or READ? commands.

ment has made an array of measurements,

FETCh:ARRay? starts over again with the ﬁ rst result.

FETCh:ARRay? -5 fetches the last ﬁve results. The output

FETCh:ARRay?

Group

If the instrument has made an array of measurements, the ﬁrst measuring results ﬁ rst. The second

FETCh[:SCALar]? fetches the

FETCh[:SCALar]? fetches

second result and so on. When the last measuring result is fetched, fetch starts over again with the ﬁrst result.

The same measuring result can be fetched again and again if the result is valid, until the following occurs:

*RST is received.

an INITiate, MEASure or READ command is executed

any reconﬁguration is done.

an acquisition of a new reading is started.

If the measuring result in the output buffer is invalid, but a new measurement was started, the fetch query completes when a new measuring result becomes valid. If no new measurement was started, an error is returned.

The optional SCALar means that one result is retrieved.

Fetch

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-55

Command Descriptions

FORMat

Related Commands

Syntax

Group

Syntax

Arguments

FETCh[:SCALar

Sets the format in which the result is sent on the bus.

Format

FORMat ASCii|REAL|PACKed FORMat?

FORMat:TINFormation, FETCh[:SCALar]?

ASCII: The length is automatically controlled by the resolution of each

measurement result.

REAL: The length parameter is ignored; the output is always in 8-byte format.

PACKED:SeeREAL.

Returns

FORMat:BORDer

Group

Syntax

Related Commands

Arguments

ASC|REAL|PACK

Sets the order in which response data bytes formatted as REAL or PACKED are sent on the bus.

Format

FORMat:BORDer NORMal|SWAPped FORMat:BORDer?

FORMat

NORMAL:ResponsedataissentwiththeMSBﬁrst and the LSB last (big-endian

order)

SWAPPED: Response data is sent with the LSB ﬁrst and the MSB last (little-endian

order)

2-56 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

FORMat:SMAX

Arguments

Returns

Group

Syntax

Returns

NORM or SWAP

Sets or queri of samples. The command is intended to set an upper limit for use with any controllers or application p rograms that cannot read large amounts of data.

Format

FORMat:SMAX <Numeric value> FORMat:SMAX?

Integer N,where4≤ N ≤ 10000

es the upper limit for FETCh:ARRay? MAX command in number

FORMat:TINFormation

This command turns on/off the time stamping of measurements. Time stamping is always done at the start of a measurement with full measurement resolution, and is saved in the measurement buffer together with the measurement result.

The setting of this command will affect the output format of the MEASure, READ and FETCh queries. See the FETCh[:SCALar]? query.

For FETCh:SCALar?, READ:SCALar? and MEASure:SCALar? the readout consists of two values instead of one. The ﬁrst value is the measured value and the second value is the timestamp value.

In FORMat ASCII mode, both the measured value and the timestamp value are given as ﬂoating-point numbers expressed in the basic units (Hz or s).

In FORMat REAL mode, the result is given as an eight-byte block containing the

ﬂoating-point measured value, followed by an eight-byte block containing the ﬂoating point timestamp value.

In FORMat PACKed mode, the result is given as an eight-byte block containing the ﬂoating-point measured v alue followed by an eight-byte block containing the timestamp value expressed as a 64-bit integer (int64), the implicit unit being ps.

When doing readouts in array form, with FETCh:ARRay?, READ:ARRay?, or MEASure:ARRay?, the response will consist of alternating measurement values.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-57

Command Descriptions

Group

Syntax

Format

FORMat:TINFormation Boolean FORMat:TINFormation?

FREQuency:BURSt:APERture

Sets the time length within a burst during which the burst frequency is measured.

Group

Syntax

Arguments

Returns

Sense

FREQuency:BURSt:APERture {<Numeric value>|MIN|MAX} FREQuency:BURSt:APERture?

<NUMERIC VALUE> isanumberbetween2E-8(20ns)and2s.

FREQuency:BURSt:PREScaler[:STATe]

The burst frequency limit is 300 MHz if the prescaler is ON and 160 MHz if it is OFF.

Group

Syntax

Arguments

Returns

Sens

FREQuency:BURSt:PREScaler[:STATe] <Boolean> FREQuency:BURSt:PREScaler[:STATe]?

<BOOLEAN> = (1 | ON | 0 | OFF)

1|0

FREQuency:BURSt:STARt:DELay

Sets the burst start delay (the time length between the burst start and the actual start of the burst measuring time). This parameter controls the point of time when a measurement sample is taken.

2-58 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Group

Syntax

Arguments

Returns

Sense

FREQuency:BURSt:STARt:DELay {<Numeric value>|MIN|MAX} FREQuency:BURSt:STARt:DELay?

<NUMERIC VALUE> is a number between 2E-8 (20 ns) and 2 s.

FREQuency:BURSt:SYNC:PERiod

Sets the synchronization delay time used in burst measurements. A correct value should be longer than the burst time and shorter than 1/PRF (the inverse of the pulse repetition frequency).

Group

Syntax

Sense

FREQuency:BU FREQuency:BURSt:SYNC:PERiod?

RSt:SYNC:PERiod {<Numeric value>|MIN|MAX}

Arguments

Return

<NUMERIC VALUE> is a number between 1E-6 (1 μs)and2s.

FREQuency:POWer:UNIT

Selects dBm or W as the basic measurement unit to be displayed or read out.

Group

Syntax

Arguments

Sense

FREQuency:POWer:UNIT DBM|W FREQuency:POWer:UNIT?

DBM | W

The reference level 0 dBm is 1 mW in 50 Ω. Increasing the level by 3 dB means doubling the power. Decreasing the level by 3 dB means halving the power.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-59

Command Descriptions

Returns

DBM | W

FREQuency:RANGe:LOWer

Use this command to speed up voltage measurements and Autotrigger functions when you do not need to measure on low frequencies.

Table 2-30: Time to determine trigger levels (typical)

Min. freque

8s 80ms

Group

Syntax

Arguments

Sense

FREQuency:RANGe:LOWer {<Numeric value>|MIN|MAX} FREQuency:RANGe:LOWer?

<NUMERIC VALUE> between 1 and 50000 (Hz).

MIN sets 1 Hz.

ncy limit (1 Hz)

Default (10

0Hz)

MAX sets 50 kHz.

Returns

FREQuency:REGRession

Despite its name, this command also applies to Period Average.

By continuous time stamping and linear regression analysis, the resolution compared to a normal reciprocal instrument is improved by one or two digits for measuring times between 200 ms and 100 s.

Not all combinations of settings will work:

In local mode (front panel control), this function may be overridden by the ﬁrmware:

An info box pops up explaining this.

Measurement time < 16 us: On is changed to Auto(Off)

Measurement time > 2.5 s: Off is changed to Auto(On)

External arming: On is changed to Auto(Off)

2-60 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

FUNCtion

Group

Syntax

Group

Syntax

In remote mode (

bus control), no consistency checks are made until you try to issue an INITiate command. If, at that time, the settings are inconsistent, you get a "Settings conﬂict" error, and the measurement will not start.

Sense

FREQuency:REGRession ON|OFF|AUTO FREQuency:REGRession?

Selects which me asuring function is to be performed and on which channel(s) the instrument should measure.

Sense

FUNCtion '<Measuring function> [<Primary channel> [,<Secondary channel>]]' FUNCtion?

Arguments

<MEASURING FUNCTION> is the function you want to select. Choose a function

from the following table.

<PRIMARY CHANNEL> is the channel used in all single-channel measurements

and the main channel in dual-channel measurements.

<SECONDARY CHANNEL> is the other channel in dual-channel measurements.

Only the primary channel may be programmed for all single channel measurements.

NOTE. The measuring function and the channels together form one <String> that

must be placed within quotation marks.

Table 2-31: Measuring functions and channels

Measuring functions Available channels

FREQuency 1|2|3|4|6 FREQuency:RATio 1|2|3,1|2|3 FREQuency:BURSt 1|2|3 FREQuency:PRF 1|2|3 NCYCles 1|2|3

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-61

Command Descriptions

Table 2-31: Measuring functions and channels (cont.)

Measuring functions Available channels

1|2 1|2|3 1|2|3

1|2 1|2 1|2,1|2

Returns

Examples

*GMC? (Query Only)

Group

Syntax

Arguments

Returns

“<Measuring function>,<Primary channel>[,<Secondary channel>]”

Select a pulse period measurement on input A (channel 1):

FUNCTION'PERIOD 1'

This command returns the deﬁnition of the speciﬁed macro label.

Common

*GMC? < macro label>

<Macro label> = the label of the macro for which you want to see the deﬁnition. (String data must be surrounded by or “ ”or ' ' as in the example below.)

2-62 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Examples

*GMC? 'AUTOTRG

Returns a block data response, for example:

#242:FUNC 'FREQ 1'; INP:LEV:AUTO ONCE; INP:LEV?

HCOPy:SDUMp:DATA? (Query Only)

Returns block data containing screen dump in Windows BMP format.

Group

Syntax

Returns

Hard Copy

HCOPy:SDUMp:DATA?

#43942<Binary BMP Data>

The '4' means that the following four digits (3942) tell how many data bytes will succeed. The proper screen data is preceded by a 62-byte header, which means that 3942 - 62 = 3880 bytes carry the pixel information. The number o f pixels is 3880x8=31040. Thedisplaygeometryis320x97=31040.

LVL?'

HF:ACQuisition[:STATe]

Group

Syntax

Arguments

Returns

Switches the automatic acquisition system on o r off. ON means Automatic Acquisition, OFF means Manual Acquisition. When the instrument is switched from remote to local operation, Automatic Acquisition mode is entered, irrespective of the previous remote setting.

Sense

HF:ACQuisition[:STATe] <Boolean> HF:ACQuisition[:STATe]?

<BOOLEAN> = {1 | ON} | {0 | OFF}

1|0

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-63

Command Descriptions

HF:FREQuency

:CENTer

Group

Syntax

Arguments

Returns

*IDN? (Query Only)

Sets the center frequency value for the RF input. Used when Manual Acquisition is selected.

Sense

HF:FREQuency:CENTer <Numeric value> HF:FREQuency:CENTer?

<Numeric value> = a number between 3*108(Hz) and 27*109, 40*109, 46*10 or 60*109(Hz), depending on the model number -27G, -40G, -46G or -60G respectively.

Returns the manufacturer, model, serial number, and ﬁrmware level in an ASCII response data element. The query must be the last query in a program message.

Response is <Manufacturer>, <Model>, <Serial Number>, <Firmware Level>.

Group

Syntax

Examples

Common

*IDN?

*IDN? might return <MANUFACTURER>, <MODEL>, 1234567, V1.01 28 Jun 2004

INITiate (No Query Form)

The INITiate command initiates a measurement. Executing an INITiate command changes the instrument trigger subsystem state from idle-state to wait-for-bus-arm-state. The trigger subsystem will continue to the other states, depending on programming. With the *RST setting, the trigger subsystem will bypass all its states and m ake a measurement, then return to idle state. (See page 2-23, Trigger Subsystem.)

Group

Initiate

2-64 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Syntax

INITiate:CONTinuous

Group

Syntax

Returns

INITiate

The trigger system could continuously be initiated with this command. When Continuous is OFF, the trigger system remains in the idle-state until Continuous is set to ON or the INITiate is received. When Continuous is set to ON, the completion of a measurement cycle immediately starts a ne w trigger cycle without entering the idle-state. In other words, the instrument is continuously measuring and storing response data.

Initiate

INITiate:CONTinuous <Boolean> INITiate:CONTinuous?

1|0

INPut{[1]|2}:ATTenuation

Attenuates the speciﬁed input channel signal by 1 or 10. The attenuation is automatically set if the input level is set to AUTO.

Group

Syntax

Arguments

Returns

Examples

Input

INPut{[1]|2}:ATTenuation {<Numeric value>| MAX | MIN } INPut{[1]|2}:ATTenuation?

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

Numeric values <5 or

Numeric values ≥5or

1.00000000000E+000|1.00000000000E+001

INPUT:ATTENUATION 10 sets the Input A attenuation to x10.

MIN set the attenuation to 1.

MAX set the attenuation to 10.

INPUT2:ATTENUATION MIN sets the Input B attenuation to x1.

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-65

Command Descriptions

INPut{[1]|2}

:COUPling

Group

Syntax

Returns

Examples

INPut{[1]|2}:FILTer

Selects AC coupling (normally used for frequency measurements), or DC coupling (normally used for time measurements).

Input

INPut{[1]|2}:COUPling {AC|DC} INPut{[1]|2}:COUPlin

AC|DC

INPUT{[1]|2}:COUPLING DC

INPUT{[1]|2}:COUPLING AC

Switches on or off the analog l It has a cutoff frequency of 100 kHz.

ow pass ﬁlter on input 1 (A) and/or input 2 (B).

Group

Syntax

Arguments

Returns

Input

INPut{[1]|2}:FILTer <Boolean> INPut{[1]|2}:FILTer?

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

<BOOLEAN> = {1 | ON} | {0 | OFF}

1|0

INPut{[1]|2}:FILTer:D I Gita l

Switches on or off the digital low pass ﬁlter on input 1 (A) and/or input 2 (B). The cutoff frequency is set by the command: INPut{[1]|2}:FILTer:DIGital:FREQuency

Group

Input

2-66 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Syntax

Arguments

Returns

INPut{[1]|2}: INPut{[1]|2}:FILTer:DIGital?

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

<BOOLEAN> = {1 | ON} | {0 | OFF}

1|0

INPut{[1]|2}:FILTer:DIGital:F

Any frequency between 1 Hz and 50 MHz can be entered. The ﬁlter is activated by the command: INPut{[1]|2}:FILTer:DIGital

Group

Syntax

Input

INPut{[1]|2}:FILTer:DIGital:FREQuency {<Numeric value>| MIN |MAX} INPut{[1]|2}:FILTer:DIGital:FREQuency?

FILTer:DIGital <Boolean>

REQuency

Arguments

Returns

INPut{[1]|2}:IMPedance

Group

Syntax

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

<NUMERIC VALUE> is a value between 1 and 50000000.

MIN sets the ﬁlter to 1 Hz.

MAX sets the ﬁlterto50MHz.

The impedance can be set to 50 Ω or 1 MΩ.

Input

INPut{[1]|2}:IMPedance {<Decimal data>| MAX | MIN } INPut{[1]|2}:IMPedance?

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-67

Command Descriptions

Arguments

Returns

Examples

INPut{[1]|2}:LEVel

INPut{[1]|2} s

peciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

MIN or <DECIMA

L DATA>

that rounds off to 50 or less, sets the input impedance

to 50 Ω.

MAX or <DECI

MAL DATA>

that rounds of f to 1001 or more, sets the impedance

to1MΩ.

5.00000000000E+001|1.00000000000E+6

INPUT:IMPEDANCE 50 sets the input A impedance to 50 Ω.

INPUT2:IMPEDANCE 1000000 sets the input B impedance to 1 MΩ.

Input A and input B can be individually set to autotrigger or to ﬁxed trigger levels of between -5V and +5V in steps of 2.5mV. If the attenuator is set to 10X, the range is -50V and +50V in 25 mV steps. Setting an absolute trigger level turns off autotrigger for the selected channel.

Group

Syntax

Arguments

Returns

Examples

For autotrigger, see INPut{[1]|2}:LEVel:AUTO.

Input

INPut{[1]|2}:LEVel {<Decimal data>| MAX | MIN } INPut{[1]|2}:LEVel?

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

<DECIMAL DATA> is a number between -5V and +5V if att = 1X, and between

-50V and +50V if att = 10X.

MAX sets +5 V or +50 V and MIN sets -5 V or -50 V, depending on the attenuator

setting.

INPUT:LEVEL 0.01

INPUT2:LEVEL 2.0

2-68 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

INPut{[1]|2}

:LEVel:AUTO

If set to AUTO, the instrument automatically controls the trigger level.

The autotrigger function normally sets the trigger levels to 50 % of the signal amplitude, except for the following measurements or modes:

Group

Syntax

Input

INPut{[1]|2}:LEVel:AUTO {<Boolean> | ONCE} INPut{[1]|2}:LEVel:AUTO?

Rise/Fall time measurements: Here the Input 1 (A) trigger level is set to 10 resp. 90% and the Input 2 (B) trigger level is set to 90% respectively. 10% of the amplitude.

Frequency and Period Average mode: The input trigger levels are set to 70% and 30% of the signal amplitude.

Functions for which AUTO does not work are Frequency or Period Back-to-Back, Time Interval Error (TIE) and Totalize. If one of these is selected, an AUTO ONCE is performed instead.

Arguments

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

<BOOLEAN> ={1|ON}|{0|OFF}.

ONCE sets the instrument to make one automatic calculation of the trigger level at

the beginning of a measurement. This value is then used until another level-setting command is sent to the instrument, or until a new measurement is initiated.

INPut{[1]|2}:LEVel:RELative

When autotrigger is active, the relative trigger levels are normally ﬁxed at values that depend on the selected function, for instan 90% (Input B) for Rise Time, 50% (Input A & Input B) for Time Interval, 70% (Input A) and 30% (Input B) for Frequency. At times you may want to change these values. Since the default values are restored automatically after changing function, this command may have to be sent repeatedly. The two input channels are programmed separately and are not interdependent.

The command itself does not switch on autotrigger, so if you want to set relative levels after having used absolute levels, you must also send the command

INPut{[1]|2}:LEVel:AUTO, unless you have changed measurement function.

ce 10% (Input A ) and

Group

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-69

Input

Command Descriptions

Syntax

Arguments

Returns

Examples

INPut{[1]|2}:SLOPe

INPut{[1]|2}: INPut{[1]|2}:LEVel:RELative?

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

LEVel:RELative <Numeric value>

entered for this argument, the command sets the attenuation for Input A.

<NUMERIC VALUE> is a positive number between 0 and 100 (%).

INPUT:LEVEL:RELATIVE 20 (Input A set to 20% to measure ECL rise time)

INPUT2:RELATIVE 80 (Input B set to 80% to measure ECL rise time)

Selects if the instrument should trigger on a positive or a negative transition. Selecting negative slope is useful for Time Interval measurements.

The slope is ﬁxed for Pos/Neg Pulse Width/Duty Factor and Rise/Fall Time.

Group

Syntax

Arguments

Returns

Examples

Arming slope is not affected by this command. Use ARM:STARt:SLOPe and ARM:STOP:SLOPe instead.

Input

INPut{[1]|2}:SLOPe {POS | NEG} INPut{[1]|2}:SLOPe?

INPut{[1]|2} speciﬁes the input channel to set (1 = A, 2 = B). If no value is

entered for this argument, the command sets the attenuation for Input A.

POS sets the instrument to trigger on a positive signal transition.

NEG sets the instrument to trigger on a negative signal transition.

POS | NEG

INPUT:SLOPE POS

INPUT2:SLOPE NEG

2-70 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

*LMC? (Query O

Syntax

Returns

Examples

*LRN?

nly)

Group

Makes the instrument send a list of string data elements, containing all macro labels deﬁned in the instrument.

Common

*LMC?

<String> { ,<String> }

<String> = a Macro label. (String data is surrounded by quotes as in the example below.)

*LMC? might return AUTOFILT, "AMPLITUDE?"

Learn Device Setup Query. Causes a response message that can be sent to the instrument to return it to the state it wasinwhenthe*LRN?querywasmade.

Group

Syntax

Returns

Examples

Common

*LRN?

:SYST:SET_<Block data>

Where: <Block data> is #3104<104 data bytes>

*LRN?

MEASure:ARRay:FREQuency:BTBack? (Query Only)

This is the inverse function of Period Back-to-Back. See MEASure:ARRay:

PERiod:BTBack?.IfCALCulate:AVERage:STATe is

used for pacing the time stamps. The pacing parameter is not used in this case. Thus a series of consecutive frequency average measurements without dead time canbemadeinordertofulﬁl the requirements for correct calculation of Allan variance or deviation.

ON, measurement time is

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-71

Command Descriptions

Group

Syntax

Arguments

Measurement

MEASure:ARRay:FREQuency:BTBack? (<array size>)[,(@1)|(@2)]

<ARRAY SIZE> sets the number of samples. (@1)|(@2) is the measurement

channel:

(@2) means input B

(@1) means input A

MEASure:ARRay:<MeasuringFunction>? (Query Only)

The MEASure:ARRay:<MeasuringFunction>? query differs from the

MEASure:<MeasuringFunction>? query in that it performs the number of

measurements you decide in the <array size> and sends all the measuring results in one string to the controller.

NOTE. The array size for MEASure and CONFigure, and the channels, are

expression data that must be in parentheses ( ).

The MEASure:ARRay:<MeasuringFunction>? query is a compound query identical to: :ABORt; CONFigure:ARRay:<Meas-func>(<array-size>); READ:ARRay?(<array-size>)

Group

Syntax

Arguments

Measurement

MEASure:ARRay:<MeasuringFunction>? (<arraysize>)[,[<parameters>] [,(<channels>)]]

<ARRAY SIZE> sets the number of measurements in the array. The maximum

number is limited to 10000 due to the physical size of the output buffer. See also FETCH:ARR? and READ:ARR?

<MEASURING FUNCTION>, <PARAMETERS> and <CHANNELS> are deﬁned for

each measuring function in the following table.

Table 2-32: Measuring functions and parameters

Measuring functions Parameters

FREQuency [<expected value>[,<resolution>],][(@1|@2|@3|@4|@6)] FREQuency:BURSt [<expected value>[,<resolution>],][(@1|@2|@3 )] FREQuency:POWer (@3)

2-72 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Table 2-32: Measuring functions and parameters (cont.)

Measuring functions Parameters

[<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2|@3)] [<expected value>[,<resolution>],][(@1|@2|@3)]

[<reference>],[(@1|@2)] [<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2),(@1|@ 2)]

Returns

Examples

<Measuring result>{[,<measuring result>]}

MEASURE:ARRAY:FREQUENCY? (10) returns ten measurement results.

MEASure:ARRay:PERiod:BTBack? (Query Only)

Every positive or negative zero crossing (depending on the selected slope) up to the m aximum frequency (125 kHz with interpolator calibration ON or 250 kHz with interpolator calibration OFF) is time-stamped. For every new time stamp the previous value is subtracted from the current value, and the result is stored.

If CALCulate:AVERage:STATe is maximum input frequency. For higher frequencies the average period time during the 4 μsor8μs observation time is stored. So, for higher frequencies the actual function is rather Period Average Back-to-Back.

ON, the array contains all periods up to the

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-73

Command Descriptions

The main purpos

eofthisfunctionistomakecontinuousmeasurementsof relatively long period times without losing single periods due to result processing. A typical example is the 1-pps timebase output from GPS receivers.

Group

Syntax

Arguments

Measurement

MEASure:ARRay:PERiod:BTBack? (<array size>)[,(@1)|(@2)]

<ARRAY SIZE> sets the number of samples. (@1)|(@2) is the measurement

channel:

(@2) means input B

(@1) means input A

MEASure:ARRay:STSTamp? (Query Only)

A time stamp (T input channel. The commands MEASure:ARRay:<MeasuringFunction>? and CONFigure:ARRay:<MeasuringFunction> automatically invoke

FORMat:TINFormation

instead, you should normally let it be preceded by the FORMat:TINFormation

ON command explicitly. Otherwise the TS

format belo

S) is taken of the trigger level crossing on the selected

ON to get the time stamp data, but when FUNCtion is used

values are omitted. See Returned

Group

Syntax

Arguments

The deadtime to the next TS is due to pacing and interpolator calibration and can go down

to 4 μs. The X register/counter records the number of trigger level

crossings.

Dependin values are output for each TS. If the timestamp is output. If

gonthestateofthecommandFORMat:TINFormation,oneortwo

OFF, only the content of the X register/counter at

ON, both the X register/counter and the TS value are

read and output as two values, separated by a comma in ASCII and REAL mode.

TS is the time stamp value in seconds since a certain start event that is not available for external control.

Therefore the TS values can only be used for relative time measurements.

Measurement

MEASure:ARRay:STSTamp? (<array size>)[,(@1)|(@2)]

Array size is the number of TS. One TS can contain 1 or 2 numeric values depending on the state of the FORMat:TINFormation command.

2-74 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

Returns

<number of trg l

vl crossings>,(<TS for trg lvl crossing>,)...deadtime...<number of

trg lvl crossings>(<TS for trg lvl crossing>,)...deadtime...and so forth.

Theformatiss

et by the FORMat command, and the data in parentheses is sent if

FORMat:TINFormation ON is active.

MEASure:ARRay:TIError? (Query Only)

This command automatically performs TIE measurements on clock signals from a predeﬁned collection of system frequencies: 4, 8, 1 5.75, 64 kHz or 1.544, 2.048, 5, 10, 27, 34, 45, 52 MHz

TIE is deﬁned as positive and increasing if the measured frequency exceeds the reference frequency.

Group

Syntax

Measurement

MEASure:ARRay:TIError? (array size)[,[<exp value>[,<resol>],][(@1|(@2)]]

MEASure:ARRay:TSTAmp? (Query Only)

Time stamps are taken of all positive and negative trigger level crossings of the selected input channel. The commands MEASure:ARRay:<MeasuringFunction>? and CONFigure:ARRay:<MeasuringFunction> automatically invoke

FORMat:TINFormation

instead, you should normally let it be preceded by the FORMat:TINFormation

ON command explicitly. Otherwise the TS

format below.

Measurements are performed in groups of four TS results, two positive and two negative, with no deadtime between the values. Deadtime between groups is affected by pacing and interpolator calibration, down to 4 μs.

Measurement results of 0 indicate negative trigger level crossings, whereas positive v alues indicate the number of positive trigger level crossings since the last reset.

TS is the time stamp value in seconds since a certain start event that is not available for external control.

So the TS values can only be used for relative time measurements.

Group

Measurement

ON to get the time stamp data, but when FUNCtion is used

values are omitted. See Returned

Syntax

MEASure:ARRay:TSTAmp? (<array size>)[,(@1)|(@2)]

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-75

Command Descriptions

Arguments

<array size> se

ts the number of samples. One complete group requires an array size of 4. It can contain 4 or 8 numeric values depending on whether

FORMat:TINFormation is

OFF or ON.

MEASure{:FALL:TIME|:FTIM}? (Query Only)

The transition time from 90% to 10% of the signal amplitude is measured.

The measurement is always a single measurement and the Auto-trigger is always on, setting the trigger levels to 9 0% and 10% of the a mplitude. If you need an average transition time measurement, or other trigger levels, use the SENSe subsystem a nd manually set trigger levels instead.

Group

Syntax

Arguments

Measurement

MEASure{:FALL:TIME|:FTIM}?[ [<lower threshold> [,<upper threshold>[,<expected value>[,<resolution>]]]] [,(@1|@2)] ]

<LOWER THRESHOLD>, <UPPER THRESHOLD>, <EXPECTED VALUE> and <RESOLUTION> are all ignored by the instrument.

<(@1)> or <(@2)> is the measurement channel (input A or input B).

MEASure:FREQuency? (Query Only)

Traditional frequency measurements. The instrument uses the <expected value> and <resolution> to calculate the Measurement Time (ACQuisition:APERture).

Group

Syntax

Arguments

Measurement

MEASure:FREQuency?[ [<expected value>[,<resolution>]] [,<(@{1|2|3|4|6})>]]

<expected value> is the expected frequency,

<resolution> is the required resolution.

<(@{1|2|3|4|6})> is the channel to measure on, where:

(@1) means input A

(@2) means input B

(@3) means input C (RF input option),

2-76 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

(@4) means inpu

(@6) means the internal ref erence

t E (Rear panel arming input)

NOTE. The channel is expression data and it must be in parentheses ( ).

These channels are prescaled by 2 when measuring frequency, and prescaled by 1 for all other

functions. An exception is burst frequency measurements, where you can choose between the two factors. See the MEASure:FREQuency:BURSt? command and the command

FREQuency:BURSt:PREScaler[:STATe]. There is a tradeoff between the minimum number of

pulses in a burst and the frequency range.

Examples

MEASURE:FREQUENCY? (@3) might return 1.78112526833E+009,which

measures the frequency at input C.

MEASure:FREQuency:BURSt? (Query Only)

Measures the carrier frequency of a burst. The burst duration must be less than 50% of the pulse repetition frequency (PRF).

How to measure bursts is described in detail in the Operators Manual.

Group

Syntax

Arguments

The instrument uses <expected value> and <resolution> to select a Measurement Time. See ACQuisition:APERture.SeeFREQuency:BURSt:SYNC:PERiod.

Measurement

MEASure:FREQuency:BURSt?[ [<expected value>[,<resolution>]] [,<(@{1|2|3|4})>]]

<EXPECTED VALUE> is the expected carrier frequency, <RESOLUTION> is the

required resolution; for example, 1 sets 1 Hz resolution.

<(@{1|2|3|4})> is the measurement channel:

(@1) means input A

(@2) means input B

(@3) means input C (RF input on FCA3003, FCA3020, FCA3103, FCA3120,

MCA3027, and MCA3040)

(@4) means input E (Rear panel arming input)

If you omit the channel, the instrument measures on input A

The prescaling factor for these channels can be set to 1 or 2 with the command

FREQuency:BURSt:PREScaler[:STATe].

(@1).

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-77

Command Descriptions

MEASure:FREQ

uency:POWer[:AC]? (Query Only)

Measures the power of the signal on input C in dBm or W. Use the command

FREQuency:POWer:UNIT to select measurement unit.

Group

Syntax

Arguments

Measurement

MEASure:FREQuency:POWer[:AC]?[ (@3)]

(@3) is the measurement channel number of the RF input C. It is redundant in

this case, as there is no other RF channel available.

MEASure:FREQuency:PRF? (Query Only)

Measures the PRF ( Pulse Repetition Frequency) of a burst signal. The burst duration must be less than 50% of the pulse repetition frequency (PRF).

NOTE. It is better to set up the measurement with the FUNCtion “:FREQ:PRF”

command when measuring pulse repetition frequency. This command will allow you to set a suitable sync delay with the FREQuency:BURSt:SYNC:PERiod command.

Group

Syntax

Arguments

How to measure bursts is described in detail in the Operators Manual.

Measurement

MEASure:FREQuency:PR val.>[,<res.>]][,<(@{1|2|3|4})>]]

<EXP. VAL.> is the expected PRF, <RES.> is the required resolution.

<(@{1|2|3|4})> is the measurement channel:

(@1) means input A

(@2) means input B

(@3) means input C (RF-input option)

(@4) means input E (Rear panel arming input)

If you omit the channel, the instrument measures on input A

F?[[<exp.

(@1).

2-78 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

MEASure:FRE

Arguments

The <EXPECTED V Measurement Time ( ACQuisition:APERture).TheSync.Delayisalways10ms (default value).

ALUE>

and <RESOLUTION> are used to calculate the

Quency:RATio? (Query Only)

Frequency ratio measurements between two inputs.

Group

Syntax

Measurement

MEASure:FREQuency:RATio?[ [<expected value> [,<resolution>]][,<(@{1|2|3})>,<(@{1|2|3})>]]

<expected value> and <resolution> are igno

<(@{1|2|3})>,<(@{1|2|3})> are the measurement channels: A,

(@2) means input B, (@3) means input C (R

If you omit the channels, the instrument measures between input A and input B.

red

(@1) means input

F input option)

NOTE. The channel is expression d ata and must be within parentheses ( ).

Examples

MEASURE:FREQUENCY:RATIO? (@1),(@3) might return 2.345625764333E+000.

This example measures the ratio between input A and input C.

MEASure:<MeasuringFunction>? (Query Only)

The measure query makes a complete measurement, including conﬁguration and readout of data. Use measure when without ﬁne tuning.

NOTE. When a CONFigure command or

query is issued, all instrument settings are set to the *RST settings, except those speciﬁed as <parameters> and <channels> in the CONFigure command or

MEASure:<MeasuringFunction>? query.

You cannot use the MEASure: <MeasuringFunction>? query with

CONFigure:TOTalize[:CONTinuous], since this function measures without

stopping (continuously fore

ver).

you can accept the generic measurement

MEASure:<MeasuringFunction>?

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-79

Command Descriptions

The MEASure:<M

easuringFunction>?

query is a compound query identical to

ABORt; CONFigure:<Meas_func>; READ?

NOTE. Aborts all previous measurement commands if * WAI is not used.

Group

Syntax

Arguments

Measurement

MEASure:<MeasuringFunction>?[ [<parameters>][ ,(<channels>)]]

<MEASURING FUNCTION>, <PARAMETERS> and <CHANNELS> are deﬁned for

each measuring function in the following table.

Table 2-33: Measuring functions and parameters

Measuring functions Parameters

FREQuency [<expected value>[,<resolution>],][(@1|@2|@3|@4|@6)] FREQuency:BURSt [<expected value>[,<resolution>],][(@1|@2|@3 )] FREQuency:POWer (@3) FREQuency:PRF [<expected value>[,<resolution>],][(@1|@2|@3)] FREQuency:RATio [<expected value>[,<resolution>],][(@1|@2|@3),(@1|@2|@3)] NCYCles (@1|@2|@3) PDUTycycle|DCYCle [<reference>],[(@1|@2)] NDUTycycle PERiod PERiod:AVERage PHASe [<expected value>[,<resolution>],][(@1|@2),(@1|@2)] PSLEwrate (@1|@2) NSLEwrate (@1|@2) RISE:TIME|RTIM [<lo threshold>[,<hi threshold>[,<expected value[,<resolution>] FALL:TIME|FTIM [<lo threshold>[,<hi threshold>[,<expected value[,<resolution> PWIDth NWIDth TINTerval TSTAmp (@1|@2) [VOLTage:]MAXimum (@1|@2) [VOLTage:]MINimum (@1|@2) [VOLTage:]PTPeak (@1|@2) [VOLTage:]RATIO (@1|@2),(@1|@2)

[<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2|@3)] [<expected value>[,<resolution>],][(@1|@2|@3)]

[<reference>],[(@1|@2)] [<reference>],[(@1|@2)] [<expected value>[,<resolution>],][(@1|@2),(@1|@2)]

]],][(@1|@2)]

]]],][(@1|@2)]

2-80 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

MEASure:ARRay

Returns

Examples

<data> Where the format of the returned data is determined by the format commands FORMat.

MEASURE:FREQUENCY? (@3) might return 1.78112526833E+009

MEASure:MEMory? (Query Only)

Same as MEASure:MEMory<N>? ommand but somewhat slower. Allows use of all memories from 1 through 19.

Group

Syntax

Measurement

MEASure:MEMory? <N>

:<MeasuringFunction>?

Examples

MEASURE:MEMORY? 13 recalls the instrument setting in memory number 13, takes

a measurement, and fetches the result.

MEASure:MEMory<N>? (Query Only)

Use this command when you want to measure several parameters fast.

MEAS:MEM1? recalls the contents of memory one and reads out the result, MEAS:MEM2? recalls the contents of memory two and reads out the result, andsoforth.

The equivalent command sequence is *RCL 1; READ?.

The allowed range for <N> is 1 to 9. Use the somewhat slower

MEASure:MEMory? commandifyouusememories10to19.

Group

Syntax

Measurement

MEASure:MEMory<N>?

Returns

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-81

Command Descriptions

MEASure:NDUT

Arguments

Examples

ycycle? (Query Only)

Traditional negative duty cycle measurement is performed. That is, the ratio between the on time and the off time of the input pulse is measured.

Group

Syntax

Measurement

MEASure:NDUTycycle?[ [<threshold>] [,(@{1|2})]]

<THRESHOLD> parameter sets the trigger levels in volts. If omitted, the auto

trigger level is set to 50 percent of the signal.

(@{1|2}) is the measurement channel: (@1) means input A, (@2) means input

If you omit the channel, the instrument measures on input A (@1).

MEASURE:NDUTYCYCLE? might return +5.097555E-001. In this example, the

duty cycle is 50.97%.

MEASure:NWIDth? (Query Only)

A negative pulse width measurement is performed.

This is always a single measurement. If you need an average pulse width measurement, use the SENSe subsystem instead.

Group

Syntax

Arguments

Measurement

MEASure:NWIDth?[ [<threshold>] [,<(@{1|2})>] ]

<THRESHOLD> parameter sets the trigger levels in volts. If omitted, the auto

trigger level is set to 50 percent of the signal.

<(@{1|2})> is the measurement channel:

(@1) means input A

(@2) means input B.

If you omit the channel, the instrument measures on input A.

2-82 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Command Descriptions

MEASure{:PDU

Arguments

Examples

Tycycle|:DCYCle}? (Query Only)

Traditional positive duty cycle measurement is performed. That is, the ratio between the on time and the off time of the input pulse is measured.

Group

Syntax

Measurement

MEASure{:PDUTycycle|:DCYCle}?[ [<threshold>] [,(@{1|2})]]

<THRESHOLD> parameter sets the trigger levels in volts. If omitted, the auto

trigger level is set to 50 percent of the signal.

(@{1|2}) is the measurement channel: (@1) means input A, (@2) means input

If you omit the channel, the instrument measures on input

MEASURE:PDUTYCYCLE? might return +5.097555E-001. In this example, the

duty cycle is 50.97%

A (@1) .

MEASure:PERiod? (Query Only)

A period time measurement is taken on a single period. Measuring time set by the

ACQuisition:APERture command does not affect the measurement.

The <expected value> and <resolution> are used to calculate the Measurement Time (ACQuisition:APERture).

Group

Syntax

Arguments

Measurement

MEASure:PERiod?[ [<expected value> [,<resolution>]][,<(@{1|2|3})>]]

<EXPECTED VALUE> is the expected Period,

<RESOLUTION> is the required resolution,

<(@{1|2|3})> is the measureme nt channel:

(@1) means input A

(@2) means input B

(@3) means input C (RF input option).

FCA3000, FCA3100, MCA3000 Series Programmer Manual 2-83

Command Descriptions

If you omit the c

hannel, the instrument measures on input A (@1).

MEASure:PERiod:AVERage? (Query Only)

A traditional period time measurement is performed on multiple periods. Measuring time set by the ACQuisition:APERture command determines the resolution.

The <expected value> and <resolution> are used to calculate the Measurement Time (ACQuisition:APERture).

Group

Syntax

Arguments

Measurement

MEASure:PERiod:AVERage?[ [<expected value> [,<resolution>]][,<(@{1|2|3})>]]

<EXPECTED VALUE> is the expected Period,

<RESOLUTION> is the required resolution,

<(@{1|2|3})> is the measurement channel:

(@1) means input A

(@2) means input B

(@3) means input C (RF input option).

If you omit the channel, the instrument measures on input A (@1).

MEASure:PHASe? (Query Only)

A traditional PHASe measurement is performed.

Group

Syntax

Arguments

Measurement

MEASure:PHASe?[ [<expected value>[,<resolution>]] [,(@{1|2}),(@{1|2})]]

<EXPECTED VALUE> and <RESOLUTION> are ignored by the instrument.

The ﬁrst channel,

(@{1|2}) is the start channel and the second (@{1|2}) is the stop (@1) means input A, (@2) means input B.

If you omit the channel, the instrument measures between input A and input B.

2-84 FCA3000, FCA3100, MCA3000 Series Programmer Manual

Tektronix FCA3000, FCA3003, FCA3103, FCA3120, MCA3027 Programmer's Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Table of Contents

Preface

Getting Started

Setting Up the Instrument

Interface Functions

Using the USB Interface

Syntax and Commands

Command Syntax

Command and Query Structure

Clearing the Instrument

Command Entry

Argument Types

Macros

Command Groups

Arming Subsystem

Calculate Subsystem

Calibration Subsystem

Display Subsystem

Fetch Function

Hard Copy

Input Subsystem

Memory Subsystem

Read Function

Sense Command Subsystem

Status Subsystem

System Subsystem

Trigger Subsystem

Command Descriptions

ABORt (No Query Form)

ACQuisition:APERture

ACQuisition:HOFF

ACQuisition:HOFF:TIME

ARM:COUNt

ARM:DELay

ARM:LAYer2 (No Query Form)

ARM:SLOPe

ARM:SOURce

ARM:STOP:SLOPe

ARM:STOP:SOURce

ARM:STOP:TIMer

CALCulate:AVERage:ALL? (Query Only)

CALCulate:AVERage:COUNt

CALCulate:AVERage:STATe

CALCulate:DATA? (Query Only)

CALCulate:IMMediate

CALCulate:LIMit:CLEar (No Query Form)

CALCulate:LIMit:FAIL? (Query Only)

CALCulate:LIMit:FCOunt? (Query Only)

The c ommand returns the total number of times the set lower and upper limits have been passed since the instrument was last reset by CALCulate:LIMit:CLEar or automatically by INITiate if CALCulate:LIMit:CLEar:AUTO is set to ON.

CALCulate:LIMit:FCOunt:LOWer? (Query Only)

CALCulate:LIMit:FCOunt:UPPer? (Query Only)

CALCulate:LIMit:LOWer:STATe

CALCulate:LIMit:PCOunt?

CALCulate:LIMit:UPPer

CALCulate:LIMit:UPPer:STATe

CALCulate:MATH

CALCulate:MATH:STATe

CALCULATE:STATE

CALCulate:TOTalize:TYPE

CALibration:INTerpolator:AUTO

*CLS (No Query Form)

CONFigure:<MeasuringFunction>

CONFigure:TOTalize[:CONTinuous]

*DDT

DISPlay:ENABle

*DMC

*EMC

*ESE (No Query Form)

*ESR?

FETCh:ARRay? (Query Only)

FETCh[:SCALar]? (Query Only)

FORMat

FORMat:BORDer

FORMat:SMAX

FORMat:TINFormation

FREQuency:BURSt:APERture