Keysight34970A/34972ACommandReference
Notice:ThisdocumentcontainsreferencestoAgilentTechnologies.Agilent'sformerTestandMeasurementbusinesshasbecomeKeysightTechnologies.Formoreinformation,gotowww.keysight.com.
ThisHelpfilecontainsreferenceinformationtohelpyouprogramtheKeysight34970A/34972Aoveraremoteinterfaceusingtheprogramminglanguage.
IntroductiontotheCommandLanguage
CommandsbySubsystem
CommandsA-Z
CommandQuickReference
ErrorMessages
FactoryResetState
InstrumentPresetState
Plug-InModuleReferenceInformation
RelatedInformationForfurtherinformation,clickonthelinkofinterest:LibrariesandInstrumentDriversKeysight34970A/34972ADocumentationKeysight34972AWebInterfaceProgrammingExamplesContactKeysightTechnologiesTrademarks
©KeysightTechnologies,Inc.2009-2014
Version2.00
CommandsbySubsystemABORt
FETCh?
INITiate
INPut:IMPedance:AUTO
READ?
R?
UNIT:TEMPerature
CALCulateSubsystem
CALibrationSubsystem
CONFigureSubsystem
DATASubsystem
DIAGnosticSubsystem
DISPlaySubsystem
FORMatSubsystemIntroduction
IEEE-488.2CommonCommands
INSTrumentSubsystemIntroduction
MEASureSubsystem
MEMorySubsystem
MMEMorySubsystem
OUTPutSubsystem
ROUTeSubsystem
SENSeSubsystem
SOURceSubsystem
STATusSubsystem
SYSTemSubsystem
TRIGgerSubsystem
ABORtSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
ABORt
Description
Thiscommandabortsameasurementinprogressfromascan.
Remarks
Ifascanisinprogresswhenthecommandisreceived,thescanwillnotbecompletedandyoucannotresumethescanfromwhereitleftoff.Notethatifyouinitiateanewscan,allreadingsareclearedfrommemory.
The*RSTcommandwillabortameasurement,clearthescanlist,andsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)alsoabortsameasurementbutitdoesnotclearthescanlist.
Example
Thefollowingcommandabortsthemeasurementinprogress.
ABOR
SeeAlso*RST
SYSTem:PRESet
FETCh?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
FETCh?
Description
Thiscommandtransfersreadingsstoredinnon-volatilememorytotheinstrument'soutputbuffer,whereyoucanreadthemintoyourcomputer.ThereadingsstoredinmemoryarenoterasedwhenyoureadthemwithFETCh?.TheformatofthereadingscanbechangedusingFORMat:READingcommands.
Remarks
TheFETCh?commandwillwaituntilthemeasurementiscompletetoterminate.
Readingscanbeacquiredduringascanusingthemultiplexeranddigitalmodules.
Youcanstoreatleast50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.
Eachtimeyoustartanewscan,theinstrumentclearsallreadings(includingalarmdata)storedinreadingmemoryfromthepreviousmeasurement.Therefore,thecontentsofmemoryarealwaysfromthemostrecentmeasurement.
Whenyouabortameasurement(seeABORtcommand),theinstrumentwillterminateanyreadinginprogress(readingsarenotclearedfrommemory).Thereadingsremaininmemoryandcanbereaduntilyouclearthemorinitiateanewscan.
TheoutputfromthiscommandisaffectedbythesettingsoftheFORMat:READingcommands.Dependingontheformatsselected,eachreadingmayormaynotbestoredwithmeasurementunits,timestamp,channelnumber,andalarmstatusinformation.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Theinstrumentclearsallreadingsfrommemorywhenanewscanisinitiated,whenanymeasurementparametersarechanged
(CONFigureandSENSecommands),andwhenthetriggeringconfigurationischanged(TRIGgercommands).
TheinstrumentclearsallreadingsfrommemoryafteraFactoryReset(*RSTcommand)orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thecommandtransfersallreadingsfrommemory(withformattingassetbytheFORMat:READingcommands)butdoesnoterasethem.Multipleresponsesareseparatedbycommas.
Example
ThefollowingprogramsegmentshowshowtousetheFETCh?commandwiththeCONFigureandINITiatecommands.TheROUTe:SCANcommandputsthetwochannelsintothescanlist(andredefinesthescanlist).TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthespecifiedchannelswhentherear-panelExtTrigInputlineispulsedlow,andthensendsthereadingstomemory.TheFETCh?commandtransfersthereadingsfrommemorytotheinstrument'soutputbuffer.
CONF:VOLT:DC10,0.003,(@103,108)
ROUT:SCAN(@103,108)
TRIG:SOUREXT
INIT
FETC?
TypicalResponse:+4.27150000E-03,+1.32130000E-03
SeeAlsoINITiate
ROUTe:SCAN
INITiateSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
INITiate
Description
Thiscommandchangesthestateofthetriggeringsystemfromthe"idle"statetothe"wait-for-trigger"state.ScanningwillbeginwhenthespecifiedtriggerconditionsaresatisfiedfollowingthereceiptoftheINITiatecommand.Readingsarestoredintheinstrument'sinternalreadingmemory.NotethattheINITiatecommandalsoclearstheprevioussetofreadingsfrommemory.
Ifascanlistiscurrentlydefined(seeROUTe:SCANcommand),theINITiatecommandperformsascanofthespecifiedchannels.
Ifascanlistisnotcurrentlydefined,theINITiatecommandfails.
Remarks
StoringreadingsinmemoryusingtheINITiatecommandisgenerallyfasterthansendingreadingstomemoryusingtheREAD?command.TheINITiatecommandisalsoan"overlapped"command.ThismeansthatafterexecutingtheINITiatecommand,youcansendothercommandsthatdonotaffectthemeasurements.
Youcanstoreupto50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Inaddition,bit9issetintheQuestionableDataRegister'sconditionregister(seeStatusSystemIntroduction).
Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodules.
Ifascanlistcontainingmultiplexerchannelsiscurrentlydefined(seeROUTe:SCANcommand),theINITiatecommandperformsascanofthespecifiedchannels.Whenthescanisinitiated,theinstrumentwillopenallchannelsinbanksthatcontainoneormorechannelsinthescanlist.
Theinstrumentscansthelistofchannelsinascendingorderfromslot100throughslot300(channelsarere-orderedasneeded).Whenyouspecifyarangeofchannelsinthe<scan_list>,thechannelsarealwayssortedinascendingorder.Therefore,(@109:101)willalwaysbeinterpretedas101,102,103,etc.
Onceyouinitiateascan,anerrorwillbegeneratedifyouattempttochangeanymeasurementparameters(CONFigureandSENSe
commands)orthetriggeringconfiguration(TRIGgercommands).Toabortascaninprogress,sendtheABORtcommand.
Toretrievethereadingsfrommemory,usetheFETCh?command.Thereadingsarenoterasedfrommemorywhenyoureadthem.Youcansendthecommandmultipletimestoretrievethesamedatainreadingmemory.
Example
ThefollowingprogramsegmentshowshowtousetheINITiatecommandwiththeCONFigureandFETCh?commands.TheROUTe:SCANcommandputsthetwochannelsintothescanlist(andredefinesthescanlist).TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthespecifiedchannelswhentherear-panelExtTrigInputlineispulsedlow,andthensendsthereadingstomemory.TheFETCh?commandtransfersthereadingsfrommemorytotheinstrument'soutputbuffer.
CONF:VOLT:DC10,0.003,(@103,108)
ROUT:SCAN(@103,108)
TRIG:SOUREXT
INIT
FETC?
TypicalResponse:+4.27150000E-03,+1.32130000E-03
SeeAlsoFETCh?
READ?
ROUTe:SCAN
INPut:IMPedance:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
INPut:IMPedance:AUTO<state>[,(@<ch_list>)]
INPut:IMPedance:AUTO?[(@<ch_list>)]
Description
ThiscommandenablesordisablestheautomaticinputresistancemodeforDCvoltagemeasurementsonthespecifiedchannels.
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
WithAUTOOFF(default),theinputresistanceisfixedat10MΩforallranges.
WithAUTOON,theinputresistanceissetto>10GΩforthe100mV,1V,and10Vranges.
ReturnFormat
Thequeryreturnstheinputresistancesettingas0(OFF)or1(ON)onthespecifiedchannels.
Examples
Thefollowingcommandsetstheimpedanceto>10GΩfortwochannels.
INP:IMP:AUTOON(@105,109)
Thefollowingqueriesfortheimpedanceontwochannels.
INP:IMP:AUTO?(@105,109)
TypicalResponse:1,1
SeeAlsoCONFigure:VOLTage:DC
MEASure:VOLTage:DC?
R?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
R?[<max_count>]
Description
Thisqueryreadsanderasesreadingsfromvolatilememoryuptothespecified<max_count>.Thereadingsareerasedfrommemorystartingwiththeoldestreadingfirst.Thepurposeofthiscommandistoallowyoutoperiodicallyremovereadingsfrommemorythatwouldnormallycausereadingmemorytooverflow(forexample,duringascanwithaninfinitescancount).
Parameters
Name Type RangeofValues
DefaultValue
<max_count> Numeric Maximumnumberofreadingstobereadanderasedfrommemory,from1to50,000.
Eraseallstoredreadings,upto50,000
Remarks
ThiscommandisaspecialversionoftheDATA:REMove?commandwithfasterexecutiontime.YoucanreadmemoryatanytimeusingtheR?command,evenduringascan.
Readingscanbeacquiredduringascanusingthemultiplexeranddigitalmodules.Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodules.
Youcanstoreupto50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Inaddition,bit9issetintheQuestionableDataRegister'sconditionregister(seeStatusSystemIntroduction).
Eachreadingisreturnedwithsomecombinationofmeasurementunits,timestamp,channelnumber,andalarmstatusinformation,dependingonthesettingssetbytheFORMat:READingcommands.Thetimestampiseitherinrelativeformat(timeinsecondssincethebeginningofthescan)orabsoluteformat(timeofdaywithdate,basedontheinstrument'sclockassetbytheSYSTem:DATEandSYSTem:TIMEcommands).ThechoiceofabsoluteandrelativetimeisdeterminedbytheFORMat:READing:TIME:TYPEcommand.
Theinstrumentclearsallreadingsfrommemorywhenanewscanisinitiated,whenanymeasurementparametersarechanged(CONFigureandSENSecommands),andwhenthetriggeringconfigurationischanged(TRIGgercommands).
TheinstrumentclearsallreadingsfrommemoryafteraFactory
Reset(*RSTcommand)orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
ThequeryreturnsaseriesofreadingsinDefinite-LengthBlockformat.Thesyntaxisapoundsign(#)followedbyanon-zerodigitrepresentingthenumberofdigitsinthedecimalintegertofollow.Thisdigitisfollowedbyadecimalintegerindicatingthenumberof8-bitdatabytestofollow.Thisisfollowedbyablockofdatacontainingthespecifiednumberofbytes.
Forexample:
Example
Thisqueryreadsthetwooldestreadingsanderasesthemfrommemory.
R?2
TypicalResponse:#231+2.87536000E-04,+3.18131400E-03
SeeAlsoDATA:REMove?
READ?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
34970ASyntax:READ?
34972ASyntax:READ?[(@<scan_list>)]
Description
Thiscommandchangestheinstrument'striggeringsystemfromthe"idle"statetothe"wait-for-trigger"state.ScanningwillbeginwhenthespecifiedtriggerconditionsaresatisfiedfollowingthereceiptoftheREAD?command.Readingsarethensentimmediatelytoreadingmemoryandtheinstrument'soutputbuffer.Onthe34970A,youmustthenreceivethereadingsintoyourcomputerortheinstrumentwillstopscanningwhentheoutputbufferbecomesfull.Readingsarenotstoredintheinstrument’sinternalmemorywhenusingREAD?.Onthe34972A,thereadingsarealwayssenttomemoryandtheywillstillbeavailableafterREAD?finishes.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizer)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<scan_list> ScanList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
SendingtheREAD?commandissimilartosendingtheINITiatecommandfollowedimmediatelybytheFETCh?command.
Youcanstoreupto50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Inaddition,bit9issetintheQuestionableDataRegister'sconditionregister(seeStatusSystemIntroduction).
Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodules.
Theinstrumentscansthelistofchannelsinascendingorderfromslot100throughslot300(channelsarere-orderedasneeded).Whenyouspecifyarangeofchannelsinthe<scan_list>,thechannelsarealwayssortedinascendingorder.Therefore,(@109:101)willalwaysbeinterpretedas101,102,103,etc.
Onceyouinitiateascan,anerrorwillbegeneratedifyouattempttochangeanymeasurementparameters(CONFigureandSENSecommands)orthetriggeringconfiguration(TRIGgercommands).Toabortascaninprogress,sendtheABORtcommand.
Eachreadingisreturnedwithsomecombinationofmeasurementunits,timestamp,channelnumber,andalarmstatusinformation,dependingonthesettingssetbytheFORMat:READingcommands.Thetimestampiseitherinrelativeformat(timeinsecondssincethebeginningofthescan)orabsoluteformat(timeofdaywithdate,basedontheinstrument'sclockassetbytheSYSTem:DATEandSYSTem:TIMEcommands).Thechoiceof
absoluteandrelativetimeisdeterminedbytheFORMat:READing:TIME:TYPEcommand.
TheREAD?queryisnotvalidwiththe*TRGcommand(usedwithTRIGger:SOURceBUScommandforsoftwaretriggering).
TheinstrumentclearsallreadingsfrommemoryafteraFactoryReset(*RSTcommand)orafteranInstrumentPreset(SYSTem:PRESetcommand).
Ifyouspecifya<scan_list>withthisquery(34972Aonly),itwilloverwritethecurrentscanlist.
ReturnFormat
Thecommandsendsreadingsdirectlytoreadingmemoryandtheinstrument'soutputbuffer(withformattingassetbytheFORMat:READingcommands).Multipleresponsesareseparatedbycommas.
Examples
ThefollowingprogramsegmentshowshowtousetheREAD?commandwiththeCONFigurecommand.TheROUTe:SCANcommandputsthetwochannelsintothescanlist(andredefinesthescanlist).TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthespecifiedchannelswhentherear-panelExtTrigInputlineispulsedlow,sendsthereadingstoreadingmemoryandtheinstrument'soutputbuffer.
CONF:VOLT:DC10,0.003,(@103,108)!Configure
channels
ROUT:SCAN(@103,108)!Definethescanlist
TRIG:SOUREXT
READ?!Appliestothepresentscanlist
TypicalResponse:+4.27150000E-03,+1.32130000E-03
SeeAlsoFETCh?
INITiate
ROUTe:SCAN
UNIT:TEMPeratureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
UNIT:TEMPerature<units>[,(@<ch_list>)]
UNIT:TEMPerature?[(@<ch_list>)]
Description
Thiscommandselectsthetemperatureunits(°C,°F,orKelvin)onthespecifiedchannels.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Thefollowingtableshowswhichtemperaturetransducersaresupportedbyeachofthemultiplexermodules.
Module Thermocouple RTD2-
Wire
RTD4-
Wire
Thermistor
34901AArmatureMultiplexer
Yes Yes Yes Yes
34902AReedMultiplexer
Yes Yes Yes Yes
34908AArmatureMultiplexer(1-Wire)
NotRecommended1
Yes No Yes
1Withaone-wiremultiplexer,evenverysmallgroundcurrentscanintroducesubstantialmeasurementerror.
Parameters
Name Type RangeofValues DefaultValue
<units> Discrete {C|F|K},forCelsius,FahrenheitorKelvin
Thisisarequiredparameter.
ThefactorydefaultisC.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Youcanmixtemperatureunitsondifferentchannelswithintheinstrumentandonthesamemodule.
IfthecorrespondingchannelsarenotconfiguredfortemperaturemeasurementspriortothesendingoftheUNIT:TEMPeraturecommand,theinstrumentwilldispatchanerrormessage.
SettingtheMx+B(seeCALCulate:SCALe:UNITcommand)measurementlabelto°C,°F,orKhasnoeffectonthetemperaturemeasurementunitscurrentlyselected.
TheCONFigureandMEASure?commandsautomaticallyselect°C.
Theinstrumentsetsthetemperatureunitsto°CafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
ThequeryreturnsC,F,orKforeachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandsetsthetemperatureunitsto°Fonchannels12and13inslot300.
CONF:TEMPTC,B,(@312,313)
UNIT:TEMPF,(@312,313)
Thefollowingqueryreturnsthetemperatureunitsselectedonchannels12and13inslot300.
UNIT:TEMP?(@312,313)
TypicalResponse:F,F
SeeAlsoCALCulate:SCALe:UNIT
CONFigure:TEMPerature
MEASure:TEMPerature?
CALCulateSubsystemIntroductionTheinternalDMMisrequiredtostorereadingsinmemoryandperformcalculations.Readingscanbeacquiredduringascanusingthe34970A/34972Amultiplexermoduleslistedbelow.
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule
34908A40ChannelSingle-EndedMultiplexerModule
CommandSummaryCALCulate:AVERage:AVERage?
CALCulate:AVERage:CLEar
CALCulate:AVERage:COUNt?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:MAXimum:TIME?
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:PTPeak?
CALCulate:COMPare:DATA
CALCulate:COMPare:DATA?
CALCulate:COMPare:MASK
CALCulate:COMPare:MASK?
CALCulate:COMPare:STATe
CALCulate:COMPare:STATe?
CALCulate:COMPare:TYPE
CALCulate:COMPare:TYPE?
CALCulate:LIMit:LOWer
CALCulate:LIMit:LOWer?
CALCulate:LIMit:LOWer:STATe
CALCulate:LIMit:LOWer:STATe?
CALCulate:LIMit:UPPer
CALCulate:LIMit:UPPer?
CALCulate:LIMit:UPPer:STATe
CALCulate:LIMit:UPPer:STATe?
CALCulate:SCALe:GAIN
CALCulate:SCALe:GAIN?
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet?
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALCulate:SCALe:STATe?
CALCulate:SCALe:UNIT
CALCulate:SCALe:UNIT?
CALCulate:AVERage:MINimum?CALCulate:AVERage:AVERage?CALCulate:AVERage:MAXimum?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALCulate:AVERage:MINimum?[(@<ch_list>)]
CALCulate:AVERage:AVERage?[(@<ch_list>)]
CALCulate:AVERage:MAXimum?[(@<ch_list>)]
Description
Thesequeriesreturntheminimum,average(arithmeticmean)andmaximumvaluesfoundoneachofthespecifiedchannelsduringthescan.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Youcanreadthevaluesatanytime,evenduringascan.AnerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
ThecalculationstartswhentheinternalDMMistriggered.Theinstrumentclearsthestoredstatisticaldataonallchannelswhenanewscanisstarted,whentheCALCulate:AVERage:CLEarcommandisexecuted,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsanumberintheform"+2.61920000E+01".Multipleresponsesareseparatedbycommas.Ifnodataisavailableforthespecifiedchannels,itreturns+0.00000000E+00.
Example
Thefollowingqueryreturnstheminimumvaluesfoundonchannels05through08onthemoduleinslot100.
Inthisexample,youcanreplacetheMINnodewithMAXorAVER.
CALC:AVER:MIN?(@105:108)
TypicalResponse:+3.13830293E+01,+1.98732123E+01,9.38293055E+00,1.20393822E+01
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:AVERage:CLEarSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALCulate:AVERage:CLEar[(@<ch_list>)]
Description
Thiscommandclearsallvaluesfromthestatisticsregistersforthespecifiedchannels.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.Theminimum,maximum,average,count,andpeak-to-peakvaluesarecleared.Thevaluesforallscannedchannelsarealsoclearedatthestartofanewscan.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Althoughthiscommandclearstheminimum,maximum,average,count,andpeak-to-peakvalues,noreadingsareclearedfrommemory.
TheinstrumentgeneratesanerroriftheinternalDMMisdisabled(seeINSTrument:DMM)ornotinstalledinthemainframe.
Theinstrumentclearsthestoredstatisticaldataonallchannelswhenanewscanisstarted,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
Example
Thefollowingcommandclearsthestoredstatisticaldataonchannels1through10inslot200.
CALC:AVER:CLEar(@201:210)
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:AVERage?
CALCulate:AVERage:COUNt?
CALCulate:AVERage:PTPeak?
CALCulate:AVERage:COUNt?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALCulate:AVERage:COUNt?[(@<ch_list>)]
Description
Thisqueryreturnsthenumberofreadingstakenoneachofthespecifiedchannelsduringthescan.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Youcanreadthevaluesatanytime,evenduringascan.AnerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
ThecalculationstartswhentheinternalDMMistriggered.Theinstrumentclearsthestoredstatisticaldataonallchannelswhenanewscanisstarted,whentheCALCulate:AVERage:CLEarcommandisexecuted,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsanumberintheform"+7.90000000E+01".Multipleresponsesareseparatedbycommas.Ifnodataisavailableforthespecifiedchannels,itreturns0.
Example
Thefollowingqueryreturnsthenumberofreadingstakenonchannels05through08onthemoduleinslot100.
CALC:AVER:COUNt?(@105:108)
TypicalResponse:+2.00000000E+01,1.90000000E+01,2.10000000E+01,2.00000000E+01
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:AVERage?
CALCulate:AVERage:MINimum:TIME?CALCulate:AVERage:MAXimum:TIME?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALCulate:AVERage:MINimum:TIME?[(@<ch_list>)]
CALCulate:AVERage:MAXimum:TIME?[(@<ch_list>)]
Description
Thesequeriesreturnthetimethattheminimumormaximumreadingwastakenonthespecifiedchannelsduringthescan(infulltimeanddateformat).Eachchannelmustbeamultiplexer,digitalinputortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Youcanreadthevaluesatanytime,evenduringascan.AnerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
ThecalculationstartswhentheinternalDMMistriggered.Theinstrumentclearsthestoredstatisticaldataonallchannelswhenanewscanisstarted,whentheCALCulate:AVERage:CLEarcommandisexecuted,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ThiscommandisnotaffectedbytheFORMat:READing:TIME:TYPEcommand,whichselectsthetimeformatforstoringscanneddatainmemory(absolutetimeversusrelativetime).
ReturnFormat
Foreachchannel,thequeryreturnsthetimeintheformyyyy,mm,dd,hh,mm,ss.sss.Forexample,2009,10,03,14,35,06.215wouldmeanOctober3,2009at2:35:06.215PM.
Example
Thefollowingqueryreturnsthetimeoftheminimumreadingonchannels03and04onthemoduleinslot100.
CALC:AVER:MIN:TIME?(@103:104)
TypicalResponse:2009,12,20,08,39,27.283,2009,12,20,08,39,28.011
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:AVERage:PTPeak?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALCulate:AVERage:PTPeak?[(@<ch_list>)]
Description
Thisqueryreturnsthepeaktopeakvalue(maximumminusminimum)foundoneachofthespecifiedchannelsduringthescan.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> Channellist Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Youcanreadthevaluesatanytime,evenduringascan.AnerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
ThecalculationstartswhentheinternalDMMistriggered.Theinstrumentclearsthestoredstatisticaldataonallchannelswhenanewscanisstarted,whentheCALCulate:AVERage:CLEarcommandisexecuted,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsanumberintheform"+2.61920000E+01".Multipleresponsesareseparatedbycommas.Ifnodataisavailableforthespecifiedchannels,itreturns+0.00000000E+00.
Example
Thefollowingqueryreturnsthepeaktopeakvaluesfoundonchannels05through08onthemoduleinslot100.
CALC:AVER:PTP?(@105:108)
TypicalResponse:+3.13830293E+01,+1.98732123E+01,9.38293055E+00,1.20393822E+01
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:AVERage?
CALCulate:COMPare:DATASyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:COMPare:DATA<data>[,(@<ch_list>)]
CALCulate:COMPare:DATA?[(@<ch_list>)]
Description
Thiscommandsetsthedigitaldataforpatterncomparisonsonthespecifieddigitalinputchannels.Youcanusethepatterncomparisonfeaturetogenerateanalarmwhenaspecificdigitalpatternisdetected.
UsedWith:
34907AMultifunctionModule(digitalinputchannelsonly)
Parameters
Name Type RangeofValues DefaultValue
<data> Numeric An8-bitdigitalpatternforcomparison,specifiedasanintegerfrom0to255.
Thisisarequiredparameter.
<ch_list> ChannelList Oneormore
channels,asshown:
(@301)-channel01onthemoduleinslot300.
(@301:302)-channels01and02onthemoduleinslot300.
(@101,201:202,302)-channel01onthemoduleinslot100,channels01and02onthemoduleinslot200,andchannel02onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Notethatthespecifiedchannelsdonothavetobepartofthescanlisttogenerateanalarm.Alarmsareevaluatedcontinuouslyassoonasyouenablethem.Alarmsareevaluatedconstantlyonthemultifunctionmodule,butalarmdataisstoredinreadingmemoryonlyduringascan.
Thechannelwidthtakesprecedenceoverthespecifieddigitalpattern.Ifthespecifiedpatternisgreaterthanthechannelwidth,additionalbitswillbeignored.Forexample,ifyousetthechannelwidthto"BYTE"andthenspecifyapatternof"256"(100000000),thepatternwillbetruncatedto"00000000"(theleading"1"willbeignored).
Afterspecifyingthedesireddigitalpattern,usetheCALCulate:COMPare:STATecommandtoenablepatterncomparisonsonthespecifiedchannels.Ifyouwanttomonitorthestateofspecificbits,usetheCALCulate:COMPare:DATAcommandinconjunctionwiththeCALCulate:COMPare:MASKcommandtospecifyamaskpattern.
UsetheCALCulate:COMPare:TYPEcommandtospecifywhetheranalarmorhardwareinterruptconditionisgeneratedwhenaspecificbitpatternorbitpatternchangeisdetected.
AFactoryReset(*RSTcommand)clearsthedigitalpatternandturnsoffthepatterncomparisonmode.AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotclearthedataanddoesnotturnoffthepatterncomparisonmode.
ReturnFormat
Thequeryreturnsthecomparisonpatternasadecimalvalue(binaryandhexadecimalvaluesareconvertedtotheirdecimalequivalents).Multipleresponsesareseparatedbycommas.
Examples
Thefollowingqueryreturnsthecomparisonpatternselectedforchannel01ofthe34907Amultifunctionmoduleinslot300.
CALC:COMP:DATA?(@301)!Alwaysreturnsdecimal
equivalent
TypicalResponse:140
Thefollowingprogramsegmentsetsthedigitalpatternforthe34907Amultifunctionmoduleinslot100andthenenablesthepatterncomparisonmode.Whenthedatareadfromthebankisequaltothecomparisonpattern,analarmwillbegeneratedonAlarm2.
CALC:COMP:DATA#HF6,(@101)!Setcomparisonpattern
(11110110)
CALC:COMP:TYPEEQUAL,(@101)!Generatealarmon
patternmatch
OUTP:ALARM2:SOUR(@101)!Enablealarms
CALC:COMP:STATON,(@101)!Enablepatterncomparison
mode
Thefollowingqueryreturnsthecomparisonpatternselectedforthe34907Amultifunctionmoduleinslot100.
CALC:COMP:DATA?(@101)!Alwaysreturnsdecimal
equivalent
TypicalResponse:+246
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:COMPare:MASK
CALCulate:COMPare:STATe
CALCulate:COMPare:TYPE
OUTPut:ALARm{1|2|3|4}:SOURce
CALCulate:COMPare:MASKSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:COMPare:MASK<mask>[,(@<ch_list>)]
CALCulate:COMPare:MASK?[(@<ch_list>)]
Description
ThiscommandisusedinconjunctionwiththeCALCulate:COMPare:DATAcommandtosetthedigitalmaskdataforpatterncomparisonsonthespecifieddigitalinputchannels.Youcanusethepatterncomparisonfeaturetogenerateanalarmwhenaspecificdigitalpatternisdetected.
UsedWith:
34907AMultifunctionModule(digitalinputchannelsonly)
Parameters
Name Type RangeofValues DefaultValue
<mask> Numeric An8-bitmaskpatternforcomparison,specifiedasanintegerfrom0to255.Activebitsarespecifiedas1's,and"don'tcare"bitsarespecifiedas0's.
Thisisarequiredparameter.
<ch_list> ChannelList Oneormore
channels,asshown:
(@301)-channel01onthemoduleinslot300.
(@301:302)-channels1and2onthemoduleinslot300.
(@101,201:202,302)-channel1onthemoduleinslot100,channels01and02onthemoduleinslot200,andchannel02onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Notethatthespecifiedchannelsdonothavetobepartofthescanlisttogenerateanalarm.Alarmsareevaluatedcontinuouslyassoonasyouenablethem.Alarmsareevaluatedconstantlyonthemultifunctionmodule,butalarmdataisstoredinreadingmemoryonlyduringascan.
Thechannelwidthtakesprecedenceoverthespecifieddigitalpattern.Ifthespecifiedpatternisgreaterthanthechannelwidth,additionalbitswillbeignored.Forexample,ifyousetthechannelwidthto"BYTE"andthenspecifyapatternof"256"(100000000),thepatternwillbetruncatedto"00000000"(theleading"1"willbeignored).
Afterspecifyingthedesireddigitalpattern,usetheCALCulate:COMPare:STATecommandtoenablepatterncomparisonsonthespecifiedchannels.
AFactoryReset(*RSTcommand)clearsthemaskandturnsoffthepatterncomparisonmode.AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotclearthemaskanddoesnotturnoffthepatterncomparisonmode.
ReturnFormat
Thequeryreturnsthemaskasadecimalvalue(binaryandhexadecimalvaluesareconvertedtotheirdecimalequivalents).Multipleresponsesareseparatedbycommas.
Examples
Toillustratehowthecalculationsareperformed,seetheexamplebelowwhichassumesthatadecimal146wasreadfromthechannel.Sincethecalculationsproduceanon-zeroresult(decimal16),aninterruptisnotgenerated.
MSBLSB10010010Datareadfromport(decimal146)10001100CALC:COMP:DATAcommand(decimal140)00011110X-ORresult11110000CALC:COMP:MASKcommand(decimal240)00010000ANDresult(decimal16,nointerruptgenerated)
Thefollowingqueryreturnsthecomparisonpatternselectedforthemoduleinslot300.
CALC:COMP:MASK?(@301)!Alwaysreturnsdecimal
equivalent
TypicalResponse:240
Thefollowingprogramsegmentsetsthedigitalpatternforthe34907Amultifunctionmoduleinslot100,appliesamasktothelowerbyte,andthenenablesthepatterncomparisonmode.Whenthedatareadfromthelowerbyteisequaltothecomparisonpattern,analarmwillbegeneratedonAlarm2.
CALC:COMP:DATA:WORD#HF6F6,(@101)!Setcomparison
pattern(1111011011110110)
CALC:COMP:MASK#H00FF,(@101)!Setmaskpattern(0000
000011111111)
CALC:COMP:TYPEEQUAL,(@101)!Generatealarmon
patternmatch
OUTP:ALARM2:SOUR(@101)!Enablealarms
CALC:COMP:STATON,(@101)!Enablepatterncomparison
mode
Toillustratehowthecalculationsareperformed,seetheexamplebelowwhichassumesthatadecimal37595wasreadfromthechannel.Sincethecalculationsproduceanon-zeroresult(decimal13),analarmisnotgenerated.
MSBLSB1001001011011011Datareadfromport(decimal37595)1111011011110110CALC:COMP:DATAcommand(decimal63222)0110010000101101X-ORresult0000000011111111CALC:COMP:MASKcommand(decimal255)0000000000001101ANDresult(decimal13,noalarmgenerated)
Thefollowingqueryreturnsthecomparisonpatternselectedforchannel01ofthe34907Amultifunctionmoduleinslot100.
CALC:COMP:MASK?(@101)!Alwaysreturnsdecimal
equivalent
TypicalResponse:+255
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:COMPare:DATA
CALCulate:COMPare:STATe
CALCulate:COMPare:TYPE
OUTPut:ALARm{1|2|3|4}:SOURce
CALCulate:COMPare:STATeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:COMPare:STATe<state>[,(@<ch_list>)]
CALCulate:COMPare:STATe?[(@<ch_list>)]
Description
Thiscommanddisablesorenablesthepatterncomparisonmodeonthespecifieddigitalinputchannels.Youcanusethepatterncomparisonfeaturetogenerateanalarmwhenaspecificdigitalpatternisdetected.
UsedWith:
34907AMultifunctionModule(digitalinputchannelsonly)
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
<ch_list> ChannelList Oneormore
channels,asshown:
(@301)-channel01onthemoduleinslot300.
(@301:302)-channels01and02onthemoduleinslot300.
(@101,201:202,302)-channel01onthemoduleinslot100,channels01and02onthemoduleinslot200,andchannel02onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Notethatthespecifiedchannelsdonothavetobepartofthescanlisttogenerateanalarm.Alarmsareevaluatedcontinuouslyassoonasyouenablethem.Alarmsareevaluatedconstantlyonthemultifunctionmodule,butalarmdataisstoredinreadingmemoryonlyduringascan.
AFactoryReset(*RSTcommand)turnsoffthepatterncomparisonmode.AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotturnoffthepatterncomparisonmode.
ReturnFormat
Thequeryreturnsthestateofthecomparisonmodeas0(OFF)or1(ON)forthespecifiedbank.Multipleresponsesareseparatedbycommas.
Examples
ThefollowingcommandsetsthecomparisonmodeONforthethreespecifiedchannels.
CALC:COMP:STAT1,(@201,202,301)
Thefollowingqueryreturnsthestateofthepatterncomparisonmodeforchannel01onthemodulesinslot200and300.
CALC:COMP:STAT?(@201,301)
TypicalResponse:1,1
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:COMPare:DATA
CALCulate:COMPare:MASK
CALCulate:COMPare:TYPE
OUTPut:ALARm{1|2|3|4}:SOURce
CALCulate:COMPare:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:COMPare:TYPE<mode>[,(@<ch_list>)]
CALCulate:COMPare:TYPE?[(@<ch_list>)]
Description
Thiscommandconfiguresthespecifieddigitalinputchannelstogenerateanalarmwhenaspecificbitpatternorbitpatternchangeisdetected.ThiscommandisusedinconjunctionwiththeCALCulate:COMPare:DATAcommandwhichsetsthedatabitpatternandtheCALCulate:COMPare:MASKcommandwhichsetsthemaskbitpattern.
UsedWith:
34907AMultifunctionModule(digitalinputchannelsonly)
Parameters
Name Type RangeofValues DefaultValue
<mode> Discrete {EQUal|NEQual} Thisisarequiredparameter.
Thepower-onvalueisNEQual.
<ch_list> ChannelList Oneormore
channels,asshown:
(@301)-channel01onthemoduleinslot300.
(@301:302)-channels01and02onthemoduleinslot300.
(@101,201:202,302)-channel01onthemoduleinslot100,channels01and02onthemoduleinslot200,andchannel02onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Notethatthespecifiedchannelsdonothavetobepartofthescanlisttogenerateanalarm.Alarmsareevaluatedcontinuouslyassoonasyouenablethem.Alarmsareevaluatedconstantlyonthemultifunctionmodule,butalarmdataisstoredinreadingmemoryonlyduringascan.
SelectEQUaltogenerateanalarmorinterruptwhenthedatareadfromthespecifiedchannelisequaltoCALCulate:COMPare:DATA,afterbeingmaskedbyCALCulate:COMPare:MASK.
SelectNEQual(notequal)togenerateanalarmorinterruptwhenthedatareadfromthebankisnotequaltoCALCulate:COMPare:DATAafterbeingmaskedbyCALCulate:COMPare:MASK.
Bitsmaskedoffas0("don'tcare")byCALCulate:COMPare:MASKareignored.
Thechannelwidthtakesprecedenceoverthespecifieddigitalpattern.Ifthespecifiedpatternisgreaterthanthechannelwidth,additionalbitswillbeignored.Forexample,ifyousetthechannelwidthto"BYTE"andthenspecifyapatternof"256"(100000000),thepatternwillbetruncatedto"00000000"(theleading"1"willbeignored).
AFactoryReset(*RSTcommand)clearsthepatterncomparesettingandturnsoffthepatterncomparisonmode.AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotclearthepatterncomparesettinganddoesnotturnoffthepatterncomparisonmode.
ReturnFormat
ThequeryreturnsEQUorNEQforthespecifiedbank.Multipleresponsesareseparatedbycommas.
Examples
ThefollowingcommandsetsthecomparisonmodeforthespecifiedchannelstoEQUal.
CALC:COMP:TYPEEQU,(@301:302)
Thefollowingqueryreturnsthecomparisonmodeforthetwospecifiedchannels.
CALC:COMP:TYPE?(@301:302)
TypicalResponse:EQU,EQU
SeeAlso
CALCulate:COMPare:DATA
CALCulate:COMPare:MASK
CALCulate:COMPare:STATe
OUTPut:ALARm{1|2|3|4}:SOURce
CALCulate:LIMit:LOWerCALCulate:LIMit:UPPerSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:LIMit:LOWer<lo_limit>[,(@<ch_list>)]CALCulate:LIMit:LOWer?[(@<ch_list>)]
CALCulate:LIMit:UPPer<hi_limit>[,(@<ch_list>)]CALCulate:LIMit:UPPer?[(@<ch_list>)]
Description
Theinstrumenthasfouralarmswhichyoucanconfiguretoalertyouwhenareadingexceedsspecifiedlimitsonamultiplexerchannelduringascan.Thesecommandssetthelowerandupperlimitsforalarmsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(totalizerchannelonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<lo_limit> Numeric Anynumericvalue 0
<hi_limit> Numeric Anynumericvalue;fortotalizerchannels,the<hi_limit>referstoamaximumcount.
0
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Alarmsareevaluatedduringascanoramonitormeasurementonchannelsofamultiplexermodule.Forscanningusingamultiplexermodule,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodulesandthespecifiedchannelsdonothavetobepartoftheactivescanlisttogenerateanalarm.
Youcanassignalowerlimit,anupperlimit,orbothtoanyconfiguredchannelinthescanlist.Thelowerlimitmustalwaysbelessthanorequaltotheupperlimit.
Onceyouhavedefinedthelowerlimits,usetheCALCulate:LIMit:LOWer:STATecommandtoenablealarmsonthespecifiedchannels.Similarly,useCALCulate:LIMit:UPPer:STATeaftersettingtheupperlimits.
ThealarmsareevaluatedbytheinternalDMMfromthetimetheCALCulate:LIMit:LOWer:STATeONandCALCulate:LIMit:UPPer:STATeONcommandsareexecuted.
Youmustconfigurethechannel(function,transducertype,etc.)beforesettinganyalarmlimits.Ifyouchangethemeasurementconfiguration,alarmsareturnedoffandthelimitvaluesarecleared.Alarmsarealsoturnedoffwhenyouchangethetemperatureprobetype,temperatureunits,ordisabletheinternalDMM.
Youcanassignmultiplechannelstoanyofthefouravailablealarms(numbered1through4,seeOUTPut:ALARm<n>:SOURcecommand).Forexample,youcanconfiguretheinstrumenttogenerateanalarmontheAlarm1outputwhenalimitisexceededonanyofchannels103,205,or310.Youcannot,however,assignalarmsonaspecificchanneltomorethanonealarmnumber.
IfyouplantousealarmsonachannelwhichwillalsouseMx+Bscaling,besuretoconfigurethescalingvaluesfirst.Ifyouattempttoassignthealarmlimitsfirst,theinstrumentwillturnoffalarmsandclearthelimitvalueswhenyouenablescalingonthatchannel.Ifyouspecifyacustommeasurementlabelwithscaling,itisautomaticallyusedwhenalarmsareloggedonthatchannel.
Ifyouredefinethescanlist,alarmsarenolongerevaluatedonthosechannels(duringascan)butthelimitvaluesarenotcleared.Ifyoudecidetoaddachannelbacktothescanlist(withoutchangingthefunction),theoriginallimitvaluesarerestoredandalarmsareturnedbackon.Thismakesiteasytotemporarilyremoveachannelfromthescanlistwithoutenteringthealarmvaluesagain.
Togenerateanalarmwhenaspecificcountisreachedonatotalizerchannel,seetheCALCulate:LIMit:UPPercommand.Togenerateanalarmwhenaspecificbitpatternorbitpatternchangeisdetectedonadigitalinputchannel,seetheCALCulate:COMParecommands.
TheinstrumentclearsallalarmlimitsandturnsoffallalarmsafteraFactoryReset(*RSTcommand),InstrumentPreset(SYSTem:PRESetcommand),orCardReset(SYSTem:CPONcommand).
ReturnFormat
Thequeryreturnstheupperorlowerlimitintheform"-1.00000000E+15"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Inthefollowingexamples,youcansubstitutethenodenameUPPforLOW.
Thefollowingcommandsetsthelowerlimitto-0.25onchannels03and13inslot100.
CALC:LIM:LOW-0.25,(@103,113)
Thefollowingqueryreturnsthelowerlimitsettingsonchannels03and13inslot100.
CALC:LIM:LOW?(@103,113)
TypicalResponse:-2.50000000E-01,-2.50000000E-01
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:LIMit:LOWer:STATe
CALCulate:LIMit:LOWer:STATeCALCulate:LIMit:UPPer:STATeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:LIMit:LOWer:STATe<mode>,(@<ch_list>)CALCulate:LIMit:LOWer:STATe?(@<ch_list>)
CALCulate:LIMit:UPPer:STATe<mode>,(@<ch_list>)CALCulate:LIMit:UPPer:STATe?(@<ch_list>)
Description
Thesecommandsdisableorenablethelowerandupperalarmlimitsonthespecifiedmultiplexerchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<mode> Boolean {OFF|0|ON|1} OFF
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Alarmdatacanbestoredinoneoftwolocationsdependingonwhetherascanlistisrunningwhenthealarmoccurs.
a. Ifanalarmeventoccursonachannelasitisbeingscanned,thenthatchannel'salarmstatusisstoredinreadingmemoryasthereadingsaretaken.Eachreadingthatisoutsidethespecifiedalarmlimitisloggedinmemory.Youcanstoreatleast50,000readingsinmemoryduringascan.
b. Asalarmeventsaregenerated,theyarealsologgedinanalarmqueue,whichisseparatefromreadingmemory.Thisistheonlyplacethatnon-scannedalarmsgetlogged(alarmsduringachannelmonitor,alarmsgeneratedbythedigitalmodules,etc.).Upto20alarmscanbeloggedinthealarmqueue.Ifmorethan20alarmeventsaregenerated,theywillbelost(onlythefirst20alarmsaresaved).Evenifthealarmqueueisfull,thealarmstatusisstoredinreadingmemoryduringascan.
Alarmsareevaluatedduringascanoramonitormeasurementonchannelsofamultiplexermodule.Forscanningusingamultiplexermodule,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodulesandthespecifiedchannelsdonothavetobepartoftheactivescanlisttogenerateanalarm.
Whenanalarmoccurs,theinstrumentstoresrelevantinformationaboutthealarminthequeue.Thisincludesthereadingthatcausedthealarm,thetimeofdayanddateofthealarm,andthechannelnumberonwhichthealarmoccurred.TheinformationstoredinthealarmqueueisalwaysinabsolutetimeandisnotaffectedbytheFORMat:READing:TIME:TYPEcommandsetting.
Alarmsareloggedinthealarmqueueonlywhenareading
crossesalimit,notwhileitremainsoutsidethelimitandnotwhenitreturnstowithinlimits.
Inadditiontobeingstoredinreadingmemory,alarmsarealsorecordedintheirownSCPIStatusSystem.YoucanconfiguretheinstrumenttousethestatusregistertogenerateaServiceRequest(SRQ)whenalarmsaregenerated.FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Onthedigitalmodules,youcansetanupperlimitforthetotalizerchannels(nolowerlimitisallowed).Thesechannelsdonothavetobepartoftheactivescanlisttogenerateanalarm,butalarmdataisstoredinreadingmemoryonlyaspartofascan.
Togenerateanalarmwhenaspecificcountisreachedonatotalizerchannel,seetheCALCulate:LIMit:UPPercommand.Togenerateanalarmwhenaspecificbitpatternorbitpatternchangeisdetectedonadigitalinputchannel,seetheCALCulate:COMParecommands.
TheinstrumentclearsallalarmlimitsandturnsoffallalarmsafteraFactoryReset(*RSTcommand),InstrumentPreset(SYSTem:PRESetcommand),orCardReset(SYSTem:CPONcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Intheexamplesbelow,youcanreplacethenodenameUPPwithLOW.
Thefollowingprogramsegmentsetsanupperlimitonchannels03and13inslot100andthenenablesalarmsonthesechannels.
CALC:LIM:UPP10.25,(@103,113)
CALC:LIM:UPP:STATON,(@103,113)
Thefollowingqueryreturnsthestateofupperlimitsonchannels03and13inslot100.
CALC:LIM:UPP:STAT?(@103,113)
TypicalResponse:1,1
Thefollowingcommandsetstheupperlimitto4095ontotalizerchannels01and02inslot300andthenenablesalarmsonthesechannels.
CALC:LIM:UPP4.095E+03,(@301,302)
CALC:LIM:UPP:STATON,(@301,302)
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:LIMit:UPPer
OUTPut:ALARm{1|2|3|4}:SOURce
SYSTem:ALARm?
CALCulate:SCALe:GAINCALCulate:SCALe:OFFSetSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:SCALe:GAIN<gain>[,(@<ch_list>)]CALCulate:SCALe:GAIN?[(@<ch_list>)]
CALCulate:SCALe:OFFSet<offset>[,(@<ch_list>)]CALCulate:SCALe:OFFSet?[(@<ch_list>)]
Description
Thesecommandssetthegain("M")andoffset("B")forscaledreadingsonthespecifiedmultiplexerchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<gain> Numeric Anyvaluebetween-1E15to+1E15
Thisisarequiredparameter.
Thefactorydefaultis1.
<offset> Numeric Anyvaluebetween-1E+15and+1E+15.
Thisisarequiredparameter.
Thefactorydefaultis0.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemodulein
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
slot200andchannels02through08onthemoduleinslot300.
Remarks
Scalingisappliedusingthefollowingequation:
ScaledReading=(GainxMeasurement)+Offset
Aftersettingthegainandoffsetvalues,usetheCALCulate:SCALe:STATecommandtoenablethescalingfunction.
Readingscanbeacquiredduringascanusingthemultiplexer.Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
Youmustconfigurethechannel(function,transducertype,etc.)beforeapplyinganyscalingvalues.Ifyouchangethemeasurementconfiguration,scalingisturnedoffonthatchannelandthegainandoffsetvaluesarereset(M=1andB=0).Scalingisalsoturnedoffwhenyouchangethetemperatureprobetype,temperatureunits,ordisabletheinternalDMM.
Ifyouchangethemeasurementconfiguration(function,transducertype,etc.)onachannelortheinternalDMM,scalingisturnedoffonthosechannelsandthegainandoffsetvaluesarecleared.
Ifyouplantousescalingonachannelwhichwillalsousealarms,besuretoconfigurethescalingvaluesfirst.Ifyouattempttoassignthealarmlimitsfirst,theinstrumentwillturnoffalarmsandclearthelimitvalueswhenyouenablescalingonthatchannel.Ifyouspecifyacustommeasurementlabelwithscaling,itisautomaticallyusedwhenalarmsareloggedonthatchannel.
Ifyouredefinethescanlist,nochangewillbemadetothescalingstateorthegainandoffsetvalues.Ifyoudecidetoaddachannelbacktothescanlist,theoriginalgainandoffsetvaluesarerestored.
Youcanusescalingtomakea"null"measurementonachannelandstoreitastheoffset("B")forsubsequentmeasurements.Thisallowsyoutoadjustforvoltageorresistiveoffsetsthroughyourwiringtothepointofthemeasurement.SeeCALCulate:SCALe:OFFSet:NULL.
TheCONFigureandMEASure?commandsautomaticallysetthegain("M")to1andoffset("B")to0.
AFactoryReset(*RSTcommand)turnsoffscalingandclearsthescalingvaluesonallchannels(gain=1,offset=0).AnInstrumentPreset(SYSTem:PRESetcommand)doesnotclearthescalingvaluesanddoesnotturnoffscaling.
ReturnFormat
Thequeryreturnsthegainoroffsetvalueforeachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandsetsthegainto+1.25onchannels03and13inslot100.
CALC:SCAL:GAIN1.25,(@103,113)
Thefollowingqueryreturnsthegainsettingsonchannels03and13inslot100.
CALC:SCAL:GAIN?(@103,113)
TypicalResponse:+1.25000000E+00,+1.25000000E+00
Thefollowingcommandsetstheoffsetto+10.125onchannels03and13inslot100.
CALC:SCAL:OFFS10.125,(@103,113)
Thefollowingqueryreturnstheoffsetvaluesonchannels03and13inslot100.
CALC:SCAL:OFFS?(@103,113)
TypicalResponse:+1.01250000E+01,+1.01250000E+01
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALCulate:SCALe:UNIT
CALCulate:SCALe:OFFSet:NULLSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALCulate:SCALe:OFFSet:NULL[(@<ch_list>)]
Description
Thiscommandmakesanimmediatenullmeasurementonthespecifiedchannelsandstoresitastheoffset("B")forsubsequentmeasurements.Thisallowsyoutoadjustforvoltageorresistiveoffsetsthroughyourwiringtothepointofthemeasurement.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Example
Thefollowingcommandmakesanimmediatenullmeasurementonchannels206through210.
CALC:SCAL:OFFS:NULL(@206:210)
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
CALCulate:SCALe:STATe
CALCulate:SCALe:UNIT
CALCulate:SCALe:STATeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:SCALe:STATe<state>[,(@<ch_list>)]
CALCulate:SCALe:STATe?[(@<ch_list>)]
Description
ThiscommanddisablesorenablesMx+Bscalingonthespecifiedchannels.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Scalingisappliedusingthefollowingequation:
ScaledReading=(GainxMeasurement)+Offset
Readingscanbeacquiredduringascanusingthemultiplexer.Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
Youmustconfigurethechannel(function,transducertype,etc.)beforeapplyinganyscalingvalues.Ifyouchangethemeasurementconfiguration,scalingisturnedoffonthatchannelandthegainandoffsetvaluesarereset(M=1andB=0).Scalingisalsoturnedoffwhenyouchangethetemperatureprobetype,temperatureunits,ordisabletheinternalDMM.
Ifyouchangethemeasurementconfiguration(function,transducertype,etc.)onachannel,scalingisturnedoffonthosechannelsandthegainandoffsetvaluesarecleared.
Ifyouplantousescalingonachannelwhichalsousesalarms,besuretoconfigurethescalingvaluesfirst.Ifyouattempttoassignthealarmlimitsfirst,theinstrumentwillturnoffalarmsandclearthelimitvalueswhenyouenablescalingonthatchannel.Ifyouspecifyacustommeasurementlabelwithscaling,itisautomaticallyusedwhenalarmsareloggedonthatchannel.
Ifyouredefinethescanlist,nochangewillbemadetothescalingstateorthegainandoffsetvalues.Ifyoudecidetoaddachannelbacktothescanlist,theoriginalgainandoffsetvaluesarerestored.
TheCONFigureandMEASure?commandsautomaticallydisablescalingonthespecifiedchannels.
AFactoryReset(*RSTcommand)turnsoffscalingandclearsthescalingvaluesonallchannels(gain=1,offset=0).AnInstrumentPreset(SYSTem:PRESetcommand)doesnotclearthescalingvaluesanddoesnotturnoffscaling.
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingprogramsegmentsetsgainandoffsetvaluesonchannels03and13inslot100andthenenablesscalingonthesechannels.
CALC:SCAL:GAIN1.25,(@103,113)
CALC:SCAL:OFFS10.125,(@103,113)
CALC:SCAL:STATON,(@103,113)
Thefollowingqueryreturnsthescalingsettingsonchannels03and13inslot100.
CALC:SCAL:STAT?(@103,113)
TypicalResponse:1,1
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:UNIT
CALCulate:SCALe:UNITSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALCulate:SCALe:UNIT<quoted_string>[,(@<ch_list>)]
CALCulate:SCALe:UNIT?[(@<ch_list>)]
Description
Thiscommandallowsyoutospecifythecustomlabelofuptothreecharacters(forexample,RPM,PSI)forscaledmeasurementsonthespecifiedchannels.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<quoted_string> QuotedASCIIString
AquotedASCIIstringofuptothreecharacters.Youcanuseletters(A-Z),numbers(0-9),anunderscore(_),orthe"#"characterwhichdisplaysadegreesymbol(°)onthefrontpanel(displayedasablankspaceinanoutputstringfromtheremoteinterface).Thefirstcharactermustbealetterorthe"#"character(the"#"characterisallowedonlyastheleftmostcharacterinthelabel).Theremainingtwocharacterscanbeletters,numbers,oranunderscore.
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemodulein
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
slot200andchannels02through08onthemoduleinslot300.
Remarks
Readingscanbeacquiredduringascanusingthemultiplexer.Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
Ifyousetthemeasurementlabelto°C,°F,orK,notethatthishasnoeffectthetemperatureunitssetusingtheUNIT:TEMPeraturecommand.
TheCONFigureandMEASure?commandsautomaticallyrevertstheunittothenaturalunitsforthefunction.
AFactoryReset(*RSTcommand)turnsoffscaling,clearsthescalingvalues(gain=1,offset=0),andautomaticallyrevertstheunittothenaturalunitsforthefunction.AnInstrumentPreset(SYSTem:PRESetcommand)doesnotclearthescalingvaluesormeasurementlabelsanddoesnotturnoffscaling.
ReturnFormat
ThequeryreadsthemeasurementunitsforeachchannelspecifiedandreturnsanASCIIstringenclosedindoublequotes.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandaddsthemeasurementlabel"RPM"(RevolutionsPerMinute)tochannels03and13inslot100.
CALC:SCAL:UNIT"RPM",(@103,113)orCALC:SCAL:UNIT
'RPM',(@103,113)
Thefollowingqueryreturnsthemeasurementlabelsassignedtochannels03and13inslot100.
CALC:SCAL:UNIT?(@103,113)
TypicalResponse:"RPM","RPM"
SeeAlsoCALCulateSubsystemIntroduction
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALibrationSubsystemIntroductionTheCALibrationcommandsareusedtocalibratetheKeysight34970A/34972A.Pleasenotethattheuseofthesecommandsrequiresadetailedknowledgeoftheappropriatecalibrationprocedures,whicharedescribedintheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
CommandSummaryCALibration?
CALibration:COUNt?
CALibration:SECure:CODE
CALibration:SECure:STATe
CALibration:SECure:STATe?
CALibration:STRing
CALibration:STRing?
CALibration:VALue
CALibration:VALue?
CALibration?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALibration?
Description
ThiscommandperformsacalibrationoftheinternalDMMorDACchannelonthe34907Amultifunctionmoduleusingthespecifiedcalibrationvalue(CALibration:VALuecommand).Beforeyoucancalibratetheinstrument,youmustunsecureitbyenteringthecorrectsecuritycode.
Foramoredetaileddiscussionofthecalibrationprocedures,seetheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
Remarks
Ifacalibrationfails,theinstrumentreturns1andgeneratesanerrormessage.Foracompletelistingoftheerrormessagesrelatedtocalibrationfailures,seeSCPIErrorMessages.
TheinternalDMMisanoptionalassemblyfortheKeysight34970A/34972A.TheinstrumentgeneratesanerrorwiththiscommandiftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
ThiscommandincrementsthecalibrationcountbyonecountfortheDMMandDACchannels(seeCALibration:COUNt?command).
ReturnFormat
Thequeryreturns0(calibrationpassed)or1(calibrationfailed).
Example
Thefollowingcommandperformsacalibrationandreturnsapass/failindication.
CAL?
TypicalResponse:0
SeeAlsoCALibration:SECure:STATe
CALibration:VALue
CALibration:COUNt?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALibration:COUNt?
Description
Thiscommandqueriestheinstrumenttodeterminethenumberoftimesithasbeencalibrated.Notethatyourinstrumentwascalibratedbeforeitleftthefactory.Whenyoureceiveyourinstrument,besuretoreadthevariouscountstodetermineitsinitialvalue.
Foramoredetaileddiscussionofthecalibrationprocedures,seetheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
UsedWith:
InternalDMM
Remarks
Thecalibrationcountincrementsuptoamaximumof65,535,afterwhichitrollsoverto0.Becausethevalueincrementsbyoneforeachcalibrationpoint,acompletecalibrationmayincreasethevaluebymanycounts.
ThemainframecalibrationcountisincrementedbytheCALibration?command(themainframemustbeunsecured;seeCALibration:SECure:STATeOFFcommand).Youcanreadthecalibrationcountregardlessofwhethertheinstrumentissecured.
ThecalibrationcountisalsoincrementedbycalibrationsoftheDACchannelsonthe34907Amultifunctionmodule.
Thecalibrationcountisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsthecalibrationcountindicatinghowmanycalibrationshavebeenperformed.
Example
Thefollowingqueryreturnsthecalibrationcount.
CAL:COUN?
TypicalResponse:+273
SeeAlsoCALibrationSubsystemIntroduction
CALibration?
CALibration:SECure:STATe
CALibration:SECure:CODESyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CALibration:SECure:CODE<new_code>
Description
Thiscommandallowsyoutoenteranewsecuritycodetopreventaccidentalorunauthorizedcalibrations.Thespecifiedcodeisusedtounsecurethemainframeandallinstalledmodules.Tochangethesecuritycode,youmustfirstunsecuretheinstrumentusingtheoldsecuritycode,andthenenteranewcode.
Foramoredetaileddiscussionofthecalibrationprocedures,seetheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
UsedWith:
InternalDMM
Parameters
Name Type RangeofValues
DefaultValue
<new_code> ASCIIString
Astringofupto12characters.Youdonothavetouseall12charactersbutthefirstcharactermustalwaysbealetter(A-Z).Theremaining11characterscanbeletters,numbers(0-9),ortheunderscorecharacter("_").Blankspacesarenotallowed.
Thisisarequiredparameter.
RemarksThesecuritycodeissetto"HP034970"or"AT034972",dependingontheproductnumber,whentheinstrumentisshippedfromthefactory.Notethatthethirdcharacterofthesecuritycodeisazero(0)andnotacapitalO.
Ifyouforgetyoursecuritycode,youcanoverridethesecurityfeature.SeetheKeysight34970A/34972AServiceGuideformoreinformation.
Thesecuritycodeisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
Example
Thefollowingcommandsetsanewcalibrationsecuritycode(theinstrumentmustbeunsecured).
CAL:SEC:CODET3ST_DUT165
SeeAlsoCALibrationSubsystemIntroduction
CALibration:SECure:STATe
CALibration:SECure:STATeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALibration:SECure:STATe<state>,<code>
CALibration:SECure:STATe?
Description
Thiscommandunsecuresorsecurestheinstrumentforcalibration.Thisfeaturerequiresyoutoprovideasecuritycodetopreventaccidentalorunauthorizedcalibrationsoftheinstrument.Beforeyoucancalibratetheinstrument,youmustunsecureitbyenteringthecorrectsecuritycode.
Foramoredetaileddiscussionofthecalibrationprocedures,seetheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
UsedWith:
InternalDMM
Parameters
Name Type RangeofValues
DefaultValue
<state> Boolean {OFF|0|ON|1} ON
<code> StringAstringofupto12characters.Youdonothavetouseall12charactersbutthefirstcharactermustalwaysbealetter(A-Z).Theremaining11characterscanbeletters,numbers(0-9),ortheunderscorecharacter("_").Blankspacesarenotallowed.
Thisisarequiredparameter.
RemarksWhenyoufirstreceiveyourinstrument,itissecured,andthesecuritycodeissetto"HP034970"or"AT034972",dependingontheproductnumber.Notethatthethirdcharacterofthesecuritycodeisazero(0)andnotacapitalO.
Onceyouenterasecuritycode,thatcodemustbeusedforbothfront-panelandremoteoperation.Forexample,ifyousecuretheinstrumentfromthefrontpanel,youmustusethatsamecodetounsecureitfromtheremoteinterface.
UnsecuringtheinstrumentusingthiscommandenablestheinternalDMMtobecalibrated.
TocalibratetheinternalDMM,usetheCALibration?command.
Thecalibrationsecuritysettingisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON),indicatingthecurrentcalibrationsecuritysetting.
Examples
Thefollowingcommandunsecurestheinstrument.Notethatthe"HP034970"stringappliestothe34970A;the"AT034972"stringappliestothe34972A.
CAL:SEC:STATOFF,HP034970
Thefollowingqueryreturnsthecurrentcalibrationsecuritysetting.Inthiscase,itisOFF.
CAL:SEC:STAT?
TypicalResponse:0
SeeAlsoCALibrationSubsystemIntroduction
CALibration:SECure:CODE
CALibration:STRingSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALibration:STRing<quoted_string>
CALibration:STRing?
Description
Thiscommandallowsyoutostoreonemessageincalibrationmemoryinthemainframe.Forexample,youcanstoresuchinformationasthedatewhenthelastcalibrationwasperformed,thedatewhenthenextcalibrationisdue,theinstrument'sserialnumber,oreventhenameandphonenumberofthepersontocontactforanewcalibration.
Foramoredetaileddiscussionofthecalibrationprocedures,seetheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
UsedWith:
InternalDMM
Parameters
Name Type RangeofValues
DefaultValue
<quoted_string> QuotedASCIIString
Astringofupto40charactersenclosedinquotes.Youcanuseletters(A-Z),numbers(0-9),andspecialcharacterslike"@","%","*",andsoon.
Thisisarequiredparameter.
RemarksYoucanrecordacalibrationmessageonlyfromtheremoteinterfaceandonlywhentheinstrumentisunsecured(seeCALibration:SECure:STATeOFFcommand).Youcanreadthemessagefromeitherthefront-panelorovertheremoteinterface.Youcanreadthecalibrationmessagewhethertheinstrumentissecuredorunsecured.
Thecalibrationmessagemaycontainupto40characters.Fromthefrontpanel,youcanviewonly13charactersofthemessageatatime.
Fromthefrontpanel,commas,periods,andsemicolonsshareadisplayspacewiththeprecedingcharacter,andarenotconsideredindividualcharacters.
Storingacalibrationmessagewilloverwriteanymessagepreviouslystoredinmemory.
Thecalibrationmessageisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset
(SYSTem:PRESetcommand).
ReturnFormat
ThequeryreturnsanASCIIstringenclosedindoublequotes.Ifnocalibrationmessagehasbeenspecified,anemptyquotedstring("")isreturned.
Examples
Thefollowingcommandstoresamessageincalibrationmemoryinthemainframe.
CAL:STR"CAL:18Aug2009"orCAL:STR'CAL:18
Aug2009'
Thefollowingqueryreturnsthemessagecurrentlystoredincalibrationmemoryinthemainframe(thequotesarealsoreturned).
CAL:STR?
TypicalResponse:"CAL:18Aug2009"
SeeAlsoCALibrationSubsystemIntroduction
CALibration:SECure:STATe
CALibration:VALueSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CALibration:VALue<value>
CALibration:VALue?
Description
ThiscommandspecifiesthevalueoftheknowncalibrationsignalasoutlinedinthecalibrationproceduresintheKeysight34970A/34972AServiceGuide.ThiscommandisusedforinternalDMMcalibrations.
Foramoredetaileddiscussionofthecalibrationprocedures,seetheKeysight34970A/34972AServiceGuide.PleaserefertothatguidebeforeattemptingtocalibratetheinstrumentasimproperuseoftheCALibrationcommandscanadverselyaffecttheaccuracyandreliabilityoftheinstrument.
Parameters
Name Type RangeofValues
DefaultValue
<value>Numeric
Desiredcalibrationsignalintheunitsspecifiedbythepresentmeasurementfunction.
Thisisarequiredparameter.
RemarksTheinternalDMMisanoptionalassemblyfortheKeysight34970A/34972A.TheinstrumentgeneratesanerrorwiththiscommandiftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
ReturnFormat
Thequeryreturnsthecalibrationvalueintheform+1.00000000E-01.
Examples
Thefollowingcommandsetscalibrationvalueto+10.001010volts.
CAL:VAL10.001010
Thefollowingqueryreturnsthepresentcalibrationvalue.
CAL:VAL?
TypicalResponse:+1.00101000E+01
SeeAlsoCALibrationSubsystemIntroduction
CALibration?
CONFigureSubsystemIntroductionTheCONFigurecommandsprovidethemostflexiblewaytoprogramtheinstrumentformeasurements.Whenyouexecutethesecommands,theinstrumentusesdefaultvaluesfortherequestedmeasurementconfiguration(liketheMEASure?command).However,themeasurementisnotautomaticallystartedandyoucanchangesomemeasurementattributesbeforeactuallyinitiatingthemeasurement.Thisallowsyoutoincrementallychangetheinstrument'sconfigurationfromthedefaultconditions.
UsetheINITiateorREAD?commandtoinitiatethemeasurement.
AMEASurecommandissimplyaCONFigurecommandfollowedbyaREAD?
Ifyouspecifya<ch_list>withoneofthesecommands,that<ch_list>overwritesthecurrentscanlist.
TheCONFigurecommandsarevalidonlywiththefollowingKeysight34970A/34972Aplug-inmoduleswhichcanbeconfiguredtobepartofascan.IftheinternalDMMisnotinstalledorisdisabled,thennoDMM-relatedconfigurationsareallowed.However,scanningisallowedonthedigitalinputandtotalizerchannelsevenwithouttheinternalDMM.
34901A 20-ChannelArmatureMultiplexer(2-wireor4-wire)
34902A 16-ChannelReedMultiplexer(2-wireor4-wire)
34907A MultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A 40-ChannelArmatureMultiplexer(2-wireonly)
CommandSummaryCONFigure?
CONFigure:CURRent:AC
CONFigure:CURRent:DC
CONFigure:DIGital:BYTE
CONFigure:FREQuency
CONFigure:FRESistance
CONFigure:PERiod
CONFigure:RESistance
CONFigure:TEMPerature
CONFigure:TOTalize
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
CONFigure?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure?[(@<ch_list>)]
Description
Thisqueryreturnsthepresentconfigurationonthespecifiedchannelsandreturnsaseriesofquotedstrings.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalI/Oonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
IftheinternalDMMisnotinstalledorisdisabled,thennoDMM-relatedconfigurationsareallowed.However,scanningisallowedonthedigitalinputandtotalizerchannelsevenwithouttheinternalDMM.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
ReturnFormat
Thequeryreturnsaseriesofcomma-separatedfieldsindicatingthepresentfunction,range,andresolutionforthespecifiedchannels.Multipleresponsesareseparatedbycommas.Theshortformofthefunctionnameisalwaysreturned(e.g.,"CURR:AC","FREQ",etc.).
Example:MultiplexerChannel
Example:DigitalI/OChannel
Example:TotalizerChannel
Examples
Thefollowingprogramsegmentconfiguresmultiplexerchannels03and08inslot100andthenreadsbacktheconfiguration(thequotesarealsoreturned).
CONF:RES1000,1,(@103)
CONF:TEMPTHER,5000,1,0.1,(@108)
CONF?(@103,108)
TypicalResponse:"RES+1.000000E+03,+1.000000E-01","TEMPTHER,5000,+1.000000E+00,+1.000000E-04"
Thefollowingqueryreturnsthepresentconfigurationofeverychannelinthescanlist.
CONF?
SeeAlsoCONFigureSubsystemIntroduction
CONFigure:CURRent:ACCONFigure:CURRent:DCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure:CURRent:AC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:CURRent:DC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
ThesecommandsconfigurethechannelsforACorDCcurrentmeasurementsbutdonotinitiatethescan.
TheCONFigurecommanddoesnotplacetheinstrumentinthe"wait-for-trigger"state.UsetheINITiateorREAD?commandinconjunctionwithCONFiguretoplacetheinstrumentinthe"wait-for-trigger"state.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module(channels21and22only)
Parameters
Name Type RangeofValues DefaultValue
<range> NumericExpectedvalueinamps(rangesshownbelow).
10mA(MIN)100mA1A(MAX)
AUTO
<resolution> Numeric Desiredresolutioninamps. Fixedat6½digits
<scan_list> ScanList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthe
Thisisarequiredparameter.
firstdigitoftheslotnumber.
Remarks
Whenyouspecifyarangeofchannelswiththiscommand,anychannelsthatareinvalidwillbeignored(noerrorwillbegenerated)butthefirstandlastchannelintherangemustbevalidfortheselectedfunction.
Youcanallowtheinstrumenttoautomaticallyselectthemeasurementrangeusingautorangingoryoucanselectafixedrangeusingmanualranging.Autorangingisconvenientbecausetheinstrumentdecideswhichrangetouseforeachmeasurementbasedontheinputsignal.Forfastestscanningoperation,usemanualrangingoneachmeasurement(someadditionaltimeisrequiredforautorangingsincetheinstrumenthastomakearangeselection).
Ifyouselectautoranging(byspecifying"AUTO"or"DEF"),anerrorwillbegeneratedifyouspecifyadiscretevalueforthe<resolution>parameter.Whenautorangingiscombinedwithadiscreteresolution,theinstrumentcannotaccuratelyresolvetheintegrationtime(especiallyiftheinputsignaliscontinuouslychanging).Ifyourapplicationrequiresautoranging,besuretospecify"AUTO"forthe<resolution>parameteroromittheparameterfromthecommand.
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Becausethiscommandresetsallmeasurementparametersonthespecifiedchannelstotheirdefaultvalues,besuretosendtheCONFigurecommandbeforesettinganyothermeasurementparameters.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverload
indication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
ForACmeasurements,theresolutionisfixedat6½digits.TheonlywaytocontrolthereadingrateforACmeasurementsisbychangingthechanneldelayorbysettingtheACfiltertothehighestfrequencylimit.The<resolution>parameteronlyaffectsthenumberofdigitsshownonthefrontpanel.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Examples
ThesecommandsshowtheCONFigure:CURRent:ACcommand.Ineachcase,youcouldsubstitutetheCONFigure:CURRent:DCcommandandtheexamplewouldbevalid.
ThefollowingprogramsegmentconfigurestheinstrumentforACcurrentmeasurementsonchannel21inslot100.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.
CONF:CURR:AC(@121)
ROUT:SCAN(@121)
READ?
TypicalResponse:+8.54530000E-02
ThefollowingprogramsegmentconfigurestheinstrumentforanACcurrentmeasurementonchannels21and22inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.The1Arangeisselectedwith200mAresolution.
CONF:CURR:AC1,0.2,(@121,122)
ROUT:SCAN(@121,122)
INIT
FETC?
TypicalResponse:+4.27150000E-02,+1.32130000E-03
SeeAlsoCONFigure?
FETCh?
INITiate
READ?
MEASure:CURRent:AC?
MEASure:CURRent[:DC]?
ROUTe:CHANnel:DELay
ROUTe:SCAN
[SENSe:]CURRent:AC:BANDwidth
CONFigure:DIGital:BYTESyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
CONFigure:DIGital:BYTE(@<scan_list>)
Description
Thiscommandconfigurestheinstrumenttoscanthespecifieddigitalinputchannelsonthemultifunctionmoduleasbytedata,butdoesnotinitiatethescan.Thiscommandredefinesthescanlist.
UsedWith:
34907AMultifunctionModule(digitalinputonly)
Parameters
Name Type RangeofValues DefaultValue
<scan_list> Scanlist Oneormoredigital
I/Ochannels,asshown:
(@301)-channel01onthemoduleinslot300.
(@101:102,201,302)-channels01and02onthemodulesonslot100,channel01onthemoduleinslot200,andchannel02onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Thedigitalinputchannelsarenumbered"s01"(LSB)and"s02"(MSB),wheresisthefirstdigitoftheslotnumber.
Notethatifyouincludebothdigitalinputchannelsinthescanlist,theinstrumentwillreaddatafrombothportssimultaneouslywiththesametimestamp.Thisallowsyoutoexternallycombinethetwo8-bitvalueintoone16-bitvalue.
Example
Thefollowingcommandconfigurestheinstrumenttoscanchannels01and02onslot100asbytedata.
CONF:DIG:BYTE(@101:102)
SeeAlsoCONFigureSubsystemIntroduction
CONFigure:FREQuencyCONFigure:PERiodSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure:FREQuency[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:PERiod[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
Thesecommandsconfigurethechannelsforfrequencyorperiodmeasurements,buttheydonotinitiatethescan.
TheCONFigurecommanddoesnotplacetheinstrumentinthe"wait-for-trigger"state.UsetheINITiateorREAD?commandinconjunctionwithCONFiguretoplacetheinstrumentinthe"wait-for-trigger"state.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<range> NumericExpectedvalueinHz(frequency)orseconds(period).Validvaluesrangefrom3Hzto300kHz,andtheirinverses(forperiod).
Forfrequencyandperiodmeasurements,thisparameterisonlyusedinconjunctionwiththe<resolution>parametertosetthegatetime.Itisotherwiseunnecessaryforfrequencyandperiodmeasurements.
AUTO
<resolution> Numeric DesiredresolutioninHz(frequency)orseconds(period).
0.000003xRange(1PLC)
<scan_list> ScanList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
Thisisarequiredparameter.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Remarks
Whenyouspecifyarangeofchannelswiththiscommand,anychannelsthatareinvalidwillbeignored(noerrorwillbegenerated)butthefirstandlastchannelintherangemustbevalidfortheselectedfunction.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Examples
Thefollowingprogramsegmentconfigurestheinstrumentforfrequencymeasurementsonchannel04inslot300.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.
CONF:FREQ(@304)
ROUT:SCAN(@304)
READ?
TypicalResponse:+1.32130000E+03
Thefollowingprogramsegmentconfigurestheinstrumentforfrequencymeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.
CONF:FREQ100,(@103,108)
ROUT:SCAN(@103,108)
INIT
FETC?
TypicalResponse:+4.27150000E+03,+1.32130000E+03
Thefollowingprogramsegmentconfigureschannel10onthemoduleinslot300forafrequencymeasurement.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,initiatesatrigger,andthen
sendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.
CONF:FREQ(@310)
READ?
TypicalResponse:+10.13240000E+03
SeeAlsoCONFigure?
FETCh?
INITiate
MEASure:FREQuency?
MEASure:PERiod?
READ?
ROUTe:SCAN
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
CONFigure:RESistanceCONFigure:FRESistanceSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure:RESistance[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:FRESistance[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
Thesecommandsconfigurethechannelsfor2-wire(RESistance)or4-wire(FRESistance)resistancemeasurementsbutdonotinitiatethescan.
TheCONFigurecommanddoesnotplacetheinstrumentinthe"wait-for-trigger"state.UsetheINITiateorREAD?commandinconjunctionwithCONFiguretoplacetheinstrumentinthe"wait-for-trigger"state.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(doesnotsupport4-wiremeasurement)
Parameters
Name Type RangeofValues DefaultValue
<range> NumericExpectedvalueinohms,upto100MW.
AUTO
<resolution> Numeric Desiredresolutioninohms. 0.000003xRange(1PLC)
<scan_list> ScanList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
FortheFRESistanceversionofthiscommand,channelnispairedwithchanneln+10(34901A)orn+8(34902A)toprovidesourceandsenseconnections.
Whenyouspecifyarangeofchannelswiththiscommand,anychannelsthatareinvalidwillbeignored(noerrorwillbegenerated)butthefirstandlastchannelintherangemustbevalidfortheselectedfunction.
Youcanallowtheinstrumenttoautomaticallyselectthemeasurementrangeusingautorangingoryoucanselectafixedrangeusingmanualranging.Autorangingisconvenientbecausetheinstrumentdecideswhichrangetouseforeachmeasurementbasedontheinputsignal.Forfastestscanningoperation,usemanualrangingoneachmeasurement(someadditionaltimeisrequiredforautorangingsincetheinstrumenthastomakearangeselection).
Ifyouselectautoranging(byspecifying"AUTO"or"DEF"),anerrorwillbegeneratedifyouspecifyadiscretevalueforthe<resolution>parameter.Whenautorangingiscombinedwithadiscreteresolution,theinstrumentcannotaccuratelyresolvetheintegrationtime(especiallyiftheinputsignaliscontinuouslychanging).Ifyourapplicationrequiresautoranging,besuretospecify"AUTO"forthe<resolution>parameter,oromittheparameterfromthecommandandusethe[SENSe:]VOLTage[:DC]NPLCcommandtospecifythedesiredintegrationtime.
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Sincethesecommandsresetallmeasurementparametersonthe
specifiedchannelstotheirdefaultvalues,besuretosendtheCONFigurecommandbeforesettinganyothermeasurementparameters.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Examples
Thefollowingprogramsegmentconfigurestheinstrumentfor2-wireresistancemeasurementsonchannel04inslot300.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(1PLC)areusedforthemeasurement.
CONF:RES(@304)
ROUT:SCAN(@304)
READ?
TypicalResponse:+1.32130000E+04
Thefollowingprogramsegmentconfigurestheinstrumentfor2-wireresistancemeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.The1kΩrangeisselectedwith1Ωresolution.
CONF:RES1000,1,(@103,108)
ROUT:SCAN(@103,108)
INIT
FETC?
TypicalResponse:+4.27150000E+02,+1.32130000E+02
Thefollowingprogramsegmentconfigurestheinstrumentfor4-wireresistancemeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,
scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.The1kΩrangeisselectedwith1Ωresolution.
CONF:FRES1000,1,(@301,302)!Notethatfora4-wire
measurement,channels
!301and302are
automaticallypairedwith
!311and312,
respectively(34901Amodule).
ROUT:SCAN(@301,302)
INIT
FETC?
TypicalResponse:+4.27150000E+02,+1.32130000E+02
SeeAlsoCONFigureSubsystemIntroduction
CONFigure?
FETCh?
INITiate
MEASure:RESistance?
MEASure:FRESistance?
READ?
ROUTe:SCAN
[SENSe:]RESistance:OCOMpensated
CONFigure:TEMPeratureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure:TEMPerature{<probe_type>|DEF},{<type>|DEF}[,1[,{<resolution>|MIN|MAX|DEF}]],(@<scan_list>)
Description
Thesecommandsconfigurethechannelsfortemperaturemeasurementsbutdonotinitiatethescan.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
TheCONFigurecommanddoesnotplacetheinstrumentinthe"wait-for-trigger"state.UsetheINITiateorREAD?commandinconjunctionwithCONFiguretoplacetheinstrumentinthe"wait-for-trigger"state.
Thefollowingtableshowswhichtemperaturetransducersaresupportedbyeachofthemultiplexermodules.
Module Thermocouple RTD2-
Wire
RTD4-
Wire
Thermistor
34901AArmatureMultiplexer
Yes Yes Yes Yes
34902AReedMultiplexer
Yes Yes Yes Yes
34908AArmatureMultiplexer(1-Wire)
NotRecommended1
Yes No Yes
1Withaone-wiremultiplexer,evenverysmallgroundcurrentscanintroducesubstantialmeasurementerror.
Parameters
Name Type RangeofValues DefaultValue
<probe_type> Discrete{TCouple|RTD|FRTD|THERmistor|DEF}
TCouple
<type> DiscreteForTCouple:
{B|E|J|K|N|R|S|T}
ForRTD {85|91}ForFRTD {85|91}ForTHERmistor {2252|5000|10000}
ForTCouple:
ForRTDForFRTDForTHERmistor
<resolution> Numeric TheresolutionindegreesCelsius,Fahrenheit,orKelvin.ThetemperaturescaleinuseisspecifiedbytheUNIT:TEMPeraturecommand.
1PLC
<scan_list> ScanList Oneormorechannels,asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Fortemperaturemeasurements,theinstrumentinternallyselectstherange;youcannotselectwhichrangeisused.Inthecommandsyntax,besuretoinclude"1"asshownforthe<range>parameter(precedingthe<resolution>parameter).
ForRTDandFRTDmeasurements,use"85"tospecifya=0.00385or"91"tospecifya=0.00391.Notethatthiscommandalsoredefinesthescanlist.Thedefault(DEF)typeis"85"(a=0.00385).
Whenyouspecifyarangeofchannelswiththiscommand,anychannelsthatareinvalidwillbeignored(noerrorwillbegenerated)butthefirstandlastchannelintherangemustbevalidfortheselectedfunction.
Forthermocouplemeasurements,theinstrumentinternallyselectsthe100mVrange.ForthermistorandRTDmeasurements,theinstrumentautorangestothecorrectrangeforthetransducerresistancemeasurement.Specifythepairedchannelinthelowerbank(source)asthe<ch_list>channel.
Thermocouplemeasurementsrequireareferencejunctiontemperature(see[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPEcommand).Forthereferencejunctiontemperature,youcanuseaninternalmeasurementonthemodule'sterminalblock(34901Aonly),anexternalthermistororRTDmeasurement,oraknownfixedjunctiontemperature.Ifyouselectanexternalreference,theinstrumentmakesthermocouplemeasurementsrelativetoapreviously-storedRTDorthermistormeasurementstoredinthereferenceregister.
Bydefault,afixedreferencejunctiontemperatureof0.0°Cisused(see[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction
command).
Ifyouselectautoranging(byspecifying"AUTO"or"DEF"),anerrorwillbegeneratedifyouspecifyadiscretevalueforthe<resolution>parameter.Whenautorangingiscombinedwithadiscreteresolution,theinstrumentcannotaccuratelyresolvetheintegrationtime(especiallyiftheinputsignaliscontinuouslychanging).Ifyourapplicationrequiresautoranging,besuretospecify"DEF"forthe<resolution>parameter,oromittheparameterfromthecommandandusethe[SENSe:]TEMPerature:NPLCcommandtospecifythedesiredintegrationtime.
Sincethiscommandresetsallmeasurementparametersonthespecifiedchannelstotheirdefaultvalues,besuretosendtheCONFigurecommandbeforesettinganyothermeasurementparameters.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
Becausechannelsareautomaticallypairedfor4-wireresistancemeasurements(seepreviousRemark),attemptstore-configurethepairedchannelinBank2willresultinanerror.Forexample:
CONF:VOLT:DC(@105)!ConfigureBank2channelfor
DCvoltagemeasurements
ROUT:SCAN(@101:110)!Addchannelstoscanlist
CONF:FRES(@101)!Generateserrorandclears
scanlist
For4-wireRTDmeasurements,theinstrumentautomaticallyenablestheautozerofunction.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Examples
ThefollowingprogramsegmentconfigurestheinstrumentforB-typethermocouplemeasurementsonchannel04inslot300.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultresolution(fixedat6½digits)isusedforthemeasurement(assumesdefaulttemperatureunits).
CONF:TEMPTC,B,(@304)
ROUT:SCAN(@304)
READ?
TypicalResponse:+3.65640000E+01
Thefollowingprogramsegmentconfigurestheinstrumentfor5kΩthermistormeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.This2-wiremeasurementismadewith0.1°Cresolution(assumesdefaulttemperatureunits).
CONF:TEMPTHER,5000,1,0.1,(@103,108)
ROUT:SCAN(@103,108)
INIT
FETC?
TypicalResponse:+2.47150000E+01,+3.12130000E+01
Thefollowingprogramsegmentconfiguresthecurrentscanlistfora2-wireRTDmeasurement(no<ch_list>isspecified).TheREAD?
commandplacestheinstrumentinthe"wait-for-trigger"state,initiatesatrigger,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultresolution(fixedat6½digits)isusedforthemeasurement(assumesdefaulttemperatureunits).
CONF:TEMPRTD,85(@203)
READ?
TypicalResponse:+2.12320000E+01
SeeAlsoCONFigure?
FETCh?
INITiate
MEASure:TEMPerature?
READ?
ROUTe:SCAN
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
UNIT:TEMPerature
CONFigure:TOTalizeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure:TOTalize<mode>,(@<scan_list>)
Description
Thiscommandconfigurestheinstrumenttoreadthespecifiedtotalizerchannelsonthemultifunctionmodulebutdoesnotinitiatethescan.Toreadthetotalizerduringascanwithoutresettingthecount,setthe<mode>toREAD.Toreadthetotalizerduringascanandresetthecountto0afteritisread,setthe<mode>toRRESet(thismeans"readandreset").
TheCONFigurecommanddoesnotplacetheinstrumentinthe"wait-for-trigger"state.UsetheINITiateorREAD?commandinconjunctionwithCONFiguretoplacetheinstrumentinthe"wait-for-trigger"state.
UsedWith:
34907AMultifunctionModule(totalizechannelonly)
Parameters
Name Type RangeofValues DefaultValue
<mode> Discrete {READ|RRESet} READ
<scan_list> ScanList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Thisisarequiredparameter.
Remarks
Thetotalizerchannelisalwaysoftheforms03,wheresisthefirstdigitoftheslotnumber.
Themaximumcountis67,108,863(226-1).Thecountrollsoverto0afterreachingthemaximumallowedvalue.
Ifthecountrollsoverto0,the"TotalizerOverflow"bit(bit11)issetintheQuestionableDataregister.FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
SelectingtheRRESetmodeperformsasynchronizedreadandresetoperationonthespecifiedtotalizerchannels.Ifyouweretousediscretecommands,suchasREAD?and[SENSe:]TOTalize:CLEar:IMMediate,youwouldlikelylosecountsoccurringbetweenthetwocommands.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Examples
Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot200tobereadwithoutresettingitscount.
CONF:TOTREAD,(@203)
Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot300toberesetto0afteritisread.
CONF:TOTRRES,(@303)
SeeAlsoCONFigureSubsystemIntroduction
CONFigure?
FETCh?
INITiate
READ?
[SENSe:]TOTalize:DATA?
CONFigure:VOLTage:ACCONFigure:VOLTage:DCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
CONFigure:VOLTage:AC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:VOLTage:DC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
Thesecommandsconfigurethechannelsinthe<scan_list>forACorDCvoltagemeasurementsbutdonotinitiatethescan.
TheCONFigurecommanddoesnotplacetheinstrumentinthe"wait-for-trigger"state.UsetheINITiateorREAD?commandinconjunctionwithCONFiguretoplacetheinstrumentinthe"wait-for-trigger"state.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<range> NumericExpectedvalueinvolts
AUTO
<resolution> Numeric Desiredresolutioninvolts. 0.000003xRange(1PLC)
<scan_list> ScanList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Whenyouspecifyarangeofchannelswiththiscommand,anychannelsthatareinvalidwillbeignored(noerrorwillbegenerated)butthefirstandlastchannelintherangemustbevalidfortheselectedfunction.
Youcanallowtheinstrumenttoautomaticallyselectthemeasurementrangeusingautorangingoryoucanselectafixedrangeusingmanualranging.Autorangingisconvenientbecausetheinstrumentdecideswhichrangetouseforeachmeasurementbasedontheinputsignal.Forfastestscanningoperation,usemanualrangingoneachmeasurement(someadditionaltimeisrequiredforautorangingsincetheinstrumenthastomakearangeselection).
Ifyouselectautoranging(byspecifying"AUTO"or"DEF"),anerrorwillbegeneratedifyouspecifyadiscretevalueforthe<resolution>parameter.Whenautorangingiscombinedwithadiscreteresolution,theinstrumentcannotaccuratelyresolvetheintegrationtime(especiallyiftheinputsignaliscontinuouslychanging).Ifyourapplicationrequiresautoranging,besuretospecify"AUTO"forthe<resolution>parameteroromittheparameterfromthecommand.
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Becausethiscommandresetsallmeasurementparametersonthespecifiedchannelstotheirdefaultvalues,besuretosendtheCONFigurecommandbeforesettinganyothermeasurementparameters.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverload
indication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
ForACmeasurements,theresolutionisfixedat6½digits.TheonlywaytocontrolthereadingrateforACmeasurementsisbychangingthechanneldelayorbysettingtheACfiltertothehighestfrequencylimit.The<resolution>parameteronlyaffectsthenumberofdigitsshownonthefrontpanel.
The*RSTcommandwillclearthescanlistandsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)willnotclearthescanlist;however,thiscommandwillclearreadingmemoryandallstoredstatisticaldata.
Examples
ThesecommandsshowtheCONFigure:VOLTage:ACcommand.Ineachcase,youcouldsubstitutetheCONFigure:VOLTage:DCcommandandtheexamplewouldbevalid.
ThefollowingprogramsegmentconfigurestheinstrumentforACvoltagemeasurementsonchannel04inslot300.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.
CONF:VOLT:AC(@304)
ROUT:SCAN(@304)
READ?
TypicalResponse:+1.86850000E-03
ThefollowingprogramsegmentconfigurestheinstrumentforACvoltagemeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.The1Vrangeisselected.
CONF:VOLT:AC1,(@103,108)
ROUT:SCAN(@103,108)
INIT
FETC?
TypicalResponse:+4.27150000E-03,+1.32130000E-03
Thefollowingprogramsegmentconfigureschannel10onthemoduleinslot300foranACvoltagemeasurement.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,initiatesatrigger,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.
CONF:VOLT:AC(@310)
READ?
TypicalResponse:+1.26360000E-02
SeeAlsoCONFigureSubsystemIntroduction
CONFigure:CURRent:AC
CONFigure?
FETCh?
INITiate
MEASure[:VOLTage]:AC?
MEASure[:VOLTage][:DC]?
READ?
ROUTe:CHANnel:DELay
ROUTe:SCAN
[SENSe:]VOLTage:AC:BANDwidth
DATASubsystemIntroduction
CommandSummaryDATA:LAST?
DATA:POINts?
DATA:POINts:EVENt:THReshold
DATA:POINts:EVENt:THReshold?
DATA:REMove?
DATA:LAST?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DATA:LAST?[<num_rdgs>,](@<channel>)
Description
Thisqueryreturnsthemostrecentreadingorreadingstakenonthespecifiedchannelduringthescan.
Parameters
Name Type RangeofValues
DefaultValue
<num_rdgs> Numeric Anintegerfrom1tothenumberofreadingsstoredinmemoryforthespecified<channel>.
1
<channel> ChannelAsinglechannel,specifiedasinthefollowingexamples.
(@310)-channel10onthemoduleinslot300.
(@214)-channel14onthemoduleinslot200.
Thisisarequiredparameter.
Remarks
Thequeryreturnsthereadingsinorder,startingwiththeearliestreadinginthegroupofrecentreadings.Ifyouspecifymorereadingsthanarecurrentlystoredinmemory,theinstrumentgeneratesanerrormessage.
Readingscanbeacquiredduringascanusingthemultiplexerordigitalmodules.
Eachreadingisreturnedwithsomecombinationofmeasurementunits,timestamp,channelnumber,andalarmstatusinformation,dependingonthesettingssetbytheFORMat:READingcommands.Thetimestampiseitherinrelativeformat(timeinsecondssincethebeginningofthescan)orabsoluteformat(timeofdaywithdate,basedontheinstrument'sclockassetbytheSYSTem:DATEandSYSTem:TIMEcommands).ThechoiceofabsoluteandrelativetimeisdeterminedbytheFORMat:READing:TIME:TYPEcommand.
ReturnFormat
Thequeryreturnsthespecifiednumberofreadingsforthespecifiedchannel(ortheinternalDMM).Ifnodataisavailableforthespecifiedchannel,thequeryreturns0foreachfield.
Forexample:
1ReadingwithUnits(26.195°C) 4ChannelNumber 2Date(November21,2004) 5AlarmLimitThresholdCrossed(0
=NoAlarm,1=LO,2=HI) 3TimeofDay(3:30:23.000PM)
Example
Thefollowingqueryreturnsthelastreadingonchannel08inslot100.
DATA:LAST?(@108)
TypicalResponse:+1.84280000E-05VDC,2004,11,21,14,54,33.104,108,0
SeeAlsoDATASubsystemIntroduction
FORMatSubsystemIntroduction
SYSTem:DATE
SYSTem:TIME
DATA:POINts?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DATA:POINts?
Description
Thisqueryreturnsthetotalnumberofreadingscurrentlystoredinreadingmemoryfromascan.
Remarks
Youcanreadthecountatanytime,evenduringascan.
Youcanstoreatleast50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,abitintheSTATus:QUEStionable:CONDition?registerissetandnewreadingswilloverwritethefirst(oldest)readingsstored.Themostrecentreadingsarealwayspreserved.Readingmemoryisnotclearedwhenyoureadit.
Thequestionablestatusbitwillbeclearedwhenmemoryiscleared.ThequestionablestatusbitwillnotbeclearedifmemoryisemptiedwithDATA:REMove?orR?.
Theinstrumentclearsallreadingsfrommemorywhenanewscanisinitiated,whenanymeasurementparametersarechanged(CONFigureandSENSecommands),andwhenthetriggeringconfigurationischanged(TRIGgercommands).
TheinstrumentclearsallreadingsfrommemoryafteraFactoryReset(*RSTcommand)orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsavaluebetween0and50,000asasignedinteger,indicatingthenumberofreadingscurrentlystoredinreadingmemory.
Example
Thefollowingqueryreturnsthenumberofreadingsinmemory.
DATA:POIN?
TypicalResponse:+320
SeeAlsoDATASubsystemIntroduction
DATA:REMove?
DATA:POINts:EVENt:THResholdSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
DATA:POINts:EVENt:THReshold<num_rdgs>
DATA:POINts:EVENt:THReshold?
Description
ThiscommandsetsabitintheStandardOperationRegistergroupeventregisterwhenthespecifiednumberofreadingshavebeenstoredinreadingmemoryfromascan.The"MemoryThreshold"bit(bit9)issettoa"1"intheeventregisterwhenthenumberofstoredreadingsisgreaterthanorequaltothespecifiedmemorythreshold.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Parameters
Name Type Rangeof
Values
DefaultValue
<num_rdgs> Numeric Anintegerfrom1to50,000
Thisisarequiredparameter.
Thefactorydefaultvalueis1.
Remarks
Toreportanysubsequentevents,thereadingcountmustfirstdropbelowtheprogrammedmemorythresholdbeforereachingthethresholdagain.UsetheR?orDATA:REMovecommandtoremovereadingsfrommemory.
Toenablethe"MemoryThreshold"bit(bit9)tobereportedtotheStatusByte,usetheSTATus:OPERation:ENABlecommand.
Oncethe"MemoryThreshold"bitisset,itwillremainsetuntilclearedbytheSTATus:OPERation[:EVENt]?commandor*CLS(clearstatus)command.
Theinstrumentresetsthememorythresholdto"1"afteraFactoryReset(*RSTcommand)orwhenmainframepoweriscycled.ThememorythresholdvalueisnotresetbytheSYSTem:PRESet,*CLS,orSTATus:PRESetcommand.
ReturnFormat
Thequeryreturnsthenumberofreadingscurrentlyspecifiedasthememorythresholdasasignedinteger.
Examples
Thefollowingcommandsetsthememorythresholdto125readings.
DATA:POIN:EVEN:THR125
Thefollowingqueryreadsthememorythresholdsetting.
DATA:POIN:EVEN:THR?
TypicalResponse:+125
SeeAlsoDATASubsystemIntroduction
STATus:OPERation:ENABle
DATA:REMove?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DATA:REMove?<num_rdgs>
Description
Thisqueryreadsandclearsthespecifiednumberofreadingsfromthenon-volatilememory.Thisallowsyoutocontinueascanwithoutlosingdatastoredinmemory(ifmemorybecomesfull,newreadingswilloverwritethefirstreadingsstored).Thespecifiednumberofreadingsareclearedfrommemory,startingwiththeoldestreading.
Parameters
Name Type RangeofValues
DefaultValue
<num_rdgs> Numeric Anintegerrepresentingthenumberofreadingstobereadanderasedfrommemory.
Thisisarequiredparameter.
Remarks
Youcanremovereadingsfrommemoryatanytime,evenduringascan.
Youcanstoreatleast50,000readingsinmemoryduringascan.Readingsarestoredonlyduringascan.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Inaddition,bit9issetintheQuestionableDataRegister'sconditionregister(seeStatusSystemIntroduction).
Iffewerthanthespecifiednumberofreadingsarecurrentlyinmemory,anerrorwillbegenerated.YoucanusetheDATA:POINts?querytodeterminethetotalnumberofreadingscurrentlyinmemory.
Eachreadingisreturnedwithsomecombinationofmeasurementunits,timestamp,channelnumber,andalarmstatusinformation,dependingonthesettingssetbytheFORMat:READingcommands.Thetimestampiseitherinrelativeformat(timeinsecondssincethebeginningofthescan)orabsoluteformat(timeofdaywithdate,basedontheinstrument'sclockassetbytheSYSTem:DATEandSYSTem:TIMEcommands).ThechoiceofabsoluteandrelativetimeisdeterminedbytheFORMat:READing:TIME:TYPEcommand.
Theinstrumentclearsallreadingsfrommemorywhenanewscanisinitiated,whenanymeasurementparametersarechanged(CONFigureandSENSecommands),andwhenthetriggeringconfigurationischanged(TRIGgercommands).
TheinstrumentclearsallreadingsfrommemoryafteraFactoryReset(*RSTcommand),afteranInstrumentPreset(SYSTem:PRESetcommand),orwhenmainframepoweriscycled.
ReturnFormat
Thequeryreturnsthespecifiednumberofreadings(withformattingassetbytheFORMat:READingcommands)andthenerasesthemfrommemory.Multipleresponsesareseparatedbycommas.
Example
Thefollowingqueryreturnsthreereadings(startingwiththeoldestreadingfirst)anderasesthemfrommemory.
DATA:REM?3
TypicalResponse:+4.27150000E+02,+1.32130000E+03,+3.65300000E+03
SeeAlsoDATASubsystemIntroduction
DATA:POINts?
FORMatSubsystemIntroduction
R?
DIAGnosticSubsystemIntroduction
CommandSummaryDIAGnostic:DMM:CYCLes?
DIAGnostic:DMM:CYCLes:CLEar
DIAGnostic:PEEK:SLOT:DATA?
DIAGnostic:POKE:SLOT:DATA
DIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
DIAGnostic:DMM:CYCLes?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DIAGnostic:DMM:CYCLes?
Description
ThisqueryreturnsthecyclecountofthethreebackplanerelaysontheinternalDMM.Theserelaysopenorclosewhenafunctionorrangeischangedonamodule.Thequeryreturnsthreenumbersindicatingthecyclecountonrelays1,2,and3(whichcorrespondtorelaysK102,K103,andK104respectively).
Remarks
TheinternalDMMisanoptionalassemblyfortheKeysight34970A/34972A.TheinstrumentgeneratesanerrorwiththiscommandiftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.
Toreadthecyclecountonthemultiplexerandswitchmodules,usetheDIAGnostic:RELay:CYCLes?command.
SeetheKeysight34970A/34972AServiceGuideforinformationonreplacingrelays.
ReturnFormat
ThequeryreturnsthecyclecountonthespecifiedinternalDMMrelay.
Example
Thefollowingqueryreturnsthecyclecountonthethreerelays.
DIAG:DMM:CYCL?
TypicalResponse:+58023,+57291,+66239
SeeAlsoDIAGnosticSubsystemIntroduction
DIAGnostic:DMM:CYCLes:CLEar
DIAGnostic:RELay:CYCLes?
DIAGnostic:DMM:CYCLes:CLEarSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DIAGnostic:DMM:CYCLes:CLEar{1|2|3}
Description
ThiscommandresetstherelaycyclecountonthespecifiedinternalDMMrelay.
Remarks
YoumustunsecuretheinstrumentwithCALibration:SECure:STATetoresetthecyclecount.
Example
ThefollowingcommandresetstherelaycyclecountoninternalDMMrelay2.
DIAGnostic:DMM:CYCLes:CLEar2
SeeAlsoDIAGnosticSubsystemIntroduction
DIAGnostic:DMM:CYCLes?
DIAGnostic:PEEK:SLOT:DATA?DIAGnostic:POKE:SLOT:DATASyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
DIAGnostic:PEEK:SLOT:DATA?{100|200|300}
DIAGnostic:POKE:SLOT:DATA{100|200|300},<quoted_string>
Description
ThePOKEcommandallowsyoutoaddacustomlabelofupto10characterstothemoduleinthespecifiedslot.Charactersbeyondthetenthcharacteraretruncated,andnoerrormessageisgenerated.ThePEEKqueryreturnsthelabelstring.
Parameters
Name Type RangeofValues
DefaultValue
<quoted_string> QuotedASCIIString
AquotedASCIIstringofupto10characters.
Thisisarequiredparameter.
Remarks
Onepossibleuseforthiscommandistoallowyoutodifferentiatebetweenmodulesofthesametypefromwithinyourprogram.
Thecustomlabelisstoredinnon-volatilememoryonthemodule.
YoumustunsecuretheinstrumentwithCALibration:SECure:STATeOFFbeforeyoucanstorethecustomlabel.
ReturnFormat
ThePEEKqueryreturnsthelabelstring.
Examples
Thefollowingcommandaddsalabeltothemoduleinslot200.
DIAG:POKE:SLOT:DATA200,"TestMod1"
Thefollowingqueryreturnsthelabelassociatedwithslot200.
DIAG:PEEK:SLOT:DATA?200
TypicalResponse:TestMod1
SeeAlsoDIAGnosticSubsystemIntroduction
DIAGnostic:RELay:CYCLes?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DIAGnostic:RELay:CYCLes?(@<ch_list>)
Description
Thisqueryreadsthecyclecountonthespecifiedchannels.Inadditiontothechannelrelays,youcanalsoquerythecountontheAnalogBusrelaysandbankrelays.
UsedWith:
Allmodulesexceptfor34907A
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,as
shown:
(@302)-channel12onthemoduleinslot300.
(@311:314)-channels11through14onthemoduleinslot300.
(@201:212,213,322:323,198)-channels1through12and13onthemoduleinslot200,channels22through23onthemoduleinslot300,andtreerelay98onthemoduleinslot100.
Thisisarequiredparameter.
RemarksOntheRFMultiplexermodules,eachbankconsistsoftwoleafrelaysandonetreerelay(seediagrambelow).Themodulestoresthecyclecountforeachofthethreerelaysonallfourbanks.TheDIAGnostic:RELay:CYCLes?queryalwaysreturnsthesamecountforchannels111and112,113and114,121and122,and123and124.
a. TheresetstateofthethreerelaysisshownaboveforBank1(aresetoperationselectsthelowestchannelwithinthebank).Thecyclecountforanyofthethreerelaysisincrementedwhenevertherelaytransitionsfromtheresetstate.Therefore,thecyclecountreflectsacompletetransitionoftherelayfrom,andbackto,theresetstate.For
example,closingChannel111willnotincrementtheleafrelaycyclecount,butclosingChannel112willincrementthecyclecount.
ToreadthecyclecountontherelaysassociatedwithfunctionselectionandisolationontheinternalDMM,usetheDIAGnostic:DMM:CYCLes?command.
SeetheKeysight34970A/34972AServiceGuideforinformationonreplacingrelays.
ReturnFormat
Thequeryreturnsthecyclecountforeachchannelspecified.Thevaluereturnedisbetween0and4,294,967,294(32-bitvalue).Multipleresponsesareseparatedbycommas.
Example
Thefollowingqueryreturnsthecyclecountonchannels03and13inslot100.
DIAG:REL:CYCL?(@103,113)
TypicalResponse:+76289,+11055
SeeAlsoDIAGnosticSubsystemIntroduction
DIAGnostic:DMM:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
DIAGnostic:RELay:CYCLes:CLEarSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DIAGnostic:RELay:CYCLes:CLEar(@<ch_list>)
Description
Thiscommandresetsthecyclecountonthespecifiedchannels.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifthisparameterisomitted,thecommandappliestothecurrentscanlist.
Remarks
Theinstrumentmustbeunsecuredinordertoresetthecyclecount.SeetheCALibration:SECure:STATecommandformoreinformationonunsecuringtheinstrument.
OntheRFMultiplexermodules(34905A,34906A),eachbankconsistsoftwoleafrelaysandonetreerelay(seeDIAGnostic:RELay:CYCLes?command).Clearingthecyclecountonaspecificchannelwillclearthecountonallthreerelaysinthecorrespondingbank.
Example
Thefollowingcommandclearsthecyclecountonchannels03and13inslot100.
DIAG:REL:CYCL:CLE(@103,113)
SeeAlsoDIAGnosticSubsystemIntroduction
CALibration:SECure:STATe
DIAGnostic:RELay:CYCLes?
DISPlaySubsystemIntroduction
CommandSummaryDISPlay
DISPlay?
DISPlay:TEXT
DISPlay:TEXT?
DISPlay:TEXT:CLEar
DISPlaySyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
DISPlay<state>
DISPlay?
Description
Thiscommanddisablesorenablestheinstrument'sfront-paneldisplay.Forsecurityreasonsorforaslightincreaseinmeasurementrates,youmaywanttoturnoffthefront-paneldisplay.Whendisabled,theentirefront-paneldisplaygoesdarkandalldisplayannunciatorsexceptERRORaredisabled.
Parameters
Name Type RangeofValues
DefaultValue
<state> Boolean {OFF|0|ON|1} ON
Remarks
AllkeysexceptLocalaredisabledwhenthedisplayisoff.
Youcandisablethefront-paneldisplayfromtheremoteinterfaceonly.
Sendingatextmessagetothedisplay(seeDISPlay:TEXTcommand)overridesthedisplaystate;thismeansthatyoucandisplayamessageevenifthedisplayisturnedoff.
Thefront-paneldisplayisautomaticallyenabledwhenpoweriscycled,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).ItisalsoenabledwhenyoupresstheLocalkey.TheOFFstateisrememberedifyoureturntoremote.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommanddisablesthefront-paneldisplay.
DISPOFF
Thefollowingqueryreturnsthefront-paneldisplaysetting.
DISP?
TypicalResponse:0
SeeAlsoDISPlaySubsystemIntroduction
DISPlay:TEXT
DISPlay:TEXTSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
DISPlay:TEXT<quoted_string>
DISPlay:TEXT?
Description
Thiscommanddisplaysatextmessageontheinstrument'sfront-paneldisplay.Theinstrumentcandisplayupto12charactersonthefrontpanel;anyadditionalcharactersaretruncated(noerrorisgenerated).
Parameters
Name Type RangeofValues
DefaultValue
<quoted_string> QuotedASCIIString
Astringofupto12charactersenclosedinquotationmarks.Youcanuseletters(A-Z),numbers(0-9),andspecialcharacterslike"@","%","*",andsoon.Use"#"charactertodisplayadegreesymbol(°).
Thisisarequiredparameter.
Remarks
Commas,periods,colons,andsemicolonsshareadisplayspacewiththeprecedingcharacter,andarenotconsideredindividualcharacters.
Whileamessageisdisplayedonthefrontpanel,readingsfromascanormonitorarenotsenttothefront-paneldisplay.
Sendingatextmessagetothedisplayoverridesthedisplaystate(seeDISPlay:STATecommand);thismeansthatyoucandisplayamessageevenifthedisplayisturnedoff.
Thedisplaytextisnotstoredaspartoftheinstrumentstatebythe*SAVcommand.
Thefront-paneldisplayisautomaticallyclearedwhenpoweriscycled,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
ThequeryreadsthemessagecurrentlydisplayedonthefrontpanelandreturnsanASCIIstringenclosedindoublequotes.Ifnomessageisdisplayed,anullstring("")isreturned.
Examples
Thefollowingcommandsdisplayamessageonthefrontpanel(thequotesarenotdisplayed).
DISP:TEXT"SCANNING..."orDISP:TEXT'SCANNING
...'
Thefollowingqueryreturnsthemessagecurrentlydisplayedonthefrontpanel(thequotesarealsoreturned).
DISP:TEXT?
TypicalResponse:"SCANNING..."
SeeAlsoDISPlaySubsystemIntroduction
DISPlay:TEXT:CLEar
DISPlay:TEXT:CLEarSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
DISPlay:TEXT:CLEar
Description
Thiscommandclearsthetextmessagedisplayedontheinstrument'sfront-paneldisplay(seeDISPlay:TEXTcommand).
Remarks
Clearingthetextmessagedoesnotoverridethedisplaystate(seeDISPlay:STATecommand);ifthedisplaywasdisabledpriortoclearingthetextmessage,thedisplaywillremaindisabled.
Thefront-paneldisplayisautomaticallyclearedwhenpoweriscycled,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
Example
Thefollowingcommandclearsthetextmessageonthefrontpanel.
DISP:TEXT:CLEAR
SeeAlsoDISPlaySubsystemIntroduction
DISPlay
DISPlay:TEXT
FORMatSubsystemIntroductionDuringascan,theinstrumentautomaticallyaddsatimestamptoallreadingsandstorestheminmemory.Eachreadingisalsostoredwithmeasurementunits,timestamp,channelnumber,andalarmstatusinformation.Youcanspecifywhichinformationyouwantreturnedwiththereadings(fromthefrontpanel,alloftheinformationisavailableforviewing).Thereadingformatappliestoallreadingsbeingremovedfromtheinstrumentfromascan;youcannotsettheformatonaper-channelbasis.Theexamplesbelowshowareadinginrelativeandabsoluteformatwithallfieldsenabled.
Notethatabsoluteformatshowsthetimeofdaywiththedate,andrelativetimeshowsthetimesincethestartofthescan.
RelativeFormat(Default):
1ReadingwithUnits(26.195°C)
3ChannelNumber
2ElapsedTime(17ms) 4AlarmLimitThresholdCrossed(0=NoAlarm,1=LO,2=HI)
AbsoluteFormat(Default):
1ReadingwithUnits(26.195°C)
4ChannelNumber
2Date(November21,2004) 5AlarmLimitThresholdCrossed(0=NoAlarm,1=LO,2=HI)
3TimeofDay(3:30:23.000PM)
TheFORMatcommandsarevalidonlywiththefollowingKeysight34970A/34972Aplug-inmodules,whichcanbeconfiguredtobepartofascan.TheinternalDMMmustalsobeinstalledandenabled.
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34903A20ChannelActuator/GPSwitchModule
34904A4x8Two-WireMatrixModule
34905A2GHzDual1:4RFMux,50OhmModule
34906A2GHzDual1:4RFMux,75OhmModule
34907AMultifunctionModule
34908A40ChannelSingle-EndedMultiplexerModule
CommandSummaryFORMat:READing:ALARm
FORMat:READing:ALARm?
FORMat:READing:CHANnel
FORMat:READing:CHANnel?
FORMat:READing:TIME
FORMat:READing:TIME?
FORMat:READing:TIME:TYPE
FORMat:READing:TIME:TYPE?
FORMat:READing:UNIT
FORMat:READing:UNIT?
FORMat:READing:ALARmSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
FORMat:READing:ALARm<state>
FORMat:READing:ALARm?
Description
ThiscommanddisablesorenablestheinclusionofalarminformationwithdataretrievedbytheREAD?command,theFETCh?command,andotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactoryresetvalueisOFF(disabled).
Remarks
Thereadingformatappliestoallreadingsbeingretrievedfromtheinstrument;youcannotsettheformatonaper-channelbasis.
TheCONFigureandMEASure?commandsautomaticallydisablethealarmsetting.
Thealarmsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommandenablestheinclusionofalarminformation.
FORM:READ:ALARON
Thefollowingqueryreturnsthealarmsetting.
FORM:READ:ALAR?
TypicalResponse:1
SeeAlsoFORMatSubsystemIntroduction
FORMat:READing:CHANnel
FORMat:READing:CHANnelSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
FORMat:READing:CHANnel<mode>
FORMat:READing:CHANnel?
Description
ThiscommanddisablesorenablestheinclusionofchannelnumberinformationwithdataretrievedbytheREAD?command,theFETCh?command,orotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultvalueisOFF(disabled).
Remarks
Thereadingformatappliestoallreadingsbeingretrievedfromtheinstrument;youcannotsettheformatonaper-channelbasis.
TheCONFigureandMEASure?commandsautomaticallydisablethechannelsetting.
Thechannelsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommandenablestheinclusionofchannelnumberinformation.
FORM:READ:CHANON
Thefollowingqueryreturnsthechannelnumbersetting.
FORM:READ:CHAN?
TypicalResponse:1
SeeAlsoFORMatSubsystemIntroduction
FORMat:READing:ALARm
FORMat:READing:TIME
FORMat:READing:UNIT
FORMat:READing:TIMESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
FORMat:READing:TIME<mode>
FORMat:READing:TIME?
Description
ThiscommanddisablesorenablestheinclusionofatimestampwithdataretrievedbytheREAD?command,theFETCh?command,orotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultvalueisOFF(disabled).
Remarks
Thereadingformatappliestoallreadingsbeingretrievedfromtheinstrument;youcannotsettheformatonaper-channelbasis.
Ifenabled,thetimestampinformationisshowneitherinabsolutetime(timeofdaywithdate)orrelativetime(timeinsecondssincestartofscan)assetbytheFORMat:READing:TIME:TYPEcommand.
TheCONFigureandMEASure?commandsautomaticallydisablethetimestampsetting.
Thetimestampsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommandenablestheinclusionofatimestamp.
FORM:READ:TIMEON
Thefollowingqueryreturnsthetimestampsetting.
FORM:READ:TIME?
TypicalResponse:1
SeeAlsoFORMatSubsystemIntroduction
FORMat:READing:ALARm
FORMat:READing:CHANnel
FORMat:READing:TIME:TYPE
FORMat:READing:UNIT
FORMat:READing:TIME:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
FORMat:READing:TIME:TYPE<format>
FORMat:READing:TIME:TYPE?
Description
ThiscommandselectsthetimeformatfortimestampsreturnedwhenFORMat:READing:TIMEisON.Youcanselectabsolutetime(timeofdaywithdate)orrelativetime(timeinsecondssincestartofscan).ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<format> Discrete {ABSolute|RELative} Thisisarequiredparameter.
ThefactorydefaultisRELative.
Remarks
Thereadingformatappliestoallreadingsbeingretrievedfromtheinstrument;youcannotsettheformatonaper-channelbasis.
Intermsofreadingstoreddatafrommemory,therelativeformatisconsiderablyfasterthantheabsoluteformat.
Theabsoluteformatisbasedontheinstrument'sreal-timeclockassetbytheSYSTem:DATEandSYSTem:TIMEcommands.
Thetimeformatsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).
ReturnFormat
ThequeryreturnsABSorREL.
Examples
Thefollowingcommandenablestheabsolutetimeformat(readingsarestoredwithtimeofdayanddateinformation).
FORM:READ:TIME:TYPEABSFORM:READ:TIMEON
Thefollowingqueryreturnsthetimeformatsetting.
FORM:READ:TIME:TYPE?
TypicalResponse:ABS
SeeAlsoFORMatSubsystemIntroduction
FORMat:READing:TIME
SYSTem:DATE
SYSTem:TIME
FORMat:READing:UNITSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
FORMat:READing:UNIT<mode>
FORMat:READing:UNIT?
Description
Thiscommanddisablesorenablestheinclusionofmeasurementunits(VAC,VDC,OHM,etc.)withdataretrievedbytheREAD?command,theFETCh?command,orotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultvalueisOFF(disabled).
Remarks
Thereadingformatappliestoallreadingsbeingretrievedfromtheinstrument;youcannotsettheformatonaper-channelbasis.
TheCONFigureandMEASure?commandsautomaticallydisabletheunitsetting.
Theunitsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommandenablestheinclusionofmeasurementunits.
FORM:READ:UNITON
Thefollowingqueryreturnsthemeasurementunitssetting.
FORM:READ:UNIT?
TypicalResponse:1
SeeAlso
FORMatSubsystemIntroduction
FORMat:READing:ALARm
FORMat:READing:CHANnel
FORMat:READing:TIME
FORMat:READing:TIME:TYPE
IEEE-488CommonCommandsIntroduction
CommandSummary*CLS
*ESE
*ESE?
*ESR?
*IDN?
*OPC
*OPC?
*PSC
*PSC?
*RCL
*RST
*SAV
*SRE
*SRE?
*STB?
*TRG
*TST?
*WAI
*CLSSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*CLS
Description
Thiscommand,whosenamederivesfromCLearStatus,clearstheeventregistersinallregistergroups.Italsoclearstheerrorqueueandthealarmqueue,butitdoesnotcleartheenableregisters.
Example
Thefollowingcommandclearstheeventregisterbits,alarmqueue,anderrorqueue.
*CLS
SeeAlsoIEEE-488CommonCommandsIntroduction
*ESR?
STATus:OPERation[:EVENt]?
STATus:QUEStionable[:EVENt]?
*ESESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
*ESE<enable_val>
*ESE?
Description
ThiscommandenablesbitsintheenableregisterfortheStandardEventRegistergroup.Theselectedbitsarethenreportedtobit5oftheStatusByteRegister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Parameters
Name Type RangeofValues
DefaultValue
<enable_val> Numeric Thedecimalvalueequaltothebinary-weightedsumofthebitsintheregister(seetablebelow).
Thisisarequiredparameter.
Remarks
ThefollowingtableliststhebitdefinitionsfortheStandardEventRegister.
Bit#
BitName DecimalValue
Definition
0 OperationComplete
1 Allcommandspriortoandincluding*OPChavebeenexecuted.
1 NotUsed NotUsed 0isreturned.
2 QueryError 4 Theinstrumenttriedtoreadtheoutputbufferbutitwasempty.Or,anewcommandlinewasreceivedbeforeapreviousqueryhasbeenread.Or,boththeinputandoutputbuffersarefull.
3 DeviceError 8 Adevice-specificerrorhasbeengenerated.Foracompletelistingoftheerrormessages,seeErrorMessages.
4 ExecutionError
16 Anexecutionerroroccurred.Theseerrorcodesareintherange-100to-199.
5 Command 32
Error Acommanderroroccurred.Theseerrorcodesareintherange-200to-299.
6 NotUsed NotUsed 0isreturned.
7 PowerOn 128 Powerhasbeenturnedoffandonsincethelasttimetheeventregisterwasreadorcleared.
Usethe<enable_val>parametertospecifywhichbitswillbeenabled.Thedecimalvaluespecifiedcorrespondstothebinary-weightedsumofthebitsyouwishtoenableintheregister.Forexample,toenablebit2(decimalvalue=4),bit3(decimalvalue=8),andbit7(decimalvalue=128),thecorrespondingdecimalvaluewouldbe140(4+8+128).
The*CLS(clearstatus)commandwillnotcleartheenableregisterbutitdoesclearallbitsintheeventregister.
ReturnFormat
Thequeryreadstheenableregisterandreturnsadecimalvaluethatcorrespondstothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit3(decimalvalue=8)andbit7(decimalvalue=128)areenabled,thequerywillreturn"+136".
Examples
Thefollowingcommandenablesbit4(decimalvalue=16)intheenableregister.Ifanexecutionerroroccurs,thisconditionwillbereportedtotheStatusByteRegister(bit4willbesethigh).
*ESE16
Thefollowingqueryreturnswhichbitsareenabledintheregister.
*ESE?
TypicalResponse:+16
SeeAlsoIEEE-488CommonCommandsIntroduction
*ESR?
*ESR?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*ESR?
Description
ThiscommandqueriestheeventregisterfortheStandardEventRegistergroup.Thisisaread-destructiveregister,andthebitsareclearedwhenyoureadtheregister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Remarks
ThefollowingtableliststhebitdefinitionsfortheStandardEventRegister.
Bit#
BitName DecimalValue
Definition
0 OperationComplete
1 Allcommandspriortoandincluding*OPChavebeenexecuted.
1 NotUsed NotUsed 0isreturned.
2 QueryError 4 Theinstrumenttriedtoreadtheoutputbufferbutitwasempty.Or,anewcommandlinewasreceivedbeforeapreviousqueryhasbeenread.Or,boththeinputandoutputbuffersarefull.
3 DeviceError
8 Adevice-specificerrorhasbeengenerated.Foracompletelistingoftheerrormessages,seeErrorMessages.
4 ExecutionError
16 Anexecutionerroroccurred.Theseerrorcodesareintherange-100to-199.
5 CommandError
32 Ancommanderroroccurred.Theseerrorcodesareintherange-200to-299.
6 NotUsed NotUsed 0isreturned.
7 PowerOn 128 Powerhasbeenturnedoffandonsincethelasttimetheeventregisterwasreadorcleared.
InordertobereportedtotheStatusRegister,thecorrespondingbitsintheeventregistermustbeenabledusingthe*ESEcommand.
Onceabitisset,itremainssetuntilclearedbyreadingtheeventregisterorexecutionofthe*CLS(clearstatus)command.
ReturnFormat
Thequeryreadstheeventregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit2(decimalvalue=4)andbit4(decimalvalue=16)areset(andthecorrespondingbitsareenabled),thiscommandwillreturn+20.
Example
Thefollowingqueryreadstheeventregister(bits3and4areset).
*ESR?
TypicalResponse:+24
SeeAlsoIEEE-488CommonCommandsIntroduction
*ESE
*CLS
*IDN?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
*IDN?
Description
Thisqueryreadstheinstrument'sidentificationstring,whichincludesthemanufacturername,themodelnameandfirmwareversioninformation.
ReturnFormat
Forthe34970A,thequeryreturnsastringwiththefollowingformat:
HEWLETT-PACKARD,34970A,0,XX-Y-Z
where:
XX Measurementprocessorfirmwareversion
Y I/Oprocessorfirmwareversion
Z Frontpanelprocessorfirmwareversion
Forthe34972A,thequeryreturnsastringwiththefollowingformat:
KeysightTechnologies,34972A,<serial#>,i.ii-o.oo-fp-fpga
where:
i.ii I/Oprocessorfirmwareversion
o.oo Measurementprocessorfirmwareversion
fp Frontpanelprocessorfirmwareversion
fpga FPGAversion
Example
Thefollowingqueryreturnstheinstrument'sidentificationstringfora34972A.
*IDN?
TypicalResponse:KeysightTechnologies,34972A,MY12345678,1.01-1.00-01-0002
Thefollowingqueryreturnstheinstrument'sidentificationstringfora34970A.
*IDN?
TypicalResponse:HEWLETT-PACKARD,34970A,0,13-2-2
SeeAlsoIEEE-488CommonCommandsIntroduction
*OPC*OPC?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
*OPC
*OPC?
Description
ThecommandformstartstheOPCstateengineandreturns.Attheendofthecurrentscan,bit0oftheenableregisterfortheStandardEventRegisterwillbesetto1.Thequeryformreturns1totheoutputbufferatthecompletionofthecurrentoperation.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.FormoreinformationontheStandardEventRegister,see*ESE.
Remarks
Thiscommandenablesyoutosynchronizeyourapplicationwiththeinstrument.
YoucanconfigureSRQinterruptstonotifyuserapplications.
Notethedifferencebetweenthe*OPCcommandandthe*OPC?query.The*OPC?querysetstheoutputbufferto1atthecompletionofthecurrentoperation.
Examples
Thefollowingcommandreturnsimmediatelyandcausesthestatussystemtosetthe"OperationComplete"bitattheendofthecurrentscan.
*OPC
Thefollowingquerysends"1"totheoutputbufferwhenthecurrentoperationcompletes.
*OPC?
TypicalResponse:+1
SeeAlsoIEEE-488CommonCommandsIntroduction
*ESE
*PSCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
*PSC<state>
*PSC?
Description
Power-OnStatusClear.Thiscommandenablesordisablestheclearingofcertainenableregistersatpoweron.With*PSC0specified,theseregistersarenotclearedatpoweron.With*PSC1specified,theseregistersareclearedatpoweron.Thefollowingregistersareaffected:
RegisterName
Command
QuestionableDataRegister
STATus:QUEStionable:ENABle
StandardOperationRegister
STATus:OPERation:ENABle
AlarmRegister
STATus:ALARm:ENABle
StatusByteRegister
*SRE(ServiceRequestEnable)
StandardEventRegister
*ESE(EventStatusEnable)
The*PSCcommanddoesnotaffecttheclearingoftheconditionoreventregisters,justtheenableregisters.FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Parameters
Name Type RangeofValues
DefaultValue
<state> Boolean {OFF|0|ON|1} ON
ReturnFormat
Thequeryreturns0(donotclearatpoweron)or1(clearatpoweron).
Examples
Thefollowingcommanddisablesthepower-onclearingoftheaffectedregisters.
*PSC0
Thefollowingqueryreturnsthepower-onstatusclearsetting.
*PSC?
TypicalResponse:0
SeeAlso*SRE
*STB?
*SAV*RCLSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*SAV{0|1|2|3|4|5}
*RCL{0|1|2|3|4|5}
Description
Thesecommandsstoreandrecallinstrumentstatesintothespecifiedstoragelocation.The*SAVcommandsavesthecurrentinstrumentstateandoverwritesanystatepreviouslystoredinthesamelocationisoverwritten(noerrorisgenerated).
Remarks
Theinstrumenthassixstoragelocationsinnon-volatilememorytostoreinstrumentstates.Youcanstoretheinstrumentstateinlocation0,1,2,3,4,or5,butyoucanonlyrecallastatefromalocationthatcontainsapreviouslystoredstate.
LANI/Oconfigurationisnotstoredbya*SAVoperationorrecalledbya*RCL.Onlyinstrumentconfigurationisrecalled.
Whenshippedfromthefactory,allsixstoragelocationsareempty.
State0isoverwrittenatpowerdown.
AFactoryReset(*RSTcommand)doesnotaffecttheconfigurationsstoredinmemory.Onceastateisstored,itremainsuntilitisoverwritten.
Example
Thefollowingcommandstoresthecurrentinstrumentstateinlocation1.
*SAV1
SeeAlsoIEEE-488CommonCommandsIntroduction
*RSTSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*RST
Description
ThiscommandresetstheinstrumenttotheFactoryconfiguration.SeeFactoryResetStateforacompletelistingoftheinstrument'sFactoryconfiguration.
Remarks
Thiscommanddoesnotaffectanypreviously-storedinstrumentstates(see*SAVcommand).
ThiscommanddoesnotaffectI/Osettings,suchasIPaddress.
ThevalueofCALibration:SECure:STATeisnotaffectedby*RST.
Example
Thefollowingcommandresetstheinstrument.
*RST
SeeAlsoIEEE-488CommonCommandsIntroduction
*SRESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
*SRE<enable_val>
*SRE?
Description
ThiscommandenablesbitsintheenableregisterfortheStatusByteRegister.Onceenabled,thecorrespondingbitsmaygenerateaRequestforService(RQS)intheStatusByte.ThisRQSeventmaygeneratea"callback"toyourapplicationasatypeofasynchronousinterrupt.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Parameters
Name Type RangeofValues
DefaultValue
<enable_val> Numeric Adecimalvaluewhichcorrespondstothebinary-weightedsumofthebitsintheregister(seetablebelow).
Thisisarequiredparameter.
Remarks
ThefollowingtableliststhebitdefinitionsfortheStatusByteRegister.
Bit#
BitName DecimalValue
Definition
0 NotUsed 1 Alwayszero.
1 AlarmSummary
2 OneormorebitsaresetintheAlarmRegister(bitsmustbeenabled).
2 ErrorQueue 4 OneormoreerrorshavebeenstoredintheErrorQueue.UsetheSYSTem:ERRor?querytoreadanddeleteerrors.
3 QuestionableDataSummary
8 OneormorebitsaresetintheQuestionableDataRegister(bitsmustbeenabled,seeSTATus:QUEStionable:ENABlecommand).
4 MessageAvailable
16 Dataisavailableintheinstrument'soutputbuffer.
5 StandardEventSummary
32 OneormorebitsaresetintheStandardEventRegister(bitsmustbeenabled,see*ESEcommand).
6 MasterSummary
64 OneormorebitsaresetintheStatusByteRegisterandmaygenerateaRequestforService(RQS).Bitsmustbeenabledusingthe*SREcommand.
7 Standard 128 Oneormorebitsaresetinthe
OperationSummary
StandardOperationRegister(bitsmustbeenabled,seeSTATus:OPERation:ENABlecommand).
Usethe<enable_val>parametertospecifywhichbitswillbeenabled.Thedecimalvaluespecifiedcorrespondstothebinary-weightedsumofthebitsyouwishtoenableintheregister.Forexample,toenablebit3(decimalvalue=8)andbit5(decimalvalue=32),thecorrespondingdecimalvaluewouldbe40(8+32).
The*CLS(clearstatus)commandwillnotcleartheenableregisterbutitdoesclearallbitsintheeventregister.
A*CLSor*RSTcommanddoesnotclearthebitsintheStatusByteenableregister.
Besuretosendthedecimalvalueofthebitandnotthebitnumber.Forexample,toenablebit4,send*SRE16,not*SRE4.
ReturnFormat
Thequeryreadstheenableregisterandreturnsadecimalvaluethatcorrespondstothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit3(decimalvalue=8)andbit5(decimalvalue=32)areenabled,thequerywillreturn+40.
Examples
Thefollowingcommandenablesbit4(decimalvalue=16)intheenableregister.
*SRE16
Thefollowingqueryreturnswhichbitsareenabledintheregister.
*SRE?
TypicalResponse:+16
SeeAlsoIEEE-488CommonCommandsIntroduction
*STB?
*STB?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*STB?
Description
ThiscommandqueriestheconditionregisterfortheStatusByteRegistergroup.Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Remarks
ThefollowingtableliststhebitdefinitionsfortheStatusByteRegister.
Bit#
BitName DecimalValue
Definition
0 NotUsed 1 Alwayszero.
1 AlarmSummary
2 OneormorebitsaresetintheAlarmRegister(bitsmustbeenabled).
2 ErrorQueue 4 OneormoreerrorshavebeenstoredintheErrorQueue.UsetheSYSTem:ERRor?querytoreadanddeleteerrors.
3 QuestionableDataSummary
8 OneormorebitsaresetintheQuestionableDataRegister(bitsmustbeenabled,seeSTATus:QUEStionable:ENABlecommand).
4 MessageAvailable
16 Dataisavailableintheinstrument'soutputbuffer.
5 StandardEventSummary
32 OneormorebitsaresetintheStandardEventRegister(bitsmustbeenabled,see*ESEcommand).
6 MasterSummary
X OneormorebitsaresetintheStatusByteRegisterandmaygenerateaRequestforService(RQS).Bitsmustbeenabledusingthe*SREcommand.
7 StandardOperationSummary
128 OneormorebitsaresetintheStandardOperationRegister(bitsmustbeenabled,seeSTATus:OPERation:ENABle
command).
ThisqueryreturnsthesameresultsasaSerialPollbutthe"MasterSummary"bit(bit6)isnotclearedifaSerialPollhasoccurred.
Unlikehowaresetclearstheconditionregister,afactoryreset(*RSTcommand)doesnotcleartheStatusByteRegister.
ReturnFormat
Thequeryreadstheconditionregisterandreturnsadecimalvaluethatcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit3(decimalvalue=8)andbit5(decimalvalue=32)areset(andthecorrespondingbitsareenabled),thiscommandwillreturn"+40".
Example
Thefollowingqueryreadstheconditionregister(bits3and5areset).
*STB?
TypicalResponse:+40
SeeAlsoIEEE-488CommonCommandsIntroduction
*SRE
*TRGSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*TRG
Description
ThiscommandsendsasoftwaretriggertotheinstrumentwhentheinstrumentisconfiguredforTRIGger:SOURceBUS.
Remarks
Thesoftwaretriggeroperationthatthiscommandexecutesisacceptedbytheinstrumentonlywhentheinstrumentisacquiringdata(executingINITiate).
Aftersettingthetriggersource,youmustplacetheinstrumentinthewait-for-triggerstateusingtheINITiatecommand.OnceyouhavesenttheINITiatecommand,theinstrumentwillbufferonesoftwaretriggertobeappliedatthenextwait-for-triggerstate,soitisnotnecessarytoverifythattheinstrumentispreciselyinthewait-for-triggerstate.
The*TRGcommanddoesnotworkwiththeREAD?command.
Example
Thefollowingcommandstriggertheinstrument.
TRIG:SOURBUS
INIT
*TRG
SeeAlsoIEEE-488CommonCommandsIntroduction
INITiate
*TST?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
*TST?
Description
Thiscommandperformsacompleteself-testoftheinstrumentandreturnsapass/failindication.Theself-testrunsaseriesoftestsandwilltakeapproximately45secondstocomplete.Ifalltestspass,youcanhaveahighconfidencethattheinstrumentisoperational.
Remarks
Whensendingthe*TST?query,youmayneedtoincreasethetimeoutperiodforyourIOLibraryreadresponsetimetoallowthecommandtocompletewithoutcausingatimeouterror.
Ifoneormoretestsfail,+1isreturnedandoneormoreerrorsarestoredintheerrorqueue.Foracompletelistingoftheerrormessagesrelatedtoself-testfailures,seeErrorMessages.
Ifoneormoretestsfail,seetheKeysight34970A/34972AServiceGuideforinstructionsonobtainingservice.
Uponcompletion,*TST?restorestheinstrumenttoitsfactoryresetstate.
ReturnFormat
Thequeryreturns+0(alltestspassed)or+1(oneormoretestsfailed).Fordetailsonpossibleerrorreturnediftestsfail,seeErrorMessages.
Example
Thefollowingcommandperformsaself-testandreturnsapass/failindication.Inthiscase,therearenofailures.
*TST?
TypicalResponse:+0
SeeAlsoIEEE-488CommonCommandsIntroduction
*WAISyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
*WAI
Description
Thiscommandwaitsforallpendingoperationstocompletebeforeexecutinganyadditionalcommandsovertheinterface.
Remarks
Functionandrangechangesareconsideredpendingoperations.Therefore,*WAIwillwaitforthesechangestocomplete.
Becausethiscommandstopsthecommandparserfromoperating,itisbettertouse*OPC?forsynchronizationpurposes.
Examples
Thefollowingcommandwaitsuntilallpendingoperationscomplete.
INIT;*WAI;:ROUT:CLOS(@101)!Ensuresthatthe
scanstartedbytheINITfinishes
!beforethe
ROUT:CLOScommandisexecuted.
SeeAlsoIEEE-488CommonCommandsIntroduction
*OPC
INSTrumentSubsystemIntroduction
CommandSummaryINSTrument:DMM
INSTrument:DMM?
INSTrument:DMM:INSTalled?
INSTrument:DMMSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
INSTrument:DMM<state>
INSTrument:DMM?
Description
ThiscommanddisablesorenablestheinternalDMM.WhenyouchangethestateoftheinternalDMM,theinstrumentissuesaFactoryReset(*RSTcommand).
Parameters
Name Type RangeofValues
DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ReturnFormat
ThequeryreturnsthestateoftheinternalDMMas0(disabled)or1(enabled).
Examples
ThefollowingcommandenablestheinternalDMM.
INST:DMMON
ThefollowingqueryreturnsthestateoftheDMM,whichisONinthiscase.
INST:DMM?
TypicalResponse:1
SeeAlsoINSTrumentSubsystemIntroduction
INSTrument:DMM:INSTalled?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
INSTrument:DMM:INSTalled?
Description
ThisquerydetermineswhethertheinternalDMMisinstalledinthemainframe.
Remarks
TheinternalDMMisanoptionalassemblyfortheKeysight34970A/34972A.
ReturnFormat
Thequeryreturns0(notinstalled)or1(installed).
Example
ThefollowingcommanddeterminesthattheinternalDMMispresent.
INST:DMM:INST?
TypicalResponse:1
SeeAlsoINSTrumentSubsystemIntroduction
INSTrument:DMM
LXISubsystemIntroductionThefollowingcommandssupportLANeXtensionsforInstrumentation(LXI)functionality.
CommandSummaryLXI:IDENtify:STATe
LXI:IDENtify:STATe?
LXI:RESet
LXI:RESTart
LXI:IDENtify[:STATe]Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
LXI:IDENtify[:STATE]<state>
LXI:IDENtify[:STATE]?
Description
ThiscommandturnstheLXIIdentifyIndicatoronthefrontpaneldisplayonoroff.
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
Remarks
TheLXIIdentifyIndicatorhelpsyouidentifywhichLXIdeviceisassociatedwiththeLANaddressyouareusing.
TheinstrumentturnsofftheLXIIdentifyIndicatorafteraFactoryReset(*RSTcommand).
YoucanpresstheLOCALkeytoturnofftheLXIIdentifyIndicator.
ReturnFormat
ThequeryreturnsthecurrentLXIIdentifyIndicatorstate:0(OFF)or1(ON).
Examples
ThefollowingcommandturnsontheLXIIdentifyIndicator.
LXI:IDENON
ThefollowingqueryreturnsthestateoftheLXIIdentifyIndicator.
LXI:IDEN?
TypicalResponse:1
SeeAlsoLXISubsystemIntroduction
LXI:RESetSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
LXI:RESet
Description
Thiscommandresetstheinstrument'sLANsettingstotheirdefaultvalues.
Example
ThefollowingcommandresetstheLANsettings.
LXI:RES
SeeAlsoLXISubsystemIntroduction
LXI:RESTartSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
LXI:RESTart
Description
ThiscommandrestartstheLANwiththecurrentparameters.
Example
ThefollowingcommandrestartstheLANinterface.
LXI:REST
SeeAlsoLXISubsystemIntroduction
MEASureSubsystemIntroductionIfyouspecifya<ch_list>withoneofthesecommands,that<ch_list>overwritesthecurrentscanlist.
CommandSummaryMEASure:CURRent:AC?
MEASure:CURRent:DC?
MEASure:DIGital:BYTE?
MEASure:FREQuency?
MEASure:FRESistance?
MEASure:PERiod?
MEASure:RESistance?
MEASure:TEMPerature?
MEASure:TOTalize?
MEASure:VOLTage:AC?
MEASure:VOLTage:DC?
MEASure:CURRent:AC?MEASure:CURRent:DC?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEASure:CURRent:AC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:CURRent:DC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
ThesecommandsareequivalenttoCONFigure:CURRent:ACorCONFigure:CURRent:DCfollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure:CURRent:AC
CONFigure:CURRent:DC
READ?
MEASure:DIGital:BYTE?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
MEASure:DIGital:BYTE?(@<scan_list>)
Description
ThiscommandisequivalenttoCONFigure:DIGital:BYTEfollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure:DIGital:BYTE
READ?
MEASure:FREQuency?MEASure:PERiod?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEASure:FREQuency?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:PERiod?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
ThesecommandsareequivalenttoCONFigure:FREQuencyorCONFigure:PERiodfollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure:FREQuency
CONFigure:PERiod
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe
READ?
MEASure:RESistance?MEASure:FRESistance?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEASure:RESistance?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:FRESistance?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
ThesecommandsareequivalenttoCONFigure:RESistanceorCONFigure:FRESistancefollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure:RESistance
[SENSe:]RESistance:OCOMpensated
CONFigure:FRESistance
[SENSe:]FRESistance:OCOMpensated
READ?
MEASure:TEMPerature?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEASure:TEMPerature?{<probe_type>|DEF},{<type>|DEF}[,1[,{<resolution>|MIN|MAX|DEF}]],(@<scan_list>)
Description
ThiscommandisequivalenttoCONFigure:TEMPeraturefollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure:TEMPerature
READ?
MEASure:TOTalize?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEASure:TOTalize?<mode>,(@<scan_list>)
Description
ThiscommandisequivalenttoCONFigure:TOTalizefollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure:TOTalize
READ?
MEASure:VOLTage:AC?MEASure:VOLTage:DC?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEASure:VOLTage:AC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:VOLTage:DC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
Description
ThesecommandsareequivalenttoCONFigure:VOLTage:ACorCONFigure:VOLTage:DCfollowedbyaREAD?.
SeeAlsoMEASureSubsystemIntroduction
CONFigure[:VOLTage][:DC]
CONFigure[:VOLTage]:AC
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay:AUTO
[SENSe:]VOLTage:AC:BANDwidth
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
READ?
MEMorySubsystemIntroduction
CommandSummaryMEMory:NSTates?
MEMory:STATe:DELete
MEMory:STATe:NAME
MEMory:STATe:NAME?
MEMory:STATe:RECall:AUTO
MEMory:STATe:RECall:AUTO?
MEMory:STATe:VALid?
MEMory:NSTates?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
MEMory:NSTates?
Description
Thisqueryreturnsthetotalnumberofmemorylocationsavailableforstatestorage.Forthe34970A/34972A,thiscommandalwaysreturnsthenumber6.
Remarks
Location0isincluded,butitisreservedforpower-downstatestorage.
ReturnFormat
Thequeryreturnsthenumber+6.
Example
Thefollowingqueryreturnsthenumberofstates.
MEMory:NSTates?
TypicalResponse:+6
SeeAlsoMEMorySubsystemIntroduction
MEMory:STATe:DELeteSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
MEMory:STATe:DELete<location>
Description
Thiscommanddeletesthecontentsofthespecifiedstoragelocation.
Parameters
Name Type Rangeof
Values
DefaultValue
<location> NumericAnintegerfrom0to5
Thisisarequiredparameter.
Remarks
Notethatyoucannotrecalltheinstrumentstatefromastoragelocationthatwasdeleted.Anerrorisgeneratedifyouattempttorecalladeletedstate(+291,"Notabletorecallstate:itisempty").
Example
Thefollowingcommanddeletesthecontentsofstoragelocation1.
MEM:STAT:DEL1
SeeAlsoMEASureSubsystemIntroduction
*SAV
*RCL
MEMory:STATe:NAMESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEMory:STATe:NAME<location>[,<name>]
MEMory:STATe:NAME?<location>
Description
Thiscommandassignsanametothespecifiedstoragelocation.Youcannamealocationfromthefrontpanelorovertheremoteinterfacebutyoucanrecallanamedstateonlyfromthefrontpanel.Fromtheremoteinterface,youcanonlyrecallastoredstateusingthe*RCLcommandwithanumber(0through5).
Parameters
Name Type RangeofValues
DefaultValue
<location> Numeric Anintegerfrom0to5
Thisisarequiredparameter.
<name> UnquotedASCIIString
Aunquotedstringofupto12characters.Thefirstcharactermustbealetter(A-Z),buttheremaining11characterscanbeletters,numbers(0-9),ortheunderscorecharacter("_").Blankspacesarenotallowed.
Ifomitted,thedefaultnameisusedforthespecifiedstoragelocation.
Remarks
Whenshippedfromthefactory,defaultnamesareassignedtostoragelocations1through5.Thedefaultnamesare"STATE1","STATE2",andsoon.
Ifyouomitthe<name>parameter,thedefaultnameisassignedtothespecifiedstoragelocation.Thisprovidesaneasywaytoresettheassociatednametoitsfactorydefault;however,thestoredstateisnotdeleted.
Theinstrumentgeneratesanerrorifyouspecifyanamewithmorethan12characters.
Deletingthecontentsofastoragelocation(seeMEMory:STATe:DELetecommand)willresettheassociatednametoitsfactorydefault("STATE1","STATE2",etc.).
AFactoryReset(*RSTcommand)doesnotaffecttheconfigurationsstoredinmemory.Onceastateisstored,itremainsuntilitisoverwrittenorspecificallydeleted.
ReturnFormat
ThequeryreadsthenameassignedtothespecifiedstoragelocationandreturnsaquotedASCIIstring.Ifthespecifiedlocationhasnocustomassigned,thedefaultnameisreturned("STATE1","STATE2",etc.).
Examples
ThefollowingcommandassignsthenameTEST_RACK_1tostoragelocation1.
MEM:STAT:NAME1,TEST_RACK_1
Thefollowingqueryreturnsthenameassignedtostoragelocation1.
MEM:STAT:NAME?1
TypicalResponse:"TEST_RACK_1"
SeeAlsoMEMorySubsystemIntroduction
*SAV
*RCL
MEMory:STATe:RECall:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
MEMory:STATe:RECall:AUTO<mode>
MEMory:STATe:RECall:AUTO?
Description
Thiscommandenablesordisables(default)theautomaticrecallofthepower-downstate(state0)whenpoweristurnedon.Select"ON"toautomaticallyrecallthepower-downstate.Select"OFF"toissueaFactoryReset(*RST)whenpoweristurnedon(inthismode,thepower-downstateisnotautomaticallyrecalled).
Parameters
Name Type RangeofValues
DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
Remarks
Whentheinstrumentisshippedfromthefactory,theautomaticrecallmodeisdisabled.
State0getsstoredeverytimethepoweristurnedoff.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommandenablestheautomaticrecallmode.
MEM:STAT:REC:AUTOON
Thefollowingqueryreturnstheautomaticrecallsetting.
MEM:STAT:REC:AUTO?
TypicalResponse:1
SeeAlsoMEMorySubsystemIntroduction
*SAV
MEMory:STATe:VALid?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
MEMory:STATe:VALid?<location>
Description
Thiscommandqueriesthespecifiedstoragelocationtodeterminewhetheravalidstateiscurrentlystoredinthislocation.Duringthevalidationprocess,theinstrumentverifiesthatthelocationisnotempty.Youcanusethiscommandbeforesendingthe*RCLcommandtodeterminewhetherastatehasbeenpreviouslystoredinthislocation.
Parameters
Name Type RangeofValues
DefaultValue
<location> NumericAnintegerfrom0to5
Thisisarequiredparameter.
Remarks
Thiscommanddoesnotguaranteethatnoerrorswillbegeneratedwhenastoredstateisrecalledusingthe*RCLcommand.Evenifthiscommanddeterminesthatthespecifiedstoragelocationisvalid,individualmodulesmaystillbeinstatesthatwillgenerateanerror.
ReturnFormat
Thequeryreturns0ifnostatehasbeenstoredinthespecifiedlocationorifithasbeendeleted.Itreturns1ifavalidstateisstoredinthespecifiedlocation.
Example
Thefollowingqueryreturnsa0,indicatingthatnovalidstateiscurrentlystoredinlocation3.
MEM:STAT:VAL?3
TypicalResponse:0
SeeAlsoMEMorySubsystemIntroduction
MMEMorySubsystemIntroductionThisfunctionalityisavailableonthe34972Aonly.
CommandSummaryMMEMory:EXPort?
MMEMory:FORMat:READing:CSEParator
MMEMory:FORMat:READing:CSEParator?
MMEMory:FORMat:READing:RLIMit
MMEMory:FORMat:READing:RLIMit?
MMEMory:IMPort:CATalog?
MMEMory:IMPort:CONFig?
MMEMory:LOG[:ENABle]
MMEMory:LOG[:ENABle]?
MMEMory:EXPort?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
MMEMory:EXPort?
Description
Thisqueryexportsthecurrentcontentsofreadingmemory,alongwiththeinstrumentconfiguration,tothedefaultdirectoryontheUSBdrive:
/34972A/data/<SN>/yyyymmdd_hhmmssmmm
Notethan<SN>istheinstrument'sserialnumber,yyyymmddindicatesthecurrentdate,andhhmmssmmmindicatesthecurrenttimein24-hourclockformat,downtothemillisecond.
Itwaitsuntiltheexportiscompleteandreturns0(noerrors)or1(exporthaderrors).
Remarks
Adirectorynamed/34972A/data/MY12345678/20100120_130542169wouldindicatedatatakenfrominstrumentMY12345678atthetimeof42.169secondsafter1:05pmonJanuary20,2010.
YoucancontrolthefielddelimiterintheexportedfileswithMMEMory:FORMat:READing:CSEParator.
Exportingthecontentsofreadingmemorycanbealengthyoperation,dependingonthenumberofreadingsinmemory.
FortypicalUSBdrives,thereisafilesystemlimitof999filesandfoldersperdirectory.Ifyoureceiveerrormessagenumber410,"Notenoughdiskspace"whileexportingdata,checktoensurethatyouhavenothitthelimitof999timestampedfoldersforyourinstrument.Youmayreceiveerror410evenifadditionalspaceisavailableonthedrive.
ReturnFormat
Thequeryreturns0(noerrors)or1(exporthaderrors)whenthefileexportiscomplete.Ifthequeryreturnsa1,usetheSYSTem:ERRor?commandtoreadtheerrors.
Example
Thefollowingqueryexportsthecurrentcontentsofreadingmemory,alongwiththeinstrumentconfiguration,totheUSBdrive.
MMEMory:EXPort?
Typicalresponse:0
SeeAlsoMMEMorySubsystemIntroduction
MMEMory:FORMat:READing:RLIMit
MMEMory:FORMat:READing:CSEParator
MMEMory:FORMat:READing:CSEParatorSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
MMEMory:FORMat:READing:CSEParator<column_separator>
MMEMory:FORMat:READing:CSEParator?
Description
ThiscommandallowsyoutospecifythecharacterusedtoseparatethecolumnsintheoutputdataontheUSBdrive.Thisenablesyoutomakethefileconformwiththeapplicationsoftwarethatyouwilluseforviewingthefile.
Parameters
Name Type RangeofValues DefaultValue
<column_separator> Discrete{TAB|COMMa|SEMicolon}
Thisisarequiredparameter.
ThefactorydefaultisCOMMa.
Remarks
Whentheinstrumentisshippedfromthefactory,thedefaultstatefor<column_separator>isCOMMa.
Thevalueofthe<state>willbesavedinnon-volatilememoryontheinstrumentandwillnotbeaffectedby*RSTorSYSTem:PRESet.
ReturnFormat
ThequeryreturnsTAB,COMMorSEMtoindicatethevalueofthe<column_separator>.
Examples
ThefollowingcommandspecifiesthattabsshouldbeusedtoseparatethecolumnsintheoutputdataontheUSBdrive.
MMEMory:FORMat:READing:CSEParatorTAB
Thefollowingqueryindicatesthecharacterusedtoseparatecolumns.Inthiscase,itistabs.
MMEMory:FORMat:READing:CSEParator?
TypicalResponse:TAB
SeeAlsoMMEMorySubsystemIntroduction
MMEMory:FORMat:READing:RLIMitSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
MMEMory:FORMat:READing:RLIMit<row_limit>
MMEMory:FORMat:READing:RLIMit?
Description
ThiscommandallowsyoutospecifywhetherthemaximumnumberofsweepsthatcanbeloggedtoasingleUSBdatafileshouldbelimitedtoonelessthan64K(216-1=65,535).If<row_limit>isON,sweepsarestoredinfilesnameddat00001.csv,dat00002.csv,dat00003.csv,andsoon,with65,535sweepsperfile.If<row_limit>isOFF,dataloggedforthescanisstoredinasinglefilenameddat00001.csv,whichislimitedbyboththespaceavailableontheUSBdriveandhowthedriveisformatted,uptoamaximumof232sweeps(roughly4.3billion).
Parameters
Name Type RangeofValues
DefaultValue
<row_limit> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultisON.
Remarks
Thisfeatureenablesyoutoaccommodatecertainversionsofcommonspreadsheet,databaseanddataanalysisprogramsthathavelimitationsof64Krowsperfile.
Whentheinstrumentisshippedfromthefactory,thedefaultstatefor<row_limit>isON.
Thevalueofthe<row_limit>willbesavedinnon-volatilememoryontheinstrumentandwillnotbeaffectedby*RSTorSYSTem:PRESet.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommandturnstherowlimitfeatureon,causingUSBdatafilestobesplitatthe64K-1boundary.
MMEMory:FORMat:READing:RLIMitON
Thefollowingqueryindicateswhethertherowlimitfeatureison.Inthiscase,itisOFF.
MMEMory:FORMat:READing:RLIMit?
TypicalResponse:0
SeeAlsoMMEMorySubsystemIntroduction
MMEMory:LOG[:ENABle]
MMEMory:FORMat:READing:CSEParator
MMEMory:IMPort:CATalog?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
MMEMory:IMPort:CATalog?
Description
ThisqueryreturnsacataloglistingalloftheKeysightBenchLinkDataLoggerconfiguration(BLCFG)filesintherootdirectoryoftheUSBdrive.
Remarks
IftheUSBdriveisnotinsertedorcontainsnofiles,thequeryreturnsanemptystring:"".
ThiscommandwillonlyrecognizefilesintherootdirectoryoftheUSBdrivewitha.BLCFGextension.
Thecommandwillrecognizeupto50BLCFGfilesintherootdirectory.Ifmorethan50filesarefoundinthedrive'srootdirectory,thesystemwillrecognizeonlythe50withthemostrecenttimestamps.
ReturnFormat
Thisqueryreturnsthecatalogasalistofquotedfilenames,separatedbycommas:
"<file_name1>","<file_name2>","<file_name3>",etc.
Notethatthefilenameswillincludethe.BLCFGextension.
Example
ThefollowingqueryreturnsalistofallBLCFGfilesintherootdirectoryoftheUSBdrive.Inthiscase,therearetwofiles.
MMEM:IMP:CAT?
TypicalResponse:"MyConfig1.BLCFG","PrevConfig.BLCFG"
SeeAlsoMMEMorySubsystemIntroduction
MMEMory:IMPort:CONFig?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
MMEMory:IMPort:CONFig?"<configuration_file>"
Description
ThisqueryimportsanKeysightBenchLinkDataLoggerconfiguration(BLCFG)fileandattemptstoconfiguretheinstrumentaccordingtothecontentsoftheBLCFGfile.Itwaitsuntiltheimportiscompleteandreturns0(noerrors)or1(importhaderrors).
Parameters
Name Type RangeofValues
DefaultValue
<configuration_file> FilenameAnyfilename,alwayswitha.BLCFGextension.
Thisisarequiredparameter.
Remarks
TheconfigurationfilemustresideintherootdirectoryoftheUSBdrive;hencenopathisincludedinthespecificationofthe"<configuration_file>."
Onlythe50mostrecentBLCFGfileswillbeaccessible.Fileswithnameslongerthan40characterswillnotbeaccessible.
PossibleerrorsincludeacardsetmismatchbetweentheinstrumentandtheBLCFGfile,oracorruptfile.YoushouldaddresserrorsbydiagnosingyourBLCFGfileswiththeKeysightBenchLinkDataLoggertool.
Importoperationscantakeseveralseconds,andthe"Busy"statussystembit(bit14)isassertedduringthistime.Becausethisisaquery,nomorecommandswillbeprocessedontheI/Oportfromwhichitwassentuntilthequerycompletesandreturnsa0or1.
ReturnFormat
Thequeryreturns0(noerrors)or1(importhaderrors)whenthefileimportiscomplete.Ifthequeryreturnsa1,usetheSYSTem:ERRor?commandtoreadtheerrors.
Examples
Thefollowingqueryperformstheimportandthenreturnsa0or1.Inthiscase,itreturnsa1,indicatingthatthefileimporthadoneormoreerrors.
MMEMory:IMPort:CONFig?"My34972ASetup.BLCFG"
Typicalresponse:0
SeeAlsoMMEMorySubsystemIntroduction
MMEMory:LOG[:ENABle]Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
MMEMory:LOG[:ENABle]<state>
MMEMory:LOG[:ENABle]?
Description
ThiscommandallowsyoutospecifywhetherscannedreadingsareloggedtotheUSBdriveastheyaretaken.
Parameters
Name Type RangeofValues
DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultstateisOFF.
Remarks
Thevalueofthe<state>willbesavedinnon-volatilememoryontheinstrumentandwillnotbeaffectedby*RSTorSYSTem:PRESet.
Forshortscans,aREAD?orMEASURE?querymaytakeabitofextratimetocompleteifyouarealsologgingtoUSB.
IfyouremovetheUSBdriveduringlogging,loggingwillstopbutthescanwillcontinue.Ifyoure-attachtheUSBdrive,itwillnotcauseloggingtoresumeunlessyoufollowthefive-stepprocedureshownbelow.Otherwise,loggingwillresumeatthenextINITiate.
ToreplaceaUSBstickonasystemactivelyloggingdatatoUSB:
1. PresstheSCANbuttonforseveralsecondsuntilthescanstops.
2. Waituntilthefrontpanelindicatesthattheboxisagainidle.Itcantakesometimeafterthescanhasbeeninterrupted,forloggingtotheUSBdrivetocomplete.
3. Oncetheinstrumentisidle,removetheUSBdrive.
4. Aftertheoldstickisremoved,wait5secondsbeforeinsertingthenewUSBdrive.
5. PresstheSCANbuttonagaintorestartscanningandloggingtothenewUSBdrive.
FortypicalUSBdrives,thereisafilesystemlimitof999filesandfoldersperdirectory.Ifyoureceiveerrormessagenumber410,"Notenoughdiskspace"whileloggingdata,checktoensurethatyouhavenothitthelimitof999timestampedfoldersforyourinstrument.Youmayreceiveerror410evenifadditionalspaceisavailableonthedrive.
1.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
ThefollowingcommandspecifiesthatscannedreadingsaretobeloggedtotheUSBdriveastheyaretaken.Datawillalsosimultaneouslybewrittentoreadingmemory.ToscandataintoreadingmemorywithoutloggingitontheUSBdrive,youwoulduseMMEM:LOGOFF.
MMEMory:LOGON
ThefollowingqueryindicateswhetherscannedreadingsaretobeloggedtotheUSBdrive.Inthiscase,thereturnedvalueof1indicatesthatloggingtotheUSBdriveisON(enabled).
MMEMory:LOG?
TypicalResponse:1
SeeAlsoMMEMorySubsystemIntroduction
OUTPutSubsystemIntroduction
CommandSummaryOUTPut:ALARm:CLEar:ALL
OUTPut:ALARm:MODE
OUTPut:ALARm:MODE?
OUTPut:ALARm:SLOPe
OUTPut:ALARm:SLOPe?
OUTPut:ALARm{1|2|3|4}:CLEar
OUTPut:ALARm{1|2|3|4}:SOURce
OUTPut:ALARm{1|2|3|4}:SOURce?
OUTPut:ALARm{1|2|3|4}:CLEarOUTPut:ALARm:CLEar:ALLSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
OUTPut:ALARm{1|2|3|4}:CLEar
OUTPut:ALARm:CLEar:ALL
Description
TheOUTPut:ALARm{1|2|3|4}:CLEarcommandclearsthespecifiedalarmoutputline.TheOUTPut:ALARm:CLEar:ALLcommandclearsallfouralarmoutputlines.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Youcanmanuallycleartheoutputlinesatanytime(evenduringascan)andthealarmdatainmemoryisnotcleared(however,dataisclearedwhenyouinitiateanewscan).Thealarmoutputsarealsoclearedwhenyouinitiateanewscan.
AFactoryReset(*RSTcommand)clearsallfouralarmoutputsbutdoesnotclearthealarmqueueineitherconfiguration.
Examples
Thefollowingcommandclearsalarmoutputline2.
OUTP:ALAR2:CLE
Thefollowingcommandclearsallfouralarmoutputlines.
OUTP:ALAR:CLE:ALL
SeeAlsoOUTPutSubsystemIntroduction
OUTPut:ALARm:MODE
OUTPut:ALARm:SLOPe
OUTPut:ALARm{1|2|3|4}:SOURce
OUTPut:ALARm:MODESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
OUTPut:ALARm:MODE<mode>
OUTPut:ALARm:MODE?
Description
ThiscommandselectstheconfigurationofthefourTTLalarmoutputlines(theselectedconfigurationappliestoallfouralarmoutputlines).Thefouralarmoutputsareavailablefromtherear-panelAlarmOutputconnector.
LatchMode:Inthismode(default),thecorrespondingoutputlineislatchedtruewhenthefirstalarmoccursandremainsasserteduntilyouclearitbyinitiatinganewscanorcyclingpower.Youcanmanuallycleartheoutputlinesatanytime(evenduringascan)andthealarmdatainmemoryisnotcleared(however,dataisclearedwhenyouinitiateanewscan).
TrackMode:Inthismode,thecorrespondingoutputlineisassertedonlywhileachannel'sreadingcrossesalimitandsubsequentreadingsremainoutsidethelimit.Whenareadingreturnstowithinlimits,theoutputlineisautomaticallycleared.Youcanmanuallycleartheoutputlinesatanytime(evenduringascan)andthealarmdatainmemoryisnotcleared(however,dataisclearedwhenyouinitiateanewscan).Thealarmoutputsarealsoclearedwhenyouinitiateanewscan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<mode> Discrete{LATCh|TRACk}
Thisisarequiredparameter.
ThefactorydefaultisLATCh
Remarks
AFactoryReset(*RSTcommand)clearsallfouralarmoutputsbutdoesnotclearthealarmqueueineitherconfiguration.
ReturnFormat
ThequeryreturnsLATCorTRAC.Theselectedconfigurationappliestoallfouralarmoutputlines.
Examples
Thefollowingcommandenablesthetrackmodeonallfouralarmoutputlines.
OUTP:ALAR:MODETRAC
Thefollowingqueryreturnstheconfigurationofthefouralarmoutputlines.
OUTP:ALAR:MODE?
TypicalResponse:TRAC
SeeAlsoOUTPutSubsystemIntroduction
OUTPut:ALARm:SLOPe
OUTPut:ALARm{1|2|3|4}:SOURce
OUTPut:ALARm{1|2|3|4}:CLEar
OUTPut:ALARm:SLOPeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
OUTPut:ALARm:SLOPe<edge>
OUTPut:ALARm:SLOPe?
Description
ThiscommandselectstheslopeofthepulsefromthefourTTLalarmoutputs(theselectedconfigurationappliestoallfouralarmoutputlines).Thefouralarmoutputsareavailablefromtherear-panelAlarmOutputconnector.
Ifyouselectthenegative/fallingedge,0V(TTLlow)indicatesanalarm.Ifyouselectthepositive/risingedge,+5V(TTLhigh)indicatesanalarm.
Changingtheslopeoftheoutputlinesmaycausethelinestochangestate.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizer)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<edge> Discrete {NEGative|POSitive} Thisisarequiredparameter.
ThekeywordNEGativereferstoafallingedge,andthekeywordPOSitivereferstoarisingedge,asshownbelow.
Remarks
AFactoryReset(*RSTcommand)resetstheslopetothenegative/fallingedge.
ReturnFormat
ThequeryreturnsNEGorPOS.Theselectedconfigurationappliestoallfouralarmoutputlines.
Examples
Thefollowingcommandselectsthepositive/risingedgeonallfouralarmoutputlines.
OUTP:ALAR:SLOPPOS
Thefollowingqueryreturnstheslopeofthefouralarmoutputlines.
OUTP:ALAR:SLOPE?
TypicalResponse:POS
SeeAlsoOUTPutSubsystemIntroduction
OUTPut:ALARm:MODE
OUTPut:ALARm{1|2|3|4}:SOURce
OUTPut:ALARm{1|2|3|4}:CLEar
OUTPut:ALARm{1|2|3|4}:SOURceSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
OUTPut:ALARm{1|2|3|4}:SOURce(@<ch_list>)
OUTPut:ALARm{1|2|3|4}:SOURce?
Description
Thiscommandassignsoneoffouralarmnumberstoreportanyalarmconditionsonthespecifiedmultiplexerordigitalchannels.
Onthedigitalmodules,youcanconfiguretheinstrumenttogenerateanalarmwhenaspecificbitpatternorbitpatternchangeisdetectedonadigitalinputchannelorwhenaspecificcountisreachedonatotalizerchannel.Thesechannelsdonothavetobepartoftheactivescanlisttogenerateanalarm.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Youcanassignmultiplechannelstoanyofthefouravailablealarms(numbered1through4,seeOUTPut:ALARm<n>:SOURcecommand).Forexample,youcanconfiguretheinstrumenttogenerateanalarmontheAlarm1outputwhenalimitisexceededonanyofchannels103,205,or310.Youcannot,however,assignalarmsonaspecificchanneltomorethanonealarmnumber.
AFactoryReset(*RSTcommand)clearsallalarmlimitsandturnsoffallalarms.AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotclearthealarmlimitsanddoesnotturnoffalarms.
ReturnFormat
ThequeryreturnsaseriesofchannelnumbersinDefinite-LengthBlockformat.Thesyntaxisapoundsign(#)followedbyanon-zerodigitrepresentingthenumberofdigitsinthedecimalintegertofollow.Thisdigitisfollowedbyadecimalintegerindicatingthenumberof8-bitdatabytestofollow.Thisisfollowedbyablockofdatacontainingthespecifiednumberofbytes.
Forexample:
Anemptyscanlist(onewithnochannelsselected)willreturn"#13(@)".
Examples
ThefollowingcommandassignsAlarm2toreportanyalarmconditionsonchannels03and13inslot100.
OUTP:ALAR2:SOUR(@103,113)
ThefollowingqueryreturnsthechannelsassignedtoAlarm2.
OUTP:ALAR2:SOUR?
TypicalResponse:#210(@103,113)
SeeAlsoOUTPutSubsystemIntroduction
CALCulate:LIMit:LOWer
CALCulate:LIMit:UPPer
OUTPut:ALARm:MODE
OUTPut:ALARm:SLOPe
OUTPut:ALARm{1|2|3|4}:CLEar
ROUTeSubsystemIntroduction
CommandSummaryROUTe:CHANnel:ADVance:SOURce
ROUTe:CHANnel:ADVance:SOURce?
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay?
ROUTe:CHANnel:DELay:AUTO
ROUTe:CHANnel:DELay:AUTO?
ROUTe:CHANnel:FWIRe
ROUTe:CHANnel:FWIRe?
ROUTe:CLOSe
ROUTe:CLOSe?
ROUTe:CLOSe:EXCLusive
ROUTe:DONE?
ROUTe:MONitor
ROUTe:MONitor?
ROUTe:MONitor:DATA?
ROUTe:MONitor:STATe
ROUTe:MONitor:STATe?
ROUTe:OPEN
ROUTe:OPEN?
ROUTe:SCAN
ROUTe:SCAN?
ROUTe:SCAN:SIZE?
ROUTe:CHANnel:ADVance:SOURceSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:CHANnel:ADVance:SOURce<source>
ROUTe:CHANnel:ADVance:SOURce?
Description
Thiscommandselectsthesourcetoprovidethechanneladvancesignaltothenextchannelinthescanlistforexternalscanning.Whenthechanneladvancesignalisreceived,theinstrumentopensthecurrentlyselectedchannelandclosesthenextchannelinthescanlist.TheinstrumentwillacceptanexternalTTLtriggerpulse,asoftware(bus)command,oranimmediate(continuous)scantrigger.
ThiscommandisvalidonlywhentheinternalDMMisdisabled(seeINSTrument:DMMcommand)orremovedfromtheKeysight34970A/34972A.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<source> Discrete {EXTernal|BUS|IMMediate} Thisisarequiredparameter.
ThefactorydefaultisEXTernal
Remarks
FortheEXTernalsource,the34970A/34972Awillacceptahardwaretriggerappliedtotherear-panelChanAdvInputline(Pin6).ForanexternaldevicesuchasaDMM,thetriggerreceivedbythe34970A/34972AisnormallysourcedbytheDMM'sVoltmeterCompleteoutputsignal.The34970A/34972Aadvancestothenextchannelinthescanlisteachtimealow-trueTTLpulseisreceived.
FortheBUS(software)source,the34970A/34972Aistriggeredbythe*TRGcommandreceivedovertheremoteinterface.The*TRGcommandwillnotbeacceptedunlessthe34970A/34972Aisinthe"wait-for-trigger"state(seeINITiatecommand).IftheinternalDMMreceivesanexternaltriggerbeforethenext"waitingfortrigger"state,itwillbufferone*TRGcommandandthenignoreanyadditionaltriggersreceived(noerrorisgenerated).
FortheIMMediate(continuous)source,thechanneladvancesignalisalwayspresent.
Thechanneladvancesignalisignoredunlessyouhaveinitiatedthescan(INITiatecommand)andhavereceivedascantrigger(TRIGger:SOURcecommand).AlthoughtheROUTe:CHANnel:ADVance:SOURcecommandsharessomeofthesamesignalsastheTRIGger:SOURcecommand,theycannotbesettothesamesource(exceptIMMediate).Ifyouattempttoselectthesamesource,anerrorisgeneratedandtheTRIGger:SOURceisresettoIMMediate.
Whenthefirsttriggerisreceived,the34970A/34972Aclosesthefirstchannelinthescanlistwithoutwaitingforthespecifiedchanneladvancesource.IfthechanneladvancesourceisEXTernalandthe34970A/34972Areceivesaneventbeforeitisready,itwillbufferoneeventandthenignoreanyadditionaleventsreceived(noerrorisgenerated).
Afterthefinalchannelinthescanlistisclosed,onemorechanneladvanceeventmustbereceivedtocompletethescan.
Achanneladvancesignalisnotrequiredfordigitalinputortotalizerchannelsincludedinthescanlist.Measurementsonthesechannelsarestillperformedbythe34970A/34972Aanddonotrequiresynchronizationwiththeexternalinstrument.
ReturnFormat
Thequeryreturnsthepresentchanneladvancesource:"EXT","BUS",or"IMM".
Examples
Thefollowingprogramsegmentconfiguresthe34970A/34972Aforscanningusinganexternalchanneladvancesource.Inthisconfiguration,the34970A/34972Aadvancestothenextchannelinthescanlisteachtimealow-trueTTLpulseisreceived.
INST:DMMOFF!DisableinternalDMM
ROUT:SCAN(@101:120)!Configurescanlist
TRIG:SOURIMM!Settriggersource
TRIG:COUN5!Settriggercount
ROUT:CHAN:ADV:SOUREXT!Setchanneladvancesource
Thefollowingqueryreturnsthechanneladvancesourcecurrentlyselectedonthe34970A/34972A.
ROUT:CHAN:ADV:SOUR?
TypicalResponse:EXT
SeeAlsoROUTeSubsystemIntroduction
INITiate
INSTrument:DMM
ROUTe:CHANnel:FWIRe
TRIGger:SOURce
ROUTe:CHANnel:DELaySyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:CHANnel:DELay<seconds>,(@<ch_list>)
ROUTe:CHANnel:DELay?(@<ch_list>)
Description
Thiscommandaddsadelaybetweenmultiplexerchannelsinthescanlist(usefulforhigh-impedanceorhigh-capacitancecircuits).Thedelayisinsertedbetweentherelayclosureandtheactualmeasurementoneachchannel,inadditiontoanydelaythatwillimplicitlyoccurduetorelaysettlingtime.Theprogrammedchanneldelayoverridesthedefaultchanneldelaythattheinstrumentautomaticallyaddstoeachchannel.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<seconds> Numeric Anumberfrom0to60,with1msresolution.
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Remarks
Youcanselectauniquedelayforeachchannelonthemodule.Thedefaultchanneldelayisautomatic;theinstrumentdeterminesthedelaybasedonfunction,range,integrationtime,andACfiltersetting.
Thechanneldelayisvalidonlywhilescanning.Ifnochannelshavebeenassignedtothescanlist(seeROUTe:SCANcommand),thespecifiedchanneldelayisignored(noerrorisgenerated).
Toensureyouaregettingthemostaccuratemeasurementspossible,usecarewhensettingthechanneldelaylessthanthedefaultvalue(Automatic).Thedefaultchanneldelayisdesignedtooptimizeparameters,suchassettlingtime,forthemostaccuratemeasurements.
TheCONFigureandMEASure?commandssetthechanneldelaytoAutomatic.
TheinstrumentsetsthechanneldelaytoAutomaticafteraFactoryReset(*RSTcommand).
ReturnFormat
Thequeryreturnsthedelayinsecondsintheform"+1.00000000E+00"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandaddsa2-secondchanneldelaytochannels03and13inslot100.
ROUT:CHAN:DEL2,(@103,113)
Thefollowingqueryreturnsthechanneldelayselectedonchannels03and13inslot100.
ROUT:CHAN:DEL?(@103,113)
TypicalResponse:+2.00000000E+00,+2.00000000E+00
SeeAlsoROUTeSubsystemIntroduction
ROUTe:CHANnel:DELay:AUTO
ROUTe:SCAN
ROUTe:CHANnel:DELay:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:CHANnel:DELay:AUTO<state>[,(@<ch_list>)]
ROUTe:CHANnel:DELay:AUTO?[(@<ch_list>)]
Description
Thiscommanddisablesorenablesanautomaticchanneldelayonthespecifiedchannels.Ifenabled,theinstrumentdeterminesthedelaybasedonfunction,range,integrationtime,andACfiltersetting.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
SelectingaspecificchanneldelayusingtheROUTe:CHANnel:DELaycommanddisablestheautomaticchanneldelay.
TheCONFigureandMEASure?commandssetthechanneldelaytoAutomatic.
TheinstrumentsetsthechanneldelaytoAutomaticafteraFactoryReset(*RSTcommand).
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandenablesanautomaticchanneldelayonchannels03and13inslot100.
ROUT:CHAN:DEL:AUTOON,(@103,113)
Thefollowingqueryreturnstheautomaticchanneldelaysettingsonchannels03and13inslot100.
ROUT:CHAN:DEL:AUTO?(@103,113)
TypicalResponse:1,1
SeeAlsoROUTeSubsystemIntroduction
ROUTe:CHANnel:DELay
ROUTe:CHANnel:FWIReSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:CHANnel:FWIRe<state>[,(@<ch_list>)]
ROUTe:CHANnel:FWIRe?[(@<ch_list>)]
Description
Thiscommandconfiguresthespecifiedchannelsfor4-wireexternalscanningwithouttheinternalDMM.Whenenabled,channelnispairedwithchanneln+10(34901A)orn+8(34902A)toprovidesourceandsenseconnections.
ThiscommandisvalidonlywhentheinternalDMMisdisabled(seeINSTrument:DMMcommand)orremovedfromtheKeysight34970A/34972A.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1}
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
If<ch_list>isomitted,thiscommandappliestothecurrentscanlist.
Remarks
SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
TheROUTe:CLOSe,ROUTe:CLOSe:EXCLusive,andROUTe:OPENcommandsignorethecurrentROUTe:CHANnel:FWIResetting(ifnochannelsareinthescanlist).
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandconfigureschannels03and05inslot100for4-wireexternalscanning.
INST:DMMOFF!DisableinternalDMM
ROUT:CHAN:FWIRON,(@103,105)!Enable4-wire
configuration
Thefollowingqueryreturnsthe4-wireconfigurationselectedonchannels03and05inslot100.
ROUT:CHAN:FWIR?(@103,105)
TypicalResponse:1,1
SeeAlsoROUTeSubsystemIntroduction
INSTrument:DMM
ROUTe:CHANnel:ADVance:SOURce
ROUTe:CLOSeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:CLOSe(@<ch_list>)
ROUTe:CLOSe?(@<ch_list>)
Description
Thiscommandclosesthespecifiedchannelsonamultiplexerorswitchmodule.Onthemultiplexermodules,ifanychannelonthemoduleisdefinedtobepartofthescanlist,attemptingtosendthiscommandwillresultinanerror.
UsedWith:
Allmodulesexcept34907A
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Forthematrixmodule(34904A),thechannelnumberrepresentstheintersectionofthedesiredrowandcolumn.Forexample,channel234representstheintersectionofrow3andcolumn4onthemoduleinslot200(assumestwo-wiremode).Formoreinformation,seethesimplifiedschematics.
TheRFMultiplexermodules(34905A,34906A)willnotrespondtotheROUTe:OPENcommand(anerrorisgenerated).To"open"achannelonthesemodules,sendtheROUTe:CLOSecommandtoadifferentchannelinthesamebank.
Aspartofthescansetup,theROUTe:SCANcommandexaminesthescanlistanddetermineswhichchannelrelaysandAnalogBusrelayswillbeimpactedbythescan.Thefollowingruleswillapplyoncethescanisinitiatedandwillimpactwhatrelayscanbemanuallyopenedandclosed.
a. Whenthescanisinitiated,theinstrumentwillopenallchannelsinmodulesthatcontainoneormorechannelsinthescanlist.
b. Whilethescanisrunning,theinstrumentprohibitsuseofallchannelsinmodulesthatcontainoneormorechannelsinthespecified<ch_list>(thesechannelsarededicatedtothescan).
ReturnFormat
Thequeryreturns1ifthespecifiedchannelisclosedor0ifthespecifiedchannelisopen.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandcloseschannels03and13inslot100(noAnalogBusconnectionsaremade).
ROUT:CLOS(@103,113)
Thefollowingcommandcloseschannel03onthematrixmoduleinslot300.
ROUT:CLOS(@303)
Thefollowingqueryreadsthestateofchannels03and13inslot100(1=closed;0=open).
ROUT:CLOS?(@103,113)
TypicalResponse:1,1
SeeAlsoROUTeSubsystemIntroduction
DIAGnostic:RELay:CYCLes?
ROUTe:CLOSe:EXCLusive
ROUTe:OPEN
ROUTe:CLOSe:EXCLusiveSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
ROUTe:CLOSe:EXCLusive(@<ch_list>)
Description
Thiscommandopensallchannelsonamultiplexerorswitchmoduleandthenclosesthespecifiedchannels.Onthemultiplexermodules,ifanychannelonthemoduleisdefinedtobepartofthescanlist,attemptingtosendthiscommandwillresultinanerror.
UsedWith:
Allmodulesexcept34907A
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Forthematrixmodules(34904A),thechannelnumberrepresentstheintersectionofthedesiredrowandcolumn.Forexample,channel234representstheintersectionofrow3andcolumn4onthemoduleinslot200(assumestwo-wiremode).Formoreinformation,seethesimplifiedschematics.
Thiscommandopensallchannelsfirst,andthenclosesthechannelsinthe<ch_list>,oneatatime.Beforeitcloseseachchannel,itopensallpreviouschannels.
TheRFMultiplexermodules(34905A,34906A)willnotrespondtotheROUTe:OPENcommand(anerrorisgenerated).To"open"achannelonthesemodules,sendtheROUTe:CLOSe:EXCLusivecommandtoadifferentchannelinthesamebank.
Example
Thefollowingcommandopensallchannelsandthencloseschannel03onthematrixmoduleinslot300.
ROUT:CLOS:EXCL(@303)
SeeAlsoROUTeSubsystemIntroduction
ROUTe:CLOSe
ROUTe:OPEN
ROUTe:DONE?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
ROUTe:DONE?
Description
Thisqueriesthestatusofallrelayoperationsoncardsnotinvolvedinthescanandreturnsa1whenallrelayoperationsarefinished(evenduringascan).
ReturnFormat
Thequeryreturnsa1.
Example
Thefollowingqueryreturnsa1whenallrelayoperationsarefinished.
ROUT:DONE?
TypicalResponse:1
SeeAlsoROUTeSubsystemIntroduction
ROUTe:MONitorSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:MONitor(@<channel>)
ROUTe:MONitor?
Description
Thiscommand/queryselectsthechanneltobedisplayedonthefrontpanel.Onlyonechannelcanbemonitoredatatime.
Parameters
Name Type RangeofValues
DefaultValue
<channel> ChannelAsinglechannel,specifiedasinthefollowingexamples.
(@310)-channel10onthemoduleinslot300.
(@214)-channel14onthemoduleinslot200.
Thisisarequiredparameter.
Remarks
Channelsmustbeconfiguredforameasurementinordertobemonitored(seeCONFigureandSENSecommands).Configuringachannelforameasurementmakesitmonitorableandmakesitpartofthescanlist.
AscanalwayshaspriorityovertheMonitorfunction(seeROUTe:SCANcommand).
Anychannelthatcanbe"read"bytheinstrumentcanbemonitored.Thisincludesanycombinationoftemperature,voltage,resistance,current,frequency,orperiodmeasurementsonmultiplexerchannels.Youcanalsomonitoradigitalinputchannelorthetotalizercountonthedigitalmodules.
Mx+BscalingandalarmlimitsareappliedtotheselectedchannelduringaMonitorandallalarmdataisstoredinthealarmqueue(whichwillbeclearedifpowerfails).
Formonitoroperationsusingamultiplexermodule,nomeasurementsaretakeniftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredformonitoroperationsonthedigitalmodules.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.
Thecountonatotalizerchannelisnotresetwhenitisbeingmonitored(theMonitorignoresthetotalizerresetmode).
ReturnFormat
ThequeryreturnstheMonitorchannelinDefinite-LengthBlockformat.Thesyntaxisapoundsign(#)followedbyanon-zerodigitrepresentingthenumberofcharacterstofollow.Thisdigitisfollowedbyadecimalintegerindicatingthenumberofdatabytestofollow.Thisisfollowedbyablockofdatacontainingthespecifiednumberofbytes.Thequeryalwaysreturnsthechannelcurrentlydisplayedonthefrontpanel.
Forexample:
Examples
Thefollowingprogramsegmentconfigureschannel3inslot100forDCvoltagemeasurements,enablesmonitoringonthechannel,andturnsontheMonitormode.
CONF:VOLT:DC(@103)
ROUT:MON:CHAN(@103)
ROUT:MON:STATON
ThefollowingcommandqueriesthechannelcurrentlyselectedastheMonitorchannel.
ROUT:MON:CHAN?
TypicalResponse:#16(@103)
SeeAlsoROUTeSubsystemIntroduction
ROUTe:MONitor:STATe
ROUTe:MONitor:DATA?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:MONitor:DATA?
Description
Thisqueryreadsthemonitordatafromtheselectedchannel.Itreturnsthereadingonly;theunits,time,channel,andalarminformationarenotreturned(theFORMat:READingcommandsdonotapplytomonitorreadings).
Remarks
IftheMonitormodeisnotcurrentlyenabled,thisqueryreturnsanerrorindicatingthatitisunabletoperformtherequestedoperation.
ReadingsacquiredduringaMonitorarenotstoredinmemorybuttheyaredisplayedonthefrontpanel;however,allreadingsfromascaninprogressatthesametimearestoredinmemory.
ReturnFormat
ThequeryreturnsonereadingfortheMonitorchannel,intheformat+1.12345678E+01.Ifnodataisavailableforthespecifiedchannel,instrumentwaitsfordatatobecomeavailable.
Examples
ThefollowingqueryreturnsonereadingfromtheMonitorchannel.
ROUT:MON:DATA?
TypicalResponse:+1.84280000E-05
SeeAlsoROUTeSubsystemIntroduction
ROUTe:MONitor
ROUTe:MONitor:STATe
ROUTe:MONitor:STATeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:MONitor:STATe<mode>
ROUTe:MONitor:STATe?
Description
ThiscommanddisablesorenablestheMonitormode.TheMonitormodeisequivalenttomakingcontinuousmeasurementsonasinglechannelwithaninfinitescancount.Onlyonechannelcanbemonitoredatatimebutyoucanchangethechannelbeingmonitoredatanytime.Thisfeatureisusefulfortroubleshootingyoursystembeforeatestorforwatchinganimportantsignal.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizer)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
Remarks
Channelsmustbeconfiguredforameasurementinordertobemonitored(seeCONFigureandSENSecommands).Configuringachannelforameasurementmakesitmonitorableandmakesitpartofthescanlist.
TheMonitormodeisautomaticallyenabledonallchannelsthatarepartoftheactivescanlist(seeROUTe:SCANcommand).
AscanalwayshaspriorityovertheMonitorfunction(seeROUTe:SCANcommand).
TheMonitormodeignoresalltriggersettings(seeTRIGger:SOURcecommand)andtakescontinuousreadingsontheselectedchannelusingtheIMMediate(continuous)source.
Anychannelthatcanbe"read"bytheinstrumentcanbemonitored.Thisincludesanycombinationoftemperature,voltage,resistance,current,frequency,orperiodmeasurementsonmultiplexerchannels.Youcanalsomonitoradigitalinputchannelorthetotalizercountonthedigitalmodules.
Mx+BscalingandalarmlimitsareappliedtotheselectedchannelduringaMonitorandallalarmdataisstoredinthealarmqueue(whichwillbeclearedifpowerfails).
Formonitoroperationsusingamultiplexermodule,nomeasurementsaretakeniftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredformonitoroperationsonthedigitalmodules.
Thecountonatotalizerchannelisnotresetwhenitisbeingmonitored(theMonitorignoresthetotalizerresetmode).
ReadingsacquiredduringaMonitorarenotstoredinmemorybut
theyaredisplayedonthefrontpanel;however,allreadingsfromascaninprogressatthesametimearestoredinmemory.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingprogramsegmentconfigureschannel3inslot100forDCvoltagemeasurements,enablesmonitoringonthechannel,andturnsontheMonitormode.
CONF:VOLT:DC(@103)
ROUT:MON:CHAN(@103)
ROUT:MON:STATON
ThefollowingqueryreturnsthestateoftheMonitormode.
ROUT:MON:STAT?
TypicalResponse:1
SeeAlsoROUTeSubsystemIntroduction
ROUTe:CLOSe
ROUTe:MONitor:DATA?
ROUTe:OPEN
ROUTe:OPENSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:OPEN(@<ch_list>)
ROUTe:OPEN?(@<ch_list>)
Description
Thiscommandopensthespecifiedchannelsonamultiplexerorswitchmodule.
UsedWith:
Allmodulesexcept34907A
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Forthematrixmodules,thechannelnumberrepresentstheintersectionofthedesiredrowandcolumn.Forexample,channel234representstheintersectionofrow3andcolumn4onthemoduleinslot200(assumestwo-wiremode).Formoreinformation,seethesimplifiedschematics.
TheRFMultiplexermodules(34905A,34906A)willnotrespondtotheROUTe:OPENcommand(anerrorisgenerated).To"open"achannelonthesemodules,sendtheROUTe:CLOSecommandtoadifferentchannelinthesamebank.
Aspartofthescansetup,theROUTe:SCANcommandexaminesthescanlistanddetermineswhichchannelrelaysandAnalogBusrelayswillbeimpactedbythescan.Thefollowingruleswillapplyoncethescanisinitiatedandwillimpactwhatrelayscanbemanuallyopenedandclosed.
a. Whenthescanisinitiated,theinstrumentwillopenallchannelsinmodulesthatcontainoneormorechannelsinthescanlist.
b. Whilethescanisrunning,theinstrumentprohibitsuseofallchannelsinmodulesthatcontainoneormorechannelsinthespecified<ch_list>(thesechannelsarededicatedtothescan).
ReturnFormat
Thequeryreturns1ifthespecifiedchannelisopenor0ifthespecifiedchannelisclosed.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandopenschannels03and13inslot100.
ROUT:OPEN(@103,113)
Thefollowingcommandopenschannel03onthematrixmoduleinslot300.
ROUT:OPEN(@303)
Thefollowingcommandopenschannels01through08onthematrixmoduleinslot300.
ROUT:OPEN(@301:308)
Thefollowingqueryreadsthestateofchannels03and06inslot100(1=open;0=closed).
ROUT:OPEN?(@103,106)
TypicalResponse:1,1
SeeAlsoROUTeSubsystemIntroduction
ROUTe:CLOSe
ROUTe:SCANSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
ROUTe:SCAN(@<scan_list>)
ROUTe:SCAN?
Description
Thiscommandselectsthechannelstobeincludedinthescanlist.ThiscommandisusedinconjunctionwiththeCONFigurecommandstosetupanautomatedscan.Thespecifiedchannelssupersedeanychannelspreviouslydefinedtobepartofthescanlist.Tostartthescan,usetheINITiateorREAD?command.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizer)
34908A40ChannelSingle-EndedMultiplexerModule
Toremoveallchannelsfromthepresentscanlist,send"ROUT:SCAN(@)".
Parameters
Name Type RangeofValues DefaultValue
<scan_list> ScanList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Toremoveallchannelsfromthescanlist,issuethecommandROUT:SCAN(@).
Theinstrumentscansthelistofchannelsinascendingorderfromslot100throughslot300(channelsarere-orderedasneeded).Whenyouspecifyarangeofchannelsinthe<scan_list>,thechannelsarealwayssortedinascendingorder.Therefore,(@109:101)willalwaysbeinterpretedas101,102,103,etc.
YoucanuseeithertheinternalDMMoranexternalinstrumenttomakemeasurementsofyourconfiguredchannels.However,the34970A/34972Aallowsonlyonescanlistatatime;youcannotscansomechannelsusingtheinternalDMMandothersusinganexternalinstrument.Readingsarestoredin34970A/34972AmemoryonlywhentheinternalDMMisused,exceptfordigitalinputandtotalizerchannels.
Youcanstoreatleast50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Youcanreadthecontentsofmemoryatanytime,evenduringascan.Readingmemoryisnotclearedwhenyoureadit.
Eachtimeyoustartanewscan,theinstrumentclearsallreadings(includingalarmdata)storedinreadingmemoryfromthepreviousmeasurement.Therefore,thecontentsofmemoryarealwaysfromthemostrecentmeasurement.
Ifyouabortascanthatisrunning(seeABORtcommand),theinstrumentwillterminateanyreadinginprogress(readingsarenotclearedfrommemory).Ifascanisinprogresswhenthecommandisreceived,thescanwillnotbecompletedandyoucannotresumethescanfromwhereitleftoff.Notethatifyouinitiateanewscan,
allreadingsareclearedfrommemory.
TheCONFigureandMEASure?commandsoverwritethescanlist.
Thepresentscanlistisstoredinnon-volatilememoryandwillberetainedwhenpoweristurnedoff.
ReturnFormat
ThequeryreturnsalistofchannelnumbersinDefinite-LengthBlockformat.Thesyntaxisapoundsign(#)followedbyanon-zerodigitrepresentingthenumberofcharacterstofollow.Thisdigitisfollowedbyadecimalintegerindicatingthenumberofdatabytestofollow.Thisisfollowedbyablockofdatacontainingthespecifiednumberofbytes.Anemptyscanlist(onewithnochannelsselected)willindicatedby"#13(@)"
Forexample:
Examples
ThefollowingprogramsegmentshowshowtousetheCONFigurecommandtoconfiguretwochannelsforDCvoltagemeasurements.TheROUTe:SCANcommandputsthetwochannelsintothescanlist(andredefinesthescanlist).TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"stateandthensendsthereadingstomemory.TheFETCh?commandtransfersthereadingsfrommemorytotheinstrument'soutputbuffer.
CONF:VOLT:DC10,0.003,(@103,108)
ROUT:SCAN(@103,108)
INIT
FETC?
TypicalResponse:+4.27150000E-03,+1.32130000E-03
Thefollowingcommandclearsthepresentscanlist.
ROUT:SCAN(@)
Thefollowingqueryreturnsalistofchannelsinthepresentscanlist.
ROUT:SCAN?
TypicalResponse:#210(@103,108)
SeeAlsoROUTeSubsystemIntroduction
ABORt
INITiate
READ?
ROUTe:SCAN:SIZE?
ROUTe:SCAN:SIZE?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
ROUTe:SCAN:SIZE?
Description
Thisqueryreturnsthenumberofchannelsinthescanlist.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizer)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Thepresentscanlistisstoredinnon-volatilememoryandwillberetainedwhenpoweristurnedoff.
ReturnFormat
Thequeryreturnsthenumberofchannelsasasignedintegerfrom0to120.
Example
Thefollowingqueryreturnsthenumberofchannelsinthescanlist.
ROUT:SCAN(@101:120)
ROUT:SCAN:SIZE?
TypicalResponse:+20
SeeAlsoROUTeSubsystemIntroduction
ROUTe:SCAN
SENSeSubsystemIntroductionIfyouspecifya<ch_list>withoneofthesecommands,that<ch_list>overwritesthecurrentscanlist.
CommandSummary
ACCurrent
[SENSe:]CURRent:AC:BANDwidth
[SENSe:]CURRent:AC:BANDwidth?
[SENSe:]CURRent:AC:RANGe
[SENSe:]CURRent:AC:RANGe?
[SENSe:]CURRent:AC:RANGe:AUTO
[SENSe:]CURRent:AC:RANGe:AUTO
[SENSe:]CURRent:AC:RESolution
[SENSe:]CURRent:AC:RESolution?
DCCurrent
[SENSe:]CURRent:DC:APERture
[SENSe:]CURRent:DC:APERture?
[SENSe:]CURRent:DC:NPLC
[SENSe:]CURRent:DC:NPLC?
[SENSe:]CURRent:DC:RANGe
[SENSe:]CURRent:DC:RANGe?
[SENSe:]CURRent:DC:RANGe:AUTO
[SENSe:]CURRent:DC:RANGe:AUTO
[SENSe:]CURRent:DC:RESolution
[SENSe:]CURRent:DC:RESolution?
ACVoltage
[SENSe:]VOLTage:AC:RANGe
[SENSe:]VOLTage:AC:RANGe?
[SENSe:]VOLTage:AC:RANGe:AUTO
[SENSe:]VOLTage:AC:RANGe:AUTO?
[SENSe:]VOLTage:AC:BANDwidth
[SENSe:]VOLTage:AC:BANDwidth?
DCCurrent
[SENSe:]VOLTage:DC:APERture
[SENSe:]VOLTage:DC:APERture?
[SENSe:]VOLTage:DC:NPLC
[SENSe:]VOLTage:DC:NPLC?
[SENSe:]VOLTage:DC:RANGe
[SENSe:]VOLTage:DC:RANGe?
[SENSe:]VOLTage:DC:RANGe:AUTO
[SENSe:]VOLTage:DC:RANGe:AUTO?
[SENSe:]VOLTage:DC:RESolution
[SENSe:]VOLTage:DC:RESolution?
2-WireResistance
[SENSe:]RESistance:APERture
[SENSe:]RESistance:APERture?
[SENSe:]RESistance:NPLC
[SENSe:]RESistance:NPLC?
[SENSe:]RESistance:OCOMpensated
[SENSe:]RESistance:OCOMpensated?
[SENSe:]RESistance:RANGe
[SENSe:]RESistance:RANGe?
[SENSe:]RESistance:RANGe:AUTO
[SENSe:]RESistance:RANGe:AUTO?
[SENSe:]RESistance:RESolution
[SENSe:]RESistance:RESolution?
4-WireResistance
[SENSe:]FRESistance:APERture
[SENSe:]FRESistance:APERture?
[SENSe:]FRESistance:NPLC
[SENSe:]FRESistance:NPLC?
[SENSe:]FRESistance:OCOMpensated
[SENSe:]FRESistance:OCOMpensated?
[SENSe:]FRESistance:RANGe
[SENSe:]FRESistance:RANGe?
[SENSe:]FRESistance:RANGe:AUTO
[SENSe:]FRESistance:RANGe:AUTO?
[SENSe:]FRESistance:RESolution
[SENSe:]FRESistance:RESolution?
Frequency
[SENSe:]FREQuency:APERture
[SENSe:]FREQuency:APERture?
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:RANGe:LOWer?
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]FREQuency:VOLTage:RANGe?
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
[SENSe:]FREQuency:VOLTage:RANGe:AUTO?
Period
[SENSe:]PERiod:APERture
[SENSe:]PERiod:APERture?
[SENSe:]PERiod:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe?
[SENSe:]PERiod:VOLTage:RANGe:AUTO
[SENSe:]PERiod:VOLTage:RANGe:AUTO?
Temperature
[SENSe:]TEMPerature:APERture
[SENSe:]TEMPerature:APERture?
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:NPLC?
[SENSe:]TEMPerature:RJUNction?
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated?
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]?
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE?
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated?
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]?
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE?
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk?
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction?
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE?
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE?
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE?
[SENSe:]TEMPerature:TRANsducer:TYPE
[SENSe:]TEMPerature:TRANsducer:TYPE?
DigitalI/OandTotalizer
[SENSe:]DIGital:DATA:{BYTE|WORD}?
[SENSe:]TOTalize:CLEar:IMMediate
[SENSe:]TOTalize:DATA?
[SENSe:]TOTalize:SLOPe
[SENSe:]TOTalize:SLOPe?
[SENSe:]TOTalize:STARt[:IMMediate]
[SENSe:]TOTalize:STOP[:IMMediate]
[SENSe:]TOTalize:TYPE
[SENSe:]TOTalize:TYPE?
Miscellaneous
[SENSe:]FUNCtion
[SENSe:]FUNCtion?
[SENSe:]ZERO:AUTO
[SENSe:]ZERO:AUTO?
[SENSe:]CURRent:AC:BANDwidthSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]CURRent:AC:BANDwidth{<filter>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:AC:BANDwidth?[{(@<ch_list>)|MIN|MAX}]
Description
TheinstrumentusesthreedifferentACfilterswhichenableyoutoeitheroptimizelowfrequencyaccuracyorachievefasterACsettlingtimes.Theinstrumentselectstheslow(3Hz),medium(20Hz),orfast(200Hz)filterbasedontheinputfrequencythatyouspecifywiththiscommandfortheselectedchannels.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module(channels21and22only)
Parameters
Name Type RangeofValues DefaultValue
<filter> Discrete {3|20|200} 20
<ch_list> ChannelList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslotnumber.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
ThiscommandappliestoACcurrentmeasurementsonly.
Forthe<filter>parameter,specifythelowestfrequencyexpectedintheinputsignalonthespecifiedchannels.Theinstrumentselectstheappropriatefilterbasedonthefrequencyyouspecify.
InputFrequency
DefaultSettlingDelay
MinimumSettlingDelay
3Hzto300kHz(Slow)
7seconds/reading
1.5seconds
20Hzto300kHz(Medium)
1second/reading
200ms
200Hzto300kHz(Fast)
0.12seconds/reading
20ms
TheCONFigureandMEASure?commandsautomaticallyselectthedefault20Hz(medium)filter.
Theinstrumentselectsthedefault20Hz(medium)filterafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ThesettlingdelayiscontrolledbytheROUTe:CHANnel:DELaycommand.YougetthedefaultdelaywithROUTe:CHANnel:DELay:AUTOON.
ReturnFormat
Thequeryreturns3(slow),20(medium),or200(fast)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandselectstheslowfilter(3Hz)onchannels21and22inslot100.
CURR:AC:BAND3,(@121,122)
ThefollowingqueryreturnstheACfiltersettingsonchannels21and22inslot100.
CURR:AC:BAND?(@121,122)
TypicalResponse:3,3
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]CURRent:AC:RANGe
CONFigure:CURRent:AC
[SENSe:]CURRent:AC:RANGe[SENSe:]CURRent:DC:RANGeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]CURRent:AC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]CURRent:AC:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:DC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]CURRent:DC:RANGe?[{(@<ch_list>)|MIN|MAX}]
Description
ThesecommandsselectthemeasurementrangeforACandDCcurrentmeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module(channels21and22only)
Parameters
Name Type RangeofValues DefaultValue
<range> DiscreteExpectedvalueinamps(rangesshownbelow).
10mA(MIN)100mA1A(MAX)
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslot
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
number.
Remarks
Selectingadiscreterangewilldisableautorangingonthespecifiedchannels(see[SENSe:]CURRent:AC:RANGe:AUTOand[SENSe:]CURRent:DC:RANGe:AUTOcommands).
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
TheinstrumentselectsautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstherangeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandselectsthe100mArangeonchannels21and22inslot100.
CURR:AC:RANG0.1,(@121,122)
Thefollowingqueryreturnstherangeselectedonchannels21and22inslot100.
CURR:AC:RANG?(@121,122)
TypicalResponse:+1.00000000E-01,+1.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:CURRent:AC
CONFigure:CURRent:DC
[SENSe:]CURRent:AC:RANGe:AUTO
[SENSe:]CURRent:DC:RANGe:AUTO
[SENSe:]CURRent:AC:RANGe:AUTO[SENSe:]CURRent:DC:RANGe:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]CURRent:AC:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]CURRent:AC:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]CURRent:DC:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]CURRent:DC:RANGe:AUTO?[(@<ch_list>)]
Description
ThesecommandsdisableorenableautorangingforACandDCcurrentmeasurementsonthespecifiedchannels.Autorangingisconvenientbecausetheinstrumentautomaticallyselectstherangeforeachmeasurementbasedontheinputsignaldetected.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module(channels21and22only)
Parameters
Name Type RangeofValues DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslotnumber.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Withautorangingenabled,theinstrumentselectsoneofthefollowingrangesbasedontheinputsignaldetected:
10mA100mA1A
Selectingadiscreterange(see[SENSe:]CURRent:AC:RANGecommand)willdisableautorangingonthespecifiedchannels.
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
TheinstrumentenablesautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelinthe<ch_list>.Multiplevaluesareseparatedbycommas.
Examples
Intheseexamples,youcouldsubstitutethenodenameDCforAC.
ThefollowingcommandturnsonACcurrentmeasurementautorangingfortwochannels.
CURR:AC:RANG:AUTO1,(@221:222)
Thefollowingqueryreturnsthevalueofautorangingforthreechannels.
CURR:AC:RANG:AUTO?(@221,321,322)
TypicalResponse:1,0,1
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]CURRent:AC:RESolution[SENSe:]CURRent:DC:RESolutionSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]CURRent:AC:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)][SENSe:]CURRent:AC:RESolution?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:DC:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)][SENSe:]CURRent:DC:RESolution?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandselectsthemeasurementresolutionforcurrentmeasurementsonthespecifiedchannels.Theinstrumentclearsallreadingsfrommemorywhenanewscanisinitiated,whenanymeasurementparametersarechanged(CONFigureandSENSecommands),andwhenthetriggeringconfigurationischanged(TRIGgercommands).Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module(channels21and22only)
Parameters
Name Type RangeofValues DefaultValue
<resolution> Numeric Desiredresolutioninamps. 0.000003xRange(1PLC)
<ch_list> ChannelList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslotnumber.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthe<resolution>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthehighestresolution;MAXselectsthelargestvalueaccepted,whichgivestheleastresolution.
Theinstrumentwilldispatchasettingsconflicterrorifyouissuethiscommandwhen[SENSe:]CURRent:AC:RANGe:AUTO(ACresolution)or[SENSe:]CURRent:DC:RANGe:AUTO(DCresolution)isONforoneormoreofthespecifiedchannels.
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001xRange
6½Digits
24
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]CURRent[:DC]:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,[SENSe:]CURRent[:DC]:NPLC,and[SENSe:]CURRent[:DC]:RESolutioncommandsautomaticallydisabletheaperturemode(thesecommandsselectanintegrationtimeinNPLCs).
Theinstrumentsetstheresolutionto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheresolutionintheform"+1.00000000E-04"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandsetsthemeasurementresolutionto0.01mAonchannels21and22inslot100.
CURR:DC:RES0.00001,(@121,122)
Thefollowingqueryreturnstheresolutionselectedonchannels21and22inslot100.
CURR:DC:RES?(@121,122)
CURR:DC:APER:ENAB?!Verifythataperturemodeis
disabled("0")
TypicalResponse:+1.00000000E-04,+1.00000000E-04
SeeAlsoSENSeSubsystemIntroduction
CONFigure:CURRent:AC
CONFigure:CURRent:DC
[SENSe:]CURRent:AC:RANGe:AUTO
[SENSe:]CURRent:DC:RANGe:AUTO
[SENSe:]CURRent:DC:APERture
[SENSe:]CURRent:DC:NPLC
[SENSe:]CURRent:DC:APERtureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]CURRent:DC:APERture{<time>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:DC:APERture?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandenablestheaperturemodeandsetstheintegrationtimeinseconds(calledaperturetime)forDCcurrentmeasurementsonthespecifiedchannels.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
YoushouldusethiscommandonlywhenyouwantprecisecontroloftheintegrationtimeoftheinternalDMM.Otherwise,specifyingintegrationtimeusingNPLC(see[SENSe:]CURRent[:DC]:NPLCcommand)executesfasterandoffersbetterpowerlinenoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module(channels21and22only)
Parameters
Name Type RangeofValues DefaultValue
<time> Numeric Desiredaperturetimeinsecondsbetween400µsand1second,with4µsresolution.MIN=400µs,MAX=1second
Aperturedisabled.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslotnumber.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthe<seconds>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthelowestresolution;MAXselectsthelargestvalueaccepted,whichgivesthehighestresolution.
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
TheCONFigure,MEASure?,[SENSe:]CURRent[:DC]:NPLC,[SENSe:]CURRent[:DC]:RESolutioncommandsautomaticallydisabletheaperturemode(thesecommandsselectanintegrationtimeinNPLCs).
TheaperturemodeisdisabledafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheaperturetimeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandenablestheaperturemodeandsetstheaperturetimeto300msonchannels21and22inslot100.
CURR:DC:APER300E-03,(@121,122)
Thefollowingqueryreturnstheaperturetimeselectedonchannels21and22inslot100.
CURR:DC:APER?(@121,12)CURR:DC:APER:ENAB?!Verify
thataperturemodeisenabled("1")
TypicalResponse:+3.00000000E-01,+3.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:CURRent:DC
[SENSe:]CURRent:DC:NPLC
[SENSe:]CURRent:DC:NPLCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]CURRent:DC:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:DC:NPLC?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandsetstheintegrationtimeinnumberofpowerlinecycles(PLCs)onthespecifiedchannels.Integrationtimeaffectsthemeasurementresolution(forbetterresolution,usealongerintegrationtime)andmeasurementspeed(forfastermeasurements,useashorterintegrationtime).Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Parameters
Name Type RangeofValues DefaultValue
<PLCs> Discrete 0.02|0.2|1|2|10|20|100|200}MIN=0.02PLC,MAX=200PLC
1PLC
<ch_list> ChannelList Oneormorechannels,
asshown:
(@321)-channel21onthemoduleinslot300.
(@221:222)-channels21through22onthemoduleinslot200.
(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.
Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslotnumber.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001xRange
6½Digits
24
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
TheNPLCcommandautomaticallyspecifies[SENSe:]ZERO:AUTOasOFFfor0.02to0.2PLCsandasONfor1PLCormore.
Thespecifiedintegrationtimeisusedforallmeasurementsontheselectedchannels.IfyouhaveappliedMx+Bscalingorhaveassignedalarmstotheselectedchannel,thosemeasurementsarealsomadeusingthespecifiedintegrationtime.MeasurementstakenduringtheMonitorfunctionalsousethespecifiedintegrationtime.
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]CURRent[:DC]:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,[SENSe:]CURRent[:DC]:NPLC,[SENSe:]CURRent[:DC]:RESolutioncommandsautomaticallydisabletheaperturemode(thesecommandsselectanintegrationtimeinNPLCs).
Theinstrumentsetstheintegrationtimeto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheintegrationtimeintheform"+1.00000000E+00"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandsettheintegrationtimeto0.2PLCsonchannels21and22inslot100.
CURR:DC:NPLC0.2,(@121,122)
Thefollowingqueryreturnstheintegrationtimesettingsonchannels21and22inslot100.
CURR:DC:NPLC?(@121,122)
TypicalResponse:+2.00000000E-01,+2.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:CURRent:DC
[SENSe:]CURRent:DC:APERture
[SENSe:]CURRent:DC:RESolution
[SENSe:]DIGital:DATA:{BYTE|WORD}?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]DIGital:DATA:{BYTE|WORD}?(@<ch_list>)
Description
Thisqueryconfiguresthespecifiedchannelsasinputsandreadsan8-bitbyteora16-bitworddigitalpatternfromthespecifieddigitalinputchannels.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormoredigital
I/Ochannels,asshown:
(@301)-channel01onthemoduleinslot300.
(@101:102,201,302)-channels01and02onthemodulesonslot100,channel01onthemoduleinslot200,andchannel02onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Toreadbothportssimultaneously(WORD),youmustsendthecommandtoport01(LSB)andneitherportcanbeincludedinthescanlist.
Thedigitalinputchannelsarenumbered"s01"(LSB)and"s02"(MSB),wheresisthefirstdigitoftheslotnumber.
ReturnFormat
TheoutputfromthiscommandisaffectedbytheFORMat:READingcommands.
Examples
Thefollowingcommandreadsthevalueonchannel02ofthemoduleinslot100.
[SENSe:]DIGital:DATA:BYTE?(@102)
TypicalResponse:+100
Thefollowingcommandreadsthevalueonchannels01and02ofthemoduleinslot200.
[SENSe:]DIGital:DATA:WORD?(@201)
TypicalResponse:+32103
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]FREQuency:APERture[SENSe:]PERiod:APERtureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]FREQuency:APERture{<seconds>|MIN|MAX}[,(@<ch_list>)][SENSe:]FREQuency:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]PERiod:APERture{<seconds>|MIN|MAX}[,(@<ch_list>)][SENSe:]PERiod:APERture?[{(@<ch_list>)|MIN|MAX}]
Description
Thesecommandsselecttheaperturetime(alsocalledgatetime)forfrequencyandperiodmeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<seconds> DiscreteDesiredgatetimeinseconds:
10ms(4½digits,MIN)
100ms(5½digits)
1second(6½digits,MAX)
100ms
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthe<seconds>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthelowestresolution;MAXselectsthelargestvalueaccepted,whichgivesthehighestresolution.
Becausefrequencyandperiodarerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
Theinstrumentsetstheaperturetimeto100msafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheaperturetimeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandsetsthegatetimeto10msonchannels03and13inslot100.
YoucansubstitutethenodenamePERiodwherethenodenameFREQappearsbelow.
FREQ:APER10E-03,(@103,113)
Thefollowingqueryreturnsthegatetimeselectedonchannels03and13inslot100.
FREQ:APER?(@103,113)
TypicalResponse:+1.00000000E-02,+1.00000000E-02
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FREQuency
CONFigure:PERiod
[SENSe:]FREQuency:RANGe:LOWerSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]FREQuency:RANGe:LOWer{<frequency>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FREQuency:RANGe:LOWer?[{(@<ch_list>)|MIN|MAX}]
Description
Theinstrumentusesthreedifferenttimeoutrangesforfrequencymeasurements.Theinstrumentselectstheslow(3Hz),medium(20Hz),orfast(200Hz)measurementtimeoutbasedontheinputfrequencythatyouspecifywiththiscommandfortheselectedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<frequency> Numeric Anintegerfrom3to300,000.
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Appliestofrequencymeasurementsonly.
Forthe<frequency>parameter,specifythelowestfrequencyexpectedintheinputsignalonthespecifiedchannels.Theinstrumentselectstheappropriatemeasurementtimeoutbasedonthefrequencyyouspecify.Attemptstomeasurefrequenciesbelowthespecifiedlimitmayfalselyreturnavalueof0.
InputFrequency Timeout
3Hzto300kHz(Slow)
1second
20Hzto300kHz(Medium)
100ms
200Hzto300kHz(Fast)
10ms
TheCONFigureandMEASure?commandsautomaticallyselectthe20Hz(medium)timeout.
Theinstrumentselectsthemediumtimeout(20Hz)afteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns3.0000000(slow),2.0000000E+1(medium),or2.0000000E+2(fast).
Examples
Foreachofthecommandsshownbelow,youcouldusethenodenamePERiodinplaceoftheFREQnodename.
Thefollowingcommandselectstheslowfilter(3Hz).
FREQ:RANG:LOW3
Thefollowingqueryreturnsthetimeoutsetting.
FREQ:RANG:LOW?
TypicalResponse:3.0000000
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FREQuency
CONFigure:PERiod
[SENSe:]FREQuency:VOLTage:RANGe[SENSe:]PERiod:VOLTage:RANGeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]FREQuency:VOLTage:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]FREQuency:VOLTage:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]PERiod:VOLTage:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]PERiod:VOLTage:RANGe?[{(@<ch_list>)|MIN|MAX}]
Description
Thesecommandsselectthevoltagerangeforfrequencyandperiodmeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<range> DiscreteDesiredrangeinvolts:
100mV(MIN)1V10V100V1000V(MAX)
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Selectingadiscreterangewilldisableautorangingonthespecifiedchannels.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
Becausefrequencyandperiodarerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
TheinstrumentenablesautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnsthevoltagerangeintheform"+1.00000000E+01".
Examples
Thefollowingcommandselectsthe10voltrangeforfrequencymeasurements.
FREQ:VOLT:RANG10
Thefollowingqueryreturnsthevoltagerangeselected.
FREQ:VOLT:RANG?
TypicalResponse:+1.00000000E+01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FREQuency
CONFigure:PERiod
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
[SENSe:]PERiod:VOLTage:RANGe:AUTO
[SENSe:]FREQuency:VOLTage:RANGe:AUTO[SENSe:]PERiod:VOLTage:RANGe:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]FREQuency:VOLTage:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]FREQuency:VOLTage:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]PERiod:VOLTage:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]PERiod:VOLTage:RANGe:AUTO?[(@<ch_list>)]
Description
Thesecommandsdisableorenablevoltageautorangingforfrequencyandperiodmeasurementsonthespecifiedchannels.Autorangingisconvenientbecausetheinstrumentautomaticallyselectstherangeforeachmeasurementbasedontheinputsignaldetected.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Withautorangingenabled,theinstrumentselectsoneofthefollowingrangesbasedontheinputsignaldetected:
100mV1V10V100V300V
Selectingadiscreterange(see[SENSe:]FREQuency:VOLTage:RANGecommand)willdisableautorangingonthespecifiedchannels.
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
Becausefrequencyandperiodarerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction
TheinstrumentenablesautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
Thefollowingcommanddisablesautoranging.
FREQ:VOLT:RANG:AUTOOFF
Thefollowingqueryreturnstheautorangingsetting.
FREQ:VOLT:RANG:AUTO?
TypicalResponse:0
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FREQuency
CONFigure:PERiod
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe
[SENSe:]RESistance:APERture[SENSe:]FRESistance:APERtureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]RESistance:APERture{<time>|MIN|MAX}[,(@<ch_list>)][SENSe:]RESistance:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:APERture{<time>|MIN|MAX}[,(@<ch_list>)][SENSe:]FRESistance:APERture?[{(@<ch_list>)|MIN|MAX}]
Description
Thesecommandsenabletheaperturemodeandsettheintegrationtime(<aperture_time>)insecondsfor2-wire(RESistance)and4-wire(FRESistance)resistancemeasurementsonthespecifiedchannels.
YoushouldusethiscommandonlywhenyouwantprecisecontroloftheintegrationtimeoftheinternalDMM.Otherwise,specifyingintegrationtimeusingNPLC(see[SENSe:]RESistance:NPLCcommand)executesfasterandoffersbetterpowerlinenoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)
Parameters
Name Type RangeofValues DefaultValue
<aperture_time> Numeric Anumberofseconds,from0.0004to4.
Thisisarequiredparameter.Youmustspecifythetime,orMINorMAX.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthe<seconds>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthelowestresolution;MAXselectsthelargestvalueaccepted,whichgivesthehighestresolution.
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction(see[SENSe:]FRESistance:APERturecommand).
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
TheCONFigure,MEASure?,[SENSe:]RESistance:NPLC,[SENSe:]RESistance:RESolution,[SENSe:]FRESistance:NPLC,and[SENSe:]FRESistance:RESolutioncommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
TheaperturemodeisdisabledafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheaperturetimeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Ineachofthefollowingexamples,youcouldreplacethenodenameFRESwithRESistance.
Thefollowingcommandenablestheaperturemodeandsetstheaperturetimeto300msonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.
FRES:APER300E-03,(@103,113)
Thefollowingqueryreturnstheaperturetimeselectedonchannels03and13inslot100.
FRES:APER?(@103,113)
FRES:APER:ENAB?!Verifythataperturemodeis
enabled("1")
TypicalResponse:+3.00000000E-01,+3.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FRESistance
CONFigure:RESistance
[SENSe:]FRESistance:NPLC
[SENSe:]RESistance:NPLC
[SENSe:]RESistance:NPLC[SENSe:]FRESistance:NPLCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]RESistance:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)][SENSe:]RESistance:NPLC?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)][SENSe:]FRESistance:NPLC?[{(@<ch_list>)|MIN|MAX}]
Description
Thesecommandssettheintegrationtimeinnumberofpowerlinecycles(PLCs)onthespecifiedchannels.Integrationtimeaffectsthemeasurementresolution(forbetterresolution,usealongerintegrationtime)andmeasurementspeed(forfastermeasurements,useashorterintegrationtime).
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)
Parameters
Name Type RangeofValues DefaultValue
<PLCs> Discrete {0.02|0.2|1|2|10|20|100|200|MIN|MAX} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001x 6½ 24
Range Digits
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
Thespecifiedintegrationtimeisusedforallmeasurementsontheselectedchannels.IfyouhaveappliedMx+Bscalingorhaveassignedalarmstotheselectedchannel,thosemeasurementsarealsomadeusingthespecifiedintegrationtime.MeasurementstakenduringtheMonitorfunctionalsousethespecifiedintegrationtime.
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]RESistance:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,[SENSe:]RESistance:NPLC,[SENSe:]FRESistance:NPLC,[SENSe:]RESistance:RESolution,and[SENSe:]FRESistance:RESolutioncommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
Theinstrumentsetstheintegrationtimeto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheintegrationtimeintheform"+1.00000000E+00"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Ineachofthefollowingexamples,youcouldreplacethenodenameFRESwithRESistance.
Thefollowingcommandsettheintegrationtimeto0.2PLCsonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.
FRES:NPLC0.2,(@103,113)
Thefollowingqueryreturnstheintegrationtimesettingsonchannels03and13inslot100.
FRES:NPLC?(@103,113)
FRES:APER:ENAB?!Verifythataperturemodeis
disabled("0")
TypicalResponse:+2.00000000E-01,+2.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]RESistance:APERture
[SENSe:]FRESistance:APERture
[SENSe:]RESistance:RESolution
[SENSe:]FRESistance:RESolution
[SENSe:]RESistance:OCOMpensated[SENSe:]FRESistance:OCOMpensatedSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
[SENSe:]RESistance:OCOMpensated<state>[,(@<ch_list>)][SENSe:]RESistance:OCOMpensated?[(@<ch_list>)]
[SENSe:]FRESistance:OCOMpensated<state>[,(@<ch_list>)][SENSe:]FRESistance:OCOMpensated?[(@<ch_list>)]
Description
OffsetcompensationremovestheeffectsofanyDCvoltagesinthecircuitbeingmeasured.Thetechniqueinvolvestakingthedifferencebetweentworesistancemeasurementsonthespecifiedchannels,onewiththecurrentsourceturnedonandonewiththecurrentsourceturnedoff.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultvalueisOFF.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Turningoffsetcompensationonwilldoublemeasurementtime.
Onceenabled,offsetcompensationisappliedtoboth2-wireand4-wireresistancemeasurementsonthespecifiedchannels.
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
TheCONFigureandMEASure?commandsautomaticallydisableoffsetcompensation.
TheinstrumentdisablesoffsetcompensationafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Ineachofthefollowingexamples,youcanreplacethenodenameRESwithFRES.
Thefollowingcommandenablesoffsetcompensationonchannels3and13inslot100.
RES:OCOMON,(@103,113)
Thefollowingqueryreturnstheoffsetcompensationsettingsonchannels03and13inslot100.
RES:OCOM?(@103,113)
TypicalResponse:1,1
SeeAlsoSENSeSubsystemIntroduction
CONFigure:RESistance
CONFigure:RESistance
[SENSe:]RESistance:RANGe[SENSe:]FRESistance:RANGeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]RESistance:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]RESistance:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]FRESistance:RANGe?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandselectsthemeasurementrangefor2-wire(RESistance)and4-wire(FRESistance)resistancemeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)
Parameters
Name Type RangeofValues DefaultValue
<range> DiscreteDesiredrangeinohms:
100Ω(MIN)1kΩ10kΩ100kΩ1MΩ10MΩ100MΩ(MAX)
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Selectingadiscreterangewilldisableautorangingonthespecifiedchannels(see[SENSe:]RESistance:RANGe:AUTOcommand).
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction(see[SENSe:]RESistance:RANGecommand).
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
TheinstrumentenablesautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstherangeintheform"+1.00000000E+03"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Inthefollowingexamples,youcansusbstitutethenodenameRESforFRES.
Thefollowingcommandselectsthe10kΩrangeonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.
FRES:RANG10E+3,(@103,113)
Thefollowingqueryreturnstherangeselectedonchannels03and13inslot100.
FRES:RANG?(@103,113)
TypicalResponse:+1.00000000E+04,+1.00000000E+04
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FRESistance
CONFigure:RESistance
[SENSe:]FRESistance:RANGe:AUTO
[SENSe:]RESistance:RANGe:AUTO
[SENSe:]RESistance:RANGe:AUTO[SENSe:]FRESistance:RANGe:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]RESistance:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]RESistance:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]FRESistance:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]FRESistance:RANGe:AUTO?[(@<ch_list>)]
Description
Thiscommanddisablesorenablesautorangingfor2-wire(RESistance)or4-wire(FRESistance)resistancemeasurementsonthespecifiedchannels.Autorangingisconvenientbecausetheinstrumentautomaticallyselectstherangeforeachmeasurementbasedontheinputsignaldetected.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultvalueisON.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Withautorangingenabled,theinstrumentselectsoneofthefollowingrangesbasedontheinputsignaldetected:
100Ω1kΩ10kΩ100kΩ1MΩ10MΩ100MΩ
Selectingadiscreterange(see[SENSe:]RESistance:RANGecommand)willdisableautorangingonthespecifiedchannels.
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
TheinstrumentenablesautorangingafteraFactoryReset(*RST
command).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Inthefollowingexamples,youcansubstitutethenodenameRESforFRES.
Thefollowingcommanddisablesautorangingonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.
FRES:RANG:AUTOOFF,(@103,113)
Thefollowingqueryreturnstheautorangingsettingsonchannels03and13inslot100.
FRES:RANG:AUTO?(@103,113)
TypicalResponse:0,0
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FRESistance
CONFigure:RESistance
[SENSe:]FRESistance:RANGe
[SENSe:]RESistance:RANGe
[SENSe:]RESistance:RESolution[SENSe:]FRESistance:RESolutionSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]RESistance:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)][SENSe:]RESistance:RESolution?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)][SENSe:]FRESistance:RESolution?[{(@<ch_list>)|MIN|MAX}]
Description
Thesecommandsselectthemeasurementresolutionfor2-wire(RESistance)and4-wire(FRESistance)resistancemeasurementsonthespecifiedchannels.Specifytheresolutioninthesameunitsastheselectedmeasurementfunction,notinnumberofdigits.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)
Parameters
Name Type RangeofValues DefaultValue
<resolution> Numeric Desiredresolutioninohms 0.000003xRange(1PLC)
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
Forthe<resolution>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthehighestresolution;MAXselectsthelargestvalueaccepted,whichgivestheleastresolution.
Theinstrumentwilldispatchasettingsconflicterrorifyouissuethiscommandwhen[SENSe:]CURRent:DC:RANGe:AUTOisONforoneormoreofthespecifiedchannels.
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001xRange
6½Digits
24
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]RESistance:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,[SENSe:]RESistance:NPLC,[SENSe:]RESistance:NPLC,[SENSe:]RESistance:RESolution,and[SENSe:]FRESistance:RESolutioncommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
Theinstrumentsetstheresolutionto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheresolutionintheform"+1.00000000E+02"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Inthefollowingcommands,youcansubstitutethenodenameRES:FRESforRES:RES.
Thefollowingcommandsetsthemeasurementresolutionto100Ωonchannels03and13inslot100.
RES:RES100,(@103,113)
Thefollowingqueryreturnstheresolutionselectedonchannels03and13inslot100.
RES:RES?(@103,113)
RES:APER:ENAB?!Verifythataperturemodeis
disabled("0")
TypicalResponse:+1.00000000E+02,+1.00000000E+02
SeeAlsoSENSeSubsystemIntroduction
CONFigure:FRESistance
CONFigure:RESistance
[SENSe:]FRESistance:APERture
[SENSe:]RESistance:APERture
[SENSe:]FRESistance:NPLC
[SENSe:]RESistance:NPLC
[SENSe:]FUNCtionSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]FUNCtion"<function>"[,(@<ch_list>)]
[SENSe:]FUNCtion?[(@<ch_list>)]
Description
Selectthemeasurementfunctiononthespecifiedchannels.Thefunctionnamemustbeenclosedinquotesinthecommandstring(forexample,FUNC"VOLT:DC").
Parameters
Name Type RangeofValues DefaultValue
<function> Discrete{TEMPerature|VOLTage[:DC]|VOLTage:AC|RESistance|FRESistance|CURRent[:DC]|CURRent:AC|FREQuency|PERiod}
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Thiscommandisnotavailableondigitalcards.
Notethatwhenyouchangethemeasurementfunctiononachannel,alloftheothermeasurementattributes(range,resolution,etc.)aresettotheirdefaultvalues.
Youcannotsetanyfunction-specificmeasurementattributesunlessthechannelisalreadyconfiguredforthatfunction.Forexample,youcannotsettheACfilterunlessthatchannelisalreadyconfiguredforACvoltageorACcurrentmeasurements.
ReturnFormat
Thequeryreturnsaquotedstringindicatingtheshortformofthefunctionname(example:"VOLT")oneachchannel.Multiplechannelsareseparatedbycommas.
Examples
Thefollowingcommandsspecifyfunctionsforthechannelsshown.
FUNC"TEMPerature",(@301)
FUNC"FREQuency",(@204)
Thefollowingqueryreturnsthefunctionsspecifiedforthechannelsshown.
FUNC?(@204,301)
Typicalresponse:"FREQ","TEMP"
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:APERtureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:APERture{<seconds>|MIN|MAX|DEF}[,(@<ch_list>)]
[SENSe:]TEMPerature:APERture?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandenablestheaperturemodeandsetstheintegrationtimeinseconds(calledaperturetime)fortemperaturemeasurementsonthespecifiedchannels.
YoushouldusethiscommandonlywhenyouwantprecisecontroloftheintegrationtimeoftheinternalDMM.Otherwise,specifyingintegrationtimeusingNPLC(see[SENSe:]TEMPerature:NPLCcommand)executesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
Thefollowingtableshowswhichtemperaturetransducersaresupportedbyeachofthemultiplexermodules.
Module Thermocouple RTD2-
Wire
RTD4-
Wire
Thermistor
34901AArmatureMultiplexer
Yes Yes Yes Yes
34902AReedMultiplexer
Yes Yes Yes Yes
34908AArmature
NotRecommended1
Yes No Yes
Multiplexer(1-Wire)
1Withaone-wiremultiplexer,evenverysmallgroundcurrentscanintroducesubstantialmeasurementerror.
Parameters
Name Type RangeofValues
DefaultValue
<seconds> Numeric Desiredaperturetimeinsecondsbetween400µsand1second,with4µsresolution.MIN=400µs,MAX=1second
Aperturedisabled.
<ch_list> Numeric Oneormorechannelsintheform(@scc).
If<ch_list>isomitted,thiscommandappliestothecurrentscanlist.
Remarks
Forthe<seconds>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthelowestresolution;MAXselectsthelargestvalueaccepted,whichgivesthehighestresolution.
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
TheCONFigure,MEASure?,and[SENSe:]TEMPerature:NPLCcommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
TheaperturemodeisdisabledafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequerycommandreturnstheaperturetimeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandenablestheaperturemodeandsetstheaperturetimeto400msonchannels03and13inslot100.
TEMP:APER400E-03,(@103,113)
Thefollowingqueryreturnstheaperturetimeselectedonchannels03and13inslot100.
TEMP:APER?(@103,113)
Typicalresponse:+4.00000000E-01,+4.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:TEMPerature
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:NPLCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]TEMPerature:NPLC?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandsetstheintegrationtimeinnumberofpowerlinecycles(PLCs)onthespecifiedchannels.Integrationtimeaffectsthemeasurementresolution(forbetterresolution,usealongerintegrationtime)andmeasurementspeed(forfastermeasurements,useashorterintegrationtime).
Thefollowingtableshowswhichtemperaturetransducersaresupportedbyeachofthemultiplexermodules.
Module Thermocouple RTD2-
Wire
RTD4-
Wire
Thermistor
34901AArmatureMultiplexer
Yes Yes Yes Yes
34902AReedMultiplexer
Yes Yes Yes Yes
34908AArmatureMultiplexer(1-Wire)
NotRecommended1
Yes No Yes
1Withaone-wiremultiplexer,evenverysmallgroundcurrentscanintroducesubstantialmeasurementerror.
Parameters
Name Type RangeofValues DefaultValue
<PLCs> Discrete {0.02|0.2|1|2|10|20|100|200}MIN=0.02PLC,MAX=200PLC
1PLC
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001xRange
6½Digits
24
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
Thespecifiedintegrationtimeisusedforallmeasurementsontheselectedchannels.IfyouhaveappliedMx+Bscalingorhaveassignedalarmstotheselectedchannel,thosemeasurementsare
alsomadeusingthespecifiedintegrationtime.MeasurementstakenduringtheMonitorfunctionalsousethespecifiedintegrationtime.
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]TEMPerature:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,and[SENSe:]TEMPerature:NPLCcommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
Theinstrumentsetstheintegrationtimeto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheintegrationtimeintheform"+1.00000000E+00"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandsettheintegrationtimeto0.2PLCsonchannels03and13inslot100.
TEMP:NPLC0.2,(@103,113)
Thefollowingqueryreturnstheintegrationtimesettingsonchannels03and13inslot100.
TEMP:NPLC?(@103,113)
TEMP:APER:ENAB?!Verifythataperturemodeis
disabled("0")
TypicalResponse:+2.00000000E-01,+2.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:TEMPerature
[SENSe:]TEMPerature:RJUNction?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
[SENSe:]TEMPerature:RJUNction?[(@<ch_list>)]
Description
Thisqueryreturnsheinternalreferencejunctiontemperatureonthespecifiedchannels.Thisisusefulonlyforaninternalreferencesource).
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
RemarksThisqueryreturnsthereferencetemperatureindegreesCelsius,regardlessofthetemperatureunitscurrentlyselected(seeUNIT:TEMPeraturecommand).
ReturnFormat
Thequeryreturnsanumberintheform+2.89753100E+01.
Example
Thefollowingqueryreturnsthetemperatureoftheinternalreferencejunctiononchannels03,04,and05inslot200.
TEMP:RJUN?(@203:205)!Alwaysreturnsresultin
degreesCelsius
TypicalResponse:+2.35212231E+01,+2.37701293E+01,+2.38291321E+01
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensatedSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
Syntax
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated<mode>[,(@<ch_list>)][SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated<mode>[,(@<ch_list>)][SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated?[(@<ch_list>)]
Description
OffsetcompensationremovestheeffectsofanyDCvoltagesinthecircuitbeingmeasured.Thetechniqueinvolvestakingthedifferencebetweentworesistancemeasurementsonthespecifiedchannels,onewiththecurrentsourceturnedonandonewiththecurrentsourceturnedoff.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RTDonly;notFRTD)
Parameters
Name Type RangeofValues DefaultValue
<mode> Boolean {OFF|0|ON|1} OFF|0
<ch_list> NumericOneormorechannels,asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
If<ch_list>isomitted,thiscommandappliestothecurrentscanlist.
Remarks
Thiscommandappliesonlyto2-wireand4-wireRTDmeasurementsonthe100Ω,1kΩ,and10kΩranges.Onceenabled,offsetcompensationisappliedtoboth2-wireand4-wireRTDmeasurementsonthespecifiedchannels.
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
TheinstrumentdisablesoffsetcompensationafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequerycommandreturns"0"(OFF)or"1"(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandenablesoffsetcompensationonchannels3and13inslot1.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.
TEMP:TRAN:FRTD:OCOMON,(@103,113)
Thefollowingqueryreturnstheoffsetcompensationsettingsonchannels03and13inslot100.
TEMP:TRAN:FRTD:OCOM?(@103,113)
TypicalResponse:1,1
SeeAlsoSENSeSubsystemIntroduction
CONFigure:TEMPerature
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence][SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]<reference>[,(@<ch_list>)][SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]<reference>[,(@<ch_list>)][SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]?[(@<ch_list>)]
Description
TheresistanceofanRTDisnominalat0°CandisreferredtoasRo.Thesecommandsselectthenominalresistance(Ro)for2-wire(RTD)or4-wire(FRTD)measurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RTDonly;notFRTD)
Parameters
Name Type RangeofValues DefaultValue
<reference> Numeric Anumber(ofohms)between49and2100.
100
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
Theinstrumentsetsthenominalresistanceto100ΩafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnsthenominalresistanceavalueoftheform+1.00000000E+02.Multiplevaluesareseparatedbycommas.
Examples
Ineachofthefollowingexamples,youcouldsubstitutethenodenameFRTDforRTD.
Thefollowingcommandsetsthenominalresistanceto75Ωonchannels01through04inslot200.
TEMP:TRAN:RTD:RES:REF75,(@201:204)
Thefollowingqueryreturnsthereferenceresistanceforthefourchannelsshown.
TEMP:TRAN:RTD:RES:REF?(@201:204)
TypicalResponse:7.50000000E+01,7.50000000E+01,7.50000000E+01,7.50000000E+01
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE[SENSe:]TEMPerature:TRANsducer:FRTD:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE<type>[,(@<ch_list>)][SENSe:]TEMPerature:TRANsducer:RTD:TYPE?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE<type>[,(@<ch_list>)][SENSe:]TEMPerature:TRANsducer:FRTD:TYPE?[(@<ch_list>)]
Description
ThiscommandselectstheRTDtypefor2-wire(RTD)or4-wire(FRTD)temperaturemeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RTDonly;notFRTD)
Parameters
Name Type RangeofValues DefaultValue
<type> Discrete {85|91} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
TheinstrumentsupportsRTDswithAlpha=0.00385(DIN/IEC751)usingITS-90softwareconversionsorAlpha=0.00391usingIPTS-68softwareconversions.
"PT100"isaspeciallabelthatissometimesusedtorefertoanRTDwithAlpha=0.00385andRo=100Ω.
TheinstrumentsetstheRTDtypeto"85"afteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns+85or+91.Multipleresultsareseparatedbycommas.
Examples
Inthefollowingexamples,youcouldsubstitutethenodenameFRTDforthenodenameRTD.
Thefollowingcommandsetsthetransducertypeto85onthechannelsshown.
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE85,
(@301:305)
Thefollowingqueryreturnsthetransducertypeonthechannelsshown.
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE?
(@202,204,301:305,308)
TypicalResponse:+85,+91,+85,+85,+85,+85,+85,+91
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECkSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk<state>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk?[(@<ch_list>)]
Description
Thiscommanddisablesorenablesthethermocouplecheckfeaturetoverifythatyourthermocouplesareproperlyconnectedformeasurements.Ifyouenablethisfeature,theinstrumentmeasuresthechannelresistanceaftereachthermocouplemeasurementtoensureaproperconnection.Ifanopenconnectionisdetected(greaterthan5kΩonthe10kΩrange),theinstrumentreportsanoverloadconditionforthatchannel'stemperaturereading.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.ThefactorydefaultisOFF.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
TheinstrumentdisablesthethermocouplecheckfeatureafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns0(disabled)or1(enabled)toindicatethestatusofeachthermocouplecheckforthechannellist.
Examples
Thefollowingcommandenablesthethermocouplecheckfeatureforsixchannels.
TEMP:TRAN:TCouple:CHECON,(@103,104,205-208)
Thefollowingqueryreturnsthestatusofthethermocouplecheckfeatureforeachofthefollowingchannels.
TEMP:TRAN:TCouple:CHEC?(@103,105,203-205,301)
TypicalResponse:1,0,0,0,1,0
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNctionSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction{<temperature>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction?[(@<ch_list>)]
Description
ThiscommandsetsthefixedreferencejunctiontemperatureindegreesCelsiusforthermocouplemeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<temperature> Numeric AnumberrepresentingthetemperatureindegreesCelsius,from-20to+80.
Thisisarequiredparameter.Thefactorydefaultvalueis0.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthiscommand,youmustalwaysspecifythetemperatureindegreesCelsiusregardlessofthetemperatureunitscurrentlyselected(seeUNIT:TEMPeraturecommand).
Theinstrumentsetsthethermocouplejunctionto0°CafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
ThequeryreturnsthefixedreferencejunctiontemperatureindegreesCelsiusintheform+1.12345678E+01.
Examples
ThefollowingcommandsetsthefixedjunctiontemperatureindegreesCelsiusforthermocouplemeasurementsonchannels01through03inslot100.
TEMPerature:TRANsducer:TCouple:RJUNction27.3
(@301:303)
ThefollowingqueryreturnsthefixedjunctiontemperatureindegreesCelsiusonthespecifiedchannels.
TEMP:TRAN:TC:RJUN?(@301:303)
TypicalResponse:2.73000000E+01,2.73000000E+01,2.73000000E+01
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE?[(@<ch_list>)]
Description
Thermocouplemeasurementsrequireareferencejunctiontemperature.Forthereferencejunctiontemperature,youcanuseaninternalmeasurementonthemodule'sterminalblock,anexternalthermistororRTDmeasurement,oraknownfixedjunctiontemperature.Thiscommandselectsthereferencejunctionsourceforthermocouplemeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule(RTDonly;notFRTD)
Parameters
Name Type RangeofValues DefaultValue
<type> Discrete {INTernal|EXTernal|FIXed} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Theaccuracyofthemeasurementishighlydependentuponthethermocoupleconnectionsandthetypeofreferencejunctionused.Useafixedtemperaturereferenceforthehighestaccuracymeasurements(youmustmaintaintheknownjunctiontemperature).Theinternalisothermalblockreferencerequiresnoexternalwiringbutprovidesloweraccuracymeasurementsthanafixedreference.
Tostoreareferencetemperature,firstconfigurechannel1onamultiplexercardforanRTDorthermistormeasurement(seeCONFigure:TEMPeraturecommand).Thenassignthemeasurementfromthatchannelastheexternalreferenceusingoneofthefollowingcommands:
[SENSe:]TEMPerature:TRANsducer:FRTD:REFerence[SENSe:]TEMPerature:TRANsducer:RTD:REFerence
Whenyouinitiateameasurementonanexternalreferencechannel(seeINITiateorREAD?command),subsequentthermocouplemeasurementsusethestoredtemperatureastheirreference.Thetemperatureisusedforallsubsequentthermocouplemeasurementsonthatcard.
Ifyouselectafixedreferencejunctionsource,youcanspecifyavaluebetween-20°Cand+80°Cusingthe[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNctioncommand.YoumustalwaysspecifythetemperatureindegreesCelsiusregardlessofthetemperatureunitscurrentlyselected(seeUNIT:TEMPeraturecommand).
TheinstrumentselectsthefixedsourceafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
ThequeryreturnsINT,EXTorFIXforeachchannelinthe<chan_list>.Multiplechannelsareseparatedbycommas.
Examples
Thefollowingcommandsetsthereferencejunctiontypetoanexternalthermistoronchannels01through04inslot200.
TEMP:TRAN:TC:RJUN:TYPEEXT,(@201:204)
Thefollowingqueryreturnsthereferencejunctiontypeforthefourchannelsshown.
TEMP:TRAN:TC:RJUN:TYPE?(@201:204)
TypicalResponse:EXT,EXT,EXT,EXT
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE?[(@<ch_list>)]
Description
Thiscommandselectsthethermocoupletypetouseformeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<type> Discrete {B|E|J|K|N|R|S|T} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Thermocouplemeasurementsrequireareferencejunctiontemperature(see[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPEcommand).Forthereferencejunctiontemperature,youcanuseaninternalmeasurementonthemodule'sterminalblock(34901Aonly),anexternalthermistororRTDmeasurement,oraknownfixedjunctiontemperature.Bydefault,afixedreferencejunctiontemperatureof0.0°Cisused.
Theinstrumentsetsthethermocoupletypeto"J"afteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnsthethermocoupletypeasaquotedletterforeachchannelinthelist.Multiplechannelsareseparatedbycommas.
Examples
ThefollowingcommandsetsthethermocoupletoJforthechannelsshown.
TEMP:TRAN:TCouple:TYPEJ,(@201:204)
Thefollowingqueryreturnsthethermocoupletypeforthechannelsshown.
TEMP:TRAN:TC:TYPE?(@101,103,202:204,301)
TypicalResponse:B,R,J,J,J,K
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE?[(@<ch_list>)]
Description
Thiscommandselectsthethermistortypefortemperaturemeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<type> Discrete {2252|5000|10000} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Theinstrumentsupports2.2kΩ(YSI44004Series),5kΩ(YSI44007Series),and10kΩ(YSI44006Series)thermistors.
Theinstrumentsetsthethermistortypeto"5000"afteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns2252,5000or10000foreachchannelinthelist.Multiplevaluesareseparatedbycommas.
Examples
Thefollowingcommandsetsthethermocoupletypeto5000forthechannelsshown.
TEMP:TRAN:THER:TYPE5000,(@201,202,301)
Thefollowingqueryreturnsthethermocoupletypeforeachofthefollowingchannels.
TEMP:TRAN:THER:TYPE?(@201:203,301:303)
TypicalResponse:5000,5000,2252,5000,10000,2252
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TEMPerature:TRANsducer:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TEMPerature:TRANsducer:TYPE{TCouple|RTD|FRTD|THERmistor|DEF}[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TYPE?[(@<ch_list>)]
Description
Thiscommandselectsthetemperaturetransducerprobetypetouseformeasurementsonthespecifiedchannels.
Thefollowingtableshowswhichtemperaturetransducersaresupportedbyeachofthemultiplexermodules.
Module Thermocouple RTD2-
Wire
RTD4-
Wire
Thermistor
34901AArmatureMultiplexer
Yes Yes Yes Yes
34902AReedMultiplexer
Yes Yes Yes Yes
34908AArmatureMultiplexer(1-Wire)
NotRecommended1
Yes No1 Yes
1Withaone-wiremultiplexer,evenverysmallgroundcurrentscanintroducesubstantialmeasurementerror.
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
ChoosingthetypeDEFisequivalenttochoosingTC.
For4-wireresistancemeasurements,theinstrumentautomaticallypairschannelninBank1withchanneln+10inBank2(34901A)orn+8(34902A)toprovidethesourceandsenseconnections.Forexample,makethesourceconnectionstotheHIandLOterminalsonchannel02inBank1andthesenseconnectionstotheHIandLOterminalsonchannel12(34901A)or10(34902A)inBank2.SpecifythepairedchannelinBank1(source)asthe<ch_list>channel(channelsinBank2arenotallowedinthe<ch_list>).
TheinstrumentselectsthermocoupleastheprobetypeafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
ThequeryreturnsTC,RTD,FRTD,orTHER.Multiplechannelsareseparatedbycommas.
Examples
ThefollowingcommandsetsthetemperaturetransducertypetoFRTDforthechannelsshown.
TEMP:TRAN:TYPEFRTD,(@201:205)
Thefollowingqueryreturnsthetemperaturetransducertypeforthechannelsshown.
TEMP:TRAN:TYPE?(@201:208)
TypicalResponse:FRTD,FRTD,FRTD,FRTD,FRTD,RTD,TC,THER
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TOTalize:CLEar:IMMediateSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
[SENSe:]TOTalize:CLEar:IMMediate[(@<ch_list>)]
Description
Thiscommandimmediatelyclearsthecountonthespecifiedcounter/totalizerchannels.
UsedWith:
34907AMultifunctionModule(totalizerchannelonly)
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Example
Thefollowingcommandclearsthecountontotalizerchannel03onthemoduleinslot200.
TOT:CLEAR:IMM(@203)
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TOTalize:DATA?
[SENSe:]TOTalize:DATA?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
[SENSe:]TOTalize:DATA?[(@<ch_list>)]
Description
Thisqueryreadsthecountonthespecifiedtotalizerchannels.Ifyouhaveconfiguredthecounttoberesetwhenitisread(seeCONFigure:TOTalizeand[SENSe:]TOTalize:TYPEcommands),thenthiscommandwillresetthecountto0afteritisread.Thecountisresetregardlessofwhetherthespecifiedchannelsareinascanlistorevenwhetherascanisinprogress.
UsedWith:
34907AMultifunctionModule(totalizerchannelonly)
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Themaximumcountis67,108,863(226-1).Thecountrollsoverto0afterreachingthemaximumallowedvalue.
TheoutputfromthiscommandisaffectedbythesettingsoftheFORMat:READingcommands.Dependingontheformatsselected,eachreadingmayormaynotbestoredwithmeasurementunits,timestamp,channelnumber,andalarmstatusinformation.
ReturnFormat
Thequeryreturnsanunsigneddecimalvaluerepresentingthecountoneachtotalizerchannelspecified(afull32-bitcountisreturned).Multipleresponsesareseparatedbycommas.
Example
Thefollowingqueryreadsthecountontotalizerchannel03onthemoduleinslot3.
TOT:DATA?(@303)
TypicalResponse:1.32130000E+03
SeeAlsoSENSeSubsystemIntroduction
CONFigure:TOTalize
[SENSe:]TOTalize:TYPE
[SENSe:]TOTalize:SLOPeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TOTalize:SLOPe<edge>[,(@<ch_list>)]
[SENSe:]TOTalize:SLOPe?[(@<ch_list>)]
Description
Thiscommandconfiguresthespecifiedtotalizerchannelstocountontherisingedge(positive)orfallingedge(negative)oftheinputsignal.
UsedWith:
34907AMultifunctionModule(totalizerchannelonly)
Parameters
Name Type RangeofValues DefaultValue
<edge> Discrete {NEGative|POSitive} Thisisarequiredparameter.
<ch_list> ChannelList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Theselectedslopeisstoredinvolatilememoryandwillbesetto"POS"whenpoweristurnedofforafteraFactoryReset(*RSTcommand).
ReturnFormat
ThequeryreturnsNEGorPOSforthespecifiedchannels.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot300tocountonthenegativeedge(falling)oftheinputsignal.
TOT:SLOPNEG,(@303)
Thefollowingqueryreturnstheedgesettingontotalizerchannel3onthemodulesinslots1and3.
TOT:SLOP?(@103,303)
TypicalResponse:NEG,NEG
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TOTalize:STARt[:IMMediate]Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
[SENSe:]TOTalize:STARt:IMMediate[(@<ch_list>)]
Description
Thiscommandimmediatelystartstotalizingonthespecifiedcounter/totalizerchannels.
UsedWith:
34907AMultifunctionModule(totalizerchannelonly)
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Example
Thefollowingcommandstartstotalizingontotalizerchannel03onthemoduleinslot200.
TOT:STARt:IMM(@203)
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TOTalize:DATA?
[SENSe:]TOTalize:STOP[:IMMediate]
[SENSe:]TOTalize:STOP[:IMMediate]Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
[SENSe:]TOTalize:STOP[:IMMediate][(@<ch_list>)]
Description
Thiscommandimmediatelystopstotalizingonthespecifiedcounter/totalizerchannels.
UsedWith:
34907AMultifunctionModule(totalizerchannelonly)
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Example
Thefollowingcommandstopstotalizingontotalizerchannel03onthemoduleinslot200.
TOT:STOP:IMM(@203)
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TOTalize:DATA?
[SENSe:]TOTalize:STARt[:IMMediate]
[SENSe:]TOTalize:TYPESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]TOTalize:TYPE<mode>[,(@<ch_list>)]
[SENSe:]TOTalize:TYPE?[(@<ch_list>)]
Description
Thiscommandenablesordisablesanautomaticresetofthecountonthespecifiedtotalizerchannels.Toreadthetotalizerduringascanwithoutresettingthecount,selecttheREADparameter.Toreadthetotalizerduringascanandresetthecountto0afteritisread,selecttheRRESetparameter(thismeans"readandreset").
UsedWith:
34907AMultifunctionModule(totalizerchannelonly)
Parameters
Name Type RangeofValues DefaultValue
<mode> Discrete {READ|RRESet} Thisisarequiredparameter.
<ch_list> ChannelList Oneormore
totalizerchannels,asshown:
(@303)-channel03onthemoduleinslot300.
(@103,203,303)-channel03onthemodulesonslot100,200,and300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Themaximumcountis67,108,863(226-1).Thecountrollsoverto0afterreachingthemaximumallowedvalue.
ReturnFormat
ThequeryreturnsREADorRRESforthespecifiedchannels.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot300tobereadwithoutresettingitscount.
TOT:TYPEREAD,(@303)
Thefollowingqueryreturnsthetotalizersettingontotalizerchannel03onthemodulesinslots200and300.
TOT:TYPE?(@203,303)
TypicalResponse:READ,READ
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]TOTalize:DATA?
[SENSe:]VOLTage:AC:BANDwidthSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]VOLTage:AC:BANDwidth{<filter>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:AC:BANDwidth?[{(@<ch_list>)|MIN|MAX}]
Description
TheinstrumentusesthreedifferentACfilterswhichenableyoutoeitheroptimizelow-frequencyaccuracyorachievefasterACsettlingtimes.Theinstrumentselectstheslow(3Hz),medium(20Hz),orfast(300Hz)filterbasedontheinputfrequencythatyouspecifywiththiscommandfortheselectedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<filter> Discrete {3|20|200} 20
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
ThiscommandappliestoACvoltagemeasurementsonly.
Forthe<filter>parameter,specifythelowestfrequencyexpectedintheinputsignalonthespecifiedchannels.Theinstrumentselectstheappropriatefilterbasedonthefrequencyyouspecify.
InputFrequency DefaultSettlingDelay
MinimumSettlingDelay
3Hzto300kHz(Slow)
7seconds/reading
1.5seconds
20Hzto300kHz(Medium)
1second/reading
200ms
200Hzto300kHz(Fast)
0.12seconds/reading
20ms
TheCONFigureandMEASure?commandsautomaticallyselectthedefault20Hz(medium)filter.
Theinstrumentselectsthedefault20Hz(medium)filterafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ThesettlingdelayiscontrolledbytheROUTe:CHANnel:DELaycommand.YougetthedefaultdelaywithROUTe:CHANnel:DELay:AUTOON.
ReturnFormat
Thequeryreturns3(slow),20(medium),or200(fast)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandselectstheslowfilter(3Hz)onchannels03and13inslot100.
VOLT:AC:BAND3,(@103,113)
Thefollowingqueryreturnstheacfiltersettingsonchannels03and13inslot100.
VOLT:AC:BAND?(@103,113)
TypicalResponse:3,3
SeeAlsoSENSeSubsystemIntroduction
CONFigure:VOLTage:AC
[SENSe:]VOLTage:AC:RANGe[SENSe:]VOLTage:DC:RANGeSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]VOLTage:AC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]VOLTage:AC:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]VOLTage:DC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)][SENSe:]VOLTage:DC:RANGe?[{(@<ch_list>)|MIN|MAX}]
Description
ThesecommandsselectsthemeasurementrangeforACandDCvoltagemeasurementsonthespecifiedchannels.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<range> DiscreteDesiredrangeinvolts:
100mV(MIN)1V10V100V300V(MAX)
Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Selectingadiscreterangewilldisableautorangingonthespecifiedchannels(see[SENSe:]VOLTage:AC:RANGe:AUTOcommand).
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.
TheinstrumentenablesautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstherangeintheform"+1.00000000E+01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Inthefollowingexamples,youcansubstitutethenodenameACforDC.
Thefollowingcommandselectsthe10voltrangeonchannels03and13inslot100.
VOLT:DC:RANG10,(@103,113)
Thefollowingqueryreturnstherangeselectedonchannels03and13inslot100.
VOLT:DC:RANG?(@103,113)
TypicalResponse:+1.00000000E+01,+1.00000000E+01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
[SENSe:]VOLTage:AC:RANGe:AUTO
[SENSe:]VOLTage:DC:RANGe:AUTO
[SENSe:]VOLTage:AC:RANGe:AUTO[SENSe:]VOLTage:DC:RANGe:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]VOLTage:AC:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]VOLTage:AC:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]VOLTage:DC:RANGe:AUTO<state>[,(@<ch_list>)][SENSe:]VOLTage:DC:RANGe:AUTO?[(@<ch_list>)]
Description
ThesecommandsdisableorenableautorangingforACandDCvoltagemeasurementsonthespecifiedchannels.Autorangingisconvenientbecausetheinstrumentautomaticallyselectstherangeforeachmeasurementbasedontheinputsignaldetected.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
ThefactorydefaultisON.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Autorangethresholds:Downrangeat:<10%ofrangeUprangeat:>120%ofrange
Withautorangingenabled,theinstrumentselectsoneofthefollowingrangesbasedontheinputsignaldetected:
100mV1V10V100V300V
Selectingadiscreterange(see[SENSe:]VOLTage:AC:RANGecommand)willdisableautorangingonthespecifiedchannels.
TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.
TheinstrumentenablesautorangingafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturns0(OFF)or1(ON)foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Ineachofthefollowingexamples,youcanreplacethenodenameACwithDC.
Thefollowingcommanddisablesautorangingonchannels03and13inslot100.
VOLT:AC:RANG:AUTOOFF,(@103,113)
Thefollowingqueryreturnstheautorangingsettingsonchannels03and13inslot100.
VOLT:AC:RANG:AUTO?(@103,113)
TypicalResponse:0,0
SeeAlsoSENSeSubsystemIntroduction
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
[SENSe:]VOLTage:AC:RANGe
[SENSe:]VOLTage:DC:RANGe
[SENSe:]VOLTage:DC:APERtureSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]VOLTage:DC:APERture{<time>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:APERture?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandenablestheaperturemodeandsetstheintegrationtimeinseconds(calledaperturetime)forDCvoltagemeasurementsonthespecifiedchannels.
YoushouldusethiscommandonlywhenyouwantprecisecontroloftheintegrationtimeoftheinternalDMM.Otherwise,specifyingintegrationtimeusingNPLC(see[SENSe:]VOLTage[:DC]:NPLCcommand)executesfasterandoffersbetterpowerlinenoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<time> Numeric Desiredaperturetimeinsecondsbetween300µsand1second,with4µsresolution.MIN=300µs,MAX=1second
Aperturedisabled.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthe<seconds>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthelowestresolution;MAXselectsthelargestvalueaccepted,whichgivesthehighestresolution.
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
TheCONFigure,MEASure?,[SENSe:]VOLTage[:DC]:NPLC,and[SENSe:]VOLTage[:DC]:RESolutioncommandsdisabletheaperturetimemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
TheaperturemodeisdisabledafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheaperturetimeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandenablestheaperturemodeandsetstheaperturetimeto300msonchannels03and13inslot100.
VOLT:DC:APER300E-03,(@103,113)
Thefollowingqueryreturnstheaperturetimeselectedonchannels03and13inslot100.
VOLT:DC:APER?(@103,113)VOLT:DC:APER:ENAB?!Verify
thataperturemodeisenabled("1")
TypicalResponse:+3.00000000E-01,+3.00000000E-01
SeeAlsoSENSeSubsystemIntroduction
CONFigure:VOLTage:DC
[SENSe:]VOLTage:DC:NPLC
[SENSe:]VOLTage:DC:NPLCSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]VOLTage:DC:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:NPLC?[{(@<ch_list>)|MIN|MAX}]
Description
Thiscommandsetstheintegrationtimeinnumberofpowerlinecycles(PLCs)onthespecifiedchannels.Integrationtimeaffectsthemeasurementresolution(forbetterresolution,usealongerintegrationtime)andmeasurementspeed(forfastermeasurements,useashorterintegrationtime).
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<PLCs> Discrete {0.02|0.2|1|2|10|20|100|200|MIN|MAX} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Onlytheintegralnumberofpowerlinecycles(1,2,10,20,100,or200PLCs)providenormalmode(linefrequencynoise)rejection.
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001xRange
6½Digits
24
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
Thespecifiedintegrationtimeisusedforallmeasurementsontheselectedchannels.IfyouhaveappliedMx+Bscalingorhaveassignedalarmstotheselectedchannel,thosemeasurementsare
alsomadeusingthespecifiedintegrationtime.MeasurementstakenduringtheMonitorfunctionalsousethespecifiedintegrationtime.
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]VOLTage[:DC]:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,[SENSe:]VOLTage[:DC]:NPLC,and[SENSe:]VOLTage[:DC]:RESolutioncommandsdisabletheaperturetimemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
Theinstrumentsetstheintegrationtimeto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheintegrationtimeinpowerlinecyclesforeachchannelintheform+1.12345678E+01.
Examples
Thefollowingcommandsetstheintegrationtimeto20PLCsonchannels03through06inslot200.
VOLT:DC:NPLC20,(@203:206)
Thefollowingqueryreturnstheintegrationtimeonthesamechannels.
VOLT:DC:NPLC?(@203:206)
TypicalResponse:+2.00000000E+01,+2.00000000E+01,+2.00000000E+01,+2.00000000E+01
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]VOLTage:DC:RESolutionSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]VOLTage:DC:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:RESolution?[{(@<ch_list>)|MIN|MAX}]
Description
ThiscommandselectsthemeasurementresolutionforDCvoltagemeasurementsonthespecifiedchannels.Theinstrumentclearsallreadingsfrommemorywhenanewscanisinitiated,whenanymeasurementparametersarechanged(CONFigureandSENSecommands),andwhenthetriggeringconfigurationischanged(TRIGgercommands).
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<resolution> Numeric Desiredresolutioninvolts. Thisisarequiredfield.Youmustspecifyanumeric<resolution>orspecifyMINorMAXtoselectthesmallestorlargest<resolution>.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
Forthe<resolution>parameter,youcansubstituteMINorMAXforanumericvalue.MINselectsthesmallestvalueaccepted,whichgivesthehighestresolution;MAXselectsthelargestvalueaccepted,whichgivestheleastresolution.
Theinstrumentwilldispatchasettingsconflicterrorifyouissuethiscommandwhen[SENSe:]VOLTage:DC:RANGe:AUTOisONforoneormoreofthespecifiedchannels.
Settingtheresolutionalsosetstheintegrationtimeforthemeasurement.Thefollowingtableshowstherelationshipbetweenintegrationtime,measurementresolution,numberofdigits,andnumberofbits.
IntegrationTime
Resolution Digits Bits
0.02PLC <0.0001xRange
4½Digits
15
0.2PLC <0.00001xRange
5½Digits
18
1PLC <0.000003xRange
5½Digits
20
2PLC <0.0000022xRange
6½Digits
21
10PLC <0.000001xRange
6½Digits
24
20PLC <0.0000008xRange
6½Digits
25
100PLC <0.0000003xRange
6½Digits
26
200PLC <0.00000022xRange
6½Digits
26
Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]VOLTage[:DC]:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.
TheCONFigure,MEASure?,[SENSe:]VOLTage[:DC]:NPLC,and[SENSe:]VOLTage[:DC]:RESolutioncommandsdisabletheaperturetimemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).
Theinstrumentsetstheresolutionto1PLCafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnstheresolutionintheform+1.12345678E+01foreachchannelinthe<ch_list>.Multiplechannelsareseparatedbycommas.
Examples
Thefollowingcommandsetsthe<resolution>to50microvoltsforthechannelsshown.
VOLT:DC:RES0.00005,(@201:204)
Thefollowingqueryreturnsthe<resolution>forchannels01through04onslot200.
VOLT:DC:RES?(@201:204)
TypicalResponse:+1.00000000E+01,+1.00000000E+01,+1.00000000E+01,+1.00000000E+01
SeeAlsoSENSeSubsystemIntroduction
[SENSe:]ZERO:AUTOSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
[SENSe:]ZERO:AUTO<mode>[,(@<ch_list>)]
[SENSe:]ZERO:AUTO?[(@<ch_list>)]
Description
Thiscommandenables(default)ordisablestheautozeromodeonthespecifiedchannels.
Parameters
Name Type RangeofValues DefaultValue
<mode> Discrete {OFF|ONCE|ON} Thisisarequiredparameter.
<ch_list> ChannelList Oneormorechannels,
asshown:
(@310)-channel10onthemoduleinslot300.
(@305:310)-channels05through10onthemoduleinslot300.
(@202:207,209,302:308)-channels02through07and09onthemoduleinslot200andchannels02through08onthemoduleinslot300.
Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.
Remarks
TheOFFandONCEparametershavethesameeffect.
TheCONFigure,MEASureandNPLCcommandsautomaticallyspecifyZERO:AUTOasOFFfor0.02to0.2PLCsandasONfor1PLCormore.
ReturnFormat
Thequeryformreturns0(OFForONCE)or1.
Examples
ThefollowingcommandturnstheautozeromodeOFF(@301:305).
ZERO:AUTOOFF(@301:305)
Thefollowingqueryreturnsthestateoftheautozeromode,whichinthiscaseisOFF.Multipleresponsesareseparatedbycommas.
ZERO:AUTO?(@301:305)
Typicalresponse:0,0,0,0,0
SeeAlsoSENSeSubsystemIntroduction
SOURceSubsystemIntroduction
CommandSummarySOURce:DIGital:DATA[:{BYTE|WORD}]
SOURce:DIGital:DATA[:{BYTE|WORD}]?
SOURce:DIGital:STATe?
SOURce:VOLTage
SOURce:VOLTage?
SOURce:DIGital:DATA[:{BYTE|WORD}]Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
SOURce:DIGital:DATA[:{BYTE|WORD}]<data>,(@<ch_list>)
SOURce:DIGital:DATA[:{BYTE|WORD}]?(@<ch_list>)
Description
Thiscommandoutputsadigitalpatternasan8-bitbyteor16-bitwordtothespecifieddigitaloutputchannels.
Parameters
Name Type RangeofValues DefaultValue
<data> Numeric Anintegerfrom0to255(:BYTE)or65,535(:WORD).
Thisisarequiredparameter.
<ch_list> ChannelList Oneormoredigital
I/Ochannels,asshown:
(@301)-channel01onthemoduleinslot300.
(@101:102,201,302)-channels01and02onthemodulesonslot100,channel01onthemoduleinslot200,andchannel02onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
Notethatyoucannotconfigureaportforoutputoperationsifthatportisalreadyconfiguredtobepartofthescanlist(digitalinput).
Youmustspecifyanintegervalue,eitherasadecimalnumber(213),abinarynumber(#b11010101)orahexadecimalnumber(#hD5).
Thedigitaloutputchannelsarenumbered"s01"(lowerbyte)and"s02"(upperbyte),wheresrepresentstheslotnumber.
Ifyouaregoingtowritetobothportssimultaneously(WORD),youmustsendthecommandtochannel01.
ReturnFormat
The:BYTE?(or:WORD?)queryreturnsthelastbyteorwordsenttothespecifieddigitaloutputchannelasadecimalnumberintheform+255.
Examples
Thefollowingcommandsalloutputthenumber12345tochannel01onthemoduleinslot200.
SOUR:DIGital:DATA:WORD12345,(@201)!
decimalinteger12345
SOUR:DIGital:DATA:WORD#b0011000000111001,(@201)!
binaryequivalentofdecimalinteger12345
SOUR:DIGital:DATA:WORD#h3039,(@201)!
hexadecimalequivalentofdecimalinteger12345
Thefollowingcommandreadsthenumberonchannel01onthemoduleinslot200.
SOUR:DIG:DATA:WORD?(@201)
TypicalResponse:+12345
SeeAlsoSOURceSubsystemIntroduction
SOURce:DIGital:STATe?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SOURce:DIGital:STATe?(@<ch_list>)
Description
Thiscommandreturnsthestatus(inputoroutput)ofthespecifieddigitalchannels.
UsedWith:
34907AMultifunctionModule(digitalI/Ochannelsonly)
Parameters
Name Type RangeofValues DefaultValue
<ch_list> ChannelList Oneormoredigital
I/Ochannels,asshown:
(@301)-channel01onthemoduleinslot300.
(@101:102,201,302)-channels01and02onthemodulesonslot100,channel01onthemoduleinslot200,andchannel02onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
AchannelissetasanoutputchannelwhenyousendaSOURce:DIGital:DATA[:{BYTE|WORD}]command.
Achannelissetasaninputchannelwhenyouplaceitinascanlistorsenda[SENSe:]DIGital:DATA:{BYTE|WORD}?command.
ReturnFormat
Thequeryreturns0ifthespecifiedchannelisaninputchannelor1ifthechannelisanoutputchannel.Multipleresponsesareseparatedbycommas.
Example
Thefollowingqueryreturnstheinput/outputstateofchannels01and02onthemoduleinslot300.Inthiscase,bothchannelsareconfiguredforoutput.
SOUR:DIG:STAT?(@301,302)
TypicalResponse:1,1
SeeAlsoSOURceSubsystemIntroduction
SOURce:VOLTage
SOURce:VOLTageSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
SOURce:VOLTage<voltage>,(@<ch_list>)
SOURce:VOLTage?(@<ch_list>)
Description
ThiscommandsetstheoutputvoltagelevelforthespecifiedDACchannelsonthe34907AMultifunctionModule.
ThiscommandoutputsaDCvoltagelevel.
Parameters
Name Type RangeofValues DefaultValue
<voltage> NumericAnumberofvoltsfrom-12to+12,inresolutionof0.001V.
0Vdc
<ch_list> ChannelList Oneormore
DACchannels,asshown:
(@304)-channel04onthemoduleinslot300.
(@104:105,204,305)-channels04and05onthemodulesonslot100,channel04onthemoduleinslot200,andchannel05onthemoduleinslot300.
Thisisarequiredparameter.
Remarks
TheDACchannelsarenumbered"s04"and"s05",wheresrepresentstheslotnumber.
EachDACchanneliscapableof10mAmaximumoutputcurrent.
AFactoryReset(*RSTcommand),InstrumentPreset(SYSTem:PRESetcommand),andCardReset(SYSTem:CPONcommand)willresettheDACoutputsto0Vdc.
ReturnFormat
Thequeryreturnstheoutputvoltageintheform+1.00000000E+00foreachDACchannelspecified.Multipleresponsesareseparatedbycommas.
Examples
Thefollowingcommandoutputs+2.5VdconDACchannels04and05inslot200.
SOUR:VOLT2.5,(@204,205)OUTP:STATON,(@204,205)
ThefollowingqueryreturnsthevoltageoutputsonDACchannels04and05inslot200.
SOUR:VOLT?(@204,205)
TypicalResponse:+2.50000000E+00,+2.50000000E+00
SeeAlsoSOURceSubsystemIntroduction
STATusSubsystemIntroduction
Keysight34970A/34972AStatusSystemDiagram
PrintablePDFVersion
STATus:PRESet
CommandSummary*ESE
*ESE?
*ESR?
*SRE
*STB?
STATus:ALARm:CONDition?
STATus:ALARm:ENABle
STATus:ALARm:ENABle?
STATus:ALARm[:EVENt]?
STATus:OPERation:CONDition?
STATus:OPERation:ENABle
STATus:OPERation:ENABle?
STATus:OPERation[:EVENt]?
STATus:PRESet
STATus:QUEStionable:CONDition?
STATus:QUEStionable:ENABle
STATus:QUEStionable:ENABle?
STATus:QUEStionable[:EVENt]?
STATus:ALARm:CONDition?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:ALARm:CONDition?
Description
ThiscommandqueriestheconditionregisterfortheAlarmRegistergroup(notethatthisconditionregisterusesonlybit4).Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Thefollowingtableliststhebitdefinitionsforthealarmenableregister.
Bit# BitName DecimalValue
Definition
0-3 NotUsed 1-8 0isreturned.
4 QueueNotEmpty
16 Thealarmqueueisnotempty.
5 NotUsed 32 0isreturned.
6 Alarm1 64 Alarm1istriggered.
7 Alarm2 128 Alarm2istriggered.
8 Alarm3 256 Alarm3istriggered.
9 Alarm4 512 Alarm4istriggered.
10-11
NotUsed 1024-2048 0isreturned.
12 LowerLimit 4096Alowerlimitalarmhasoccurred.
13 UpperLimit 8192 Anupperlimitalarmhasoccurred.
14-15
NotUsed 16384-32768
0isreturned.
AFactoryReset(*RSTcommand)willclearthe"QueueEmpty"bit(bit4)intheconditionregister.
ReturnFormat
Thequeryreadstheconditionregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbits6-8areset,thiscommandwillreturn+448.
Examples
Thefollowingqueryreadstheconditionregister(bits6and9areset).
STAT:ALAR:COND?
TypicalResponse:+576
SeeAlsoSTATusSubsystemIntroduction
STATus:ALARm:ENABle
STATus:ALARm[:EVENt]?
SYSTem:ALARm?
STATus:ALARm:ENABleSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:ALARm:ENABle<enable_val>
STATus:ALARm:ENABle?
Description
ThiscommandenablesbitsintheenableregisterfortheAlarmRegistergroup.TheselectedbitsarethenreportedtotheStatusByte.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<enable_val> Numeric Anintegerfrom0to65535,specifyingthealarmstoenableasabitsum.
Thisisarequiredparameter.
Remarks
Thefollowingtableliststhebitdefinitionsforthealarmenableregister.
Bit# BitName DecimalValue
Definition
0 Alarm1 1 AneventhasoccurredonAlarm1.
1 Alarm2 2 AneventhasoccurredonAlarm2.
2 Alarm3 4 AneventhasoccurredonAlarm3.
3 Alarm4 8 AneventhasoccurredonAlarm4.
4 QueueNotEmpty
16 Thealarmqueueisnotempty.
5 QueueOverflow 32Analarmqueueoverfloweventhasoccurred.
6 Alarm1 64 Alarm1istriggered.
7 Alarm2 128 Alarm2istriggered.
8 Alarm3 256 Alarm3istriggered.
9 Alarm4 512 Alarm4istriggered.
10-11
NotUsed 1024-2048 0isreturned.
12 LowerLimit 4096Alowerlimitalarmhasoccurred.
13 UpperLimit 8192 Anupperlimitalarmhasoccurred.
14-15
NotUsed 16384-32768
0isreturned.
ReturnFormat
Thequeryreadstheenableregisterandreturnsadecimalvaluethatcorrespondstothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit1(decimalvalue=2)andbit2(decimalvalue=4)areenabled,thequerywillreturn+6.
Examples
Thefollowingcommandenablesalarmregisters0through3.
STAT:ALAR:ENAB15
Thefollowingqueryreturnsathebinarysumequivalenttotheenabledregisters.
STAT:ALAR:ENAB?
TypicalResponse:+15
SeeAlsoSTATusSubsystemIntroduction
STATus:ALARm[:EVENt]?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:ALARm[:EVENt]?
Description
ThiscommandqueriestheeventregisterfortheAlarmRegistergroup.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Thefollowingtableliststhebitdefinitionsforthealarmeventregister.
Bit# BitName DecimalValue
Definition
0 Alarm1 1 AneventhasoccurredonAlarm1.
1 Alarm2 2 AneventhasoccurredonAlarm2.
2 Alarm3 4 AneventhasoccurredonAlarm3.
3 Alarm4 8 AneventhasoccurredonAlarm4.
4 QueueNotEmpty
16 Thealarmqueueisnotempty.
5 QueueOverflow 32Analarmqueueoverfloweventhasoccurred.
6 Alarm1 64 Alarm1istriggered.
7 Alarm2 128 Alarm2istriggered.
8 Alarm3 256 Alarm3istriggered.
9 Alarm4 512 Alarm4istriggered.
10-11 NotUsed 1024-2048 0isreturned.
12 LowerLimit 4096Alowerlimitalarmhasoccurred.
13 UpperLimit 8192 Anupperlimitalarmhasoccurred.
14-15 NotUsed 16384-32768
0isreturned.
Notethatifanyofbits0through3areset,bit4willalsobesettoindicatethattheAlarmQueueisnotempty.
Onceabitisset,itremainssetuntilclearedbyreadingtheeventregisterorthe*CLS(clearstatus)command.
ReturnFormat
Thequeryreadstheeventregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit1(decimalvalue=2)andbit2(decimalvalue=4)areset,thiscommandwillreturn+6.
Examples
Thefollowingqueryindicatesthatalarmeventshaveoccurredonalarms1and3.
STAT:ALAR:EVENt?
TypicalResponse:+5
SeeAlsoSTATusSubsystemIntroduction
STATus:ALARm:CONDition?
STATus:ALARm:ENABle
STATus:OPERation:CONDition?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:OPERation:CONDition?
Description
ThiscommandqueriestheconditionregisterfortheStandardOperationRegistergroup.Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Theconditionregisterbitsreflectthecurrentcondition.Ifaconditionisnolongertrue,thecorrespondingbitisclearedintheconditionregister.
ThefollowingtableliststhebitdefinitionsfortheStandardOperationRegister.
Bit#
BitName DecimalValue
Definition
0 Calibrating 1 Theinstrumentiscalibrating.
1 SelfTest 2 Theinstrumentisdoingaself-test.
2 NotUsed 4 (Alwaysreturns0)
3 NotUsed 8 (Alwaysreturns0)
4 Scanning 16 Theinstrumentisscanning.
5 WFT 32 Theinstrumentiswaitingforatrigger.
6 NotUsed 64 (Alwaysreturns0)
7 USBMSDdetected
128 AUSBmassstoragedevice(USBdrive)hasbeendetected.
8 ConfigChanged
256 Theinstrumentconfigurationhaschanged.
9 NotUsed 512 (Alwaysreturns0)
10 InstrumentLocked
1024 Theinstrumentislocked.
11 NotUsed 2048 (Alwaysreturns0)
12 NotUsed 4096 (Alwaysreturns0)
13 GlobalError 8192 Anerrorisintheglobalerrorqueue.
14 Busy 16384 Theinstrumentisbusy.
15 NotUsed 32768(Alwaysreturns0)
Bit14,theBusybit,willbesetwhiletheinstrumentisperforminglongcommands,suchasMMEMory:IMPort:CONFig?.
AFactoryReset(*RSTcommand)willsetthe"ConfigurationChange"bit(bit8)intheconditionregister.
ReturnFormat
Thequeryreadstheconditionregisterandreturnsadecimalvaluethatcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit4(decimalvalue=16)andbit8(decimalvalue=256)areset,thiscommandwillreturn"+272".
Examples
Thefollowingcommandreadstheconditionregister(bit8isset).
STAT:OPER:COND?
TypicalResponse:+256
SeeAlsoSTATusSubsystemIntroduction
STATus:OPERation:ENABle
STATus:OPERation[:EVENt]?
STATus:OPERation:ENABleSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:OPERation:ENABle<enable_val>
STATus:OPERation:ENABle?
Description
ThiscommandenablesbitsintheenableregisterfortheStandardOperationRegistergroup.TheselectedbitsarethenreportedtotheStatusByte.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<enable_val> Numeric Anintegerfrom0to65535,specifyingthebitstoenableasabitsum.
Thisisarequiredparameter.
Remarks
ThefollowingtableliststhebitdefinitionsfortheStandardOperationRegister.
Bit#
BitName DecimalValue
Definition
0 Calibrating 1 Theinstrumentiscalibrating.
1 SelfTest 2 Theinstrumentisdoingaself-test.
2 NotUsed 4 (Alwaysreturns0)
3 NotUsed 8 (Alwaysreturns0)
4 Scanning 16 Theinstrumentisscanning.
5 WFT 32 Theinstrumentiswaitingforatrigger.
6 NotUsed 64 (Alwaysreturns0)
7 USBMSDdetected
128 AUSBmassstoragedevice(USBdrive)hasbeendetected.
8 ConfigChanged
256 Theinstrumentconfigurationhaschanged.
9 MemThreshold
512 Thenumberofreadingsinmemoryhasexceededthememorythresholdsetting(seeDATA:POINts:EVENt:THReshold).
10 InstrumentLocked
1024 Theinstrumentislocked.
11 SettingsChanged
2048 Theinstrument'ssettingshavechanged.
12 NotUsed 4096 (Alwaysreturns0)
13 GlobalError 8192 Anerrorisintheglobalerrorqueue.
14 Busy 16384 Theinstrumentisbusy.
15 NotUsed 32768(Alwaysreturns0)
Usethe<enable_value>parametertospecifywhichbitswillbereportedtotheStatusByte.Thedecimalvaluespecifiedcorrespondstothebinary-weightedsumofthebitsyouwishtoenableintheregister.Forexample,toenablebit0(decimalvalue=1)andbit10(decimalvalue=1024),thecorrespondingdecimalvaluewouldbe1024(1+1024).
Bit14,theBusybit,willbesetwhiletheinstrumentisperforminglongcommands,suchasMMEMory:IMPort:CONFig?.
ReturnFormat
Thequerycommandreadstheenableregisterandreturnsadecimalvaluecorrespondingtothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit0(decimalvalue=1)andbit10(decimalvalue=1024)areenabled,thequerycommandwillreturn+1025.
Examples
Thefollowingcommandenablesbit9(decimalvalue=512)intheenableregister.
STAT:OPER:ENAB512
Thefollowingqueryreturnswhichbitsareenabledintheregister.
STAT:OPER:ENAB?
TypicalResponse:+512
SeeAlsoSTATusSubsystemIntroduction
STATus:OPERation:CONDition?
STATus:OPERation[:EVENt]?
STATus:OPERation[:EVENt]?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:OPERation[:EVENt]?
Description
ThiscommandqueriestheconditionregisterfortheStandardOperationRegistergroup.Thisisaread-destructiveregisterandthebitsareclearedwhenyoureadtheregister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
ThefollowingtableliststhebitdefinitionsfortheStandardOperationRegister.
Bit#
BitName DecimalValue
Definition
0 Calibrating 1 Theinstrumentiscalibrating.
1 SelfTest 2 Theinstrumentisdoingaself-test.
2 NotUsed 4 (Alwaysreturns0)
3 NotUsed 8 (Alwaysreturns0)
4 Scanning 16 Theinstrumentisscanning.
5 WFT 32 Theinstrumentiswaitingforatrigger.
6 NotUsed 64 (Alwaysreturns0)
7 USBMSDdetected
128 AUSBmassstoragedevice(USBdrive)hasbeendetected.
8 ConfigChanged
256 Theinstrumentconfigurationhaschanged.
9 MemThreshold
512 Thenumberofreadingsinmemoryhasexceededthememorythresholdsetting(seeDATA:POINts:EVENt:THReshold).
10 InstrumentLocked
1024 Theinstrumentislocked.
11 SettingsChanged
2048 Theinstrument'ssettingshavechanged.
12 NotUsed 4096 (Alwaysreturns0)
13 GlobalError 8192 Anerrorisintheglobalerrorqueue.
14 Busy 16384 Theinstrumentisbusy.
15 NotUsed 32768(Alwaysreturns0)
Bit14,theBusybit,willbesetwhiletheinstrumentisperforminglongcommands,suchasMMEMory:IMPort:CONFig?.
Thisregisterisclearedwhenitisread,orwhenyouissuea*CLScommand.
ReturnFormat
Thequeryreadstheoperationeventregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit1(decimalvalue=2)andbit9(decimalvalue=512)areset,thiscommandwillreturn"+514".
Examples
Thefollowingcommandreadsthequestionableeventregister(bits1and9areset).
STAT:OPER?
TypicalResponse:+514
SeeAlsoSTATusSubsystemIntroduction
STATus:OPERation:CONDition?
STATus:OPERation:ENABle
STATus:PRESetSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
STATus:PRESet
Description
ThiscommandclearsallbitsintheQuestionableDataenableregister,theAlarmenableregister,andtheStandardOperationenableregister.
Example
Thefollowingcommandclearsallbitsintheregisterslistedabove.
STATus:PRESet
SeeAlsoSTATusSubsystemIntroduction
STATus:QUEStionable:CONDition?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:QUEStionable:CONDition?
Description
ThiscommandqueriestheconditionregisterfortheQuestionableDataRegistergroup.Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Theconditionregisterbitsreflectthecurrentcondition.Ifaconditionisnolongertrue,thecorrespondingbitisclearedintheconditionregister.
ThefollowingtableliststhebitdefinitionsfortheQuestionableDataRegister.
Bit# BitName DecimalValue
Definition
0-10 NotUsed 1-1024 (Alwaysreturns0)
11 TotalizerOverflow
2048 Atotalizerhascountedpastitslimit.
12 MemoryOverflow
4096 Thereadingmemoryhasoverflowed.
13-15 NotUsed 8192-32768 (Alwaysreturns0)
AFactoryReset(*RSTcommand)clearsallbitsintheconditionregister.
ReturnFormat
Thequeryreadsthequestionableconditionregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit11(decimalvalue=2048)andbit12(decimalvalue=4096)areset,thiscommandwillreturn"6144".
Examples
Thefollowingcommandreadstheconditionregister(bit11isset).
STAT:QUES:COND?
TypicalResponse:+2048
SeeAlsoSTATusSubsystemIntroduction
STATus:QUEStionable:ENABle
STATus:QUEStionable[:EVENt]?
STATus:QUEStionable:ENABleSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
STATus:QUEStionable:ENABle<enable_val>
STATus:QUEStionable:ENABle?
Description
ThiscommandenablesbitsintheenableregisterfortheQuestionableDataRegistergroup.TheselectedbitsarethenreportedtotheStatusByte.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<enable_val> Numeric Anintegerfrom0to65535,specifyingthebitstoenableasabitsum.
Thisisarequiredparameter.
Remarks
ThefollowingtableliststhebitdefinitionsfortheQuestionableDataRegister.
Bit#
BitName DecimalValue
Definition
0 VoltageOverload
1 Theinstrumenthasexperiencedavoltageoverload.
1 CurrentOverload
2 Theinstrumenthasexperiencedacurrentoverload.
2 NotUsed 4 (Alwaysreturns0)
3 NotUsed 8 (Alwaysreturns0)
4 NotUsed 16 (Alwaysreturns0)
5 NotUsed 32 (Alwaysreturns0)
6 NotUsed 64 (Alwaysreturns0)
7 NotUsed 128 (Alwaysreturns0)
8 NotUsed 256 (Alwaysreturns0)
9 ResOverload 512 Theinstrumenthasexperiencedaresistanceoverload.
10 TemperatureOverload
1024 Theinstrumenthasexperiencedatemperatureoverload.
11 TotalizerOverflow
2048 Atotalizerhascountedpastitslimit.
12 MemoryOverflow
4096 Thereadingmemoryhasoverflowed.
13 NotUsed 8192 (Alwaysreturns0)
14 NotUsed 16384 (Alwaysreturns0)
15 NotUsed 32768 (Alwaysreturns0)
Usethe<enable_value>parametertospecifywhichbitswillbereportedtotheStatusByte.Thedecimalvaluespecifiedcorrespondstothebinary-weightedsumofthebitsyouwishtoenableintheregister.Forexample,toenablebit0(decimalvalue=1)andbit10(decimalvalue=1024),thecorrespondingdecimalvaluewouldbe1025(1+1024).
The*CLS(clearstatus)commandwillnotcleartheenableregisterbutitdoesclearallbitsintheeventregister.
The*RSTcommandhasnoeffectonthisregister.
ReturnFormat
Thequerycommandreadstheenableregisterandreturnsadecimalvaluecorrespondingtothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit0(decimalvalue=1)andbit10(decimalvalue=1024)areenabled,thequerycommandwillreturn+1025.
Examples
Thefollowingcommandenablesbit9(decimalvalue=512)intheenableregister.
STAT:QUES:ENAB512
Thefollowingqueryreturnswhichbitsareenabledintheregister.
STAT:QUES:ENAB?
TypicalResponse:+512
SeeAlsoSTATusSubsystemIntroduction
STATus:QUEStionable:CONDition?
STATus:QUEStionable[:EVENt]?
STATus:QUEStionable[:EVENt]?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
STATus:QUEStionable[:EVENt]?
Description
ThiscommandqueriestheconditionregisterfortheQuestionableDataRegistergroup.Thisisaread-destructiveregisterandthebitsareclearedwhenyoureadtheregister.
FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
ThefollowingtableliststhebitdefinitionsfortheQuestionableDataRegister.
Bit#
BitName DecimalValue
Definition
0 VoltageOverload
1 Theinstrumenthasexperiencedavoltageoverload.
1 CurrentOverload
2 Theinstrumenthasexperiencedacurrentoverload.
2 NotUsed 4 (Alwaysreturns0)
3 NotUsed 8 (Alwaysreturns0)
4 NotUsed 16 (Alwaysreturns0)
5 NotUsed 32 (Alwaysreturns0)
6 NotUsed 64 (Alwaysreturns0)
7 NotUsed 128 (Alwaysreturns0)
8 NotUsed 256 (Alwaysreturns0)
9 ResOverload 512 Theinstrumenthasexperiencedaresistanceoverload.
10 TemperatureOverload
1024 Theinstrumenthasexperiencedatemperatureoverload.
11 TotalizerOverflow
2048 Atotalizerhascountedpastitslimit.
12 MemoryOverflow
4096 Thereadingmemoryhasoverflowed.
13 NotUsed 8192 (Alwaysreturns0)
14 NotUsed 16384 (Alwaysreturns0)
15 NotUsed 32768 (Alwaysreturns0)
Onceabitisset,itremainssetuntilclearedbyreadingtheeventregisterorthe*CLS(clearstatus)command.
The*RSTcommandhasnoeffectonthisregister.
ReturnFormat
Thequeryreadsthequestionableeventregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit1(decimalvalue=2)andbit9(decimalvalue=512)areset,thiscommandwillreturn"+514".
Example
Thefollowingcommandreadsthequestionableeventregister(bits1and9areset).
STAT:QUES?
TypicalResponse:+514
SeeAlsoSTATusSubsystemIntroduction
STATus:QUEStionable:ENABle
STATus:QUEStionable:CONDition?
SYSTemSubsystemIntroduction
CommandSummarySYSTem:ALARm?
SYSTem:CPON
SYSTem:CTYPe?
SYSTem:DATE
SYSTem:DATE?
SYSTem:ERRor?
SYSTem:INTerface
SYSTem:INTerface?
SYSTem:LANGuage
SYSTem:LANGuage?
SYSTem:LFRequency?
SYSTem:LOCal
SYSTem:LOCK:NAME?
SYSTem:LOCK:OWNer?
SYSTem:LOCK:RELease
SYSTem:LOCK:REQuest?
SYSTem:PRESet
SYSTem:REMote
SYSTem:RWLock
SYSTem:SECurity[:IMMediate]
SYSTem:TIME
SYSTem:TIME?
SYSTem:TIME:SCAN?
SYSTem:VERSion?
LANConfigurationCommands
TheinstrumentusesthefollowingLANports(34972Aonly):
Port5024isusedforSCPITelnetsessions.Port5025isusedforSocketsessions.
LANConfigurationIntroduction
RemoteInterfaceConfigurationCommandsSYSTem:COMMunicate:LAN:CONTrol?
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:DHCP?
SYSTem:COMMunicate:LAN:DNS
SYSTem:COMMunicate:LAN:DNS?
SYSTem:COMMunicate:LAN:DOMain?
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:GATEway?
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:HOSTname?
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:IPADdress?
SYSTem:COMMunicate:LAN:MAC?
SYSTem:COMMunicate:LAN:SMASk
SYSTem:COMMunicate:LAN:SMASk?
SYSTem:COMMunicate:LAN:TELNet:PROMpt
SYSTem:COMMunicate:LAN:TELNet:PROMpt?
SYSTem:COMMunicate:LAN:TELNet:WMESsage
SYSTem:COMMunicate:LAN:TELNet:WMESsage?
SYSTem:COMMunicate:LAN:UPDate
TheinstrumentusesthefollowingLANports(34972Aonly):
Port5024isusedforSCPITelnetsessions.Port5025isusedforSocketsessions.
SYSTem:COMMunicate:LAN:CONTrol?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:CONTrol?
Description
Thisqueryreturnsthecontrolconnectionportnumberforsocketcommunications.
Remarks
Thisqueryisonlyusedwhenprogrammingoversockets.
YoucanusethecontrolsocketconnectiontosendaDeviceCleartotheinstrumentortodetectpendingServiceRequest(SRQ)events.
Thisqueryalwaysreturns0ifnotsentfromasocketconnection.
ReturnFormat
Thequeryreturnsthecontrolconnectionportnumber.If0isreturned,theinterfacedoesnotsupportaSocketControlconnection.
Examples
Thefollowingqueryreturnsthecontrolconnectionportnumber.
SYST:COMM:LAN:CONT?
TypicalResponse:+5005
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:DHCPSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:DHCP<mode>
SYSTem:COMMunicate:LAN:DHCP?
Description
ThiscommanddisablesorenablesuseoftheDynamicHostConfigurationProtocol(DHCP)fortheinstrument.
WhenDHCPisenabled(factorysetting),theinstrumentwilltrytoobtainanIPaddressfromaDHCPserver.IfaDHCPserverisfound,itwillassignadynamicIPaddress,SubnetMask,andDefaultGatewaytotheinstrument.IfaDHCPserverisnotfound,theinstrumentusesAutoIPtoautomaticallyconfigureitsIPsettingintheAutomaticPrivateIPAddressingrange(169.254.xxx.xxx).
WhenDHCPisdisabled,theinstrumentwillusethestaticIPaddress,SubnetMask,andDefaultGatewayduringpower-on.
IfyouchangetheDHCPmode,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.
Parameters
Name Type RangeofValues
DefaultValue
<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.
Remarks
MostsiteLANshaveaDHCPserver.
IfaDHCPLANaddressisnotassignedbyaDHCPserver,thenanAutoIPaddressstaticIPwillbeassumedafterapproximatelytwominutes.
TheDHCPsettingisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
Thequeryreturnsthecurrentsettingonly.ThismaydifferfromwhatwasjustsetifyouhavenotyetexecutedaSYSTem:COMMunicate:LAN:UPDatecommand.
ReturnFormat
Thequeryreturns0(OFF)or1(ON).
Examples
ThefollowingcommanddisablesDHCP.
SYST:COMM:LAN:DHCPOFFSYST:COMM:LAN:UPDate
ThefollowingqueryreturnsthecurrentDHCPsetting.
SYST:COMM:LAN:DHCP?
TypicalResponse:0
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:SMASk
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:DNSSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:DNS"<address>"
SYSTem:COMMunicate:LAN:DNS?[{CURRent|STATic}]
Description
ThiscommandassigntheIPaddressoftheDomainNameSystemserver(DNS).
ContactyournetworkadministratortodeterminewhetherDNSisbeingusedandforthecorrectaddress.IfDHCPisavailableandenabled,DHCPwillauto-assigntheDNSaddress.Thisauto-assignedDNSaddresstakesprecedenceoverthestaticDNSaddressassignedwiththiscommand.
IfyouchangetheDNSaddress,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.
Parameters
Name Type RangeofValues DefaultValue
<address> QuotedString
Specifiedinfour-bytedotnotation("nnn.nnn.nnn.nnn"),where"nnn"ineachcaseisabytevalueintherange0through255.
Thisisarequiredparameter.
Remarks
TheassignedDNSaddressisusedfortheDNSserverifDHCPisdisabled.Otherwise,theDNSserveraddressisauto-assignedbyDHCP.
TheDNSaddressisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
ThequeryformreturnstheaddressoftheDNSserverintheform"nnn.nnn.nnn.nnn".
Notethatthequeryversionofthecommandhastwooptionalparameters.Specify"CURRent"(default)toreadtheDNSaddresscurrentlyinuse.Specify"STATic"toreadtheDNSaddress,staticgateway,orIPaddresscurrentlystoredinnon-volatilememorywithintheinstrument.TheDNSaddressstoredinmemoryisusedifDHCPisdisabled.IfDHCPisenabled,itwillauto-assigntheDNSaddress,andthatDHCPassignedaddresscanbereadbyspecifying"CURRent".
Examples
ThefollowingcommandsetsthestaticDNSaddress.
SYST:COMM:LAN:DNS"198.105.232.4"
SYST:COMM:LAN:UPDate
ThefollowingqueryreturnstheDNSaddresscurrentlybeingusedbytheinstrument(thequotesarealsoreturned).
SYST:COMM:LAN:DNS?CURR
TypicalResponse:"198.105.232.4"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:DOMain?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:DOMain?
Description
Thisqueryreturnsthecurrentnetworkdomain.
Remarks
IftheinstrumenthasaDNSserver,itlooksupitsdomainname.
ReturnFormat
ThequeryreadsthedomainnameandreturnsanASCIIstringenclosedindoublequotes.Ifadomainnamehasnotbeenassigned,anullstring("")isreturned.
Examples
Thefollowingqueryreturnsthedomainnamecurrentlybeingusedbytheinstrument(thequotesarealsoreturned).
SYST:COMM:LAN:DOM?
TypicalResponse:"example.com"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:DNS
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:GATEwaySyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:GATEway"<address>"
SYSTem:COMMunicate:LAN:GATEway?[{CURRent|STATic}]
Description
Thiscommandassignsthestaticgatewayfortheinstrument.
Contactyournetworkadministratortodeterminewhethersubnettingisbeingusedandforthecorrectaddress.IfDHCPisenabled,DHCPwillauto-assignthegateway.Thisauto-assignedgatewaytakesprecedenceoverthestaticgatewayassignedwiththiscommand.
Ifyouchangethegateway,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.
Parameters
Name Type RangeofValues DefaultValue
<address> QuotedString
Specifiedinfour-bytedotnotation("nnn.nnn.nnn.nnn"),where"nnn"ineachcaseisabytevalueintherange0through255.
Thisisarequiredparameter.
Remarks
TheassignedgatewayisusedifDHCPisdisabled.Otherwise,thegatewayisauto-assignedbyDHCP.
Thestaticgatewayisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
IfDHCPisenabled(seeSYSTem:COMMunicate:LAN:DHCPcommand),thestaticgatewayisassignedbytheDHCPserver,sothespecifiedstaticgatewayisnotused.However,ifDHCPisturnedoff,thecurrentlyconfiguredstaticgatewaywillbeused.
Agatewayvalueof"0.0.0.0"indicatesthatsubnettingisnotbeingused.
ReturnFormat
Thequeryformreturnstheaddressofthegatewayintheform"nnn.nnn.nnn.nnn".
Notethatthequeryversionofthecommandhastwooptionalparameters.Specify"CURRent"(default)toreadthestaticgatewaycurrentlyinuse.Specify"STATic"toreadthestaticgatewaycurrentlystoredinnon-volatilememorywithintheinstrument.ThegatewaystoredinmemoryisusedifDHCPisdisabled.IfDHCPisenabled,itwillauto-assignthegatewaycanbereadbyspecifying"CURRent".
Examples
Thefollowingcommandsetsthestaticgateway.
SYST:COMM:LAN:GATEway"192.168.1.1"
SYST:COMM:LAN:UPDate
Thefollowingqueryreturnsthegatewaycurrentlybeingusedbytheinstrument(thequotesarealsoreturned).
SYST:COMM:LAN:GATEway?CURR
TypicalResponse:"192.168.1.1"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:SMASk
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:HOSTnameSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:HOSTname"<name>"
SYSTem:COMMunicate:LAN:HOSTname?[{CURRent|STATic}]
Description
Thiscommandassignsahostnametotheinstrument.Thehostnameisthehostportionofthedomainname,whichistranslatedintoanIPaddress.
Ifyouchangethehostname,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.
Parameters
Name Type RangeofValues DefaultValue
<name> QuotedASCIIString
Astringofupto45characters.Thefirstcharactermustbealetter(A-Z),buttheremaining44characterscanbeletters,numbers(0-9),ordashes("-").Blankspacesarenotallowed.
Thisisarequiredparameter.
TheLXIresetvalueisA-34970A-nnnnnorA-34972A-nnnnn,wherennnnnisthelast5digitsintheinstrument'sserialnumber.
Remarks
IfDynamicDomainNameSystem(DDNS)isavailableonyournetworkandyourinstrumentusesDHCP,thehostnameisregisteredwiththeDynamicDNSserviceatpower-on.
IfDHCPisenabled(seeSYSTem:COMMunicate:LAN:DHCPcommand),theDHCPservercanassignadifferentnameiftherequestednameisalreadyinuseonthenetwork.
Thehostnameisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
ThequeryreadsthehostnameandreturnsanASCIIstringenclosedindoublequotes.Ifahostnamehasnotbeenassigned,thequeryreturnsanullstring("").
Notethatthequeryversionofthecommandhastwooptionalparameters.Specify"CURRent"(default)toreadthehostnamethattheinstrumentiscurrentlyusing.Specify"STATic"toreadthedesiredhostnamecurrentlystoredinnon-volatilememorywithintheinstrument(whichmaynotbetheactualnamecurrentlyinuseonthenetwork).
Examples
Thefollowingcommanddefinesahostname.
SYST:COMM:LAN:HOST"LAB1-34970A"
SYST:COMM:LAN:UPDate
Thefollowingqueryreturnsthehostnamecurrentlybeingusedbytheinstrument(thequotesarealsoreturned).
SYST:COMM:LAN:HOST?CURRorSYST:COMM:LAN:HOST?
TypicalResponse:"LAB1-34970A"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:DOMain?
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:IPADdressSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:IPADdress"<address>"
SYSTem:COMMunicate:LAN:IPADdress?[{CURRent|STATic}]
Description
ThiscommandassignsthestaticIPaddressfortheinstrument.
IfDHCPisenabled,DHCPwillauto-assigntheIPaddress.Thisauto-assignedIPaddresstakesprecedenceoverthestaticIPaddressassignedwiththiscommand.
IfyouchangetheIPaddress,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.
Parameters
Name Type RangeofValues DefaultValue
<address> QuotedString
Specifiedinfour-bytedotnotation("nnn.nnn.nnn.nnn"),where"nnn"ineachcaseisabytevalueintherange0through255.
Thisisarequiredparameter.
Remarks
TheassignedIPaddressisusedifDHCPisdisabled.Otherwise,theIPaddressisauto-assignedbyDHCP.
TheIPaddressisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
IfDHCPisenabled(seeSYSTem:COMMunicate:LAN:DHCPcommand),theIPaddressisassignedbytheDHCPserver,sothespecifiedIPaddressisnotused.However,ifDHCPisturnedoff,thecurrentlyconfiguredIPaddresswillbeused.
IFDHCPisenabled,butaDHCPserverisnotavailable,theIPaddressisdeterminedbyAutoIP.
IfyouareplanningtouseastaticIPaddressonasiteLAN,contactyournetworkadministratortoobtainafixedIPaddresstobeusedexclusivelyforyourinstrument,alongwiththecorrespondingsubnetmaskandgateway.
ReturnFormat
ThequeryformreturnstheaddressoftheIPaddressoftheinstrumentintheform"nnn.nnn.nnn.nnn".
Notethatthequeryversionofthecommandhastwooptionalparameters.Specify"CURRent"(default)toreadtheIPaddresscurrentlyinuse.Specify"STATic"toreadtheIPaddresscurrentlystoredinnon-volatilememorywithintheinstrument.TheIPaddressstoredinmemoryisusedifDHCPisdisabled.IfDHCPisenabled,itwillauto-assigntheIPaddress,andthatDHCPassignedaddresscanbereadbyspecifying"CURRent".
Examples
ThefollowingcommandsetsthestaticIPaddress.
SYST:COMM:LAN:IPAD"198.168.1.2"
SYST:COMM:LAN:UPDate
ThefollowingqueryreturnstheIPaddresscurrentlybeingusedbytheinstrument(thequotesarealsoreturned).
SYST:COMM:LAN:IPAD?CURR
TypicalResponse:"198.168.1.2"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:SMASk
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:MAC?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:MAC?
Description
Thisqueryreadstheinstrument'sMediaAccessControl(MAC)address,alsoknownasthelink-layeraddress,theEthernet(station)address,LANICID,orHardwareAddress.Thisisanunchangeable48-bitaddressassignedbythemanufacturertoeachuniqueInternetdevice.
Yournetworkadministratormayneedtheinstrument'sMACaddressinordertoassignastaticIPaddressforthisdevice.
Remarks
Theinstrument'sMACaddressisuniquetotheinstrument.Itissetatthefactoryandcannotbechanged.
TheMACaddressisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
ThequeryreadstheMACaddressandreturnsanASCIIstringenclosedindoublequotes.TheMACaddressisrepresentedas12hexadecimalcharacters.
Examples
ThefollowingqueryreturnstheMACaddress(thequotesarealsoreturned).
SYST:COMM:LAN:MAC?
TypicalResponse:"0030D3001041"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:SMASkSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:SMASk"<mask>"
SYSTem:COMMunicate:LAN:SMASk?[{CURRent|STATic}]
Description
ThiscommandassignsaSubnetMaskfortheinstrument.TheinstrumentusestheSubnetMasktodeterminewhetheraclientIPaddressisonthesamelocalsubnet.WhenaclientIPaddressisonadifferentsubnet,allpacketsmustbesenttotheDefaultGateway.ContactyournetworkadministratortodeterminewhethersubnettingisbeingusedandforthecorrectSubnetMask.
Ifyouchangethesubnetmask,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.
Parameters
Name Type RangeofValues DefaultValue
<mask> QuotedString
Specifiedinfour-bytedotnotation("nnn.nnn.nnn.nnn"),where"nnn"ineachcaseisabytevalueintherange0through255.
Thisisarequiredparameter.
Thefactorydefaultvalueis"255.255.0.0".
Remarks
TheassignedsubnetmaskisusedifDHCPisdisabled.Otherwise,thesubnetmaskisauto-assignedbyDHCP.
IfDHCPisenabled(factorydefault),thesubnetmaskdoesnotneedtobeset.
IfDHCPisenabled(seeSYSTem:COMMunicate:LAN:DHCPcommand),thesubnetmaskisassignedbytheDHCPserver,sothespecifiedsubnetmaskisnotused.However,ifDHCPisturnedoff,thecurrentlyconfiguredSubnetMaskwillbeused.
Avalueof"0.0.0.0"or"255.255.255.255"indicatesthatsubnettingisnotbeingused.
TheSubnetMaskisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
ThequeryreturnstheSubnetMaskintheform"nnn.nnn.nnn.nnn".
Notethatthequeryversionofthecommandhastwooptionalparameters.Specify"CURRent"(default)toreadthedynamicSubnetMaskcurrentlybeingusedbytheinstrument.Specify"STATic"toreadtheSubnetMaskcurrentlystoredinnon-volatilememorywithintheinstrument(maynotbetheactualmaskusedbytheinstrumentifDHCPisenabled).
Examples
ThefollowingcommandsetstheSubnetMask.
SYST:COMM:LAN:SMAS"255.255.254.0"
SYST:COMM:LAN:UPDate
Thefollowingqueryreturnsthesubnetmaskcurrentlybeingusedbytheinstrument(thequotesarealsoreturned).
SYST:COMM:LAN:SMAS?CURRorSYST:COMM:LAN:SMAS?
TypicalResponse:"255.255.254.0"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:UPDate
SYSTem:COMMunicate:LAN:TELNet:PROMptSYSTem:COMMunicate:LAN:TELNet:WMESsageSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:TELNet:PROMpt"<string>"SYSTem:COMMunicate:LAN:TELNet:PROMpt?
SYSTem:COMMunicate:LAN:TELNet:WMESsage"<string>"SYSTem:COMMunicate:LAN:TELNet:WMESsage?
Description
ThesecommandssetthecommandpromptandwelcomemessagethataredisplayedwhenyouuseaTelnetsessiontocommunicatewiththeinstrument.
Parameters
Name Type RangeofValues DefaultValue
<string> QuotedASCIIString
Astringofupto15characters(prompt)or63characters(welcomemessage).
"34972A>"(prompt)
"WelcometoKeysight's34972ASwitch/MeasureUnit"(welcomemessage)
Remarks
TheTelnetportisanalternatewaytosendSCPIcommandstotheinstrument.
Port5024isusedforSCPITelnetsessions.
Telnetsessioncantypicallybestartedasfollowsfromahostcomputershell:
telnet<IP_address><port>
Forexample:
telnet169.254.4.105024
ToexitaTelnetsession,press<Ctrl-D>.
Thecommandpromptandwelcomemessagearestoredinnon-volatilememory,andtheydonotchangewhenpowerhasbeenofforafteraFactoryReset(*RSTcommand).
Thefollowingimageshowsboththepromptandthewelcomemessage.
ReturnFormat
ThequeriesreturnthecommandpromptorwelcomemessageasASCIIstringsenclosedindoublequotes.
Examples
Thefollowingcommanddefinesthecommandprompt.
SYST:COMM:LAN:TELN:PROM"Command>"
Thefollowingqueryreturnsthecommandpromptcurrentlybeingused(thequotesarealsoreturned).
SYST:COMM:LAN:TELN:PROM?
TypicalResponse:"Command>"
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:UPDateSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:COMMunicate:LAN:UPDate
Description
ThiscommandupdatesalloftheLANchanges.ItdisconnectsallactiveLANandWebconnectionsandrestartstheLANinterface,possiblywithanewIPaddress,dependingonhowyourinstrument'sIPaddressisassigned.
Remarks
Executingthiscommandisnecessarytomakethefollowingcommandstakeeffect:
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:DNS
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:SMASk
Beverycarefulwhenyouexecutethiscommand,becauseyourinstrumentmaynotworkontheLANifyouupdatetheinstrumentwithinvalidLANsettings.
Ifyourinstrumentdoesnotworkafteryouexecutethiscommand,pushtheLANResetfrontpanelsoftkeytorestorethesettingstoresetvaluesandresettheLAN,oruseanotherI/Ointerface,suchasUSB,tocorrectthesettings.
Example
ThecommandsbelowdemonstrateatypicalusemodelforsettingandapplyingLANparameters.
SYST:COMM:LAN:DHCPOFF
SYST:COMM:LAN:IPADdress"192.168.1.2"
SYST:COMM:LAN:SMASk"255.255.0.0"
SYST:COMM:LAN:GATEway"192.168.1.1"
SYST:COMM:LAN:UPDate
SeeAlsoLANConfigurationIntroduction
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:DNS
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:SMASk
SYSTem:ALARm?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:ALARm?
Description
Thisqueryreadsthealarmdatafromthealarmqueue(onealarmeventisreadanddeletedfromthequeueeachtimethiscommandisexecuted).Arecordofupto20alarmscanbestoredintheinstrument'salarmqueue.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Eachtimeyoustartanewscan,theinstrumentclearsallreadings(includingalarmdata)storedinreadingmemoryfromthepreviousmeasurement.Therefore,thecontentsofmemoryarealwaysfromthemostrecentmeasurement.
Alarmdataisretrievedinfirst-in-first-out(FIFO)order.Thefirstalarmreturnedisthefirstalarmthatwasstored.
Upto20alarmscanbeloggedinthealarmqueue.Ifmorethan20alarmsaregenerated,theywillbelost(onlythefirst20alarmsaresaved).
Toretrievescannedreadingsandalarmdatafromreadingmemorywithoutclearingtheinformation,usetheFETCh?command.
Thealarmqueueisclearedbythe*CLS(clearstatus)command,whenpoweriscycled,andbyreadingalloftheentries.AFactoryReset(*RSTcommand)orInstrumentPreset(SYSTem:PRESetcommand)doesnotclearthealarmqueue.
ReturnFormat
Thequeryreturnsonestringeachtimeitisexecuted.Italsoreadsthealarmdataandclearsonealarmeventfromthealarmqueue.
Thequeryreturnsastringintheformshownbelow(independentofFORMat:READingcommands):
1ReadingwithUnits(26.195°C)
4ChannelNumber
2Date(November21,2004) 5AlarmLimitThresholdCrossed(0=NoAlarm,1=LO,2=HI)
3TimeofDay(3:30:23.000PM)
6AlarmNumber(1-4)
Example
Thefollowingqueryreadsonemessagefromthealarmqueueandremovesthatmessagefromthequeue.
SYST:ALAR?
TypicalResponse:-1.17616000E-04VDC,2004,11,21,15,54,50.184,103,1,3
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:CPONSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:CPON<slot>
Description
Thiscommandresetsthemoduleinthespecifiedslottoitspower-onstate(CPONmeans"cardpoweron").SeeFactoryResetStateforacompletelistingoftheinstrument'sFactoryconfiguration.
Parameters
Name Type RangeofValues DefaultValue
<slot> Discrete {100|200|300|ALL} Thisisarequiredparameter.
Remarks
Thevariousmodulecardsareaffectedasfollows:
Module Effect
34901A Ifanychannelisconfiguredforameasurement,thiscommandhasnoeffect.Ifnochannelisconfigured,thiscommandopensallchannels.
34902A Ifanychannelisconfiguredforameasurement,thiscommandhasnoeffect.Ifnochannelisconfigured,thiscommandopensallchannels.
34903A Thiscommandopensallchannels.
34904A Thiscommandopensallchannels.
34905A Thiscommandcloseschannels11and21.
34906A Thiscommandcloseschannels11and21.
34907A Thiscommandresetsallchannelsnotinvolvedinscantothepower-onstate.
34908A Ifanychannelisconfiguredforameasurement,thiscommandhasnoeffect.Ifnochannelisconfigured,thiscommandopensallchannels.
ThiscommanddoesnotresettheinternalDMM.
TheinstrumentwillproduceanerrorifyouareactivelyscanningandtrytoexecuteaSYSTem:CPONforacardthatisinvolvedinthescan.
Toresetthemodulesinallthreeslotsintheinstrument,usetheALLkeywordshownabove.
Example
Thefollowingcommandresetsthemoduleinslot200.
SYST:CPON200
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:PRESet
*RST
SYSTem:CTYPe?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
SYSTem:CTYPe?<slot>
Description
Thisqueryreturnstheidentityoftheplug-inmoduleinthespecifiedslot.Thetablebelowshowstheplug-inmodulesavailablefortheKeysight34970A/34972A.
ModelNumber
ModuleDescription
34901A 20ChannelMultiplexer(2/4-wire)Module
34902A 16ChannelMultiplexer(2/4-wire)Module
34903A 20ChannelActuator/GPSwitchModule
34904A 4x8Two-WireMatrixModule
34905A 2GHzDual1:4RFMux,50OhmModule
34906A 2GHzDual1:4RFMux,75OhmModule
34907A MultifunctionModule
34908A 40ChannelSingle-EndedMultiplexer
Module
Parameters
Name Type RangeofValues DefaultValue
<slot> Numeric {100|200|300} Thisisarequiredparameter.
ReturnFormat
Thequeryreturnscomma-delimitedfieldsofASCIIcharacters,asshownbelow.Toreadthestringintoyourcomputer,besuretodimensionastringvariablewithatleast43characters.
<CompanyName>,<CardModelNumber>,<SerialNumber>,<FirmwareRev>
Forthe34970A,the<CompanyName>isHEWLETT-PACKARD.Forthe34972A,the<CompanyName>isKeysightTechnologies.IfyouhaveusedtheSYSTem:LANGuagecommandtosetthelanguageto"34970A",thequerywillalsoreturnthecompanynameasHEWLETT-PACKARD.
The<CardModelNumber>iseitheranumberfrom34901Athrough34908A.Thenumber0isreturnedforthe<SerialNumber>field.TheFirmwareRevisionhastheformR.Randindicatestherevisionoffirmwarecurrentlyinuseonthespecifiedmodule.
Ifthespecifiedslotisempty,thecommandrespondswitheitherKeysightTechnologies,0,0,0(34972A)orHEWLETT-PACKARD,0,0,0(34970A).
Example
Thefollowingcommandreturnstheidentityofthemoduleinslot300ofa34972A.
SYST:CTYP?300
TypicalResponse:KeysightTechnologies,34907A,0,1.0
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:CTYPe?
*IDN?
SYSTem:DATESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
SYSTem:DATE<yyyy>,<mm>,<dd>
SYSTem:DATE?
Description
Duringascan,theinstrumentstoresallreadingsandalarmswiththecurrenttimeanddate.Thiscommandsetstheinstrumentcalendar.
Parameters
Name Type RangeofValues
DefaultValue
<yyyy> Numeric Thecurrentyear
Thisisarequiredparameter.
<mm> Numeric Thecurrentmonth
Thisisarequiredparameter.
<dd> Numeric Thecurrentdayofthecurrentmonth
Thisisarequiredparameter.
Remarks
Whenshippedfromthefactory,theinstrumentissettothecurrenttimeanddateforGreenwichMeanTime(GMT).
Thecalendarsettingisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsthreecomma-separatedvaluesintheform"yyyy,mm,dd".
Examples
ThefollowingcommandsetstheinstrumentdatetoSeptember12,2009.
SYST:DATE2009,09,12
Thefollowingqueryreturnsthedate.
SYST:DATE?
TypicalResponse:2009,09,12
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:TIME
SYSTem:ERRor?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:ERRor?
Description
Thisqueryreadsandclearsoneerrorfromtheinstrument'serrorqueue.Arecordofupto10errors(34970A)or20errors(34972A)isstoredintheinstrument’serrorqueue.Errorsareretrievedinfirst-in-first-out(FIFO)order.Theerrorqueueisclearedbythe*CLS(clearstatus)commandorwhenpoweriscycled.Theerrorsarealsoclearedwhenyoureadthequeue.
ForacompletelistingoftheerrormessagesfortheKeysight34970A/34972A,seeSCPIErrorMessages.
Remarks
Theinstrumentbeepsonceeachtimeacommandsyntaxorhardwareerrorisgenerated.Thefront-panelERRORannunciatorturnsonwhenoneormoreerrorsarecurrentlystoredintheerrorqueue.
Errorsareretrievedinfirst-in-first-out(FIFO)order.Thefirsterrorreturnedisthefirsterrorthatwasstored.Onceyouhavereadalloftheinterface-specificerrors,theerrorsintheglobalerrorqueueareretrieved.
Errorsareclearedasyoureadthem.Whenyouhavereadallerrorsfromtheinterface-specificerrorqueue(errorsfromthecurrentI/Osession)andglobalerrorqueue(errorsfromanyI/Osession),theERRORannunciatorturnsoffandtheerrorsarecleared.
Ifmorethanthemaximumnumberoferrorshaveoccurred(10errorsonthe34970Aor20errorsonthe34972A),thelasterrorstoredinthequeue(themostrecenterror)isreplacedwith-350,"Errorqueueoverflow".Noadditionalerrorsarestoreduntilyouremoveerrorsfromthequeue.Ifnoerrorshaveoccurredwhenyoureadtheerrorqueue,theinstrumentrespondswith+0,"Noerror".
ThefrontpanelreportserrorsfromallI/Osessionsaswellastheglobalerrorqueue.Toreadtheerrorqueuefromthefrontpanel,usetheViewkey.
ErrorconditionsarealsosummarizedintheStatusByteRegister.FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Theinterface-specificandglobalerrorqueuesareclearedbythe*CLS(ClearStatus)commandandwhenpoweriscycled.Theerrorsarealsoclearedwhenyoureadtheerrorqueue.Theerror
queueisnotclearedbyaFactoryReset(*RSTcommand)oranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreadsandclearsoneerrorstringfromtheerrorqueue.Theerrorstringmaycontainupto160charactersandconsistsofanerrornumberandanerrorstringenclosedindoublequotes.Forexample:
-113,"Undefinedheader"
Example
Thefollowingqueryreadsandclearsoneerror.
SYST:ERR?
TypicalResponse:-101,"Invalidcharacter"
SeeAlsoSYSTemSubsystemIntroduction
*SRE
SYSTem:INTerfaceSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34970Aonly.
Syntax
SYSTem:INTerface{GPIB|RS232}
SYSTem:INTerface?
Description
Thiscommand/queryselectstheremoteinterfacefortheinstrument.Onlyoneinterfacecanbeenabledatatime.TheGPIBinterfaceisselectedwhentheinstrumentisshippedfromthefactory.
Remarks
Thiscommandonlyhaseffectonthe34970A.The34972Awillacceptthecommand,butthecommandwillhavenoeffect.Boththeparametersandtheresponsetothequeryaremeaningless.
Thenon-selectedinterfaceisdisabledimmediately.
ReturnFormat
ThequeryreturnsGPIBorRS232.Onthe34972A,the(meaningless)responseisGPIB.
Examples
ThefollowingcommandsetstheremoteinterfacetoRS-232ona34970A.
SYST:INTRS232
Thefollowingqueryreturnstheremoteinterfacefora34970A.
SYST:INT?
TypicalResponse:RS232
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:LOCal
SYSTem:REMote
SYSTem:LANGuageSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:LANGuage<language>
SYSTem:LANGuage?
Description
Thiscommandallowsyoutospecifywhethertheinstrumentshouldbehaveasa34970Aora34972A.
Parameters
Name Type RangeofValues DefaultValue
<language> Discrete {"34970A"|"34972A"} Thisisarequiredparameter.
Remarks
Thiscommandonlyaffectstheoutputofthe*IDN?andSYSTem:CTYPe?queries.
Ifyoudonotspecify34970Aor34972A,theinstrumentwilldispatchanerrormessage.
ReturnFormat
Thequeryreturns"34970A"or"34972A".
Examples
Thefollowingcommandsetsthelanguageto34970A.
SYST:LANG"34970A"
Thefollowingqueryreturnsthecurrent<language>settingfortheinstrument.
SYST:LANG?
TypicalResponse:"34970A"
SeeAlsoSYSTemSubsystemIntroduction
*IDN?
SYSTem:CTYPe?
SYSTem:LFRequency?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:LFRequency?
Description
Thiscommandreturnsthecurrentpower-linereferencefrequencyusedbytheinstrument.Whenyouapplypowertotheinstrument,theinstrumentautomaticallydetectsthepower-linefrequency(50Hz,60Hz,or400Hz)andusesthisvaluetodeterminetheintegrationtimeused.
Remarks
Ifthedetectedpowerlinefrequencyis400Hz,the50Hzreferencevalueisactuallyused(asubharmonicof400Hz).
TheinstrumentusesthisinformationindeterminingintegrationtimeinNPLCcommands.
Thereferencefrequencysettingisstoredinvolatilememoryandwillbelostwhenpoweristurnedoff.Theinstrumentautomaticallymeasuresthepower-linefrequency(50Hz,60Hz,or400Hz)atpower-on.
ReturnFormat
Thecommandreturns"50"(for50Hzor400Hz)or"60"indicatingthepresentreferencefrequencysetting.
Example
Thefollowingqueryreturnsthepowerlinefrequency.
SYST:LFR?
TypicalResponse:+60
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:LOCalSYSTem:REMoteSYSTEM:RWLockSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
SYSTem:LOCal
SYSTem:REMote
SYSTem:RWLock
Description
Thesecommandsplacetheinstrumentineitherthelocal,remoteorlocallockout(LLO)mode.
Remarks
IntheLOCalmode,allkeysonthefrontpanelarefullyfunctional.
IntheREMotemode,mostkeysonthefrontpanelaredisabled.TheexceptionsaretheLocal,MonandViewkeys.Also,theknobandthearrowsaboveitareenabled.
Inthelocallockoutmode(RWLock),allkeysonthefrontpanelaredisabled,includingtheLocalkey.
ThesecommandsarenotallowedoverGPIBonthe34970A.
Examples
Thefollowingcommandputstheinstrumentinlocalmode.
SYST:LOC
Thefollowingcommandputstheinstrumentinremotemode.
SYST:REMote
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:INTerface
SYSTem:LOCK:NAME?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:LOCK:NAME?
Description
ThisqueryreturnstheI/OinterfacenameoftheI/Osessionsendingthequery.YoucanusethereturnednametodeterminewhethertheI/OsessionownstheinterfacelockbycomparingittothevaluereturnedbySYSTem:LOCK:OWNer?.
Remarks
Usethiscommandtodeterminethelocknamefortheinterfacethatyouareusing.ThenusetheSYSTem:LOCK:OWNer?commandtodeterminewhichinterface,ifany,hasthelock.Onceyouhaveexecutedbothofthesecommands,youcancomparetheresultstodeterminewhetheryouhavethelock.
ThisqueryissometimesconfusedwiththeSYSTem:LOCK:OWNer?query.ThedifferenceisthatSYSTem:LOCK:OWNer?returnsthenameoftheinterfacethathasthelock,andSYSTem:LOCK:NAME?returnsthenameofthecurrentinterface,regardlessofwhetherithasthelock.
ReturnFormat
ThequeryreturnsUSBorLAN<IPAddress>indicatingtheI/Ointerfacebeingusedbythequeryingcomputer.TheIPaddressisfourintegersseparatedbyperiods,suchas156.140.79.29,andthereisnospacebetweenthewordLANandthe<IPAddress>.Therefore,atypicalLANwithanIPaddresswouldbereturnedasLAN156.140.79.29.
Example
ThefollowingqueryreturnsthenameoftheI/Ointerfaceinusebythequeryingcomputers.
SYST:LOCK:NAME?
TypicalResponse:"LAN169.254.149.35"
SeeAlsoSYSTem:LOCK:OWNer?
SYSTem:LOCK:RELease
SYSTem:LOCK:REQuest?
SYSTem:LOCK:OWNer?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:LOCK:OWNer?
Description
ThisqueryreturnsthenameoftheI/Ointerfacethatcurrentlyhasalock.
Remarks
IfthevaluereturnedbythisquerymatchesthevaluereturnedbySYSTem:LOCK:NAME?,thentheI/Osessionsendingthisqueryownsthelock.
Whenalockisactive,Bit10intheStandardOperationRegisterwillbeset(seeSTATus:OPERation:CONDition?command).WhenthereisnoactivelockonanyI/Ointerface,thisbitwillbecleared.
ThisqueryissometimesconfusedwiththeSYSTem:LOCK:NAME?query.ThedifferenceisthatSYSTem:LOCK:OWNer?returnsthenameoftheinterfacethathasthelock,andSYSTem:LOCK:NAME?returnsthenameofthecurrentinterface,regardlessofwhetherithasthelock.
ReturnFormat
ThequeryreturnsUSBorLAN<IPAddress>indicatingtheI/Ointerfacethatcurrentlyhasalock.Ifnointerfacehasalock,thequeryreturnsNONE.TheIPaddressisfourintegersseparatedbyperiods,suchas156.140.79.29,andthereisnospacebetweenthewordLANandthe<IPAddress>.Therefore,atypicalLANwithanIPaddresswouldbereturnedasLAN156.140.79.29.
Example
ThefollowingqueryreturnsthenameoftheI/Ointerfacethatcurrentlyhasalock.
SYST:LOCK:OWN?
TypicalResponse:"USB"
SeeAlsoSYSTem:LOCK:NAME?
SYSTem:LOCK:RELease
SYSTem:LOCK:REQuest?
SYSTem:LOCK:RELeaseSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:LOCK:RELease
Description
Thiscommanddecrementsthelockcountbyoneandreleasestheinstrumentlock.
Remarks
Whenalockisactive,Bit10intheStandardOperationRegisterwillbeset(seeSTATus:OPERation:CONDition?command).Whenthelockisreleased,thisbitiscleared.
Examples
Thefollowingcommanddecreasesthelockcountbyone.
SYST:LOCK:REL
Thefollowingseriesofcommandsillustratesusage.
InitialState=unlocked,Count=0
<FROMUSB>SYST:LOCK:REQ?returns+1
(requestsuccessful)
State=locked,Count=1
<FROMLAN>SYST:LOCK:REQ?returns+0
becauseUSBhaslock
State=locked,Count=1
<FROMUSB>SYST:LOCK:REQ?returns+1
(requestsuccessful)
State=locked,Count=2
<FROMUSB>SYST:LOCK:REL
State=locked,Count=1
<FROMUSB>SYST:LOCK:REL
State=unlocked,Count=0
Notethatforeachsuccessfullockrequest,alockreleaseisrequired.Tworequestsrequiretworeleases.
SeeAlsoSYSTem:LOCK:NAME?
SYSTem:LOCK:OWNer?
SYSTem:LOCK:REQuest?
SYSTem:LOCK:REQuest?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:LOCK:REQuest?
Description
Thiscommandissuesarequesttolocktheinstrument'sconfigurationtoasingleI/Ointerface.Thisallowsyoutolocktheinstrumentorsharetheinstrumentwithothercomputers.
Remarks
Whenarequestisgranted,onlyI/Osessionsfromtheinterfacewhichwasgrantedthelockwillbeallowedtochangethestateoftheinstrument.FromtheotherI/Ointerfaces,youcanquerythestateoftheinstrumentbutnoinstrumentconfigurationchangesormeasurementsareallowed.
Lockrequestscanbenestedandeachrequestwillincreasethelockcountby1.Foreveryrequest,youwillneedareleasefromthesameI/Ointerface(seeSYSTem:LOCK:RELeasecommand).
InstrumentlocksarehandledattheI/Ointerfacelevel(USBorsockets)andyouareresponsibleforallcoordinationbetweenthreadsand/orprogramsonthatinterface.
Locksfromsocketsessionswillbeautomaticallyreleasedwhenasocketdisconnectisdetected.
Whenalockisgranted,Bit10intheStandardOperationRegisterwillbeset(seeSTATus:OPERation:CONDition?command).
ReturnFormat
Thecommandimmediatelyreturns+1ifthelockrequestisgrantedor+0ifdenied.
Examples
ThefollowingcommandrequestsalockofthecurrentI/Ointerface.
SYST:LOCK:REQ?
TypicalResponse:+1
Thefollowingseriesofcommandsillustratesusage.
InitialState=unlocked,Count=0
<FROMUSB>SYST:LOCK:REQ?returns+1
(requestsuccessful)
State=locked,Count=1
<FROMLAN>SYST:LOCK:REQ?returns+0
becauseUSBhaslock
State=locked,Count=1
<FROMUSB>SYST:LOCK:REQ?returns+1
(requestsuccessful)
State=locked,Count=2
<FROMUSB>SYST:LOCK:REL
State=locked,Count=1
<FROMUSB>SYST:LOCK:REL
State=unlocked,Count=0
Notethatforeachsuccessfullockrequest,alockreleaseisrequired.Tworequestsrequiretworeleases.
SeeAlsoSYSTem:LOCK:NAME?
SYSTem:LOCK:OWNer?
SYSTem:LOCK:RELease
SYSTem:PRESetSyntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:PRESet
Description
Thiscommandpresetstheinstrumenttoaknownconfiguration.
Remarks
SeeInstrumentPresetStateforacompletelistingoftheinstrument’spresetstate.
ThiscommandisequivalenttoselectingPRESETfromthefront-panelSto/RclMenu.
Example
Thefollowingcommandreturnstheinstrumenttoitspresetstate.
SYST:PRES
SeeAlsoSYSTemSubsystemIntroduction
*RST
SYSTem:CPON
SYSTem:SECurity:IMMediateSyntax|Description|Parameters|Remarks|>ReturnFormat|Example
Thisfunctionalityisavailableonthe34972Aonly.
Syntax
SYSTem:SECurity:IMMediate
Description
Thiscommandclearsandsanitizesallinstrumentmemoryexceptfortheinstrument'sfirmware,MACaddress,calibrationparameters,andserialnumber.Itthenrebootstheinstrumenttothenewmemorystate.Thiscommandistypicallyusedtoclearallmemorybeforeremovingtheinstrumentfromasecurearea.
Thiscommandisnotrecommendedforuseinroutineapplicationsbecauseofthepossibilityofunintendedlossofdata.
Remarks
ThiscommandinitializesallinstrumentsettingstotheirFactoryReset(*RSTcommand)values.
AllI/Osettings,suchastheIPaddress,arereturnedtotheirfactorysettings.
ThiscommandwillnotclearanattachedUSBstoragedevice.
Thecommandclearsandsanitizesalluserfilesontheinternalfilesystem.
Example
Thefollowingcommandclearsallinstrumentmemoryotherthantheinstrument'sfirmware,MACaddress,calibrationparameters,andserialnumber.
SYST:SEC:IMM
SeeAlsoSYSTemSubsystemIntroduction
*RST
SYSTem:TIMESyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
SYSTem:TIME<hh>,<mm>,<ss.sss>
SYSTem:TIME?
Description
Duringascan,theinstrumentstoresallreadingsandalarmswiththecurrenttimeanddate.Thiscommandsetstheinstrumentclock(basedona24-hourclock).
Parameters
Name Type RangeofValues
DefaultValue
<hh> Numeric Thehourin24-hourclockformat,from0to23
Thisisarequiredparameter.
<mm> Numeric Theminutes,from0to59
Thisisarequiredparameter.
<ss.sss> Numeric Theseconds,with1msresolution,from00.000to59.999
Thisisarequiredparameter.
Remarks
Whenshippedfromthefactory,theinstrumentissettothecurrenttimeanddateforGreenwichMeanTime(GMT).
Theclocksettingisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsthreecomma-separatedvaluesintheform"hh,mm,sss.ss".
Examples
Thefollowingcommandsetstheclockto3:30:23.000PM.
SYST:TIME15,30,23.000
Thefollowingqueryreturnsthecurrenttime.
SYST:TIME?
TypicalResponse:15,30,23.000
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:DATE
SYSTem:TIME
SYSTem:TIME:SCAN?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:TIME:SCAN?
Description
Thisqueryreturnsthetimeatthestartofthescan.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Remarks
Youcanreadthetimeatanytime,evenduringascan.
ThiscommandisnotaffectedbytheFORMat:READing:TIME:TYPEcommand,whichselectsthetimeformatforstoringscanneddatainmemory(absolutetimeversusrelativetime).
ThiscommandisnotaffectedbytheCALCulate:AVERage:CLEarcommand,whichclearsallvaluesfromthestatisticsregisters.
Theinstrumentclearsallstoreddataonallchannelswhenanewscanisstarted,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).
ReturnFormat
Thequeryreturnsastringindicatingthetimeanddateatthestartofthemostrecentscan.
Thestringreturnedhastheformyyyy,mm,dd,hh,mm,ss.sss:
yyyy istheyearmm isthemonthdd isthedayofthemonthhh isthehourin24-hourformatmm istheminutesss.sss istheseconds(with1msresolution)
Forexample:
Example
Thefollowingqueryreturnsthetimeanddateatthestartofthemostrecentscan.
SYST:TIME:SCAN?
TypicalResponse:2009,07,26,22,03,10.314
SeeAlsoSYSTemSubsystemIntroduction
SYSTem:DATE
SYSTem:TIME
SYSTem:VERSion?Syntax|Description|Parameters|Remarks|ReturnFormat|Example
Syntax
SYSTem:VERSion?
Description
ThisqueryreturnstheversionoftheSCPI(StandardCommandsforProgrammableInstruments)standardwithwhichtheinstrumentisincompliance.TheinstrumentcomplieswiththerulesandconventionsoftheindicatedversionoftheSCPIstandard.
YoucannotquerytheSCPIversionfromthefrontpanel.
ReturnFormat
TheinstrumentreturnstheversionintheformYYYY.V,whereYYYYistheyearandVistheversionnumber.
Example
Thefollowingqueryreturnstheversionnumberofthesoftware.
SYST:VERS?
TypicalResponse:1994.0
SeeAlsoSYSTemSubsystemIntroduction
TRIGgerSubsystemIntroduction
CommandSummaryTRIGger:COUNt
TRIGger:COUNt?
TRIGger:SOURce
TRIGger:SOURce?
TRIGger:TIMer
TRIGger:TIMer?
TRIGger:COUNtSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
TRIGger:COUNt{<count>|MIN|MAX|INFinity}
TRIGger:COUNt?
Description
Thiscommandspecifiesthenumberoftimestosweepthroughthescanlist.Asweepisonepassthroughthescanlist.Thescanstopswhenthenumberofspecifiedsweepshasoccurred.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<count> NumericAnintegerfrom1to50,000triggers,orcontinuous(INFinity).
MIN=1
MAX=50,000
Thisisarequiredparameter.
Remarks
Aftersettingthetriggercount,youmustplacetheinternalDMMinthe"wait-for-trigger"stateusingtheINITiateorREAD?command.Atriggerwillnotbeacceptedfromtheselectedtriggersource(seeTRIGger:SOURcecommand)untiltheinternalDMMisinthe"wait-for-trigger"state.
a. FortheBUSsource,thetriggercountsetsthenumberof*TRGcommandsthatwillbeacceptedbeforereturningtothe"idle"triggerstate.
b. FortheEXTernalsource,thetriggercountsetsthenumberofexternalpulsesthatwillbeacceptedbeforereturningtothe"idle"triggerstate.
c. FortheALARmxsource,thetriggercountsetsthenumberofalarmsthatwillbeacceptedbeforereturningtothe"idle"triggerstate.
d. FortheTIMersource,thetriggercountsetsthenumberoftimestheinstrumentwillsweepthroughthescanlistandthereforedeterminestheoveralldurationofthescan.
Youcanstoreatleast50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.
Tosetthetrigger-to-triggerinterval(inseconds)formeasurementsonthechannelsinthepresentscanlist,usetheTRIGger:TIMercommand.
TheCONFigureandMEASure?commandsautomaticallysetthetriggercountto1.
Theinstrumentsetsthetriggercountto1afteraFactoryReset
(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnsthescancountintheform"+1.00000000E+01".Foracontinuoustrigger(INFinity),thecountisreturnedas"9.90000200E+37".
Examples
ThefollowingprogramsegmentconfigurestwochannelsforDCvoltagemeasurements,putsthechannelsinthescanlist(thescanlistisredefined),andsetsthetriggercountto10.Foreachtriggerreceived,onereadingisreturnedforeachchannel(20readingstotal).
CONF:VOLT:DC10,0.003,(@103,108)
ROUT:SCAN(@103,108)
TRIG:COUN10
INIT
ThefollowingprogramsegmentconfiguresthecurrentscanlistforanACvoltagemeasurementandsetsthetriggercountto5.Foreachtriggerreceived,onereadingisreturned(5readingstotal).
CONF:VOLT:AC10,0.001,(@205,206,208)
TRIG:COUN5
INIT
Thefollowingqueryreturnsthecurrenttriggercount.
TRIG:COUN?
TypicalResponse:+5.00000000E+00
SeeAlsoTRIGgerSubsystemIntroduction
ROUTe:CHANnel:ADVance:SOURce
ROUTe:SCAN
TRIGger:SOURce
TRIGger:TIMer
TRIGger:SOURceSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
TRIGger:SOURce<source>
TRIGger:SOURce?
Description
Selectthetriggersourcetocontroltheonsetofeachsweepthroughthescanlist(asweepisonepassthroughthescanlist).Theinstrumentwillacceptasoftware(bus)command,animmediate(continuous)scantrigger,anexternalTTLtriggerpulse,analarm-initiatedaction,oraninternallypacedtimer.
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues
DefaultValue
<source> Discrete{BUS|IMMediate|EXTernal|ALARm1|ALARm2|ALARm3|ALARm4|TIMer}
IMMediate=ContinuousscantriggerBUS=SoftwaretriggerEXTernal=AnexternalTTLpulsetriggerALARm=TriggeronanalarmTIMer=Internallypacedtimertrigger
Thisisarequiredparameter.
ThefactorydefaultisIMMediate.
Remarks
FortheIMMediate(continuous)source,thetriggersignalisalwayspresent.Whenyouplacetheinstrumentinthe"wait-for-trigger"state,thetriggerisissuedimmediately.
TheREAD?andMEASurecommandsandqueriescannotbeusedtotakereadingswhenthetriggersourceisBUS.Thisiscalledatriggerdeadlockcondition.
FortheBUS(software)source,theinstrumentistriggeredbythe*TRGcommandreceivedovertheremoteinterface.The*TRGcommandwillnotbeacceptedunlesstheinstrumentisinthe"wait-for-trigger"state(seeINITiatecommand).Iftheinstrumentreceivesanexternaltriggerbeforethenext"waitingfortrigger"state,itwillbufferone*TRGcommandandthenignoreanyadditionaltriggersreceived(noerrorisgenerated).
FortheEXTernalsource,theinstrumentwillacceptahardwaretriggerappliedtotherear-panelExtTrigInputline(Pin6).Theinstrumenttakesonesweepthroughthescanlisteachtimealow-trueTTLpulseisreceived.Iftheinstrumentreceivesanexternaltriggerbutisnotinthe"wait-for-trigger"state,itwillbufferonetriggerandthenignoreanyadditionaltriggersreceived(noerrorisgenerated).Also,ifthetriggersourceisBUS,youcanusethescanbuttonasatrigger.
FortheALARmxsource,theinstrumentistriggeredeachtimeareadingcrossesanalarmlimitonachannel.SeetheOUTPut:ALARm<n>:SOURcecommandformoreinformation.Withthissource,youcanusetheMonitormode(seeROUTe:MONitor:STATecommand)tocontinuouslytakereadingsonaselectedchannelandwaitforanalarmonthatchannel.Digitalinputandtotalizerchannelsdonothavetobepartoftheactivescanlisttobemonitored.
FortheTIMersource,youcontrolthetrigger-to-triggerinterval(inseconds)formeasurementsonthechannelsinthepresentscanlist.UsetheTRIGger:TIMercommandtosetthewaitperiod.
Afterselectingthetriggersource,youmustplacetheinstrumentinthe"wait-for-trigger"stateusingtheINITiateorREAD?command.Atriggerwillnotbeacceptedfromtheselectedtriggersourceuntiltheinstrumentisinthe"wait-for-trigger"state.
AlthoughtheTRIGger:SOURcecommandsharessomeofthesamesignalsastheROUTe:CHANnel:ADVance:SOURcecommand(usedforexternalscanning),theycannotbesettothesamesource(exceptIMMediate).Ifyouattempttoselectthesamesource,anerrorisgeneratedandtheTRIGger:SOURceisresettoIMMediate.
TheCONFigureandMEASure?commandsautomaticallysetthetriggersourcetoIMMediate.
TheinstrumentselectstheimmediatetriggersourceafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnsthetriggersourceas"BUS","IMM","EXT","ALAR1","ALAR2","ALAR3","ALAR4",or"TIM".
Examples
Thefollowingprogramsegmentselectstheexternaltriggersource.Inthisconfiguration,theinstrumentsweepsthroughthescanlistonceeachtimealow-trueTTLpulseisreceivedontherear-panelExtTrigInputline(Pin6).
TRIG:SOUREXT
INIT
Thefollowingprogramsegmentselectsthebus(software)triggersource.Notethatthe*TRGcommandwillnotbeacceptedunlesstheinternalDMMisinthe"wait-for-trigger"state.
TRIG:SOURBUS
INIT
*TRG
ThefollowingprogramsegmentselectsthealarmsourceandconfigurestheinstrumenttoscanwhenanalarmisreportedonAlarm1.TheMonitormodeisusedtoevaluatealarmconditionsontheselectedchannel.
ROUT:SCAN(@103)!SetthescanlisttoasinglechannelTRIG:SOURALARM1!SelecttriggersourceOUTP:ALAR:SOUR(@103)CALC:LIM:UPP10.25,(@103)!SetupperalarmlimitCALC:LIM:UPP:STATON,(@103)!EnablealarmsROUT:MON(@103)!SelectmonitorchannelROUT:MON:STATON!EnablemonitormodeINIT
Thefollowingprogramsegmentselectsthetimersourceandsetsthescanintervalto30milliseconds.
TRIG:SOURTIMER!Selecttrigger
source
TRIG:TIM30E-03!Scanintervalis30
ms
INIT
Thefollowingqueryreturnsthetriggersourcecurrentlyselected.
TRIG:SOUR?
TypicalResponse:EXT
SeeAlsoTRIGgerSubsystemIntroduction
*TRG
OUTPut:ALARm{1|2|3|4}:SOURce
ROUTe:CHANnel:ADVance:SOURce
ROUTe:MONitor:STATe
TRIGger:TIMer
TRIGger:TIMerSyntax|Description|Parameters|Remarks|ReturnFormat|Examples
Syntax
TRIGger:TIMer{<seconds>|MIN|MAX}
TRIGger:TIMer?[{MIN|MAX}]
Description
Thiscommandsetsthetrigger-to-triggerinterval(inseconds)formeasurementsonthechannelsinthepresentscanlist.Thiscommanddefinesthetimefromthestartofonetriggertothestartofthenexttrigger,uptothespecifiedtriggercount(seeTRIGger:COUNtcommand).
UsedWith:
34901A20ChannelMultiplexer(2/4-wire)Module
34902A16ChannelMultiplexer(2/4-wire)Module
34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)
34908A40ChannelSingle-EndedMultiplexerModule
Parameters
Name Type RangeofValues DefaultValue
<seconds> NumericAnumberfrom0secondsto359,999with1msresolution.
MIN=0seconds,MAX=359,999seconds
Notethat359,999isonesecondlessthan100hours.
Thisisarequiredparameter.
Remarks
ThescanintervalappliestotheTIMertriggersourceassetbytheTRIGger:SOURcecommand.
Ifyouareusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodules.
Ifthescanintervalislessthanthetimerequiredtomeasureallchannelsinthescanlist,theinstrumentwillscancontinuously,asfastaspossible(noerrorisgenerated).
TheCONFigureandMEASure?commandsautomaticallysetthetriggerintervalto1secondandthetriggercountto1sweep.
Theinstrumentsetsthescanintervaltoimmediate(0seconds)afteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.
ReturnFormat
Thequeryreturnsthescan-to-scanintervalinsecondsintheform"+1.00000000E+01".
Examples
Thefollowingprogramsegmentsetsthetriggerintervalto30milliseconds.
TRIG:SOURTIMER
TRIG:TIM30E-03
Thefollowingqueryreturnsthetriggerintervalinseconds.
TRIG:TIM?
TypicalResponse:+3.00000000E-02
SeeAlsoTRIGgerSubsystemIntroduction
TRIGger:COUNt
TRIGger:SOURce
CommandsA-ZA–C|D-L|M-R|S|T-W
AABORt
CCALCulate:AVERage:AVERage?
CALCulate:AVERage:CLEar
CALCulate:AVERage:COUNt?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:MAXimum:TIME?
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:PTPeak?
CALCulate:COMPare:DATA
CALCulate:COMPare:DATA?
CALCulate:COMPare:MASK
CALCulate:COMPare:MASK?
CALCulate:COMPare:STATe
CALCulate:COMPare:STATe?
CALCulate:COMPare:TYPE
CALCulate:COMPare:TYPE?
CALCulate:LIMit:LOWer
CALCulate:LIMit:LOWer?
CALCulate:LIMit:LOWer:STATe
CALCulate:LIMit:LOWer:STATe?
CALCulate:LIMit:UPPer
CALCulate:LIMit:UPPer?
CALCulate:LIMit:UPPer:STATe
CALCulate:LIMit:UPPer:STATe?
CALCulate:SCALe:GAIN
CALCulate:SCALe:GAIN?
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet?
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALCulate:SCALe:STATe?
CALCulate:SCALe:UNIT
CALCulate:SCALe:UNIT?
CALibration?
CALibration:COUNt?
CALibration:SECure:CODE
CALibration:SECure:STATe
CALibration:SECure:STATe?
CALibration:STRing
CALibration:STRing?
CALibration:VALue
CALibration:VALue?
*CLS
CONFigure?
CONFigure:CURRent:AC
CONFigure:CURRent:DC
CONFigure:DIGital:BYTE
CONFigure:FREQuency
CONFigure:FRESistance
CONFigure:PERiod
CONFigure:RESistance
CONFigure:TEMPerature
CONFigure:TOTalize
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
DDATA:LAST?
DATA:POINts?
DATA:POINts:EVENt:THReshold
DATA:POINts:EVENt:THReshold?
DATA:REMove?
DIAGnostic:DMM:CYCLes?
DIAGnostic:DMM:CYCLes:CLEar
DIAGnostic:PEEK:SLOT:DATA?
DIAGnostic:POKE:SLOT:DATA
DIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
DISPlay
DISPlay?
DISPlay:TEXT
DISPlay:TEXT?
DISPlay:TEXT:CLEar
E*ESE
*ESE?
*ESR?
FFETCh?
FORMat:READing:ALARm
FORMat:READing:ALARm?
FORMat:READing:CHANnel
FORMat:READing:CHANnel?
FORMat:READing:TIME
FORMat:READing:TIME?
FORMat:READing:TIME:TYPE
FORMat:READing:TIME:TYPE?
FORMat:READing:UNIT
FORMat:READing:UNIT?
I*IDN?
INITiate
INPut:IMPedance:AUTO
INPut:IMPedance:AUTO?
INSTrument:DMM
INSTrument:DMM?
INSTrument:DMM:INSTalled?
LLXI:IDENtify[:STATe]
LXI:IDENtify[:STATe]?
LXI:RESet
LXI:RESTart
MMEASure:CURRent:AC?
MEASure:CURRent:DC?
MEASure:DIGital:BYTE?
MEASure:FREQuency?
MEASure:FRESistance?
MEASure:PERiod?
MEASure:RESistance?
MEASure:TEMPerature?
MEASure:TOTalize?
MEASure:VOLTage:AC?
MEASure:VOLTage:DC?
MEMory:NSTates?
MEMory:STATe:DELete
MEMory:STATe:NAME
MEMory:STATe:NAME?
MEMory:STATe:RECall:AUTO
MEMory:STATe:RECall:AUTO?
MEMory:STATe:VALid?
MMEMory:EXPort?
MMEMory:FORMat:READing:CSEParator
MMEMory:FORMat:READing:CSEParator?
MMEMory:FORMat:READing:RLIMit
MMEMory:FORMat:READing:RLIMit?
MMEMory:IMPort:CATalog?
MMEMory:IMPort:CONFig?
MMEMory:LOG[:ENABle]
MMEMory:LOG[:ENABle]?
O*OPC
*OPC?
OUTPut:ALARm:CLEar:ALL
OUTPut:ALARm:MODE
OUTPut:ALARm:MODE?
OUTPut:ALARm:SLOPe
OUTPut:ALARm:SLOPe?
OUTPut:ALARm{1|2|3|4}:CLEar
OUTPut:ALARm{1|2|3|4}:SOURce
OUTPut:ALARm{1|2|3|4}:SOURce?
P*PSC
*PSC?
RR?
*RCL
READ?
ROUTe:CHANnel:ADVance:SOURce
ROUTe:CHANnel:ADVance:SOURce?
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay?
ROUTe:CHANnel:DELay:AUTO
ROUTe:CHANnel:DELay:AUTO?
ROUTe:CHANnel:FWIRe
ROUTe:CHANnel:FWIRe?
ROUTe:CLOSe
ROUTe:CLOSe?
ROUTe:CLOSe:EXCLusive
ROUTe:DONE?
ROUTe:MONitor
ROUTe:MONitor?
ROUTe:MONitor:DATA?
ROUTe:MONitor:STATe
ROUTe:MONitor:STATe?
ROUTe:OPEN
ROUTe:OPEN?
ROUTe:SCAN
ROUTe:SCAN?
ROUTe:SCAN:SIZE?
*RST
S*SAV
[SENSe:]CURRent:AC:BANDwidth
[SENSe:]CURRent:AC:BANDwidth?
[SENSe:]CURRent:AC:RANGe
[SENSe:]CURRent:AC:RANGe?
[SENSe:]CURRent:AC:RANGe:AUTO
[SENSe:]CURRent:AC:RANGe:AUTO?
[SENSe:]CURRent:AC:RESolution
[SENSe:]CURRent:AC:RESolution
[SENSe:]CURRent:DC:APERture
[SENSe:]CURRent:DC:APERture?
[SENSe:]CURRent:DC:NPLC
[SENSe:]CURRent:DC:NPLC?
[SENSe:]CURRent:DC:RANGe
[SENSe:]CURRent:DC:RANGe?
[SENSe:]CURRent:DC:RANGe:AUTO
[SENSe:]CURRent:DC:RANGe:AUTO?
[SENSe:]CURRent:DC:RESolution
[SENSe:]CURRent:DC:RESolution?
[SENSe:]DIGital:DATA:{BYTE|WORD}?
[SENSe:]FREQuency:APERture
[SENSe:]FREQuency:APERture?
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:RANGe:LOWer?
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]FREQuency:VOLTage:RANGe?
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
[SENSe:]FREQuency:VOLTage:RANGe:AUTO?
[SENSe:]FRESistance:APERture
[SENSe:]FRESistance:APERture?
[SENSe:]FRESistance:NPLC
[SENSe:]FRESistance:NPLC?
[SENSe:]FRESistance:OCOMpensated
[SENSe:]FRESistance:OCOMpensated?
[SENSe:]FRESistance:RANGe
[SENSe:]FRESistance:RANGe?
[SENSe:]FRESistance:RANGe:AUTO
[SENSe:]FRESistance:RANGe:AUTO?
[SENSe:]FRESistance:RESolution
[SENSe:]FRESistance:RESolution?
[SENSe:]FUNCtion
[SENSe:]FUNCtion?
[SENSe:]PERiod:APERture
[SENSe:]PERiod:APERture?
[SENSe:]PERiod:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe?
[SENSe:]PERiod:VOLTage:RANGe:AUTO
[SENSe:]PERiod:VOLTage:RANGe:AUTO?
[SENSe:]RESistance:APERture
[SENSe:]RESistance:APERture?
[SENSe:]RESistance:NPLC
[SENSe:]RESistance:NPLC?
[SENSe:]RESistance:OCOMpensated
[SENSe:]RESistance:OCOMpensated?
[SENSe:]RESistance:RANGe
[SENSe:]RESistance:RANGe?
[SENSe:]RESistance:RANGe:AUTO
[SENSe:]RESistance:RANGe:AUTO?
[SENSe:]RESistance:RESolution
[SENSe:]RESistance:RESolution?
[SENSe:]TEMPerature:APERture
[SENSe:]TEMPerature:APERture?
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:NPLC?
[SENSe:]TEMPerature:RJUNction?
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated?
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]?
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE?
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated?
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]?
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE?
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk?
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction?
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE?
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE?
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE?
[SENSe:]TEMPerature:TRANsducer:TYPE
[SENSe:]TEMPerature:TRANsducer:TYPE?
[SENSe:]TOTalize:CLEar:IMMediate
[SENSe:]TOTalize:DATA?
[SENSe:]TOTalize:SLOPe
[SENSe:]TOTalize:SLOPe?
[SENSe:]TOTalize:STARt[:IMMediate]
[SENSe:]TOTalize:STOP[:IMMediate]
[SENSe:]TOTalize:TYPE
[SENSe:]TOTalize:TYPE?
[SENSe:]VOLTage:AC:RANGe
[SENSe:]VOLTage:AC:RANGe?
[SENSe:]VOLTage:AC:RANGe:AUTO
[SENSe:]VOLTage:AC:RANGe:AUTO?
[SENSe:]VOLTage:AC:BANDwidth
[SENSe:]VOLTage:AC:BANDwidth?
[SENSe:]VOLTage:DC:APERture
[SENSe:]VOLTage:DC:APERture?
[SENSe:]VOLTage:DC:NPLC
[SENSe:]VOLTage:DC:NPLC?
[SENSe:]VOLTage:DC:RANGe
[SENSe:]VOLTage:DC:RANGe?
[SENSe:]VOLTage:DC:RANGe:AUTO
[SENSe:]VOLTage:DC:RANGe:AUTO?
[SENSe:]VOLTage:DC:RESolution
[SENSe:]VOLTage:DC:RESolution?
[SENSe:]ZERO:AUTO
[SENSe:]ZERO:AUTO?
SOURce:DIGital:DATA[:{BYTE|WORD}]
SOURce:DIGital:DATA[:{BYTE|WORD}]?
SOURce:DIGital:STATe?
SOURce:VOLTage
SOURce:VOLTage?
*SRE
*SRE?
STATus:ALARm:CONDition?
STATus:ALARm:ENABle
STATus:ALARm:ENABle?
STATus:ALARm[:EVENt]?
STATus:OPERation:CONDition?
STATus:OPERation:ENABle
STATus:OPERation:ENABle?
STATus:OPERation[:EVENt]?
STATus:PRESet
STATus:QUEStionable:CONDition?
STATus:QUEStionable:ENABle
STATus:QUEStionable:ENABle?
STATus:QUEStionable[:EVENt]?
*STB?
SYSTem:ALARm?
SYSTem:COMMunicate:LAN:CONTrol?
SYSTem:COMMunicate:LAN:DHCP
SYSTem:COMMunicate:LAN:DHCP?
SYSTem:COMMunicate:LAN:DNS
SYSTem:COMMunicate:LAN:DNS?
SYSTem:COMMunicate:LAN:DOMain?
SYSTem:COMMunicate:LAN:GATEway
SYSTem:COMMunicate:LAN:GATEway?
SYSTem:COMMunicate:LAN:HOSTname
SYSTem:COMMunicate:LAN:HOSTname?
SYSTem:COMMunicate:LAN:IPADdress
SYSTem:COMMunicate:LAN:IPADdress?
SYSTem:COMMunicate:LAN:MAC?
SYSTem:COMMunicate:LAN:SMASk
SYSTem:COMMunicate:LAN:SMASk?
SYSTem:COMMunicate:LAN:TELNet:PROMpt
SYSTem:COMMunicate:LAN:TELNet:PROMpt?
SYSTem:COMMunicate:LAN:TELNet:WMESsage
SYSTem:COMMunicate:LAN:TELNet:WMESsage?
SYSTem:COMMunicate:LAN:UPDate
SYSTem:CPON
SYSTem:CTYPe?
SYSTem:DATE
SYSTem:DATE?
SYSTem:ERRor?
SYSTem:INTerface
SYSTem:INTerface?
SYSTem:LANGuage
SYSTem:LANGuage?
SYSTem:LFRequency?
SYSTem:LOCal
SYSTem:LOCK:NAME?
SYSTem:LOCK:OWNer?
SYSTem:LOCK:RELease
SYSTem:LOCK:REQuest?
SYSTem:PRESet
SYSTem:REMote
SYSTem:RWLock
SYSTem:SECurity[:IMMediate]
SYSTem:TIME
SYSTem:TIME?
SYSTem:TIME:SCAN?
SYSTem:VERSion?
T*TRG
TRIGger:COUNt
TRIGger:COUNt?
TRIGger:SOURce
TRIGger:SOURce?
TRIGger:TIMer
TRIGger:TIMer?
*TST?
UUNIT:TEMPerature
UNIT:TEMPerature?
W*WAI
Keysight34970A/34972ACommandQuickReference
PrintablePDFVersion
SyntaxConventions
Braces({})enclosetheparameterchoicesforagivencommandstring.Thebracesarenotsentwiththecommandstring.
Averticalbar(|)separatesmultipleparameterchoicesforagivencommandstring.Thebarisnotsentwiththecommandstring.
Anglebrackets(<>)indicatethatyoumustspecifyavaluefortheenclosedparameter.Forexample,theabovesyntaxstatementshowsthe<range>parameterenclosedintrianglebrackets.Thebracketsarenotsentwiththecommandstring.Youmustspecifyavaluefortheparameter(e.g.,"VOLT:DC:RANG10").
Someparametersareenclosedinsquarebrackets([]).Thesquarebracketsindicatethattheparameterisoptionalandcanbeomitted.Thebracketsarenotsentwiththecommandstring.Ifyoudonotspecifyavalueforanoptionalparameter,theinstrumentchoosesadefaultvalue.
CALCulateSubsystem
CALCulate:AVERage:AVERage?[(@<ch_list>)]
CALCulate:AVERage:CLEar[(@<ch_list>)]
CALCulate:AVERage:COUNt?[(@<ch_list>)]
CALCulate:AVERage:MAXimum?[(@<ch_list>)]
CALCulate:AVERage:MAXimum:TIME?[(@<ch_list>)]
CALCulate:AVERage:MINimum?[(@<ch_list>)]
CALCulate:AVERage:MINimum:TIME?[(@<ch_list>)]
CALCulate:AVERage:PTPeak?[(@<ch_list>)]
CALCulate:COMPare:DATA<data>[,(@<ch_list>)]
CALCulate:COMPare:DATA?[(@<ch_list>)]
CALCulate:COMPare:MASK<mask>[,(@<ch_list>)]
CALCulate:COMPare:MASK?[(@<ch_list>)]
CALCulate:COMPare:STATe<state>[,(@<ch_list>)]
CALCulate:COMPare:STATe?[(@<ch_list>)]
CALCulate:COMPare:TYPE<mode>[,(@<ch_list>)]
CALCulate:COMPare:TYPE?[(@<ch_list>)]
CALCulate:LIMit:LOWer<lo_limit>[,(@<ch_list>)]
CALCulate:LIMit:LOWer?[(@<ch_list>)]
CALCulate:LIMit:LOWer:STATe<mode>,(@<ch_list>)
CALCulate:LIMit:LOWer:STATe?(@<ch_list>)
CALCulate:LIMit:UPPer<hi_limit>[,(@<ch_list>)]
CALCulate:LIMit:UPPer?[(@<ch_list>)]
CALCulate:LIMit:UPPer:STATe<mode>,(@<ch_list>)
CALCulate:LIMit:UPPer:STATe?(@<ch_list>)
CALCulate:SCALe:GAIN<gain>[,(@<ch_list>)]
CALCulate:SCALe:GAIN?[(@<ch_list>)]
CALCulate:SCALe:OFFSet<offset>[,(@<ch_list>)]
CALCulate:SCALe:OFFSet?[(@<ch_list>)]
CALCulate:SCALe:OFFSet:NULL[(@<ch_list>)]
CALCulate:SCALe:STATe<state>[,(@<ch_list>)]
CALCulate:SCALe:STATe?[(@<ch_list>)]
CALCulate:SCALe:UNIT<quoted_string>[,(@<ch_list>)]
CALCulate:SCALe:UNIT?[(@<ch_list>)]
CALibrationSubsystem
CALibration?
CALibration:COUNt?
CALibration:SECure:CODE<new_code>
CALibration:SECure:STATe<state>,<code>
CALibration:SECure:STATe?
CALibration:STRing<quoted_string>
CALibration:STRing?
CALibration:VALue<value>
CALibration:VALue?
CONFigureSubsystem
CONFigure?[(@<ch_list>)]
CONFigure:CURRent:AC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:CURRent:DC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:DIGital:BYTE(@<scan_list>)
CONFigure:FREQuency[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:FRESistance[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:PERiod[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:RESistance[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:TEMPerature{<probe_type>|DEF},{<type>|DEF}[,1[,{<resolution>|MIN|MAX|DEF}]],(@<scan_list>)
CONFigure:TOTalize<mode>,(@<scan_list>)
CONFigure:VOLTage:AC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
CONFigure:VOLTage:DC[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
DATASubsystem
DATA:LAST?[<num_rdgs>,](@<channel>)
DATA:POINts?
DATA:POINts:EVENt:THReshold<num_rdgs>
DATA:POINts:EVENt:THReshold?
DATA:REMove?<num_rdgs>
DIAGnosticSubsystem
DIAGnostic:DMM:CYCLes?
DIAGnostic:DMM:CYCLes:CLEar{1|2|3}
DIAGnostic:PEEK:SLOT:DATA?{100|200|300}
DIAGnostic:POKE:SLOT:DATA?{100|200|300},<quoted_string>
DIAGnostic:RELay:CYCLes?(@<ch_list>)
DIAGnostic:RELay:CYCLes:CLEar(@<ch_list>)
DISPlaySubsystem
DISPlay<state>
DISPlay?
DISPlay:TEXT<quoted_string>
DISPlay:TEXT?
DISPlay:TEXT:CLEar
FORMatSubsystem
FORMat:READing:ALARm<state>
FORMat:READing:ALARm?
FORMat:READing:CHANnel<mode>
FORMat:READing:CHANnel?
FORMat:READing:TIME<mode>
FORMat:READing:TIME?
FORMat:READing:TIME:TYPE<format>
FORMat:READing:TIME:TYPE?
FORMat:READing:UNIT<format>
FORMat:READing:UNIT?
IEEE-488Subsystem
*CLS
*ESE<enable_val>
*ESE?
*ESR?
*IDN?
*OPC
*OPC?
*PSC<state>
*PSC?
*RCL{0|1|2|3|4|5}
*RST
*SAV{0|1|2|3|4|5}
*SRE<enable_val>
*SRE?
*STB?
*TRG
*TST?
*WAI
INSTrumentSubsystem
INSTrument:DMM<state>
INSTrument:DMM?
INSTrument:DMM:INSTalled?
LXISubsystem
LXI:IDENtify[:STATe]<state>
LXI:IDENtify[:STATe]?
LXI:RESet
LXI:RESTart
MEASureSubsystem
MEASure:CURRent:AC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:CURRent:DC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:DIGital:BYTE?(@<scan_list>)
MEASure:FREQuency?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:FRESistance?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:PERiod?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:RESistance?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:TEMPerature?{<probe_type>|DEF},{<type>|DEF}[,1[,{<resolution>|MIN|MAX|DEF}]],(@<scan_list>)
MEASure:TOTalize?<mode>,(@<scan_list>)
MEASure:VOLTage:AC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEASure:VOLTage:DC?[{<range>|AUTO|MIN|MAX|DEF}[,{<resolution>|MIN|MAX|DEF}],](@<scan_list>)
MEMorySubsystem
MEMory:NSTates?
MEMory:STATe:DELete<location>
MEMory:STATe:NAME<location>[,<name>]
MEMory:STATe:NAME?<location>
MEMory:STATe:RECall:AUTO<mode>
MEMory:STATe:RECall:AUTO?
MEMory:STATe:VALid?<location>
MMEMorySubsystem
MMEMory:EXPort?
MMEMory:FORMat:READing:CSEParator<column_separator>
MMEMory:FORMat:READing:CSEParator?
MMEMory:FORMat:READing:RLIMit<row_limit>
MMEMory:FORMat:READing:RLIMit?
MMEMory:IMPort:CATalog?
MMEMory:IMPort:CONFig?"<configuration_file>"
MMEMory:LOG[:ENABle]<state>
MMEMory:LOG[:ENABle]?
OtherCommands
ABORt
FETCh?
INITiate
INPut:IMPedance:AUTO<state>[,(@<ch_list>)]
INPut:IMPedance:AUTO?[(@<ch_list>)]
R?[<max_count>
READ?[(@<scan_list>]
UNIT:TEMPerature<units>[,(@<ch_list>)]
UNIT:TEMPerature?[(@<ch_list>)]
OUTPutSubsystem
OUTPut:ALARm:CLEar:ALL
OUTPut:ALARm:MODE<mode>
OUTPut:ALARm:MODE?
OUTPut:ALARm:SLOPe<edge>
OUTPut:ALARm:SLOPe?
OUTPut:ALARm{1|2|3|4}:CLEar
OUTPut:ALARm{1|2|3|4}:SOURce(@<ch_list>)
OUTPut:ALARm{1|2|3|4}:SOURce?
ROUTeSubsystem
ROUTe:CHANnel:ADVance:SOURce<source>
ROUTe:CHANnel:ADVance:SOURce?
ROUTe:CHANnel:DELay<seconds>,(@<ch_list>)
ROUTe:CHANnel:DELay?(@<ch_list>)
ROUTe:CHANnel:DELay:AUTO<state>[,(@<ch_list>)]
ROUTe:CHANnel:DELay:AUTO?[(@<ch_list>)]
ROUTe:CHANnel:FWIRe<state>[,(@<ch_list>)]
ROUTe:CHANnel:FWIRe?[(@<ch_list>)]
ROUTe:CLOSe(@<ch_list>)
ROUTe:CLOSe?(@<ch_list>)
ROUTe:CLOSe:EXCLusive(@<ch_list>)
ROUTe:DONE?
ROUTe:MONitor(@<channel>)
ROUTe:MONitor?
ROUTe:MONitor:DATA?
ROUTe:MONitor:STATe<mode>
ROUTe:MONitor:STATe?
ROUTe:OPEN(@<ch_list>)
ROUTe:OPEN?(@<ch_list>)
ROUTe:SCAN(@<scan_list>)
ROUTe:SCAN?
ROUTe:SCAN:SIZE?
SENSeSubsystem
[SENSe:]CURRent:AC:BANDwidth{<filter>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:AC:BANDwidth?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:AC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:AC:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:AC:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]CURRent:AC:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]CURRent:AC:RESolution{<resolution>|MIN|MAX|DEF}[,(@<ch_list>)]
[SENSe:]CURRent:AC:RESolution?{<ch_list>|MIN|MAX}
[SENSe:]CURRent:DC:APERture{<time>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:DC:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:DC:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:DC:NPLC?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:DC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:DC:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]CURRent:DC:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]CURRent:DC:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]CURRent:DC:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]CURRent:DC:RESolution?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]DIGital:DATA:{BYTE|WORD}?[(@<ch_list>)]
[SENSe:]FREQuency:APERture{<seconds>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FREQuency:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FREQuency:RANGe:LOWer{<filter>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FREQuency:RANGe:LOWer?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FREQuency:VOLTage:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FREQuency:VOLTage:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FREQuency:VOLTage:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]FREQuency:VOLTage:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]FRESistance:APERture{<time>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FRESistance:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FRESistance:NPLC?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:OCOMpensated<state>[,(@<ch_list>)]
[SENSe:]FRESistance:OCOMpensated?[(@<ch_list>)]
[SENSe:]FRESistance:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FRESistance:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FRESistance:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]FRESistance:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]FRESistance:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]FRESistance:RESolution?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]FUNCtion"<function>"[,(@<ch_list>)]
[SENSe:]FUNCtion?[(@<ch_list>)]
[SENSe:]PERiod:APERture{<seconds>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]PERiod:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]PERiod:VOLTage:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]PERiod:VOLTage:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]PERiod:VOLTage:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]PERiod:VOLTage:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]RESistance:APERture{<time>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]RESistance:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]RESistance:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]RESistance:NPLC?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]RESistance:OCOMpensated<state>[,(@<ch_list>)]
[SENSe:]RESistance:OCOMpensated?[(@<ch_list>)]
[SENSe:]RESistance:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]RESistance:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]RESistance:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]RESistance:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]RESistance:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]RESistance:RESolution?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]TEMPerature:APERture{<time>|MIN|MAX|DEF}[,(@<ch_list>)]
[SENSe:]TEMPerature:APERture?{(@<ch_list>)|MIN|MAX}
[SENSe:]TEMPerature:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]TEMPerature:NPLC?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]TEMPerature:RJUNction?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated<state>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated<state>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk<state>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction{<temperature>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE<type>[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE?[(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TYPE{TCouple|RTD|FRTD|THERmistor|DEF}[,(@<ch_list>)]
[SENSe:]TEMPerature:TRANsducer:TYPE?[(@<ch_list>)]
[SENSe:]TOTalize:CLEar:IMMediate[(@<ch_list>)]
[SENSe:]TOTalize:DATA?[(@<ch_list>)]
[SENSe:]TOTalize:SLOPe<edge>[,(@<ch_list>)]
[SENSe:]TOTalize:SLOPe?[(@<ch_list>)]
[SENSe:]TOTalize:STARt[:IMMediate][(@<ch_list>)]
[SENSe:]TOTalize:STOP[:IMMediate][(@<ch_list>)]
[SENSe:]TOTalize:TYPE<mode>[,(@<ch_list>)]
[SENSe:]TOTalize:TYPE?[(@<ch_list>)]
[SENSe:]VOLTage:AC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:AC:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]VOLTage:AC:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]VOLTage:AC:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]VOLTage:AC:BANDwidth{<filter>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:AC:BANDwidth?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]VOLTage:DC:APERture{<time>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:APERture?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]VOLTage:DC:NPLC{<PLCs>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:NPLC?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]VOLTage:DC:RANGe{<range>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:RANGe?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]VOLTage:DC:RANGe:AUTO<state>[,(@<ch_list>)]
[SENSe:]VOLTage:DC:RANGe:AUTO?[(@<ch_list>)]
[SENSe:]VOLTage:DC:RESolution{<resolution>|MIN|MAX}[,(@<ch_list>)]
[SENSe:]VOLTage:DC:RESolution?[{(@<ch_list>)|MIN|MAX}]
[SENSe:]ZERO:AUTO{OFF|ONCE|ON}[,(@<ch_list>)]
[SENSe:]ZERO:AUTO?[(@<ch_list>)]
SOURceSubsystem
SOURce:DIGital:DATA[:{BYTE|WORD}]<data>,(@<ch_list>)
SOURce:DIGital:DATA[:{BYTE|WORD}]?(@<ch_list>)
SOURce:DIGital:STATe?(@<ch_list>)
SOURce:VOLTage<voltage>,(@<ch_list>)
SOURce:VOLTage?(@<ch_list>)
STATusSubsystem
STATus:ALARm:CONDition?
STATus:ALARm:ENABle<enable_val>
STATus:ALARm:ENABle?
STATus:ALARm[:EVENt]?
STATus:OPERation:CONDition?
STATus:OPERation:ENABle<enable_val>
STATus:OPERation:ENABle?
STATus:OPERation[:EVENt]?
STATus:PRESet
STATus:QUEStionable:CONDition?
STATus:QUEStionable:ENABle<enable_val>
STATus:QUEStionable:ENABle?
STATus:QUEStionable[:EVENt]?
SYSTEMSubsystem-LANConfiguration
SYSTem:COMMunicate:LAN:CONTrol?
SYSTem:COMMunicate:LAN:DHCP<mode>
SYSTem:COMMunicate:LAN:DHCP?
SYSTem:COMMunicate:LAN:DNS"<address>"
SYSTem:COMMunicate:LAN:DNS?[{CURRent|STATic}]
SYSTem:COMMunicate:LAN:DOMain?[{CURRent|STATic}]
SYSTem:COMMunicate:LAN:GATEway"<address>"
SYSTem:COMMunicate:LAN:GATEway?[{CURRent|STATic}]
SYSTem:COMMunicate:LAN:HOSTname"<name>"
SYSTem:COMMunicate:LAN:HOSTname?[{CURRent|STATic}]
SYSTem:COMMunicate:LAN:IPADdress"<address>"
SYSTem:COMMunicate:LAN:IPADdress?[{CURRent|STATic}]
SYSTem:COMMunicate:LAN:MAC?
SYSTem:COMMunicate:LAN:SMASk"<mask>"
SYSTem:COMMunicate:LAN:SMASk?[{CURRent|STATic}]
SYSTem:COMMunicate:LAN:TELNet:PROMpt"<string>"
SYSTem:COMMunicate:LAN:TELNet:PROMpt?
SYSTem:COMMunicate:LAN:TELNet:WMESsage"<string>"
SYSTem:COMMunicate:LAN:TELNet:WMESsage?
SYSTem:COMMunicate:LAN:UPDate
SYSTemSubsystem-OtherCommands
SYSTem:ALARm?
SYSTem:CPON<slot>
SYSTem:CTYPe?<slot>
SYSTem:DATE<yyyy>,<mm>,<dd>
SYSTem:DATE?
SYSTem:ERRor?
SYSTem:INTerface{GPIB|RS232}
SYSTem:INTerface?
SYSTem:LANGuage<language>
SYSTem:LANGuage?
SYST:LFRequency?
SYSTem:LOCal
SYSTem:LOCK:NAME?
SYSTem:LOCK:OWNer?
SYSTem:LOCK:RELease
SYSTem:LOCK:REQuest?
SYSTem:PRESet
SYSTem:REMote
SYSTem:RWLock
SYSTem:SECurity[:IMMediate]
SYSTem:TIME<hh>,<mm>,<ss.sss>
SYSTem:TIME?
SYSTem:TIME:SCAN?
SYSTem:VERSion?
TRIGgerSubsystem
TRIGger:COUNt{<count>|MIN|MAX|INFinity}
TRIGger:COUNt?
TRIGger:SOURce<source>
TRIGger:SOURce?
TRIGger:TIMer{<seconds>|MIN|MAX}
TRIGger:TIMer?[{MIN|MAX}]
©KeysightTechnologies,Inc.2009-2013
ErrorMessages-350-99IEEEandParserErrors|100-299GeneralErrors|300-399ModuleandChannelErrors|400-449MassStorageErrors|450-499USBLoggingErrors|500-599SeriousInstrumentErrors|600-649Self-testErrors|700-799CalibrationErrors|811OperationNotImplemented|900-999ModuleErrors
Theinstrumentbeepsonceeachtimeacommandsyntaxorhardwareerrorisgenerated.Thefront-panelERRORannunciatorturnsonwhenoneormoreerrorsarecurrentlystoredintheerrorqueue.
Errorsareretrievedinfirst-in-first-out(FIFO)order.Thefirsterrorreturnedisthefirsterrorthatwasstored.Onceyouhavereadalloftheinterface-specificerrors,theerrorsintheglobalerrorqueueareretrieved.
Errorsareclearedasyoureadthem.Whenyouhavereadallerrorsfromtheinterface-specificandglobalerrorqueues,theERRORannunciatorturnsoffandtheerrorsarecleared.
Ifmorethan20errorshaveoccurred,thelasterrorstoredinthequeue(themostrecenterror)isreplacedwith-350,"Errorqueueoverflow".Noadditionalerrorsarestoreduntilyouremoveerrorsfromthequeue.Ifnoerrorshaveoccurredwhenyoureadtheerrorqueue,theinstrumentrespondswith+0,"Noerror".
ThefrontpanelreportserrorsfromallI/Osessionsaswellastheglobalerrorqueue.Toreadtheerrorqueuefromthefrontpanel,usetheViewkey.
ErrorconditionsarealsosummarizedintheStatusByteRegister.FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.
Theinterface-specificandglobalerrorqueuesareclearedbythe
*CLS(ClearStatus)commandandwhenpoweriscycled.Theerrorsarealsoclearedwhenyoureadtheerrorqueue.TheerrorqueueisnotclearedbyaFactoryReset(*RSTcommand)oranInstrumentPreset(SYSTem:PRESetcommand).
Thequeryreadsandclearsoneerrorstringfromtheerrorqueue.Theerrorstringmaycontainupto160charactersandconsistsofanerrornumberandanerrorstringenclosedindoublequotes.Forexample:
-113,"Undefinedheader"
-350-99IEEEandParserErrors-350 "Errorqueueoverflow"-330 "Selftestfailed"-256 "Fileorfoldernamenotfound"-231 "Internalsoftwareerror"-230 "Datastale"-224 "Dataquestionable"-224 "Illegalparametervaluerangesmustbepositive"-222 "Dataoutofrange"-221 "Settingsconflict"-214 "Triggerdeadlock"-213 "INITignored"-211 "Triggerignored"-123 "Numericoverflow"-114 "Subopcodeoutofrange"-110 "Internalcommunicationstimeout"-56 "Systemerror"
100-299GeneralErrors100 "NetworkError"111 "Channellist:slotnumberoutofrange"112 "Channellist:channelnumberoutofrange"113 "Channellist:emptyscanlist"201 "Memorylost:storedstate"202 "Memorylost:power-onstate"203 "Memorylost:storedreadings"204 "Memorylost:timeanddate"221 "Settingsconflict:calculatelimitstateforcedoff"222 "Settingsconflict:moduletypedoesnotmatchstate"223 "Settingsconflict:trigsourcechangedtoIMM"224 "Settingsconflict:chanadvsourcechangedtoIMM"225 "Settingsconflict:DMMdisabledormissing"226 "Settingsconflict:DMMenabled"251 "Unsupportedtemperaturetransducertype"261 "Notabletoexecutewhilescaninitiated"262 "Notabletoabortscan"271 "Notabletoacceptunitnameslongerthan3characters"272 "Notabletoacceptcharacterinunitname"281 "Notabletoperformonmorethanonechannel"291 "Notabletorecallstate:itisempty"292 "Notabletorecallstate:DMMenablechanged"
300-399ModuleandChannelErrors301 "Modulecurrentlycommittedtoscan"302 "Nomodulewasdetectedinthisslot"303 "Moduleisnotabletoperformrequestedoperation"304 "Doesnotexist"305 "Notabletoperformrequestedoperation"306 "Partofa4-wirepair"307 "Incorrectlyconfiguredrefchannel"308 "Channelnotabletoperformrequestedoperation"309 "Incorrectlyformattedchannellist"
400-449MassStorageErrors401 "Massstorageerror:failedtocreatefile"402 "Massstorageerror:failedtoopenfile"403 "Massstorageerror:failedtoclosefile"404 "Massstorageerror:filewriteerror"405 "Massstorageerror:filereaderror"406 "Massstorageerror:filewriteerror"407 "Massstorageerror:failedtoremovefile"408 "Massstorageerror:failedtocreatedirectory"409 "Massstorageerror:failedtoremovedirectory"410 "Notenoughdiskspace"411 "Noexternaldiskdetected"412 "Externaldiskhasbeendetached"413 "Filealreadyexists"414 "Directoryalreadyexists"415 "Filenotfound"416 "Pathnotfound"417 "Filenotopenedforwriting"418 "Filenotopenedforreading"
450-499USBLoggingErrors450 "Overrunduringdatacollection:readingslostinUSBtransfer"451 "OverrunduringUSBoutput:readingslostinUSBtransfer"452 "Readingmemoryexportabortedduetomeasurementreconfig"453 "NotabletoexecutewhileloggingdatatoUSB"454 "NotabletoexecutewhilecopyingdatatoUSB"455 "NotabletoexecutewhileimportingaconfigurationfromUSB"456 (none)457 "Loggingrequestignored:USBdeviceisbusy"458 "ExternalUSBdriveisinaccessible"459 "LoggingtoUSBwasstopped"460 "LoggingtoUSBwasstoppedafter2^32sweepsofdata"461 "Memorylost:non-volatilesettings;USBdrive"462 "Configurationimportaborted"463 "Configurationimportfailed"464 "Invalidimportfile"465 "Importfilecardsetdoesnotmatchinstrument"466 "Operationnotallowedinaconfigurationimportfile"467 "Noreadingstoexport"468 "Unabletofetchmeasurementconfigfrominternalprocessor"469 "Internalprocessorreturnedaninvalidmeasurementconfig"470 "Measurementwasreconfigured;Cannotsaveconfigurationdata"471 "USBoperationaborted;Cannotsaveconfigurationdata"472 "Oneormoreblcfgfilenamesinvalid;filesinaccessible"473 "Diskcontainstoomanyblcfgfiles;oldestfilesinaccessible"
500-599SeriousInstrumentErrors514 "RS-232only:unabletoexecuteusingHP-IB"(34970A
only)514 "Notallowed;InstrumentlockedbyanotherI/O
session"(34972Aonly)521 "Communications:inputbufferoverflow"522 "Communications:outputbufferoverflow"532 "Notabletoachieverequestedresolution"540 "Notabletonullchannelinoverload"550 "Notabletoexecutecommandinlocalmode"
600-649Self-testErrors601 "Self-test:frontpanelnotresponding"602 "Self-test:RAMread/write"603 "Self-test:A/Dsyncstuck"604 "Self-test:A/Dslopeconvergence"605 "Self-test/Cal:notabletocalibraterundowngain"606 "Self-test/Cal:rundowngainoutofrange"607 "Self-test:rundowntoonoisy"608 "Self-test:serialconfigurationreadbackfailed"609 "Self-test:DCgainx1failed"610 "Self-test:DCgainx10failed"611 "Self-test:DCgainx100failed"612 "Self-test:Ohms500nAsourcefailed"613 "Self-test:Ohms5uAsourcefailed"614 "Self-test:DC300Vzerofailed"615 "Self-test:Ohms10uAsourcefailed"616 "Self-test:DCcurrentsensefailed"617 "Self-test:Ohms100uAsourcefailed"618 "Self-test:DChighvoltageattenuatorfailed"619 "Self-test:Ohms1mAsourcefailed"620 "Self-test:ACrmszerofailed"621 "Self-test:ACrmsfullscalefailed"622 "Self-test:frequencycounterfailed"623 "Self-test:cannotcalibrateprecharge"624 "Self-test:unabletosenselinefrequency"625 "Self-test:I/Oprocessordoesnotrespond"626 "Self-test:I/Oprocessorfailedself-test"
700-799CalibrationErrors701 "Calsecuritydisabledbyjumper"702 "Cal:secured"703 "Cal:invalidsecurecode"704 "Cal:securecodetoolong"705 "Cal:aborted"706 "Cal:valueoutofrange"707 "Cal:signalmeasurementoutofrange"708 "Cal:signalfrequencyoutofrange"709 "Cal:nocalforthisfunctionorrange"710 "Cal:fullscalecorrectionoutofrange"720 "Cal:DCVoffsetoutofrange"721 "Cal:DCIoffsetoutofrange"722 "Cal:RESoffsetoutofrange"723 "Cal:FRESoffsetoutofrange"724 "Cal:extendedresistanceselfcalfailed"725 "Cal:300VDCcorrectionoutofrange"730 "Cal:prechargeDACconvergencefailed"731 "Cal:A/Dturnovercorrectionoutofrange"732 "Cal:ACflatnessDACconvergencefailed"733 "Cal:AClowfrequencyconvergencefailed"734 "Cal:AClowfrequencycorrectionoutofrange"735 "Cal:ACrmsconverternoisecorrectionoutofrange"736 "Cal:ACrms100thscalecorrectionoutofrange"740 "Caldatalost:securestate"741 "Caldatalost:stringdata"742 "Caldatalost:DCVcorrections"743 "Caldatalost:DCIcorrections"744 "Caldatalost:REScorrections"745 "Caldatalost:FREScorrections"746 "Caldatalost:ACcorrections"747 "Configdatalost:HP-IBaddress"(34970Aonly)747 "Calibrationfailed"(34972Aonly)748 "Configdatalost:RS-232"(34970Aonly)748 "Calchecksumfailedinternaldata"(34972Aonly)749 "DMMrelaycountdatalost"
811OperationNotImplemented811 "Operationnotimplemented"
900-999ModuleErrors901 "Modulehardware:unexpecteddatareceived"902 "Modulehardware:missingstopbit"903 "Modulehardware:dataoverrun"904 "Modulehardware:protocolviolation"905 "Modulehardware:earlyendofdata"906 "Modulehardware:missingendofdata"907 "Modulehardware:moduleSRQsignalstucklow"908 "Modulehardware:notresponding"910 "Modulereportedanunknownmoduletype"911 "Modulereportedcommandbufferoverflow"912 "Modulereportedcommandsyntaxerror"913 "Modulereportednonvolatilememoryfault"914 "Modulereportedtemperaturesensorfault"915 "Modulereportedfirmwaredefect"916 "Modulereportedincorrectfirmwareinstalled"
FactoryResetStateThefollowingtablesshowthestateoftheinstrumentafteraFACTORYRESETfromtheSto/Rclmenu,or*RSTfromtheremoteinterface.
MeasurementConfiguration
FactoryResetState
Function DCVolts
Range Autorange
Resolution 5½Digits
IntegrationTime 1PLC
InputResistance 10MΩ(fixedforallDCVranges)
ChannelDelay AutomaticDelay
TotalizerResetMode
CountNotResetWhenRead
TotalizerEdgeDetect
RisingEdge
ScanningOperations
FactoryResetState
ScanList Empty
ReadingMemory AllReadingsareCleared
Min,Max,andAverage
NotChanged
ScanTriggerSource Immediate
ScanInterval(usedwithTRIGger:SOURceTIMer)
10Seconds
ScanCount 1
ScanReadingFormat
ReadingOnly(NoUnits,Channel,Time)
MonitorinProgress Stopped
Mx+BScaling FactoryResetState
GainFactor("M")
1
OffsetFactor("B")
0
ScaleLabel VDC
AlarmLimits FactoryResetState
AlarmQueue NotCleared
AlarmState Off
HIandLOAlarmLimits
0
AlarmOutput Alarm1
AlarmOutputConfiguration
LatchedMode
AlarmOutputState OutputLinesareCleared
AlarmOutputSlope Fail=Low
ModuleHardware
FactoryResetState
34901A,34902A,34908A
AllChannelsOpen
34903A,34904A AllChannelsOpen
34905A,34906A Channelss11ands21Selected
34907A BothDIOPorts=Input,TotalizerCount=0,BothDACs=0VDC
System-RelatedOperations
FactoryResetState
DisplayState On
ErrorQueue ErrorsNotCleared
StoredStates NoChange
InstrumentPresetStateThefollowingtablesshowthestateoftheinstrumentafteraPRESETfromtheSto/RclmenuoraSYSTem:PRESetcommandfromtheremoteinterface.
MeasurementConfiguration
InstrumentPresetState
Function NoChange
Range NoChange
Resolution NoChange
AdvancedSettings NoChange
TotalizerResetMode
CountNotResetWhenRead
TotalizerEdgeDetect
RisingEdge
ScanningOperations
InstrumentPresetState
ScanList NoChange
ReadingMemory AllReadingsareCleared
Min,Max,andAverage
NoChange
ScanIntervalSource
NoChange
ScanInterval NoChange
ScanCount NoChange
ScanReadingFormat
NoChange
MonitorinProgress
Stopped
Mx+BScaling InstrumentPresetState
GainFactor NoChange
("M")
OffsetFactor("B")
NoChange
ScaleLabel NoChange
AlarmLimits InstrumentPresetState
AlarmQueue NoChange
AlarmState NoChange
HIandLOAlarmLimits
NoChange
AlarmOutputConfiguration
NoChange
AlarmOutputState OutputLinesareCleared
AlarmOutputSlope
NoChange
ModuleHardware
InstrumentPresetState
34901A,34902A,34908A
AllChannelsOpen
34903A,34904A AllChannelsOpen
34905A,34906A Channelss11ands21Selected
34907A BothDIOPorts=Input,TotalizerCount=0,BothDACs=0VDC
System-RelatedOperations
InstrumentPresetState
DisplayState NoChange
ErrorQueue ErrorsNotCleared
StoredStates NoChange
34970A/34972AModuleDetailsThelinksbelowtakeyoutosummaryinformationfortheKeysight34970A/34972Aplug-inmodules.
34901A20-ChannelArmatureMultiplexer
34902A16-ChannelReedMultiplexer
34903A20-ChannelActuator/General-PurposeSwitch
34904A4x8Two-WireMatrixSwitch
34905A/34906ADual4-ChannelRFMultiplexers
34907AMultifunctionModule
34908A40-ChannelSingle-EndedMultiplexer
Keysight34901AModuleSummary
20-ChannelArmatureMultiplexer(2/4-wire)Module
SimplifiedSchematic
SCPICommandsUsed
CALCulate:AVERage:AVERage?
CALCulate:AVERage:CLEar
CALCulate:AVERage:COUNt?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:MAXimum:TIME?
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:PTPeak?
CALCulate:LIMit:LOWer
CALCulate:LIMit:LOWer:STATe
CALCulate:LIMit:UPPer
CALCulate:LIMit:UPPer:STATe
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALCulate:SCALe:UNIT
CONFigure?
CONFigure:CURRent:AC
CONFigure:CURRent:DC
CONFigure:FREQuency
CONFigure:FRESistance
CONFigure:PERiod
CONFigure:RESistance
CONFigure:TEMPerature
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
DIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
MEASure:CURRent:AC?
MEASure:CURRent:DC?
MEASure:FREQuency?
MEASure:FRESistance?
MEASure:PERiod?
MEASure:RESistance?
MEASure:TEMPerature?
MEASure:VOLTage:AC?
MEASure:VOLTage:DC?
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay:AUTO
ROUTe:CHANnel:FWIRe
ROUTe:CLOSe
ROUTe:CLOSe:EXCLusive
ROUTe:MONitor
ROUTe:MONitor:DATA?
ROUTe:OPEN
ROUTe:SCAN
[SENSe:]CURRent:AC:BANDwidth
[SENSe:]CURRent:AC:RANGe
[SENSe:]CURRent:AC:RANGe:AUTO
[SENSe:]CURRent:DC:APERture
[SENSe:]CURRent:DC:NPLC
[SENSe:]CURRent:DC:RANGe
[SENSe:]CURRent:DC:RANGe:AUTO
[SENSe:]CURRent:DC:RESolution
[SENSe:]FREQuency:APERture
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
[SENSe:]FRESistance:APERture
[SENSe:]FRESistance:NPLC
[SENSe:]FRESistance:OCOMpensated
[SENSe:]FRESistance:RANGe
[SENSe:]FRESistance:RANGe:AUTO
[SENSe:]FRESistance:RESolution
[SENSe:]PERiod:APERture
[SENSe:]PERiod:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe:AUTO
[SENSe:]RESistance:APERture
[SENSe:]RESistance:NPLC
[SENSe:]RESistance:OCOMpensated
[SENSe:]RESistance:RANGe
[SENSe:]RESistance:RANGe:AUTO
[SENSe:]RESistance:RESolution
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:RJUNction?
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE
[SENSe:]TEMPerature:TRANsducer:TYPE
[SENSe:]VOLTage:AC:BANDwidth
[SENSe:]VOLTage:AC:RANGe
[SENSe:]VOLTage:AC:RANGe:AUTO
[SENSe:]VOLTage:DC:APERture
[SENSe:]VOLTage:DC:NPLC
[SENSe:]VOLTage:DC:RANGe
[SENSe:]VOLTage:DC:RANGe:AUTO
[SENSe:]VOLTage:DC:RESolution
[SENSe:]ZERO:AUTO
SYSTem:CPON
SYSTem:CTYPe?
UNIT:TEMPerature
Keysight34902AModuleSummary
16-ChannelReedMultiplexer(2/4-wire)Module
SimplifiedSchematic
SCPICommandsUsedCALCulate:AVERage:AVERage?
CALCulate:AVERage:CLEar
CALCulate:AVERage:COUNt?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:MAXimum:TIME?
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:PTPeak?
CALCulate:LIMit:LOWer
CALCulate:LIMit:LOWer:STATe
CALCulate:LIMit:UPPer
CALCulate:LIMit:UPPer:STATe
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALCulate:SCALe:UNIT
CONFigure?
CONFigure:FREQuency
CONFigure:FRESistance
CONFigure:PERiod
CONFigure:RESistance
CONFigure:TEMPerature
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
DIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
MEASure:FREQuency?
MEASure:FRESistance?
MEASure:PERiod?
MEASure:RESistance?
MEASure:TEMPerature?
MEASure:VOLTage:AC?
MEASure:VOLTage:DC?
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay:AUTO
ROUTe:CHANnel:FWIRe
ROUTe:CLOSe
ROUTe:CLOSe:EXCLusive
ROUTe:MONitor
ROUTe:MONitor:DATA?
ROUTe:OPEN
ROUTe:SCAN
[SENSe:]FREQuency:APERture
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
[SENSe:]FRESistance:APERture
[SENSe:]FRESistance:NPLC
[SENSe:]FRESistance:OCOMpensated
[SENSe:]FRESistance:RANGe
[SENSe:]FRESistance:RANGe:AUTO
[SENSe:]FRESistance:RESolution
[SENSe:]PERiod:APERture
[SENSe:]PERiod:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe:AUTO
[SENSe:]RESistance:APERture
[SENSe:]RESistance:NPLC
[SENSe:]RESistance:OCOMpensated
[SENSe:]RESistance:RANGe
[SENSe:]RESistance:RANGe:AUTO
[SENSe:]RESistance:RESolution
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:RJUNction?
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE
[SENSe:]TEMPerature:TRANsducer:TYPE
[SENSe:]VOLTage:AC:BANDwidth
[SENSe:]VOLTage:AC:RANGe
[SENSe:]VOLTage:AC:RANGe:AUTO
[SENSe:]VOLTage:DC:APERture
[SENSe:]VOLTage:DC:NPLC
[SENSe:]VOLTage:DC:RANGe
[SENSe:]VOLTage:DC:RANGe:AUTO
[SENSe:]VOLTage:DC:RESolution
[SENSe:]ZERO:AUTO
SYSTem:CPON
SYSTem:CTYPe?
UNIT:TEMPerature
Keysight34903AModuleSummary
20-ChannelActuator/GPSwitchModule
SimplifiedSchematic
SCPICommandsUsedDIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
ROUTe:CLOSe
ROUTe:CLOSe:EXCLusive
ROUTe:OPEN
SYSTem:CPON
SYSTem:CTYPe?
Keysight34904AModuleSummary
4x8Two-WireMatrixModule
SimplifiedSchematic
SCPICommandsUsedDIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
ROUTe:CLOSe
ROUTe:CLOSe:EXCLusive
ROUTe:OPEN
SYSTem:CPON
SYSTem:CTYPe?
Keysight34905A/34906AModuleSummary
2GHzDual1:4RFMux,50OhmModule(34905A)
2GHzDual1:4RFMux,75OhmModule(34906A)
SimplifiedSchematic
SCPICommandsUsedDIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
ROUTe:CLOSe
ROUTe:CLOSe:EXCLusive
SYSTem:CPON
SYSTem:CTYPe?
Keysight34907AModuleSummary
MultifunctionModule
SimplifiedSchematic-DigitalInput/Output
SimplifiedSchematic-TotalizeInput
SimplifiedSchematic-AnalogOutput(DAC)
SCPICommandsUsedCALCulate:AVERage:AVERage?
CALCulate:AVERage:CLEar
CALCulate:AVERage:COUNt?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:MAXimum:TIME?
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:PTPeak?
CALCulate:COMPare:DATA
CALCulate:COMPare:MASK
CALCulate:COMPare:STATe
CALCulate:COMPare:TYPE
CALCulate:LIMit:LOWer
CALCulate:LIMit:UPPer
CALibration?
CALibration:VALue
CONFigure?
CONFigure:DIGital:BYTE
CONFigure:TOTalize
MEASure:DIGital:BYTE?
MEASure:TOTalize?
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay:AUTO
ROUTe:MONitor
ROUTe:MONitor:DATA?
ROUTe:SCAN
[SENSe:]DIGital:DATA:{BYTE|WORD}?
[SENSe:]TOTalize:CLEar:IMMediate
[SENSe:]TOTalize:DATA?
[SENSe:]TOTalize:SLOPe
[SENSe:]TOTalize:TYPE
SOURce:DIGital:DATA[:{BYTE|WORD}]
SOURce:DIGital:STATe?
SOURce:VOLTage
SYSTem:CPON
SYSTem:CTYPe?
Keysight34908AModuleSummary
40ChannelSingle-EndedMultiplexerModule
SimplifiedSchematic
SCPICommandsUsed
CALCulate:AVERage:AVERage?
CALCulate:AVERage:CLEar
CALCulate:AVERage:COUNt?
CALCulate:AVERage:MAXimum?
CALCulate:AVERage:MAXimum:TIME?
CALCulate:AVERage:MINimum?
CALCulate:AVERage:MINimum:TIME?
CALCulate:AVERage:PTPeak?
CALCulate:LIMit:LOWer
CALCulate:LIMit:LOWer:STATe
CALCulate:LIMit:UPPer
CALCulate:LIMit:UPPer:STATe
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
CALCulate:SCALe:OFFSet:NULL
CALCulate:SCALe:STATe
CALCulate:SCALe:UNIT
CALibration?
CONFigure?
CONFigure:FREQuency
CONFigure:PERiod
CONFigure:RESistance
CONFigure:TEMPerature
CONFigure:VOLTage:AC
CONFigure:VOLTage:DC
DIAGnostic:RELay:CYCLes?
DIAGnostic:RELay:CYCLes:CLEar
MEASure:FREQuency?
MEASure:PERiod?
MEASure:RESistance?
MEASure:TEMPerature?
MEASure:VOLTage:AC?
MEASure:VOLTage:DC?
ROUTe:CHANnel:DELay
ROUTe:CHANnel:DELay:AUTO
ROUTe:CHANnel:FWIRe
ROUTe:CLOSe
ROUTe:CLOSe:EXCLusive
ROUTe:MONitor
ROUTe:MONitor:DATA?
ROUTe:OPEN
ROUTe:SCAN
[SENSe:]FREQuency:APERture
[SENSe:]FREQuency:RANGe:LOWer
[SENSe:]FREQuency:VOLTage:RANGe
[SENSe:]FREQuency:VOLTage:RANGe:AUTO
[SENSe:]FRESistance:APERture
[SENSe:]PERiod:APERture
[SENSe:]PERiod:VOLTage:RANGe
[SENSe:]PERiod:VOLTage:RANGe:AUTO
[SENSe:]RESistance:APERture
[SENSe:]RESistance:NPLC
[SENSe:]RESistance:OCOMpensated
[SENSe:]RESistance:RANGe
[SENSe:]RESistance:RANGe:AUTO
[SENSe:]RESistance:RESolution
[SENSe:]TEMPerature:NPLC
[SENSe:]TEMPerature:RJUNction?
[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE
[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]
[SENSe:]TEMPerature:TRANsducer:RTD:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:CHECk
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction
[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction:TYPE
[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE
[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE
[SENSe:]TEMPerature:TRANsducer:TYPE
[SENSe:]VOLTage:AC:BANDwidth
[SENSe:]VOLTage:AC:RANGe
[SENSe:]VOLTage:AC:RANGe:AUTO
[SENSe:]VOLTage:DC:APERture
[SENSe:]VOLTage:DC:NPLC
[SENSe:]VOLTage:DC:RANGe
[SENSe:]VOLTage:DC:RANGe:AUTO
[SENSe:]VOLTage:DC:RESolution
[SENSe:]ZERO:AUTO
SYSTem:CPON
SYSTem:CTYPe?
UNIT:TEMPerature
IntroductiontotheCommandLanguage
ThisdocumentdescribestheSCPIcommandlanguagefortheKeysight34970A/34972Amultifunctionswitch/measureunit.Thesecommandsarebasedonahierarchicaltreesysteminwhichassociatedcommandsaregroupedtogetherunderacommonnodeorroottoformsubsystems.AportionoftheINPutsubsystemisshownbelowtoillustratethetreesystem.
INPut: COUPling:
IMPedance:
INPutistherootkeywordofthecommand,andCOUPlingandIMPedancearesecond-levelkeywords.Acolon(:)separatesacommandkeywordfromalower-levelkeyword.
SyntaxConventions
Theformatusedtoshowcommandsisillustratedbelow:
MEASure:INSTall:DELete{<label>|ALL}
Thecommandsyntaxshowsmostcommands(andsomeparameters)asamixtureofupper-andlower-caseletters.Theupper-caselettersindicatetheabbreviatedspellingforthecommand.Forshorterprogramlines,youcansendtheabbreviatedform.Forbetterprogramreadability,youcansendthelongform.
Forexample,intheabovesyntaxstatement,MEASandMEASurearebothacceptableforms.Youcanuseupper-orlower-caseletters.Therefore,MEASure,meas,andMeasareallacceptable.Otherforms,suchasMEAandMEASUR,arenotvalidandwillgenerateanerror.
Braces({})enclosetheparameterchoicesforagivencommandstring.Thebracesarenotsentwiththecommandstring.
Averticalbar(|)separatesmultipleparameterchoicesforagivencommandstring.Forexample,{<label>|ALL}intheabovecommandindicatesthatyoucanspecifya<label>,or"ALL".Thebarisnotsentwiththecommandstring.
Anglebrackets(<>)indicatethatyoumustspecifyavaluefortheenclosedparameter.Forexample,theabovesyntaxstatementshowsthe<label>parameterenclosedinanglebrackets.Thebracketsarenotsentwiththecommandstring.Youmustspecifyavaluefortheparameter(forexample,MEASure:INSTall:DELete"MEZ_25")unlessyouselectoneoftheotheroptionsshowninthesyntax(forexample,MEASure:INSTall:DELeteALL).
Someparametersareenclosedinsquarebrackets([]).Thisindicatesthattheparameterisoptional.Thebracketsarenotsentwiththecommandstring.Ifyoudonotspecifyavalueforanoptionalparameter,theinstrumentchoosesadefaultvalue.
CommandSeparators
Acolon(:)separatesacommandkeywordfromalower-levelkeyword.Youmustinsertablankspacetoseparateaparameterfromacommandkeyword.Ifacommandrequiresmorethanoneparameter,youmustseparateadjacentparametersusingacommaasshownbelow:
MEASure:THResholds:ABSolute(@1:4),90,50,10
Asemicolon(;)isusedtoseparatecommandswithinthesamesubsystem,andcanalsominimizetyping.Forexample,sendingthefollowingcommandstring:
TRIG:SOUREXT;COUNT10
...isthesameassendingthefollowingtwocommands:
TRIG:SOUREXT
TRIG:COUNT10
Useacolonandasemicolontolinkcommandsfromdifferentsubsystems.Forexample,inthefollowingcommandstring,anerrorisgeneratedifyoudonotuseboththecolonandsemicolon:
TRIG:COUNMIN;:SAMP:COUNMIN
QueryingParameterSettings
Youcanquerythecurrentvalueofmostparametersbyaddingaquestionmark(?)tothecommand.Forexample,thefollowingcommandturnsprotectiononforchannels1through4.
CONFigure:CHANnel:PROTection(@1:4),1
Youcanthenquerytheprotectionbysending:
CONFigure:CHANnel:PROTection?(@1:4)
Thiswouldreturn+1,+1,+1,+1.
CommandTerminators
Acommandstringsenttotheinstrumentmustterminatewitha<newline>(<NL>)character.TheIEEE-488EOI(End-Or-Identify)messageisinterpretedasa<NL>characterandcanbeusedtoterminateacommandstringinplaceofa<NL>character.A<carriagereturn>followedbya<NL>isalsoaccepted.Commandstringterminationwillalwaysresetthecurrentcommandpathtotherootlevel.
Foreverymessagethatincludesaqueryandissenttotheinstrument,theinstrumentterminatesthereturnedresponsewitha<NL>orline-feedcharacter(EOI).Forexample,if*IDN?issent,theresponseisterminatedwitha<NL>aftertheblockofdatathatisreturned.Ifamessageincludesmultiplequeriesseparatedbysemicolons(forexample"*ESR?;*IDN?"),thereturnedresponseisagainterminatedbya<NL>aftertheresponsetothelastquery.Ineithercase,theprogrammustreadthis<NL>intheresponsebeforeanothercommandissenttotheinstrument,oranerrorwilloccur.
IEEE-488.2CommonCommands
TheIEEE-488.2standarddefinesasetofcommoncommandsthatperformfunctionssuchasreset,self-test,andstatusoperations.Commoncommandsalwaysbeginwithanasterisk(*),arethreecharactersinlength,andmayincludeoneormoreparameters.Thecommandkeywordisseparatedfromthefirstparameterbyablankspace.Useasemicolon(;)toseparatemultiplecommandsasshownbelow:
*RST;*CLS;*ESE32;*OPC?
ParameterTypes
Thelanguagedefinesseveraldataformatstobeusedinprogrammessagesandresponsemessages.
NumericParameters
Commandsthatrequirenumericparameterswillacceptallcommonlyuseddecimalrepresentationsofnumbersincludingoptionalsigns,decimalpoints,andscientificnotation.Youcanalsosendengineeringunitsuffixeswithnumericparameters(e.g.,M,k,m,oru).Ifacommandacceptsonlycertainspecificvalues,theinstrumentwillautomaticallyroundtheinputnumericparameterstotheacceptedvalues.Thefollowingcommandrequiresnumericparametersforthe<vHigh>,<vMid>and<vLow>parameters.
MEASure:THResholds:ABSolute(@<ch_list>)[,<vHigh>,<vMid>,<vLow>]
Becausetheparseriscase-insensitive,thereissomeconfusionovertheletter"M"(or"m").Foryourconvenience,theinstrumentinterprets"mV"(or"MV")asmillivolts,and"MHZ"(or"mhz")asmegahertz.Likewise"MΩ"(or"mΩ")isinterpretedasmegohms.Youcanusetheprefix"MA"formega.Forexample,"MAV"isinterpretedasmegavolts.
DiscreteParameters
Discreteparametersareusedtoprogramsettingsthathavealimitednumberofvalues(likeIMMediate,EXTernal,orBUS).Theyhaveashortformandalongformjustlikecommandkeywords.Youcanmixupper-andlower-caseletters.Queryresponseswillalwaysreturntheshortforminallupper-caseletters.Thefollowingcommandrequiresadiscrete
parameterforthetriggersource:
CONFigure:TRIGger:SOURce{IMMediate|SOFTware|EXTernal|CHANnel|OR}
BooleanParameters
Booleanparametersrepresentasinglebinaryconditionthatiseithertrueorfalse.Forafalsecondition,theinstrumentwillaccept"OFF"or0.Foratruecondition,theinstrumentwillaccept"ON"or"1".WhenyouqueryaBooleansetting,theinstrumentwillalwaysreturn0or1.ThefollowingcommandrequiresaBooleanparameter:
CALibration:SECure:STATe{OFF|0|ON|1}
ASCIIStringParameters
StringparameterscancontainvirtuallyanysetofASCIIcharacters.Astringmustbeginandendwithmatchingquotes;eitherwithasinglequoteoradoublequote.Youcanincludethequotedelimiteraspartofthestringbytypingittwicewithoutanycharactersinbetween.Thefollowingcommandusesastringparameter:
DISPlay:TEXT<quotedstring>
Forexample,thefollowingcommanddisplaysthemessage"WAITING..."ontheinstrument'sfrontpanel(thequotesarenotdisplayed).
DISP:TEXT"WAITING..."
Youcanalsodisplaythesamemessageusingthefollowingcommandwithsinglequotes.
DISP:TEXT'WAITING...'
UsingDeviceClear
DeviceClearisanIEEE-488low-levelbusmessagethatyoucanusetoreturntheinstrumenttoaresponsivestate.DifferentprogramminglanguagesandIEEE-488interfacecardsprovideaccesstothiscapabilitythroughtheirownuniquecommands.Thestatusregisters,theerrorqueue,andallconfigurationstatesareleftunchangedwhenaDeviceClearmessageisreceived.
DeviceClearperformsthefollowingactions:
Ifameasurementisinprogress,itisaborted.
Theinstrumentreturnstothetrigger"idle"state.
Theinstrument'sinputandoutputbuffersarecleared.
Theinstrumentispreparedtoacceptanewcommandstring.
Anoverlappedcommand,ifany,willbeterminatedwithno"OperationComplete"indication.
TheABORtcommandistherecommendedmethodtoterminateameasurement.
LANPortUsage
TheKeysight34972AusesthefollowingLANports:
Port5024isusedforSCPITelnetsessions.
Port5025isusedforSocketsessions.
DHCP
ShortforDynamicHostConfigurationProtocol,aprotocolforassigningdynamicIPaddressestodevicesonanetwork.Withdynamicaddressing,adevicecanhaveadifferentIPaddresseverytimeitconnectstothenetwork.