XITRON XT2640 - Harmonics Limits Configuration and Configuration Query Commands; DC Zero Control and Query Commands; Custom Screen Configuration and Configuration Query Commands

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