XITRON XT2640 - Command Keywords and Fields; Interface Clear Commands; Local;Remote State Control Commands; Error Register Query Commands

XT2640OperatingManual 13July2016 Page141of187

6digitcharacterswithanembeddeddecimalpointcharacter,definingthemantissaportionofthenumeric
TheletterEcharacter(uppercase)
Apolaritycharacter,definingthepolarityoftheexponent
Asingledigitcharacterdefiningtheexponent(whichisalwaysamultipleof3)
ThereisaspecialcaseofaNR3responsewhichisusedtoindicatethatthedataisnotavailable.Normallyazerovalueusesa
+0.00000E‐9response;aresponseof+0.00000E+0indicatesthatthevalueisunavailable.
24.4 COMMANDKEYWORDSANDFIELDS
Inthetablesbelow,thespecifiedcommandKEYWORDshouldbefollowedbyeachfield(ifany)intheorderdescribedinthetable
witheachfieldseparatedfromthepreviousbyafieldseparatorcharacter.E.g.VSCALE,1,0–turnsoffvoltagescalingforchannel1.
NOTES:
Forclarity,eachcommandwithineachsectionislistedinalphabeticalorderandalltableslistingthosecommandshavethe
samecolumnusage.
WheretheFIELD(s)columnindicatesadash(‐)thenthatcommandrequiresnofields.
WheretheFIELD(s)columnindicatesthatfieldsarerequired,thenthosefieldsmustbeincludedwiththecommandinthe
ordershowninthetable.
24.4.1 INTERFACECLEARCOMMANDS
Bothofthesecommandsperformthesamefunction.Theuseofeitherofthesecommandsisrecommendedwhenstartingasession
withtheXT2640toensurethatanyincompleteactivitiesperformedinapriorsessionareproperlydiscarded.
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELDDATA
RANGE
DESCRIPTION
*CLS
‐ ‐ ‐
ClearsallinterfaceregistersandflushesanyunsentTxdata,selectstheLOCAL
state,andabandonsanyunsavedmeasurementconfigurationchangesfromthe
interface
*RST
24.4.2 LOCAL/REMOTESTATECONTROLCOMMANDS
TheXT2640automaticallyenterstheREMOTEstatewhenanycommandisreceivedviaaninterface.WhileintheREMOTEstatea
frontpanelusercannotchangethemeasurementorinterfaceconfigurationwithoutfirstselectingtoreturntotheLOCALstate.
InterfacecommandsarealwaysactionedindependentoftheLOCAL/REMOTEstate.Thesecommandsareinvalidcommandsif
receivedviatheGPIBinterface.
COMMAND
KEYWORD
FIELD(s)
FIELD
FORMAT
FIELDDATA
RANGE
DESCRIPTION
LOCAL ‐ ‐ ‐
EnterstheLOCALstate(frontpanelmeasurementconfigurationchanges
enabled)
LOCKOUT ‐ ‐ ‐
EnterstheLOCKOUTstate(frontpanelmeasurementconfigurationchanges
disabledandyoucannotunlockfromthefrontpanel)
24.4.3 ERRORREGISTERQUERY COMMANDS
Eachregisteraccumulatesinterfacecommanderrorsandisclearedwhenread.TheuseoftheERRregisterisrecommended,the
OPCandESRregistersareincludedforlegacypurposes.
Itisnotrecommendedtoincludeanerrorregisterquerycommandwithanyothercommandsinasetofcommands;anysyntaxerror
inthoseothercommandsmaycausetheerrorregisterquerycommandtonotbeactioned.
Thesecommandsshouldbeusedfollowingcommandsduringtestingofyoursoftware;theymayberemovedlaterifdesired.Forthe
LANinterfaceitishighlyunlikelythatacommandwillbecorrupted,sotheregularuseofthistypeoferrorcheckingisnotnecessary;
howeverfortheUSBandRS232interfacesitispossibleforcommandstobecomecorruptedduringtransmissiontotheXT2640so
theuseofthe*ERR?commandisrecommendedinhighinterferenceenvironments.
TheERRregisterisautomaticallyclearedwhenaninterfaceisdisconnectedorwhenaLANinterfacesocketisclosed.
Non‐zerocontentsoftheERRregistercausethescreenoftheXT2640toindicateanerrormessageintheErrorInfoArea.This
messageremainsuntiltheERRregisteriscleared.