XT2640 Operating Manual
13 July 2016
Page 153 of 187
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELD
DATA
RANGE
DESCRIPTION
size
NR1
0 to 4
size
sets the text size to 12pix (
size
=0), 16pix (
size
=1), 22pix (
size
=2), 28pix
(
size
=3) or 36pix (
size
=4)
just
sets the horizontal text justification to left (
just
=0), centered (
just
=1) or right
(
just
=2)
colour
sets the text colour (R:G:B values)
def
sets the measurement result to be shown (blank if none required)
units
selects whether to include the measurement results units (
units
=1) or not
(
units
=0)
text
sets the text to include. If
def
is defined then up to the first 5 characters of
text
are included to the left of the measurement result otherwise the cell contains up to
the first 60 characters of
text
; if no characters are to be included in the cell then
the
text
field need not be present
If both
def
and
text
fields are blank (or not included) then only the
r
and
c
fields
are used
just
NR1
0 to 2
colour
COLOR
‐
def
RDEF
‐
units
NR1
0 or 1
text
STRING
Up to 60
characters
CUSTOM?
r
NR1
0 to 14
Responds with the CUSTOM command string to recreate custom screen row
r
and
column
c
c
NR1
0 to 3
SAVECUSTOM
‐
‐
‐
Saves the present custom screen internally and makes any changes active
24.4.15
MEASUREMENT
RESULTS
QUERY
COMMANDS
These commands which have a VDEF field will raise an error if the VDEF field defines a VPA which is not available.
These commands which have a CDEF field will raise an error if the CDEF field defines a channel which is not installed.
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELD
DATA
RANGE
DESCRIPTION
CYCLEVIEW?
c
CDEF
‐
Responds with the 512 data points of cycle view data for channel
c
voltage (
s
=V),
current (
s
=A) or power (
s
=W) waveforms
The data points correspond to phases of the fundamental starting at 0° and then at
successive (360/512)° increments.
Each data point contains two fields as follows –
1
st
field : NR1 indicating if this data point has a valid data (1) or not (0)
2
nd
field : NR3 indicating the level at this data point
Note – the response is a large number of characters (approximately 7K) and is a
total of 1024 fields. Not all data points may be valid, interpolate between valid data
points as appropriate.
s
KEYWORD
V or A or W
HARMLIST?
i
KEYWORD
V or A or W
Responds with one NR3 harmonic amplitude for the voltage input (
i
=V) or current
input (
i
=A) or power (
i
=W) of channel
c
for each harmonic starting with the
start
harmonic up to and including the
end
harmonic (the fundamental is harmonic 1).
c
CDEF
‐
start
NR1
1 to 500
end
NR1
start
to 500
HISTORYDATA?
n
NR1
2 to 1024
Responds with
n
data points of historical data defined by
def
, starting at historical
data collection time
start
and ending at
end
(both in seconds relative to the time at
which historical data collection was last started)
Each data point is four fields as follows –
1
st
field: NR1 indicating if this data point contains data (1) or not (0)
2
nd
field: NR3 indicating the maximum data recorded
3
rd
field: NR3 indicating the average data recorded
4
th
field: NR3 indicating the minimum data recorded
Note – the response can be a very large number of characters (up to 38.9K) and
fields (up to 4096).
start
NR3
≥0.0
end
NR3
>
start
def
DDEF
‐
HISTORYTIME?
‐
‐
‐
Responds with an NR3 indicating the length of time covered by the present
historical data (in seconds)
HLIMITFAIL?
c
CDEF
‐
Responds with a NR1 indicating if harmonic
h
(
h
>0) or all harmonics (
h
=0) for the
voltage (
i
=V) or current (
i
=A) of channel
c
is passing (responds with 0) or failing
(responds with 1)
Note – a harmonic which has no limit or is not being measured is considered as
passing
i
KEYWORD
V or A
h
NR1
0 to 500
LEADING?
srce
KEYWORD
CH1, CH2,
CH3, CH4, A1,
A2, A3, VPA1,
VPA2, or VPA3
Responds with a NR1 indicating if the selected data source (
srce
) has a leading PF
(responds with 1) or lagging PF (responds with 0)
srce
is either‐
A1 to A3: selects VPA1 to 3 as the data source
VPA1 to VPA3: selects VPA1 to 3 as the data source
CH1 to CH4: selects channel 1 to channel 4 as the data source
MAXHARMS?
v
VDEF
‐
Responds with a NR1 indicating the number of harmonics being measured in VPA
v
READ?
≥
1
fields
RDEF
‐
Responds with the requested measurement result(s). You may specify any number
of results to be obtained in a single READ? command as long as the command is
within the allowable maximum number of characters in a command set and the
response generated is less than the maximum number of characters in a response.
REREAD?
‐
‐
‐
Responds with the measurement results defined by the last received READ?
command.
Note – this is typically used when a large number of results are to be repeatedly
requested and a slow interface (e.g. USB or RS232) is being used. Sending the
READ? command once and then repeating by using the REREAD? command
achieves higher throughput because of the reduction in characters required. When
using the LAN interface there is typically very little difference if the REREAD?
command is used vs using the READ? Command.