Common Commands

*IDN?

Syntax

*IDN?

Description

Query the ID string of the instrument

Parameter

None

Explanation

The query returns a colon-separated four-field ASCII string. The first field contains the manufacturer name, the second field is the product name, the third field is the device serial number, and the fourth field is the product revision number

Return Format

<Arbitrary ASCII String>

Example

-> *IDN?
<- DEWETRON,OXYGEN,0,2.5.0

*VER?

Syntax

*VER?

Description

Query the software and SCPI interface version string

Parameter

None

Explanation

The query returns the version information for the relevant parts. The SCPI version, the RC_SCPI plugin version and the OXYGEN version is mandatory and always reported

Return Format

<Character>,<String>[,<Character>,<String>]…

Example

-> *VER?
<- SCPI,"1999.0",RC_SCPI,"1.10",OXYGEN,"5.1.1"

*CLS

Syntax

*CLS

Description

Clears the standard event register, extended event register, and error queue

Parameter

None

Explanation

If the *CLS command is located immediately after the program message terminator, the output queue is also cleared

Example

-> *CLS

*ESE

Syntax

*ESE <num>

Description

Sets the standard event status enable register

Parameter

Name

Type

Range

Default

<num>

Integer

0 - 255

0

Explanation

  • Specify the value as a sum of decimal values of each bit

  • For example, specifying “*ESE 251” will cause the standard enable register to be set to “11111011”. In this case, bit 2 of the standard event register is disabled which means that bit 5 (ESB) of the status byte register is not set to 1, even if a “query error” occurs

  • A query using *ESE? will not clear the contents of the standard event enable register

Example

-> *ESE 251
-> *ESE?
<- 251

*ESE?

Syntax

*ESE?

Description

Queries the current setting of the standard event status enable register

Parameter

None

Explanation

The query returns the content of the standard event status enable register

Return Format

<NR1>

Example

-> *ESE 251
-> *ESE?
<- 251

*ESR?

Syntax

*ESR?

Description

Queries the standard event status register and clears the register

Parameter

None

Explanation

  • A sum of decimal values of each bit is returned

  • You can check what type of events occurred when an SRQ is generated

  • For example, if a value of “32” is returned, this indicates that the standard event register is set to “00100000.” In this case, you can see that the SRQ occurred due to a “command syntax error.”

  • A query using *ESR? will clear the contents of the standard event register

Return Format

<NR1>

Example

-> *ESR?
<- 32

*OPC

Syntax

*OPC

Description

Sets bit 0 (OPC bit) of the standard event register to 1 upon the completion of the specified overlap command

Parameter

None

Explanation

Currently all operations are non-overlapped.*OPC sets the OPC bit and *OPC? returns the state of the OPC bit

Example

-> *OPC
-> *OPC?
<- 1

*OPC?

Syntax

*OPC?

Description

Queries the state of specified overlapped command

Parameter

None

Explanation

Currently all operations are non-overlapped.*OPC sets the OPC bit

Return Format

<Boolean>

Example

-> *OPC
-> *OPC?
<- 1

*RST

Syntax

*RST

Description

Initializes the device to default settings

Parameter

None

Explanation

  • Stops the recording

  • Restarts the acquisition

  • Clears the event queue

  • Resets all settings except communication settings to factory default values

Example

-> *RST

*SRE

Syntax

*SRE <num>

Description

Sets the service request enable register

Parameter

Name

Type

Range

Default

<num>

Integer

0 - 255

0

Explanation

  • Specify the value as a sum of decimal values of each bit

  • For example, specifying “SRE 239” will cause the *service request enable register to be set to “11101111.” In this case, bit 4 of the service request enable register is disabled which means that bit 4 (MAV) of the status byte register is not set to 1, even if “the output queue is not empty”.

  • Bit 6 (MSS) of the status byte register is the MSS bit itself, and therefore, is ignored

  • A query using *SRE? will not clear the contents of the service request enable register

Example

-> *SRE 239
-> *SRE?
<- 175

*SRE?

Syntax

*SRE?

Description

Queries the current setting of the service request enable register

Parameter

None

Explanation

The query returns the content of the service request enable register

Return Format

<NR1>

Example

-> *SRE 239
-> *SRE?
<- 175

*STB?

Syntax

*STB?

Description

Queries the status byte register

Parameter

None

Explanation

The query returns the content of the status byte register.
  • Bits 0, 1, 3, 4 and 7 Not used (always 0)

  • Bit 2 EAV (Error Available)

    Set to 1 when the error queue is not empty. In other words, this bit is set to 1 when an error occurs. See the page 7-9.

  • Bit 5 ESB (Event Summary Bit)

    Set to 0 when the logical product of the standard event register and the corresponding enable register is 1. In other words, this bit is set to 1, when an event takes place inside the instrument.

  • Bit 6 RQS (Request Service)/MSS (Master Status Summary)

    Set to 1 when the logical AND of the status byte excluding Bit 6 and the service request enable register is not 0. In other words, this bit is set to 1 when the instrument is requesting service from the controller.

    RQS is set to 1 when the MSS bit changes from 0 to 1, and cleared when serial polling is carried out or when the MSS bit changes to 0.

Return Format

<NR1>

Example

-> *STB?
<- 4

*TST?

Syntax

*TST?

Description

Performs a self-test and queries the result

Parameter

None

Explanation

Currently a self-test is not defined and this query is no-op.

Return Format

<NR1>

Example

-> *TST?
<- 0

*WAI

Syntax

*WAI

Description

Holds the subsequent command until the completion of the asynchronous operation

Parameter

None

Explanation

Currently all operations are synchronous operations

Example

-> *WAI