agilent 34970a/72a command reference · remarks if a scan is in progress when the command is...

Keysight34970A/34972ACommandReference

Notice:ThisdocumentcontainsreferencestoAgilentTechnologies.Agilent'sformerTestandMeasurementbusinesshasbecomeKeysightTechnologies.Formoreinformation,gotowww.keysight.com.

ThisHelpfilecontainsreferenceinformationtohelpyouprogramtheKeysight34970A/34972Aoveraremoteinterfaceusingtheprogramminglanguage.

IntroductiontotheCommandLanguage

CommandsbySubsystem

CommandsA-Z

CommandQuickReference

ErrorMessages

FactoryResetState

InstrumentPresetState

Plug-InModuleReferenceInformation

http://www.keysight.com/

RelatedInformationForfurtherinformation,clickonthelinkofinterest:LibrariesandInstrumentDriversKeysight34970A/34972ADocumentationKeysight34972AWebInterfaceProgrammingExamplesContactKeysightTechnologiesTrademarks

©KeysightTechnologies,Inc.2009-2014

Version2.00

http://www.keysight.com/find/iosuite

http://www.keysight.com/find/34970A


http://www.keysight.com/find/connectivity



http://www.keysight.com/find/assist

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

Syntax

ABORt

Description

Thiscommandabortsameasurementinprogressfromascan.

Remarks

Ifascanisinprogresswhenthecommandisreceived,thescanwillnotbecompletedandyoucannotresumethescanfromwhereitleftoff.Notethatifyouinitiateanewscan,allreadingsareclearedfrommemory.

The*RSTcommandwillabortameasurement,clearthescanlist,andsetallmeasurementparameterstotheirfactorysettings.TheInstrumentPreset(SYSTem:PRESetcommand)alsoabortsameasurementbutitdoesnotclearthescanlist.

Example

Thefollowingcommandabortsthemeasurementinprogress.

ABOR

SeeAlso*RST

SYSTem:PRESet

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

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?


SeeAlsoFETCh?

READ?

ROUTe:SCAN

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?

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.


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?

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


34907AMultifunctionModule(digitalinputandtotalizer)

34908A40ChannelSingle-EndedMultiplexerModule

Parameters


<scan_list> ScanList Oneormorechannels,

asshown:




Thisisarequiredparameter.

Remarks

SendingtheREAD?commandissimilartosendingtheINITiatecommandfollowedimmediatelybytheFETCh?command.


Forscanningmeasurementsusingthemultiplexermodules,anerrorisgeneratediftheinternalDMMisdisabled(seeINSTrument:DMMcommand)ornotinstalledinthemainframe.TheinternalDMMisnotrequiredforoperationsonthedigitalmodules.


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).


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


SeeAlsoFETCh?

INITiate

ROUTe:SCAN

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


<units> Discrete {C|F|K},forCelsius,FahrenheitorKelvin


ThefactorydefaultisC.


asshown:





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.



34907AMultifunctionModule


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?

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



asshown:





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

Syntax

CALCulate:AVERage:CLEar[(@<ch_list>)]

Description

Thiscommandclearsallvaluesfromthestatisticsregistersforthespecifiedchannels.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.Theminimum,maximum,average,count,andpeak-to-peakvaluesarecleared.Thevaluesforallscannedchannelsarealsoclearedatthestartofanewscan.

Parameters



asshown:





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)




CALCulate:AVERage:AVERage?



Syntax

CALCulate:AVERage:COUNt?[(@<ch_list>)]

Description

Thisqueryreturnsthenumberofreadingstakenoneachofthespecifiedchannelsduringthescan.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.

Parameters



asshown:





Remarks



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

Syntax

CALCulate:AVERage:MINimum:TIME?[(@<ch_list>)]

CALCulate:AVERage:MAXimum:TIME?[(@<ch_list>)]

Description

Thesequeriesreturnthetimethattheminimumormaximumreadingwastakenonthespecifiedchannelsduringthescan(infulltimeanddateformat).Eachchannelmustbeamultiplexer,digitalinputortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.

Parameters



asshown:





Remarks



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

Syntax

CALCulate:AVERage:PTPeak?[(@<ch_list>)]

Description

Thisqueryreturnsthepeaktopeakvalue(maximumminusminimum)foundoneachofthespecifiedchannelsduringthescan.Eachchannelshouldbeamultiplexer,digitalortotalizerchannelthathasbeenconfiguredtobepartofthescanlist.Ifitisnotpartofthescanlist,noerrorwillbegenerated,butthevaluereturnedwillbeameaninglessvalueof0.

Parameters


<ch_list> Channellist Oneormorechannels,

asshown:





Remarks



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

Syntax

CALCulate:COMPare:DATA<data>[,(@<ch_list>)]

CALCulate:COMPare:DATA?[(@<ch_list>)]

Description

Thiscommandsetsthedigitaldataforpatterncomparisonsonthespecifieddigitalinputchannels.Youcanusethepatterncomparisonfeaturetogenerateanalarmwhenaspecificdigitalpatternisdetected.

UsedWith:

34907AMultifunctionModule(digitalinputchannelsonly)

Parameters


<data> Numeric An8-bitdigitalpatternforcomparison,specifiedasanintegerfrom0to255.


<ch_list> ChannelList Oneormore

channels,asshown:


(@301:302)-channels01and02onthemoduleinslot300.

(@101,201:202,302)-channel01onthemoduleinslot100,channels01and02onthemoduleinslot200,andchannel02onthemoduleinslot300.


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





OUTPut:ALARm{1|2|3|4}:SOURce

Syntax

CALCulate:COMPare:MASK<mask>[,(@<ch_list>)]

CALCulate:COMPare:MASK?[(@<ch_list>)]

Description

ThiscommandisusedinconjunctionwiththeCALCulate:COMPare:DATAcommandtosetthedigitalmaskdataforpatterncomparisonsonthespecifieddigitalinputchannels.Youcanusethepatterncomparisonfeaturetogenerateanalarmwhenaspecificdigitalpatternisdetected.

UsedWith:


Parameters


<mask> Numeric An8-bitmaskpatternforcomparison,specifiedasanintegerfrom0to255.Activebitsarespecifiedas1's,and"don'tcare"bitsarespecifiedas0's.



channels,asshown:





Remarks



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


Syntax

CALCulate:COMPare:STATe<state>[,(@<ch_list>)]

CALCulate:COMPare:STATe?[(@<ch_list>)]

Description

Thiscommanddisablesorenablesthepatterncomparisonmodeonthespecifieddigitalinputchannels.Youcanusethepatterncomparisonfeaturetogenerateanalarmwhenaspecificdigitalpatternisdetected.

UsedWith:


Parameters




channels,asshown:





Remarks


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

Syntax

CALCulate:COMPare:TYPE<mode>[,(@<ch_list>)]

CALCulate:COMPare:TYPE?[(@<ch_list>)]

Description

Thiscommandconfiguresthespecifieddigitalinputchannelstogenerateanalarmwhenaspecificbitpatternorbitpatternchangeisdetected.ThiscommandisusedinconjunctionwiththeCALCulate:COMPare:DATAcommandwhichsetsthedatabitpatternandtheCALCulate:COMPare:MASKcommandwhichsetsthemaskbitpattern.

UsedWith:


Parameters


<mode> Discrete {EQUal|NEQual} Thisisarequiredparameter.

Thepower-onvalueisNEQual.


channels,asshown:





Remarks


SelectEQUaltogenerateanalarmorinterruptwhenthedatareadfromthespecifiedchannelisequaltoCALCulate:COMPare:DATA,afterbeingmaskedbyCALCulate:COMPare:MASK.

SelectNEQual(notequal)togenerateanalarmorinterruptwhenthedatareadfromthebankisnotequaltoCALCulate:COMPare:DATAafterbeingmaskedbyCALCulate:COMPare:MASK.

Bitsmaskedoffas0("don'tcare")byCALCulate:COMPare:MASKareignored.


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





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:



34907AMultifunctionModule(totalizerchannelonly)


Parameters


<lo_limit> Numeric Anynumericvalue 0

<hi_limit> Numeric Anynumericvalue;fortotalizerchannels,the<hi_limit>referstoamaximumcount.

0


asshown:





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

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:




Parameters


<mode> Boolean {OFF|0|ON|1} OFF


asshown:





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)




SYSTem:ALARm?

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:




Parameters


<gain> Numeric Anyvaluebetween-1E15to+1E15


Thefactorydefaultis1.

<offset> Numeric Anyvaluebetween-1E+15and+1E+15.


Thefactorydefaultis0.


asshown:



(@202:207,209,302:308)-channels02through07and09onthemodulein


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)


Syntax

CALCulate:SCALe:OFFSet:NULL[(@<ch_list>)]

Description

Thiscommandmakesanimmediatenullmeasurementonthespecifiedchannelsandstoresitastheoffset("B")forsubsequentmeasurements.Thisallowsyoutoadjustforvoltageorresistiveoffsetsthroughyourwiringtothepointofthemeasurement.

Parameters



asshown:





Example

Thefollowingcommandmakesanimmediatenullmeasurementonchannels206through210.

CALC:SCAL:OFFS:NULL(@206:210)

Syntax

CALCulate:SCALe:STATe<state>[,(@<ch_list>)]

CALCulate:SCALe:STATe?[(@<ch_list>)]

Description

ThiscommanddisablesorenablesMx+Bscalingonthespecifiedchannels.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.

UsedWith:




Parameters




asshown:





Remarks

Scalingisappliedusingthefollowingequation:

ScaledReading=(GainxMeasurement)+Offset


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


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

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:




Parameters


<quoted_string> QuotedASCIIString

AquotedASCIIstringofuptothreecharacters.Youcanuseletters(A-Z),numbers(0-9),anunderscore(_),orthe"#"characterwhichdisplaysadegreesymbol(°)onthefrontpanel(displayedasablankspaceinanoutputstringfromtheremoteinterface).Thefirstcharactermustbealetterorthe"#"character(the"#"characterisallowedonlyastheleftmostcharacterinthelabel).Theremainingtwocharacterscanbeletters,numbers,oranunderscore.



asshown:



(@202:207,209,302:308)-channels02through07and09onthemodulein


slot200andchannels02through08onthemoduleinslot300.

Remarks


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"

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?

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

Syntax

CALibration:COUNt?

Description

Thiscommandqueriestheinstrumenttodeterminethenumberoftimesithasbeencalibrated.Notethatyourinstrumentwascalibratedbeforeitleftthefactory.Whenyoureceiveyourinstrument,besuretoreadthevariouscountstodetermineitsinitialvalue.


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?


SeeAlsoCALibrationSubsystemIntroduction

CALibration?


Syntax

CALibration:SECure:CODE<new_code>

Description

Thiscommandallowsyoutoenteranewsecuritycodetopreventaccidentalorunauthorizedcalibrations.Thespecifiedcodeisusedtounsecurethemainframeandallinstalledmodules.Tochangethesecuritycode,youmustfirstunsecuretheinstrumentusingtheoldsecuritycode,andthenenteranewcode.


UsedWith:

InternalDMM

Parameters


DefaultValue

<new_code> ASCIIString

Astringofupto12characters.Youdonothavetouseall12charactersbutthefirstcharactermustalwaysbealetter(A-Z).Theremaining11characterscanbeletters,numbers(0-9),ortheunderscorecharacter("_").Blankspacesarenotallowed.


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

Syntax

CALibration:SECure:STATe<state>,<code>


Description

Thiscommandunsecuresorsecurestheinstrumentforcalibration.Thisfeaturerequiresyoutoprovideasecuritycodetopreventaccidentalorunauthorizedcalibrationsoftheinstrument.Beforeyoucancalibratetheinstrument,youmustunsecureitbyenteringthecorrectsecuritycode.


UsedWith:

InternalDMM

Parameters


DefaultValue

<state> Boolean {OFF|0|ON|1} ON

<code> StringAstringofupto12characters.Youdonothavetouseall12charactersbutthefirstcharactermustalwaysbealetter(A-Z).Theremaining11characterscanbeletters,numbers(0-9),ortheunderscorecharacter("_").Blankspacesarenotallowed.


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

Syntax

CALibration:STRing<quoted_string>

CALibration:STRing?

Description

Thiscommandallowsyoutostoreonemessageincalibrationmemoryinthemainframe.Forexample,youcanstoresuchinformationasthedatewhenthelastcalibrationwasperformed,thedatewhenthenextcalibrationisdue,theinstrument'sserialnumber,oreventhenameandphonenumberofthepersontocontactforanewcalibration.


UsedWith:

InternalDMM

Parameters


DefaultValue


Astringofupto40charactersenclosedinquotes.Youcanuseletters(A-Z),numbers(0-9),andspecialcharacterslike"@","%","*",andsoon.


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"

Syntax

CALibration:VALue<value>

CALibration:VALue?

Description

ThiscommandspecifiesthevalueoftheknowncalibrationsignalasoutlinedinthecalibrationproceduresintheKeysight34970A/34972AServiceGuide.ThiscommandisusedforinternalDMMcalibrations.


Parameters


DefaultValue

<value>Numeric

Desiredcalibrationsignalintheunitsspecifiedbythepresentmeasurementfunction.


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


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:TOTalize

CONFigure:VOLTage:AC

CONFigure:VOLTage:DC

Syntax

CONFigure?[(@<ch_list>)]

Description

Thisqueryreturnsthepresentconfigurationonthespecifiedchannelsandreturnsaseriesofquotedstrings.

UsedWith:



34907AMultifunctionModule(digitalI/Oonly)


Parameters



asshown:





Remarks

IftheinternalDMMisnotinstalledorisdisabled,thennoDMM-relatedconfigurationsareallowed.However,scanningisallowedonthedigitalinputandtotalizerchannelsevenwithouttheinternalDMM.


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

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


<range> NumericExpectedvalueinamps(rangesshownbelow).

10mA(MIN)100mA1A(MAX)

AUTO

<resolution> Numeric Desiredresolutioninamps. Fixedat6½digits


asshown:



(@121:122,222,321:322)-channels21and22onthemoduleinslot100,channel22onthemoduleinslot200,andchannels21-22onthemoduleinslot300.

Notethatthechannelsmustbeoftheforms21ands22,wheresisthe


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.


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?


SeeAlsoCONFigure?

FETCh?

INITiate

READ?

MEASure:CURRent:AC?

MEASure:CURRent[:DC]?

ROUTe:CHANnel:DELay

ROUTe:SCAN

[SENSe:]CURRent:AC:BANDwidth

Syntax

CONFigure:DIGital:BYTE(@<scan_list>)

Description

Thiscommandconfigurestheinstrumenttoscanthespecifieddigitalinputchannelsonthemultifunctionmoduleasbytedata,butdoesnotinitiatethescan.Thiscommandredefinesthescanlist.

UsedWith:

34907AMultifunctionModule(digitalinputonly)

Parameters


<scan_list> Scanlist Oneormoredigital

I/Ochannels,asshown:


(@101:102,201,302)-channels01and02onthemodulesonslot100,channel01onthemoduleinslot200,andchannel02onthemoduleinslot300.


Remarks

Thedigitalinputchannelsarenumbered"s01"(LSB)and"s02"(MSB),wheresisthefirstdigitoftheslotnumber.

Notethatifyouincludebothdigitalinputchannelsinthescanlist,theinstrumentwillreaddatafrombothportssimultaneouslywiththesametimestamp.Thisallowsyoutoexternallycombinethetwo8-bitvalueintoone16-bitvalue.

Example

Thefollowingcommandconfigurestheinstrumenttoscanchannels01and02onslot100asbytedata.

CONF:DIG:BYTE(@101:102)

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.


UsedWith:




Parameters


<range> NumericExpectedvalueinHz(frequency)orseconds(period).Validvaluesrangefrom3Hzto300kHz,andtheirinverses(forperiod).

Forfrequencyandperiodmeasurements,thisparameterisonlyusedinconjunctionwiththe<resolution>parametertosetthegatetime.Itisotherwiseunnecessaryforfrequencyandperiodmeasurements.

AUTO

<resolution> Numeric DesiredresolutioninHz(frequency)orseconds(period).

0.000003xRange(1PLC)


asshown:




Remarks


Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverloadindication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.


Examples

Thefollowingprogramsegmentconfigurestheinstrumentforfrequencymeasurementsonchannel04inslot300.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.

CONF:FREQ(@304)

ROUT:SCAN(@304)

READ?


Thefollowingprogramsegmentconfigurestheinstrumentforfrequencymeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.

CONF:FREQ100,(@103,108)

ROUT:SCAN(@103,108)

INIT

FETC?


Thefollowingprogramsegmentconfigureschannel10onthemoduleinslot300forafrequencymeasurement.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,initiatesatrigger,andthen

sendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.

CONF:FREQ(@310)

READ?


SeeAlsoCONFigure?

FETCh?

INITiate

MEASure:FREQuency?

MEASure:PERiod?

READ?

ROUTe:SCAN

[SENSe:]FREQuency:RANGe:LOWer

[SENSe:]FREQuency:VOLTage:RANGe:AUTO

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.


UsedWith:



34908A40ChannelSingle-EndedMultiplexerModule(doesnotsupport4-wiremeasurement)

Parameters


<range> NumericExpectedvalueinohms,upto100MW.

AUTO

<resolution> Numeric Desiredresolutioninohms. 0.000003xRange(1PLC)


asshown:





Remarks

FortheFRESistanceversionofthiscommand,channelnispairedwithchanneln+10(34901A)orn+8(34902A)toprovidesourceandsenseconnections.



Ifyouselectautoranging(byspecifying"AUTO"or"DEF"),anerrorwillbegeneratedifyouspecifyadiscretevalueforthe<resolution>parameter.Whenautorangingiscombinedwithadiscreteresolution,theinstrumentcannotaccuratelyresolvetheintegrationtime(especiallyiftheinputsignaliscontinuouslychanging).Ifyourapplicationrequiresautoranging,besuretospecify"AUTO"forthe<resolution>parameter,oromittheparameterfromthecommandandusethe[SENSe:]VOLTage[:DC]NPLCcommandtospecifythedesiredintegrationtime.


Sincethesecommandsresetallmeasurementparametersonthe

specifiedchannelstotheirdefaultvalues,besuretosendtheCONFigurecommandbeforesettinganyothermeasurementparameters.



Examples

Thefollowingprogramsegmentconfigurestheinstrumentfor2-wireresistancemeasurementsonchannel04inslot300.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelonce,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(1PLC)areusedforthemeasurement.

CONF:RES(@304)

ROUT:SCAN(@304)

READ?


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?


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?



CONFigure?

FETCh?

INITiate

MEASure:RESistance?

MEASure:FRESistance?

READ?

ROUTe:SCAN

[SENSe:]RESistance:OCOMpensated

Syntax

CONFigure:TEMPerature{<probe_type>|DEF},{<type>|DEF}[,1[,{<resolution>|MIN|MAX|DEF}]],(@<scan_list>)

Description

Thesecommandsconfigurethechannelsfortemperaturemeasurementsbutdonotinitiatethescan.Ifyouomittheoptional<ch_list>parameter,thiscommandappliestothecurrentlydefinedscanlist.




Wire

RTD4-

Wire

Thermistor


Yes Yes Yes Yes


Yes Yes Yes Yes


NotRecommended1

Yes No Yes


Parameters


<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:





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).


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.


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?


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?


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?


SeeAlsoCONFigure?

FETCh?

INITiate


READ?

ROUTe:SCAN

[SENSe:]TEMPerature:NPLC

[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]

[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]

UNIT:TEMPerature

Syntax

CONFigure:TOTalize<mode>,(@<scan_list>)

Description

Thiscommandconfigurestheinstrumenttoreadthespecifiedtotalizerchannelsonthemultifunctionmodulebutdoesnotinitiatethescan.Toreadthetotalizerduringascanwithoutresettingthecount,setthe<mode>toREAD.Toreadthetotalizerduringascanandresetthecountto0afteritisread,setthe<mode>toRRESet(thismeans"readandreset").


UsedWith:

34907AMultifunctionModule(totalizechannelonly)

Parameters


<mode> Discrete {READ|RRESet} READ

<scan_list> ScanList Oneormore

totalizerchannels,asshown:


(@103,203,303)-channel03onthemodulesonslot100,200,and300.


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.


Examples

Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot200tobereadwithoutresettingitscount.

CONF:TOTREAD,(@203)

Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot300toberesetto0afteritisread.

CONF:TOTRRES,(@303)


CONFigure?

FETCh?

INITiate

READ?

[SENSe:]TOTalize:DATA?

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.


UsedWith:




Parameters


<range> NumericExpectedvalueinvolts

AUTO

<resolution> Numeric Desiredresolutioninvolts. 0.000003xRange(1PLC)


asshown:





Remarks



Ifyouselectautoranging(byspecifying"AUTO"or"DEF"),anerrorwillbegeneratedifyouspecifyadiscretevalueforthe<resolution>parameter.Whenautorangingiscombinedwithadiscreteresolution,theinstrumentcannotaccuratelyresolvetheintegrationtime(especiallyiftheinputsignaliscontinuouslychanging).Ifyourapplicationrequiresautoranging,besuretospecify"AUTO"forthe<resolution>parameteroromittheparameterfromthecommand.


Becausethiscommandresetsallmeasurementparametersonthespecifiedchannelstotheirdefaultvalues,besuretosendtheCONFigurecommandbeforesettinganyothermeasurementparameters.

Iftheinputsignalisgreaterthancanbemeasuredontheselectedrange(manualranging),theinstrumentgivesanoverload

indication:"±OVLD"fromthefrontpanelor"±9.9E+37"fromtheremoteinterface.

ForACmeasurements,theresolutionisfixedat6½digits.TheonlywaytocontrolthereadingrateforACmeasurementsisbychangingthechanneldelayorbysettingtheACfiltertothehighestfrequencylimit.The<resolution>parameteronlyaffectsthenumberofdigitsshownonthefrontpanel.


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?


ThefollowingprogramsegmentconfigurestheinstrumentforACvoltagemeasurementsonchannels03and08inslot100.TheINITiatecommandplacestheinstrumentinthe"wait-for-trigger"state,scansthechannelsonce,andstoresthereadingsinmemory.TheFETCh?commandtransfersthereadingsfromreadingmemorytotheinstrument'soutputbuffer.The1Vrangeisselected.

CONF:VOLT:AC1,(@103,108)

ROUT:SCAN(@103,108)

INIT

FETC?


Thefollowingprogramsegmentconfigureschannel10onthemoduleinslot300foranACvoltagemeasurement.TheREAD?commandplacestheinstrumentinthe"wait-for-trigger"state,initiatesatrigger,andthensendsthereadingtoreadingmemoryandtheinstrument'soutputbuffer.Thedefaultrange(autorange)andresolution(fixedat6½digits)areusedforthemeasurement.

CONF:VOLT:AC(@310)

READ?




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?

Syntax

DATA:LAST?[<num_rdgs>,](@<channel>)

Description

Thisqueryreturnsthemostrecentreadingorreadingstakenonthespecifiedchannelduringthescan.

Parameters


DefaultValue

<num_rdgs> Numeric Anintegerfrom1tothenumberofreadingsstoredinmemoryforthespecified<channel>.

1

<channel> ChannelAsinglechannel,specifiedasinthefollowingexamples.




Remarks

Thequeryreturnsthereadingsinorder,startingwiththeearliestreadinginthegroupofrecentreadings.Ifyouspecifymorereadingsthanarecurrentlystoredinmemory,theinstrumentgeneratesanerrormessage.

Readingscanbeacquiredduringascanusingthemultiplexerordigitalmodules.


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


SYSTem:DATE

SYSTem:TIME

Syntax

DATA:POINts?

Description

Thisqueryreturnsthetotalnumberofreadingscurrentlystoredinreadingmemoryfromascan.

Remarks

Youcanreadthecountatanytime,evenduringascan.

Youcanstoreatleast50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,abitintheSTATus:QUEStionable:CONDition?registerissetandnewreadingswilloverwritethefirst(oldest)readingsstored.Themostrecentreadingsarealwayspreserved.Readingmemoryisnotclearedwhenyoureadit.

Thequestionablestatusbitwillbeclearedwhenmemoryiscleared.ThequestionablestatusbitwillnotbeclearedifmemoryisemptiedwithDATA:REMove?orR?.



ReturnFormat

Thequeryreturnsavaluebetween0and50,000asasignedinteger,indicatingthenumberofreadingscurrentlystoredinreadingmemory.

Example

Thefollowingqueryreturnsthenumberofreadingsinmemory.

DATA:POIN?



DATA:REMove?

Syntax

DATA:POINts:EVENt:THReshold<num_rdgs>


Description

ThiscommandsetsabitintheStandardOperationRegistergroupeventregisterwhenthespecifiednumberofreadingshavebeenstoredinreadingmemoryfromascan.The"MemoryThreshold"bit(bit9)issettoa"1"intheeventregisterwhenthenumberofstoredreadingsisgreaterthanorequaltothespecifiedmemorythreshold.

FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.

Parameters

Name Type Rangeof

Values

DefaultValue

<num_rdgs> Numeric Anintegerfrom1to50,000


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?



STATus:OPERation:ENABle

Syntax

DATA:REMove?<num_rdgs>

Description

Thisqueryreadsandclearsthespecifiednumberofreadingsfromthenon-volatilememory.Thisallowsyoutocontinueascanwithoutlosingdatastoredinmemory(ifmemorybecomesfull,newreadingswilloverwritethefirstreadingsstored).Thespecifiednumberofreadingsareclearedfrommemory,startingwiththeoldestreading.

Parameters


DefaultValue

<num_rdgs> Numeric Anintegerrepresentingthenumberofreadingstobereadanderasedfrommemory.


Remarks

Youcanremovereadingsfrommemoryatanytime,evenduringascan.

Youcanstoreatleast50,000readingsinmemoryduringascan.Readingsarestoredonlyduringascan.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Inaddition,bit9issetintheQuestionableDataRegister'sconditionregister(seeStatusSystemIntroduction).

Iffewerthanthespecifiednumberofreadingsarecurrentlyinmemory,anerrorwillbegenerated.YoucanusetheDATA:POINts?querytodeterminethetotalnumberofreadingscurrentlyinmemory.



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


DATA:POINts?


R?

DIAGnosticSubsystemIntroduction

CommandSummaryDIAGnostic:DMM:CYCLes?

DIAGnostic:DMM:CYCLes:CLEar

DIAGnostic:PEEK:SLOT:DATA?

DIAGnostic:POKE:SLOT:DATA

DIAGnostic:RELay:CYCLes?

DIAGnostic:RELay:CYCLes:CLEar

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



Syntax

DIAGnostic:DMM:CYCLes:CLEar{1|2|3}

Description

ThiscommandresetstherelaycyclecountonthespecifiedinternalDMMrelay.

Remarks

YoumustunsecuretheinstrumentwithCALibration:SECure:STATetoresetthecyclecount.

Example

ThefollowingcommandresetstherelaycyclecountoninternalDMMrelay2.

DIAGnostic:DMM:CYCLes:CLEar2

Syntax

DIAGnostic:PEEK:SLOT:DATA?{100|200|300}

DIAGnostic:POKE:SLOT:DATA{100|200|300},<quoted_string>

Description

ThePOKEcommandallowsyoutoaddacustomlabelofupto10characterstothemoduleinthespecifiedslot.Charactersbeyondthetenthcharacteraretruncated,andnoerrormessageisgenerated.ThePEEKqueryreturnsthelabelstring.

Parameters


DefaultValue


AquotedASCIIstringofupto10characters.


Remarks

Onepossibleuseforthiscommandistoallowyoutodifferentiatebetweenmodulesofthesametypefromwithinyourprogram.

Thecustomlabelisstoredinnon-volatilememoryonthemodule.

YoumustunsecuretheinstrumentwithCALibration:SECure:STATeOFFbeforeyoucanstorethecustomlabel.

ReturnFormat

ThePEEKqueryreturnsthelabelstring.

Examples

Thefollowingcommandaddsalabeltothemoduleinslot200.

DIAG:POKE:SLOT:DATA200,"TestMod1"

Thefollowingqueryreturnsthelabelassociatedwithslot200.

DIAG:PEEK:SLOT:DATA?200

TypicalResponse:TestMod1

Syntax

DIAGnostic:RELay:CYCLes?(@<ch_list>)

Description

Thisqueryreadsthecyclecountonthespecifiedchannels.Inadditiontothechannelrelays,youcanalsoquerythecountontheAnalogBusrelaysandbankrelays.

UsedWith:

Allmodulesexceptfor34907A

Parameters


<ch_list> ChannelList Oneormorechannels,as

shown:



(@201:212,213,322:323,198)-channels1through12and13onthemoduleinslot200,channels22through23onthemoduleinslot300,andtreerelay98onthemoduleinslot100.


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

Syntax

DIAGnostic:RELay:CYCLes:CLEar(@<ch_list>)

Description

Thiscommandresetsthecyclecountonthespecifiedchannels.

Parameters



asshown:




Ifthisparameterisomitted,thecommandappliestothecurrentscanlist.

Remarks

Theinstrumentmustbeunsecuredinordertoresetthecyclecount.SeetheCALibration:SECure:STATecommandformoreinformationonunsecuringtheinstrument.

OntheRFMultiplexermodules(34905A,34906A),eachbankconsistsoftwoleafrelaysandonetreerelay(seeDIAGnostic:RELay:CYCLes?command).Clearingthecyclecountonaspecificchannelwillclearthecountonallthreerelaysinthecorrespondingbank.

Example

Thefollowingcommandclearsthecyclecountonchannels03and13inslot100.

DIAG:REL:CYCL:CLE(@103,113)

DISPlaySubsystemIntroduction

CommandSummaryDISPlay

DISPlay?

DISPlay:TEXT

DISPlay:TEXT?

DISPlay:TEXT:CLEar

Syntax

DISPlay<state>

DISPlay?

Description

Thiscommanddisablesorenablestheinstrument'sfront-paneldisplay.Forsecurityreasonsorforaslightincreaseinmeasurementrates,youmaywanttoturnoffthefront-paneldisplay.Whendisabled,theentirefront-paneldisplaygoesdarkandalldisplayannunciatorsexceptERRORaredisabled.

Parameters


DefaultValue


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

Syntax

DISPlay:TEXT<quoted_string>

DISPlay:TEXT?

Description

Thiscommanddisplaysatextmessageontheinstrument'sfront-paneldisplay.Theinstrumentcandisplayupto12charactersonthefrontpanel;anyadditionalcharactersaretruncated(noerrorisgenerated).

Parameters


DefaultValue


Astringofupto12charactersenclosedinquotationmarks.Youcanuseletters(A-Z),numbers(0-9),andspecialcharacterslike"@","%","*",andsoon.Use"#"charactertodisplayadegreesymbol(°).


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..."


DISPlay:TEXT:CLEar

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


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):


4ChannelNumber

2Date(November21,2004) 5AlarmLimitThresholdCrossed(0=NoAlarm,1=LO,2=HI)

3TimeofDay(3:30:23.000PM)

TheFORMatcommandsarevalidonlywiththefollowingKeysight34970A/34972Aplug-inmodules,whichcanbeconfiguredtobepartofascan.TheinternalDMMmustalsobeinstalledandenabled.



34903A20ChannelActuator/GPSwitchModule

34904A4x8Two-WireMatrixModule

34905A2GHzDual1:4RFMux,50OhmModule

34906A2GHzDual1:4RFMux,75OhmModule



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?

Syntax

FORMat:READing:ALARm<state>


Description

ThiscommanddisablesorenablestheinclusionofalarminformationwithdataretrievedbytheREAD?command,theFETCh?command,andotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.

UsedWith:





Parameters


DefaultValue


ThefactoryresetvalueisOFF(disabled).

Remarks

Thereadingformatappliestoallreadingsbeingretrievedfromtheinstrument;youcannotsettheformatonaper-channelbasis.

TheCONFigureandMEASure?commandsautomaticallydisablethealarmsetting.

Thealarmsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).

ReturnFormat


Examples

Thefollowingcommandenablestheinclusionofalarminformation.

FORM:READ:ALARON

Thefollowingqueryreturnsthealarmsetting.

FORM:READ:ALAR?

TypicalResponse:1

SeeAlsoFORMatSubsystemIntroduction


Syntax

FORMat:READing:CHANnel<mode>


Description

ThiscommanddisablesorenablestheinclusionofchannelnumberinformationwithdataretrievedbytheREAD?command,theFETCh?command,orotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.

UsedWith:





Parameters


DefaultValue

<mode> Boolean {OFF|0|ON|1} Thisisarequiredparameter.

ThefactorydefaultvalueisOFF(disabled).

Remarks


TheCONFigureandMEASure?commandsautomaticallydisablethechannelsetting.

Thechannelsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).

ReturnFormat


Examples

Thefollowingcommandenablestheinclusionofchannelnumberinformation.

FORM:READ:CHANON

Thefollowingqueryreturnsthechannelnumbersetting.

FORM:READ:CHAN?

TypicalResponse:1


FORMat:READing:ALARm

FORMat:READing:TIME

FORMat:READing:UNIT

Syntax

FORMat:READing:TIME<mode>


Description

ThiscommanddisablesorenablestheinclusionofatimestampwithdataretrievedbytheREAD?command,theFETCh?command,orotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.

UsedWith:





Parameters


DefaultValue



Remarks


Ifenabled,thetimestampinformationisshowneitherinabsolutetime(timeofdaywithdate)orrelativetime(timeinsecondssincestartofscan)assetbytheFORMat:READing:TIME:TYPEcommand.

TheCONFigureandMEASure?commandsautomaticallydisablethetimestampsetting.

Thetimestampsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).

ReturnFormat


Examples

Thefollowingcommandenablestheinclusionofatimestamp.

FORM:READ:TIMEON

Thefollowingqueryreturnsthetimestampsetting.

FORM:READ:TIME?

TypicalResponse:1





FORMat:READing:UNIT

Syntax

FORMat:READing:TIME:TYPE<format>


Description

ThiscommandselectsthetimeformatfortimestampsreturnedwhenFORMat:READing:TIMEisON.Youcanselectabsolutetime(timeofdaywithdate)orrelativetime(timeinsecondssincestartofscan).ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.

UsedWith:





Parameters


<format> Discrete {ABSolute|RELative} Thisisarequiredparameter.

ThefactorydefaultisRELative.

Remarks


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


FORMat:READing:TIME

SYSTem:DATE

SYSTem:TIME

Syntax

FORMat:READing:UNIT<mode>


Description

Thiscommanddisablesorenablestheinclusionofmeasurementunits(VAC,VDC,OHM,etc.)withdataretrievedbytheREAD?command,theFETCh?command,orotherqueriesofscanresults.ThiscommandoperatesinconjunctionwiththeotherFORMat:READingcommands(theyarenotmutuallyexclusive).SeeFormatSubsystemIntroductionforexamplesoffully-formattedresultsfromascan.

UsedWith:





Parameters


DefaultValue



Remarks


TheCONFigureandMEASure?commandsautomaticallydisabletheunitsetting.

Theunitsettingisstoredinvolatilememoryandwillbedisabled(OFF)whenpoweristurnedofforafteraFactoryReset(*RSTcommand).

ReturnFormat


Examples

Thefollowingcommandenablestheinclusionofmeasurementunits.

FORM:READ:UNITON

Thefollowingqueryreturnsthemeasurementunitssetting.

FORM:READ:UNIT?

TypicalResponse:1

SeeAlso




FORMat:READing:TIME


IEEE-488CommonCommandsIntroduction

CommandSummary*CLS

*ESE

*ESE?

*ESR?

*IDN?

*OPC

*OPC?

*PSC

*PSC?

*RCL

*RST

*SAV

*SRE

*SRE?

*STB?

*TRG

*TST?

*WAI

Syntax

*CLS

Description

Thiscommand,whosenamederivesfromCLearStatus,clearstheeventregistersinallregistergroups.Italsoclearstheerrorqueueandthealarmqueue,butitdoesnotcleartheenableregisters.

Example

Thefollowingcommandclearstheeventregisterbits,alarmqueue,anderrorqueue.

*CLS

SeeAlsoIEEE-488CommonCommandsIntroduction

*ESR?

STATus:OPERation[:EVENt]?

STATus:QUEStionable[:EVENt]?

Syntax

*ESE<enable_val>

*ESE?

Description

ThiscommandenablesbitsintheenableregisterfortheStandardEventRegistergroup.Theselectedbitsarethenreportedtobit5oftheStatusByteRegister.


Parameters


DefaultValue

<enable_val> Numeric Thedecimalvalueequaltothebinary-weightedsumofthebitsintheregister(seetablebelow).


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.


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


*ESR?

Syntax

*ESR?

Description

ThiscommandqueriestheeventregisterfortheStandardEventRegistergroup.Thisisaread-destructiveregister,andthebitsareclearedwhenyoureadtheregister.


Remarks

ThefollowingtableliststhebitdefinitionsfortheStandardEventRegister.

Bit#


Definition

0 OperationComplete

1 Allcommandspriortoandincluding*OPChavebeenexecuted.


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.


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


*ESE

*CLS

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

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


*ESE

Syntax

*PSC<state>

*PSC?

Description

Power-OnStatusClear.Thiscommandenablesordisablestheclearingofcertainenableregistersatpoweron.With*PSC0specified,theseregistersarenotclearedatpoweron.With*PSC1specified,theseregistersareclearedatpoweron.Thefollowingregistersareaffected:

RegisterName

Command

QuestionableDataRegister

STATus:QUEStionable:ENABle

StandardOperationRegister


AlarmRegister

STATus:ALARm:ENABle

StatusByteRegister

*SRE(ServiceRequestEnable)

StandardEventRegister

*ESE(EventStatusEnable)

The*PSCcommanddoesnotaffecttheclearingoftheconditionoreventregisters,justtheenableregisters.FormoreinformationontheStatusSystemfortheinstrument,seeStatusSystemIntroduction.

Parameters


DefaultValue


ReturnFormat

Thequeryreturns0(donotclearatpoweron)or1(clearatpoweron).

Examples

Thefollowingcommanddisablesthepower-onclearingoftheaffectedregisters.

*PSC0

Thefollowingqueryreturnsthepower-onstatusclearsetting.

*PSC?

TypicalResponse:0

SeeAlso*SRE

*STB?

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

Syntax

*RST

Description

ThiscommandresetstheinstrumenttotheFactoryconfiguration.SeeFactoryResetStateforacompletelistingoftheinstrument'sFactoryconfiguration.

Remarks

Thiscommanddoesnotaffectanypreviously-storedinstrumentstates(see*SAVcommand).

ThiscommanddoesnotaffectI/Osettings,suchasIPaddress.

ThevalueofCALibration:SECure:STATeisnotaffectedby*RST.

Example

Thefollowingcommandresetstheinstrument.

*RST

Syntax

*SRE<enable_val>

*SRE?

Description

ThiscommandenablesbitsintheenableregisterfortheStatusByteRegister.Onceenabled,thecorrespondingbitsmaygenerateaRequestforService(RQS)intheStatusByte.ThisRQSeventmaygeneratea"callback"toyourapplicationasatypeofasynchronousinterrupt.


Parameters


DefaultValue

<enable_val> Numeric Adecimalvaluewhichcorrespondstothebinary-weightedsumofthebitsintheregister(seetablebelow).


Remarks

ThefollowingtableliststhebitdefinitionsfortheStatusByteRegister.

Bit#


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).


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


*SRE?

TypicalResponse:+16


*STB?

Syntax

*STB?

Description

ThiscommandqueriestheconditionregisterfortheStatusByteRegistergroup.Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.


Remarks

ThefollowingtableliststhebitdefinitionsfortheStatusByteRegister.

Bit#


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


*SRE

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


INITiate

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

Syntax

*WAI

Description

Thiscommandwaitsforallpendingoperationstocompletebeforeexecutinganyadditionalcommandsovertheinterface.

Remarks

Functionandrangechangesareconsideredpendingoperations.Therefore,*WAIwillwaitforthesechangestocomplete.

Becausethiscommandstopsthecommandparserfromoperating,itisbettertouse*OPC?forsynchronizationpurposes.

Examples

Thefollowingcommandwaitsuntilallpendingoperationscomplete.

INIT;*WAI;:ROUT:CLOS(@101)!Ensuresthatthe

scanstartedbytheINITfinishes

!beforethe

ROUT:CLOScommandisexecuted.


*OPC

INSTrumentSubsystemIntroduction

CommandSummaryINSTrument:DMM

INSTrument:DMM?

INSTrument:DMM:INSTalled?

Syntax

INSTrument:DMM<state>

INSTrument:DMM?

Description

ThiscommanddisablesorenablestheinternalDMM.WhenyouchangethestateoftheinternalDMM,theinstrumentissuesaFactoryReset(*RSTcommand).

Parameters


DefaultValue


ReturnFormat

ThequeryreturnsthestateoftheinternalDMMas0(disabled)or1(enabled).

Examples

ThefollowingcommandenablestheinternalDMM.

INST:DMMON

ThefollowingqueryreturnsthestateoftheDMM,whichisONinthiscase.

INST:DMM?

TypicalResponse:1

SeeAlsoINSTrumentSubsystemIntroduction

Syntax


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

Syntax

LXI:IDENtify[:STATE]<state>

LXI:IDENtify[:STATE]?

Description

ThiscommandturnstheLXIIdentifyIndicatoronthefrontpaneldisplayonoroff.

Parameters



Remarks

TheLXIIdentifyIndicatorhelpsyouidentifywhichLXIdeviceisassociatedwiththeLANaddressyouareusing.

TheinstrumentturnsofftheLXIIdentifyIndicatorafteraFactoryReset(*RSTcommand).

YoucanpresstheLOCALkeytoturnofftheLXIIdentifyIndicator.

ReturnFormat

ThequeryreturnsthecurrentLXIIdentifyIndicatorstate:0(OFF)or1(ON).

Examples

ThefollowingcommandturnsontheLXIIdentifyIndicator.

LXI:IDENON

ThefollowingqueryreturnsthestateoftheLXIIdentifyIndicator.

LXI:IDEN?

TypicalResponse:1

SeeAlsoLXISubsystemIntroduction

Syntax

LXI:RESet

Description

Thiscommandresetstheinstrument'sLANsettingstotheirdefaultvalues.

Example

ThefollowingcommandresetstheLANsettings.

LXI:RES

Syntax

LXI:RESTart

Description

ThiscommandrestartstheLANwiththecurrentparameters.

Example

ThefollowingcommandrestartstheLANinterface.

LXI:REST

MEASureSubsystemIntroductionIfyouspecifya<ch_list>withoneofthesecommands,that<ch_list>overwritesthecurrentscanlist.

CommandSummaryMEASure:CURRent:AC?

MEASure:CURRent:DC?

MEASure:DIGital:BYTE?

MEASure:FREQuency?


MEASure:PERiod?

MEASure:RESistance?


MEASure:TOTalize?

MEASure:VOLTage:AC?

MEASure:VOLTage:DC?

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



READ?

Syntax

MEASure:DIGital:BYTE?(@<scan_list>)

Description

ThiscommandisequivalenttoCONFigure:DIGital:BYTEfollowedbyaREAD?.



READ?

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?.


CONFigure:FREQuency

CONFigure:PERiod


[SENSe:]FREQuency:VOLTage:RANGe

[SENSe:]PERiod:VOLTage:RANGe

READ?

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?.





[SENSe:]FRESistance:OCOMpensated

READ?

Syntax

MEASure:TEMPerature?{<probe_type>|DEF},{<type>|DEF}[,1[,{<resolution>|MIN|MAX|DEF}]],(@<scan_list>)

Description

ThiscommandisequivalenttoCONFigure:TEMPeraturefollowedbyaREAD?.



READ?

Syntax

MEASure:TOTalize?<mode>,(@<scan_list>)

Description

ThiscommandisequivalenttoCONFigure:TOTalizefollowedbyaREAD?.


CONFigure:TOTalize

READ?

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?.


CONFigure[:VOLTage][:DC]

CONFigure[:VOLTage]:AC

ROUTe:CHANnel:DELay

ROUTe:CHANnel:DELay:AUTO




READ?

MEMorySubsystemIntroduction

CommandSummaryMEMory:NSTates?

MEMory:STATe:DELete

MEMory:STATe:NAME

MEMory:STATe:NAME?

MEMory:STATe:RECall:AUTO

MEMory:STATe:RECall:AUTO?

MEMory:STATe:VALid?

Syntax

MEMory:NSTates?

Description

Thisqueryreturnsthetotalnumberofmemorylocationsavailableforstatestorage.Forthe34970A/34972A,thiscommandalwaysreturnsthenumber6.

Remarks

Location0isincluded,butitisreservedforpower-downstatestorage.

ReturnFormat

Thequeryreturnsthenumber+6.

Example

Thefollowingqueryreturnsthenumberofstates.

MEMory:NSTates?

TypicalResponse:+6

SeeAlsoMEMorySubsystemIntroduction

Syntax

MEMory:STATe:DELete<location>

Description

Thiscommanddeletesthecontentsofthespecifiedstoragelocation.

Parameters

Name Type Rangeof

Values

DefaultValue

<location> NumericAnintegerfrom0to5


Remarks

Notethatyoucannotrecalltheinstrumentstatefromastoragelocationthatwasdeleted.Anerrorisgeneratedifyouattempttorecalladeletedstate(+291,"Notabletorecallstate:itisempty").

Example

Thefollowingcommanddeletesthecontentsofstoragelocation1.

MEM:STAT:DEL1


*SAV

*RCL

Syntax

MEMory:STATe:NAME<location>[,<name>]

MEMory:STATe:NAME?<location>

Description

Thiscommandassignsanametothespecifiedstoragelocation.Youcannamealocationfromthefrontpanelorovertheremoteinterfacebutyoucanrecallanamedstateonlyfromthefrontpanel.Fromtheremoteinterface,youcanonlyrecallastoredstateusingthe*RCLcommandwithanumber(0through5).

Parameters


DefaultValue

<location> Numeric Anintegerfrom0to5


<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"


*SAV

*RCL

Syntax

MEMory:STATe:RECall:AUTO<mode>


Description

Thiscommandenablesordisables(default)theautomaticrecallofthepower-downstate(state0)whenpoweristurnedon.Select"ON"toautomaticallyrecallthepower-downstate.Select"OFF"toissueaFactoryReset(*RST)whenpoweristurnedon(inthismode,thepower-downstateisnotautomaticallyrecalled).

Parameters


DefaultValue


Remarks

Whentheinstrumentisshippedfromthefactory,theautomaticrecallmodeisdisabled.

State0getsstoredeverytimethepoweristurnedoff.

ReturnFormat


Examples

Thefollowingcommandenablestheautomaticrecallmode.

MEM:STAT:REC:AUTOON

Thefollowingqueryreturnstheautomaticrecallsetting.

MEM:STAT:REC:AUTO?

TypicalResponse:1


*SAV

Syntax

MEMory:STATe:VALid?<location>

Description

Thiscommandqueriesthespecifiedstoragelocationtodeterminewhetheravalidstateiscurrentlystoredinthislocation.Duringthevalidationprocess,theinstrumentverifiesthatthelocationisnotempty.Youcanusethiscommandbeforesendingthe*RCLcommandtodeterminewhetherastatehasbeenpreviouslystoredinthislocation.

Parameters


DefaultValue

<location> NumericAnintegerfrom0to5


Remarks

Thiscommanddoesnotguaranteethatnoerrorswillbegeneratedwhenastoredstateisrecalledusingthe*RCLcommand.Evenifthiscommanddeterminesthatthespecifiedstoragelocationisvalid,individualmodulesmaystillbeinstatesthatwillgenerateanerror.

ReturnFormat

Thequeryreturns0ifnostatehasbeenstoredinthespecifiedlocationorifithasbeendeleted.Itreturns1ifavalidstateisstoredinthespecifiedlocation.

Example

Thefollowingqueryreturnsa0,indicatingthatnovalidstateiscurrentlystoredinlocation3.

MEM:STAT:VAL?3

TypicalResponse:0

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]?

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



Syntax

MMEMory:FORMat:READing:CSEParator<column_separator>


Description

ThiscommandallowsyoutospecifythecharacterusedtoseparatethecolumnsintheoutputdataontheUSBdrive.Thisenablesyoutomakethefileconformwiththeapplicationsoftwarethatyouwilluseforviewingthefile.

Parameters


<column_separator> Discrete{TAB|COMMa|SEMicolon}


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.


TypicalResponse:TAB

Syntax

MMEMory:FORMat:READing:RLIMit<row_limit>


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


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


Examples

Thefollowingcommandturnstherowlimitfeatureon,causingUSBdatafilestobesplitatthe64K-1boundary.

MMEMory:FORMat:READing:RLIMitON

Thefollowingqueryindicateswhethertherowlimitfeatureison.Inthiscase,itisOFF.


TypicalResponse:0

Syntax


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"

Syntax

MMEMory:IMPort:CONFig?"<configuration_file>"

Description

ThisqueryimportsanKeysightBenchLinkDataLoggerconfiguration(BLCFG)fileandattemptstoconfiguretheinstrumentaccordingtothecontentsoftheBLCFGfile.Itwaitsuntiltheimportiscompleteandreturns0(noerrors)or1(importhaderrors).

Parameters


DefaultValue

<configuration_file> FilenameAnyfilename,alwayswitha.BLCFGextension.


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

Syntax

MMEMory:LOG[:ENABle]<state>


Description

ThiscommandallowsyoutospecifywhetherscannedreadingsareloggedtotheUSBdriveastheyaretaken.

Parameters


DefaultValue


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.

ReturnFormat


Examples

ThefollowingcommandspecifiesthatscannedreadingsaretobeloggedtotheUSBdriveastheyaretaken.Datawillalsosimultaneouslybewrittentoreadingmemory.ToscandataintoreadingmemorywithoutloggingitontheUSBdrive,youwoulduseMMEM:LOGOFF.

MMEMory:LOGON

ThefollowingqueryindicateswhetherscannedreadingsaretobeloggedtotheUSBdrive.Inthiscase,thereturnedvalueof1indicatesthatloggingtotheUSBdriveisON(enabled).

MMEMory:LOG?

TypicalResponse:1

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}:CLEarOUTPut:ALARm:CLEar:ALLSyntax|Description|Parameters|Remarks|ReturnFormat|Examples

Syntax


OUTPut:ALARm:CLEar:ALL

Description

TheOUTPut:ALARm{1|2|3|4}:CLEarcommandclearsthespecifiedalarmoutputline.TheOUTPut:ALARm:CLEar:ALLcommandclearsallfouralarmoutputlines.

UsedWith:





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


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:





Parameters


<mode> Discrete{LATCh|TRACk}


ThefactorydefaultisLATCh

Remarks

AFactoryReset(*RSTcommand)clearsallfouralarmoutputsbutdoesnotclearthealarmqueueineitherconfiguration.

ReturnFormat

ThequeryreturnsLATCorTRAC.Theselectedconfigurationappliestoallfouralarmoutputlines.

Examples

Thefollowingcommandenablesthetrackmodeonallfouralarmoutputlines.

OUTP:ALAR:MODETRAC

Thefollowingqueryreturnstheconfigurationofthefouralarmoutputlines.

OUTP:ALAR:MODE?

TypicalResponse:TRAC


OUTPut:ALARm:SLOPe



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:





Parameters


<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


OUTPut:ALARm:MODE



OUTPut:ALARm{1|2|3|4}:SOURceSyntax|Description|Parameters|Remarks|ReturnFormat|Examples

Syntax

OUTPut:ALARm{1|2|3|4}:SOURce(@<ch_list>)


Description

Thiscommandassignsoneoffouralarmnumberstoreportanyalarmconditionsonthespecifiedmultiplexerordigitalchannels.

Onthedigitalmodules,youcanconfiguretheinstrumenttogenerateanalarmwhenaspecificbitpatternorbitpatternchangeisdetectedonadigitalinputchannelorwhenaspecificcountisreachedonatotalizerchannel.Thesechannelsdonothavetobepartoftheactivescanlisttogenerateanalarm.

UsedWith:





Parameters



asshown:





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)




OUTPut:ALARm:MODE

OUTPut:ALARm:SLOPe


ROUTeSubsystemIntroduction

CommandSummaryROUTe:CHANnel:ADVance:SOURce

ROUTe:CHANnel:ADVance:SOURce?

ROUTe:CHANnel:DELay

ROUTe:CHANnel:DELay?


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?

Syntax

ROUTe:CHANnel:ADVance:SOURce<source>


Description

Thiscommandselectsthesourcetoprovidethechanneladvancesignaltothenextchannelinthescanlistforexternalscanning.Whenthechanneladvancesignalisreceived,theinstrumentopensthecurrentlyselectedchannelandclosesthenextchannelinthescanlist.TheinstrumentwillacceptanexternalTTLtriggerpulse,asoftware(bus)command,oranimmediate(continuous)scantrigger.

ThiscommandisvalidonlywhentheinternalDMMisdisabled(seeINSTrument:DMMcommand)orremovedfromtheKeysight34970A/34972A.

UsedWith:




Parameters


<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

Syntax

ROUTe:CHANnel:DELay<seconds>,(@<ch_list>)

ROUTe:CHANnel:DELay?(@<ch_list>)

Description

Thiscommandaddsadelaybetweenmultiplexerchannelsinthescanlist(usefulforhigh-impedanceorhigh-capacitancecircuits).Thedelayisinsertedbetweentherelayclosureandtheactualmeasurementoneachchannel,inadditiontoanydelaythatwillimplicitlyoccurduetorelaysettlingtime.Theprogrammedchanneldelayoverridesthedefaultchanneldelaythattheinstrumentautomaticallyaddstoeachchannel.

UsedWith:



34907AMultifunctionModule(digitalinputandtotalizerchannelsonly)


Parameters


<seconds> Numeric Anumberfrom0to60,with1msresolution.



asshown:




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)




ROUTe:SCAN

Syntax

ROUTe:CHANnel:DELay:AUTO<state>[,(@<ch_list>)]

ROUTe:CHANnel:DELay:AUTO?[(@<ch_list>)]

Description

Thiscommanddisablesorenablesanautomaticchanneldelayonthespecifiedchannels.Ifenabled,theinstrumentdeterminesthedelaybasedonfunction,range,integrationtime,andACfiltersetting.

UsedWith:





Parameters




asshown:





Remarks

SelectingaspecificchanneldelayusingtheROUTe:CHANnel:DELaycommanddisablestheautomaticchanneldelay.

TheCONFigureandMEASure?commandssetthechanneldelaytoAutomatic.

TheinstrumentsetsthechanneldelaytoAutomaticafteraFactoryReset(*RSTcommand).

ReturnFormat


Examples

Thefollowingcommandenablesanautomaticchanneldelayonchannels03and13inslot100.

ROUT:CHAN:DEL:AUTOON,(@103,113)

Thefollowingqueryreturnstheautomaticchanneldelaysettingsonchannels03and13inslot100.

ROUT:CHAN:DEL:AUTO?(@103,113)

TypicalResponse:1,1


ROUTe:CHANnel:DELay

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:



Parameters


<state> Boolean {OFF|0|ON|1}


asshown:




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


Examples

Thefollowingcommandconfigureschannels03and05inslot100for4-wireexternalscanning.

INST:DMMOFF!DisableinternalDMM

ROUT:CHAN:FWIRON,(@103,105)!Enable4-wire

configuration

Thefollowingqueryreturnsthe4-wireconfigurationselectedonchannels03and05inslot100.

ROUT:CHAN:FWIR?(@103,105)

TypicalResponse:1,1


INSTrument:DMM

ROUTe:CHANnel:ADVance:SOURce

Syntax

ROUTe:CLOSe(@<ch_list>)

ROUTe:CLOSe?(@<ch_list>)

Description

Thiscommandclosesthespecifiedchannelsonamultiplexerorswitchmodule.Onthemultiplexermodules,ifanychannelonthemoduleisdefinedtobepartofthescanlist,attemptingtosendthiscommandwillresultinanerror.

UsedWith:

Allmodulesexcept34907A

Parameters



asshown:





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




ROUTe:OPEN

Syntax

ROUTe:CLOSe:EXCLusive(@<ch_list>)

Description

Thiscommandopensallchannelsonamultiplexerorswitchmoduleandthenclosesthespecifiedchannels.Onthemultiplexermodules,ifanychannelonthemoduleisdefinedtobepartofthescanlist,attemptingtosendthiscommandwillresultinanerror.

UsedWith:


Parameters



asshown:





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)


ROUTe:CLOSe

ROUTe:OPEN

Syntax

ROUTe:DONE?

Description

Thisqueriesthestatusofallrelayoperationsoncardsnotinvolvedinthescanandreturnsa1whenallrelayoperationsarefinished(evenduringascan).

ReturnFormat

Thequeryreturnsa1.

Example

Thefollowingqueryreturnsa1whenallrelayoperationsarefinished.

ROUT:DONE?

TypicalResponse:1

Syntax

ROUTe:MONitor(@<channel>)

ROUTe:MONitor?

Description

Thiscommand/queryselectsthechanneltobedisplayedonthefrontpanel.Onlyonechannelcanbemonitoredatatime.

Parameters


DefaultValue

<channel> ChannelAsinglechannel,specifiedasinthefollowingexamples.




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)


ROUTe:MONitor:STATe

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?



ROUTe:MONitor

ROUTe:MONitor:STATe

Syntax

ROUTe:MONitor:STATe<mode>


Description

ThiscommanddisablesorenablestheMonitormode.TheMonitormodeisequivalenttomakingcontinuousmeasurementsonasinglechannelwithaninfinitescancount.Onlyonechannelcanbemonitoredatatimebutyoucanchangethechannelbeingmonitoredatanytime.Thisfeatureisusefulfortroubleshootingyoursystembeforeatestorforwatchinganimportantsignal.

UsedWith:





Parameters


DefaultValue


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


Examples

Thefollowingprogramsegmentconfigureschannel3inslot100forDCvoltagemeasurements,enablesmonitoringonthechannel,andturnsontheMonitormode.

CONF:VOLT:DC(@103)

ROUT:MON:CHAN(@103)

ROUT:MON:STATON

ThefollowingqueryreturnsthestateoftheMonitormode.

ROUT:MON:STAT?

TypicalResponse:1


ROUTe:CLOSe

ROUTe:MONitor:DATA?

ROUTe:OPEN

Syntax

ROUTe:OPEN(@<ch_list>)

ROUTe:OPEN?(@<ch_list>)

Description

Thiscommandopensthespecifiedchannelsonamultiplexerorswitchmodule.

UsedWith:


Parameters



asshown:





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


ROUTe:CLOSe

Syntax

ROUTe:SCAN(@<scan_list>)

ROUTe:SCAN?

Description

Thiscommandselectsthechannelstobeincludedinthescanlist.ThiscommandisusedinconjunctionwiththeCONFigurecommandstosetupanautomatedscan.Thespecifiedchannelssupersedeanychannelspreviouslydefinedtobepartofthescanlist.Tostartthescan,usetheINITiateorREAD?command.

UsedWith:





Toremoveallchannelsfromthepresentscanlist,send"ROUT:SCAN(@)".

Parameters



asshown:





Remarks

Toremoveallchannelsfromthescanlist,issuethecommandROUT:SCAN(@).


YoucanuseeithertheinternalDMMoranexternalinstrumenttomakemeasurementsofyourconfiguredchannels.However,the34970A/34972Aallowsonlyonescanlistatatime;youcannotscansomechannelsusingtheinternalDMMandothersusinganexternalinstrument.Readingsarestoredin34970A/34972AmemoryonlywhentheinternalDMMisused,exceptfordigitalinputandtotalizerchannels.

Youcanstoreatleast50,000readingsinmemoryandallreadingsareautomaticallytimestamped.Ifmemoryoverflows,thenewreadingswilloverwritethefirst(oldest)readingsstored;themostrecentreadingsarealwayspreserved.Youcanreadthecontentsofmemoryatanytime,evenduringascan.Readingmemoryisnotclearedwhenyoureadit.


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?


Thefollowingcommandclearsthepresentscanlist.

ROUT:SCAN(@)

Thefollowingqueryreturnsalistofchannelsinthepresentscanlist.

ROUT:SCAN?

TypicalResponse:#210(@103,108)


ABORt

INITiate

READ?

ROUTe:SCAN:SIZE?

Syntax

ROUTe:SCAN:SIZE?

Description

Thisqueryreturnsthenumberofchannelsinthescanlist.

UsedWith:





Remarks

Thepresentscanlistisstoredinnon-volatilememoryandwillberetainedwhenpoweristurnedoff.

ReturnFormat

Thequeryreturnsthenumberofchannelsasasignedintegerfrom0to120.

Example

Thefollowingqueryreturnsthenumberofchannelsinthescanlist.

ROUT:SCAN(@101:120)

ROUT:SCAN:SIZE?

TypicalResponse:+20


ROUTe:SCAN

SENSeSubsystemIntroductionIfyouspecifya<ch_list>withoneofthesecommands,that<ch_list>overwritesthecurrentscanlist.

CommandSummary

ACCurrent


[SENSe:]CURRent:AC:BANDwidth?

[SENSe:]CURRent:AC:RANGe

[SENSe:]CURRent:AC:RANGe?

[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: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?

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: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: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:VOLTage:RANGe?


[SENSe:]FREQuency:VOLTage:RANGe:AUTO?

Period

[SENSe:]PERiod:APERture

[SENSe:]PERiod:APERture?


[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:RJUNction?

[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated

[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated?


[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: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: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?

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:


Parameters


<filter> Discrete {3|20|200} 20


asshown:




Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslotnumber.


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



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:


Parameters


<range> DiscreteExpectedvalueinamps(rangesshownbelow).

10mA(MIN)100mA1A(MAX)



asshown:




Notethatthechannelsmustbeoftheforms21ands22,wheresisthefirstdigitoftheslot


number.

Remarks

Selectingadiscreterangewilldisableautorangingonthespecifiedchannels(see[SENSe:]CURRent:AC:RANGe:AUTOand[SENSe:]CURRent:DC:RANGe:AUTOcommands).

TheCONFigureandMEASure?commandsautomaticallyenableautorangingifthefirstparameterisAUTO,DEForomitted.


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)


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:


Parameters




asshown:






Remarks


Withautorangingenabled,theinstrumentselectsoneofthefollowingrangesbasedontheinputsignaldetected:

10mA100mA1A

Selectingadiscreterange(see[SENSe:]CURRent:AC:RANGecommand)willdisableautorangingonthespecifiedchannels.


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

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:


Parameters


<resolution> Numeric Desiredresolutioninamps. 0.000003xRange(1PLC)


asshown:






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


5½Digits

18

1PLC <0.000003xRange

5½Digits

20


6½Digits

21


6½Digits

24


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")


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:


Parameters


<time> Numeric Desiredaperturetimeinsecondsbetween400µsand1second,with4µsresolution.MIN=400µs,MAX=1second

Aperturedisabled.


asshown:






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")


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


<PLCs> Discrete 0.02|0.2|1|2|10|20|100|200}MIN=0.02PLC,MAX=200PLC

1PLC


asshown:






Remarks



IntegrationTime



4½Digits

15


5½Digits

18


5½Digits

20


6½Digits

21


6½Digits

24


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)


[SENSe:]DIGital:DATA:{BYTE|WORD}?Syntax|Description|Parameters|Remarks|ReturnFormat|Examples

Syntax

[SENSe:]DIGital:DATA:{BYTE|WORD}?(@<ch_list>)

Description

Thisqueryconfiguresthespecifiedchannelsasinputsandreadsan8-bitbyteora16-bitworddigitalpatternfromthespecifieddigitalinputchannels.

Parameters


<ch_list> ChannelList Oneormoredigital





Remarks

Toreadbothportssimultaneously(WORD),youmustsendthecommandtoport01(LSB)andneitherportcanbeincludedinthescanlist.

Thedigitalinputchannelsarenumbered"s01"(LSB)and"s02"(MSB),wheresisthefirstdigitoftheslotnumber.

ReturnFormat

TheoutputfromthiscommandisaffectedbytheFORMat:READingcommands.

Examples

Thefollowingcommandreadsthevalueonchannel02ofthemoduleinslot100.

[SENSe:]DIGital:DATA:BYTE?(@102)


Thefollowingcommandreadsthevalueonchannels01and02ofthemoduleinslot200.

[SENSe:]DIGital:DATA:WORD?(@201)


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:




Parameters


<seconds> DiscreteDesiredgatetimeinseconds:

10ms(4½digits,MIN)

100ms(5½digits)

1second(6½digits,MAX)

100ms


asshown:





Remarks


Becausefrequencyandperiodarerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.

Theinstrumentsetstheaperturetimeto100msafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.

ReturnFormat


Examples

Thefollowingcommandsetsthegatetimeto10msonchannels03and13inslot100.

YoucansubstitutethenodenamePERiodwherethenodenameFREQappearsbelow.

FREQ:APER10E-03,(@103,113)

Thefollowingqueryreturnsthegatetimeselectedonchannels03and13inslot100.

FREQ:APER?(@103,113)



CONFigure:FREQuency

CONFigure:PERiod

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:




Parameters


<frequency> Numeric Anintegerfrom3to300,000.



asshown:





Remarks

Appliestofrequencymeasurementsonly.

Forthe<frequency>parameter,specifythelowestfrequencyexpectedintheinputsignalonthespecifiedchannels.Theinstrumentselectstheappropriatemeasurementtimeoutbasedonthefrequencyyouspecify.Attemptstomeasurefrequenciesbelowthespecifiedlimitmayfalselyreturnavalueof0.

InputFrequency Timeout

3Hzto300kHz(Slow)

1second


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


CONFigure:FREQuency

CONFigure:PERiod

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:




Parameters


<range> DiscreteDesiredrangeinvolts:

100mV(MIN)1V10V100V1000V(MAX)



asshown:





Remarks

Selectingadiscreterangewilldisableautorangingonthespecifiedchannels.



Becausefrequencyandperiodarerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.


ReturnFormat

Thequeryreturnsthevoltagerangeintheform"+1.00000000E+01".

Examples

Thefollowingcommandselectsthe10voltrangeforfrequencymeasurements.

FREQ:VOLT:RANG10

Thefollowingqueryreturnsthevoltagerangeselected.

FREQ:VOLT:RANG?



CONFigure:FREQuency

CONFigure:PERiod



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:




Parameters




asshown:





Remarks



100mV1V10V100V300V

Selectingadiscreterange(see[SENSe:]FREQuency:VOLTage:RANGecommand)willdisableautorangingonthespecifiedchannels.


Becausefrequencyandperiodarerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction


ReturnFormat


Examples

Thefollowingcommanddisablesautoranging.

FREQ:VOLT:RANG:AUTOOFF

Thefollowingqueryreturnstheautorangingsetting.

FREQ:VOLT:RANG:AUTO?

TypicalResponse:0


CONFigure:FREQuency

CONFigure:PERiod



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:



34908A40ChannelSingle-EndedMultiplexerModule(RESistanceonly;notFRESistance)

Parameters


<aperture_time> Numeric Anumberofseconds,from0.0004to4.

Thisisarequiredparameter.Youmustspecifythetime,orMINorMAX.


asshown:





Remarks


Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction(see[SENSe:]FRESistance:APERturecommand).



TheCONFigure,MEASure?,[SENSe:]RESistance:NPLC,[SENSe:]RESistance:RESolution,[SENSe:]FRESistance:NPLC,and[SENSe:]FRESistance:RESolutioncommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).


ReturnFormat


Examples

Ineachofthefollowingexamples,youcouldreplacethenodenameFRESwithRESistance.

Thefollowingcommandenablestheaperturemodeandsetstheaperturetimeto300msonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.

FRES:APER300E-03,(@103,113)


FRES:APER?(@103,113)

FRES:APER:ENAB?!Verifythataperturemodeis

enabled("1")


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:




Parameters


<PLCs> Discrete {0.02|0.2|1|2|10|20|100|200|MIN|MAX} Thisisarequiredparameter.

<ch_list> ChannelList Oneormorechannels,asshown:





Remarks


Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction.



IntegrationTime



4½Digits

15


5½Digits

18


5½Digits

20


6½Digits

21

10PLC <0.000001x 6½ 24

Range Digits


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).


ReturnFormat


Examples

Ineachofthefollowingexamples,youcouldreplacethenodenameFRESwithRESistance.

Thefollowingcommandsettheintegrationtimeto0.2PLCsonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.

FRES:NPLC0.2,(@103,113)


FRES:NPLC?(@103,113)

FRES:APER:ENAB?!Verifythataperturemodeis

disabled("0")


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:




Parameters



ThefactorydefaultvalueisOFF.


asshown:





Remarks

Turningoffsetcompensationonwilldoublemeasurementtime.

Onceenabled,offsetcompensationisappliedtoboth2-wireand4-wireresistancemeasurementsonthespecifiedchannels.



TheCONFigureandMEASure?commandsautomaticallydisableoffsetcompensation.

TheinstrumentdisablesoffsetcompensationafteraFactoryReset(*RSTcommand).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.

ReturnFormat


Examples

Ineachofthefollowingexamples,youcanreplacethenodenameRESwithFRES.

Thefollowingcommandenablesoffsetcompensationonchannels3and13inslot100.

RES:OCOMON,(@103,113)

Thefollowingqueryreturnstheoffsetcompensationsettingsonchannels03and13inslot100.

RES:OCOM?(@103,113)

TypicalResponse:1,1

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:




Parameters


<range> DiscreteDesiredrangeinohms:

100Ω(MIN)1kΩ10kΩ100kΩ1MΩ10MΩ100MΩ(MAX)



asshown:





Remarks

Selectingadiscreterangewilldisableautorangingonthespecifiedchannels(see[SENSe:]RESistance:RANGe:AUTOcommand).

Because2-wireand4-wireresistancearerelatedfunctions,changingameasurementparameterforonefunctionwillalsochangethecorrespondingparameterfortheotherfunction(see[SENSe:]RESistance:RANGecommand).





ReturnFormat

Thequeryreturnstherangeintheform"+1.00000000E+03"foreachchannelspecified.Multipleresponsesareseparatedbycommas.

Examples

Inthefollowingexamples,youcansusbstitutethenodenameRESforFRES.

Thefollowingcommandselectsthe10kΩrangeonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.

FRES:RANG10E+3,(@103,113)


FRES:RANG?(@103,113)


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:




Parameters



ThefactorydefaultvalueisON.


asshown:





Remarks





100Ω1kΩ10kΩ100kΩ1MΩ10MΩ100MΩ

Selectingadiscreterange(see[SENSe:]RESistance:RANGecommand)willdisableautorangingonthespecifiedchannels.


TheinstrumentenablesautorangingafteraFactoryReset(*RST

command).AnInstrumentPreset(SYSTem:PRESetcommand)orCardReset(SYSTem:CPONcommand)doesnotchangethesetting.

ReturnFormat


Examples

Inthefollowingexamples,youcansubstitutethenodenameRESforFRES.

Thefollowingcommanddisablesautorangingonchannels03and13inslot100.Forthis4-wiremeasurement,theinstrumentautomaticallypairsthesechannelsinBank1withthecorrespondingchannelsinBank2.

FRES:RANG:AUTOOFF,(@103,113)

Thefollowingqueryreturnstheautorangingsettingsonchannels03and13inslot100.

FRES:RANG:AUTO?(@103,113)

TypicalResponse:0,0

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:




Parameters


<resolution> Numeric Desiredresolutioninohms 0.000003xRange(1PLC)


asshown:





Remarks



Theinstrumentwilldispatchasettingsconflicterrorifyouissuethiscommandwhen[SENSe:]CURRent:DC:RANGe:AUTOisONforoneormoreofthespecifiedchannels.



IntegrationTime



4½Digits

15


5½Digits

18


5½Digits

20


6½Digits

21


6½Digits

24


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).


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")


Syntax

[SENSe:]FUNCtion"<function>"[,(@<ch_list>)]

[SENSe:]FUNCtion?[(@<ch_list>)]

Description

Selectthemeasurementfunctiononthespecifiedchannels.Thefunctionnamemustbeenclosedinquotesinthecommandstring(forexample,FUNC"VOLT:DC").

Parameters


<function> Discrete{TEMPerature|VOLTage[:DC]|VOLTage:AC|RESistance|FRESistance|CURRent[:DC]|CURRent:AC|FREQuency|PERiod}



asshown:





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"

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.



Wire

RTD4-

Wire

Thermistor


Yes Yes Yes Yes


Yes Yes Yes Yes

34908AArmature

NotRecommended1

Yes No Yes

Multiplexer(1-Wire)


Parameters


DefaultValue

<seconds> Numeric Desiredaperturetimeinsecondsbetween400µsand1second,with4µsresolution.MIN=400µs,MAX=1second

Aperturedisabled.

<ch_list> Numeric Oneormorechannelsintheform(@scc).


Remarks



TheCONFigure,MEASure?,and[SENSe:]TEMPerature:NPLCcommandsdisabletheaperturemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).


ReturnFormat

Thequerycommandreturnstheaperturetimeintheform"+1.00000000E-01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.

Examples


TEMP:APER400E-03,(@103,113)


TEMP:APER?(@103,113)

Typicalresponse:+4.00000000E-01,+4.00000000E-01

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).



Wire

RTD4-

Wire

Thermistor


Yes Yes Yes Yes


Yes Yes Yes Yes


NotRecommended1

Yes No Yes


Parameters


<PLCs> Discrete {0.02|0.2|1|2|10|20|100|200}MIN=0.02PLC,MAX=200PLC

1PLC


asshown:





Remarks



IntegrationTime



4½Digits

15


5½Digits

18


5½Digits

20


6½Digits

21


6½Digits

24


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).


ReturnFormat


Examples

Thefollowingcommandsettheintegrationtimeto0.2PLCsonchannels03and13inslot100.

TEMP:NPLC0.2,(@103,113)


TEMP:NPLC?(@103,113)

TEMP:APER:ENAB?!Verifythataperturemodeis

disabled("0")


Syntax

[SENSe:]TEMPerature:RJUNction?[(@<ch_list>)]

Description

Thisqueryreturnsheinternalreferencejunctiontemperatureonthespecifiedchannels.Thisisusefulonlyforaninternalreferencesource).

Parameters



asshown:





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

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:



34908A40ChannelSingle-EndedMultiplexerModule(RTDonly;notFRTD)

Parameters


<mode> Boolean {OFF|0|ON|1} OFF|0

<ch_list> NumericOneormorechannels,asshown:





Remarks

Thiscommandappliesonlyto2-wireand4-wireRTDmeasurementsonthe100Ω,1kΩ,and10kΩranges.Onceenabled,offsetcompensationisappliedtoboth2-wireand4-wireRTDmeasurementsonthespecifiedchannels.



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

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:




Parameters


<reference> Numeric Anumber(ofohms)between49and2100.

100


asshown:





Remarks



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

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:




Parameters


<type> Discrete {85|91} Thisisarequiredparameter.


asshown:





Remarks


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.


(@202,204,301:305,308)

TypicalResponse:+85,+91,+85,+85,+85,+85,+85,+91

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:




Parameters


<state> Boolean {OFF|0|ON|1} Thisisarequiredparameter.ThefactorydefaultisOFF.


asshown:





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

Syntax

[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction{<temperature>|MIN|MAX}[,(@<ch_list>)]

[SENSe:]TEMPerature:TRANsducer:TCouple:RJUNction?[(@<ch_list>)]

Description

ThiscommandsetsthefixedreferencejunctiontemperatureindegreesCelsiusforthermocouplemeasurementsonthespecifiedchannels.

UsedWith:




Parameters


<temperature> Numeric AnumberrepresentingthetemperatureindegreesCelsius,from-20to+80.

Thisisarequiredparameter.Thefactorydefaultvalueis0.


asshown:





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

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:




Parameters


<type> Discrete {INTernal|EXTernal|FIXed} Thisisarequiredparameter.


asshown:





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

Syntax

[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE<type>[,(@<ch_list>)]

[SENSe:]TEMPerature:TRANsducer:TCouple:TYPE?[(@<ch_list>)]

Description

Thiscommandselectsthethermocoupletypetouseformeasurementsonthespecifiedchannels.

UsedWith:




Parameters


<type> Discrete {B|E|J|K|N|R|S|T} Thisisarequiredparameter.


asshown:





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

Syntax

[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE<type>[,(@<ch_list>)]

[SENSe:]TEMPerature:TRANsducer:THERmistor:TYPE?[(@<ch_list>)]

Description

Thiscommandselectsthethermistortypefortemperaturemeasurementsonthespecifiedchannels.

UsedWith:




Parameters


<type> Discrete {2252|5000|10000} Thisisarequiredparameter.


asshown:





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

Syntax

[SENSe:]TEMPerature:TRANsducer:TYPE{TCouple|RTD|FRTD|THERmistor|DEF}[,(@<ch_list>)]

[SENSe:]TEMPerature:TRANsducer:TYPE?[(@<ch_list>)]

Description

Thiscommandselectsthetemperaturetransducerprobetypetouseformeasurementsonthespecifiedchannels.



Wire

RTD4-

Wire

Thermistor


Yes Yes Yes Yes


Yes Yes Yes Yes


NotRecommended1

Yes No1 Yes


Parameters



asshown:





Remarks

ChoosingthetypeDEFisequivalenttochoosingTC.


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

Syntax

[SENSe:]TOTalize:CLEar:IMMediate[(@<ch_list>)]

Description

Thiscommandimmediatelyclearsthecountonthespecifiedcounter/totalizerchannels.

UsedWith:


Parameters







Example

Thefollowingcommandclearsthecountontotalizerchannel03onthemoduleinslot200.

TOT:CLEAR:IMM(@203)

Syntax

[SENSe:]TOTalize:DATA?[(@<ch_list>)]

Description

Thisqueryreadsthecountonthespecifiedtotalizerchannels.Ifyouhaveconfiguredthecounttoberesetwhenitisread(seeCONFigure:TOTalizeand[SENSe:]TOTalize:TYPEcommands),thenthiscommandwillresetthecountto0afteritisread.Thecountisresetregardlessofwhetherthespecifiedchannelsareinascanlistorevenwhetherascanisinprogress.

UsedWith:


Parameters







Remarks


TheoutputfromthiscommandisaffectedbythesettingsoftheFORMat:READingcommands.Dependingontheformatsselected,eachreadingmayormaynotbestoredwithmeasurementunits,timestamp,channelnumber,andalarmstatusinformation.

ReturnFormat

Thequeryreturnsanunsigneddecimalvaluerepresentingthecountoneachtotalizerchannelspecified(afull32-bitcountisreturned).Multipleresponsesareseparatedbycommas.

Example

Thefollowingqueryreadsthecountontotalizerchannel03onthemoduleinslot3.

TOT:DATA?(@303)

TypicalResponse:1.32130000E+03


CONFigure:TOTalize


Syntax

[SENSe:]TOTalize:SLOPe<edge>[,(@<ch_list>)]

[SENSe:]TOTalize:SLOPe?[(@<ch_list>)]

Description

Thiscommandconfiguresthespecifiedtotalizerchannelstocountontherisingedge(positive)orfallingedge(negative)oftheinputsignal.

UsedWith:


Parameters


<edge> Discrete {NEGative|POSitive} Thisisarequiredparameter.






Remarks

Theselectedslopeisstoredinvolatilememoryandwillbesetto"POS"whenpoweristurnedofforafteraFactoryReset(*RSTcommand).

ReturnFormat

ThequeryreturnsNEGorPOSforthespecifiedchannels.Multipleresponsesareseparatedbycommas.

Examples

Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot300tocountonthenegativeedge(falling)oftheinputsignal.

TOT:SLOPNEG,(@303)

Thefollowingqueryreturnstheedgesettingontotalizerchannel3onthemodulesinslots1and3.

TOT:SLOP?(@103,303)

TypicalResponse:NEG,NEG

Syntax

[SENSe:]TOTalize:STARt:IMMediate[(@<ch_list>)]

Description

Thiscommandimmediatelystartstotalizingonthespecifiedcounter/totalizerchannels.

UsedWith:


Parameters







Example

Thefollowingcommandstartstotalizingontotalizerchannel03onthemoduleinslot200.

TOT:STARt:IMM(@203)

Syntax

[SENSe:]TOTalize:STOP[:IMMediate][(@<ch_list>)]

Description

Thiscommandimmediatelystopstotalizingonthespecifiedcounter/totalizerchannels.

UsedWith:


Parameters







Example

Thefollowingcommandstopstotalizingontotalizerchannel03onthemoduleinslot200.

TOT:STOP:IMM(@203)

Syntax

[SENSe:]TOTalize:TYPE<mode>[,(@<ch_list>)]

[SENSe:]TOTalize:TYPE?[(@<ch_list>)]

Description

Thiscommandenablesordisablesanautomaticresetofthecountonthespecifiedtotalizerchannels.Toreadthetotalizerduringascanwithoutresettingthecount,selecttheREADparameter.Toreadthetotalizerduringascanandresetthecountto0afteritisread,selecttheRRESetparameter(thismeans"readandreset").

UsedWith:


Parameters


<mode> Discrete {READ|RRESet} Thisisarequiredparameter.






Remarks


ReturnFormat

ThequeryreturnsREADorRRESforthespecifiedchannels.Multipleresponsesareseparatedbycommas.

Examples

Thefollowingcommandconfigurestotalizerchannel03onthemoduleinslot300tobereadwithoutresettingitscount.

TOT:TYPEREAD,(@303)

Thefollowingqueryreturnsthetotalizersettingontotalizerchannel03onthemodulesinslots200and300.

TOT:TYPE?(@203,303)

TypicalResponse:READ,READ

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:




Parameters


<filter> Discrete {3|20|200} 20


asshown:





Remarks

ThiscommandappliestoACvoltagemeasurementsonly.

Forthe<filter>parameter,specifythelowestfrequencyexpectedintheinputsignalonthespecifiedchannels.Theinstrumentselectstheappropriatefilterbasedonthefrequencyyouspecify.

InputFrequency DefaultSettlingDelay

MinimumSettlingDelay

3Hzto300kHz(Slow)

7seconds/reading

1.5seconds


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

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:




Parameters


<range> DiscreteDesiredrangeinvolts:

100mV(MIN)1V10V100V300V(MAX)



asshown:





Remarks

Selectingadiscreterangewilldisableautorangingonthespecifiedchannels(see[SENSe:]VOLTage:AC:RANGe:AUTOcommand).




ReturnFormat

Thequeryreturnstherangeintheform"+1.00000000E+01"foreachchannelspecified.Multipleresponsesareseparatedbycommas.

Examples

Inthefollowingexamples,youcansubstitutethenodenameACforDC.

Thefollowingcommandselectsthe10voltrangeonchannels03and13inslot100.

VOLT:DC:RANG10,(@103,113)


VOLT:DC:RANG?(@103,113)


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:




Parameters



ThefactorydefaultisON.


asshown:





Remarks



100mV1V10V100V300V

Selectingadiscreterange(see[SENSe:]VOLTage:AC:RANGecommand)willdisableautorangingonthespecifiedchannels.



ReturnFormat


Examples

Ineachofthefollowingexamples,youcanreplacethenodenameACwithDC.

Thefollowingcommanddisablesautorangingonchannels03and13inslot100.

VOLT:AC:RANG:AUTOOFF,(@103,113)

Thefollowingqueryreturnstheautorangingsettingsonchannels03and13inslot100.

VOLT:AC:RANG:AUTO?(@103,113)

TypicalResponse:0,0

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:




Parameters


<time> Numeric Desiredaperturetimeinsecondsbetween300µsand1second,with4µsresolution.MIN=300µs,MAX=1second

Aperturedisabled.


asshown:





Remarks



TheCONFigure,MEASure?,[SENSe:]VOLTage[:DC]:NPLC,and[SENSe:]VOLTage[:DC]:RESolutioncommandsdisabletheaperturetimemode(thesecommandsselectanintegrationtimeinnumberofpowerlinecycles).


ReturnFormat


Examples


VOLT:DC:APER300E-03,(@103,113)


VOLT:DC:APER?(@103,113)VOLT:DC:APER:ENAB?!Verify

thataperturemodeisenabled("1")


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:




Parameters


<PLCs> Discrete {0.02|0.2|1|2|10|20|100|200|MIN|MAX} Thisisarequiredparameter.

<ch_list> ChannelList Oneormorechannels,asshown:





Remarks



IntegrationTime



4½Digits

15


5½Digits

18


5½Digits

20


6½Digits

21


6½Digits

24


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.



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

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:




Parameters


<resolution> Numeric Desiredresolutioninvolts. Thisisarequiredfield.Youmustspecifyanumeric<resolution>orspecifyMINorMAXtoselectthesmallestorlargest<resolution>.


asshown:





Remarks


Theinstrumentwilldispatchasettingsconflicterrorifyouissuethiscommandwhen[SENSe:]VOLTage:DC:RANGe:AUTOisONforoneormoreofthespecifiedchannels.


IntegrationTime



4½Digits

15


5½Digits

18


5½Digits

20


6½Digits

21


6½Digits

24


6½Digits

25

100PLC <0.0000003xRange

6½Digits

26

200PLC <0.00000022xRange

6½Digits

26

Youcanalsosettheintegrationtimebyspecifyinganaperturetime(see[SENSe:]VOLTage[:DC]:APERturecommand).However,notethatspecifyingintegrationtimeusingNPLCsexecutesfasterandoffersbetternoiserejectioncharacteristicsforvaluesofNPLCgreaterthan1.



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

Syntax

[SENSe:]ZERO:AUTO<mode>[,(@<ch_list>)]

[SENSe:]ZERO:AUTO?[(@<ch_list>)]

Description

Thiscommandenables(default)ordisablestheautozeromodeonthespecifiedchannels.

Parameters


<mode> Discrete {OFF|ONCE|ON} Thisisarequiredparameter.


asshown:





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

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


<data> Numeric Anintegerfrom0to255(:BYTE)or65,535(:WORD).







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)


SeeAlsoSOURceSubsystemIntroduction

Syntax

SOURce:DIGital:STATe?(@<ch_list>)

Description

Thiscommandreturnsthestatus(inputoroutput)ofthespecifieddigitalchannels.

UsedWith:

34907AMultifunctionModule(digitalI/Ochannelsonly)

Parameters







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


SOURce:VOLTage

Syntax

SOURce:VOLTage<voltage>,(@<ch_list>)

SOURce:VOLTage?(@<ch_list>)

Description

ThiscommandsetstheoutputvoltagelevelforthespecifiedDACchannelsonthe34907AMultifunctionModule.

ThiscommandoutputsaDCvoltagelevel.

Parameters


<voltage> NumericAnumberofvoltsfrom-12to+12,inresolutionof0.001V.

0Vdc


DACchannels,asshown:




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)


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:PRESet

STATus:QUEStionable:CONDition?


STATus:QUEStionable:ENABle?


Syntax


Description

ThiscommandqueriestheconditionregisterfortheAlarmRegistergroup(notethatthisconditionregisterusesonlybit4).Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.

UsedWith:





Remarks

Thefollowingtableliststhebitdefinitionsforthealarmenableregister.

Bit# BitName DecimalValue

Definition

0-3 NotUsed 1-8 0isreturned.

4 QueueNotEmpty

16 Thealarmqueueisnotempty.

5 NotUsed 32 0isreturned.

6 Alarm1 64 Alarm1istriggered.




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?


SeeAlsoSTATusSubsystemIntroduction

STATus:ALARm:ENABle


SYSTem:ALARm?

Syntax

STATus:ALARm:ENABle<enable_val>


Description

ThiscommandenablesbitsintheenableregisterfortheAlarmRegistergroup.TheselectedbitsarethenreportedtotheStatusByte.

UsedWith:





Parameters


DefaultValue

<enable_val> Numeric Anintegerfrom0to65535,specifyingthealarmstoenableasabitsum.


Remarks

Thefollowingtableliststhebitdefinitionsforthealarmenableregister.


Definition

0 Alarm1 1 AneventhasoccurredonAlarm1.




4 QueueNotEmpty


5 QueueOverflow 32Analarmqueueoverfloweventhasoccurred.





10-11

NotUsed 1024-2048 0isreturned.



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

Syntax


Description

ThiscommandqueriestheeventregisterfortheAlarmRegistergroup.

UsedWith:





Remarks

Thefollowingtableliststhebitdefinitionsforthealarmeventregister.


Definition





4 QueueNotEmpty


5 QueueOverflow 32Analarmqueueoverfloweventhasoccurred.





10-11 NotUsed 1024-2048 0isreturned.



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



STATus:ALARm:ENABle

Syntax


Description

ThiscommandqueriestheconditionregisterfortheStandardOperationRegistergroup.Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.


UsedWith:





Remarks

Theconditionregisterbitsreflectthecurrentcondition.Ifaconditionisnolongertrue,thecorrespondingbitisclearedintheconditionregister.

ThefollowingtableliststhebitdefinitionsfortheStandardOperationRegister.

Bit#


Definition

0 Calibrating 1 Theinstrumentiscalibrating.

1 SelfTest 2 Theinstrumentisdoingaself-test.

2 NotUsed 4 (Alwaysreturns0)


4 Scanning 16 Theinstrumentisscanning.

5 WFT 32 Theinstrumentiswaitingforatrigger.


7 USBMSDdetected

128 AUSBmassstoragedevice(USBdrive)hasbeendetected.

8 ConfigChanged

256 Theinstrumentconfigurationhaschanged.


10 InstrumentLocked

1024 Theinstrumentislocked.



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?


Syntax

STATus:OPERation:ENABle<enable_val>


Description

ThiscommandenablesbitsintheenableregisterfortheStandardOperationRegistergroup.TheselectedbitsarethenreportedtotheStatusByte.


UsedWith:





Parameters


DefaultValue

<enable_val> Numeric Anintegerfrom0to65535,specifyingthebitstoenableasabitsum.


Remarks


Bit#


Definition








7 USBMSDdetected


8 ConfigChanged


9 MemThreshold

512 Thenumberofreadingsinmemoryhasexceededthememorythresholdsetting(seeDATA:POINts:EVENt:THReshold).

10 InstrumentLocked


11 SettingsChanged

2048 Theinstrument'ssettingshavechanged.





Usethe<enable_value>parametertospecifywhichbitswillbereportedtotheStatusByte.Thedecimalvaluespecifiedcorrespondstothebinary-weightedsumofthebitsyouwishtoenableintheregister.Forexample,toenablebit0(decimalvalue=1)andbit10(decimalvalue=1024),thecorrespondingdecimalvaluewouldbe1024(1+1024).


ReturnFormat

Thequerycommandreadstheenableregisterandreturnsadecimalvaluecorrespondingtothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit0(decimalvalue=1)andbit10(decimalvalue=1024)areenabled,thequerycommandwillreturn+1025.

Examples


STAT:OPER:ENAB512


STAT:OPER:ENAB?


Syntax


Description

ThiscommandqueriestheconditionregisterfortheStandardOperationRegistergroup.Thisisaread-destructiveregisterandthebitsareclearedwhenyoureadtheregister.


UsedWith:





Remarks


Bit#


Definition








7 USBMSDdetected


8 ConfigChanged


9 MemThreshold

512 Thenumberofreadingsinmemoryhasexceededthememorythresholdsetting(seeDATA:POINts:EVENt:THReshold).

10 InstrumentLocked


11 SettingsChanged

2048 Theinstrument'ssettingshavechanged.






Thisregisterisclearedwhenitisread,orwhenyouissuea*CLScommand.

ReturnFormat

Thequeryreadstheoperationeventregisterandreturnsadecimalvaluewhichcorrespondstothebinary-weightedsumofallbitssetintheregister(seetableabove).Forexample,ifbit1(decimalvalue=2)andbit9(decimalvalue=512)areset,thiscommandwillreturn"+514".

Examples

Thefollowingcommandreadsthequestionableeventregister(bits1and9areset).

STAT:OPER?


Syntax

STATus:PRESet

Description

ThiscommandclearsallbitsintheQuestionableDataenableregister,theAlarmenableregister,andtheStandardOperationenableregister.

Example

Thefollowingcommandclearsallbitsintheregisterslistedabove.

STATus:PRESet

Syntax


Description

ThiscommandqueriestheconditionregisterfortheQuestionableDataRegistergroup.Thisisaread-onlyregisterandthebitsarenotclearedwhenyoureadtheregister.


UsedWith:





Remarks

Theconditionregisterbitsreflectthecurrentcondition.Ifaconditionisnolongertrue,thecorrespondingbitisclearedintheconditionregister.

ThefollowingtableliststhebitdefinitionsfortheQuestionableDataRegister.


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?


Syntax

STATus:QUEStionable:ENABle<enable_val>


Description

ThiscommandenablesbitsintheenableregisterfortheQuestionableDataRegistergroup.TheselectedbitsarethenreportedtotheStatusByte.


UsedWith:





Parameters


DefaultValue

<enable_val> Numeric Anintegerfrom0to65535,specifyingthebitstoenableasabitsum.


Remarks


Bit#


Definition

0 VoltageOverload

1 Theinstrumenthasexperiencedavoltageoverload.

1 CurrentOverload

2 Theinstrumenthasexperiencedacurrentoverload.








9 ResOverload 512 Theinstrumenthasexperiencedaresistanceoverload.

10 TemperatureOverload

1024 Theinstrumenthasexperiencedatemperatureoverload.



12 MemoryOverflow





Usethe<enable_value>parametertospecifywhichbitswillbereportedtotheStatusByte.Thedecimalvaluespecifiedcorrespondstothebinary-weightedsumofthebitsyouwishtoenableintheregister.Forexample,toenablebit0(decimalvalue=1)andbit10(decimalvalue=1024),thecorrespondingdecimalvaluewouldbe1025(1+1024).


The*RSTcommandhasnoeffectonthisregister.

ReturnFormat

Thequerycommandreadstheenableregisterandreturnsadecimalvaluecorrespondingtothebinary-weightedsumofallbitssetintheregister.Forexample,ifbit0(decimalvalue=1)andbit10(decimalvalue=1024)areenabled,thequerycommandwillreturn+1025.

Examples


STAT:QUES:ENAB512


STAT:QUES:ENAB?


Syntax


Description

ThiscommandqueriestheconditionregisterfortheQuestionableDataRegistergroup.Thisisaread-destructiveregisterandthebitsareclearedwhenyoureadtheregister.


UsedWith:





Remarks


Bit#


Definition

0 VoltageOverload

1 Theinstrumenthasexperiencedavoltageoverload.

1 CurrentOverload

2 Theinstrumenthasexperiencedacurrentoverload.








9 ResOverload 512 Theinstrumenthasexperiencedaresistanceoverload.

10 TemperatureOverload

1024 Theinstrumenthasexperiencedatemperatureoverload.



12 MemoryOverflow





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?


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.

Syntax

SYSTem:COMMunicate:LAN:CONTrol?

Description

Thisqueryreturnsthecontrolconnectionportnumberforsocketcommunications.

Remarks

Thisqueryisonlyusedwhenprogrammingoversockets.

YoucanusethecontrolsocketconnectiontosendaDeviceCleartotheinstrumentortodetectpendingServiceRequest(SRQ)events.

Thisqueryalwaysreturns0ifnotsentfromasocketconnection.

ReturnFormat

Thequeryreturnsthecontrolconnectionportnumber.If0isreturned,theinterfacedoesnotsupportaSocketControlconnection.

Examples

Thefollowingqueryreturnsthecontrolconnectionportnumber.

SYST:COMM:LAN:CONT?


SeeAlsoLANConfigurationIntroduction

Syntax

SYSTem:COMMunicate:LAN:DHCP<mode>


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


DefaultValue


Remarks

MostsiteLANshaveaDHCPserver.

IfaDHCPLANaddressisnotassignedbyaDHCPserver,thenanAutoIPaddressstaticIPwillbeassumedafterapproximatelytwominutes.

TheDHCPsettingisstoredinnon-volatilememory,anddoesnotchangewhenpowerhasbeenoff,afteraFactoryReset(*RSTcommand),orafteranInstrumentPreset(SYSTem:PRESetcommand).

Thequeryreturnsthecurrentsettingonly.ThismaydifferfromwhatwasjustsetifyouhavenotyetexecutedaSYSTem:COMMunicate:LAN:UPDatecommand.

ReturnFormat


Examples

ThefollowingcommanddisablesDHCP.

SYST:COMM:LAN:DHCPOFFSYST:COMM:LAN:UPDate

ThefollowingqueryreturnsthecurrentDHCPsetting.

SYST:COMM:LAN:DHCP?

TypicalResponse:0

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


<address> QuotedString

Specifiedinfour-bytedotnotation("nnn.nnn.nnn.nnn"),where"nnn"ineachcaseisabytevalueintherange0through255.


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"

Syntax


Description

Thisqueryreturnsthecurrentnetworkdomain.

Remarks

IftheinstrumenthasaDNSserver,itlooksupitsdomainname.

ReturnFormat

ThequeryreadsthedomainnameandreturnsanASCIIstringenclosedindoublequotes.Ifadomainnamehasnotbeenassigned,anullstring("")isreturned.

Examples

Thefollowingqueryreturnsthedomainnamecurrentlybeingusedbytheinstrument(thequotesarealsoreturned).

SYST:COMM:LAN:DOM?

TypicalResponse:"example.com"

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





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"


Thefollowingqueryreturnsthegatewaycurrentlybeingusedbytheinstrument(thequotesarealsoreturned).

SYST:COMM:LAN:GATEway?CURR


Syntax

SYSTem:COMMunicate:LAN:HOSTname"<name>"

SYSTem:COMMunicate:LAN:HOSTname?[{CURRent|STATic}]

Description

Thiscommandassignsahostnametotheinstrument.Thehostnameisthehostportionofthedomainname,whichistranslatedintoanIPaddress.

Ifyouchangethehostname,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.

Parameters


<name> QuotedASCIIString

Astringofupto45characters.Thefirstcharactermustbealetter(A-Z),buttheremaining44characterscanbeletters,numbers(0-9),ordashes("-").Blankspacesarenotallowed.


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"


Thefollowingqueryreturnsthehostnamecurrentlybeingusedbytheinstrument(thequotesarealsoreturned).

SYST:COMM:LAN:HOST?CURRorSYST:COMM:LAN:HOST?

TypicalResponse:"LAB1-34970A"

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





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"


ThefollowingqueryreturnstheIPaddresscurrentlybeingusedbytheinstrument(thequotesarealsoreturned).

SYST:COMM:LAN:IPAD?CURR


Syntax


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"

Syntax

SYSTem:COMMunicate:LAN:SMASk"<mask>"

SYSTem:COMMunicate:LAN:SMASk?[{CURRent|STATic}]

Description

ThiscommandassignsaSubnetMaskfortheinstrument.TheinstrumentusestheSubnetMasktodeterminewhetheraclientIPaddressisonthesamelocalsubnet.WhenaclientIPaddressisonadifferentsubnet,allpacketsmustbesenttotheDefaultGateway.ContactyournetworkadministratortodeterminewhethersubnettingisbeingusedandforthecorrectSubnetMask.

Ifyouchangethesubnetmask,youmustexecuteaSYSTem:COMMunicate:LAN:UPDatecommandtoactivatethesetting.

Parameters


<mask> QuotedString



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"


Thefollowingqueryreturnsthesubnetmaskcurrentlybeingusedbytheinstrument(thequotesarealsoreturned).

SYST:COMM:LAN:SMAS?CURRorSYST:COMM:LAN:SMAS?


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


<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>"

Syntax


Description

ThiscommandupdatesalloftheLANchanges.ItdisconnectsallactiveLANandWebconnectionsandrestartstheLANinterface,possiblywithanewIPaddress,dependingonhowyourinstrument'sIPaddressisassigned.

Remarks

Executingthiscommandisnecessarytomakethefollowingcommandstakeeffect:







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"


Syntax

SYSTem:ALARm?

Description

Thisqueryreadsthealarmdatafromthealarmqueue(onealarmeventisreadanddeletedfromthequeueeachtimethiscommandisexecuted).Arecordofupto20alarmscanbestoredintheinstrument'salarmqueue.

UsedWith:





Remarks


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):


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

Syntax

SYSTem:CPON<slot>

Description

Thiscommandresetsthemoduleinthespecifiedslottoitspower-onstate(CPONmeans"cardpoweron").SeeFactoryResetStateforacompletelistingoftheinstrument'sFactoryconfiguration.

Parameters


<slot> Discrete {100|200|300|ALL} Thisisarequiredparameter.

Remarks

Thevariousmodulecardsareaffectedasfollows:

Module Effect

34901A Ifanychannelisconfiguredforameasurement,thiscommandhasnoeffect.Ifnochannelisconfigured,thiscommandopensallchannels.


34903A Thiscommandopensallchannels.

34904A Thiscommandopensallchannels.

34905A Thiscommandcloseschannels11and21.

34906A Thiscommandcloseschannels11and21.

34907A Thiscommandresetsallchannelsnotinvolvedinscantothepower-onstate.


ThiscommanddoesnotresettheinternalDMM.

TheinstrumentwillproduceanerrorifyouareactivelyscanningandtrytoexecuteaSYSTem:CPONforacardthatisinvolvedinthescan.

Toresetthemodulesinallthreeslotsintheinstrument,usetheALLkeywordshownabove.

Example

Thefollowingcommandresetsthemoduleinslot200.

SYST:CPON200


SYSTem:PRESet

*RST

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


<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


SYSTem:CTYPe?

*IDN?

Syntax

SYSTem:DATE<yyyy>,<mm>,<dd>

SYSTem:DATE?

Description

Duringascan,theinstrumentstoresallreadingsandalarmswiththecurrenttimeanddate.Thiscommandsetstheinstrumentcalendar.

Parameters


DefaultValue

<yyyy> Numeric Thecurrentyear


<mm> Numeric Thecurrentmonth


<dd> Numeric Thecurrentdayofthecurrentmonth


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


SYSTem:TIME

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"


*SRE

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


SYSTem:LOCal

SYSTem:REMote

Syntax

SYSTem:LANGuage<language>

SYSTem:LANGuage?

Description

Thiscommandallowsyoutospecifywhethertheinstrumentshouldbehaveasa34970Aora34972A.

Parameters


<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"


*IDN?

SYSTem:CTYPe?

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

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


SYSTem:INTerface

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


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


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



(requestsuccessful)


<FROMUSB>SYST:LOCK:REL



State=unlocked,Count=0

Notethatforeachsuccessfullockrequest,alockreleaseisrequired.Tworequestsrequiretworeleases.


SYSTem:LOCK:OWNer?


Syntax


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


(requestsuccessful)


<FROMLAN>SYST:LOCK:REQ?returns+0

becauseUSBhaslock



(requestsuccessful)





State=unlocked,Count=0

Notethatforeachsuccessfullockrequest,alockreleaseisrequired.Tworequestsrequiretworeleases.


SYSTem:LOCK:OWNer?

SYSTem:LOCK:RELease

Syntax

SYSTem:PRESet

Description

Thiscommandpresetstheinstrumenttoaknownconfiguration.

Remarks

SeeInstrumentPresetStateforacompletelistingoftheinstrument’spresetstate.

ThiscommandisequivalenttoselectingPRESETfromthefront-panelSto/RclMenu.

Example

Thefollowingcommandreturnstheinstrumenttoitspresetstate.

SYST:PRES


*RST

SYSTem:CPON

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


*RST

Syntax

SYSTem:TIME<hh>,<mm>,<ss.sss>

SYSTem:TIME?

Description

Duringascan,theinstrumentstoresallreadingsandalarmswiththecurrenttimeanddate.Thiscommandsetstheinstrumentclock(basedona24-hourclock).

Parameters


DefaultValue

<hh> Numeric Thehourin24-hourclockformat,from0to23


<mm> Numeric Theminutes,from0to59


<ss.sss> Numeric Theseconds,with1msresolution,from00.000to59.999


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


SYSTem:DATE

SYSTem:TIME

Syntax

SYSTem:TIME:SCAN?

Description

Thisqueryreturnsthetimeatthestartofthescan.

UsedWith:





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


SYSTem:DATE

SYSTem:TIME

Syntax

SYSTem:VERSion?

Description

ThisqueryreturnstheversionoftheSCPI(StandardCommandsforProgrammableInstruments)standardwithwhichtheinstrumentisincompliance.TheinstrumentcomplieswiththerulesandconventionsoftheindicatedversionoftheSCPIstandard.

YoucannotquerytheSCPIversionfromthefrontpanel.

ReturnFormat

TheinstrumentreturnstheversionintheformYYYY.V,whereYYYYistheyearandVistheversionnumber.

Example

Thefollowingqueryreturnstheversionnumberofthesoftware.

SYST:VERS?

TypicalResponse:1994.0

TRIGgerSubsystemIntroduction

CommandSummaryTRIGger:COUNt

TRIGger:COUNt?

TRIGger:SOURce

TRIGger:SOURce?

TRIGger:TIMer

TRIGger:TIMer?

Syntax

TRIGger:COUNt{<count>|MIN|MAX|INFinity}

TRIGger:COUNt?

Description

Thiscommandspecifiesthenumberoftimestosweepthroughthescanlist.Asweepisonepassthroughthescanlist.Thescanstopswhenthenumberofspecifiedsweepshasoccurred.

UsedWith:





Parameters


DefaultValue

<count> NumericAnintegerfrom1to50,000triggers,orcontinuous(INFinity).

MIN=1

MAX=50,000


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?


SeeAlsoTRIGgerSubsystemIntroduction


ROUTe:SCAN

TRIGger:SOURce

TRIGger:TIMer

Syntax

TRIGger:SOURce<source>

TRIGger:SOURce?

Description

Selectthetriggersourcetocontroltheonsetofeachsweepthroughthescanlist(asweepisonepassthroughthescanlist).Theinstrumentwillacceptasoftware(bus)command,animmediate(continuous)scantrigger,anexternalTTLtriggerpulse,analarm-initiatedaction,oraninternallypacedtimer.

UsedWith:





Parameters


DefaultValue

<source> Discrete{BUS|IMMediate|EXTernal|ALARm1|ALARm2|ALARm3|ALARm4|TIMer}

IMMediate=ContinuousscantriggerBUS=SoftwaretriggerEXTernal=AnexternalTTLpulsetriggerALARm=TriggeronanalarmTIMer=Internallypacedtimertrigger


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


*TRG



ROUTe:MONitor:STATe

TRIGger:TIMer

Syntax

TRIGger:TIMer{<seconds>|MIN|MAX}

TRIGger:TIMer?[{MIN|MAX}]

Description

Thiscommandsetsthetrigger-to-triggerinterval(inseconds)formeasurementsonthechannelsinthepresentscanlist.Thiscommanddefinesthetimefromthestartofonetriggertothestartofthenexttrigger,uptothespecifiedtriggercount(seeTRIGger:COUNtcommand).

UsedWith:





Parameters


<seconds> NumericAnumberfrom0secondsto359,999with1msresolution.

MIN=0seconds,MAX=359,999seconds

Notethat359,999isonesecondlessthan100hours.


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?



TRIGger:COUNt

TRIGger:SOURce

CommandsA-ZA–C|D-L|M-R|S|T-W

AABORt

CCALCulate:AVERage:AVERage?









CALCulate:COMPare:DATA?


CALCulate:COMPare:MASK?


CALCulate:COMPare:STATe?


CALCulate:COMPare:TYPE?


CALCulate:LIMit:LOWer?


CALCulate:LIMit:LOWer:STATe?


CALCulate:LIMit:UPPer?


CALCulate:LIMit:UPPer:STATe?


CALCulate:SCALe:GAIN?


CALCulate:SCALe:OFFSet?



CALCulate:SCALe:STATe?


CALCulate:SCALe:UNIT?

CALibration?

CALibration:COUNt?




CALibration:STRing

CALibration:STRing?

CALibration:VALue

CALibration:VALue?

*CLS

CONFigure?




CONFigure:FREQuency


CONFigure:PERiod



CONFigure:TOTalize



DDATA:LAST?

DATA:POINts?

DATA:POINts:EVENt:THReshold


DATA:REMove?



DIAGnostic:PEEK:SLOT:DATA?

DIAGnostic:POKE:SLOT:DATA



DISPlay

DISPlay?

DISPlay:TEXT

DISPlay:TEXT?

DISPlay:TEXT:CLEar

E*ESE

*ESE?

*ESR?

FFETCh?





FORMat:READing:TIME




FORMat:READing:UNIT


I*IDN?

INITiate

INPut:IMPedance:AUTO

INPut:IMPedance:AUTO?

INSTrument:DMM

INSTrument:DMM?


LLXI:IDENtify[:STATe]

LXI:IDENtify[:STATe]?

LXI:RESet

LXI:RESTart

MMEASure:CURRent:AC?

MEASure:CURRent:DC?


MEASure:FREQuency?


MEASure:PERiod?

MEASure:RESistance?


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:VALid?

MMEMory:EXPort?






MMEMory:IMPort:CONFig?



O*OPC

*OPC?


OUTPut:ALARm:MODE

OUTPut:ALARm:MODE?

OUTPut:ALARm:SLOPe

OUTPut:ALARm:SLOPe?




P*PSC

*PSC?

RR?

*RCL

READ?



ROUTe:CHANnel:DELay

ROUTe:CHANnel:DELay?


ROUTe:CHANnel:DELay:AUTO?

ROUTe:CHANnel:FWIRe

ROUTe:CHANnel:FWIRe?

ROUTe:CLOSe

ROUTe:CLOSe?


ROUTe:DONE?

ROUTe:MONitor

ROUTe:MONitor?

ROUTe:MONitor:DATA?

ROUTe:MONitor:STATe


ROUTe:OPEN

ROUTe:OPEN?

ROUTe:SCAN

ROUTe:SCAN?

ROUTe:SCAN:SIZE?

*RST

S*SAV


[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:]FUNCtion

[SENSe:]FUNCtion?


[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:APERture

[SENSe:]TEMPerature:APERture?


[SENSe:]TEMPerature:NPLC?


[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated

[SENSe:]TEMPerature:TRANsducer:FRTD:OCOMpensated?


[SENSe:]TEMPerature:TRANsducer:FRTD:RESistance[:REFerence]?


[SENSe:]TEMPerature:TRANsducer:FRTD:TYPE?

[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated

[SENSe:]TEMPerature:TRANsducer:RTD:OCOMpensated?


[SENSe:]TEMPerature:TRANsducer:RTD:RESistance[:REFerence]?




[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:]TOTalize:SLOPe?




[SENSe:]TOTalize:TYPE?


[SENSe:]VOLTage:AC:RANGe?


[SENSe:]VOLTage:AC:RANGe:AUTO?


[SENSe:]VOLTage:AC:BANDwidth?


[SENSe:]VOLTage:DC:APERture?


[SENSe:]VOLTage:DC:NPLC?


[SENSe:]VOLTage:DC:RANGe?


[SENSe:]VOLTage:DC:RANGe:AUTO?


[SENSe:]VOLTage:DC:RESolution?

[SENSe:]ZERO:AUTO

[SENSe:]ZERO:AUTO?

SOURce:DIGital:DATA[:{BYTE|WORD}]

SOURce:DIGital:DATA[:{BYTE|WORD}]?


SOURce:VOLTage

SOURce:VOLTage?

*SRE

*SRE?


STATus:ALARm:ENABle







STATus:PRESet





*STB?

SYSTem:ALARm?





SYSTem:COMMunicate:LAN:DNS?



SYSTem:COMMunicate:LAN:GATEway?


SYSTem:COMMunicate:LAN:HOSTname?


SYSTem:COMMunicate:LAN:IPADdress?



SYSTem:COMMunicate:LAN:SMASk?

SYSTem:COMMunicate:LAN:TELNet:PROMpt


SYSTem:COMMunicate:LAN:TELNet:WMESsage



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:PRESet

SYSTem:REMote

SYSTem:RWLock


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?

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: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:REMove?<num_rdgs>

DIAGnosticSubsystem


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:CHANnel<mode>


FORMat:READing:TIME<mode>


FORMat:READing:TIME:TYPE<format>


FORMat:READing:UNIT<format>

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?


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:VALid?<location>

MMEMorySubsystem

MMEMory:EXPort?

MMEMory:FORMat:READing:CSEParator<column_separator>


MMEMory:FORMat:READing:RLIMit<row_limit>



MMEMory:IMPort:CONFig?"<configuration_file>"

MMEMory:LOG[:ENABle]<state>


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:MODE<mode>

OUTPut:ALARm:MODE?

OUTPut:ALARm:SLOPe<edge>

OUTPut:ALARm:SLOPe?


OUTPut:ALARm{1|2|3|4}:SOURce(@<ch_list>)


ROUTeSubsystem

ROUTe:CHANnel:ADVance:SOURce<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: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]?[(@<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]?[(@<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:ENABle<enable_val>




STATus:OPERation:ENABle<enable_val>



STATus:PRESet


STATus:QUEStionable:ENABle<enable_val>



SYSTEMSubsystem-LANConfiguration


SYSTem:COMMunicate:LAN:DHCP<mode>


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:SMASk"<mask>"

SYSTem:COMMunicate:LAN:SMASk?[{CURRent|STATic}]

SYSTem:COMMunicate:LAN:TELNet:PROMpt"<string>"


SYSTem:COMMunicate:LAN:TELNet:WMESsage"<string>"



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:PRESet

SYSTem:REMote

SYSTem:RWLock


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


Function NoChange

Range NoChange

Resolution NoChange

AdvancedSettings NoChange

TotalizerResetMode

CountNotResetWhenRead

TotalizerEdgeDetect

RisingEdge

ScanningOperations


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


34901A,34902A,34908A

AllChannelsOpen

34903A,34904A AllChannelsOpen

34905A,34906A Channelss11ands21Selected

34907A BothDIOPorts=Input,TotalizerCount=0,BothDACs=0VDC

System-RelatedOperations


DisplayState NoChange

ErrorQueue ErrorsNotCleared

StoredStates NoChange

34970A/34972AModuleDetailsThelinksbelowtakeyoutosummaryinformationfortheKeysight34970A/34972Aplug-inmodules.

34901A20-ChannelArmatureMultiplexer

34902A16-ChannelReedMultiplexer

34903A20-ChannelActuator/General-PurposeSwitch

34904A4x8Two-WireMatrixSwitch

34905A/34906ADual4-ChannelRFMultiplexers


34908A40-ChannelSingle-EndedMultiplexer

Keysight34901AModuleSummary

20-ChannelArmatureMultiplexer(2/4-wire)Module

SimplifiedSchematic

SCPICommandsUsed


















CONFigure?



CONFigure:FREQuency


CONFigure:PERiod







MEASure:CURRent:AC?

MEASure:CURRent:DC?

MEASure:FREQuency?


MEASure:PERiod?

MEASure:RESistance?


MEASure:VOLTage:AC?

MEASure:VOLTage:DC?

ROUTe:CHANnel:DELay


ROUTe:CHANnel:FWIRe

ROUTe:CLOSe


ROUTe:MONitor

ROUTe:MONitor:DATA?

ROUTe:OPEN

ROUTe:SCAN






















[SENSe:]ZERO:AUTO

SYSTem:CPON

SYSTem:CTYPe?

UNIT:TEMPerature


16-ChannelReedMultiplexer(2/4-wire)Module

SimplifiedSchematic

SCPICommandsUsedCALCulate:AVERage:AVERage?

















CONFigure?

CONFigure:FREQuency


CONFigure:PERiod







MEASure:FREQuency?


MEASure:PERiod?

MEASure:RESistance?


MEASure:VOLTage:AC?

MEASure:VOLTage:DC?

ROUTe:CHANnel:DELay


ROUTe:CHANnel:FWIRe

ROUTe:CLOSe


ROUTe:MONitor

ROUTe:MONitor:DATA?

ROUTe:OPEN

ROUTe:SCAN








































[SENSe:]ZERO:AUTO

SYSTem:CPON

SYSTem:CTYPe?

UNIT:TEMPerature


20-ChannelActuator/GPSwitchModule

SimplifiedSchematic

SCPICommandsUsedDIAGnostic:RELay:CYCLes?


ROUTe:CLOSe


ROUTe:OPEN

SYSTem:CPON

SYSTem:CTYPe?


4x8Two-WireMatrixModule

SimplifiedSchematic



ROUTe:CLOSe


ROUTe:OPEN

SYSTem:CPON

SYSTem:CTYPe?

Keysight34905A/34906AModuleSummary

2GHzDual1:4RFMux,50OhmModule(34905A)

2GHzDual1:4RFMux,75OhmModule(34906A)

SimplifiedSchematic



ROUTe:CLOSe


SYSTem:CPON

SYSTem:CTYPe?


MultifunctionModule

SimplifiedSchematic-DigitalInput/Output

SimplifiedSchematic-TotalizeInput

SimplifiedSchematic-AnalogOutput(DAC)

SCPICommandsUsedCALCulate:AVERage:AVERage?














CALibration?

CALibration:VALue

CONFigure?


CONFigure:TOTalize


MEASure:TOTalize?

ROUTe:CHANnel:DELay


ROUTe:MONitor

ROUTe:MONitor:DATA?

ROUTe:SCAN






SOURce:DIGital:DATA[:{BYTE|WORD}]


SOURce:VOLTage

SYSTem:CPON

SYSTem:CTYPe?


40ChannelSingle-EndedMultiplexerModule

SimplifiedSchematic

SCPICommandsUsed


















CALibration?

CONFigure?

CONFigure:FREQuency

CONFigure:PERiod







MEASure:FREQuency?

MEASure:PERiod?

MEASure:RESistance?


MEASure:VOLTage:AC?

MEASure:VOLTage:DC?

ROUTe:CHANnel:DELay


ROUTe:CHANnel:FWIRe

ROUTe:CLOSe


ROUTe:MONitor

ROUTe:MONitor:DATA?

ROUTe:OPEN

ROUTe:SCAN



































[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.

agilent 34970a/72a command reference · remarks if a scan is in progress when the command is...

Documents