XITRON XT2640 - Measurement Results Query Commands

XT2640OperatingManual 13July2016 Page153of187

COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELDDATA
RANGE
DESCRIPTION
s
ize NR1 0to4
s
ize setsthetextsizeto12pix(
s
ize=0),16pix(
s
ize=1),22pix(
s
ize=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
j
ust 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
s
tart 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.