XT2640 Operating Manual
13 July 2016
Page 152 of 187
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELD
DATA
RANGE
DESCRIPTION
TEMPSAVECFG
‐
‐
‐
Saves the present complete configuration of the XT2640 into an internal
temporary storage.
TEMPLOADCFG
‐
‐
‐
Reloads the previously saved configuration from a TEMPSAVECFG command. If
there was no previous TEMPSAVECFG command then this command raises an
error. This command can only be used once for each TEMPSAVECFG command.
24.4.12
HARMONICS
LIMITS
CONFIGURATION
AND
CONFIGURATION
QUERY
COMMANDS
Any changes made to harmonics limits take an immediate effect but are volatile until the SAVEHLIMITS command is used (i.e. will
not be retained when power is turned off).
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELD
DATA
RANGE
DESCRIPTION
CLRHLIMITS
i
KEYWORD
V or A
Removes all voltage (
i
=V) or current (
i
=A) harmonic limits
HLIMIT
i
KEYWORD
V or A
Sets voltage (
i
=V) or current (
i
=A) limit for harmonic
h
according to the
remaining fields as follows –
t
sets the type of limit (if any) to apply ‐
t
=0: no limit applied (further fields are optional and are ignored if present)
t
=1: the limit is the highest of the percentage and level limits
t
=2: the limit is the addition of the percentage and level limits
p
sets whether the percentage limit is a percentage of the fundamental
(
p
=0) or of the total signal (
p
=1)
plimit
and
llimit
are the percentage and level limits respectively
Note : setting a limit with both
plimit
and
llimit
=0.0 will never pass
h
NR1
1 to 500
t
NR1
0 to 2
p
NR1
0 or 1
plimit
NR3
≥0.0
llimit
NR3
≥0.0
HLIMIT?
i
KEYWORD
V or A
Responds with the HLIMIT command STRING needed to reproduce the
voltage (
i
=V) or current (
i
=A) limit for harmonic
h
h
NR1
1 to 500
SAVEHLIMITS
i
KEYWORD
V or A
Saves all voltage (
i
=V) or current (
i
=A) harmonic limits
24.4.13
DC
ZERO
CONTROL
AND
QUERY
COMMANDS
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELD
DATA
RANGE
DESCRIPTION
DCZERO
‐
‐
‐
Initiates an INT DC ZERO activity on all configured channels (same as the SYS
CONFIG ‐> INT DC ZERO button)
Sets DCZ register as needed and clears DCZERR register
Suspends normal measurement actions of the XT2640 until ENDDCZERO is received
DCZ?
‐
‐
‐
Responds with the NR1 DCZ register
b0 through 3: set if CH 1 through 4 resp. are performing an INT DC Zero activity
Each bit clears when the activity is successfully completed or ENDDCZERO
commanded
DCZERR?
‐
‐
‐
Responds with the NR1 DCZERR register
b0 through 3: set if CH 1 through 4 resp. have found an error during an INT DC Zero
activity
ENDDCZERO
‐
‐
‐
Terminates an INT DC ZERO activity on all channels (aborts if still in progress)
Clears DCZ and DCZERR registers
Returns to normal measurement actions of the XT2640
EXTDCZERO
o
NR1
0 or 1
Performs an external DC Zero. If
o
is 0 then all channels have their DC zeroes
adjusted to the present DC measurements, otherwise if
o
is 1 then only those
channels which are scaled have their DC zeroes adjusted to the present DC
measurements.
24.4.14
CUSTOM
SCREEN
CONFIGURATION
AND
CONFIGURATION
QUERY
COMMANDS
The actual custom screen is not updated with the results of any changes until the SAVECUSTOM command is actioned. The use of the
CLRCUSTOM command is recommended prior to starting to generate a custom screen via the interface to ensure that no existing
contents of a custom screen are included in a newly generated screen. Following a SAVECUSTOM command no further custom
screen commands can be executed for up to 300ms and attempting to do so raises an error.
Note that the CUSTOM command must either be the only command or the last command in a set of commands (i.e. it must be
terminated by a command terminator character).
A custom screen is composed of 57 cells arranged in 15 rows with row 0 (the topmost row) only having a single column and rows 1
through 14 having 4 columns (the leftmost column is 0). For cells other than the row 0 cell, for text sizes other than 12pix or 16pix
then the target cell is expanded to include surrounding cells as follows –
22pix text size: includes the cell to the right of the target cell.
28pix and 36pix text sizes: includes the cell to the right of the target cell and also the cells immediately below both the
target cell and that to the right of it.
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELD
DATA
RANGE
DESCRIPTION
CLRCUSTOM
‐
‐
‐
Sets the custom screen totally blank
CUSTOM
r
NR1
0 to 14
Set custom screen cell row (
r
), column (
c
) according to the remaining fields ‐
c
NR1
0 to 3