содержание .. 25 26 27 28 ..

FTB-2 и FTB-2 Pro. Руководство пользователя - часть 27

IEEE 488.2 and Specific Command Reference

Specific Commands

:FORMat[:DATA]?

Description

The FORMat[:DATA]? query returns the data

format and the <Length>.

At *RST, ASCii is selected as the default data

format and the <Length> is set to 0.

Syntax

:FORMat[:DATA]?

Parameter(s)

None

Response Syntax

Response(s)

 Type:

The response data syntax for <Type> is defined

as a <CHARACTER RESPONSE DATA> element.

The ASCII <Type> is returned when numeric

data is transferred to ASCII bytes in <NR1

NUMERIC RESPONSE DATA>, <NR2 NUMERIC

RESPONSE DATA> or <NR3 NUMERIC

RESPONSE DATA> representation, as

appropriate.

The PACKED <Type> is returned when data is

transferred to a <DEFINITE BLOCK RESPONSE

DATA>, as specified in the device

documentation.

 Length:

The response data syntax for <Length> is

defined as a <NR1 NUMERIC RESPONSE DATA>

element.

FTB-2 and FTB-2 Pro

407

IEEE 488.2 and Specific Command Reference

Specific Commands

:FORMat[:DATA]?

When the data is returned in ASCII, the

<Length> is the number of significant digits to

be returned. A <Length> value of zero indicates

that the device selects the number of significant

digits to be returned.

When the data is returned in PACKED <Type>,

the <Length> is not used and always returns 0.

Example(s)

FORM? returns ASCII,6

FORM? returns PACKED,0

See Also

FORMat[:DATA]?

408

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:INSTrument:CATalog?

Description

The INSTrument:CATalog? query returns a

comma-separated list of <STRING RESPONSE

DATA>, which contains the names of all logical

instruments and groups. If no logical instruments

are defined, a single null <STRING RESPONSE

DATA> is returned.

This is not affected by a *RST command.

Syntax

:INSTrument:CATalog?

Parameter(s)

None

Response Syntax

Response(s)

Catalog:

The response data syntax for <Catalog> is

defined as a <STRING RESPONSE DATA>

element.

The list of <STRING PROGRAM DATA> contains

the names of all logical instruments and groups.

Example(s)

INST:CAT? returns “FTB-5240BP Optical

Spectrum Analyzer

(1250nm-1650nm)”,”FTB-5240S Optical

Spectrum Analyzer (1250nm-1650nm)”

See Also

INSTrument:CATalog:FULL?

FTB-2 and FTB-2 Pro

409

IEEE 488.2 and Specific Command Reference

Specific Commands

:INSTrument:CATalog:FULL?

Description

The INSTrument:CATalog:FULL? returns a list of

<STRING RESPONSE DATA> - <NR1 NUMERIC

RESPONSE DATA> pairs. The <STRING

RESPONSE DATA> contains the name of the

logical instrument. The immediately following

<NR1 NUMERIC RESPONSE DATA> formatted

number is its associated logical instrument

number. All response data elements are

separated by commas. If no logical instrument is

defined, a null <STRING RESPONSE DATA>

value followed by a zero is returned.

This is not affected by a *RST command.

Syntax

:INSTrument:CATalog:FULL?

Parameter(s)

None

Response Syntax

Response(s)

Catalog:

The response data syntax for <Catalog> is

defined as a <STRING RESPONSE DATA>

element.

The list of <STRING RESPONSE DATA> contains

the names of all logical instruments and groups.

The immediately following <NR1 NUMERIC

RESPONSE DATA> formatted number is its

associated logical instrument number.

Example(s)

INST:CAT:FULL? returns

“FTB-5240BP Optical Spectrum Analyzer

(1250nm-1650nm)”,1,”FTB-5240S Optical

Spectrum Analyzer (1250nm-1650nm)”,2

See Also

INSTrument:CATalog?.

410

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:DATE

Description

The SYSTem:DATE command is used to set the

device's internal calendar.

This is not affected by a *RST command.

Syntax

:SYSTem:DATE<wsp><Year>,<Month>,<Day

Parameter(s)

 Year:

The program data syntax for <Year> is defined

as a <DECIMAL NUMERIC PROGRAM DATA>

element.

The <Year> is rounded to the nearest integer. Its

range is limited by the capability of the device.

The year shall be entered as a four-digit number,

including century and millennium information.

 Month:

The program data syntax for <Month> is defined

as a <DECIMAL NUMERIC PROGRAM DATA>

element.

The <Month> is rounded to the nearest integer.

Its range is 1 to 12 inclusive. The number 1

corresponds to January, 2 to February, and so on.

FTB-2 and FTB-2 Pro

411

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:DATE

 Day:

The program data syntax for <Day> is defined as

a <DECIMAL NUMERIC PROGRAM DATA>

element.

The <Day> is rounded to the nearest integer. It

ranges from 1 to the number of days in the

month from the previous parameter. This

command keeps track of the number of days in

each month, accounting for leap years through

the range of years that it accepts.

Example(s)

SYST:DATE 2014,07,29

See Also

SYSTem:DATE?

412

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:DATE?

Description

The SYSTem:DATE query returns the instrument's

internal calendar.

This is not affected by a *RST command.

Syntax

:SYSTem:DATE?

Parameter(s)

None

Response Syntax

FTB-2 and FTB-2 Pro

413

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:DATE?

Response(s)

 Year:

The response data syntax for <Year> is defined

as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Year> is a four-digit number, including

century and millennium information.

 Month:

The response data syntax for <Month> is

defined as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Month> ranges from 1 to 12, inclusively.

The number 1 corresponds to January, 2 to

February, and so on.

 Day:

The response data syntax for <Day> is defined

as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Day> ranges from 1 to the number of days

in the month from the previous field. This

command keeps track of the number of days in

each month, accounting for leap years through

the range of years that it accepts.

Example(s)

SYST:DATE? returns 2017,07,29

See Also

SYSTem:DATE

414

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:ERRor[:NEXT]?

Description

The SYSTem:ERRor[:NEXT]? queries the

error/event queue for the next item and removes

it from the queue. The response message

consists of two fields separated by commas

<Code>,<Description[,Info]>.

SYSTem:ERRor[:NEXT]? is a query only and,

therefore, does not have an associated *RST

state.

Syntax

:SYSTem:ERRor[:NEXT]?

Parameter(s)

None

Response Syntax

Response(s)

 Code:

The response data syntax for <Code> is defined

as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Code> is a unique integer in the range

[-32768, 32767]. All positive numbers are

instrument-dependent. All negative numbers are

reserved by the SCPI standard with certain

standard error/event codes described in an

appendix of this document. The zero value is

also used to indicate that no error or event has

occurred.

 Description[,Info]:

The response data syntax for

<Description[,Info]> is defined as a <STRING

RESPONSE DATA> element.

FTB-2 and FTB-2 Pro

415

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:ERRor[:NEXT]?

The <Description[,Info]> parameter of the full

response is a quoted string containing a

description followed by information text [,Info].

Each <Code> has a unique and fixed

<Description> associated with it. The <Date>

and <Time> are appended to the [,info]

separated by a semi-colon using the following

format:

<Date><wsp><Time> where

<Date> = Year/Month/Day

<Time> = Hour,Minute,Second (24 hour time)

The maximum length of <Description[,Info]> is

255 characters. For standard defined error/event

<Codes>, the <Description> is sent exactly as

indicated in the appendix of this document.

Example(s)

SYST:ERR:NEXT? returns -222,”Data out of range”

SYST:ERR:NEXT? returns -222,”Data out of

range,instrument monomodule 5240S,

2014/07/29 14:56:16.259”

416

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:TIME

Description

This device has an internal clock and

implements the SYSTem:TIME command to set

the clock time over the interface.

This is not affected by a *RST command.

Syntax

:SYSTem:TIME<wsp><Hour>,<Minute>,<Sec

onds>

Parameter(s)

 Hour:

The program data syntax for <Hour> is defined

as a <DECIMAL NUMERIC PROGRAM DATA>

element.

The <Hour> is always rounded to the nearest

integer. It ranges from 0 to 23 inclusively. The

device accepts hour information in 24-hour

format.

 Minute:

The program data syntax for <Minute> is

defined as a <DECIMAL NUMERIC PROGRAM

DATA> element.

The <Minute> is always rounded to the nearest

integer. It ranges from 0 to 59 inclusively.

FTB-2 and FTB-2 Pro

417

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:TIME

 Seconds:

The program data syntax for <Seconds> is

defined as a <DECIMAL NUMERIC PROGRAM

DATA> element.

The <Second> is rounded to the resolution of

the clock. It ranges from 0 to 60. A value of 60 is

allowed since rounding may cause a number

greater than 59.5 to be rounded to 60. When this

element is rounded to 60 it shall be set to 0 and

the minute value incremented. Any other carries

shall be rippled through the date.

Example(s)

SYST:TIME 12,47,29

See Also

SYSTem:TIME?

418

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:TIME?

Description

This device has an internal clock and

implements the SYSTem:DATE? query to get the

clock time over the interface.

This is not affected by a *RST command.

Syntax

:SYSTem:TIME?

Parameter(s)

None

Response Syntax

FTB-2 and FTB-2 Pro

419

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:TIME?

Response(s)

 Hour:

The response data syntax for <Hour> is defined

as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Hour> ranges from 0 to 23. The

instruments returns hour information in 24-hour

format.

 Minute:

The response data syntax for <Minute> is

defined as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Minute> ranges from 0 to 59.

 Second:

The response data syntax for <Second> is

defined as a <NR1 NUMERIC RESPONSE DATA>

element.

The <Second> ranges from 0 to 59. The

resolution of the clock is the second.

Example(s)

SYST:TIME? returns 16,55,38

See Also

SYSTem:TIME

420

FTB-2 and FTB-2 Pro

IEEE 488.2 and Specific Command Reference

Specific Commands

:SYSTem:VERSion?

Description

The SYSTem:VERSion? query returns a value

corresponding to the SCPI version number to

which the device complies.

The SYSTem:VERSion? is a query only and,

therefore, does not have an associated *RST

state.

Syntax

:SYSTem:VERSion?

Parameter(s)

None

Response Syntax

Response(s)

Version:

The response data syntax for <Version> is

defined as a <NR2 NUMERIC RESPONSE DATA>

element.

The <Version> is shown in the form

Year.Revision, where Year represents the

year-version (that is 1990) and Revision

represents an approved revision number for that

year. If no approved revisions are claimed, then

this extension is 0.

Example(s)

SYSTem:VERSion? returns 1999.0 (no approved

revisions are claimed)

FTB-2 and FTB-2 Pro

421

содержание .. 25 26 27 28 ..