Chapter 2 Commands

 

2.2 Detailed Explanation of the Commands

 

2.2.1 Explanation

 

The following sections describe the format and functions of individual commands.

The following is an example of how the descriptions are organized.

 

 

Changes and queries the function selection.

Common

(1)

 

Syntax

 

command

 

:FUNCtion A$

(2)

 

query

:FUNCtion?

 

response

A$

 

Explanation

 

A$ = MEM : memory recorder function

         REC : recorder function

RMS : RMS recorder function

 

Switches to the function designated by A$.

Returns the name of the current function as character data.

 

(3)

 

Example

 

 

 

FFUNCtion MEM

The function is set to the memory recorder function.

 

(4)

 

When allowed

 

 

In MEM, REC and RMS

 

(5)

 

(1)Command function

            Common: Common command that can be used for all the models

            8835: Command that can be used for the 8835

            8835-01: Command that can be used for the 8835-01

            8826: Command that can be used for the 8826

            8841: Command that can be used for the 8841

            8842: Command that can be used for the 8842

            8720: Command that can be used for the 8720

 

(2)Command syntax

         command gives the syntax of a command program message, query the syntax of a query program message, and response the format of the response message.

 

         The parameters, referred to as data, are shown as follows:

         A, B, C,... Numerical data (e.g. 1.5, 10E-3)

         A$, B$,... Character data (e.g. A, B1, GND, OFF)

         "A", "A$",... Character string data (e.g. "1.5", "mA")

          (Single quotation marks (f) can be used instead of double quotation marks (").)

 

         The format of numerical data follows the formats <NR1>, <NR2>, and <NR3>.

          [Example]

          A <NR1> Numerical parameter in NR1 format

          B <NR2> Numerical parameter in NR2 format

          C <NR3> Numerical parameter in NR3 format

          [NOTE]

          If no format is mentioned, <NR1> format is accepted.

          [NR format]

          NR1 format integer data

          NR2 format fixed point numbers

          NR3 format floating point numbers

          The term "NRf format" includes all these three formats.

 

               When the unit is receiving a command or query program message, it accepts format, but when it is sending it utilizes whichever one of the formats <NR1> to <NR3> is indicated in the particular command.

               Response messages may or may not have headers prefixed.

 

(3)Explanation of the command function.

 

(4)Example of command use.

 

(5)This lists the functions in which the command may be used.

          MEM: memory recorder function

          REC: recorder function

          RMS: RMS recorder function

 

Execution of commands

    Commands are input into the input buffer and are executed in order.

    However the :ABORT command is executed immediately, even if commands are waiting in the input buffer - more precisely, at the instant its terminator is received.

    Commands other than those which can be handled by the unit in its current state are not executed but generate execution errors. This happens, for example, when in memory recorder function it is attempted to execute a recorder mode setting.

    Further, almost all commands cannot be executed during measurement operation.

 

8841 and 8842

    Commands related to FFT, and recorder and memory functions are supported from Version 2.00.

 

Regarding the command for specifying the channel number

    Unless specifically mentioned, the ch$ character string specifying the channels becomes as follows.

          ch$ = CH1 to CH4 (8835)

                    CH1 to CH8 (8835-01)

                    CH1 to CH16 (8841, 8842, 8720)

                    CH1 to CH32 (8826)

 

 

(1) Standard Commands Specified by IEEE 488.2

 

(1) Queries device ID.

Common

 

Syntax

 

query

 

*IDN?

response

HIOKI,8835,0,V1.00

 

(1)        ,(2)  (3), (4)

 

 

Explanation

 

 

(1): First field Manufacturerfs name

(2): Second field Model name

(3): Third field Serial number (not used: 0)

(4): Fourth field Software version

 

 

(2) Queries device option provision.

Common

 

Syntax

 

query

 

*OPT?

response

ch1,ch2, ... ch4<NR1>   (8835)

ch1,ch2, ... ch8<NR1>   (8835-01)

ch1,ch2, ... ch32<NR1> (8826)

ch1,ch2, ... ch16<NR1> (8841, 8842, 8720)

 

0: not present

1: analog unit

2: voltage/temperature unit

3: strain unit

4: FFT unit

5: F/V unit

6: charge unit

7: 4-channel unit

 

Explanation

 

 

Whether or not input unit present is returned as an NR1 numerical value.

 

 

(3) Device initial setting.

Common

 

Syntax

 

 

command

 

 

*RST

 

 

Explanation

 

 

Initializes the unit (same as system reset).

 

 

Note

 

 

It does not clear GP-IB and RS-232C related items.

(the event registers, the enable registers, the input buffer and the output queue)

 

 

(4) Queries the result of the ROM/RAM check.

Common

 

Syntax

 

 

query

 

*TST?

response

A<NR1>

A = 0, 1

0: normal

1: failure

 

 

Explanation

 

 

The result of the ROM/RAM check of the unit is returned as an NR1 numerical value.

 

 

Note

 

 

If the unit communicates with LAN, it can not receive the response.

 

 

(5) After all action has been completed during execution, sets the LSB (bit 0) of SESR (the standard event status register).

Common

 

Syntax

 

 

command

 

 

*OPC

 

 

Explanation

 

 

When the command preceding the *OPC command completes execution, the LSB of SESR is set.

 

 

Example

 

 

A$;B$;*OPC;C$;

After the execution of the commands A$ and B$ is completed, the LSB of SESR is set.

 

 

(6) After execution is completed, replies with ASCII [1].

Common

 

Syntax

 

 

query

 

*OPC?

response

 

1

 

 

Explanation

 

 

When the command preceding the *OPC command completes execution, the response of ASCII [1] is made.

 

(7) After the execution of the command is completed, subsequently performs the following command.

Common

 

Syntax

 

 

command

 

 

*WAI

 

 

Explanation

 

 

After the execution of the command is completed, subsequently performs the following command.

 

 

Example

 

 

A$ B$G*WAIGC$

The command C$ following *WAI is not executed until the execution of the commands A$ and B$ is completed.

 

 

(8) Clears the status byte and associated queues (except for the output queue).

Common

 

Syntax

 

 

command

 

 

*CLS

 

 

Explanation

 

 

This instruction clears the event register associated with each bit of the status byte register. It also clears the status byte register.

 

 

Note

 

 

Because it does not clear the output queue, it has no effect upon bit 4 (MAV) of the status byte.

 

 

(9) Writes the standard event status enable register (SESER). (GP-IB only)

Common

 

Syntax

 

 

 

command

 

 

 

*ESE A

A = 0 to 255

 

 

Explanation

 

 

Sets the mask pattern of SESER to a value in the range 0 to 255.

Outside this range, an execution error occurs. (The initial value (when the power is turned on) is 0.)

 

 

Example

 

 

*ESE 36

Bit 5 and bit 2 of SESER are set.

 

 

(10) Reads the standard event status register (SESER). (GP-IB only)

Common

 

Syntax

 

 

query

 

*ESE?

response

A<NR1>

A = 0 to 255

 

Explanation

 

 

The contents of SESER as set by the *ESE command are returned as an integral value in the range 0 to 255.

 

 

(11) Reads out and clears the contents of the standard event status register (SESR).

Common

 

Syntax

 

 

query

 

*ESR?

response

A<NR1>

A = 0 to 255

 

 

Explanation

 

 

The contents of SESR are returned as an NR1 numerical value.

 

 

(12) Writes the service request enable register (SRER). (GP-IB only)

Common

 

Syntax

 

 

command

 

 

*SRE A

A = 0 to 255

 

 

Explanation

 

 

Sets the mark pattern of SRER to a value in the range 0 to 255.

Outside this range, an execution error occurs. However, the value of bit 6 is disregarded.

 

 

Example

 

 

*SRE 33

Bits 5 and 0 of SRER are set.

 

 

(13) Reads the service request enable register (SRER). (GP-IB only)

Common

 

Syntax

 

 

query

 

*SRE?

response

A<NR1>

A = 0 to 63, 128 to 191

 

 

Explanation

 

 

The contents of SRER as set by the *SRE command are returned as an NR1 numerical value in the range 0 to 63, 128 to 191.

Bit 6 is always 0.

 

 

(14) Reads the status byte and MSS bit, without performing serial polling.

Common

 

Syntax

 

 

query

 

*STB?

response

A<NR1>

A = 0 to 255

 

 

Explanation

 

 

This is the same as reading out the status byte with serial polling.

 

 

Note

 

 

Bit 6 is not RQS, but is MSS.

 

 

(15) Writes event status enable register 0 (ESER0). (GP-IB only)

Common

 

Syntax

 

 

command

 

:ESE0 A

A = 0 to 255

 

 

Explanation

 

 

Sets the mask pattern of ESER0 to a value in the range of 0 to 255.

Outside this range, an execution error occurs.

The initial value (when the power is turned on) is 0.

 

 

Example

 

 

:ESE0 36

This sets bit 5 and bit 2 of ESER0.

 

 

(16) Reads event status enable register 0 (ESER0).

Common

 

Syntax

 

 

query

 

:ESE0?

response

A<NR1>

A = 0 to 255

 

 

Explanation

 

 

The contents of ESER0 are returned as an NR1 numerical value.

 

 

(17) Reads event status register 0 (ESR0).

Common

 

Syntax

 

 

query

 

:ESR0?

response

A<NR1>

A = 0 to 255

 

 

Explanation

 

 

The contents of ESR0 are returned as an NR1 numerical value, and ESR0 is cleared.