This document was created with operating system version: release-4.9.7.

1. SCPI Standard

The Standard Commands for Programmable Instruments (SCPI) defines syntax and commands to control test and measurement devices. While originally created for IEEE-488 (GPIB), it can also be used with RS232, USB, Ethernet etc.
SCPI is organized as a hierarchical tree of nodes. Root nodes are called instrument models.

Some specifications of SCPI standard are as below:

• The short form of the node name is usually the first four characters of the long form command header. The exception to this is when the long form consists of more than four characters and the fourth character is a vowel. In such cases, the vowel is dropped and the short form becomes the first three characters of the long form.
  Examples: SENSE -> SENS; DEVICE -> DEV;


• The colon (:) is a path hierarchy separator.


• A semicolon (;) indicates end of a command with parameter(s).


• Queries (?) will instruct the instrument to send a response message. Queries return either measured values or internal instrument settings.
  Caution: If you send two query commands without reading the response of the first query, the first response will get lost as the device recognizes an interrupted action. In this case the query error bit in the standard event status register will also be set.


• A comma (,) is used to separate parameters if a command requires more than one parameter.


• Whitespace (space) must be used to separate a parameter from a command keyword.


• Common Commands (*) follow the IEEE-488.2 interface standard. These commands are used to control reset, self-test, and status operations in a device.


• Input Message Terminators: Program messages sent to a SCPI instrument must terminate with a <linefeed> character. The IEEE-488 EOI signal is interpreted as a <linefeed> character.

2. Device connection

The device uses an Ethernet connection and/or an optional serial device for scpi communication.

• For Ethernet connection, the IP address can be found in device's GUI/settings/Network Settings/Info button. The associated port is 6320.
• For Serial connection, the configuration is 9600 baud, 8 data bits, 1 stop bit and no parity.

3. Device information

4. Device interface

This command queries all SCPI commands possible on this device. The output is all SCPI commands in an xml notation.

5. System commands

6. Standard SCPI commands

7. Measurement systems

There are three atomic measurement node-types available:

1. CONFigure: Intended to configure nodes. No functionality implemeneted on Zera devices - available just for compatibility.
2. INITiate: Initializes the measurement.
3. FETCh?: This query returns the requested result. When executed multiple times, it will return same result unless INITiate is called.

There are two composite measurement node-types available:

1. READ: It is a sequence of INITiate and FETCh.
2. MEASure?: It is a sequence of CONFigure, INITiate and FETCh.

In the tables below, MEASure commands are mentioned for illustration. To use other nodes, for example replace MEASure by READ .

Several measurement modules generate actual values.

• To read out dedicated single values, the node must be fully specified within the command. For example, to read out the voltage for channel UL1 the associated command is MEASure:RMS1:UL1? Output format is RMS1:UL1:[V]:value;
• To read out group of values, parent nodes can be specified within the command. For example, MEAS:RMS1? reads out all the RMS values.
• To read out all measurement values from the device, use MEASure? command.

Following sections explain the measuring systems supported by this device. Each measurement section has two tables:

• Configuration: Lists all possible configurations/settings available for that measurement system. These configurations can be read and modified.
• Values: These SCPI-queries provide measured values.

7.1 Phase amplitudes and angles

Each result is a vector, with a real part and an imaginary part. MEAS:DFT1? Reads out vectors for all available channels.

7.2 Power measurement

Each power module provides four values. Values with numbered indices are phase values and value with index ending 'S' is a sum value.
Four power modules are available:

• Power 1 module provides active power. MEAS:POW1? gives all of these values.
• Power 2 module provides reactive power. MEAS:POW2? gives all of these values.
• Power 3 module provides apparent power. MEAS:POW3? gives all of these values.
• Power 4 module provides all kind of powers. MEAS:POW4? gives all of these values. This module is connected to frequency output.

Measuring modes:
The measuring mode selection strings have following meanings -

• 4LW means 4WA (4-wire active power)
• 3LW means 3WA (3-wire active power)
• 2LW means 2WA (2-wire active power)
• 4LB means 4WR (4-wire reactive power)
• 3LB means 3WR (3-wire reactive power)
• 2LB means 2WR (2-wire reactive power)
• 4LS means 4WAP (4-wire apparent power)
• 4LSg means 4WAPG (4-wire apparent power geometric)
• 2LS means 2WAP (2-wire apparent power)
• 2LSg means 2WAPG (2-wire apparent power geometric)

Power 1

Power 2

Power 3

Power 4

7.3 FFT/DC values

FFT represents the Fast Fourier Transform of phase values.
For each phase, a comma separated array of vectors is provided where 1st value is DC and others are harmonics. All vectors are pairs of real part and imaginary part separated by comma.
MEAS:FFT1? Reads out vectors for all available channels.

7.4 RMS values

RMS represents the Root Mean Square of phase values.
SCPI Name RMS1 provides phase RMS values and phase-to-phase RMS values.
MEAS:RMS1? Reads out all RMS values.

7.5 THD measurement

THD represents the Total Harmonic Distortion of phase values.
SCPI names THD1 represents fundamental values and THD2 represents root mean square values. The unit of returned values is %.

THD 1

THD 2

7.6 Transformer measurement

7.7 Burden measurement

BD 11

BD 12

7.8 Lambda values

7.9 Harmonic power values

7.10 Oscilloscope values

7.11 Sampling/PLL configurations

8. Ranges

On this model, the user can:

• Select and read out voltage/current ranges
• Query Catalog: get all ranges for the measurement channel
• Reset overload
• Change configuration: range automatic and range grouping for phase 1 to 3
• Measure: fetch actual peak values and frequency

Note: Values in 'Valid strings' may vary. To get the current, use channel's 'Catalog' queries.

9. Comparison Measurements

Pulse comparison

Meter test

Energy register

Power register

10. EMOB

These are the commands to be used with EMOB suitcases.

• EMOB lock state query: It is recommended to use this query only when measurement is not running.
  

• If there is only one EMOB controller connected to the device, then parameter to EMOB SCPI commands is optional. When no parameter is specified, device will automatically work with the connected EMOB controller.
  

• If there are multiple EMOB controllers connected to the device, then parameter to EMOB SCPI commands is a must. This parameter indicates to which EMOB controller the SCPI command is directed to.