IVI Class Driver Help for LabVIEW...IVI Class Driver Help for LabVIEW January 2007 Edition, Part Number 370036E-01 This help file contains technical and programming support for the

IVI™ClassDriverHelpforLabVIEW™January2007Edition,PartNumber370036E-01ThishelpfilecontainstechnicalandprogrammingsupportforthefollowingNationalInstrumentsInterchangeableVirtualInstrumentsclassdrivers:IviDCPwr,IviDmm,IviFgen,IviPwrMeter,RFSigGen,IviScope,IviSpecAn,andIviSwtch.ThishelpfilealsodescribesthefundamentalandadvancedterminologyfortheseIVIclassdrivers.ThishelpfileisintendedforusebydeveloperswithaworkingknowledgeofLabVIEW.ClickontheIVIclass-driverlibraryyouwanttoreferto:

IviDCPwrPowerSupply

IviDmmDigitalMultimeter IviFgenFunctionGenerator IviPwrMeterPowerMeter

IviRFSigGenRFSignalGenerator

IviSpecAnSpectrumAnalyzer

IviScopeOscilloscope IviSwtchSwitch

Tonavigatethishelpfile,usetheContents,Index,andSearchtabstotheleftofthiswindow.Formoreinformationaboutthishelpfile,refertothefollowingtopics:Conventions—formattingandtypographicalconventionsinthishelpfileRelatedDocumentationImportantInformationTechnicalSupportandProfessionalServicesTocommentonNationalInstrumentsdocumentation,refertotheNationalInstrumentsWebsite.©2000–2007NationalInstrumentsCorporation.Allrightsreserved.

UsingHelpConventionsNavigatingHelpSearchingHelpPrintingHelpFileTopics

ConventionsThishelpfileusesthefollowingconventions:

<> Anglebracketsthatcontainnumbersseparatedbyanellipsisrepresentarangeofvaluesassociatedwithabitorsignalname—forexample,DBIO<3..0>.

» The»symbolleadsyouthroughnestedmenuitemsanddialogboxoptionstoafinalaction.ThesequenceFile»PageSetup»OptionsdirectsyoutopulldowntheFilemenu,selectthePageSetupitem,andselectOptionsfromthelastdialogbox.Thisicondenotesanote,whichalertsyoutoimportantinformation.

bold Boldtextdenotesitemsthatyoumustselectorclickoninthesoftware,suchasmenuitemsanddialogboxoptions.Boldtextalsodenotesparameternames,emphasis,oranintroductiontoakeyconcept.

green Underlinedtextinthiscolordenotesalinktoahelptopic,helpfile,orWebaddress.

italic Italictextdenotesvariablesorcrossreferences.Thisfontalsodenotestextthatisaplaceholderforawordorvaluethatyoumustsupply.

monospace Textinthisfontdenotestextorcharactersthatyoushouldenterfromthekeyboard,sectionsofcode,programmingexamples,andsyntaxexamples.Thisfontisalsousedforthepropernamesofdiskdrives,paths,directories,programs,subprograms,subroutines,devicenames,functions,operations,variables,filenamesandextensions,andcodeexcerpts.

monospacebold

Boldtextinthisfontdenotesthemessagesandresponsesthatthecomputerautomaticallyprintstothescreen.Thisfontalsoemphasizeslinesofcodethataredifferentfromtheotherexamples.

NavigatingHelp(WindowsOnly)Tonavigatethishelpfile,usetheContents,Index,andSearchtabstotheleftofthiswindoworusethefollowingtoolbarbuttonslocatedabovethetabs:

Hide—Hidesthenavigationpanefromview.Locate—LocatesthecurrentlydisplayedtopicintheContentstab,allowingyoutoviewrelatedtopics.Back—Displaysthepreviouslyviewedtopic.Forward—DisplaysthetopicyouviewedbeforeclickingtheBackbutton.Options—Displaysalistofcommandsandviewingoptionsforthehelpfile.

PrintingHelpFileTopics(WindowsOnly)CompletethefollowingstepstoprintanentirebookfromtheContentstab:

1. Right-clickthebook.2. SelectPrintfromtheshortcutmenutodisplaythePrintTopics

dialogbox.3. SelectthePrinttheselectedheadingandallsubtopicsoption.

NoteSelectPrinttheselectedtopicifyouwanttoprintthesingletopicyouhaveselectedintheContentstab.

4. ClicktheOKbutton.

PrintingPDFDocumentsThishelpfilemaycontainlinkstoPDFdocuments.ToprintPDFdocuments,clicktheprintbuttonlocatedontheAdobeAcrobatViewertoolbar.

SearchingHelp(WindowsOnly)UsetheSearchtabtotheleftofthiswindowtolocatecontentinthishelpfile.Ifyouwanttosearchforwordsinacertainorder,suchas"relateddocumentation,"addquotationmarksaroundthesearchwordsasshownintheexample.SearchingfortermsontheSearchtaballowsyoutoquicklylocatespecificinformationandinformationintopicsthatarenotincludedontheContentstab.

WildcardsYoualsocansearchusingasterisk(*)orquestionmark(?)wildcards.Usetheasteriskwildcardtoreturntopicsthatcontainacertainstring.Forexample,asearchfor"prog*"liststopicsthatcontainthewords"program,""programmatically,""progress,"andsoon.Usethequestionmarkwildcardasasubstituteforasinglecharacterinasearchterm.Forexample,"?ext"liststopicsthatcontainthewords"next,""text,"andsoon.

NoteWildcardsearchingwillnotworkonSimplifiedChinese,TraditionalChinese,Japanese,andKoreansystems.

NestedExpressionsUsenestedexpressionstocombinesearchestofurtherrefineasearch.YoucanuseBooleanexpressionsandwildcardsinanestedexpression.Forexample,"exampleAND(programORVI)"liststopicsthatcontain"exampleprogram"or"exampleVI."Youcannotnestexpressionsmorethanfivelevels.

BooleanExpressionsClickthe buttontoaddBooleanexpressionstoasearch.ThefollowingBooleanoperatorsareavailable:

AND(default)—Returnstopicsthatcontainbothsearchterms.Youdonotneedtospecifythisoperatorunlessyouareusingnestedexpressions.OR—Returnstopicsthatcontaineitherthefirstorsecondterm.NOT—Returnstopicsthatcontainthefirsttermwithoutthesecondterm.NEAR—Returnstopicsthatcontainbothtermswithineightwordsofeachother.

SearchOptions

UsethefollowingcheckboxesontheSearchtabtocustomizeasearch:Searchpreviousresults—Narrowstheresultsfromasearchthatreturnedtoomanytopics.Youmustremovethecheckmarkfromthischeckboxtosearchalltopics.Matchsimilarwords—Broadensasearchtoreturntopicsthatcontainwordssimilartothesearchterms.Forexample,asearchfor"program"liststopicsthatincludethewords"programs,""programming,"andsoon.Searchtitlesonly—Searchesonlyinthetitlesoftopics.

IVIClassDriverHelpforLabVIEWOverviewThishelpfilecontainstechnicalandprogrammingsupportforthefollowingNationalInstrumentsInterchangeableVirtualInstrumentsclassdrivers:IviDCPwr,IviDmm,IviFgen,IviPwrMeter,RFSigGen,IviScope,IviSpecAn,andIviSwtch.ThisbookalsodescribesthefundamentalandadvancedterminologyfortheseIVIclassdrivers.ThetopicsincludedinthisbookareintendedforusebydeveloperswithaworkingknowledgeofLabVIEW.ClickontheIVIclass-driverlibraryyouwanttoreferto:

IviDCPwrPowerSupply

IviDmmDigitalMultimeter

IviFgenFunctionGenerator

IviPwrMeterPowerMeter

IviRFSigGenRFSignalGenerator

IviSpecAnSpectrumAnalyzer

IviScopeOscilloscope

IviSwtchSwitch

RelatedDocumentationThefollowingdocumentscontaininformationthatyoumightfindhelpfulasyouusethishelpfile:

ApplicationNotes—Alibrarywithmorethan100shortpapersaddressingspecifictopicssuchascreatingandcallingDLLs,developingyourowninstrumentdriversoftware,andportingapplicationsbetweenplatformsandoperatingsystems.Measurement&AutomationExplorerHelpforIVI—ThishelpfilediscusseshowtoconfigureyoursystemwithMAX.LabWindows/CVIInstrumentDriverDevelopersGuide—ThisdocumentdescribesguidelinesforwritinganIVIinstrumentdriver.Todownloadandusethisdocument,clickni.com/manuals,andsearchfortheLabWindows/CVIInstrumentDriverDevelopersGuide.IVIFoundation—ThiswebsiteprovidesinformationfromtheIVIFoundation,includingthespecificationsforeachinstrumentclass.

SampleProgramsTheIVIsampleprogramsforLabVIEWarelocatedintheLabVIEW\examples\instr\IviClass.llbdirectory.Thesampleprogramsarebasicexamplesofclassdriveroperations.Eachexampleallowsyoutointeractivelyconfigurethedevice.Someofthefrontpaneldefaultsettingsmightnotapplytoallinstruments.RefertotheVIandcontrolhelpofthespecificinstrumentdriverforadescriptionofvalidvaluesforyourinstrument.

IVIInherentCapabilitiesExpandthistopictoviewinherentVIsandProperties.

IVIInherentClassCapabilitiesOverviewThissectioncontainsinformationanddescriptionsforinherentdriverVIsthatallclassdriverssupport.ScrolldownforinformationaboutclassdriverinherentVIs.YoucancallanyoftheseinherentVIs.

IVIInherentVIsClass/PanelName VINameInitialize/CloseVIsInitialize ClassPrefixInitialize

InitializewithOptions ClassPrefixInitializeWithOptions

Close ClassPrefixClose

PropertyAccessInvalidateAllAttributes ClassPrefixInvalidateAllAttributes

ChannelAccessGetChannelName ClassPrefixGetChannelName

UtilityVIsReset ClassPrefixResetResetWithDefaults ClassPrefixResetWithDefaultsSelf-Test ClassPrefixSelf-Test

Disable ClassPrefixDisableRevisionQuery ClassPrefixRevisionQueryError-Query ClassPrefixError-QueryErrorMessage ClassPrefixErrorMessageCoercionGetNextCoercionRecord ClassPrefixGetNextCoercionRecordInterchangeabilityCheckingGetNextInterchangeWarning

ClassPrefixGetNextInterchangeWarning

ResetInterchangeCheck ClassPrefixResetInterchangeCheckClearInterchangeWarnings ClassPrefixClearInterchangeWarnings

RelatedTopicsIVIInherentPropertiesIVIStatusCodes

ClassPrefixClearInterchangeWarningsIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmClearInterchangeWarnings.TheclassdriverperformsinterchangeabilitycheckingiftheClassPrefixInterchangeCheckpropertyissettoTRUE.ThisVIclearsthelistofcurrentinterchangewarnings.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

ClassPrefixCloseIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmClose.

ThisVIperformsthefollowingoperations:

ClosestheinstrumentI/Osession.Destroystheinstrumentdriversessionandallofitsproperties.Deallocatesanymemoryresourcesthedriveruses.

NoteAftercallingClassPrefixClose,youcannotusetheinstrumentdriveragainuntilyoucallClassPrefixInitialize.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.errorin(noerror)UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

ClassPrefixDisableIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmDisable.

ThisVIplacestheinstrumentinaquiescentstatewhereithasminimalornoimpactonthesystemtowhichitisconnected.

ClassPrefixErrorMessageIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmErrorMessage.ThisVIconvertsastatuscodereturnedbyaninstrumentdriverintoauser-readablestring.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.ErrorCodePasstheStatusparameterthatisreturnedfromanyoftheinstrumentdriverVIs.DefaultValue:0(Noerror)

errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

ErrorMessageReturnsareadablemessagestringtoyouthat

correspondstothestatuscodeyouspecify.

ClassPrefixError-QueryIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmError-Query.

ThisVIqueriestheinstrumentandreturnstheinstrumentspecificerrorinformation.Generally,youcallthisVIafteranotherVIintheinstrumentdriverreturnstheIVI_ERROR_INSTRUMENT_STATUS(0xBFFA0001)errorcode.Thedriverreturnsthiserrorcodewhentheinstrument'sstatusregisterindicatesthattheinstrument'serrorqueueisnotempty.TheClassPrefixErrorQueryVIextractsthefirsterroroutoftheinstrument'serrorqueue.Forinstrumentsthathavestatusregistersbutnoerrorqueue,thedriversimulatesanerrorqueueinsoftware.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.errorcodeReturnstheerrorcodereadfromtheinstrument'serrorqueue.

errormessageReturnstheerrormessagestringreadfromtheinstrument'serrormessagequeue.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

ClassPrefixGetChannelNameIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmGetChannelName.

ThisVIreturnsthespecificdriverdefinedchannelnamethatcorrespondstotheone-basedindexthatyouspecify.IfthevalueyoupassfortheIndexparameterislessthanoneorgreaterthanthevalueoftheChannelCountproperty,thisVIreturnsanemptystringintheNameparameterandreturnsanerror.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.index(1)Aone-basedindexthatdefineswhichnametoreturn.TheindexmustbelessthanorequaltotheClassPrefixChannelCountproperty.instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

outputchannelnameReturnsthenameoftheChannelspecifiedbytheindexparameter.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.

Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

ClassPrefixGetNextCoercionRecordIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmGetNextCoercionRecord.

ThisVIobtainsthecoercioninformationassociatedwiththeIVIsession.Itretrievesandclearstheoldestinstanceinwhichthespecificdrivercoercedavalueyouspecifiedtoanothervalue.IfyousettheClassPrefixRecordValueCoercionspropertytoTRUE,thespecificdriverkeepsalistofallcoercionsitmakesonViInt32orViReal64valuesyoupasstoinstrumentdriverVIs.YouusethisVItoretrieveinformationfromthatlist.TheVIreturnsanemptystringintheCoercionRecordparameterifnocoercionrecordsremainforthesession.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.

coercionrecordReturnsthenextcoercionrecordfortheIVIsession.Iftherearenocoercionrecords,theVIreturnsanemptystring.

ClassPrefixGetNextInterchangeWarningIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmGetNextInterchangeWarning.

ThisVIreturnstheinterchangeabilitywarningsassociatedwiththeIVIsession.Itretrievesandclearstheoldestinstanceinwhichtheclassdriverrecordedaninterchangeabilitywarning.Interchangeabilitywarningsindicatethatusingyourapplicationwithadifferentinstrumentmightcausedifferentbehavior.UsethisVItoretrieveinterchangeabilitywarnings.Alternately,youmayuseNISpytoviewinterchangeabilitywarnings.Interchangeabilitycheckingexaminesthepropertiesinacapabilitygrouponlyifyouspecifyavalueforatleastonepropertywithinthatgroup.Ingeneral,theclassdrivergeneratesinterchangeabilitywarningswhenitencountersoneofthefollowingconditions:

Apropertythataffectsthebehavioroftheinstrumentisinastatethatyoudidnotspecify.Yousetaclass-definedpropertytoaninstrumentspecificvalue.Yousetthevalueofapropertythattheclassdriverdefinesasread-only.Theclassdriverencountersanerrorwhenittriestoapplyavaluetoanextensionpropertythatyourprogramneverconfigures.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.interchangewarningReturnsthenextinterchangewarningfortheIVIsession.Iftherearenointerchangewarnings,thisparameterreturnsanemptystring.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

RelatedTopics

InterchangeabilityChecking

ClassPrefixInitializeIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmInitializeWithOptions.

ThisVIperformsthefollowinginitializationactions:

CreatesanewIVIinstrumentdriversession.OpensasessiontothespecifieddeviceusingtheinterfaceandaddressyouspecifyfortheResourceNameparameter.IftheIDQueryparameterissettoTRUE,thisVIqueriestheinstrumentIDandchecksthatitisvalidforthisinstrumentdriver.IftheResetparameterissettoTRUE,thisVIresetstheinstrumenttoaknownstate.Sendsinitializationcommandstosettheinstrumenttothestatenecessaryfortheoperationoftheinstrumentdriver.ReturnsaninstrumenthandlethatyouusetoidentifytheinstrumentinallsubsequentinstrumentdriverVIcalls.

NoteThisVIcreatesanewsessioneachtimeyouinvokeit.AlthoughyoucanopenmorethanoneIVIsessionforthesameresource,itisbestnottodoso.Youcanusethesamesessioninmultipleprogramthreads.CautionAllIVInames,suchaslogicalnamesorvirtualnames,arecase-sensitive.Ifyouuselogicalnames,driversessionnames,orvirtualnamesinyourprogram,youmustmakesurethatthenameyouusematchesthenameintheIVIConfigurationStorefileexactly,withoutanyvariationsinthecaseofthecharactersinthename.logicalname("SampleFGen")Passesthelogicalnamethat

identifiestheparticulardriversessiontouse.Thedriversession,inturn,identifiesaspecificdriveranddeviceandspecifiestheinitialsettingsforthesession.Youconfigurethelogicalname,driversession,specificdriver,andhardwareassetwithMAX.Ifyouwanttouseyourprogramwithadifferentphysicalinstrument,youchangetheconfigurationofthelogicalnametousethedriversessionforthenewphysicalinstrument.Youcanchangetheinitialsettingsforthesessionbychangingtheconfigurationofthedriversession.DefaultValues:"SampleScope"forIviScope"SampleDmm"forIviDmm"SamplePower"forIviDCPwr"SampleSwitch"forIviSwtch"SampleFgen"forIviFgen

idquery(true)SpecifywhetheryouwanttheinstrumentdrivertoperformanIDQuery.

ValidRange:TRUE(1)PerformIDQuery(DefaultValue)FALSE(0)SkipIDQueryWhenyousetthisparametertoTRUE,thedriververifiesthattheinstrumentyouinitializeisatypethatthisdriversupports.CircumstancescanarisewhereitisundesirabletosendanIDQuerycommandstringtotheinstrument.WhenyousetthisparametertoFALSE,theVIinitializestheinstrumentwithoutperforminganIDQuery.

resetdevice(true)Specifywhetheryouwantthetoresettheinstrumentduringtheinitializationprocedure.

ValidRange:TRUE(1)ResetDevice(DefaultValue)FALSE(0)Don'tReset

errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.instrumenthandleoutTheinstrumentdriverthatyouusetoidentifytheinstrumentinallsubsequentinstrumentdriverVIcalls.Note

1. TheInitializeVIcreatesanewsessioneachtimeyouinvokeit.Thisisusefulifyouhavemultiplephysicalinstancesofthesametypeofinstrument.

2. Avoidcreatingmultipleconcurrentinstrumenthandlestothesamephysicalinstrument.Althoughyoucancreatemorethanoneinstrumentdriverhandleforthesameresource,itisbestnottodoso.

ClassPrefixInitializeWithOptionsIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmInitializeWithOptions.Details.

logicalname("SampleScope")Passesthelogicalnamethatidentifiestheparticulardriversessiontouse.Thedriversession,inturn,identifiesaspecificdriveranddeviceandspecifiestheinitialsettingsforthesession.Youconfigurethelogicalname,driversession,specificdriver,andhardwareassetwithMAX.Ifyouwanttouseyourprogramwithadifferentphysicalinstrument,youchangetheconfigurationofthelogicalnametousethedriversessionforthenewphysicalinstrument.Youcanchangetheinitialsettingsforthesessionbychangingtheconfigurationofthedriversession.DefaultValues:"SampleScope"forIviScope"SampleDmm"forIviDmm"SamplePower"forIviDCPwr"SampleSwitch"forIviSwtch"SampleFgen"forIviFgen

idquery(True)SpecifywhetheryouwanttheinstrumentdrivertoperformanIDQuery.ValidRange:TRUE(1)—PerformIDQuery(DefaultValue)FALSE(0)—SkipIDQueryWhenyousetthisparametertoTRUE,thedriververifiesthattheinstrumentyou

initializeisatypethatthisdriversupports.CircumstancescanarisewhereitisundesirabletosendanIDQuerycommandstringtotheinstrument.WhenyousetthisparametertoFALSE,theVIinitializestheinstrumentwithoutperforminganIDQuery.

resetdevice(True)Specifywhetheryouwantthetoresettheinstrumentduringtheinitializationprocedure.ValidRange:TRUE(1)—ResetDevice(DefaultValue)FALSE(0)—DonotReset

optionstring("Simulate=0,RangeCheck=0,QueryInstrStatus=0,Cache=1,InterchangeCheck=0")Youcanusethisparametertosettheinitialvalueofcertainpropertiesforthesession.Thefollowingtableliststhenameandthepropertiesyouuseinthisparametertoidentifytheproperty.

Name PropertyRangeCheck CLASSPREFIX_ATTR_RANGE_CHECKQueryInstrStatus CLASSPREFIX_ATTR_QUERY_INSTRUMENT_STATUSCache CLASSPREFIX_ATTR_CACHESimulate CLASSPREFIX_ATTR_SIMULATERecordCoercions CLASSPREFIX_ATTR_RECORD_COERCIONSInterchangeCheck CLASSPREFIX_ATTR_INTERCHANGE_CHECK

Theformatofthisstringis,"PropertyName=Value"wherePropertyNameisthenameofthepropertyandValueisthevaluetowhichthepropertywillbeset.Tosetmultipleproperties,separatetheirassignmentswithacomma.IfyoupassNULLoranemptystringforthisparameter,thesessionusesthedefaultvaluesfortheproperties.Youcanoverridethedefaultvaluesbyassigningavalueexplicitlyinastringyoupassforthisparameter.You

donothavetospecifyallofthepropertiesandmayleaveanyofthemout.Ifyoudonotspecifyoneoftheproperties,itsdefaultvaluewillbeused.Thedefaultvaluesforthepropertiesareshownbelow:

Name DefaultValueRangeCheck TRUEQueryInstrStatus FALSECache TRUESimulate FALSERecordCoercions FALSEInterchangeCheck FALSEDriverSetup ""

ThefollowingarevalidvaluesforViBooleanproperties:

True: 1,TRUE,orTRUEFalse: 0,False,orFALSEDefaultValue: ""

Anexampleoptionstring:"Simulate=0,RangeCheck=1,QueryInstStatus=0,Cache=1,Spy=0,InterchangeCheck=0"

NoteSpyingonIVIAPIcallswithinNI-SpyisafeaturethatisonlyavailableifyouhaveNI-Spyinstalledonyoursystem.NI-SpyisinstalledwithseveralNIsoftwarepackages.

instrumenthandleoutTheinstrumentdriverthatyouusetoidentifytheinstrumentinallsubsequentinstrumentdriverVIcalls.

1. ThisVIcreatesanewsessioneachtimeyouinvokeit,whichisusefulifyouhavemultiplephysicalinstancesofthesametypeofinstrument.

2. Avoidcreatingmultipleconcurrentinstrumenthandlestothesamephysicalinstrument.Althoughyoucancreatemorethanoneinstrumentdriverhandleforthesameresource,itisbestnottodoso.

erroroutTheerroroutclusterpasseserrororwarninginformation

outofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

ClassPrefixInitializeWithOptionsDetailsThisVIperformsthefollowinginitializationactions:

CreatesanewIVIinstrumentdriversession.OpensasessiontothespecificdriverusingthelogicalnameoftheIVIvirtualinstrument.IftheIDQueryparameterissettoTRUE,thisVIqueriestheinstrumentIDandchecksthatitisvalidforthisinstrumentdriver.IftheResetparameterissettoTRUE,thisVIresetstheinstrumenttoaknownstate.Sendsinitializationcommandstosettheinstrumenttothestatenecessaryfortheoperationoftheinstrumentdriver.ReturnsaninstrumenthandlethatyouusetoidentifytheinstrumentinallsubsequentinstrumentdriverVIcalls.

NoteThisVIcreatesanewsessioneachtimeyouinvokeit.AlthoughyoucanopenmorethanoneIVIsessionforthesameresource,itisbestnottodoso.Youcanusethesamesessioninmultipleprogramthreads.CautionAllIVInames,suchaslogicalnamesorvirtualnames,arecase-sensitive.Ifyouuselogicalnames,driversessionnames,orvirtualnamesinyourprogram,youmustmakesurethatthenameyouusematchesthenameintheIVIConfigurationStorefileexactly,withoutanyvariationsinthecaseofthecharactersinthename.

ClassPrefixInvalidateAllAttributesIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmInvalidateAllAttributes.

ThisVIinvalidatesthecachedvaluesofallpropertiesforthesession.

ClassPrefixResetIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmReset.

ThisVIresetstheinstrumenttoaknownstateandsendsinitializationcommandstotheinstrument.TheinitializationcommandssetinstrumentsettingssuchasHeadersOff,ShortCommandform,andDataTransferBinarytothestatenecessaryfortheoperationoftheinstrumentdriver.

ClassPrefixResetInterchangeCheckIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmResetInterchangeCheck.Details.

ClassPrefixResetInterchangeCheckDetailsWhendevelopingacomplextestsystemthatconsistsofmultipletestmodules,itisgenerallyagoodideatodesignthetestmodulessothat

theycanruninanyorder.Todosorequiresensuringthateachtestmodulecompletelyconfiguresthestateofeachinstrumentituses.Ifaparticulartestmoduledoesnotcompletelyconfigurethestateofaninstrument,thestateoftheinstrumentdependsontheconfigurationfromapreviouslyexecutedtestmodule.Ifyouexecutethetestmodulesinadifferentorder,thebehavioroftheinstrumentandthereforetheentiretestmoduleislikelytochange.Thischangeinbehaviorisgenerallyinstrumentspecificdriverandrepresentsaninterchangeabilityproblem.YoucanusethisVItotestforsuchcases.AfteryoucallthisVI,theinterchangeabilitycheckingalgorithmsinthespecificdriverignoreallpreviousconfigurationoperations.BycallingthisVIatthebeginningofatestmodule,youcandeterminewhetherthetestmodulehasdependenciesontheoperationofpreviouslyexecutedtestmodules.ThisVIdoesnotcleartheinterchangeabilitywarningsfromthelistofpreviouslyrecordedinterchangeabilitywarnings.IfyouwanttoguaranteethattheClassPrefixGetNextInterchangeWarningVIonlyreturnsthoseinterchangeabilitywarningsthataregeneratedaftercallingthisVI,youmustclearthelistofinterchangeabilitywarnings.YoucancleartheinterchangeabilitywarningslistbyrepeatedlycallingtheClassPrefixGetNextInterchangeWarningVIuntilnomoreinterchangeabilitywarningsarereturned.Ifyouarenotinterestedinthecontentofthosewarnings,youcancalltheClassPrefixClearInterchangeWarningsVI.

ClassPrefixResetWithDefaultsIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmResetWithDefaults.

ThisVIresetstheinstrumentandappliesinitialuser-specifiedsettingsfromtheLogicalNamewhichwasusedtoinitializethesession.

ClassPrefixRevisionQueryIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmRevisionQuery.

Obtainsthefollowinginformation:

Therevisionoftheinstrumentdriver.Thefirmwarerevisionoftheinstrumentyouarecurrentlyusing

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.instrumentdriverrevisionReturnstheinstrumentdriversoftwarerevisionnumbersintheformofastring.firmwarerevisionReturnstheinstrumentfirmwarerevisionnumbersintheformofastring.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.

ClassPrefixSelf-TestIVIInherentFunctionToformtheClassPrefixVIname,usetheprefixoftheclassdriverthatyouareworkingwith.Forexample,ifyouareworkingwiththeIviDmmclassdriver,usetheprefixIviDmmtocreatethecorrectVIname,IviDmmSelf-Test.

ThisVIrunstheinstrument'sself-testroutineandreturnsthetestresult(s).

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheClassPrefixInitializeorClassPrefixInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.selftestresultThiscontrolcontainsthevaluereturnedfromtheinstrumentselftest.Zeromeanssuccess.Foranyothercode,refertothedevice'soperatormanual.Numericresultfromself-testoperation:0=noerror(testpassed)non-zero=testfailed

self-testmessageReturnstheself-testresponsestringfromthe

instrument.Refertothedevice'sdocumentationforanexplanationofthestring'scontents.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

InherentPropertiesNoteYouaccesspropertiesthroughtheLabVIEWPropertyNode.

IVIInherentPropertiesAdvancedSessionInformationLogicalNameResourceDescriptorDriverSetup

ClassDriverIdentificationDescriptionPrefixVendorRevisionSpecificationMajorVersionSpecificationMinorVersion

InstrumentIdentificationManufacturerModelFirmwareRevision

SpecificDriverCapabilitiesSupportedInstrumentModelsGroupCapabilitiesFunctionCapabilitiesChannelCount

SpecificDriverIdentificationDescriptionLocatorPrefixRevisionMajorVersionMinorVersion

VendorUserOptionsRangeCheckQueryInstrumentStatusCacheSimulateRecordValueCoercionsInterchangeCheckSpyUseSpecificSimulation

ClassPrefixAttributeCapabilitiesInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionThispropertyisacomma-separatedstringthatidentifiestheclasspropertiesthatthespecificinstrumentdriverimplements.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverCapabilities»AttributeCapabilities

ClassPrefixCacheInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhethertocachethevalueofproperties.Whencachingisenabled,thespecificdriverkeepstrackofthecurrentinstrumentsettingssothatitcanavoidsendingredundantcommandstotheinstrument.Statecachingcansignificantlyincreaseexecutionspeed.Youspecifyavalueforthispropertyfortheentireinstrumentdriver.However,thespecificdrivercanoverridethisvalueforaparticularproperty.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»ClassCache

ClassPrefixChannelCountInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsthenumberofavailablechannels.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»ChannelCount

ClassPrefixClassDriverDescriptionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsabriefdescriptionoftheclassdriver.PropertyNodePathClassPrefix»InherentIVISettings»ClassDriverIdentification»Description

ClassPrefixClassDriverPrefixInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnstheprefixfortheclassinstrumentdriver.Theprefixcanbeamaximumof31characters.Thenameofeachuser-callableVIintheclassdriverbeginswiththisprefix.Forexample,ifaclassdriverhasauser-callableVInamedIviDmmInitialize,thenIviDmmistheprefixforthatdriver.PropertyNodePathClassPrefix»InherentIVISettings»ClassDriverIdentification»ClassDriverPrefix

ClassPrefixClassDriverRevisionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsastringthatcontainsadditionalversioninformationaboutthespecificinstrumentdriver.Thereturnedvaluecontainsdriverprefixandversion.Italsocontainsversioninformationforcompilerandcomponentsusedinthedriverbuildprocess.PropertyNodePathClassPrefix»InherentIVISettings»ClassDriverIdentification»Revision

ClassPrefixClassDriverVendorInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsthenameofthevendorthatsuppliestheclassdriver.PropertyNodePathClassPrefix»InherentIVISettings»ClassDriverIdentification»ClassDriverVendor

ClassPrefixClassSpecificationMajorVersionInherentPropertyDataType Access Applies-to Coercion HighLevelFunctions

RO N/A None None

DescriptionSpecifiesthemajorversionnumberoftheIVIclassspecificationwithwhichtheclassdriveriscompliant.PropertyNodePathClassPrefix»InherentIVISettings»ClassDriverIdentification»ClassSpecificationMajorVersion

ClassPrefixClassSpecificationMinorVersionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnstheminorversionnumberoftheclassinstrumentdriver.PropertyNodePathClassPrefix»InherentIVISettings»ClassDriverIdentification»MinorVersion

ClassPrefixDriverSetupInherentPropertyDataType Access Applies

to Coercion HighLevelFunctions

RO N/A None ClassPrefixInitializeWithOptions

DescriptionThispropertyreturnstheDriverSetupstringthatyouspecifiedwheninitializingthedriver.Somecasesexistwhereyoumightspecifytheinstrumentdriveroptionsatinitializationtime.Anexampleofthisisspecifyingaparticularinstrumentmodelfromamongafamilyofinstrumentsthatthedriversupports.Thisisusefulwhenusingsimulation.Youcanspecifydriver-specificoptionsthroughtheDriverSetupkeywordintheoptionStringparametertotheClassPrefixInitializeWithOptionsVIorthroughMAX.IfyoudonotspecifyaDriverSetupstring,thispropertyreturnsanemptystring.PropertyNodePathClassPrefix»InherentIVISettings»DriverSetup

ClassPrefixFirmwareRevisionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None ClassPrefixRevisionQuery

DescriptionReturnsaninstrumentspecificstringthatcontainsthefirmwarerevisioninformationofthephysicalinstrument.Whensimulating,thespecificdriverreturnsthevalue.PropertyNodePathClassPrefix»InherentIVISettings»InstrumentIdentification»FirmwareRevision

ClassPrefixFunctionCapabilitiesInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionThispropertyisacomma-separatedstringthatidentifiestheclassfunctionsthatthespecificinstrumentdriverimplements.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverCapabilities»FunctionCapabilities

ClassPrefixGroupCapabilitiesInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionThispropertyisacomma-separatedstringthatidentifiestheinstrumentclassandtheclass-extensiongroupsthatthespecificinstrumentdriverimplements.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverCapabilities»GroupCapabilities

ClassPrefixInterchangeCheckInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhetherthedriverperformsinterchangeabilitychecking.Whenthispropertyisenabled,theclassdriverkeepsalistoftheinterchangeabilitywarningsitencounters.YouviewtheinterchangeabilitywarningswithNISpy.Alternatively,youcancallClassPrefixGetNextInterchangeWarningVItoextractanddeletetheoldestrecordfromthelist.

NoteIfClassPrefixInterchangeCheckissettoTRUEandyouarenotusingNISpy,theinterchangecheckqueueisclearedbycallingClassPrefixGetNextInterchangeWarningVI.Ifyoudonotclearthequeue,theresultinglistbuild-upappearsasamemoryleak.

ThedefaultvalueisFALSE.YoucanoverridethisvaluebyspecifyingavaluewithMAX.YoucancleartheinterchangeabilitywarninglistbycallingtheClassPrefixClearInterchangeWarningsVI.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»InterchangeCheck

ClassPrefixLogicalNameInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionYoupassalogicalnametotheclassdriverinitializationVI.MAXmustcontainanentryforthelogicalname.ThelogicalnameentryreferstoadriversessioninMAX.Thedriversessionspecifiesaphysicaldeviceandaspecificinstrumentdriver.ByassigningthenameofadifferentdriversessiontothelogicalnameinMAX,youcanexchangeoneinstrumentforanotherwithoutmodifyingorrecompilingyourLabVIEWapplication.ThispropertyindicatesthelogicalnameyouspecifiedwhenopeningthecurrentIVIsession.PropertyNodePathClassPrefix»InherentIVISettings»AdvancedSessionInformation»LogicalName

ClassPrefixManufacturerInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsthenameofthemanufactureroftheinstrument.PropertyNodePathClassPrefix»InherentIVISettings»InstrumentIdentification»Manufacturer

ClassPrefixModelInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsthemodelnumberornameofthephysicalinstrument.PropertyNodePathClassPrefix»InherentIVISettings»InstrumentIdentification»Model

ClassPrefixQueryInstrumentStatusInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhetherthespecificdriverqueriestheinstrumentstatusaftereachVIcall.Queryingtheinstrumentstatusisusefulfordebugging.Aftervalidatingtheprogram,youcansetthispropertytoFALSEtodisablestatuscheckingandmaximizeperformance.Youspecifyavalueforthispropertyfortheentireinstrumentdriver.However,thedrivercanoverridethisvalueforaparticularproperty.ThedefaultvalueisFALSE.YoucanoverridethisvaluebyspecifyingavaluewithMAXorbyinitializingtheIVIsessionwiththeClassPrefixInitializeWithOptionsVI.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»QueryInstrumentStatus

ClassPrefixRangeCheckInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhethertovalidatepropertyvaluesandVIparameters.Rangecheckingparametersisveryusefulfordebugging.Aftervalidatingtheprogram,youcansetthispropertytoFALSEtodisablerangecheckingandmaximizeperformance.ThedefaultvalueisTRUE.YoucanoverridethisvaluebyspecifyingavaluewithMAXorbyinitializingtheIVIsessionwiththeClassPrefixInitializeWithOptionsVI.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»RangeCheck

ClassPrefixRecordValueCoercionsInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhethertheIVIEnginekeepsalistofthevaluecoercionsitmakesfor and properties.Whenthispropertyisenabled,theclassdrivermaintainsarecordofeachcoercion.YouviewthecoercionrecordswithNISpy.Alternately,youcallClassPrefix_GetNextCoercionRecordVItoextractanddeletetheoldestcoercionrecordfromthelist.ThedefaultvalueisFALSE.YoucanoverridethisvaluebyspecifyingavaluewithMAXorbyinitializingtheIVIsessionwiththeClassPrefixInitializeWithOptionsVI.

NoteIfClassPrefixRecordValueCoercionsissettoTRUEandyouarenotusingNISpy,thecoercionqueueisclearedbycallingClassPrefixGetNextCoercionInfo.Ifyoudonotclearthequeue,theresultinglistbuild-upappearsasamemoryleak.

PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»RecordValueCoercions

ClassPrefixResourceDescriptorInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnstheresourcedescriptorthatthedriverusestoidentifythephysicaldevice.Ifyouinitializethedriverwithalogicalnamethatisassociatedwithadevice,thispropertycontainstheresourcedescriptorthatcorrespondstotheentryinMAX.PropertyNodePathClassPrefix»InherentIVISettings»AdvancedSessionInformation»ResourceDescriptor

ClassPrefixSimulateInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhethertosimulateinstrumentdriverI/Ooperations.Ifsimulationisenabled,specificdriverVIsperformrangechecking,buttheydonotperforminstrumentI/O.TheclassdriverreturnssimulateddataforoutputVIparameters.ThedefaultvalueisFALSE.YoucanoverridethisvaluebyspecifyingavaluewiththeMAXorbyinitializingtheIVIsessionwiththeClassPrefixInitializeWithOptionsVI.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»Simulate

ClassPrefixSpecificDriverClassSpecificationMajorVersionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsthemajorversionnumberoftheIVIclassspecificationwithwhichthespecificdriveriscompliant.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»ClassSpecificationMajorVersion

ClassPrefixSpecificDriverClassSpecificationMinorVersionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnstheminorversionnumberoftheIVIclassspecificationwithwhichthespecificdriveriscompliant.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»ClassSpecificationMinorVersion

ClassPrefixSpecificDriverDescriptionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsabriefdescriptionofthespecificdriver.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»Description

ClassPrefixSpecificDriverLocatorInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnstheinformationthattheclassdriverusestofindthespecificdrivermodule.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»SpecificDriverLocator

ClassPrefixSpecificDriverPrefixInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionThenameofeachuser-callablefunctioninthespecificdriverbeginswiththisprefix.Forexample,iftheFluke45driverhasauser-callablefunctionnamed"FL45_init",then"FL45"istheprefixforthatdriver.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»SpecificDriverPrefix

ClassPrefixSpecificDriverRevisionInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsastringthatcontainsadditionalversioninformationaboutthespecificinstrumentdriver.Thereturnedvaluecontainsdriverprefixandversion.Italsocontainsversioninformationforcompilerandcomponentsusedinthedriverbuildprocess.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»Revision

ClassPrefixSpecificDriverVendorInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsthenameofthevendorthatsuppliesthespecificdriverPropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverIdentification»SpecificDriverVendor

ClassPrefixSpyInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhethertheclassdriverusesNISpytorecordcallstoclassdriverVIs.ThedefaultvalueisTRUE.YoucanoverridethisvaluebyinitializingtheIVIsessionwiththeClassPrefixInitializeWithOptionsVI.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»Spy

ClassPrefixSupportedInstrumentModelsInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

RO N/A None None

DescriptionReturnsacomma-separatedlistthatidentifiestheinstrumentmodelswithwhichthespecificdriveriscompatible.PropertyNodePathClassPrefix»InherentIVISettings»SpecificDriverCapabilities»SupportedInstrumentModels

ClassPrefixUseSpecificSimulationInherentPropertyDataType Access Appliesto Coercion HighLevelFunctions

R/W N/A None None

DescriptionSpecifieswhethertheclassdriverorthespecificdrivergeneratesthesimulationdataforoutputparameters.AvalueofFALSEspecifiesthattheclassdrivergeneratesthesimulationdataforoutputparameters.AvalueofTRUEspecifiesthatthespecificdrivergeneratesthesimulationdataforoutputparameters.ThedefaultvalueisFALSE.YoucanoverridethisvaluebyspecifyingavaluewithMAX.PropertyNodePathClassPrefix»InherentIVISettings»UserOptions»UseSpecificSimulation

InterchangeabilityCheckingInterchangeabilitywarningsindicatethatusingyourapplicationwithadifferentinstrumentmightcausedifferentbehavior.UsetheClassPrefixGetNextInterchangeWarningVItoretrieveinterchangeabilitywarnings.Alternately,youmayuseNISpytoviewinterchangeabilitywarnings.Interchangeabilitycheckingisperformedonacapabilitygroupbasis.Whenenabled,interchangeabilitycheckingisalwaysperformedonthebasecapabilitygroup.Interchangeabilitycheckingisperformedonextensioncapabilitygroupswhenyouhavesetavalueforanypropertyinthegroup.Ifyouneversetthevalueofanypropertyofanextensioncapabilitygroup,interchangeabilitycheckingisnotperformedonthatgroup.Ingeneral,interchangeabilitywarningsaregeneratedifthefollowingconditionsareencountered:

Apropertythataffectsthebehavioroftheinstrumentisnotinastatethatyouspecify.Thiscanhappenifyourprogramdoesnotconfigurethepropertyorifyourprogramconfiguresthepropertybutthevaluebecomesinvalidasaresultofyourprogramconfiguringadifferentproperty.Yousetorgetaninstrumentspecificproperty.YousetanpropertyforwhichtheIVIclassspecificationdefinesvaluestoaninstrumentspecificvalue.YoupassaninstrumentspecificvaluetoaVIparameterforwhichtheIVIclassspecificationdefinesvalues.Youattempttosetanpropertythattheclassdefinesasread-only.Insomecasestheclassdriversdefineread-onlypropertiesthatspecificdriversmightimplementasread/write.Theclassdriverencountersanerrorwhenittriestodisableanextensioncapabilitygroupthatyourprogramdoesnotuse.Thepurposeofdisablingunusedextensiongroupsistomakeyourprogrambehavethesameregardlessofwhethertheinstrumentsyouuseimplementtheextensioncapabilitygroup.Someinstrumentsthatimplementtheextensioncapabilitygroupmightnotsupportthevaluetowhichtheclassdriverattemptstosettheproperty.Inthiscase,theclassdriverqueuesaninterchangeabilitywarninginsteadofreturninganerrorfromtheVI.

RelatedTopicsClassPrefixClearInterchangeWarningsClassPrefixGetNextInterchangeWarningClassPrefixResetInterchangeCheckClickthefollowinglinkstolearnmoreaboutinterchangeabilitycheckingforaparticularIVIclassdriver.IviDCPwrDCPowerSupplyIviDmmDigitalMultimeterIviFgenFunctionGeneratorIviPwrMeterPowerMeterIviRFSigGenRFSignalGeneratorIviScopeOscilloscopeIviSpecAnSpectrumAnalyzerIviSwtchSwitch

IviDCPwrInterchangeabilityTheIviDCPwrclassdriverperformsinterchangeabilitycheckingwhentheIviDCPwrInterchangeCheckpropertyissettoTRUEandyoucalloneofthefollowingVIs:IviDCPwrInitiateIviDCPwrMeasure

Inadditiontothegeneralinterchangeabilitycheckingrules,theIviDCPwrclassdefinesadditionalrulesandexceptionsforeachcapabilitygroup.

IviDCPwrTrigger ThedriverneedstoperforminterchangeabilitycheckingonthisgrouponlywhentheVIperforminginterchangeabilitycheckingisIviDCPwrInitiate.

TheIviDCPwrclassdoesnotdefineadditionalinterchangeabilityrulesorexceptionsforthefollowingextensioncapabilitygroups:IviDCPwrBase,IviDCPwrSoftwareTrigger,andIviDCPwrMeasurement.

IviDmmInterchangeabilityTheIviDmmclassdriverperformsinterchangeabilitycheckingwhentheIviDmmInterchangeCheckpropertyissettoVI_TRUEandyoucalloneofthefollowingVIs:IviDmm_InitiateIviDmm_ReadIviDmm_ReadMultiPointInadditiontothegeneralinterchangeabilitycheckingrules,theIviDmmclassdefinesadditionalrulesandexceptionsforeachcapabilitygroup.

IviDmmBase IftheIviDmmFunctionpropertyissettoIVIDMM_VAL_TEMPERATURE,theIviDmmResolutionpropertyisnotrequiredtobeinauser-specifiedstate.

IviDmmACMeasurement

IftheIviDmmFunctionpropertyissettoIVIDMM_VAL_AC_VOLTS,IVIDMM_VAL_AC_CURRENT,IVIDMM_VAL_AC_PLUS_DC_VOLTS,orIVIDMM_VAL_AC_PLUS_DC_CURRENT,thenthefollowingpropertiesarerequiredtobeinauser-specifiedstate:

IviDmmACMinimumFrequencyIviDmmACMaximumFrequency

IviDmmFrequencyMeasurement

IftheIviDmmFunctionpropertyissettoIVIDMM_VAL_FREQorIVIDMM_VAL_PERIOD,thentheIviDmmFrequencyVoltageRangepropertyisrequiredtobeinauser-specifiedstate.

IviDmmTemperatureMeasurement

IftheIviDmmFunctionpropertyissettoIVIDMM_VAL_TEMPERATURE,theIviDmmTransducerTypepropertyisrequiredtobeinauser-specifiedstate.

IviDmmThermocouple

IftheIviDmmTransducerTypepropertyissettoIVIDMM_VAL_THERMOCOUPLE,thefollowingpropertiesarerequiredtobeinauser-specifiedstate:

IviDmmThermocoupleType

IviDmmReferenceJunctionTypeIviDmmFixedReferenceJunction

IviDmmResistanceTemperatureDevice

IftheIviDmmTransducerTypepropertyissettoIVIDMM_VAL_2_WIRE_RTDorIVIDMM_VAL_4_WIRE_RTD,thenthefollowingpropertiesarerequiredtobeinauser-specifiedstate:

IviDmmRTDAlphaIviDmmRTDResistance

IviDmmThermistor

IftheIviDmmTransducerTypepropertyissettoIVIDMM_VAL_THERMISTOR,theIviDmmThermistorResistancepropertyisrequiredtobeinauser-specifiedstate.

IviDmmMultiPoint

IftheIviDmmSampleCountpropertyissetto1,thenIviDMMSampleTriggerpropertyisnotrequiredtobeinauser-specifiedstate.IftheIviDmmSampleCountpropertyissetto1ortheIviDmmSampleTriggerpropertyissettoavalueotherthanIVIDMM_VAL_INTERVAL,thentheIviDmmSampleIntervalpropertyisnotrequiredtobeinauser-specifiedstate.

TheIviDmmclassdoesnotdefineadditionalinterchangeabilityrulesorexceptionsforthefollowingextensioncapabilitygroups:IviDmmSoftwareTrigger,IviDmmDeviceInfo,IviDmmAutoRangeValue,IviDmmAutoZero,andIviDmmPowerLineFrequency.

IviFgenInterchangeabilityTheIviFGenclassdriverperformsinterchangeabilitycheckingwhentheIviFgenInterchangeCheckpropertyissettoTRUEandyoucalltheIviFgenInitiateGenerationVI.Inadditiontothegeneralinterchangeabilitycheckingrules,theIviFgenclassdefinesadditionalrulesandexceptionsforeachcapabilitygroup.

IviFgenStdFunc IftheIviFgenOutputModepropertyisnotsettoIVIFGEN_VAL_OUTPUT_FUNC,nopropertiesintheIviFgenStdFuncextensiongrouparerequiredtobeinauser-specifiedstate.IftheIviFgenOutputEnabledpropertyissettoFALSEonachannel,nopropertiesintheIviFgenStdFuncextensiongrouparerequiredtobeinauser-specifiedstateonthatchannel.IftheIviFgenWaveformpropertyissettoIVIFGEN_VAL_WFM_DConachannel,thefollowingpropertiesarenotrequiredtobeinauser-specifiedstateonthatchannel:

IviFgenFuncAmplitudeIviFgenFrequencyIviFgenStartPhase

IftheIviFgenWaveformpropertyissettoIVIFGEN_VAL_WFM_SQUAREonachannel,theIviFgenDutyCycleHighpropertyisrequiredtobeinauser-specifiedstateonthatchannel.

IviFgenArbWaveform

IftheIviFgenOutputModepropertyisnotsettoIVIFGEN_VAL_OUTPUT_ARB,nopropertiesintheIviFgenArbWaveformextensiongrouparerequiredtobeinauser-specifiedstate.IftheIVIFGEN_ATTR_OUTPUT_ENABLEDpropertyissettoFALSEonachannel,nopropertiesintheIviFgenArbWaveformextensiongrouparerequiredtobeinauser-specifiedstateonthatchannel.

IviFgenArb IftheIviFgenOutputModepropertyisnotsetto

Sequence IVIFGEN_VAL_OUTPUT_SEQ,nopropertiesintheIviFgenArbSequenceextensiongrouparerequiredtobeinauser-specifiedstate.IftheIviFgenOutputEnabledpropertyissettoFALSEonachannel,nopropertiesintheIviFgenArbSequenceextensiongrouparerequiredtobeinauser-specifiedstateonthatchannel.

IviFgenTrigger IftheIviFgenOperationModepropertyisnotsettoIVIFGEN_VAL_OPERATE_BURST,nopropertiesintheIviFgenTriggerextensiongrouparerequiredtobeinauser-specifiedstate.

IviFgenInternalTrigger

IftheIviFgenTriggerSourcepropertyisnotsettoIVIFGEN_VAL_INTERNAL_TRIGGER,nopropertiesintheIviFgenInternalTriggerextensiongrouparerequiredtobeinauser-specifiedstate.

IviFgenBurst IftheIviFgenOperationModepropertyisnotsettoIVIFGEN_VAL_OPERATE_BURST,nopropertiesintheIviFgenBurstextensiongrouparerequiredtobeinauser-specifiedstate.IftheIviFgenOutputEnabledpropertyissettoFALSEonachannel,nopropertiesintheIviFgenBurstextensiongrouparerequiredtobeinauser-specifiedstateonthatchannel.

IviFgenModulateAM

IftheIviFgenOutputEnabledpropertyissettoFALSEonachannel,nopropertiesintheIviFgenModulateAMextensiongrouparerequiredtobeinauser-specifiedstateonthatchannel.IftheIviFgenAMEnabledpropertyisnotsettoTRUEonachannel,theIviFgenAMSourcepropertyisnotrequiredtobeinauser-specifiedstateonthatchannel.IftheIviFgenAMSourceisnotsettoIviFgenAMInternalonatleastonechannel,thefollowing

propertiesarenotrequiredtobeinauser-specifiedstate.

IviFgenAMInternalDepthIviFgenAMInternalWaveformIviFgenAMInternalFrequency

IviFgenModulateFM

IftheIviFgenOutputEnabledpropertyissettoFALSEonachannel,nopropertiesintheIviFgenModulateFMextensiongrouparerequiredtobeinauser-specifiedstateonthatchannel.IftheIviFgenFMEnabledpropertyisnotsettoTRUEonachannel,theIviFgenFMSourcepropertyisnotrequiredtobeinauser-specifiedstateonthatchannel.IftheIviFgenFMSourceisnotsettoIviFgenFMInternalonatleastonechannel,thefollowingpropertiesarenotrequiredtobeinauser-specifiedstate.

IviFgenFMInternalDeviationIviFgenFMInternalWaveformIviFgenFMInternalFrequency

TheIviFgenclassdoesnotdefineadditionalinterchangeabilityrulesorexceptionsforthefollowingextensioncapabilitygroups:IviFgenBase,IviFgenSoftwareTrigger.

IviPwrMeterInterchangeabilityTheIviPwrMeterclassdriverperformsinterchangeabilitycheckingwhentheIVIPWRMETER_ATTR_INTERCHANGE_CHECKpropertyissettoVI_TRUEandyoucalloneofthefollowingVIs:

IviPwrMeter_InitiateIviPwrMeter_ReadIviPwrMeter_ReadChannel

Inadditiontothegeneralinterchangeabilitycheckingrules,theIviRFSigGenclassdefinesadditionalrulesandexceptionsforthefollowingcapabilitygroups.

IviPwrMeterManualRange

Supportspowermetersthatcanmanuallyspecifytheupperandlowerlimitsofthemeasurementrange.TheIviPwrMeterManualRangeextensioncapabilityalsoincludesVIsforconfiguringthemeasurementrange.

IviPwrMeterInternalTrigger

Supportspowermetersthatcantriggerinternallyonthemeasurementsignal.Itspecifiestoconfiguretheinternaltriggereventsource,triggerlevel,andthetriggerslope.AlsoincludesVIsforconfiguringtheseproperties.

IviPwrMeterSoftwareTrigger

Supportspowermetersthatcaninitiateameasurementbasedonasoftwaretriggersignal.Youcansendasoftwaretriggertocausethepowermetertotriggerameasurement.

IviPwrMeterAveragingCount

Supportspowermetersthatcanfilterasignalbyaveragingitaspecifiednumberoftimesinmanualaveragingmode.TheIviPwrMeterAveragingCountgroupdefinesapropertyandVItospecifytheaveragingcount.

TheIviPwrMeterclassdoesnotdefineadditionalinterchangeabilityrulesorexceptionsforthefollowingextensioncapabilitygroups:IviPwrMeterChannelAcquisition IviPwrMeterTriggerSource IviPwrMeterDutyCycleCorrectionIviPwrMeterZeroCorrection IviPwrMeterCalibration IviPwrMeterReferenceOscillator

IviRFSigGenInterchangeabilityTheIviRFSigGenclassdriverperformsinterchangeabilitycheckingwhentheIVIRFSIGGEN_ATTR_INTERCHANGE_CHECKpropertyissettoVI_TRUEandyoucalloneofthefollowingVIs:IviRFSigGen_IsSettledandIviRFSigGen_WaitUntilSettled.Inadditiontothegeneralinterchangeabilitycheckingrules,theIviRFSigGenclassdefinesadditionalrulesandexceptionsforeachcapabilitygroup.

IviRFSigGenModulateAM

IftheIVIRFSIGGEN_ATTR_OUTPUT_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulateAMextensiongroupneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_AM_SOURCEpropertyisnotsettoanexternalmodulationsource,theIVIRFSIGGEN_ATTR_AM_EXTERNAL_COUPLINGpropertydoesneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_AM_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulateAMextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenModulateFM

IftheIVIRFSIGGEN_ATTR_OUTPUT_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulateFMextensiongroupneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_FM_SOURCEpropertyisnotsettoanexternalmodulationsource,thepropertiesIVIRFSIGGEN_ATTR_FM_EXTERNAL_COUPLINGdoesneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_FM_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulateFMextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenModulatePM

IftheIVIRFSIGGEN_ATTR_OUTPUT_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulatePMextensiongroupneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_FM_SOURCEpropertyisnotsettoanexternalmodulationsource,theIVIRFSIGGEN_ATTR_PM_EXTERNAL_COUPLINGpropertydoesneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_PM_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulatePMextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenModulatePulse

IftheIVIRFSIGGEN_ATTR_OUTPUT_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulatePulseextensiongroupneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_PULSE_MODULATION_SOURCEpropertyisnotsettoExternal,allotherpropertiesintheIviRFSigGenModulatePulseextensiongroupneednotbeinauser-specifiedstate.IftheIVIRFSIGGEN_ATTR_FM_ENABLEDpropertyissettoFalse,propertiesintheIviRFSigGenModulateFMextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenLFGenerator

IftheLFGeneratorOutputEnabledpropertyissettoTrueORIfLFGeneratorOutputEnabledpropertyissettoTrueANDoneofthefollowingsourcesincludesaninternalsource

AMSourceFMSourcePMSource

ANDanyofthefollowingaresettoTrueAMEnabledFMEnabledPMEnabled

thenthepropeteriesintheIviRFSigGenLFGeneratorextensiongroupshallbeinauser-specifiedstate.

IviRFSigGenLFGeneratorOutput

IftheLFGeneratorOutputEnabledpropertyissettoFalse,theLFGeneratorOutputAmplitudepropertyneednotbeinauser-specifiedstate.

IviRFSigGenPulseGenerator

IfthePulseOutputEnabledpropertyissettoTrueOutputEnabledsettoTrueANDthePulseGeneratorSourceissettoInternalANDthePulseModulationEnabledpropertyissettoTrue,thepropertiesintheIviRFSigGenPulseGeneratorextensiongroupshallbeinauser-specifiedstate.IfthePulseTriggerSourcepropertyisnotsettoInternal,thePulseInternalTriggerPeriodpropertyneednotbeinauser-specifiedstate.IfthePulseTriggerSourcepropertyisnotsettoExternal,thePulseExternalTriggerDelaypropertyandthePulseExternalTriggerSlopepropertyneednotbeinauser-specifiedstate.

IviRFSigGenPulseDoubleGenerator

IfthePulseDoubleEnabledpropertyissettoFalse,propertiesintheIviRFSigGenPulseDoubleGeneratorextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenPulseGeneratorextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenPulseDoubleGenerator

extensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenPulseGeneratorOutput

IfthePulseOutputEnabledpropertyissettoFalse,allotherpropertiesintheIviRFSigGenPulseGeneratorOutputextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenSweep

IftheSweepModepropertyissettoNone,allotherpropertiesintheIviRFSigGenSweepextensiongroupneednotbeinauser-specifiedstate.

IftheOutputEnabledpropertyissettoFalse,allthepropertiesintheIviRFSigGenSweepextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenFrequencySweep

IftheSweepModepropertyisnotsettoFrequencySweep,propertiesintheIviRFSigGenFrequencySweepextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenSweepextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiestheIviRFSigGenFrequencySweepextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenPowerSweep

IftheSweepModepropertyisnotsettoPowerSweep,intheIviRFSigGenPowerSweepextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenSweepextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenPowerSweepextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenFrequencyStep

IftheSweepModepropertyisnotsettoFrequencyStep,propertiesintheIviRFSigGenFrequencyStepextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenSweepextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiestheIviRFSigGenFrequencyStepextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenPowerStep

IftheSweepModepropertyisnotsettoPowerStep,propertiesintheIviRFSigGenPowerStepextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenSweepextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenPowerStepextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenList

IftheSweepModepropertyisnotsettoList,propertiesintheIviRFSigGenListextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenSweepextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenListextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenALC

IftheALCEnabledpropertyissettoFalse,propertiestheIviRFSigGenALCextensiongroupneednotbeinauser-specifiedstate.IftheOutputEnabledpropertyissettoFalse,allthepropertiesintheIviRFSigGenALCextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenReferenceOscillator

IftheOutputEnabledpropertyissettoFalse,allthepropertiesintheIviRFSigGenReferenceOscillatorextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenSoftwareTrigger

NoadditionalinterchangeabilityrulesorexceptionsaredefinedfortheIviRFSigGenSoftwareTriggercapabilitygroup.

IviRFSigGenModulateIQ

IftheOutputEnabledpropertyissettoFalse,propertiesintheIviRFSigGenModulateIQextensiongroupneednotbeinauser-specifiedstate.IftheIQEnabledpropertyissettoFalse,propertiestheIviRFSigGenModulateIQextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenIQImpairment

IftheIQImpairmentEnabledpropertyissettoFalse,propertiesintheIviRFSigGenIQImpairmentextensiongroupneednotbeinauser-specifiedstate.IftheIviRFSigGenModulateIQextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenIQImpairmentextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenArbGenerator

IftheIQSourcepropertyisnotsettoArbGenerator,propertiesintheIviRFSigGenArbGeneratorextensiongroupneednotbeinauser-specifiedstate.IftheArbTriggerSourcepropertyisnotsettoExternal,propertiestheArbExternalTriggerSlopepropertyneednotbeinauser-specifiedstate.IftheIviRFSigGenModulateIQextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenArbGeneratorextension

groupneednotbeinauser-specifiedstate.

IviRFSigGenDigitalModulationBase

IftheOutputEnabledpropertyissettoFalse,propertiesintheIviRFSigGenDigitalModulationBaseextensiongroupneednotbeinauser-specifiedstate.IftheIQSourcepropertyisnotsettoDigitalModulationBase,propertiesintheIviRFSigGenDigitalModulationBaseextensiongroupneednotbeinauser-specifiedstate.IftheDigitalModulationBaseClockSourcepropertysettoExternal,theExternalClockTypepropertynotbeinauser-specifiedstate.IftheDigitalModulationBaseDataSourcepropertysettoPRBS,theDigitalModulationBasePRBSTypepropertyneednotbeinauser-specifiedstate.IftheDigitalModulationBaseDataSourcepropertyisnotsettoBitSequence,theDigitalModulationBaseSelectedBitSequencepropertyneednotbeinauser-specifiedstate.IftheIviRFSigGenModulateIQextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenDigitalModulationBaseextensiongroupneednotbeinauser-specifiedstate

IviRFSigGenCDMABase

IftheOutputEnabledpropertyissettoFalse,propertiesintheIviRFSigGenCDMABaseextensiongroupneednotbeinauser-specifiedstate.IftheIQSourceattributeisnotsettoCDMABase,propertiesintheIviRFSigGenCDMABaseextensiongroupneednotbeinauser-specifiedstate.IftheCDMAClockSourceisnotsettoExternal,theCDMAExternalTriggerSlopepropertyneednotbeinauser-specifiedstate.

IftheIviRFSigGenModulateIQextensiongroupdoesneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenCDMABaseextensiongroupneednotbeinauser-specifiedstate.

IviRFSigGenTDMABase

IftheOutputEnabledpropertyissettoFalse,propertiesintheIviRFSigGenTDMABaseextensiongroupneednotbeinauser-specifiedstate.IftheIQSourcepropertyisnotsettoTDMABase,propertiesintheIviRFSigGenTDMABaseextensiongroupneednotbeinauser-specifiedstate.IftheTDMAClockSourcepropertyisnotsettoExternal,theTDMAExternalTriggerSlopepropertyneednotbeinauser-specifiedstate.IftheIviRFSigGenModulateIQextensiongroupdoesnotneedtobecheckedforinterchangeability,thenpropertiesintheIviRFSigGenTDMABaseextensiongroupneednotbeinauser-specifiedstate.

TheIviRFSigGenclassdoesnotdefineadditionalinterchangeabilityrulesorexceptionsforthefollowingextensioncapabilitygroups:IviRFSigGenAnalogModulationSourceandIviRFSigGenSoftwareTrigger.

IviScopeInterchangeabilityTheIviScopeclassdriverperformsinterchangeabilitycheckingwhentheIviScopeInterchangeCheckpropertyissettoTRUEandyoucalloneofthefollowingVIs:IviScopeInitiateAcquisitionIviScopeReadWaveformIviScopeReadMinMaxWaveformIviScopeReadWaveformMeasurementIviScopeFetchWaveformMeasurementInadditiontothegeneralinterchangeabilitycheckingrules,theIviScopeclassdefinesadditionalrulesandexceptionsforeachcapabilitygroup.

IviScopeBase TheIviScopeTriggerLevelpropertymustbeinauser-specifiedstateonlyiftheapplicationsetstheIviScopeTriggerTypepropertytoIVISCOPE_VAL_EDGE_TRIGGERorIVISCOPE_VAL_RUNT_TRIGGER.

IviScopeTVTrigger ThedriverperformsinterchangeabilitycheckingontheIviScopeTVTriggergrouponlyiftheapplicationsetstheIviScopeTriggerTypepropertytoIVISCOPE_VAL_TV_TRIGGER.TheIviScopeTVTriggerLineNumberpropertymustbeinauser-specifiedstateonlyiftheapplicationsetstheIviScopeTVTriggerEventpropertytoIVISCOPE_VAL_TV_EVENT_LINE_NUMBER.

IviScopeRuntTrigger ThedriverperformsinterchangeabilitycheckingontheIviScopeRuntTriggergrouponlyiftheapplicationsetstheIviScopeTriggerTypepropertytoIVISCOPE_VAL_RUNT_TRIGGER.

IviScopeGlitchTrigger ThedriverperformsinterchangeabilitycheckingontheIviScopeGlitchTriggergroup

onlyiftheapplicationsetstheIviScopeTriggerTypepropertytoIVISCOPE_VAL_GLITCH_TRIGGER.

IviScopeWidthTrigger ThedriverperformsinterchangeabilitycheckingontheIviScopeWidthTriggergrouponlyiftheapplicationsetstheIviScopeTriggerTypepropertytoIVISCOPE_VAL_WIDTH_TRIGGER.

IviScopeAcLineTrigger ThedriverperformsinterchangeabilitycheckingontheIviScopeAcLineTriggergrouponlyiftheapplicationsetstheIviScopeTriggerTypepropertytoIVISCOPE_VAL_AC_LINE_TRIGGER.

IviScopeWaveformMeas TheIviScopeMeasurementLowReferencepropertymustbeinastateyouspecifyisyourequestawaveformmeasurementthatrequiresthelowreferencelevel,suchasrisetime,falltime,preshootandovershoot.TheIviScopeMeasurementMidReferencepropertymustbeinauser-specifiedstateifyourequestawaveformmeasurementthatrequiresthemiddlereferencelevel,suchasfrequency,period,positiveandnegativepulsewidths,andallcycle-basedmeasurements.TheIviScopeMeasurementHighReferencepropertymustbeinauser-specifiedstateifyourequestawaveformmeasurementthatrequiresthehighreferencelevel,suchasrisetime,falltime,preshootandovershoot.

IviScopeMinMaxWaveform

ThedriverperformsinterchangeabilitycheckingontheIviScopeMinMaxWaveformgrouponlyiftheapplicationsetstheIviScopeAcquisitionTypepropertytoIVISCOPE_VAL_ENVELOPEorIVISCOPE_VAL_PEAK_DETECT.TheIviScopeNumberofEnvelopesproperty

mustbeinauser-specifiedstateonlyiftheapplicationsetstheIviScopeAcquisitionTypepropertytoIVISCOPE_VAL_ENVELOPE.

IviScopeContinuousAcquisition

Usingthisextensiongroupisinherentlynon-interchangeable.Thisspecificationdoesnotdefinethebehavioroftheinstrumentnorthedatatheinstrumentsreturnwhilecontinuouslyacquiringthedata.

IviScopeAverageAcquisition

ThedriverperformsinterchangeabilitycheckingontheIviScopeAverageAcquisitiongrouponlyiftheapplicationsetstheIviScopeAcquisitionTypepropertytoIVISCOPE_VAL_AVERAGE.

IviScopeAutoSetup Usingthisextensiongroupisinherentlynon-interchangeable.Theapplicationbehaviorthendependsontheinternalinstrument'salgorithmsforoptimalacquisitionandchannelconfiguration.

TheIviScopeclassdoesnotdefineadditionalinterchangeabilityrulesorexceptionsforthefollowingextensioncapabilitygroups:IviScopeProbeAutoSense,IviScopeSampleMode,IviScopeInterpolation,andIviScopeTriggerModifier.

IviSpecAnInterchangeabilityTheIviSpecAnclassdriverperformsinterchangeabilitycheckingwhentheIVISPECAN_ATTR_INTERCHANGE_CHECKpropertyissettoVI_TRUEandyoucalloneofthefollowingVIs:IviSpecAn_InitiateandIviSpecAn_ReadYTrace.Inadditiontothegeneralinterchangeabilitycheckingrules,theIviSpecAnclassdefinesadditionalrulesandexceptionsforthefollowingcapabilitygroups:

IviSpecAnMarker

IftheMarkerEnabledpropertyissettoFalseforaparticularmarker,thentheMarkerPosition,MarkerTrace,MarkerFrequencyCounterEnabled,MarkerFrequencyCounterResolution,andSignalTrackEnabledpropertiesneednotbeinauserspecifiedstateforthatmarker.IftheMarkerEnabledpropertyissettoFalseforallmarkers,thentheMarkerThresholdandPeakExcursionpropertiesneednotbeinauserspecifiedstate.MarkerFrequencyCounterResolutionpropertyneednotbeinauserspecifiedstateforthatmarker.

IviSpecAnExternalTrigger

ThepropertiesofthisextensiongroupmustbeinauserspecifiedstateifandonlyiftheTriggerSourcepropertyissettoExternal.

IviSpecAnVideoTrigger

ThepropertiesofthisextensiongroupmustbeinauserspecifiedstateifandonlyiftheTriggerSourcepropertyissettoVideo.

IviSpecAnExternalMixing

IftheExternalMixerEnabledpropertyissettoFalse,thenallremaininggrouppropertiesneednotbeinauserspecifiedstate.IftheExternalMixerBiasEnabledpropertyissettoFalse,thentheExternalMixerBiasandExternalMixerBiasLimitpropertiesneednotbeinauserspecifiedstate.

TheIviSpecAnclassdoesnotdefineadditionalinterchangeabilityrulesor

exceptionsforthefollowingextensioncapabilitygroups:IviSpecAnMultiTrace IviSpecAnTrigger IviSpecAnDisplayIviSpecAnMarkerType IviSpecAnDeltaMarker IviSpecAnPreselector

IviSwtchInterchangeabilityTheIviSwtchclassdriverperformsinterchangeabilitycheckingwhentheIviSwtchInterchangeCheckpropertyissettoTRUEandyoucalloneofthefollowingVIs:IviSwtchConnectChannelsIviSwtchSetPathIviSwtchInitiateScan

TheIviSwtchclassdoesnotdefineanyadditionalrulesorexceptionbeyondthethegeneralinterchangeabilitycheckingrules.

DisablingUnusedExtensions-OverviewYoumightdeveloptestprogramsthatdonotuseoneormoreoftheextensiongroupsthataclassdriverdefines.Normallyyourprogramshouldworkwithinstrumentsthatdonotimplementtheextensiongroupaswellaswiththosethatdo.However,ifyourprogramdoesnotconfigureanextensiongroupandthespecificdriverimplementsthatextensiongroup,thevaluesoftheattributesintheunusedextensiongroupareunknown.Theattributesarelikelytobesettothepower-onsettingsofthedevice.Thepower-onsettingsoftenvaryfrominstrumenttoinstrument,sowhenyourelyonaspecificdrivertoimplementanextensiongroup,youmightsacrificeinterchangeability.Toaccommodateinstrumentsthatimplementextensiongroupsthatyourprogramneverconfigures,theclassdriverdisablesunusedextensionsbysettingtheextensiongroupstoaninterchangeablestate.Thisinterchangeablestateforanextensiongroupconfigurestheextensiongrouptohavenoeffectonthebehavioroftheinstrument.Forexample,theIviDmmbasecapabilitiescontrolDMMsthatcantakeasinglemeasurement.TheIviDmmclassdefinesamultipointextensiongroupthatcontrolsDMMsthatcanacquiremultiplesamplesfrommultipletriggers.IfyoudevelopaprogramthatusesonlytheIviDmmbasecapabilitieswithaninstrumentthatimplementsthemultipointextensiongroup,theIviDmmclassdriversetsthemultipointextensiongroupattributestoaninterchangeablestatewhenyoucalltheInitiateorReadfunctionsforIviDmm.Todisablethemultipointextensiongrouptotheinterchangeablestate,theIviDmmclassdriversetsthetriggercountattributeto1andthesamplecountattributeto1.Inthisconfiguration,themultipointextensiongroupdoesnotaffecttheinstrumentsbehavior.Therefore,youcanruntheprogramwithinstrumentsthatimplementonlytheIviDmmbasecapabilitiesaswellaswithinstrumentsthatimplementthemultipointextensiongroup.Ifyourprogramhaseversetanyofthevaluesofanextensiongroup,theclassdriverdoesnotconfiguretheextensiongroup.

DisablingUnusedExtensionsIviDCPwrClassDriverTheIviDCPwrdriverdoesnotdisableunusedextensions.

DisablingUnusedExtensionsIviFgenClassDriverWhenyoucalltheIviFgen_InitiateGenerationVI,theclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingpropertiesoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.

IfyoudonotusetheIviFgenModulateAMextensiongroupforachannel,thisdriversetstheIVIFGEN_ATTR_AM_ENABLEDpropertytoVI_FALSEforthatchannel.IfyoudonotusetheIviFgenModulateFMextensiongroupforachannel,thisdriversetstheIVIFGEN_ATTR_FM_ENABLEDpropertytoVI_FALSEforthatchannel.

DisablingUnusedExtensionsIviDmmClassDriverWhenyoucalltheIviDmm_Initiate,theIviDmm_Read,ortheIviDmm_ReadMultiPointVIs,theclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingpropertiesoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.Theclassdriverdisablesextensioncapabilitygroupsasfollows:

IfyoudonotusetheIviDmmMultiPointextensiongroup,thisdriversetstheIVIDMM_ATTR_SAMPLE_COUNTandIVIDMM_ATTR_TRIGGER_COUNTpropertiesto1.IfyoudonotusetheIviDmmAutoZeroextensiongroup,thisdriversetstheIVIDMM_ATTR_AUTO_ZEROpropertytoIVIDMM_VAL_AUTO_ZERO_OFF.

DisablingUnusedExtensionsIviPwrMeterClassDriverWhenyoucalltheIviPwrMeter_init,theIviPwrMeter_InitWithOptions,ortheIviPwrMeter_ResetVI,theclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.Theclassdriverdisablesextensioncapabilitygroupsbysettingthefollowingtothenoteddefaultvalues:

UnusedExtensionGroup PropertyIviPwrMeterChannelAcquistion IVIPWRMETER_ATTR_CHANNEL_ENABLEDIviPwrMeterTriggerSource IVIPWRMETER_ATTR_TRIGGER_SOURCEIviPwrMeterDutyCycleCorrection IVIPWRMETER_ATTR_DUTY_CYCLE_CORRECTION_ENABLEDIviPwrMeterReferenceOscillator IVIPWRMETER_ATTR_REFERENCE_OSCILLATOR_ENABLED

ThefollowingextensiongroupsarenotdisabledbytheIviPwrMeterdriver:IviPwrMeterInternalTriggerIviPwrMeterSoftwareTriggerIviPwrMeterAveragingCountIviPwrMeterZeroCorrectionIviPwrMeterSoftwareTriggerIviPwrMeterManualRange

DisablingUnusedExtensionsIviRFSigGenClassDriverWhenyoucalltheIviRFSigGen_init,theIviRFSigGen_InitWithOptions,ortheIviRFSigGen_ResetVI,theclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.Theclassdriverdisablesextensioncapabilitygroupsbysettingthefollowingtothenoteddefaultvalues:

UnusedExtensionGroup PropertyIviRFSigGenModulateAM IVIRFSIGGEN_ATTR_AM_ENABLEDIviRFSigGenModulateFM IVIRFSIGGEN_ATTR_FM_ENABLEDIviRFSigGenModulatePM IVIRFSIGGEN_ATTR_PM_ENABLEDIviRFSigGenModulatePulse IVIRFSIGGEN_ATTR_PULSE_MODULATION_ENABLEDIviRFSigGenLFGeneratorOutput IVIRFSIGGEN_ATTR_LF_GENERATOR_OUTPUT_ENABLEDIviRFSigGenPulseDoubleGenerator IVIRFSIGGEN_ATTR_PULSE_DOUBLE_ENABLEDIviRFSigGenPulseOutputEnabled IVIRFSIGGEN_ATTR_PULSE_OUTPUT_ENABLEDIviRFSigGenSweep IVIRFSIGGEN_ATTR_SWEEP_MODEIviRFSigGenFrequencySweep IVIRFSIGGEN_ATTR_SWEEP_MODEIviRFSigGenPowerSweep IVIRFSIGGEN_ATTR_SWEEP_MODEIviRFSigGenFrequencyStep IVIRFSIGGEN_ATTR_SWEEP_MODEIviRFSigGenPowerStep IVIRFSIGGEN_ATTR_SWEEP_MODEIviRFSigGenList IVIRFSIGGEN_ATTR_SWEEP_MODEIviRFSigGenACL IVIRFSIGGEN_ATTR_ALC_ENABLEDIviRFSigGenModulateIQ IVIRFSIGGEN_ATTR_IQ_ENABLEDIviRFSigGenIQImpairment IVIRFSIGGEN_ATTR_IQ_IMPAIRMENT_ENABLED

ThefollowingextensiongroupsarenotdisabledbytheIviRFSigGendriver:IviRFSigGenLFGenerator

IviRFSigGenPulseGeneratorIviRFSigGenReferenceOscillatorIviRFSigGenSoftwareTriggerIviRFSigGenArbGeneratorIviRFSigGenDigitalModulationBaseIviRFSigGenCDMABaseIviRFSigGenTDMABase

DisablingUnusedExtensionsIviScopeClassDriverWhenyoucalltheIviScope_InitiateAcquisition,IviScope_ReadWaveform,IviScope_ReadMinMaxWaveform,orIviScope_ReadWaveformMeasurementVIstheclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingpropertiesoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.Theclassdriverdisablesextensioncapabilitiesasfollows:

IfyoudonotusetheIviScopeContinuousAcquisitionextensiongroup,thisdriversetstheIVISCOPE_ATTR_INITIATE_CONTINUOUSpropertytoVI_FALSE.IfyoudonotusetheIviScopeInterpolationextensiongroup,thisdriversetstheIVISCOPE_ATTR_INTERPOLATIONpropertytotheIVISCOPE_VAL_NO_INTERPOLATIONvalue.IfyoudonotusetheIviScopeTriggerModifierextensiongroup,thisdriversetstheIVISCOPE_ATTR_TRIGGER_MODIFIERpropertytotheIVISCOPE_VAL_NO_TRIGGER_MODvalue.

DisablingUnusedExtensionsIviSpecAnClassDriverWhenyoucalltheIviSpecAn_init,theIviSpecAn_InitWithOptions,ortheIviSpecAn_ResetVI,theclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingpropertiesoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.Theclassdriverdisablesextensioncapabilitygroupsbysettingthefollowingpropertiestothenoteddefaultvalues:

UnusedExtensionGroup Property

IviSpecAnMarker IVISPECAN_ATTR_MARKER_ENABLEDIviSpecAnTrigger IVISPECAN_ATTR_TRIGGER_SOURCEIviSpecAnExternalMixer IVISPECAN_ATTR_EXTERNAL_MIXER_ENABLED

ThefollowingextensiongroupsarenotdisabledbytheIviRFSigGendriver:IviSpecAnMultiTraceIviSpecAnExternalTriggerIviSpecAnVideoTriggerIviSpecAnDisplayIviSpecAnMarkerTypeIviSpecAnDeltaMarkerIviSpecAnPreselector

DisablingUnusedExtensionsIviSwtchClassDriverWhenyoucalltheIviSwtch_Connect_Channels,theIviSwtch_SetPath,ortheIviSwtch_InitiateScanfunction,theclassdriverdisablesextensioncapabilitygroupsthattheprogramdoesnotusebysettingpropertiesoftheunusedextensiongrouptovaluesthatdisablethatextensiongroup.IfyoudonotusetheIviSwtchScannerextensiongroup,thedriverusesthefollowingdefaultvalues.

IVISWTCH_ATTR_SCAN_LIST ""(Emptystring)IVISWTCH_ATTR_TRIGGER_INPUT IVISWTCH_VAL_IMMEDIATEIVISWTCH_ATTR_SCAN_ADVANCED_OUTPUT IVISWTCH_VAL_NONEIVISWTCH_ATTR_SCAN_DELAY 0

IVIStatusCodesIVIclassdriverfunctionscanreturnerrorandwarningvaluesfromseveralsetsofstatuscodes.SomestatuscodesareuniquetotheIVIclassdriverfunctions.OtherstatuscodesarethesamecodesthatVISALibraryfunctionsreturn.Stillothersareerrororwarningvaluesthatfunctionsinspecificinstrumentdriversreturn.Eachsetofstatuscodeshasitsownnumericrange.Regardlessofthesourceofthestatuscode,0alwaysindicatessuccess,apositivevalueindicatesawarning,andanegativevalueindicatesanerror.

StatusCodeTables SpecificErrorandWarningCodesforClassDrivers

StatusCodeRanges IviDmmDefaultValuesofDefinedConstants

IviFgen

IVIErrorsandWarnings IviDCPwrCommonInstrumentDriverErrorsandWarnings

IviScope

Most-Often-EncounteredVISAErrorsandWarnings

IviSwtch

IviPwrMeterIviRFSigGenIviSpecAn

Thefollowingtabledefinesthedifferentrangesofstatuscodes.Thetableliststheincludefilesthatcontainthedefinedconstantsfortheparticularstatuscodes.

StatusCodeRanges

StatusCodeType NumericRange(inHex)

IncludeFile

IVIErrors BFFA0000toBFFA1FFF ivi.hIVIWarnings 3FFA0000to3FFA1FFF ivi.hClassDriverErrors BFFA2000toBFFA3FFF IviClass.hClassDriverWarnings 3FFA2000to3FFA3FFF IviClass.hSpecificDriverErrors BFFA4000toBFFA5FFF Prefix.hSpecificDriverWarnings 3FFA4000to3FFA5FFF Prefix.hCommonInstrumentDriverErrors BFFC0000toBFFCFFFF vpptype.hCommonInstrumentDriverWarnings

3FFC0000to3FFCFFFF vpptype.h

VISAErrors BFFF0000toBFFFFFFF visa.hVISAWarnings 3FFF0000to3FFFFFFF visa.h

TheCommonErrorsandWarningsarevaluesthatVXIplug&playdefinesandthatspecificinstrumentdriversreturn.Theyprovideaconsistentsetofcodesforerrorandwarningconditionsthatarecommonamongallinstrumentdrivers.EachparticularinstrumentdriverdefinesitsownsetofDriverErrorsandWarnings.Thestatuscodesvaluesforonedrivercanoverlapthestatuscodevaluesforotherdrivers.TheIVIclassdriversincludefilesdefineparticularstatuscodesastheunsignedsumofabasevalueandadecimalintegervalue.Thefollowingtableliststhebasevalues.

DefaultValuesofDefinedConstantsStatusCodeType DefinedConstantforBaseValue ValueIVIErrors IVI_ERROR_BASE BFFA0000IVIWarnings IVI_WARN_BASE 3FFA0000ClassDriverErrors IVI_CLASS_ERROR_BASE BFFA2000ClassDriverWarnings IVI_CLASS_WARN_BASE 3FFA2000SpecificDriverErrors IVI_SPECIFIC_ERROR_BASE BFFA4000SpecificDriverWarnings IVI_SPECIFIC_WARN_BASE 3FFA4000

Forexample,ifyoupassaninvalidattributeIDtoanIVIclassdriverfunction,thefunctionreturnsIVI_ERROR_INVALID_ATTRIBUTE,whichivi.hdefinesasIVI_ERROR_BASE+12,or0xBFFA000C.ThefollowingtablescontaintheIVIStatusCodes,theCommonStatusCodes,andthemostcommonlyusedVISAStatusCodes.

IVIErrorsandWarningsStatus Description0 Thecallwassuccessful.BFFA0000 Unrecoverablefailure.BFFA0001 Instrumenterrordetected.CalltheClassPrefix_error_query

functionandexaminetheerror.BFFA0002 Filecouldnotbeopened.BFFA0003 Fileisbeingread.BFFA0004 Fileisbeingmodified.BFFA0005 Drivermodulefilenotfound.BFFA0006 Cannotopendrivermodulefileforreading.BFFA0007 Drivermodulehasinvalidfileformatorcontainsinvaliddata.BFFA0008 Drivermodulecontainsundefinedreferences.BFFA0009 Cannotfindfunctionindrivermodule.BFFA000A Failureloadingdrivermodule.BFFA000B Thepathnameisinvalid.BFFA000C AttributeIDnotrecognized.BFFA000D Attributeisread-only.BFFA000E Attributeiswrite-only.BFFA000F Invalidparameter.BFFA0010 Invalidvalueforparameterorproperty.BFFA0011 Functionormethodnotsupported.BFFA0012 Attributeorpropertynotsupported.BFFA0013 Theenumerationvaluefortheparameterisnotsupported.BFFA0014 InvalidType.BFFA0015 Theattributeandfunctionparametertypesdonotmatch.BFFA0016 Thespecifiedattributealreadyhasavaluewaitingtobe

updated.BFFA0017 Thespecifieditemalreadyexists.BFFA0018 Notavalidconfiguration.

BFFA0019 Therequesteditemorvaluedoesnotexistorisnotavailable.

BFFA001A Therequestedattributevaluenotknownandcannotbedetermined.

BFFA001B Thereisnorangetableforthisattribute.BFFA001C Therangetableisinvalid.BFFA001D Aconnectiontotheinstrumenthasnotbeeninitialized.BFFA001E Theclassinstrumentdriverhasencounteredunderspecified

instrumentconfigurationsthatlimitinterchangeability.BFFA001F Nochanneltablehasbeenbuiltforthesession.The

instrumentdrivermustcallIvi_BuildChannelTableinitsIviInitfunction.

BFFA0020 Channelorrepeatedcapabilitynamespecifiedisnotvalidfortheinstrument.

BFFA0021 Unabletoallocatesystemresource.BFFA0022 Permissiontoaccessfilewasdenied.BFFA0023 Toomanyfilesopened.BFFA0024 Unabletocreatetemporaryfileintargetdirectory.BFFA0025 Alltemporaryfilenamesalreadyusedintargetdirectory.BFFA0026 Diskisfull.BFFA0027 Configurationfilewasnotfoundondisk.BFFA0028 Cannotopenconfigurationfile.BFFA0029 Errorreadingconfigurationfile.BFFA002A Invalid valueinconfigurationfile.BFFA002B Invalid valueinconfigurationfile.BFFA002C Invalid valueinconfigurationfile.BFFA002D Entrymissingfromconfigurationfile.BFFA002E InitializationfailedindriverDLL.BFFA002F Drivermodulecouldnotbeloadedbecauseofanunresolved

externalreference.BFFA0030 CannotfindCVIRun-TimeEngine.

BFFA0031 CannotopenCVIRun-TimeEngine.BFFA0032 CVIRun-TimeEnginehasinvalidformat.BFFA0033 CVIRun-TimeEngineismissingoneormorerequired

functions.BFFA0034 CVIRun-TimeEngineinitializationfailed,probablybecause

ofinsufficientmemory.BFFA0035 CVIRun-TimeEnginecouldnotbeloadedbecauseofan

unresolvedexternalreference.BFFA0036 FailureloadingCVIRun-TimeEngine.BFFA0037 CannotopenDLLtoreadexports.BFFA0038 DLLfileiscorrupt.BFFA0039 NoexporttableinDLL.BFFA003A Unknownattributenameforinitialsettinginconfigurationfile.BFFA003B Invalidattributevalueforinitialsettinginconfigurationfile.BFFA003C Memorypointerspecifiedisnotknown.BFFA003D Unabletofindanychannelorrepeatedcapabilitystrings.BFFA003E Thechannelorrepeatedcapabilitylistcontainstwo

instancesofthesamename.BFFA003F TheVirtualChannelNamesitemintheconfigurationfile

containsaduplicatevirtualchannelname.BFFA0040 TheVirtualChannelNamesitemintheconfigurationfile

containsanentrywithoutavirtualchannelname(nothingbeforethe'=').

BFFA0041 TheVirtualChannelNamesitemintheconfigurationfilecontainsaninvalidvirtualchannelname.Channelnamesmustcontainonlyalphanumerics,underscores,oranexclamationpoint.

BFFA0042 TheVirtualChannelNamesitemintheconfigurationfilecontainsavirtualchannelnamewithoutanassignedchannelstring(i.e.,nothingafter'=').

BFFA0043 TheVirtualChannelNamesitemintheconfigurationfilecontainsavirtualchannelnamethatisassignedtoanunknownorinvalidchannelstring.

BFFA0044 Channelorrepeatedcapabilitynamerequired.BFFA0045 Thechannelorrepeatedcapabilitynameisnotallowed.BFFA0046 Theattributeisnotvalidforthespecifiedchannelorrepeated

capability.BFFA0047 Thisoperationrequiresachannel–orrepeatedcapability–

basedattribute.Thespecifiedattributeisnotchannel–orrepeatedcapability–based.

BFFA0048 Thechannelhasalreadybeenexcludedforthespecifiedattributeandcannotbere-included.

BFFA0049 Theoptionstringparametercontainsanentrywithoutaname.

BFFA004A Theoptionstringparametercontainsanentrywithoutavalue.

BFFA004B Theoptionstringparametercontainsanentrywithanunknownoptionname.

BFFA004C Theoptionstringparametercontainsanentrywithanunknownoptionvalue.

BFFA004D Thisoperationisvalidonlyonasesssioncreatedbyaclassdriver.

BFFA004E Youcannotcreateaconfigurationfilenamed'ivi.ini'.Thatfilenameisreserved.

BFFA004F Therealreadyisanentryofthesamenameintherun-timeconfiguration.

BFFA0050 Theindexparameterisone-based.Youmustpassanumbergreaterthanorequalto1.

BFFA0051 Theindexexceedsthenumberofitemsavailable.BFFA0052 Youcannotsetthecacheforanattributethathasthe

IVI_VAL_NEVER_CACHEflag.BFFA0053 AninstrumentdrivercannotexportaViAddrattributetothe

end-user.UsetheIVI_VAL_HIDDENflagmacrotomakeitaprivateattribute.

BFFA0054 Channelorrepeatedcapabilitystringsmustcontainonlyalphanumerics,underscores,oranexclamationpoint.

BFFA0055 ThePrefixitemintheconfigurationfiledoesnotmatchthespecificdriver'sprefix.

BFFA0056 Thenecessarymemorycouldnotbeallocated.BFFA0057 Operationinprogress.BFFA0058 Nullpointerpassedforparameterorproperty.BFFA0059 Unexpectedresponsefromtheinstrument.BFFA005B Filenotfound.BFFA005C Thefileformatisinvalid.BFFA005D Theinstrumentstatusisnotavailable.BFFA005E InstrumentIDQueryfailed.BFFA005F Instrumentresetfailed.BFFA0060 Insufficientlocationinformationorresourcenotpresentinthe

system.BFFA0061 Thedriverisalreadyinitialized.BFFA0062 Thesimulationstatecannotbechanged.BFFA0063 Invalidnumberoflevelsinselector.BFFA0064 Invalidrangeinselector.BFFA0065 Unknownnameinselector.BFFA0066 Badly-formedselector.BFFA0067 Unknownphysicalselector.BFFA1190 Thesessionhandleisnotvalid.BFFA1198 Thesessionhandleisnotvalid.BFFA11A0 Couldnotcreatethreadlocal.BFFA1200 Thespecifiedconfigurationstorefilecouldnotbe

deserialized.BFFA1201 Adeserializewasattemptedafterapreviousdeserializehad

alreadysucceeded.BFFA1202 Thespecifiedconfigurationstorefilecouldnotbeserialized.BFFA1203 Thesessionnameorlogicalnamecouldnotberesolvedtoa

sessionordriversession.

BFFA1204 Theitemdoesnotexistintheglobalcollection.BFFA1205 Anentrywithnamealreadyexistsinthecollection.BFFA1206 Theregistryentryforthemasterconfigurationstoredoesnot

existorthefilecouldnotbefound.BFFA1207 Theitemdoesnotexistinthecollection.BFFA1208 Thedatacomponentisnotavaliddatacomponent.BFFA1209 Theelementcannotberemovedfromtheglobalcollection

whenitisreferencedinthelocalcollections.BFFA1232 Thespecifiedhandleisinvalidorofanincorrecttype.BFFA1233 ThespecifiedpropertyIDisnotvalidforthisfunction.BFFA6000 RepeatedCapabilitylistscannotbemodifiedafterattributes

havebeenaddedtothem.BFFA6001 Anattributecanonlyberestrictedtoasubsetofarepeated

capabilityonce.BFFA6002 Therepeatedcapabilitytablecannotbebuiltbecauseit

alreadyexists.BFFA6003 Therepeatedcapabilityhasnotbeendefinedyet.BFFA6004 Therepeatedcapabilitynamecannotbeanemptyornull

string.BFFA600D TheConfigServermoduleisnotpresentonthesystem.3FFA0065 Identificationquerynotsupported.3FFA0066 Resetoperationnotsupported.3FFA0067 Selftestoperationnotsupported.3FFA0068 Errorqueryoperationnotsupported.3FFA0069 Revisionquerynotsupported.

CommonInstrumentDriverErrorsandWarningsStatus Description

BFFC0001 Parameter1outofrange,orerrortryingtosetit.BFFC0002 Parameter2outofrange,orerrortryingtosetit.BFFC0003 Parameter3outofrange,orerrortryingtosetit.BFFC0004 Parameter4outofrange,orerrortryingtosetit.BFFC0005 Parameter5outofrange,orerrortryingtosetit.BFFC0006 Parameter6outofrange,orerrortryingtosetit.BFFC0007 Parameter7outofrange,orerrortryingtosetit.BFFC0008 Parameter8outofrange,orerrortryingtosetit.BFFC0011 InstrumentfailedtheIDQuery.BFFC0012 Invalidresponsefrominstrument.3FFC0101 InstrumentdoesnothaveIDQuerycapability.3FFC0102 InstrumentdoesnothaveResetcapability.3FFC0103 InstrumentdoesnothaveSelf-Testcapability.3FFC0104 InstrumentdoesnothaveErrorQuerycapability.3FFC0105 InstrumentdoesnothaveRevisionQuerycapability.

Most-Often-EncounteredVISAErrorsandWarningsStatus DescriptionBFFF0000 Miscellaneousorsystemerroroccurred.BFFF000E Invalidsessionhandle.BFFF0015 Timeoutoccurredbeforeoperationcouldcomplete.BFFF0034 Violationofrawwriteprotocoloccurred.BFFF0035 Violationofrawreadprotocoloccurred.BFFF0036 Devicereportedanoutputprotocolerror.BFFF0037 Devicereportedaninputprotocolerror.BFFF0038 Buserroroccurredduringtransfer.BFFF003A Invalidsetup(propertiesarenotconsistent).BFFF005F Nolistenersconditionwasdetected.BFFF0060 Thisinterfaceisnotthecontrollerincharge.BFFF0067 Operationisnotsupportedonthissession.3FFF0085 Thestatusvalueyoupassedisunknown.

IviDCPwrClassDriverReferenceforLabVIEWConceptsIviDCPwrTerminologyIviDCPwrClassDriverOverviewIviDCPwrExtensionCapabilityGroupsIviDCPwrBehaviorModels

IviDCPwrVIandPropertyReferenceIviDCPwrVITreeIviDCPwrPropertiesbyGroupIviDCPwrPropertyValueDefinitionsIviDCPwrErrorandCompletionCodes

OtherReferenceInterchangeabilityCheckingSimulation

IviDCPwrTerminologyThisdocumentusesthefollowingtermstodescribethepowersupply'soutput:VoltageLevel,OVPLimit,CurrentLimit,CurrentLimitBehavior,ConstantVoltageMode,ConstantCurrentMode,andUnregulatedMode.VoltageLevel—TheDCvoltagethepowersupplyattemptstogenerate.YouconfiguresthevoltagelevelwiththeIviDCPwrVoltageLevelproperty.OVP—OVPisanacronymforOvervoltageProtection.OVPLimitandOVPEnabled—IftheOVPlimitisenabled,thepowersupplydisablestheoutputwhentheoutputvoltageisgreaterthanorequaltotheOVPlimit.YouconfiguretheOVPlimitwiththeIviDCPwrOVPLimitproperty,andenableordisabletheOVPlimitwiththeIviDCPwrOVPEnabledproperty.CurrentLimitandCurrentLimitBehavior—Thecurrentlimitbehaviordeterminesthebehavioroftheinstrumentwhentheoutputcurrentisgreaterthanorequaltothecurrentlimit.Whenthecurrentlimitbehavioristrip,thepowersupplydisablestheoutputwhentheoutputcurrentisgreaterthanorequaltothecurrentlimit.Whenthecurrentlimitbehaviorisregulate,thepowersupplyrestrictstheoutputvoltagesuchthattheoutputcurrentisnotgreaterthanthecurrentlimit.YouconfigurethecurrentlimitandcurrentlimitbehaviorwiththeIviDCPwrCurrentLimitandIviDCPwrCurrentLimitBehaviorproperties.ConstantVoltageMode—Thepowersupplyissaidtobeintheconstantvoltagemodewhenthepowersupply'soutputsignalreachesthevoltagelevelbeforeitreachesthecurrentlimit.Intheconstantvoltagemode,thepowersupply'soutputvoltageremainsconstantatthevoltagelevelanditsoutputcurrentcanvary.ConstantCurrentMode—Thepowersupplyissaidtobeintheconstantcurrentmodewhenthepowersupply'soutputsignalreachesthecurrentlimitbeforeitreachesthevoltagelevel,andthecurrentlimitbehaviorissettoregulate.Intheconstantcurrentmode,thepowersupply'soutputcurrentremainsconstantatthecurrentlimitanditsoutputvoltagevaries.UnregulatedMode—Thepowersupplyissaidtobeintheunregulatedmodewhenthepowersupply'soutputsignalreachesneitherthevoltagelevelorthecurrentlimit.Intheunregulatedmode,thepowersupply's

outputcurrentandoutputvoltagevaries.

IviDCPwrClassDriverOverviewThisinstrumentdriverprovidesprogrammingsupportfortheIviDCPwrClass.TheIviDCPwrclassisdesignedtosupporttypicalDCpowersuppliesaswellascommonextendedfunctionalityfoundinmorecomplexinstruments.TheIviDCPwrclassconceptualizesaDCpowersupplyasaninstrumentcapableofgeneratingaDCpowersignal.TheIviDCPwrclassdriverdividesinstrumentcapabilitiesintoIviDCPwrBasecapabilitygroupandmultipleextensioncapabilitygroups.TheIviDCPwrBasegroupsupportsDCpowersuppliescapableofconfiguringthevoltagelevel,currentlimit,currentlimitbehavior,andovervoltageprotectionlimit,aswellasenablinganddisablingoutputchannels.Italsoallowsyoutoconfiguretheoutputrangeinwhichthepowersupplyoperates,andtoquerytheinstrumenttodetermineinwhatstateitisoperating.

ExtensionCapabilityGroupsTheIviDCPwrclassdriveridentifiesVIsandpropertiesthatbelongtoanextensiongroupwiththefollowingabbreviations.Instrumentspecificdriversarenotrequiredtoimplementanyoftheextensioncapabilitygroups.IfyouuseVIsandpropertiesthatbelongtoextensioncapabilitygroups,everyinstrumentspecificdriverthatyouusemustimplementthoseextensions.

GroupName Abbreviation DescriptionIviDCPwrTrigger [TRG] Forpowersuppliescapableof

makingchangestotheoutputsignalbasedonatriggerevent.

IviDCPwrSoftwareTrigger [SWT] Forpowersuppliescapableofmakingchangestotheoutputsignalbasedonasoftwaretriggerevent.

IviDCPwrMeasurement [MSR] Forpowersuppliescapableofreturningmeasurementcharacteristicsoftheoutputsignal.

RelatedTopicsIVIInherentClassCapabilities

IviDCPwrExtensionCapabilityGroupsTheIviDCPwrclassdriveridentifiesVIsandpropertiesthatbelongtoanextensiongroupwiththefollowingabbreviations.Instrumentspecificdriversarenotrequiredtoimplementanyoftheextensioncapabilitygroups.IfyouuseVIsandpropertiesthatbelongtoextensioncapabilitygroups,everyinstrumentspecificdriverdriverthatyouusemustimplementthoseextensions.

GroupName DescriptionIviDCPwrTrigger Forpowersuppliescapableofmaking

changestotheoutputsignalbasedonatriggerevent.

IviDCPwrSoftwareTrigger Forpowersuppliescapableofmakingchangestotheoutputsignalbasedonasoftwaretriggerevent.

IviDCPwrMeasurement Forpowersuppliescapableofreturningmeasurementcharacteristicsoftheoutputsignal.

IviDCPwrBaseCapabilityGroupTheIviDCPwrBasecapabilitygroupsupportsthemostbasicDCpowersupplycapabilities.Youcanenableordisableoutputchannels,specifytheDCvoltagetogenerate,specifyoutputlimits,andcontrolthebehaviorofthepowersupplywhentheoutputisgreaterthanorequaltooneofthelimits.Thishelpfileusesthefollowingtermstodescribethepowersupply'soutput:VoltageLevel,OVPLimit,CurrentLimit,CurrentLimitBehavior,ConstantVoltageMode,ConstantCurrentMode,andUnregulatedMode.RefertoIviDCPwrTerminologyformoreinformationontheseterms.Thesignalthatthepowersupplyproducesdependsonthevaluesofthevoltagelevel,OVPlimit,andcurrentlimitthatyousupply,andtheimpedanceoftheloadtowhichthepowersupplyisattached.Therefore,thepowersupplymightnotproducetheexactvoltageorcurrentthatyouconfigure.Thefollowingdiagramshowsthepossibleoutputscenarios.

PowerSupplyOutputDiagramAtPoint1,thepowersupply'soutputhasreachedthevoltagelevelbeforeitreachedthecurrentlimit.Thisisanexampleofthepowersupplyoperatingintheconstantvoltagemode.Notethatanypointontheverticallinedefinedbythevoltagelevelwouldalsocausethepowersupplytooperateintheconstantvoltagemode.AtPoint2,thepowersupply'soutputhasreachedthecurrentlimitbeforeitreachedthevoltagelevel.Ifthecurrentlimitbehaviorissettoregulate,thisisanexampleofthepowersupplyoperatingintheconstantcurrentmode.Ifthecurrentlimitbehaviorissettotrip,thepowersupplydisablestheoutput.Notethatanypointonthehorizontallinedefinedbythecurrentlimitwouldalsocausethepowersupplytooperateintheconstantcurrentmodewhenthecurrentlimitbehaviorissettoregulate.

Atpoint3,thepowersupply'soutputhasreachedneitherthevoltagelevelorthecurrentlimit.Thisisanexampleofthepowersupplyoperatingintheunregulatedmode.Notethatanypointwithintherectangledefinedbythevoltagelevelandcurrentlimitwouldalsocausethepowersupplytooperateintheunregulatedmode.Atpoint4,thepowersupply'soutputhasreachedtheOVPlimit.IfOVPisenabled,thepowersupplydisablestheoutput.NotethatanypointontheverticallinedefinedbytheOVPlimitwouldalsocausethepowersupplytodisabletheoutputwhenOVPisenabled.

IviDCPwrBaseVIsIviDCPwrConfigureOVPIviDCPwrConfigureCurrentLimitIviDCPwrConfigureOutputRangeIviDCPwrConfigureOutputEnabledIviDCPwrQueryOutputStateIviDCPwrResetOutputProtectionIviDCPwrQueryMaxCurrentLimitIviDCPwrQueryMaxVoltageLevelIviDCPwrVoltageLevel

IviDCPwrBasePropertiesIviDCPwrOVPEnabledIviDCPwrOVPLimitIviDCPwrCurrentLimitBehaviorIviDCPwrCurrentLimitIviDCPwrOutputEnabledRelatedTopicsIVIInherentFunctionsIVIInherentPropertiesIviDCPwrBasebehaviormodel

IviDCPwrMeasurementExtensionGroupTheIviDCPwrMeasurementextensiongroupsupportsDCpowersuppliescapableofreturningoutputsignalmeasurementssuchasvoltageandcurrent

IviDCPwrMeasurementVIIviDCPwrMeasure

IviDCPwrSoftwareTriggerExtensionGroupTheIviDCPwrSoftwareTriggerextensiongroupsupportsDCpowersuppliescapableofchangingtheoutputsignalbasedonasoftwaretriggerevent.

IviDCPwrSoftwareTriggerVIIviDCPwrSendSoftwareTrigger

IviDCPwrTriggerExtensionGroupTheIviDCPwrTriggerextensiongroupsupportsDCpowersuppliescapableofchangingtheoutputsignalbasedonatriggerevent.RefertotheIviDCPwrTriggerbehaviormodel.

IviDCPwrTriggerVIsIviDCPwrConfigureTriggerSource[TRG]IviDCPwrConfigureTriggeredVoltageLevel[TRG]IviDCPwrConfigureTriggeredCurrentLimit[TRG]IviDCPwrInitiate[TRG]IviDCPwrAbort[TRG]

IviDCPwrTriggerPropertiesIviDCPwrTriggerSourceIviDCPwrTriggeredCurrentLimitIviDCPwrTriggeredVoltageLevel

IviDCPwrBehaviorModelsIviDCPwrBaseIviDCPwrMeasurementIviDCPwrSoftwareTriggerIviDCPwrTrigger

IviDCPwrBaseBehaviorModelAfteryoucalltheIviDCPwrInitialize,IviDCPwrInitializeWithOptions,orIviDCPwrResetVIs,thepowersupplyproducesapowersignalbasedonitscurrentconfiguration.Allchangestothepowersupply'sIviDCPwrBaseVIsandpropertiestakeplaceimmediately.

IviDCPwrMeasurementBehaviorModelTheIviDCPwrMeasurementExtensionGroupfollowsthebehaviormodeloftheIviDCPwrBasecapabilitygroup.TheonlymodificationtothebehaviormodelfromtheIviDCPwrBasecapabilitygroupistheabilitytotakemeasurementontheoutputsignal.

IviDCPwrSoftwareTriggerBehaviorModelTheIviDCPwrSoftwareTriggerExtensionGroupfollowsthebehaviormodeloftheIviDCPwrTriggercapabilitygroup.TheonlymodificationtothebehaviormodelfromtheIviDCPwrTriggercapabilitygroupistheabilitytosendsoftwaretriggers.

IviDCPwrTriggerBehaviorModelThefollowingbehaviormodelshowstherelationshipbetweentheIviDCPwrTriggercapabilitygroupandpowersupplybehavior.

AfteryoucalltheIviDCPwrInitialize,IviDCPwrInitializeWithOptions,orIviDCPwrResetVIs.,thepowersupplyenterstheignoretriggerstate.Intheignoretriggerstate,thepropertiesoftheIviDCPwrBasecapabilitygroupdeterminethesignalthatthepowersupplyproduces.IviDCPwrTriggerpropertiescanbeset,butdonotaffecttheoutputsignal.CallingIviDCPwrInitiateVImovesthepowersupplytothewaitfortriggerstate.Inthewaitfortriggerstate,thepowersupplywaitsforatriggeronthetriggersourcespecifiedbytheIviDCPwrTriggerSource[TRG]property.Afterthepowersupplyreceivesatrigger,itsetsthevoltageleveltothevalueoftheIviDCPwrTriggeredVoltageLevel[TRG]property,andthecurrentlimittothevalueoftheIviDCPwrTriggeredCurrentLimit[TRG]property.Itthenreturnstotheignoretriggerstate.Afterthechangesinoutputoccur,theIviDCPwrTriggeredVoltageLevel[TRG]andIviDCPwrCurrentLimitpropertiesreflectthepowersupply'snewconfiguration.CallingIviDCPwrAbortVImovesthepowersupplyfromitscurrentstatetotheignoretriggerstate.Ifthepowersupplyhasnotyetrespondedtoatrigger,nochangeoccurstothevoltagelevelorcurrentlimit.

IviDCPwrVITreeTheVItreefortheIviDCPwrclassdriver,includingIVIandVXIplug&playrequiredVIs,isshownbelow.

NoteYouusetheLabVIEWPropertyNodetogetandsetproperties.

IviDCPwrVITreeNameorClass VIName RequiredBy

Initialize IviDCPwrInitialize IVI

InitializewithOptions IviDCPwrInitializeWithOptions

ConfigurationVIs

ConfigureVoltageLevel

IviDCPwrConfigureVoltageLevel

IviDCPwrBase

ConfigureOVP IviDCPwrConfigureOVP

IviDCPwrBase

ConfigureCurrentLimit

IviDCPwrConfigureCurrentLimit

IviDCPwrBase

ConfigureOutputRange

IviDCPwrConfigureOutputRange

IviDCPwrBase

ConfigureOutputEnabled

IviDCPwrConfigureOutputEnabled

IviDCPwrBase

Triggering

ConfigureTriggerSource[TRG]

IviDCPwrConfigureTriggerSource

IviDCPwrTrigger

ConfigureTriggeredVoltageLevel[TRG]

IviDCPwrConfigureTriggeredVoltageLevel

IviDCPwrTrigger

ConfigureTriggeredCurrentLimit[TRG]

IviDCPwrConfigureTriggeredCurrentLimit

IviDCPwrTrigger

Action

Initiate[TRG] IviDCPwrInitiate IviDCPwrTrigger

Abort[TRG] IviDCPwrAbort IviDCPwrTrigger

SendSoftwareTrigger

IviDCPwrSendSoftwareTrigger

IviDCPwrSoftwareTrigger

QueryMaxCurrentLimit

IviDCPwrQueryMaxCurrentLimit

IviDCPwrBase

QueryMaxVoltageLevel

IviDCPwrQueryMaxVoltageLevel

IviDCPwrBase

QueryOutputState IviDCPwrQueryOutputState

IviDCPwrBase

ResetOutputProtection

IviDCPwrResetOutputProtection

IviDCPwrBase

Measure IviDCPwrMeasure IviDCPwrMeasurement

Utility

Reset IviDCPwrReset IVI

ResetWithDefaults IviDCPwrResetWithDefaults

Self-Test IviDCPwrSelf-Test IVI

Disable IviDCPwrDisable VPP

InvalidateAllAttributes

IviDCPwrInvalidateAllAttributes

RevisionQuery IviDCPwrRevisionQuery

Error-Query IviDCPwrError-Query

ErrorMessage IviDCPwrErrorMessage

GetChannelName IviDCPwrGetChannelName

InterchangeabilityInfo

GetNextInterchangeWarning

IviDCPwrGetNextInterchangeWarning

ResetInterchangeCheck

IviDCPwrResetInterchangeCheck

ClearInterchangeWarnings

IviDCPwrClearInterchangeWarnings

CoercionInfo

GetNextCoercionRecord

IviDCPwrGetNextCoercionRecord

Close IviDCPwrClose IVI

RelatedTopicsIviDCPwrPropertiesIVIInherentVIs

IviDCPwrPropertiesNoteYouusetheLabVIEWPropertyNodetogetandsetproperties.

BasePropertiesIviDCPwrVoltageLevelIviDCPwrOVPEnabledIviDCPwrOVPLimitIviDCPwrCurrentLimitBehaviorIviDCPwrCurrentLimitIviDCPwrOutputEnabled

IviDCPwrTriggerPropertiesIviDCPwrTriggerSourceIviDCPwrTriggeredCurrentLimitIviDCPwrTriggeredVoltageLevel

IviDCPwrPropertyValueDefinitionsThefollowingtabledefinesvaluesforallIviDCPwrclasspropertyconstants.

NoteInthefollowingtable,theliteralstringIVIDCPWR_ATTR_precedesthepropertynameandtheliteralstringIVIDCPWR_VALprecedesthevalueextensionname.

IviDCPwrPropertyDefinedValues

Property DefinedValue

DefinedValue DefinedValue

CURRENTLIMITBEHAVIOR

Regulate 0 ThepowersupplyregulatestheoutputcurrentatthevalueoftheIviDCPwrCurrentLimitpropertywhentheoutputreachesorexceedsthatvalue.

Trip 1 ThepowersupplydisablestheoutputwhentheoutputcurrentreachesorexceedsthevalueoftheIviDCPwrCurrentLimitproperty.

TRIGGERSOURCE

Immediate 0 Thepowersupplydoesnotwaitforatriggerbeforechangingtheoutputsignal.

External 1 Thepowersupplywaitsforanexternaltriggerbeforechangingtheoutputsignal.

Software 2 ThepowersupplywaitsfortheIviDCPwrSendSoftwareTriggerVItoexecutebeforechangingtheoutputsignal.

TTL0 3 ThepowersupplywaitsforatriggerontheTTL0linebeforechangingtheoutputsignal.

TTL4 7 ThepowersupplywaitsforatriggerontheTTL4linebeforechangingthe

outputsignal.TTL5 8 Thepowersupplywaitsforatriggeron

theTTL5linebeforechangingtheoutputsignal.

ECLO 11 ThepowersupplywaitsforatriggerontheECL0linebeforechangingtheoutputsignal.

ECL1 12 ThepowersupplywaitsforatriggerontheECL1linebeforechangingtheoutputsignal.

PXIStar 13 ThepowersupplywaitsforatriggeronthePXISTARlinebeforechangingtheoutputsignal.

RTSI0 14 ThepowersupplywaitsforatriggerontheRTSI0linebeforechangingtheoutputsignal.

RTSI5 19 Thepowersupplywaitsforatriggeron

theRTSI5linebeforechangingtheoutputsignal.

RelatedTopicsIviDCPwrVITreeIviDCPwrProperties

IviDCPwrErrorandWarningCodesStatusCodeRangesStatusCodeType NumericRange(inHex)IviDCPwrErrors 0xBFFA2001to0xBFFA3FFFIviDCPwrWarnings 0x3FFA2001to0x3FFA3FFFIVISpecificDriverErrors 0xBFFA4000to0xBFFA5FFFIVISpecificDriverWarnings 0x3FFA4000to0x3FFA5FFFIVIErrors 0xBFFA0000to0xBFFA1FFFIVIWarnings 0x3FFA0000to0x3FFA1FFFCommonInstrumentDriverErrors 0xBFFC0000to0xBFFCFFFFCommonInstrumentDriverWarnings 0x3FFC0000to0x3FFCFFFFVISAErrors 0xBFFF0000to0xBFFFFFFFVISAWarnings 0x3FFF0000to0xFFFFFFF

IviDCPwrErrorCodeError Value MessageIVIDCPWR_ERROR_NOT_TRIGGER_SOFTWARE

0xBFFA1001 Thetriggersourceisnotsoftwaretrigger.

RelatedTopicIVIStatusCodes

IviDCPwrFunctionsExpandthisbooktoviewanalphabetizedlistofIviDCPwrfunctions.

IviDCPwrAbortIviDCPwrTriggerCapabilityGroup[TRG]ThisVIabortsallpendingoutputchanges.

NoteIfyoucallthisVIaftercallingtheIviDCPwrInitiate[TRG]VI,thepowersupplyignoresanytriggeranddoesnotchangetheoutput.instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDCPwrConfigureCurrentLimitIviDCPwrBaseCapabilityGroupThisVIconfiguresthecurrentlimit.Youspecifytheoutputcurrentlimitvalueandthebehaviorofthepowersupplywhentheoutputcurrentisgreaterthanorequaltothatvalue.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.channelname("CHANNEL1")PassthevirtualchannelnamethatyouassigntotheinstrumentinMAX.Virtualchannelnamesarealiasesforinstrumentspecificchannelstrings.Theinstrumentspecificchannelstringscandifferfromoneinstrumenttoanother.Virtualchannelnamesallowyoutouseandswapinstrumentswithouthavingtochangethechannelnamesinyoursourcecode.YouassignavirtualchannelnametoaninstrumentspecificchannelthroughMAX.Thiscontrolacceptsvirtualchannelnamesyouhaveassignedtothespecificinstrumentyouareusing.Italsoacceptstheinstrumentspecificchannelnames.DefaultValue:CHANNEL1

behavior(regulate)Passthebehavioryouwantthepowersupplytoexhibitwhentheoutputcurrentisgreaterthanorequaltothevalueofthelimitparameter.ThedriverusesthisvaluetosettheIviDCPwrCurrentLimitBehaviorproperty.DefinedValues:IVIDCPWR_VAL_CURRENT_REGULATE—RegulatorylimitIVIDCPWR_VAL_CURRENT_TRIP—TriplimitDefaultValue:IVIDCPWR_VAL_CURRENT_REGULATE

limit(0.0amps)Passthecurrentlimityouwanttouse.ThedriverusesthisvaluetosettheIviDCPwrCurrentLimitproperty.Units:ampsDefaultValue:0.0

IviDCPwrConfigureOutputEnabledIviDCPwrBaseCapabilityGroupConfigureswhetherthesignalthatthepowersupplyproducesonachannelappearsattheoutputconnector.

enabled(true)Passwhetheryouwantthesignalthepowersupplyproducesonachanneltoappearattheoutputconnector.ThedriverusesthisvaluetosettheIviDCPwrOutputEnabledproperty.ValidValues:TRUE-EnabletheoutputFALSE-DisabletheoutputDefaultValue:TRUE

errorin(noerror)Theerrorinclustercanaccepterrorinformation

wiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDCPwrConfigureOutputRangeIviDCPwrBaseCapabilityGroupConfiguresthepowersupply'soutputrangeonachannel.Youspecifywhetheryouwanttoconfigurethevoltageorcurrentrange,andthevaluetowhichtosettherange.

1. Settingavoltagerangecaninvalidateapreviouslyconfiguredcurrentrange.

2. Settingacurrentrangecaninvalidateapreviouslyconfiguredvoltagerange.

rangetype(Voltage)Passthetypeofrangeyouwanttoconfigure.DefinedValues:IVIDCPWR_VAL_RANGE_VOLTAGE—VoltageRangeIVIDCPWR_VAL_RANGE_CURRENT—CurrentRangeDefaultValue:IVIDCPWR_VAL_RANGE_VOLTAGE

1. Settingavoltagerangecaninvalidateapreviouslyconfiguredcurrentrange.

2. Settingacurrentrangecaninvalidateapreviouslyconfiguredvoltagerange.

range(0.0)Passtherangeinwhichyouwantthepowersupplytooperate.IfyoupassavalueofIVIDCPWR_VAL_RANGE_CURRENTfortheRangeTypeparameter,specifythisparameterinamps.IfyoupassavalueofIVIDCPWR_VAL_RANGE_VOLTAGEfortheRangeTypeparameter,specifythisparameterinvolts.Units: volts(forvoltagerange)

amps(forcurrentrange)DefaultValue: 0.0errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDCPwrConfigureOVPIviDCPwrBaseCapabilityGroupThisVIconfiguresthepowersupply'sovervoltageprotection.Youspecifytheovervoltagelimitandthebehaviorofthepowersupplywhentheoutputvoltageisgreaterthanorequaltothatvalue.WhentheenabledparameterisFALSE,thelimitparameterdoesnotaffecttheinstrument'sbehavior,andthedriverignoresthelimitparameter.

enabled(true)PasswhetheryouwanttoenableordisabletheOVPlimit.ThedriverusesthisvaluetosettheIviDCPwrOVPEnabledproperty.DefinedValues:TRUE—EnableOVPlimit

FALSE—DisableOVPlimitDefaultValue:TRUE

limit(0.0V)Passtheovervoltageprotectionlimityouwanttouse.ThedriverusesthisvaluetosettheIviDCPwrOVPLimitproperty.Units:volts(V)DefaultValue:0.0V

IviDCPwrConfigureTriggerSourceIviDCPwrTriggerCapabilityGroup[TRG]ThisVIconfiguresthetriggersourcetowhichthepowersupplyrespondsafteryoucallIviDCPwrInitiate[TRG].Whenthepowersupplyreceivesatriggersignalonthesourceyouspecify,itchangesitscurrentandvoltageoutputs.YouconfigurethetriggeredcurrentandvoltageoutputswiththeIviDCPwrConfigureTriggeredCurrentLimit[TRG]andIviDCPwrConfigureTriggeredVoltageLevel[TRG]VIs.

source(Immediate)Passthetriggersourcetowhichyouwantthepowersupplytorespond.ThedriversetstheIviDCPwrTriggerSource[TRG]propertytothisvalue.DefinedValues:

IVIDCPWR_VAL_TRIG_IMMEDIATE—Thepowersupplydoesnotwaitforatriggerofanykind.IVIDCPWR_VAL_TRIG_EXTERNAL—Thepowersupplywaitsforatriggerontheexternaltriggerpoint.IVIDCPWR_VAL_SOFTWARE_TRIG—ThepowersupplywaitsuntilyoucalltheIviDCPwrSendSoftwareTrigger[SWT]VI.IVIDCPWR_VAL_TRIG_TTL0—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG0line(forPXIinstruments)ortheVXITTL0line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL1—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG1line(forPXIinstruments)ortheVXITTL1line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL2—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG2line(forPXIinstruments)ortheVXITTL2line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL3—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG3line(forPXIinstruments)ortheVXITTL3line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL4—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG4line(forPXIinstruments)ortheVXITTL4line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL5—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG5line(forPXIinstruments)ortheVXITTL5line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL6—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG6line(forPXIinstruments)ortheVXITTL6line(forVXIinstruments).IVIDCPWR_VAL_TRIG_TTL7—ThepowersupplywaitsuntilitreceivesatriggeronthePXITRIG7line(forPXIinstruments)ortheVXITTL7line(forVXIinstruments).IVIDCPWR_VAL_TRIG_ECL0—ThepowersupplywaitsuntilitreceivesatriggerontheVXIECL0line.IVIDCPWR_VAL_TRIG_ECL1—ThepowersupplywaitsuntilitreceivesatriggerontheVXIECL1line.

IVIDCPWR_VAL_TRIG_PXI_STAR—ThepowersupplywaitsuntilitreceivesatriggeronthePXISTARtriggerbus.IVIDCPWR_VAL_TRIG_RTSI_0—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline0.IVIDCPWR_VAL_TRIG_RTSI_1—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline1.IVIDCPWR_VAL_TRIG_RTSI_2—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline2.IVIDCPWR_VAL_TRIG_RTSI_3—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline3.IVIDCPWR_VAL_TRIG_RTSI_4—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline4.IVIDCPWR_VAL_TRIG_RTSI_5—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline5.IVIDCPWR_VAL_TRIG_RTSI_6—ThepowersupplywaitsuntilitreceivesatriggeronRTSIline6.DefaultValue:IVIDCPWR_VAL_TRIG_IMMEDIATE

IviDCPwrConfigureTriggeredCurrentLimitIviDCPwrTriggerCapabilityGroup[TRG]ThisVIconfiguresthecurrentlimitthepowersupplyusesafteritreceivesatrigger.

triggeredlimit(0.0amps)Passthecurrentlimityouwantthepowersupplytouseafteritreceivesatrigger.ThedriversetstheIviDCPwrTriggeredCurrentLimit[TRG]propertytothisvalue.Units:ampsDefaultValue:0.0amps

errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.Usethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfrom

otherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDCPwrConfigureTriggeredVoltageLevelIviDCPwrTriggerCapabilityGroup[TRG]ThisVIconfigurestheDCvoltagelevelthepowersupplyattemptstogenerateafteritreceivesatrigger.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.channelname("CHANNEL1")PassthevirtualchannelnamethatyouassigntotheinstrumentinPassthevirtualchannelnamethatyouassigntotheinstrumentinMAX.Virtualchannelnamesarealiasesforinstrumentspecificchannelstrings.Theinstrumentspecificchannelstringscandifferfromoneinstrumenttoanother.Virtualchannelnamesallowyoutouseandswapinstrumentswithouthavingtochangethechannelnamesinyoursourcecode.YouassignavirtualchannelnametoaninstrumentspecificchannelthroughMAX.Thiscontrolacceptsvirtualchannelnamesyouhaveassignedtothespecificinstrumentyouareusing.Italsoacceptstheinstrumentspecificchannelnames.DefaultValue:CHANNEL1

triggeredlevel(0.0V)PasstheDCvoltagelevelyouwantthepowersupplytoattempttogenerateafteritreceivesatrigger.ThedriversetstheIviDCPwrTriggeredVoltageLevel[TRG]propertytothisvalue.Units:volts(V)DefaultValue:0.0V

IviDCPwrConfigureVoltageLevelIviDCPwrBaseCapabilityGroupThisVIconfigurestheDCvoltagelevelthatthepowersupplyattemptstogenerate.

level(0.0V)PasstheDCvoltageyouwantthepowersupplytoattempttogenerate.ThedriversetstheIviDCPwrVoltageLevelpropertytothisvalue.Units:volts(V)DefaultValue:0.0V

errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmore

informationabouttheerrordisplayed.

IviDCPwrGetChannelNameIviDCPwrBaseCapabilityGroupThisVIreturnsthespecificdriverdefinedchannelnamethatcorrespondstotheone-basedindexthatyouspecify.IfthevalueyoupassfortheIndexparameterislessthanoneorgreaterthanthevalueoftheChannelCountproperty,thefunctionreturnsanemptystringintheNameparameterandreturnsanerror.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.

index(1)Aone-basedindexthatdefineswhichnametoreturn.TheindexmustbelessthanorequaltotheClassPrefixChannelCountproperty.instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.Thehandleidentifiesaparticularinstrumentsession.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

outputchannelnameReturnsthenameoftheChannelspecifiedbytheindexparameter.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDCPwrInitiateIviDCPwrTriggerCapabilityGroup[TRG]ThisVIinitiatesoutputchangesthatyoupreviouslyspecified.AfteryoucallthisVI,thepowersupplywaitsforthetriggeryouspecifywiththeIviDCPwrConfigureTriggerSource[TRG]VI.Afterthepowersupplydetectsthetrigger,itupdatesitsvoltagelevelandcurrentlimittothevaluesyouspecifywiththeIviDCPwrConfigureTriggeredVoltageLevel[TRG]andIviDCPwrConfigureTriggeredCurrentLimit[TRG]VIs.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.

IviDCPwrMeasureIviDCPwrMeasurement[MSR]ThisVItakesasinglemeasurementonthechannelyouspecify.

measurementtype(voltage)Passthemeasurementyouwantthepowersupplytotake.DefinedValues:IVIDCPWR_VAL_MEASURE_VOLTAGE—DCvoltageIVIDCPWR_VAL_MEASURE_CURRENT—DCcurrentDefaultValue:IVIDCPWR_VAL_MEASURE_VOLTAGE

errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.measurementReturnsthemeasuredvalue.IfyoupassavalueofIVIDCPWR_VAL_MEASURE_CURRENTforthemeasurementTypeparameter,thisparameterreturnsavalueinamps.IfyoupassavalueofIVIDCPWR_VAL_MEASURE_VOLTAGEforthemeasurementTypeparameter,thisparameterreturnsavalueinvolts.

Units: volts(forvoltagemeasurement)amps(forcurrentmeasurement)

IviDCPwrQueryMaxCurrentLimitIviDCPwrBaseCapabilityGroupThisVIreturnsthemaximumprogrammablecurrentlimitthatthepowersupplyacceptsforaparticularvoltagelevelonachannelfortheoutputrangetowhichthepowersupplyiscurrentlyconfigured.

voltagelevel(0.0V)Passthevoltagelevelforwhichtodeterminethemaximumprogrammablecurrentlimit.Units:volts(V)DefaultValue:0.0

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.maxcurrentlimitThisparameterreturnsthemaximumprogrammablecurrentlimitforthevoltagelevelyouspecify.Units:amps(A)

IviDCPwrQueryMaxVoltageLevelIviDCPwrBaseCapabilityGroupThisVIreturnsthemaximumprogrammablevoltagelevelthatthepowersupplyacceptsforaparticularcurrentlimitonachannelfortheoutputrangetowhichthepowersupplyiscurrentlyconfigured.

currentlimit(0.0amps)Passthecurrentlimitforwhichtodeterminethemaximumprogrammablevoltagelevel.Units:amps(A).DefaultValue:0.0

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.maxvoltagelevelThisparameterreturnsthemaximumprogrammablevoltagelevelforthecurrentlimityouspecify.Units:volts(V)

IviDCPwrQueryOutputStateIviDCPwrBaseCapabilityGroupThisVIreturnswhetherthepowersupplyisinaparticularoutputstate.Details

outputstate(ConstantVoltage)Passtheoutputstateforwhichyouwanttoquery.DefinedValues:IVIDCPWR_VAL_OUTPUT_CONSTANT_VOLTAGE—ConstantVoltageStateIVIDCPWR_VAL_OUTPUT_CONSTANT_CURRENT—ConstantCurrentStateIVIDCPWR_VAL_OUTPUT_UNREGULATED—UnregulatedStateIVIDCPWR_VAL_OUTPUT_OVER_VOLTAGE—OvervoltageState

IVIDCPWR_VAL_OUTPUT_OVER_CURRENT—OvercurrentStateDefaultValue:IVIDCPWR_VAL_OUTPUT_CONSTANT_VOLTAGE

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.instateThisparameterreturnsTRUEifthepowersupplyiscurrentlyinthestateyouspecifywiththeOutputStateparameter,andFALSEifitisnot.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDCPwrQueryOutputStateDetailsAconstantvoltageconditionoccurswhentheoutputvoltageisequaltothevalueoftheIviDCPwrVoltageLevelpropertyandthecurrentislessthanorequaltothevalueoftheIviDCPwrCurrentLimitproperty.AconstantcurrentconditionoccurswhentheoutputcurrentisequaltothevalueoftheIviDCPwrCurrentLimitpropertyandtheIviDCPwrCurrentLimitBehaviorpropertyissettoIVIDCPWR_VAL_CURRENT_REGULATE.AnunregulatedconditionoccurswhentheoutputvoltageislessthanthevalueoftheIviDCPwrVoltageLevelpropertyandthecurrentislessthanthevalueoftheIviDCPwrCurrentLimitproperty.AnovervoltageconditionoccurswhentheoutputvoltageisequaltoorgreaterthanthevalueoftheIviDCPwrOVPLimitpropertyandtheIviDCPwrOVPEnabledpropertyissettoTRUE.Anover-currentconditionoccurswhentheoutputcurrentisequaltoor

greaterthanthevalueoftheIviDCPwrCurrentLimitpropertyandtheIviDCPwrCurrentLimitBehaviorpropertyissettoIVIDCPWR_VAL_CURRENT_TRIP.Wheneitheranovervoltageconditionoranover-currentconditionoccurs,thepowersupply'soutputprotectiondisablestheoutput.Ifthepowersupplyisinanovervoltageorover-currentstate,itdoesnotproducepoweruntiltheoutputprotectionisreset.TheIviDCPwrResetOutputProtectionVIresetstheoutputprotection.Oncetheoutputprotectionisreset,thepowersupplyresumesgeneratingapowersignal.

IviDCPwrResetOutputProtectionIviDCPwrBaseCapabilityGroupThisVIclearsalloutput-protectionconditionsonthepowersupply.

channelname("CHANNEL1")PassthevirtualchannelnamethatyouassigntotheinstrumentinMAX.Virtualchannelnamesarealiasesforinstrumentspecificchannelstrings.Theinstrumentspecificchannelstringscandifferfromoneinstrumenttoanother.Virtualchannelnamesallowyoutouseandswapinstrumentswithouthavingtochangethechannelnamesinyoursourcecode.YouassignavirtualchannelnametoaninstrumentspecificchannelthroughMAX.Thiscontrolacceptsvirtualchannelnamesyouhaveassignedtothespecificinstrumentyouareusing.Italsoacceptstheinstrumentspecificchannelnames.DefaultValue:CHANNEL1

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDCPwrInitializeorIviDCPwrInitializeWithOptionsVI.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmore

IviDCPwrSendSoftwareTriggerIviDCPwrSoftwareTrigger[SWT]ThisVIsendsacommandtotriggerthepowersupply.CallthisVIifyouconfigurethepowersupplytorespondtosoftwaretriggers.Ifthepowersupplyisnotconfiguredtorespondtosoftwaretriggers,thisVIreturnstheerrorIVIDCPWR_ERROR_TRIGGER_NOT_SOFTWARE(0xBFFA1001).

IviDCPwrPropertiesExpandthisbooktoviewanalphabetizedlistofIviDCPwrproperties.

ActiveChannelActiveChannelPropertyDataType Access Appliesto Coercion HighLevelVIs

WO n/a none none

DescriptionSpecifiesthechannelnameusedtoaccessallsubsequentchannel-basedpropertiesinthispropertynode.Setthechannelbeforesettingchannel-basedproperties.Passanamethattheinstrumentdriverdefinesoravirtualchannelnametheend-userdefinesintheIVIconfigurationfileinMAX.PropertyNodePath<classdriver>»ActiveChannel

IviDCPwrChannelCountIviDCPwrBasePropertyDataType Access Appliesto Coercion HighLevelVIs

RO N/A None None

DescriptionReturnsthenumberofchannelsavailableontheinstrument.PropertyNodePathIviDCPwr»InherentIVISettings»SpecificDriverCapabilities»ChannelCount

IviDCPwrCurrentLimitIviDCPwrBasePropertyDataType Access Applies

to Coercion HighLevelVIs

R/W Channel N/A IviDCPwrConfigureCurrentLimit

DescriptionThischannel-basedpropertyspecifiestheoutputcurrentlimit.TheunitsareAmperes.ThevalueoftheIviDCPwrCurrentLimitBehaviorpropertydeterminesthebehaviorofthepowersupplywhentheoutputcurrentisequaltoorgreaterthanthevalueofthisproperty.PropertyNodePathIviDCPwr»BasicOperation»CurrentLimit

IviDCPwrCurrentLimitBehaviorIviDCPwrBasePropertyDataType Access Applies

R/W Channel N/A IviDCPwrConfigureCurrentLimit

DescriptionThischannel-basedpropertyspecifiesthebehaviorofthepowersupplywhentheoutputcurrentisequaltoorgreaterthanthevalueoftheIviDCPwrCurrentLimitproperty.PropertyNodePathIviDCPwr»BasicOperation»CurrentLimitBehaviorDefinedValuesIVIDCPWR_VAL_CURRENT_REGULATEIVIDCPWR_VAL_CURRENT_TRIP

IviDCPwrOutputEnabledIviDCPwrBasePropertyDataType Access Applies

R/W Channel N/A IviDCPwrConfigureOutputEnabled

DescriptionThischannel-basedpropertyspecifieswhetherthesignalthepowersupplyproducesappearsattheoutputconnector.PropertyNodePathIviDCPwr»BasicOperation»OutputEnabled

IviDCPwrOVPEnabledIviDCPwrBasePropertyDataType Access Appliesto Coercion HighLevelVIs

R/W Channel N/A IviDCPwrConfigureOVP

DescriptionThischannel-basedpropertyspecifieswhetherthepowersupplyprovidesovervoltageprotection.IfthispropertyissettoTRUE,thepowersupplydisablestheoutputwhentheoutputvoltageisgreaterthanorequaltothevalueoftheIviDCPwrOVPLimitproperty.PropertyNodePathIviDCPwr»BasicOperation»OVPEnabled

IviDCPwrOVPLimitIviDCPwrBasePropertyDataType Access Appliesto Coercion HighLevelVIs

R/W Channel N/A IviDCPwrConfigureOVP

DescriptionThischannel-basedpropertyspecifiesthevoltagethepowersupplyallows.Theunitsarevolts.IftheIviDCPwrOVPEnabledpropertyissettoTRUE,thepowersupplydisablestheoutputwhentheoutputvoltageisgreaterthanorequaltothevalueofthisproperty.IftheIviDCPwrOVPEnabledpropertyissettoFALSE,thispropertydoesnotaffectthebehavioroftheinstrument.PropertyNodePathIviDCPwr»BasicOperation»OVPLimit

IviDCPwrTriggerSource[TRG]IviDCPwrTriggerProperty[TRG]DataType Access Applies

R/W Channel N/A IviDCPwrConfigureTriggerSource[TRG]

DescriptionThischannel-basedpropertyspecifiesthetriggersource.AfteryoucallIviDCPwrInitiate[TRG],thepowersupplywaitsforatriggereventfromthesourceyouspecifywiththisproperty.Afteratriggereventoccurs,thepowersupplychangesthevoltageleveltothevalueoftheIviDCPwrTriggeredVoltageLevel[TRG],andthecurrentlimittothevalueoftheIviDCPwrTriggeredCurrentLimit[TRG],properties.PropertyNodePathIviDCPwr»Trigger»TriggerSource[TRG]DefinedValuesIVIDCPWR_VAL_TRIG_IMMEDIATEIVIDCPWR_VAL_TRIG_EXTERNALIVIDCPWR_VAL_SOFTWARE_TRIGIVIDCPWR_VAL_TRIG_TTL0IVIDCPWR_VAL_TRIG_TTL1IVIDCPWR_VAL_TRIG_TTL2IVIDCPWR_VAL_TRIG_TTL3IVIDCPWR_VAL_TRIG_TTL4IVIDCPWR_VAL_TRIG_TTL5IVIDCPWR_VAL_TRIG_TTL6IVIDCPWR_VAL_TRIG_TTL7IVIDCPWR_VAL_TRIG_ECL0IVIDCPWR_VAL_TRIG_ECL1IVIDCPWR_VAL_TRIG_PXI_STAR

IVIDCPWR_VAL_TRIG_RTSI_0IVIDCPWR_VAL_TRIG_RTSI_1IVIDCPWR_VAL_TRIG_RTSI_2IVIDCPWR_VAL_TRIG_RTSI_3IVIDCPWR_VAL_TRIG_RTSI_4IVIDCPWR_VAL_TRIG_RTSI_5IVIDCPWR_VAL_TRIG_RTSI_6

IviDCPwrTriggeredCurrentLimit[TRG]IviDCPwrTriggerProperty[TRG]DataType Access Applies

R/W Channel N/A IviDCPwrConfigureTriggeredCurrentLimit[TRG]

DescriptionThischannel-basedpropertyspecifiesthevaluetowhichthepowersupplysetsthecurrentlimitafteratriggereventoccurs.Theunitsareamps.AfteryoucallIviDCPwrInitiate[TRG],thepowersupplywaitsforatriggereventfromthesourceyouspecifywiththeIviDCPwrTriggerSource[TRG],property.Afteratriggereventoccurs,thepowersupplysetsthecurrentlimittothevalueofthisproperty.Afteratriggeroccurs,thevalueoftheIviDCPwrCurrentLimit[TRG]propertyreflectsthenewvaluetowhichthecurrentlimithasbeenset.PropertyNodePathIviDCPwr»Trigger»TriggeredCurrent[TRG]

IviDCPwrTriggeredVoltageLevel[TRG]IviDCPwrTriggerPropertyDataType Access Applies

R/W Channel N/A IviDCPwrConfigureTriggeredVoltageLevel[TRG]

DescriptionThischannel-basedpropertyspecifiesthevaluetowhichthepowersupplysetsthevoltagelevelafteratriggereventoccurs.Theunitsarevolts.AfteryoucallIviDCPwrInitiate[TRG],thepowersupplywaitsforatriggereventfromthesourceyouspecifywiththeIviDCPwrTriggerSource[TRG],property.Afteratriggereventoccurs,thepowersupplysetsthevoltageleveltothevalueofthisproperty.Afteratriggeroccurs,thevalueoftheIviDCPwrVoltageLevel[TRG]propertyreflectsthenewvaluetowhichthevoltagelevelhasbeenset.PropertyNodePathIviDCPwr»Trigger»TriggeredVoltageLevel[TRG]

IviDCPwrVoltageLevelIviDCPwrBasePropertyDataType Access Applies

R/W Channel N/A IviDCPwrConfigureVoltageLevel

DescriptionThischannel-basedpropertyspecifiesthevoltageleveltheDCpowersupplyattemptstogenerate.Theunitsarevolts.PropertyNodePathIviDCPwr»BasicOperation»VoltageLevel

IviDCPwrDefinedValuesExpandthisbooktoviewanalphabetizedlistofIviDCPwrdefinedvalues.

IVIDCPWR_VAL_CURRENT_REGULATEThepowersupplyregulatestheoutputcurrentatthevalueoftheIviDCPwrCurrentLimitpropertywhentheoutputreachesorexceedsthatvalue.DefinedValue:0

IVIDCPWR_VAL_CURRENT_TRIPThepowersupplydisablestheoutputwhentheoutputcurrentreachesorexceedsthevalueoftheIviDCPwrCurrentLimitproperty.DefinedValue:1

IVIDCPWR_VAL_SOFTWARE_TRIGThepowersupplywaitsfortheIviDCPwrSendSoftwareTriggerVItoexecutebeforechangingtheoutputsignal.DefinedValue:2

IVIDCPWR_VAL_TRIG_ECL0ThepowersupplywaitsforatriggerontheECL0linebeforechangingtheoutputsignal.DefinedValue:11

IVIDCPWR_VAL_TRIG_ECL1ThepowersupplywaitsforatriggerontheECL1linebeforechangingtheoutputsignal.DefinedValue:12

IVIDCPWR_VAL_TRIG_EXTERNALThepowersupplywaitsforanexternaltriggerbeforechangingtheoutputsignal.DefinedValue:1

IVIDCPWR_VAL_TRIG_IMMEDIATEThepowersupplydoesnotwaitforatriggerbeforechangingtheoutputsignal.DefinedValue:0

IVIDCPWR_VAL_TRIG_PXI_STARThepowersupplywaitsforatriggeronthePXISTARlinebeforechangingtheoutputsignal.DefinedValue:13

IVIDCPWR_VAL_TRIG_RTSI_0ThepowersupplywaitsforatriggerontheRTSI0linebeforechangingtheoutputsignal.DefinedValue:14

IVIDCPWR_VAL_TRIG_TTL0ThepowersupplywaitsforatriggerontheTTL0linebeforechangingtheoutputsignal.DefinedValue:3

PropertiesforControllingIviDCPwrSimulationNoteYoucansetSimulationAttributesinMAXontheInitialSettingstabofIVIDrivers»Advanced»SimulationDriverSessions»nisIviClassorinthesimulationinteractivepanels.RefertoNationalInstrumentsIVIDriverHelp»ConfiguringYourSystemformoreinformation.

TwosetsofpropertiesexistforusewiththeIviDCPwrSimulationDriver.Thefollowingtabledescribespropertiesthatcontrolbehaviorofthedriver.AnothertablelistspropertiesthatsimulatethestatusofspecificdriverVIs.AnIviDCPwrSimulatorSetupDialogBoxexiststohelpyouconfigurethemeasurementsimulationfortheIviDCPwrSimulatordriver.

IviDCPwrPropertiesforControllingSimulationName Data

TypeAccess Applies

toDescription

INTERACTIVE_SIMULATION Boolean W No Specifieswhethertosetthedrivertointeractivemode.Ininteractivemode,thesimulationdriverusespop-upuserinterfacepanelsforgettinginformationfromyou.Non-interactivemodeisusefulwhenyoudonotwanttheinteractivepanelstointerruptyourtestprogram.

SELF_TEST_CODE Integer W No Specifiestheself-testcode.WhentheIviDCPwrSelf-TestVIiscalled,theself-testresultparameterreturnsthis

value.SELF_TEST_MSG String W No Specifiesthe

self-testmessage.WhentheIviDCPwrSelf-TestVIiscalled,theself-testmessageparameterreturnsthisstring.

ERROR_QUERY_CODE Integer W No Specifiestheerror-querycode.WhentheIviDCPwrError-QueryVIiscalled,theerrorcodeparameterreturnsthisvalue.

ERROR_QUERY_MSG String W No Specifiestheerror-querymessage.WhentheIviDCPwrError-QueryVIiscalled,theerrormessageparameterreturnsthisstring.

DRIVER_REV_QUERY String W No Specifiestheinstrument

driverrevisionmessage.WhentheIviDCPwrRevisionQueryVIiscalled,theinstrumentdriverrevisionparameterreturnsthisstring.

INSTR_REV_QUERY String W No Specifiesthefirmwarerevisionmessage.WhentheIviDCPwrRevisionQueryVIiscalled,thefirmwarerevisionparameterreturnsthisstring.

SIMULATE_STATUS_CODE Boolean W No SpecifieswhethertosimulatereturncodesfromtheIviDCPwrdriverVIs.RefertothePropertiesforIviDCPwrSimulation

tableformore

RelatedTopicsSettingUpSimulatedErrorsSettingUpSimulationforVXIplug&playVIs

IviDCPwrSimulatorSetupDialogBoxTwosetsofpropertiesexistforusewiththeIviDCPwrSimulationDriver.YouusethedialogboxshownbelowtoconfigurethemeasurementsimulationfortheIviDCPwrSimulatordriver.Scrolldowntoseeadescriptionofeachcontrol.

SimulatorSetupDialogBoxAlwayspromptforoutputdatasimulationLeavingthiscontrolselectedcausesthepaneltoappearateverymeasurementacquisitioneventinyourprogram.Allsimulatedacquisitionsintheprogramusethesamemeasurementconfigurationinformation.Unselectingthiscontrolcausesthemeasurementsimulationpaneltoneverappearagainduringthecourseofyourprogram.ChannelThiscontrolspecifiesthechannelforwhichyouwanttoconfigureasimulationmeasurement.MeasurementEnterthemeasurementbasetouseforallcomputergeneratedmeasurements.AllcomputergeneratedmeasurementvaluesfallwithintherangeofthisvalueplusorminusthevalueoftheNoisecontrol.ValidRange:anyvalueNoiseEnterthereadingnoisetouseforallcomputergeneratedmeasurements.AllcomputergeneratedmeasurementvaluesfallwithintherangeofthevalueoftheMeasurementcontrolplusorminusthisvalue.ValidRange:anypositivevalue

PropertiesforStatusSimulationinIviDCPwrWhenanIviDCPwrdriverfunctioniscalled,thedriverquerieswhetherNISDCPWR_ATTR_SIMULATE_STATUS_CODEisenabled.Ifenabled,thedrivergetstheappropriatefunction'ssimulationstatuscode.Ifthevalueofthesimulationstatuscoderepresentsawarning(hasapositivevalue),thenitisreturnedasthefunction'sreturnstatusonlyifnoothererrororwarningoccurredbeforethefunctionends.Ifthevalueofthesimulationstatuscoderepresentsanerror(hasanegativevalue),thenitisreturnedasthefunction'sreturnstatusonlyifnoothererroroccurredbeforethefunctionends.ThefollowingIviDCPwrVIsdonotsupportstatuscodesimulation:

IviDCPwrGetErrorIviDCPwrClearErrorIviDCPwrGetNextInterchangeWarningIviDCPwrResetNextInterchangeWarningIviDCPwrClearNextInterchangeWarningIviDCPwrGetNextCoercionRecord

EachVIsupportedbytheIviDCPwrclassdriverhasacorrespondingpropertythatdeterminesthestatuscodetoreturnwhenstatuscodesimulationisenabled.ThefollowingtableliststhestatuscodepropertiesandtheVIforwhichtheyreturnavalue.ThesepropertiesarealloftypeViInt32,non-readable,andnon-channelbased.

NoteInthefollowingtable,theliteralstringNISDCPWRprecedesallpropertynames.

IviDCPwrPropertiesforStatusSimulationProperty VIINIT_STATUS IviDCPwr

Initialize,IviDCPwrInitializeWithOptions

CLOSE_STATUS IviDCPwrCloseRESET_STATUS IviDCPwrResetSELF_TEST_STATUS IviDCPwrSelf-Test

ERROR_QUERY_STATUS IviDCPwrError-Query

ERROR_MESSAGE_STATUS IviDCPwrErrorMessage

REVISION_QUERY_STATUS IviDCPwrRevisionQuery

RESET_DEFAULT_STATUS IviDCPwrResetWithDefaults

DISABLE_STATUS IviDCPwrDisableINVALIDATE_STATUS IviDCPwr

GET_CH_NAME_STATUS IviDCPwrGetChannelName

CONFIGURE_OUTPUT_ENABLED_STATUS IviDCPwrConfigureOutputEnabled

CONFIGURE_OUTPUT_RANGE_STATUS IviDCPwrConfigureOutputRange

CONFIGURE_CURRENT_LIMIT_STATUS IviDCPwrConfigureCurrentLimit

CONFIGURE_OVP_STATUS IviDCPwr

ConfigureOVPCONFIGURE_VOLTAGE_LEVEL_STATUS IviDCPwr

ConfigureVoltageLevel

QUERY_OUTPUT_STATE_STATUS IviDCPwrQueryOutputState

QUERY_MAX_CURRENT_LIMIT_STATUS IviDCPwrQueryMaxCurrentLimit

QUERY_MAX_VOLTAGE_LEVEL_STATUS IviDCPwrQueryMaxVoltageLevel

RESET_OUTPUT_PROTECTION_STATUS IviDCPwrResetOutputProtection

CONFIGURE_TRIGGER_SOURCE_STATUS IviDCPwrConfigureTriggerSource

CONFIGURE_TRIGGERED_VOLTAGE_LEVEL_STATUS IviDCPwrConfigureTriggeredVoltageLevel

CONFIGURE_TRIGGERED_CURRENT_LIMIT_STATUS IviDCPwrConfigureTriggeredCurrentLimit

ABORT_STATUS IviDCPwrAbortINITIATE_STATUS IviDCPwrInitiateSEND_SOFTWARE_TRIGGER_STATUS IviDCPwrSend

SoftwareTriggerMEASURE_STATUS IviDCPwrMeasure

IviDmmClassDriverReferenceforLabVIEWConceptsIviDmmClassDriverOverviewIviDmmExtensionCapabilityGroupsIviDmmBehaviorModels

IviDmmVIandPropertyReferenceIviDmmVITreeIviDmmPropertiesbyGroupIviDmmPropertyValueDefinitionsIviDmmErrorandCompletionCodesOtherReferenceInterchangeabilityCheckingSimulation

IviDmmClassDriverOverviewThisinstrumentdriverprovidesprogrammingsupportfortheIviDmmClass.TheIviDmmclassisdesignedtosupportthetypicalDMMaswellascommonextendedfunctionalityfoundinmorecomplexinstruments.TheIviDmmclassdriverconceptualizesaDMMasaninstrumentthatcanmeasurescalarquantitiesofaninputsignalandcanbeappliedtoawidevarietyofinstruments.Typicallythemeasuredquantityisavoltage(ACandDC),current,orresistance.However,theIviDmmclassdrivercansupportinstrumentsthatmeasureotherquantitiessuchastemperatureandfrequency.ThedrivercontainsalltheVIsthattheIVIFoundationrequiresfortheIviDmmspecification.ThisdriverrequiresNI-VISAandtheIVICompliancePackagetobeinstalled.TheIviDmmclassisdividedintoaIviDmmBasecapabilitygroupandseveralextensiongroups.ThebasecapabilitygroupisusedtoconfigureaDMMforatypicalmeasurement(whichincludessettingthemeasurementVI,desiredrange,desiredresolution,andtriggersource),initiatingthatmeasurement,andreturningameasuredvalue.ManyDMMssupportmeasurementtypesthatrequireadditionalparameterstobeconfigured,suchastheminimumandmaximumfrequencyoftheinputsignalforACmeasurements.TheIviDmmclassdefinesextensiongroupsforeachmeasurementtypethatrequirestheseadditionalparameters.TheIviDmmclassalsodefinesanextensiongroupcalledIviDmmMultiPoint.TheIviDmmMultiPointextensiongroupisusedtoconfigureDMMsthatcanacquiremultiplemeasurementsbasedonmultipletriggersandtakemultiplemeasurementspertrigger.ThistypeofinstrumentusedinconjunctionwithascanneristypicallyusedtoimplementascanningDMM.Inaddition,theIviDmmclassdefinesextensiongroupsthatconfigureadvancedsettingssuchasauto-zeroandpowerlinefrequency,orreturnadditionalinformationaboutthecurrentstateoftheinstrumentsuchasaperturetime.UsethisdrivertodevelopprogramsthatareindependentofaparticularDMM.YoucanusethisclassdriverwithanyDMMthathasanIVIinstrumentspecificdriverthatiscompliantwiththeIviDmmclass.TheIviDmmclassdriveraccessesthespecificdriverforyourinstrumentusing

theconfigurationinformationyousupplywithMAX.

ExtensionCapabilityGroupsTheIviDmmclassdriveridentifiesVIsandpropertiesthatbelongtoanextensiongroupwiththefollowingabbreviations.Instrumentspecificdriversarenotrequiredtoimplementanyoftheextensioncapabilitygroups.IfyouuseVIsandpropertiesthatbelongtoextensioncapabilitygroups,everyinstrumentspecificdriverthatyouusemustimplementthoseextensions.

GroupName Abbreviation DescriptionIviDmmACMeasurement [AC] Definespropertiesthat

configureadditionalsettingsforACmeasurements.Thesepropertiesaretheminimumandmaximumfrequencycomponentsoftheinputsignal.ThisextensiongroupalsodefinesVIsthatconfiguretheseproperties.

IviDmmAutoRangeValue [ARV] SupportsDMMswiththecapabilitytoreturntheactualrangevaluewhenautoranging.

IviDmmAutoZero [AZ] SupportsDMMswiththecapabilitytotakeanautozeroreading.Ingeneral,theauto-zerocapabilityofaDMMnormalizesallmeasurementsbasedonaZeroReading.

IviDmmDeviceInfo [DI] DefinesaVIandasetofpropertiesthatyoucanquerytogain

additionalinformationabouttheinstrument'sconfiguration

IviDmmFrequencyMeasurement [FREQ] SupportsDMMsthattakefrequencymeasurements.Itdefinespropertiesthatarerequiredtoconfigureadditionalparametersneededforfrequencymeasurements.

IviDmmMultiPoint [MP] Supportsinstrumentscapableofacquiringmeasurementsbasedonmultipletriggers,andacquiringmultiplemeasurementsforeachtrigger

IviDmmPowerLineFrequency [PLF] SupportsDMMswiththecapabilitytospecifythepowerlinefrequency.

[RTD] SupportsDMMsthattaketemperaturemeasurementsusingaresistancetemperaturedevice(RTD)transducertype.

IviDmmSoftwareTrigger [SWT] SupportsDMMsthatcaninitiateameasurementbasedonasoftwaretriggersignal.YoucansendasoftwaretriggertocausetheDMMto

initiateameasurement.

IviDmmTemperatureMeasurement [TMP] SupportsDMMsthattaketemperaturemeasurementswithathermocouple,anRTD,orathermistortransducertype.Thisextensiongroupselectsthetransducertype.Othercapabilitygroupsfurtherconfiguretemperaturesettingsbasedonthetransducertype.

IviDmmThermistor [THM] SupportsDMMsthattaketemperaturemeasurementsusingathermistortransducertype.

IviDmmThermocouple [TC] SupportsDMMsthattaketemperaturemeasurementsusingathermocoupletransducertype.

IviDmmTriggerSlope [TS] SupportsDMMsthatcanspecifythepolarityoftheexternaltriggersignal.ItdefinesanpropertyandaVItoconfigurethispolarity.

IviDmmExtensionCapabilityGroupsTheIviDmmclassdriveridentifiesVIsandpropertiesthatbelongtoanextensiongroupwiththefollowingabbreviations.Instrumentspecificdriversarenotrequiredtoimplementanyoftheextensioncapabilitygroups.IfyouuseVIsandpropertiesthatbelongtoextensioncapabilitygroups,everyinstrumentspecificdriverthatyouusemustimplementthoseextensions.

GroupName DescriptionIviDmmACMeasurement Definespropertiesthatconfigure

additionalsettingsforACmeasurements.Thesepropertiesaretheminimumandmaximumfrequencycomponentsoftheinputsignal.ThisextensiongroupalsodefinesVIsthatconfiguretheseproperties.

IviDmmAutoRangeValue SupportsDMMswiththecapabilitytoreturntheactualrangevaluewhenautoranging.

IviDmmAutoZero SupportsDMMswiththecapabilitytotakeanautozeroreading.Ingeneral,theauto-zerocapabilityofaDMMnormalizesallmeasurementsbasedonaZeroReading.

IviDmmDeviceInfo DefinesaVIandasetofpropertiesthatyoucanquerytogainadditionalinformationabouttheinstrument'sconfiguration

IviDmmFrequencyMeasurement SupportsDMMsthattakefrequencymeasurements.Itdefinespropertiesthatarerequiredtoconfigureadditionalparametersneededforfrequencymeasurements.

IviDmmMultiPoint Supportsinstrumentscapableofacquiringmeasurementsbasedon

multipletriggers,andacquiringmultiplemeasurementsforeachtrigger

IviDmmPowerLineFrequency SupportsDMMswiththecapabilitytospecifythepowerlinefrequency.

SupportsDMMsthattaketemperaturemeasurementsusingaresistancetemperaturedevice(RTD)transducertype.

IviDmmSoftwareTrigger SupportsDMMsthatcaninitiateameasurementbasedonasoftwaretriggersignal.YoucansendasoftwaretriggertocausetheDMMtoinitiateameasurement.

IviDmmTemperatureMeasurement SupportsDMMsthattaketemperaturemeasurementswithathermocouple,anRTD,orathermistortransducertype.Thisextensiongroupselectsthetransducertype.Othercapabilitygroupsfurtherconfiguretemperaturesettingsbasedonthetransducertype.

IviDmmThermistor SupportsDMMsthattaketemperaturemeasurementsusingathermistortransducertype.

IviDmmThermocouple SupportsDMMsthattaketemperaturemeasurementsusingathermocoupletransducertype.

IviDmmTriggerSlope SupportsDMMsthatcanspecifythepolarityoftheexternaltriggersignal.ItdefinesanpropertyandaVItoconfigurethispolarity.

IviDmmACMeasurementExtensionGroupTheIviDmmACMeasurementextensiongroupsupportsDMMsthattakeACvoltageorACcurrentmeasurements.ItdefinespropertiesthatconfigureadditionalsettingsforACmeasurements.Thesepropertiesaretheminimumandmaximumfrequencycomponentsoftheinputsignal.ThisextensiongroupalsodefinesVIsthatconfiguretheseproperties.

ACMeasurementExtensionVIIviDmmConfigureACBandwidth

ACMeasurementExtensionPropertiesIviDmmACMinimumFrequencyIviDmmACMaximumFrequencyRelatedTopicsIviDmmBehaviorModelIviDmmVITreeIviDmmProperties

IviDmmAutoRangeValueExtensionGroupTheIviDmmAutoRangeValueextensionsupportsDMMswiththecapabilitytoreturntheactualrangevaluewhenautoranging.

AutoRangeValueExtensionVIIviDmmGetAutoRangeValue

AutoRangeValueExtensionPropertyIviDmmAutoRangeValueRelatedTopicsIviDmmbehaviormodel

IviDmmAutoZeroExtensionGroupTheIviDmmAutoZeroextensiongroupsupportsDMMsthathavethecapabilitytotakeanauto-zeroreading.Ingeneral,theauto-zerocapabilityofaDMMnormalizesallmeasurementsbasedonaZeroReading.

AutoZeroExtensionVIIviDmmConfigureAutoZeroMode

AutoZeroExtensionPropertyIviDmmAutoZeroRelatedTopicsIviDmmbehaviormodel

IviDmmBaseCapabilityGroupTheIviDmmbasecapabilitygroupsupportsDMMsthattakeonemeasurementatatime.TheIviDmmbasecapabilitygroupdefinespropertiesandtheirvaluestoconfigurethetypeofmeasurementandhowthemeasurementisperformed.Thesepropertiesincludethemeasurementfunction,range,resolution,triggersource,andtriggerdelay.TheIviDmmbasecapabilitygroupincludesVIsforconfiguringtheDMMaswellasinitiatingandretrievingmeasurements.

IviDmmBaseVIsIviDmmConfigureMeasurementIviDmmConfigureTriggerIviDmmReadIviDmmAbortIviDmmInitiateIviDmmFetchIviDmmSendSoftwareTriggerIviDmmIsOver-Range

IviDmmBasePropertiesIviDmmFunctionIviDmmRangeIviDmmResolutionIviDmmTriggerSourceIviDmmTriggerDelayRelatedTopicsIVIInherentVIsIVIInherentPropertiesIviDmmBehaviorModelFormoreVIandpropertyinformation:IviDmmVITreeIviDmmProperties

IviDmmDeviceInfoExtensionGroupTheIviDmmDeviceInfocapabilitygroupdefinesasetofread-onlypropertiesthatcanbequeriedtogainadditionalinformationconcerninghowtheDMMispresentlyconfigured.

IviDmmDeviceInfoVIIviDmmGetApertureTimeInfo

IviDmmDeviceInfoPropertiesIviDmmApertureTime[DI]IviDmmApertureTimeUnits[DI]

BehaviorModelIviDmmbehaviormodel

IviDmmFrequencyMeasurementExtensionGroupTheIviDmmFrequencyMeasurementextensiongroupsupportsDMMsthattakefrequencymeasurements.Thisgroupdefinespropertiesthatarerequiredtoconfigureadditionalparametersneededforfrequencymeasurements.

FrequencyMeasurementExtensionVIIviDmmConfigureFrequencyVoltageRange[FRQ]

FrequencyMeasurementExtensionPropertyIviDmmFrequencyVoltageRangeRelatedTopicsIviDmmbehaviormodel

IviDmmMultiPointExtensionGroupTheIviDmmMultiPointextensiongroupdefinesextensionsforDMMscapableofacquiringmeasurementsbasedonmultipletriggers,andacquiringmultiplemeasurementsforeachtrigger.TheIviDmmMultiPointextensiongroupdefinesadditionalpropertiessuchsamplecount,sampletrigger,triggercount,andsampleintervaltocontrolmultipointDMMs.TheIviDmmMultiPointextensiongroupalsoaddsVIsforconfiguringtheDMMaswellasstartingacquisitionsandretrievingmultiplemeasuredvalues.

MultipointExtensionVIsIviDmmConfigureMeasCompleteDestIviDmmConfigureMultipointIviDmmReadMultipointIviDmmFetchMultiplePoint

MultipointExtensionPropertiesIviDmmMeasCompleteDestination[MP]IviDmmSampleCount[MP]IviDmmSampleInterval[MP]IviDmmSampleTrigger[MP]IviDmmTriggerCount[MP]RelatedTopicsIviDmmPropertiesIviDmmVIsIviDmmbehaviormodel

IviDmmPowerLineFrequencyExtensionGroupTheIviDmmPowerLineFrequencyextensiongroupsupportsDMMswiththecapabilitytospecifythepowerlinefrequency.

PowerLineFrequencyExtensionVIIviDmmConfigurePowerLineFrequency[PLF]

PowerLineFrequencyExtensionPropertyIviDmmPowerlineFrequencyRelatedTopicsIviDmmbehaviormodel

IviDmmResistanceTemperatureDeviceExtensionGroupTheIviDmmResistanceTemperatureDeviceextensiongroupsupportsDMMsthattaketemperaturemeasurementsusingaresistancetemperaturedevice(RTD)transducertype.TheIviDmmclassassumesthatyouareusingaPlatinumResistanceTemperatureDevice.

ResistanceTemperatureDeviceExtensionVIIviDmmConfigureRTD

ResistanceTemperatureDeviceExtensionPropertiesIviDmmRTDAlphaIviDmmRTDResistanceRelatedTopicsIviDmmbehaviormodel

IviDmmSoftwareTriggerExtensionGroupTheIviDmmSoftwareTriggerextensiongroupsupportsDMMsthatcaninitiateameasurementbasedonasoftwaretriggersignal.YoucansendasoftwaretriggertocausetheDMMtoinitiateameasurement.

SoftwareTriggerExtensionVIIviDmmSendSoftwareTriggerRelatedTopicsIviDmmbehaviormodel

IviDmmTemperatureMeasurementExtensionGroupTheIviDmmTemperatureMeasurementextensiongroupsupportsDMMsthattaketemperaturemeasurementswithathermocouple,anRTD,orathermistortransducertype.Thisextensiongroupselectsthetransducertype.Othercapabilitygroupsfurtherconfiguretemperaturesettingsbasedonthetransducertype.

TemperatureMeasurementExtensionVIIviDmmConfigureTransducerType

TemperatureMeasurementExtensionPropertyIviDmmTransducerType[TMP]RelatedTopicsIviDmmbehaviormodel

IviDmmThermistorExtensionGroupTheIviDmmThermistorextensiongroupsupportsDMMsthattaketemperaturemeasurementsusingathermistortransducertype.TheIviDmmclassassumesthatyouareusinganinterchangeablethermistor.Interchangeablethermistorsarethermistorsthatexhibitsimilarbehaviorforagivenresistancevalue.

ThermistorExtensionVIIviDmmConfigureThermistor[THM]

ThermistorExtensionPropertyIviDmmThermistorResistanceRelatedTopicsIviDmmbehaviormodel

IviDmmThermocoupleExtensionGroupTheIviDmmThermocoupleextensiongroupsupportsDMMsthattaketemperaturemeasurementsusingathermocoupletransducertype.

ThermocoupleExtensionVIsIviDmmConfigureThermocoupleIviDmmConfigureFixedRefJunction

ThermocoupleExtensionPropertiesIviDmmFixedReferenceJunctionIviDmmReferenceJunctionTypeIviDmmThermocoupleTypeRelatedTopicsIviDmmbehaviormodel

IviDmmTriggerSlopeExtensionGroupTheIviDmmTriggerSlopeextensiongroupsupportsDMMsthatcanspecifythepolarityoftheexternaltriggersignal.ItdefinesanpropertyandaVItoconfigurethispolarity.

TriggerSlopeExtensionVIIviDmmConfigureTriggerSlope

TriggerSlopeExtensionPropertyIviDmmTriggerSlopeRelatedTopicsIviDmmbehaviormodel

IviDmmBehaviorModelsIviDmmIviDmmMultiPointIviDmmSoftwareTrigger

IviDmmBehaviorModelThefollowingstatediagramshowsrelationshipsbetweentheIviDmmbasecapabilitygroupandDMMbehavior.

IviDmmBehaviorModelThemainstateintheIviDmmClassistheIdlestate.TheDMMenterstheIdlestatewhenitispowered-on,whenitsuccessfullycompletesameasurement,orwhenyoucallIviDmmAbortfromapreviousmeasurement.Typically,youconfiguretheDMMwhileitisintheIdlestate.IviDmmpropertiescanbeconfiguredindividuallywiththepropertynodeorwiththehigh-levelIviDmmConfigureMeasurementVI.TheIviDmmReadandIviDmmInitiateVIscausetheDMMtoleavetheIdlestateandtransitiontotheWait-For-Triggerstate.TheIviDmmReadVIdoesnotreturnuntilthemeasurementprocessiscompleteandtheDMMhasreturnedtotheIdlestate.TheIviDmmInitiateVIreturnsassoonastheDMMleavestheIdlestate.TheDMMleavestheWait-For-Triggerstatewhenitreceivesatriggerevent.ThetypeoftriggereventisspecifiedbythepropertyIviDmmTriggerSource.Afterthespecifiedtriggereventoccurs,theDMMwaitstheamountoftimespecifiedbythepropertyIviDmmTriggerDelayandthentakesameasurement.ThetypeofmeasurementisspecifiedbytheIviDmm

Function,IviDmmRange,andIviDmmResolutionproperties.IfyousettheIviDmmFunctionpropertytoavaluethatrequiresanextensioncapabilitygroup,thepropertiesofthatcapabilitygroupfurtherconfigurethemeasurement.Afterthemeasurementistaken,theDMM(ifitiscapableofdoingso)generatestheMeasurementCompletesignalandreturnstotheIdlestate.TheIviDmmbasecapabilitygroupdoesnotrequirethataDMMbeabletogenerateaMeasurementCompletesignal.TheMeasurementCompletesignalispresentedintheBaseCapabilitiesStateDiagramtodefinewhenthesignalisgeneratedasmostDMMsgeneratethissignalbutmaynotbeabletoconfigureit.TheIviDmmFetchVIisusedtoretrievemeasurementsthatwereinitiatedbytheIviDmmInitiateVI.ThemeasurementdatareturnedfromtheIviDmmReadandIviDmmFetchVIsisacquiredaftertheDMMhaslefttheWait-For-Triggerstate.

IviDmmMultiPointBehaviorModelThefollowingstatediagramshowsrelationshipsbetweenIviDmmMultiPointextensiongroupandDMMbehavior.OnlytheelementsaddedbytheIviDmmMultiPointcapabilitygrouparerepresentedinthisstatediagram.

IviDmmMultiPointBehaviorModelTheIviDmmMultiPointbehaviormodelbuildsuponthefundamentalIviDmmbehaviormodelandonlydocumentsadditionalitemsintroducedbytheIviDmmMultiPointextensiongroup.ThemainstateistheIdlestate.Typically,youconfiguretheIviDmmMultiPointpropertieswhileDMMisintheIdlestate.IviDmmMultiPointpropertiescanbeconfiguredindividuallywiththehigh-levelIviDmmConfigureMultiPointVI.TheIviDmmInitiateandIviDmmReadMultiPointVIscausetheDMMtoleavetheIdlestateandtransitiontotheWait-For-Triggerstate.TheIviDmmReadMultiPointVIdoesnotreturnuntilthemeasurementprocessiscompleteandtheDMMreturnstotheIdlestate.TheIviDmmInitiateVIreturnsassoonastheDMMleavestheIdlestate.TheIviDmmMultiPointextensiongroupdoesnotaddadditionalcapabilitiestotheWait-For-Triggerstate.AftertheDMMleavestheWait-For-Triggerstate,itthenexecutesadelay.ThelengthofthedelayisspecifiedbytheIviDmmTriggerDelayproperty.Afterthemeasurementistaken,theDMMthen,ifitiscapableofdoingso,generatestheMeasurementCompletesignal.TheDMMthencomparesthesamplecountwiththenumberofmeasurementstakensincethelasttriggerevent.ThesamplecountisspecifiedbytheIviDmmSampleCount[MP]property.IfthenumbermeasurementsisnotequaltothesamplecounttheDMMmovestotheWait-For-Sample-Triggerstate.TheDMMremainsintheWait-For-Sample-TriggerstateuntiltheeventspecifiedbythepropertyIviDmmSampleTrigger[MP]occurs.Thenittakesanothermeasurement.Oncethenumberofmeasurementstakenisequaltothesamplecount,theDMMthencomparesthenumbertriggercountwiththenumberoftriggereventsthathaveoccurredsinceeithertheIviDmmInitiateorIviDmmReadMultiPointVIwascalled.Thetriggercountisspecifiedby

thepropertyIviDmmTriggerCount[MP].Ifthenumberoftriggereventsisnotequaltothetriggercount,theDMMreturnstotheWait-For-Triggerstate.Oncethenumberoftriggereventsisequaltothetriggercount,theDMMreturnstotheIdlestate.TheIviDmmFetchMultiPointVIisusedtoretrievemeasureddatafrommeasurementsinitiatedbytheIviDmmInitiateVI.ThemeasurementdatareturnedfromtheIviDmmReadMultiPointandIviDmmFetchMultiPointVIsisacquiredaftertheDMMhaslefttheWait-For-Triggerstate.

IviDmmSoftwareTriggerBehaviorModelThebehaviormodeloftheIviDmmSoftwareTriggerfollowsthebehaviormodeloftheIviDmmBasecapabilitygroupandtheIviDmmMultiPointextensiongroup.Itdefinesanadditionaltriggereventforthetriggersource.TheDMMleavestheWait-For-TriggerstatewhenitreceivesatriggereventspecifiedbytheIviDmmTriggerSourceproperty.TheDMMleavestheWait-For-Sample-TriggerstatewhenitreceivesatriggereventspecifiedbytheIviDmmSampleTrigger[MP]property.WhenthetriggersourceorsampletriggerissettoIVIDMM_VAL_SOFTWARE_TRIG,theIviDmmSendSoftwareTriggerVIisusedtogeneratethetriggerevent.CallingthisVIcausestheDMMtotakeameasurement.

IviDmmVITreeTheVItreefortheIviDmmclassdriver,includingIVIandVXIplug&playrequiredVIs,isshowninthefollowingtable.

IviDmmVITreeNameorClass VIName RequiredBy

Initialize IviDmmInitialize

InitializeWithOptions

IviDmmInitializeWithOptions

Configuration

ConfigureMeasurement

IviDmmConfigureMeasurement

SpecificMeasurements

ConfigureACBandwidth[AC]

IviDmmConfigureACBandwidth

IviDmmACMeasurement

ConfigureFrequencyVoltageRange[FRQ]

IviDmmConfigureFrequencyVoltageRange

IviDmmFrequencyMeasurement

Temperature

ConfigureTransducerType[TMP]

IviDmmConfigureTransducerType

IviDmmTemperatureMeasurement

ConfigureThermocouple[TC]

IviDmmConfigureThermocouple

IviDmmThermocouple

ConfigureFixedRefJunction[TC]

IviDmmConfigureFixedRefJunction

IviDmmThermocouple

IviDmm IviDmmResistanceTemperatureDevice

ConfidentRTD[RTD]

ConfigureRTD

ConfigureThermistor[THM]

IviDmmConfigureThermistor

IviDmmThermistor

Trigger

ConfigureTrigger

IviDmmConfigureTrigger

IviDmm

ConfigureTriggerSlope

IviDmmConfigureTriggerSlope

IviDmmTriggerSlope

Multipoint

ConfigureMultipoint[MP]

IviDmmConfigureMultipoint

IviDmmMultiPoint

ConfigureMeasCompleteDest[MP]

IviDmmConfigureMeasCompleteDest

IviDmmMultiPoint

MeasurementOperationOptions

ConfigureAutoZeroMode[AZ]

IviDmmConfigureAutoZeroMode

IviDmmAutoZero

ConfigurePowerLineFrequency[PLF]

IviDmmConfigurePowerLineFrequency

IviDmmPowerLineFrequency

ConfigurationInformation

GetAutoRangeValue[ARV]

IviDmmGetAutoRangeValue

IviDmmAutoRangeValue

GetApertureTimeInfo[DI]

IviDmmGetApertureTimeInfo

IviDmmDeviceInfo

Measurement

Read IviDmmRead IviDmm

ReadMultipoint[MP]

IviDmmReadMultipoint

IviDmmMultiPoint

Low-LevelMeasurement

Initiate IviDmmInitiate IviDmm

SendSoftwareTrigger

IviDmmSendSoftwareTrigger

IviDmmSoftwareTrigger

Fetch IviDmmFetch IviDmm

FetchMultipoint[MP]

IviDmmFetchMultiplePoint

IviDmmMultiPoint

Abort IviDmmAbort IviDmm

IsOverrange IviDmmIsOver-Range

IviDmm

Utility

Reset IviDmmReset VPP

ResetWithDefaults

Self-Test IviDmmSelf-Test

Disable Disable VPP

InvalidateAll InvalidateAllAttributes

Attributes

RevisionQuery

IviDmmRevisionQuery

Error-Query IviDmmError-Query

ErrorMessage IviDmmErrorMessage

IviDmmGetNextInterchangeWarning

IviDmmResetInterchangeCheck

IviDmmClearInterchangeWarnings

CoercionInfo

IviDmmGetNextCoercionRecord

Close IviDmmClose VPP

RelatedTopicsIviDmmPropertiesIVIInherentVIs

IviDmmPropertiesNoteYouusetheLabVIEWPropertyNodetogetandsetproperties.

IviDmmBasePropertiesIviDmmFunctionIviDmmRangeIviDmmResolutionIviDmmTriggerSourceIviDmmTriggerDelay

ACMeasurementPropertiesIviDmmACMinimumFrequencyIviDmmACMaximumFrequency

AutoRangeValuePropertiesIviDmmAutoRangeValue

AutoZeroPropertiesIviDmmAutoZero

DeviceInfoPropertiesIviDmmApertureTime[DI]IviDmmApertureTimeUnits[DI]

FrequencyMeasurementPropertiesIviDmmFrequencyVoltageRange

MultipointPropertiesIviDmmMeasCompleteDestination[MP]IviDmmSampleCount[MP]IviDmmSampleInterval[MP]IviDmmSampleTrigger[MP]IviDmmTriggerCount[MP]

PowerLineFrequencyPropertyIviDmmPowerlineFrequency

ResistanceTemperatureDevicePropertiesIviDmmRTDAlphaIviDmmRTDResistance

TemperatureMeasurementPropertiesIviDmmTransducerType

ThermistorPropertiesIviDmmThermistorResistance

ThermocouplePropertiesIviDmmThermocoupleTypeIviDmmReferenceJunctionTypeIviDmmFixedReferenceJunction

TriggerSlopePropertiesIviDmmTriggerSlope

IviDmmPropertyValueDefinitionsThefollowingtabledefinesvaluesforeachpropertyconstantintheIviDmmclass.

NoteInthefollowingtable,theliteralstringIVIDMMprecedesthepropertyname,andtheliteralstringIVIDMMprecedesthevalueextensionname.

IviDmmPropertyDefinedValues

Property ValueName DefinedValue Definitions

APERTURETIMEUNITS

Seconds 0 ReportsthattheunitsforthevaluereturnedbyIviDmmApertureTimeseconds

PowerLineCycles

1 ReportsthattheunitsforthevaluereturnedbyIviDmmApertureTimePowerlineCycles.

AUTOZER0 Off 0 Disablesauto-ranging.TheDMMsetstherangetothevalueitmostrecentlycalculated.Furtherqueriesofthispropertyreturntheactualrange.

On 1 ConfigurestheDMMtotakeaZeroReadingforeachmeasurement.TheDMMsubtractstheZeroReadingfromthevalueitmeasures.

Once 2 ConfigurestheDMMtocalculatetherangebeforethenextmeasurement.TheDMMusesthisrangevalueforallsubsequentmeasurements.Furtherqueriesofthispropertyshouldreturntheactualrange.

FUNCTION DCVolts 1 SetstheDMMtomeasureDCvoltage.ACVolts 2 SetstheDMMtomeasureACvoltage.DCCurrent 3 SetstheDMMtomeasureDCcurrent.ACCurrent 4 SetstheDMMtomeasureACcurrent.2WireResistance

5 SetstheDMMtomeasure2-wireresistance.

4WireResistance

101 SetstheDMMtomeasure4-wireresistance.

Frequency 104 SetstheDMMtomeasurefrequency.Period 105 SetstheDMMtomeasureperiod.

AC+DCVolts

106 SetstheDMMtomeasureACplusDCvoltage.

AC+DCCurrent

107 SetstheDMMtomeasureACplusDCcurrent.

Temperature 108 SetstheDMMtomeasuretemperatureinCelsius.

MEASCOMPLETEDEST

None -1 Themeasurementcompletesignalisnotrouted.

External 2 Routesthemeasurement-completesignaltotheexternalconnector.

PXITRIG0orVXITTL0

111 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronTTL0.

PXITRIG1orVXITTL1

PXITRIG2orVXITTL2

PXITRIG3orVXITTL3

PXITRIG4orVXITTL4

PXITRIG5orVXITTL5

PXITRIG6orVXITTL6

PXITRIG7orVXITTL7

ECLO 119 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronECL0.

ECL1 120 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronECL1.

PXIStar 131 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronthePXIStartriggerbus.

RTSI0 140RTSI1 141RTSI2 142RTSI3 143RTSI4 144RTSI5 145RTSI6 146

RANGE On -1.0 ConfigurestheDMMtocalculatetherangebeforeeachmeasurementautomatically.WhenthispropertyissettoIVIDMM_VAL_AUTO_RANGE_ONyoucanobtaintheactualrangetheDMMiscurrentlyusingbygettingthevalueoftheIviDmmAutoRangeValueproperty.

Off -2.0 Disablesauto-ranging.TheDMMsetstherangetothevalueitmostrecentlycalculated.Furtherqueriesofthispropertyreturntheactualrange.

Once -3.0 ConfigurestheDMMtocalculatetherangebeforethenextmeasurement.TheDMMusesthisrangevalueforallsubsequentmeasurements.Furtherqueriesofthispropertyshouldreturntheactualrange.

SAMPLETRIGGER

Immediate 1 1

External 2 2SoftwareTriggerFunction

3 TheDMMexitstheWait-For-TriggerstateortheWait-For-Sample-TriggerstatewhentheIviDmmSendSoftwareTriggerVIexecutes.

Interval 10 TheDMMexitstheWait-For-Sample-TriggerstatewhenthelengthoftimespecifiedbytheIviDmmSampleIntervalpropertyelapses.

PXITRIG0orVXITTL0

111 111

PXITRIG1orVXITTL1

112 112

PXITRIG2orVXITTL2

113 113

PXITRIG3orVXITTL3

114 114

PXITRIG4orVXITTL4

115 115

PXITRIG5orVXITTL5

116 116

PXITRIG6orVXITTL6

117 117

PXITRIG7orVXITTL7

118 118

ECL1 120 120PXIStar 131 TheDMMexitstheWait-For-Triggeror

theWait-For-Sample-TriggerstatewhenitreceivesatriggeronthePXIStar

triggerbus.RTSI0 140RTSI1 141RTSI2 142RTSI3 143RTSI4 144RTSI5 145RTSI6 146

TEMPTCREFJUNCTYPE

Internal 1 SetstheDMMtouseafixedvalueforthethermocouplejunctioncompensation.

Fixed 2 SetstheDMMtouseafixedvalueforthethermocouplejunctioncompensation.

TEMPTCTYPE

B 1 SetstheDMMtomeasuretemperaturefromaB-typethermocouple.

C 2 SetstheDMMtomeasuretemperaturefromaC-typethermocouple.

D 3 SetstheDMMtomeasuretemperaturefromaD-typethermocouple.

E 4 SetstheDMMtomeasuretemperaturefromaE-typethermocouple.

G 5 SetstheDMMtomeasuretemperaturefromaG-typethermocouple.

J 6 SetstheDMMtomeasuretemperaturefromaJ-typethermocouple.

K 7 SetstheDMMtomeasuretemperaturefromaK-typethermocouple.

N 8 SetstheDMMtomeasuretemperaturefromaN-typethermocouple.

R 9 SetstheDMMtomeasuretemperaturefromaR-typethermocouple.

S 10 SetstheDMMtomeasuretemperature

fromaS-typethermocouple.T 11 SetstheDMMtomeasuretemperature

fromaT-typethermocouple.U 12 SetstheDMMtomeasuretemperature

fromaU-typethermocouple.V 13 SetstheDMMtomeasuretemperature

fromaV-typethermocouple.TEMPTRANSDUCERTYPE

Thermocouple 1 SetstheDMMtomeasuretemperatureusingathermocouple.UsetheIviDmmThermocoupleextensiongrouptoconfigureadditionalsettingsforthistransducertype.

Thermistor 2 SetstheDMMtomeasuretemperatureusingathermistor.UsetheIviDmmThermistorextensiongroupconfigureadditionalsettingsforthistransducertype.

2-WireRTD 3 SetstheDMMtomeasuretemperatureusinga2-wiretemperatureresistancedevice.UsetheIviDmmResistanceTemperatureDeviceExtensionGrouptoconfigureadditionalsettingsforthistransducertype.

4-WireRTD 4 SetstheDMMtomeasuretemperatureusinga4-wiretemperatureresistancedevice.UsetheIviDmmResistanceTemperatureDeviceExtensionGrouptoconfigureadditionalsettingsforthistransducertype.

TRIGGERDELAY

On -1.0 ConfigurestheDMMtocalculatethetriggerdelaybeforeeachmeasurement.

Off -2.0 StopstheDMMfromcalculatingthetriggerdelay.SetsthetriggerdelaytothelasttriggerdelaytheDMMcalculated.

NoteAfteryousetthispropertyto

IVIDMM_VAL_AUTO_DELAY_OFFfurtherqueriesofthispropertyshouldreturntheactualdelay.

TRIGGERSLOPE

Positive 0 Setsthetriggereventtooccurontherisingedgeofthetriggerpulse.

Negative 1 Setsthetriggereventtooccuronthefallingedgeofthetriggerpulse.

TRIGGERSOURCE

Immediate 1 TheDMMexitstheWait-For-TriggerstateortheWait-For-Sample-Triggerstateimmediatelyafterentering.Itdoesnotwaitforatriggerofanykind.

External 2 TheDMMexitstheWait-For-Triggerstatewhenatriggeroccursontheexternaltriggerinput.

SoftwareTriggerFunction

3 TheDMMexitstheWait-For-TriggerstateortheWait-For-Sample-TriggerstatewhentheIviDmmSendSoftwareTriggerVIexecutes.

PXITRIG0orVXITTL0

PXITRIG1orVXITTL1

PXITRIG2orVXITTL2

PXITRIG3orVXITTL3

PXITRIG4orVXITTL4

PXITRIG5orVXITTL5

116 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-Triggerstatewhen

itreceivesatriggeronTTL5.PXITRIG6orVXITTL6

PXITRIG7orVXITTL7

ECL1 120 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronECL1.

PXIStar 131 TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronthePXIStartriggerbus.

RTSI0 140RTSI1 141RTSI2 142RTSI3 143RTSI4 144RTSI5 145RTSI6 146

RelatedTopicsIviDmmVITreeIviDmmProperties

IviDmmErrorandWarningCodesStatusCodeRangesStatusCodeType NumericRange(inHex)IviDmmErrors 0xBFFA2001to0xBFFA3FFFIviDmmWarnings 0x3FFA2001to0x3FFA3FFFIVISpecificDriverErrors 0xBFFA4000to0xBFFA5FFFIVISpecificDriverWarnings 0x3FFA4000to0x3FFA5FFFIVIErrors 0xBFFA0000to0xBFFA1FFFIVIWarnings 0x3FFA0000to0x3FFA1FFFCommonInstrumentDriverErrors 0xBFFC0000to0xBFFCFFFFCommonInstrumentDriverWarnings 0x3FFC0000to0x3FFCFFFFVISAErrors 0xBFFF0000to0xBFFFFFFFVISAWarnings 0x3FFF0000to0xFFFFFFF

TheIviDmmclassdriverdefinestheerrorcodesshowninthefollowingtableinadditiontotheIVIdefinederrorcodes.

IviDmmErrorCodesError Value MessageIVIDMM_ERROR_MAX_TIME_EXCEEDED 0xBFFA2001 Maximum

timeexceededbeforetheoperationcompleted.

IVIDMM_ERROR_TRIGGER_NOT_SOFTWARE 0xBFFA1001 Thetriggersourceisnotsoftwaretrigger.

IviDmmWarningCodeWarning Value MessageIVIDMM_WARN_OVER_RANGE 0x3FFA2001 OverRangewarning

IviDmmVIsExpandthisbooktoviewanalphabetizedlistofIviDmmVIs.

IviDmmAbortIviDmmBaseCapabilityGroupThisVIabortsapreviouslyinitiatedmeasurementandreturnstheDMMtotheIdlestate.

NoteThisVIdoesnotchecktheinstrumentstatus.Typically,youcallthisVIonlyinasequenceofcallstootherlow-leveldriverVIs.Thesequenceperformsoneoperation.Youusethelow-levelVIstooptimizeoneormoreaspectsofinteractionwiththeinstrument.Ifyouwanttochecktheinstrumentstatus,calltheIviDmmError-QueryVIattheconclusionofthesequence.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDmmConfigureACBandwidthIviDmmACMeasurementCapabilityGroup[AC]ThisVIconfigurestheACminimumandmaximumfrequencyforDMMsthattakeACvoltageorACcurrentmeasurements.ThisVIaffectsthebehavioroftheinstrumentonlyiftheIviDmmFunctionpropertyissettoanACvoltageorACcurrentmeasurement.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.acminfrequency(20.0Hz)PasstheminimumexpectedfrequencycomponentoftheinputsignalinHertz.ThedriversetstheIviDmmACMinimumFrequency[AC]propertytothisvalue.DefaultValue:20.0

acmaxfrequency(300.0E+3Hz)PassthemaximumexpectedfrequencycomponentoftheinputsignalinHertz.ThedriversetstheIviDmmACMaximumFrequency[AC]propertytothisvalue.DefaultValue:300000.0

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.

IviDmmConfigureAutoZeroModeIviDmmAutoZeroCapabilityGroup[AZ]ThisVIconfigurestheauto-zeromodeoftheDMM.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.autozeromode(Off)Specifytheauto-zeromode.ThedriversetstheIviDmmAutoZero[AZ]propertytothisvalue.Whentheauto-zeromodeisenabled,theDMMinternallydisconnectstheinputsignalandtakesaZeroReading.TheDMMthensubtractstheZeroReadingfromthemeasurement.Thispreventsoffsetvoltagespresentintheinstrument'sinputcircuitryfromaffectingmeasurementaccuracy.DefinedValues:IVIDMM_VAL_AUTO_ZERO_ON—ConfigurestheDMMtotakeaZeroReadingforeachmeasurement.TheDMMsubtractstheZeroReadingfromthevalueitmeasures.IVIDMM_VAL_AUTO_ZERO_OFF—Disablestheauto-zerofeature.IVIDMM_VAL_AUTO_ZERO_ONCE—ConfigurestheDMMtotakeaZeroReadingimmediately.TheDMMthensubtractsthisZeroReadingfromallsubsequentvaluesitmeasures.DefaultValue:IVIDMM_VAL_AUTO_ZERO_OFF

IviDmmConfigureFixedRefJunctionIviDmmThermocoupleCapabilityGroup[TC]ThisVIconfiguresthefixedreferencejunctionforathermocouplewithafixedreferencejunctiontype.ThisVIaffectsthebehavioroftheinstrumentonlywhentheIviDmmReferenceJunctionType[TC]propertyissettoIVIDMM_VAL_TEMP_REF_JUNC_FIXED.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.fixedrefjunc(0.0ºCelsius)Passthereferencejunctiontemperaturewhenafixedreferencejunctiontypethermocoupleisusedtotakethetemperaturemeasurement.TheunitsaredegreesCelsius.ThedriversetstheIviDmmFixedReferenceJunction[TC]propertytothisvalue.DefaultValue:0.0ºC

NoteThispropertymayalsobeusedtospecifythethermocouplejunctiontemperatureofaninstrumentthatdoesnothaveaninternaltemperaturesensor.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.erroroutTheerroroutclusterpasseserrororwarninginformation

IviDmmConfigureFrequencyVoltageRangeIviDmmFrequencyMeasurementCapabilityGroup[FRQ]ThisVIconfiguresthefrequencyvoltagerangeoftheDMMforfrequencyandperiodmeasurements.ThisVIaffectsthebehavioroftheinstrumentonlyiftheIviDmmFunctionpropertyissettoIVIDMM_VAL_FREQorIVIDMM_VAL_PERIOD.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.freqvoltrange(10.0VRMS)PasstheexpectedmaximumvalueoftheinputsignalforfrequencyandperiodmeasurementsinvoltsRMS.ThedriversetstheIviDmmFrequencyVoltageRange[FRQ]propertytothisvalue.Thedriverreservesspecialnegativevaluesfortheauto-rangemode.DefinedValues:IVIDMM_VAL_AUTO_RANGE_ON(-1.0)—Auto-rangeOnIVIDMM_VAL_AUTO_RANGE_OFF(-2.0)—Auto-rangeOffDefaultValue:10.0VRMS

IviDmmConfigureMeasCompleteDestIviDmmMultiPointCapabilityGroup[MP]ThisVIconfiguresthedestinationofthemeasurement-completesignal.ThissignaliscommonlyreferredtoasVoltmeterComplete.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.meascompletedest(None)Specifythedestinationofthemeasurement-completesignal.ThedriversetstheIviDmmMeasCompleteDestination[MP]propertytothisvalue.DefinedValues:IVIDMM_VAL_NONE—NoneIVIDMM_VAL_EXTERNAL—ExternalIVIDMM_VAL_TTL0—PXITRIG0orVXITTL0IVIDMM_VAL_TTL1—PXITRIG1orVXITTL1IVIDMM_VAL_TTL2—PXITRIG2orVXITTL2IVIDMM_VAL_TTL3—PXITRIG3orVXITTL3IVIDMM_VAL_TTL4—PXITRIG4orVXITTL4IVIDMM_VAL_TTL5—PXITRIG5orVXITTL5IVIDMM_VAL_TTL6—PXITRIG6orVXITTL6IVIDMM_VAL_TTL7—PXITRIG7orVXITTL7IVIDMM_VAL_ECL0—VXIECL0IVIDMM_VAL_ECL1—VXIECL1IVIDMM_VAL_PXI_STAR—PXIStarIVIDMM_VAL_RTSI_0—RTSIline0

IVIDMM_VAL_RTSI_1—RTSIline1IVIDMM_VAL_RTSI_2—RTSIline2IVIDMM_VAL_RTSI_3—RTSIline3IVIDMM_VAL_RTSI_4—RTSIline4IVIDMM_VAL_RTSI_5—RTSIline5IVIDMM_VAL_RTSI_6—RTSIline6DefaultValue:IVIDMM_VAL_NONE

IviDmmConfigureMeasurementIviDmmBaseCapabilityGroupThisVIconfiguresthecommonpropertiesoftheDMM.Thesepropertiesincludethemeasurementfunction,maximumrange,andresolution.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.measurementfunction(DCVolts)PassthemeasurementVIyouwanttheDMMtoperform.ThedriversetstheIviDmmFunctionpropertytothisvalue.ValidValues:IVIDMM_VAL_DC_VOLTS—DCVoltsIVIDMM_VAL_AC_VOLTS—ACVoltsIVIDMM_VAL_DC_CURRENT—DCCurrentIVIDMM_VAL_AC_CURRENT—ACCurrentIVIDMM_VAL_2_WIRE_RES—2-WireResistanceIVIDMM_VAL_4_WIRE_RES—4-WireResistanceIVIDMM_VAL_AC_PLUS_DC_VOLTS—ACplusDCVoltsIVIDMM_VAL_AC_PLUS_DC_CURRENT—ACplusDCCurrentIVIDMM_VAL_FREQ—FrequencyIVIDMM_VAL_PERIOD—PeriodIVIDMM_VAL_TEMPERATURE—Temperature(C)DefaultValue:IVIDMM_VAL_DC_VOLTS

range(-1.0:Auto)Passthemeasurementrangeyouwanttouse.ThedriversetstheIviDmmRangepropertytothisvalue.

Usepositivevaluestorepresenttheabsolutevalueofthemaximumexpectedmeasurement.ThevaluemustbeinunitsappropriatefortheMeasurementFunction.Forexample,whenyousettheMeasurementFunctiontoIVIDMM_VAL_DC_VOLTS,youmustspecifytheRangeinvolts.Settingthisparameterto10.0configurestheDMMtomeasureDCvoltagesfrom–10.0to+10.0volts.ThedriverreservesspecialnegativevaluesforcontrollingtheDMM'sauto-rangingcapability.DefinedValues:IVIDMM_VAL_AUTO_RANGE_ON(-1.0)—Auto-rangeOnIVIDMM_VAL_AUTO_RANGE_OFF(-2.0)—Auto-rangeOffIVIDMM_VAL_AUTO_RANGE_ONCE(-3.0)—Auto-rangeOnceDefaultValue:IVIDMM_VAL_AUTO_RANGE_ON(-1.0)

1. SettingthisparametertoIVIDMM_VAL_AUTO_RANGE_ONCEconfigurestheDMMtoauto-rangeonce,turnauto-rangeoff,andthenremainatthecurrentmaximumrange.

2. SettingthistoparameterIVIDMM_VAL_AUTO_RANGE_OFFconfigurestheDMMtostopauto-rangingandkeeptherangefixedatthecurrentmaximumrange.

absoluteresolution(0.001)Passyourdesiredmeasurementresolutioninabsoluteunits.ThedriversetstheIviDmmResolutionpropertytothisvalue.ThevaluemustbeinunitsappropriatefortheMeasurementfunction.Settingthisparametertolowervaluesincreasesthemeasurementaccuracy.Settingthisparametertohighervaluesincreasesthemeasurementspeed.DefaultValue:0.001

NoteThisparameterisignorediftheRangeparameterissettoIVIDMM_VAL_AUTO_RANGE_ON.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDmmConfigureMultiPointIviDmmMultiPointCapabilityGroup[MP]ThisVIconfiguresthepropertiesthataffectmultipointmeasurements.Thesepropertiesarethetriggercount,samplecount,sampletriggerandsampleinterval.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.triggercount(1)PassthenumberoftriggersyouwanttheDMMtoreceivebeforereturningtotheIdlestate.ThedriversetstheIviDmmTriggerCount[MP]propertytothisvalue.DefaultValue:1

samplecount(1)PassthenumberofmeasurementsyouwanttheDMMtotakeeachtimeitreceivesatrigger.ThedriversetstheIviDmmSampleCount[MP]propertytothisvalue.DefaultValue:1

sampletrigger(Immediate)Passthetypeofsampletriggeryouwanttouse.ThedriversetstheIviDmmSampleTrigger[MP]propertytothisvalue.WhentheDMMtakesameasurementandtheSampleCountparameterisgreaterthan1,theDMMdoesnottakethenextmeasurementuntiltheeventyouspecifyintheSampleTriggerparameteroccurs.ValidValues:IVIDMM_VAL_IMMEDIATE—ImmediateIVIDMM_VAL_EXTERNAL—ExternalIVIDMM_VAL_SOFTWARE_TRIG—SoftwareTriggerFunction

IVIDMM_VAL_INTERVAL—IntervalIVIDMM_VAL_TTL0—PXITRIG0orVXITTL0IVIDMM_VAL_TTL1—PXITRIG1orVXITTL1IVIDMM_VAL_TTL2—PXITRIG2orVXITTL2IVIDMM_VAL_TTL3—PXITRIG3orVXITTL3IVIDMM_VAL_TTL4—PXITRIG4orVXITTL4IVIDMM_VAL_TTL5—PXITRIG5orVXITTL5IVIDMM_VAL_TTL6—PXITRIG6orVXITTL6IVIDMM_VAL_TTL7—PXITRIG7orVXITTL7IVIDMM_VAL_ECL0—VXIECL0IVIDMM_VAL_ECL1—VXIECL1IVIDMM_VAL_PXI_STAR—PXIStarIVIDMM_VAL_RTSI_0—RTSIline0IVIDMM_VAL_RTSI_1—RTSIline1IVIDMM_VAL_RTSI_2—RTSIline2IVIDMM_VAL_RTSI_3—RTSIline3IVIDMM_VAL_RTSI_4—RTSIline4IVIDMM_VAL_RTSI_5—RTSIline5IVIDMM_VAL_RTSI_6—RTSIline6DefaultValue:IVIDMM_VAL_IMMEDIATE

1. IVIDMM_VAL_IMMEDIATE—TheDMMtakesthenextmeasurementimmediately.TheDMMdoesnotwaitforatriggerofanykind.

2. IVIDMM_VAL_EXTERNAL—TheDMMtakesthenextmeasurementwhenatriggeroccursontheexternaltriggerinput.

3. IVIDMM_VAL_SOFTWARE_TRIG—TheDMMtakesthenextmeasurementwhenyoucalltheSendSoftwareTrigger[SWT]VI.

4. IVIDMM_VAL_INTERVAL—TheDMMtakesthenext

measurementafterwaitingthelengthoftimeyouspecifyintheSampleIntervalparameter.

ThisparameterisignoredifthevalueoftheSampleCountparameteris1.

sampleinterval(0.0s)PassthelengthoftimeyouwanttheDMMtowaitbetweensamples.Expressthisvalueinseconds.ThedriversetstheIviDmmSampleInterval[MP]propertytothisvalue.IftheSampleCountparameterisgreaterthan1andtheSampleTriggerparameterissettoIVIDMM_VAL_INTERVAL,theDMMwaitsbetweenmeasurementsforthelengthoftimeyouspecifywiththisparameter.Otherwise,thispropertydoesnotaffectthebehavioroftheinstrument.DefaultValue:0.0seconds

1. ThisparameterisignoredifthevalueoftheSampleCountparameteris1.

2. ThisparameterisignoredifthevalueoftheSampleTriggerparameterisnotIVIDMM_VAL_INTERVAL.

IviDmmConfigurePowerLineFrequencyIviDmmPowerLineFrequencyCapabilityGroup[PLF]ThisVIconfiguresthepowerlinefrequencyoftheDMM.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.powerlinefrequency(60.0Hz)SpecifythepowerlinefrequencyinHertz.ThedriversetstheIviDmmPowerlineFrequency[PLF]propertytothisvalue.DefaultValue:60.0Hz

IviDmmConfigureRTDIviDmmResistanceTemperatureDeviceCapabilityGroup[RTD]ThisVIconfiguresthealphaandresistanceparametersforaresistancetemperaturedevice.ThisVIaffectsthebehavioroftheinstrumentonlywhentheIviDmmTransducerType[TMP]propertyissettoIVIDMM_VAL_2_WIRE_RTDorIVIDMM_VAL_4_WIRE_RTD.

NoteThedriverassumesthatyouareusingaPlatinumResistanceTemperatureDevice.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.alpha(0.0)Passthealphaparameterforaresistancetemperaturedevice.ThedriversetstheIviDmmRTDAlpha[RTD]propertytothisvalue.DefaultValue:0.0

resistance(0.0ohms)SpecifiestheR0parameter(resistance)foraresistancetemperaturedevice.TheRTDresistanceisalsoknownastheRTDreferencevalue.ThedriversetstheIviDmmRTDResistance[RTD]propertytothisvalue.DefaultValue:0.0ohms

IviDmmConfigureThermistorIviDmmThermistorCapabilityGroup[THM]ThisVIconfigurestheresistanceforathermistortemperaturemeasurementdevice.ThisVIaffectsthebehavioroftheinstrumentonlywhentheIviDmmTransducerTypepropertyissettoIVIDMM_VAL_THERMISTOR.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.resistance(0.0ohms)PasstheresistanceofthethermistorinOhms.ThedriversetstheIviDmmThermistorResistance[THM]propertytothisvalue.DefaultValue:0.0ohms

NoteThedriverassumesthatyouareusinganinterchangeablethermistor.Interchangeablethermistorsarethermistorsthatexhibitsimilarbehaviorforagivenresistancevalue.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDmmConfigureThermocoupleIviDmmThermocoupleCapabilityGroup[TC]ThisVIconfiguresthethermocoupletypeandthereferencejunctiontypeofthethermocoupleforDMMsthattaketemperaturemeasurementsusingathermocoupletransducertype.ThisVIaffectsthebehavioroftheinstrumentonlyiftheIviDmmTransducerType[TMP]propertyissettoIVIDMM_VAL_THERMOCOUPLE.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.thermocoupletype(B)Passthetypeofthermocoupleusedtomeasurethetemperature.ThedriverusesthisvaluetosettheIviDmmThermocoupleType[TC]property.DefinedValues:IVIDMM_VAL_TEMP_TC_BIVIDMM_VAL_TEMP_TC_CIVIDMM_VAL_TEMP_TC_DIVIDMM_VAL_TEMP_TC_EIVIDMM_VAL_TEMP_TC_JIVIDMM_VAL_TEMP_TC_KIVIDMM_VAL_TEMP_TC_NIVIDMM_VAL_TEMP_TC_RIVIDMM_VAL_TEMP_TC_SIVIDMM_VAL_TEMP_TC_TIVIDMM_VAL_TEMP_TC_UIVIDMM_VAL_TEMP_TC_V

DefaultValue:IVIDMM_VAL_TEMP_TC_B

refjunctype(Internal)Passthetypeofreferencejunctiontobeusedinthereferencejunctioncompensationofathermocouplemeasurement.ThedriverusesthisvaluetosettheIviDmmReferenceJunctionType[TC]property.DefinedValues:IVIDMM_VAL_TEMP_REF_JUNC_INTERNAL—TheDMMusesaninternalreferencejunctiontype.IVIDMM_VAL_TEMP_REF_JUNC_FIXED—TheDMMusesafixedvalueforthereferencejunction.UsetheIviDmmConfigureFixedRefJunction[TC]VItospecifythefixedreferencejunctionvalue.DefaultValue:IVIDMM_VAL_TEMP_REF_JUNC_INTERNAL

IviDmmConfigureTransducerTypeIviDmmTemperatureMeasurementCapabilityGroup[TMP]ThisVIconfigurestheDMMtotaketemperaturemeasurementsfromaspecifiedtransducertype.ThisVIaffectsthebehavioroftheinstrumentonlywhentheIviDmmFunctionpropertyissetto.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.transducertype(Thermocouple)Passthetypeofdeviceusedtomeasurethetemperature.ThedriverusesthisvaluetosettheIviDmmTransducerType[TMP]property.DefinedValues:IVIDMM_VAL_THERMOCOUPLE—ThermocoupleIVIDMM_VAL_THERMISTOR—ThermistorIVIDMM_VAL_2_WIRE_RTD—2WireResistanceTemperatureDeviceIVIDMM_VAL_4_WIRE_RTD—4WireResistanceTemperatureDeviceDefaultValue:

IviDmmConfigureTriggerIviDmmBaseCapabilityGroupThisVIconfiguresthecommonDMMtriggerproperties.Thesepropertiesarethetriggersourceandtriggerdelay.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.triggersource(Immediate)Specifythetriggersourceyouwanttouse.ThedriversetstheIviDmmTriggerSourcepropertytothisvalue.AfteryoucalltheReadorInitiateVI,theDMMwaitsforthetriggeryouspecifyinthisparameter.Afteritreceivesthetrigger,theDMMwaitsthelengthoftimeyouspecifyintheTriggerDelayparameter.TheDMMthentakesameasurement.ValidValues:IVIDMM_VAL_IMMEDIATE—ImmediateIVIDMM_VAL_EXTERNAL—ExternalIVIDMM_VAL_SOFTWARE_TRIG—SoftwareTriggerFunctionIVIDMM_VAL_TTL0—PXITRIG0orVXITTL0IVIDMM_VAL_TTL1—PXITRIG1orVXITTL1IVIDMM_VAL_TTL2—PXITRIG2orVXITTL2IVIDMM_VAL_TTL3—PXITRIG3orVXITTL3IVIDMM_VAL_TTL4—PXITRIG4orVXITTL4IVIDMM_VAL_TTL5—PXITRIG5orVXITTL5IVIDMM_VAL_TTL6—PXITRIG6orVXITTL6IVIDMM_VAL_TTL7—PXITRIG7orVXITTL7IVIDMM_VAL_ECL0—VXIECL0

IVIDMM_VAL_ECL—VXIECL1IVIDMM_VAL_PXI_STAR—PXIStarIVIDMM_VAL_RTSI_0—RTSIline0IVIDMM_VAL_RTSI_1—RTSIline1IVIDMM_VAL_RTSI_2—RTSIline2IVIDMM_VAL_RTSI_3—RTSIline3IVIDMM_VAL_RTSI_4—RTSIline4IVIDMM_VAL_RTSI_5—RTSIline5IVIDMM_VAL_RTSI_6—RTSIline6DefaultValue:IVIDMM_VAL_IMMEDIATE

1. IVIDMM_VAL_IMMEDIATE—TheDMMdoesnotwaitforatriggerofanykind.

2. IVIDMM_VAL_EXTERNAL—TheDMMwaitsforatriggerontheexternaltriggerinput.

3. IVIDMM_VAL_SOFTWARE_TRIG—TheDMMwaitsuntilyoucalltheSendSoftwareTrigger[SWT]VI.

triggerdelay(0.0s)Passthevalueyouwanttouseforthetriggerdelay.Expressthisvalueinseconds.ThedriversetstheIviDmmTriggerDelaypropertytothisvalue.ThetriggerdelayspecifiesthelengthoftimetheDMMwaitsafteritreceivesthetriggerandbeforeittakesameasurement.Usepositivevaluestosetthetriggerdelayinseconds.ThedriverreservesnegativevaluesforconfiguringtheDMMtocalculatethetriggerdelayautomatically.DefaultValue:0.0seconds

1. SettingthisparametertoIVIDMM_VAL_AUTO_DELAY_ON(-1.0)configurestheDMMtocalculatethetriggerdelaybeforeeachmeasurement.

2. SettingthisparametertoIVIDMM_VAL_AUTO_DELAY_OFF

(-2.0)stopstheDMMfromcalculatingthetriggerdelayandsetsthetriggerdelaytothelastautomaticallycalculatedvalue.

IviDmmConfigureTriggerSlopeIviDmmTriggerSourceCapabilityGroup[TS]ThisVIconfiguresthepolarityoftheexternaltriggersourceoftheDMM.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.triggerslope(0:Positive)Passthepolarityoftheexternaltriggerslope.ThedriversetstheIviDmmTriggerSlope[TS]propertytothisvalue.TheDMMtriggersoneithertherisingorthefallingedgeoftheexternaltriggersourcedependingonthevalueofthisproperty.DefinedValues:IVIDMM_VAL_POSITIVE-Thedrivertriggersontherisingedgeoftheexternaltrigger.IVIDMM_VAL_NEGATIVE-Thedrivertriggersonthefallingedgeoftheexternaltrigger.Default:IVIDMM_VAL_POSITIVE

IviDmmFetchIviDmmBaseCapabilityGroupThisVIreturnsthevaluefromapreviouslyinitiatedmeasurement.YoumustfirstcalltheIviDmmInitiateVItoinitiateameasurementbeforecallingthisVI.

1. AfterthisVIexecutes,theReadingparametercontainsanactualreadingoravalueindicatingthatanoverrangeconditionoccurred.

2. Ifanoverrangeconditionoccurs,theReadingparametercontainsanIEEE-definedNaN(NotaNumber)valueandtheVIreturnstheIVIDMM_WARN_OVER_RANGE(0x3FFA2001)warningcode.

3. YoucantestthemeasurementvalueforanoverrangeconditionbycallingtheIviDmmIsOver-RangeVI.

4. TheclassdriverreturnsasimulatedmeasurementwhenthisVIiscalledandtheIviDmmSimulatepropertyissettoTRUEandtheIviDmmUseSpecificSimulationpropertyissettoFALSE.Forinformationonhowtoconfigureasimulatedmeasurement,refertoNationalInstrumentsIVIDriverHelp»IVIClassDriverSimulationOverview.

5. ThisVIdoesnotchecktheinstrumentstatus.Typically,youcallthisVIonlyinasequenceofcallstootherlow-leveldriverVIs.Thesequenceperformsoneoperation.Youusethelow-levelVIstooptimizeoneormoreaspectsofinteractionwiththeinstrument.Ifyouwanttochecktheinstrumentstatus,calltheIviDmmError-QueryVIattheconclusionofthesequence.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.

maximumtime(5000ms)Passthemaximumlengthoftimeinwhichtoallowthefetchoperationtocomplete.Expressthisvalueinmilliseconds.Iftheoperationdoesnotcompletewithinthistimeinterval,theVIreturnstheIVIDMM_ERROR_MAX_TIME_EXCEEDED(0xBFFA2003)errorcode.Whenthisoccurs,youcancallIviDmmAborttocancelthefetchoperationandreturntheinstrumenttotheIdlestate.DefinedValues:IVIDMM_VAL_MAX_TIME_INFINITE(-1)—Waitindefinitelyforatimeout.IVIDMM_VAL_MAX_TIME_IMMEDIATE(0)—Donotwaitforatimeout.DefaultValue:5000(ms)

NoteTheMaximumTimeparameteraffectsonlythisVI.Ithasnoeffectonothertimeoutparametersorproperties.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.readingReturnsthemeasuredvalue.ThevalueyouspecifyfortheMeasurementFunctionparameteroftheIviDmmConfigureMeasurementVIdeterminestheunitsofthisparameterasshowninthefollowingtable.DCVolts voltsACVolts voltsDCCurrent amperesACCurrent amperes2-WireResistance ohms4-WireResistance ohms

ACplusDCVolts volts

ACplusDCCurrent amperesTemperature CelsiusFrequency hertzPeriod secondsNotes

IviDmmFetchMultiPointIviDmmMultiPointCapabilityGroup[MP]ThisVIreturnsanarrayofvaluesfromapreviouslyinitiatedmultipointmeasurement.ThenumberofmeasurementstheDMMtakesisdeterminedbythevaluesyouspecifyfortheTriggerCountandSampleCountparametersoftheIviDmmConfigureMulti-Point[MP]VI.CalltheIviDmmInitiateVItoinitiateameasurementbeforecallingthisVI.

1. AfterthisVIexecutes,eachelementintheReadingArrayparameterisanactualreadingoravalueindicatingthatanoverrangeconditionoccurred.

2. Ifanoverrangeconditionoccurs,thecorrespondingReadingArrayelementcontainsanIEEE-definedNaN(NotaNumber)valueandtheVIreturnsIVIDMM_WARN_OVER_RANGE(0x3FFA2001).

3. YoucantesteachelementintheReadingArrayparameterforoverrangewiththeIviDmmIsOver-RangeVI.

4. TheclassdriverreturnsasimulatedmeasurementwhenthisVIiscalledandtheIviDmmSimulatepropertyissettoTRUEandtheIviDmmUseSpecificSimulationpropertyissettoFALSE.Forinformationonhowtoconfigureasimulatedmeasurement,refertoNationalInstrumentsIVIDriverHelp»IVIClassDriverSimulationOverview.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.maximumtime(5000ms)Passthemaximumlengthoftimeinwhichtoallowthemultipointfetchoperationtocompleteexpressedinmilliseconds.Iftheoperationdoesnotcompletewithinthistimeinterval,theVIreturnstheIVIDMM_ERROR_MAX_TIME_EXCEEDED(0xBFFA2003)errorcode.Whenthisoccurs,youcancallIviDmmAborttocancelthemultipointfetchoperationandreturntheinstrumenttotheIdlestate.DefinedValues:IVIDMM_VAL_MAX_TIME_INFINITE(1)—Waitindefinitelyforatimeout.IVIDMM_VAL_MAX_TIME_IMMEDIATE(0)—Donotwaitforatimeout.DefaultValue:5000ms

NoteTheMaximumTimeparameteraffectsonlythisVI.Ithasnoeffectonothertimeoutparametersorproperties.arraysize(1)PassthenumberofelementsintheReadingArrayparameter.DefaultValue:1

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.readingarrayReturnsanarrayofthemostrecentmeasurementvalues.ThevalueyouspecifyfortheMeasurementFunctionparameteroftheIviDmmConfigureMeasurementVIdeterminestheunitsofthisparameter,asshowninthefollowingtable.

DCVolts voltsACVolts voltsDCCurrent amperesACCurrent amperes2-WireResistance ohms4-WireResistance ohmsACplusDCVolts voltsACplusDCCurrent amperesTemperature CelsiusFrequency hertzPeriod secondsNotes

1. Ifanoverrangeconditionoccurs,thecorrespondingReadingArrayelementcontainsanIEEE-definedNaN(NotaNumber)valueandtheVIreturnstheIVIDMM_WARN_OVER_RANGE(0x3FFA2001)warningcode.

2. YoucantesteachelementintheReadingArrayparameterforanoverrangeconditionbycallingtheIviDmmIsOver-RangeVI.

actualnumberofpointsIndicatesthenumberofmeasuredvaluestheVIplacesintheReadingArrayparameter.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDmmGetApertureTimeInfoIviDmmDeviceInfoCapabilityGroup[DI]ThisVIreturnsadditionalinformationaboutthestateoftheinstrument.Specifically,itreturnstheaperturetimeandtheaperturetimeunits.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.aperturetime(sec)ReturnsthevalueoftheIviDmmApertureTime[DI]property.TheunitsofthispropertydependonthevalueoftheIviDmmApertureTimeUnits[DI]property.

aperturetimeunitsReturnsthevalueoftheIviDmmApertureTimeUnits[DI]property.DefinedReturnValues:IVIDMM_VAL_SECONDS(0)—SecondsIVIDMM_VAL_POWER_LINE_CYCLES(1)—Powerlinecycles

IviDmmGetAutoRangeValueIviDmmAutoRangeValueCapabilityGroup[ARV]ThisVIreturnstheactualrangetheDMMiscurrentlyusing,evenwhileitisauto-ranging.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.actualrangeReturnsthevalueoftheIviDmmAutoRangeValueproperty.TheunitsofthereturnedvaluedependonthevalueoftheIviDmmFunctionproperty.

IviDmmInitiateIviDmmBaseCapabilityGroupThisVIinitiatesameasurement.AfteryoucallthisVI,theDMMleavestheIdlestateandwaitsforatrigger.Details.

IviDmmInitiateDetailsThisVIappliesdefaultvaluestopropertiesthathavenotbeensetbyyouunderthefollowingconditions:

1. IfyouhavenotsetthevalueofanypropertyintheIviDmmMultiPointextensiongroup,theVIsetstheIviDmmSampleCount[MP]andIviDmmTriggerCount[MP]propertiesto1.

2. IfyouhavenotsetthevalueoftheIviDmmAutoZero[AZ]property,theVIsetsthevalueofthispropertyto

IVIDMM_VAL_AUTO_ZERO_OFF(0).

2. ThisVIperformsinterchangeabilitycheckingwhentheIviDmmInterchangeCheckpropertyissettoTRUE.UseNISpytoviewinterchangeabilitywarnings.Alternately,youmayusetheIviDmmGetNextInterchangeWarningVItoretrieveinterchangeabilitywarnings.Formoreinformationaboutinterchangeabilitychecking,refertotheIviDmmInterchangeCheckproperty.

3. TheclassdriverinitiatesasimulatedmeasurementwhenthisVIiscalledandtheIviDmmSimulatepropertyissettoTRUEandtheIviDmmUseSpecificSimulationpropertyissettoFALSE.Forinformationonhowtoconfigureasimulatedmeasurement,refertoNationalInstrumentsIVIDriverHelp»IVIClassDriverSimulationOverview.

IviDmmIsOver-RangeIviDmmBaseCapabilityGroupThisVItakesameasurementvaluethatyouobtainfromeithertheReadorFetchVIsanddeterminesifthevalueisavalidmeasurementvalueoravalueindicatingthatanoverrangeconditionoccurred.

NoteThisVIdoesnotchecktheinstrumentstatus.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.measurementvaluePassthemeasurementvaluethatyouobtainfromeithertheReadorFetchVI.Thedriverteststhisvaluetodetermineifthevalueisavalidmeasurementvalueoravalueindicatingthatanoverrangeconditionoccurred.DefaultValue:0.0

NoteIfanoverrangeconditionoccurs,themeasurementvaluecontainsanIEEE-definedNaN(NotaNumber)valueindicatingthatanoverrangeoccurred.errorin(noerror)TheerrorinclustercanaccepterrorinformationwiredfromVIspreviouslycalled.UsethisinformationtodecideifanyfunctionalityshouldbebypassedintheeventoferrorsfromotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.isoverrangeReturnswhetherthemeasuredvalueisavalidmeasurementoravalueindicatingthatanoverrangeconditionoccurred.

ReturnValues:True—Thevalueindicatesanoverrangeconditionoccurred.False—Thevalueisavalidmeasurement.

NoteIfanoverrangeconditionoccurs,themeasurementvaluecontainsanIEEE-definedNaN(NotaNumber)valueindicatingthatanoverrangeoccurred.erroroutTheerroroutclusterpasseserrororwarninginformationoutofaVItobeusedbyotherVIs.Thepop-upoptionExplainError(orExplainWarning)givesmoreinformationabouttheerrordisplayed.

IviDmmReadIviDmmBaseCapabilityGroupThisVIinitiatesameasurement,waitsuntiltheDMMhasreturnedtotheIdlestate,andreturnsthemeasuredvalue.ThisVIappliesdefaultvaluestopropertiesthathavenotbeensetbyyouunderthefollowingconditions:

2. IfyouhavenotsetthevalueoftheIviDmmAutoZero[AZ]property,theVIsetsthevalueofthispropertytoIVIDMM_VAL_AUTO_ZERO_OFF(0).

1. AfterthisVIexecutes,theReadingparametercontainsanactualreadingoravalueindicatingthatanoverrangeconditionoccurred.

2. Ifanoverrangeconditionoccurs,theReadingparametercontainsanIEEE-definedNaN(NotaNumber)valueandtheVIreturnstheIVIDMM_WARN_OVER_RANGE(0x3ffA2001)warningcode.

4. ThisVIperformsinterchangeabilitycheckingwhentheIviDmmInterchangeCheckpropertyissettoTRUE.UseNISpytoviewinterchangeabilitywarnings.Alternately,youmayusetheIviDmmGetNextInterchangeWarningVItoretrieveinterchangeabilitywarnings.Formoreinformationaboutinterchangeabilitychecking,refertotheIviDmmInterchange

Checkproperty.5. Theclassdriverreturnsasimulatedmeasurementwhenthis

VIiscalledandtheIviDmmSimulatepropertyissettoTRUEandtheIviDmmUseSpecificSimulationpropertyissettoFALSE.Forinformationonhowtoconfigureasimulatedmeasurement,refertoNationalInstrumentsIVIDriverHelp»IVIClassDriverSimulationOverview.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.maximumtime(5000ms)Passthemaximumlengthoftimeinwhichtoallowthereadoperationtocomplete.Expressthisvalueinmilliseconds.Iftheoperationdoesnotcompletewithinthistimeinterval,theVIreturnstheIVIDMM_ERROR_MAX_TIME_EXCEEDED(0xBFFA2003)errorcode.Whenthisoccurs,youcancallIviDmmAborttocancelthereadoperationandreturntheinstrumenttotheIdlestate.DefinedValues:IVIDMM_VAL_MAX_TIME_INFINITE(-1)—Waitindefinitelyforatimeout.IVIDMM_VAL_MAX_TIME_IMMEDIATE(0)—Donotwaitforatimeout.DefaultValue:5000(ms)

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.readingReturnsthemeasuredvalue.Thevalueyouspecifyforthe

MeasurementFunctionparameteroftheIviDmmConfigureMeasurementVIdeterminestheunitsofthisparameterasshowninthefollowingtable.DCVolts voltsACVolts voltsDCCurrent amperesACCurrent amperes2-WireResistance ohms4-WireResistance ohmsACplusDCVolts voltsACplusDCCurrent amperesTemperature CelsiusFrequency hertzPeriod secondsNotes

IviDmmReadMultiPointIviDmmMultiPointCapabilityGroup[MP]ThisVIinitiatesthemeasurement,waitsfortheDMMtoreturntotheIdlestate,andreturnsanarrayofmeasuredvalues.ThenumberofmeasurementstheDMMtakesisdeterminedbythevaluesyouspecifyfortheTriggerCountandSampleCountparametersoftheIviDmmConfigureMultiPoint[MP]VI.ThisVIappliesdefaultvaluestopropertiesthatyouhavenotsetunderthefollowingconditions:

2. IfyouhavenotsetthevalueoftheIviDmmAutoZero[AZ]property,theVIsetsthevalueofthispropertytoIVIDMM_VAL_AUTO_ZERO_OFF(0).

1. AfterthisVIexecutes,eachelementintheReadingArrayparameterisanactualreadingoravalueindicatingthatanoverrangeconditionoccurred.

4. ThisVIperformsinterchangeabilitycheckingwhentheIviDmm

InterchangeCheckpropertyissettoTRUE.UseNISpytoviewinterchangeabilitywarnings.Alternately,youmayusetheIviDmmGetNextInterchangeWarningVItoretrieveinterchangeabilitywarnings.Formoreinformationaboutinterchangeabilitychecking,refertotheIviDmmInterchangeCheckproperty.

5. TheclassdriverinitiatesanarrayofsimulatedmeasurementswhenthisVIiscalledandtheIviDmmSimulatepropertyissettoTRUEandtheIviDmmUseSpecificSimulationpropertyissettoFALSE.Forinformationonhowtoconfigureasimulatedmeasurement,refertoNationalInstrumentsIVIDriverHelp»IVIClassDriverSimulationOverview.

instrumenthandleTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.maximumtime(5000ms)Passthemaximumlengthoftimeinwhichtoallowthemultipointreadoperationtocomplete.Expressthisvalueinmilliseconds.Iftheoperationdoesnotcompletewithinthistimeinterval,theVIreturnstheIVIDMM_ERROR_MAX_TIME_EXCEEDED(0xBFFA2003)errorcode.Whenthisoccurs,youcancalltheIviDmmAbortVItocancelthemultipointreadoperationandreturntheinstrumenttotheIdlestate.DefinedValues:IVIDMM_VAL_MAX_TIME_INFINITE(-1)—Waitindefinitelyforatimeout.IVIDMM_VAL_MAX_TIME_IMMEDIATE(0)—Donotwaitforatimeout.DefaultValue:5000ms

NoteTheMaximumTimeparameteraffectsonlythisVI.Ithasnoeffectonothertimeoutparametersorproperties.arraysizePassthenumberofelementsintheReadingArrayparameter.DefaultValue:None

instrumenthandleoutTheinstrumenthandlethatyouobtainfromtheIviDmmInitializeorIviDmmInitializeWithOptionsVI.readingarrayReturnsanarrayofthemostrecentmeasurementvalues.ThevalueyouspecifyfortheMeasurementFunctionparameteroftheIviDmmConfigureMeasurementVIdeterminestheunitsofthisparameterasshowninthefollowingtable:DCVolts voltsACVolts voltsDCCurrent amperesACCurrent amperes2-WireResistance ohms4-WireResistance ohmsACplusDCVolts voltsACplusDCCurrent amperesTemperature CelsiusFrequency hertzPeriod secondsNotes

actualnumberofpointsIndicatesthenumberofmeasuredvaluestheVIplacesintheReadingArrayparameter.erroroutTheerroroutclusterpasseserrororwarninginformation

IviDmmSendSoftwareTriggerIviDmmSoftwareTriggerCapabilityGroupThisVIsendsacommandtotriggertheinstrument.YoumustsatisfycertainconditionsbeforeyoucansuccessfullycallthisVI,TheIviDmmTriggerSourceortheIviDmmSampleTriggerpropertyissettoIVIDMM_VAL_SOFTWARE_TRIG.Ifthisconditionisnottrue,thisVIdoesnotsendthesoftwaretriggerandreturnstheerrorIVIDMM_ERROR_TRIGGER_NOT_SOFTWARE.ThisVIdoesnotchecktheinstrumentstatus.Typically,theend-usercallsthisVIonlyinasequenceofcallstootherlow-leveldriverVIs.Thesequenceperformsoneoperation.Theend-userusesthelow-levelVIstooptimizeoneormoreaspectsofinteractionwiththeinstrument.Tochecktheinstrumentstatus,calltheIviDmmError-QueryVIattheconclusionofthesequence.

IviDmmPropertiesExpandthisbooktoviewanalphabetizedlistofIviDmmproperties.

IviDmmACMaximumFrequency[AC]IviDmmACMeasurementPropertyDataType Access Applies

R/W N/A Up IviDmmConfigureACBandwidth

DescriptionSpecifiesthemaximumfrequencycomponentoftheinputsignalforACmeasurements.ThevalueofthispropertyaffectsinstrumentbehavioronlywhenyousettheIviDmmFunctionpropertytoanACmeasurement.PropertyNodePathIviDmm»ACMeasurements»ACMaximum[AC]

IviDmmACMinimumFrequency[AC]IviDmmACMeasurementPropertyDataType Access Applies

R/W N/A Down IviDmmConfigureACBandwidth

DescriptionSpecifiestheminimumfrequencycomponentoftheinputsignalforACmeasurements.ThevalueofthispropertyaffectsinstrumentbehavioronlywhenyousettheIviDmmFunctionpropertytoanACmeasurement.PropertyNodePathIviDmm»ACMeasurements»ACMinimumFrequency[AC]

IviDmmApertureTime[DI]IviDmmDeviceInfoProperty[DI]DataType Access Applies

RO N/A None IviDmmGetApertureTimeInfo

DescriptionReturnsthemeasurementaperturetimeforthecurrentconfiguration.Theunitsforthispropertyareeithersecondsorpowerlinecycles(PLCs)andaredeterminedbythevalueoftheIviDmmApertureTimeUnits[DI]property.PropertyNodePathIviDmm»ConfigurationInformation»ApertureTime[DI]

IviDmmApertureTimeUnits[DI]IviDmmDeviceInfoProperty[DI]DataType Access Applies

RO N/A None IviDmmGetApertureTimeInfo

DescriptionReturnstheunitsforthepropertyIviDmmApertureTime[DI].PropertyNodePathIviDmm»ConfigurationInformation»ApertureTimeUnits[DI]DefinedValuesIVIDMM_VAL_SECONDSIVIDMM_VAL_POWER_LINE_CYCLES

IviDmmAutoRangeValueAutoRangeValuePropertyDataType Access Applies

RO N/A None IviDmmGetAutoRangeValue

DescriptionAlwaysreturnstheactualrangetheDMMiscurrentlyusing,evenwhentheDMMisauto-ranging.BecausethevalueofthispropertycanchangeastheDMMauto-ranges,youshouldnevercachethisproperty.PropertyNodePathIviDmm»ConfigurationInformation»AutoRangeValue

IviDmmAutoZero[AZ]AutoZeroPropertyDataType Access Applies

R/W N/A None IviDmmConfigureAutoZeroMode

DescriptionSpecifiestheauto-zeromode.Ingeneral,theauto-zerocapabilityofaDMMnormalizesallmeasurementsbasedonaZeroReading.Whenautozeroingisenabled,theDMMinternallydisconnectstheinputsignalandtakesaZeroReading.TheDMMthensubtractstheZeroReadingfromthemeasurement,whichpreventsoffsetvoltagespresentintheDMM'sinputcircuitryfromaffectingmeasurementaccuracy.PropertyNodePathIviDmm»MeasurementOperationOptions»AutoZero[AZ]DefinedValuesIVIDMM_VAL_AUTO_ZERO_OFFIVIDMM_VAL_AUTO_ZERO_ONIVIDMM_VAL_AUTO_ZERO_ONCE

IviDmmFixedReferenceJunction[TC]ThermocoupleProperty[TC]DataType Access Applies

R/W N/A None IviDmmConfigureFixedRefJunction

DescriptionSpecifiestheexternalreferencejunctiontemperaturewhenafixedreferencejunctiontypethermocoupleisusedtotakethetemperaturemeasurement.ThetemperatureisspecifiedindegreesCelsius.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIviDmmReferenceJunctionType[TC]propertyissettoIVIDMM_VAL_TEMP_REF_JUNC_FIXED.PropertyNodePathIviDmm»TemperatureMeasurements»Thermocouple»FixedReferenceJunction[TC]

IviDmmFrequencyVoltageRange[FRQ]FrequencyMeasurementProperty[FRQ]DataType Access Applies

R/W N/A Up IviDmmConfigureFrequencyVoltageRange

DescriptionSpecifiestheexpectedmaximumvalueoftheinputsignalforfrequencyandperiodmeasurements.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIviDmmFunctionpropertyissettoIVIDMM_VAL_FREQorIVIDMM_VAL_PERIOD.PropertyNodePathIviDmm»FrequencyMeasurements»FrequencyVoltageRange[FRQ]

IviDmmFunctionIviDmmBasePropertyDataType Access Applies

R/W N/A None IviDmmConfigureMeasurement

DescriptionSpecifiesthemeasurementfunction.PropertyNodePathIviDmm»BasicOperation»FunctionDefinedValuesIVIDMM_VAL_DC_VOLTSIVIDMM_VAL_AC_VOLTSIVIDMM_VAL_DC_CURRENTIVIDMM_VAL_AC_CURRENTIVIDMM_VAL_2_WIRE_RESIVIDMM_VAL_FREQIVIDMM_VAL_PERIODIVIDMM_VAL_4_WIRE_RESIVIDMM_VAL_AC_PLUS_DC_VOLTSIVIDMM_VAL_AC_PLUS_DC_CURRENTIVIDMM_VAL_TEMPERATURE

IviDmmMeasCompleteDestination[MP]MultipointPropertyDataType Access Applies

R/W N/A None IviDmmConfigureMeasurementCompleteDestination

DescriptionAftereachmeasurement,theDMMgeneratesameasurement-completesignal.Thispropertyspecifiesthedestinationofthemeasurement-completesignal.ThissignaliscommonlyreferredtoasVoltmeterComplete.PropertyNodePathIviDmm»MultipointAcquisition»MeasCompleteDestination[MP]DefinedValuesIVIDMM_VAL_NONEIVIDMM_VAL_EXTERNALIVIDMM_VAL_TTL0IVIDMM_VAL_TTL1IVIDMM_VAL_TTL2IVIDMM_VAL_TTL3IVIDMM_VAL_TTL4IVIDMM_VAL_TTL5IVIDMM_VAL_TTL6IVIDMM_VAL_TTL7IVIDMM_VAL_ECL0IVIDMM_VAL_ECL1IVIDMM_VAL_PXI_STARIVIDMM_VAL_RTSI_0IVIDMM_VAL_RTSI_1IVIDMM_VAL_RTSI_3

IVIDMM_VAL_RTSI_4IVIDMM_VAL_RTSI_5IVIDMM_VAL_RTSI_6

IviDmmPowerlineFrequency[PLF]PowerLineFrequencyProperty[PLF]DataType Access Applies

R/W N/A None IviDmmConfigurePowerLineFrequency

DescriptionSpecifiesthepowerlinefrequencyinhertz.PropertyNodePathIviDmm»MeasurementOperationOptions»PowerlineFrequency[PLF]

IviDmmRangeIviDmmBasePropertyDataType Access Applies

R/W N/A IviDmmConfigureMeasurement

DescriptionSpecifiesthemeasurementrange.Usepositivevaluestorepresenttheabsolutevalueofthemaximumexpectedmeasurement.ThevalueisinunitsappropriateforthecurrentvalueoftheIviDmmFunctionproperty.Forexample,whenyousettheIviDmmFunctionpropertytoIVIDMM_VAL_DC_VOLTS,theunitsarevolts.Settingthispropertyto10.0configurestheDMMtomeasureDCvoltagesfrom–10.0to+10.0volts.

NoteNegativevaluesarereservedforcontrollingtheDMM'sauto-rangingcapability.

AfteryousetthispropertytoIVIDMM_VAL_AUTO_RANGE_OFForIVIDMM_VAL_AUTO_RANGE_ONCE,furtherqueriesofthispropertyreturntheactualrange.WhenyousetthispropertytoIVIDMM_VAL_AUTO_RANGE_ON,youcanobtaintheactualrangetheDMMiscurrentlyusingbygettingthevalueoftheIviDmmAutoRangeValue[ARV]property.PropertyNodePathIviDmm»BasicOperation»RangeDefinedValuesIVIDMM_VAL_AUTO_RANGE_ONIVIDMM_VAL_AUTO_RANGE_OFFIVIDMM_VAL_AUTO_RANGE_ONCE

IviDmmReferenceJunctionType[TC]ThermocoupleProperty[TC]DataType Access Applies

R/W N/A None IviDmmConfigureThermocouple

DescriptionSpecifiesthetypeofreferencejunctiontobeusedinthereferencejunctioncompensationofathermocouplemeasurement.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIVIDMM_VAL_TEMP_TRANSDUCER_TYPEpropertyissettoIVIDMM_VAL_THERMOCOUPLE.PropertyNodePathIviDmm»TemperatureMeasurements»Thermocouple»ReferenceJunctionType[TC]DefinedValuesIVIDMM_VAL_TEMP_REF_JUNC_INTERNALIVIDMM_VAL_TEMP_REF_JUNC_FIXED

IviDmmResolutionIviScopeBasePropertyDataType Access Applies

R/W N/A Down IviDmmConfigureMeasurement

DescriptionSpecifiesthemeasurementresolutionoftheDMMinabsoluteunits.Settingthispropertytolowervaluesincreasesthemeasurementaccuracy.Settingthispropertytohighervaluesincreasesthemeasurementspeed.PropertyNodePathIviDmm»BasicOperation»Resolution

IviDmmRTDAlpha[RTD]ResistanceTemperatureDeviceProperty[RTD]DataType Access Appliesto Coercion HighLevelVIs

R/W N/A None IviDmmConfigureRTD

DescriptionSpecifiesthealphaparameterforaresistancetemperaturedevice.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIVIDMM_VAL_TEMP_TRANSDUCER_TYPEpropertyissettoIVIDMM_VAL_2_WIRE_RTDorIVIDMM_VAL_4_WIRE_RTD.PropertyNodePathIviDmm»TemperatureMeasurements»ResistanceTemperatureDevice»RTDAlpha[RTD]

IviDmmRTDResistance[RTD]ResistanceTemperatureDeviceProperty[RTD]DataType Access Appliesto Coercion HighLevelVIs

R/W N/A None IviDmmConfigureRTD

DescriptionSpecifiestheR0parameter(resistance)foraresistancetemperaturedevice(RTD).TheRTDresistanceisalsoknownastheRTDreferencevalue.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIVIDMM_VAL_TEMP_TRANSDUCER_TYPEpropertyissettoIVIDMM_VAL_2_WIRE_RTDorIVIDMM_VAL_4_WIRE_RTD.PropertyNodePathIviDmm»TemperatureMeasurements»ResistanceTemperatureDevice»RTDResistance[RTD]

IviDmmSampleCount[MP]MultipointProperty[MP]DataType Access Appliesto Coercion HighLevelVIs

R/W N/A None IviDmmConfigureMultipoint

DescriptionSpecifiesthenumberofmeasurementstheDMMtakeseachtimeitreceivesatrigger.PropertyNodePathIviDmm»MultipointAcquisition»SampleCount[MP]

IviDmmSampleInterval[MP]MultipointPropertyDataType Access Appliesto Coercion HighLevelVIs

R/W N/A Up IviDmmConfigureMultipoint

DescriptionSpecifiestheintervalbetweensamplesinseconds.ThispropertyaffectsinstrumentoperationonlywhentheIviDmmSampleCount[MP]propertyisgreaterthan1andtheIviDmmSampleTrigger[MP]propertyissettoIVIDMM_VAL_INTERVAL.Inthiscase,theDMMwaitsbetweenmeasurementsforthelengththetimeyouspecifywiththisproperty.PropertyNodePathIviDmm»MultipointAcquisition»SampleInterval[MP]

IviDmmSampleTrigger[MP]MultipointPropertyDataType Access Appliesto Coercion HighLevelVIs

DescriptionSpecifiesthesampletriggersource.ThispropertyaffectsinstrumentoperationonlywhentheIviDmmSampleCount[MP]propertyisgreaterthan1.WhentheDMMtakesameasurementandtheIviDmmSampleCount[MP]propertyisgreaterthan1,theDMMdoesnottakethenextmeasurementuntiltheeventyouspecifywiththispropertyoccurs.WhenyousetthispropertytoIVIDMM_VAL_IMMEDIATE,theDMMdoesnotwaitforatriggerofanykindbetweenmeasurements.WhenyousetthispropertytoIVIDMM_VAL_EXTERNAL,theDMMwaitsforatriggerontheexternaltriggerinputbeforeittakesthenextmeasurement.WhenyousetthispropertytoIVIDMM_VAL_SOFTWARE_TRIG,theDMMwaitsuntilyoucalltheIviDmmSendSoftwareTrigger[SWT]VIbeforeittakesthenextmeasurement.WhenyousetthispropertytoIVIDMM_VAL_INTERVAL,theDMMwaitsthelengthoftimeyouspecifywiththeIviDmmSampleInterval[MP]propertybeforeittakesthenextmeasurement.PropertyNodePathIviDmm»MultipointAcquisition»SampleTrigger[MP]DefinedValuesIVIDMM_VAL_IMMEDIATEIVIDMM_VAL_EXTERNALIVIDMM_VAL_SOFTWARE_TRIGIVIDMM_VAL_INTERVALIVIFGEN_VAL_TTL0IVIFGEN_VAL_TTL1IVIFGEN_VAL_TTL2IVIFGEN_VAL_TTL3

IVIFGEN_VAL_TTL4IVIFGEN_VAL_TTL5IVIFGEN_VAL_TTL6IVIFGEN_VAL_TTL7IVIFGEN_VAL_ECL0IVIFGEN_VAL_ECL1IVIFGEN_VAL_PXI_STARIVIFGEN_VAL_RTSI_0IVIFGEN_VAL_RTSI_1IVIFGEN_VAL_RTSI_2IVIFGEN_VAL_RTSI_3IVIFGEN_VAL_RTSI_4IVIFGEN_VAL_RTSI_5IVIFGEN_VAL_RTSI_6

IviDmmThermistorResistance[THM]ThermistorProperty[THM]DataType Access Appliesto Coercion HighLevelVIs

R/W N/A None IviDmmConfigureThermistor

DescriptionSpecifiestheresistanceofthethermistorinOhms.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIviDmmTransducerType[TMP]propertyissettoIVIDMM_VAL_THERMISTOR.PropertyNodePathIviDmm»TemperatureMeasurements»Thermistor»ThermistorResistance[THM]

IviDmmThermocoupleType[TC]ThermocoupleProperty[TC]DataType Access Applies

R/W N/A None IviDmmConfigureThermocouple

DescriptionSpecifiesthetypeofthermocoupleusedtomeasurethetemperature.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIVIDMM_VAL_TEMP_TRANSDUCER_TYPEissettoIVIDMM_VAL_THERMOCOUPLE.PropertyNodePathIviDmm»TemperatureMeasurements»Thermocouple»ThermocoupleType[TC]DefinedValuesIVIDMM_VAL_TEMP_TC_BIVIDMM_VAL_TEMP_TC_CIVIDMM_VAL_TEMP_TC_DIVIDMM_VAL_TEMP_TC_EIVIDMM_VAL_TEMP_TC_GIVIDMM_VAL_TEMP_TC_JIVIDMM_VAL_TEMP_TC_KIVIDMM_VAL_TEMP_TC_NIVIDMM_VAL_TEMP_TC_RIVIDMM_VAL_TEMP_TC_SIVIDMM_VAL_TEMP_TC_TIVIDMM_VAL_TEMP_TC_UIVIDMM_VAL_TEMP_TC_V

IviDmmTransducerType[TMP]TemperatureMeasurementProperty[TMP]DataType Access Applies

R/W N/A None IviDmmConfigureTransducerType

DescriptionSpecifiesthedeviceusedtomeasurethetemperature.ThevalueofthispropertyaffectsinstrumentbehavioronlywhentheIviDmmFunctionpropertyissettoIVIDMM_VAL_TEMPERATURE.PropertyNodePathIviDmm»TemperatureMeasurements»TransducerType[TMP]DefinedValuesIVIDMM_VAL_THERMOCOUPLEIVIDMM_VAL_THERMISTORIVIDMM_VAL_2_WIRE_RTDIVIDMM_VAL_4_WIRE_RTD

IviDmmTriggerCount[MP]MultipointProperty[MP]DataType Access Appliesto Coercion HighLevelVIs

DescriptionSpecifiesthenumberoftriggerstheDMMacceptsbeforeitreturnstotheIdlestate.PropertyNodePathIviDmm»MultipointAcquisition»TriggerCount[MP]

IviDmmTriggerDelayIviScopeBasePropertyDataType Access Applies

R/W N/A Seenotebelow.

IviDmmConfigureTrigger

DescriptionSpecifiesthelengthoftimetheDMMwaitsafteritreceivesthetriggerandbeforeittakesameasurement.Usepositivevaluestosetthetriggerdelayinseconds.

NoteNegativevaluesarereservedforconfiguringtheDMMtocalculatethetriggerdelayautomatically.

SettingthispropertytoIVIDMM_VAL_AUTO_DELAY_ONconfigurestheDMMtocalculatethetriggerdelaybeforeeachmeasurement.SettingthispropertytoIVIDMM_VAL_AUTO_DELAY_OFFstopstheDMMfromcalculatingthetriggerdelayandsetsthetriggerdelaytothelastautomaticallycalculatedvalue.PropertyNodePathIviDmm»BasicOperation»TriggerDelayDefinedValuesIVIDMM_VAL_AUTO_DELAY_ONIVIDMM_VAL_AUTO_DELAY_OFF

IviDmmTriggerSlope[TS]TriggerSlopeProperty[TS]DataType Access Applies

R/W N/A None IviDmmConfigureTriggerSlope

DescriptionSpecifieswhetherthetriggeroccursontherisingedge(IVIDMM_VAL_POSITIVE)oronthefallingedge(IVIDMM_VAL_NEGATIVE)oftheexternaltriggersource.PropertyNodePathIviDmm»Trigger»TriggerSlope[TS]DefinedValuesIVIDMM_VAL_POSITIVEIVIDMM_VAL_NEGATIVE

IviDmmTriggerSourceIviScopeBasePropertyDataType Access Appliesto Coercion HighLevelVIs

R/W N/A None IviDmmConfigureTrigger

DescriptionSpecifiesthetriggersource.AfteryoucalleithertheReadorInitiateVI,theDMMwaitsforthetriggeryouspecifywiththisproperty.Afteritreceivesthetrigger,theDMMwaitsthelengthoftimeyouspecifywiththeIviDmmTriggerDelayproperty.TheDMMthentakesameasurement.PropertyNodePathIviDmm»Trigger»TriggerSourceDefinedValuesIVIDMM_VAL_IMMEDIATEIVIDMM_VAL_EXTERNALIVIDMM_VAL_SOFTWARE_TRIGIVIDMM_VAL_TTL0IVIDMM_VAL_TTL1IVIDMM_VAL_TTL2IVIDMM_VAL_TTL3IVIDMM_VAL_TTL4IVIDMM_VAL_TTL5IVIDMM_VAL_TTL6IVIDMM_VAL_TTL7IVIDMM_VAL_ECL0IVIDMM_VAL_ECL1IVIDMM_VAL_PXI_STARIVIDMM_VAL_RTSI_0IVIDMM_VAL_RTSI_1IVIDMM_VAL_RTSI_3

IVIDMM_VAL_RTSI_4IVIDMM_VAL_RTSI_5IVIDMM_VAL_RTSI_6

IviDmmDefinedValuesExpandthisbooktoviewanalphabetizedlistofIviDmmdefinedvalues.

IVIDMM_VAL_2_WIRE_RESSetstheDMMtomeasure2-wireresistance.Definedvalue:5

IVIDMM_VAL_2_WIRE_RTDSetstheDMMtomeasuretemperatureusinga2-wiretemperatureresistancedevice.UsetheIviDmmResistanceTemperatureDeviceextensiongrouptoconfigureadditionalsettingsforthistransducertype.DefinedValue:3

IVIDMM_VAL_4_WIRE_RESSetstheDMMtomeasure4-wireresistance.DefinedValue:101

IVIDMM_VAL_4_WIRE_RTDSetstheDMMtomeasuretemperatureusinga4-wiretemperatureresistancedevice.UsetheIviDmmResistanceTemperatureDeviceextensiongrouptoconfigureadditionalsettingsforthistransducertype.DefinedValue:4

IVIDMM_VAL_AC_CURRENTSetstheDMMtomeasureACcurrent.Definedvalue:4

IVIDMM_VAL_AC_PLUS_DC_CURRENTSetstheDMMtomeasureACplusDCcurrent.DefinedValue:107

IVIDMM_VAL_AC_PLUS_DC_VOLTSSetstheDMMtomeasureACplusDCvoltage.DefinedValue:106

IVIDMM_VAL_AC_VOLTSSetstheDMMtomeasureACvoltage.DefinedValue:2

IVIDMM_VAL_AUTO_DELAY_OFFStopstheDMMfromcalculatingthetriggerdelay.SetsthetriggerdelaytothelasttriggerdelaytheDMMcalculated.DefinedValue:-2.0

IVIDMM_VAL_AUTO_DELAY_ONConfigurestheDMMtocalculatethetriggerdelaybeforeeachmeasurement.DefinedValue:-1.0

IVIDMM_VAL_AUTO_RANGE_OFFDisablesauto-ranging.TheDMMsetstherangetothevalueitmostrecentlycalculated.Definedvalue:-2.0

IVIDMM_VAL_AUTO_RANGE_ONConfigurestheDMMtocalculatetherangebeforeeachmeasurementautomatically.Definedvalue:-1.0

IVIDMM_VAL_AUTO_RANGE_ONCEConfigurestheDMMtocalculatetherangebeforethenextmeasurement.TheDMMusesthisrangevalueforallsubsequentmeasurements.Definedvalue:-3.0

IVIDMM_VAL_AUTO_ZERO_OFFDisablestheauto-zerofeature.DefinedValue:0

IVIDMM_VAL_AUTO_ZERO_ONConfigurestheDMMtotakeaZeroReadingforeachmeasurement.TheDMMsubtractstheZeroReadingfromthevalueitmeasures.DefinedValue:1

IVIDMM_VAL_AUTO_ZERO_ONCEConfigurestheDMMtotakeaZeroReadingimmediately.TheDMMthensubtractsthisZeroReadingfromallsubsequentvaluesitmeasures.DefinedValue:2

IVIDMM_VAL_DC_CURRENTSetstheDMMtomeasureDCcurrent.Definedvalue:3

IVIDMM_VAL_DC_VOLTSSetstheDMMtomeasureDCvoltage.Definedvalue:1

IVIDMM_VAL_ECL0TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronECL0.DefinedValue:119

IVIDMM_VAL_ECL1TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronECL1.DefinedValue:120

IVIDMM_VAL_EXTERNALRoutesthemeasurementcompletesignaltotheexternalconnector.DefinedValue:2

IVIDMM_VAL_EXTERNAL(forMEAS_COMPLETE_DEST)Routesthemeasurement-completesignaltotheexternalconnector.DefinedValue:2

IVIDMM_VAL_EXTERNAL(forSAMPLE_TRIGGER)TheDMMexitstheWait-For-Sample-Triggerstatewhenatriggeroccursontheexternaltriggerinput.DefinedValue:2

IVIDMM_VAL_EXTERNAL(forTRIGGER_SOURCE)TheDMMexitstheWait-For-Triggerstatewhenatriggeroccursontheexternaltriggerinput.DefinedValue:2

IVIDMM_VAL_EXTERNALforIviDmmMeasCompleteDestinationRoutesthemeasurement-completesignaltotheexternalconnector.DefinedValue:2

IVIDMM_VAL_EXTERNALforIviDmmTriggerSourceTheDMMexitstheWait-For-Triggerstatewhenatriggeroccursontheexternaltriggerinput.DefinedValue:2

IVIDMM_VAL_FREQSetstheDMMtomeasurefrequency.DefinedValue:104

IVIDMM_VAL_IMMEDIATETheDMMexitstheWait-For-TriggerstateortheWait-For-Sample-Triggerstateimmediatelyafterentering.Itdoesnotwaitforatriggerofanykind.DefinedValue:1

IVIDMM_VAL_INTERVALTheDMMexitstheWait-For-Sample-TriggerstatewhenthelengthoftimespecifiedbytheIVIDMM_ATTR_SAMPLE_INTERVALpropertyelapses.DefinedValue:10

IVIDMM_VAL_NEGATIVESetsthetriggereventtooccuronthefallingedgeofthetriggerpulse.DefinedValue:1

IVIDMM_VAL_NONEThemeasurementcompletesignalisnotrouted.DefinedValue:-1

IVIDMM_VAL_PERIODSetstheDMMtomeasureperiod.DefinedValue:105

IVIDMM_VAL_POSITIVESetsthetriggereventtooccurontherisingedgeofthetriggerpulse.DefinedValue:0

IVIDMM_VAL_POWER_LINE_CYCLESReportsthattheunitsforthevaluereturnedbyIVIDMM_ATTR_APERTURE_TIMEarePowerLineCycles.DefinedValue:1

IVIDMM_VAL_PXI_STARTheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronthePXIStartriggerbus.DefinedValue:131

IVIDMM_VAL_RTSI_0RoutesthemeasurementcompletesignaltoRTSI0.DefinedValue:140

IVIDMM_VAL_SECONDSReportsthattheunitsforthevaluereturnedbyIVIDMM_ATTR_APERTURE_TIMEareseconds.DefinedValue:0

IVIDMM_VAL_SOFTWARE_TRIGTheDMMexitstheWait-For-TriggerstateortheWait-For-Sample-TriggerstatewhentheIviDmm_SendSoftwareTriggerfunctionexecutes.IfyousettheIVIDMM_ATTR_TRIGGER_SOURCEpropertytothisvalue,theinstrumentcanonlybetriggeredbycallingtheIviDmm_SendSoftwareTriggerfunction.IfyousettheIVIDMM_ATTR_SAMPLE_TRIGGERpropertytothisvalue,theinstrumentcanonlybetriggeredoneachsamplebycallingtheIviDmm_SendSoftwareTriggerfunction.DefinedValue:3

IVIDMM_VAL_TEMPERATURESetstheDMMtomeasuretemperatureinCelsius.DefinedValue:108

IVIDMM_VAL_TEMP_FSetstheDMMtomeasuretemperatureinFahrenheit.DefinedValue:109

IVIDMM_VAL_TEMP_REF_JUNC_FIXEDSetstheDMMtouseafixedvalueforthethermocouplejunctioncompensation.UsetheIVIDMM_ATTR_TEMP_TC_FIXED_REF_JUNCpropertytosetthefixedreferencejunctionvalue.DefinedValue:2

IVIDMM_VAL_TEMP_REF_JUNC_INTERNALSetstheDMMtouseaninternalsensoratthethermocouplejunctionforthejunctioncompensation.DefinedValue:1

IVIDMM_VAL_TEMP_TC_BSetstheDMMtomeasuretemperaturefromaB-typethermocouple.DefinedValue:1

IVIDMM_VAL_TEMP_TC_CSetstheDM7MtomeasuretemperaturefromaC-typethermocouple.DefinedValue:2

IVIDMM_VAL_TEMP_TC_DSetstheDMMtomeasuretemperaturefromaD-typethermocouple.DefinedValue:3

IVIDMM_VAL_TEMP_TC_ESetstheDMMtomeasuretemperaturefromanE-typethermocouple.DefinedValue:4

IVIDMM_VAL_TEMP_TC_GSetstheDMMtomeasuretemperaturefromaG-typethermocouple.DefinedValue:5

IVIDMM_VAL_TEMP_TC_JSetstheDMMtomeasuretemperaturefromaJ-typethermocouple.DefinedValue:6

IVIDMM_VAL_TEMP_TC_KSetstheDMMtomeasuretemperaturefromaK-typethermocouple.DefinedValue:7

IVIDMM_VAL_TEMP_TC_NSetstheDMMtomeasuretemperaturefromanN-typethermocouple.DefinedValue:8

IVIDMM_VAL_TEMP_TC_RSetstheDMMtomeasuretemperaturefromanR-typethermocouple.DefinedValue:9

IVIDMM_VAL_TEMP_TC_SSetstheDMMtomeasuretemperaturefromanS-typethermocouple.DefinedValue:10

IVIDMM_VAL_TEMP_TC_TSetstheDMMtomeasuretemperaturefromaT-typethermocouple.DefinedValue:11

IVIDMM_VAL_TEMP_TC_USetstheDMMtomeasuretemperaturefromaU-typethermocouple.DefinedValue:12

IVIDMM_VAL_TEMP_TC_VSetstheDMMtomeasuretemperaturefromaV-typethermocouple.DefinedValue:13

IVIDMM_VAL_THERMISTORSetstheDMMtomeasuretemperatureusingathermistor.UsetheIviDmmThermistorextensiongrouptoconfigureadditionalsettingsforthistransducertype.DefinedValue:2

IVIDMM_VAL_THERMOCOUPLESetstheDMMtomeasuretemperatureusingathermocouple.UsetheIviDmmThermocoupleextensiongrouptoconfigureadditionalsettingsforthistransducertype.DefinedValue:1

IVIDMM_VAL_TTL0TheDMMexitstheWait-For-TriggerortheWait-For-Sample-TriggerstatewhenitreceivesatriggeronTTL0.DefinedValue:112

PropertiesforControllingIviDmmSimulationNoteYoucansetSimulationAttributesinMAXontheInitialSettingstabofIVIDrivers»Advanced»SimulationDriverSessions»nisIviClassorinthesimulationinteractivepanels.RefertoNationalInstrumentsIVIDriverHelp»ConfiguringYourSystemformoreinformation.

TwosetsofpropertiesexistforusewiththeIviDmmSimulationdriver.Thefollowingtabledescribespropertiesthatcontrolbehaviorofthedriver.AnothertablelistspropertiesthatsimulatethestatusofspecificdriverVIs.AnIviDmmSimulatorSetupDialogBoxexiststohelpyouconfigurethemeasurementsimulationfortheIviDmmSimulatordriver.

PropertiesforControllingIviDmmSimulationName Data

TypeAccess Applies

toDescription

SELF_TEST_CODE Integer W No Specifiestheself-testcode.WhentheIviDmmSelf-Testresultparameterreturnsthisvalue.

SELF_TEST_MSG String W No Specifiestheself-testmessage.WhentheIviDmmSelf-TestVIiscalled,themessageparameterreturnsthisstring.

ERROR_QUERY_CODE Integer W No Specifiestheerror-querycode.WhentheIviDmmError-Querycodeparameterreturnsthisvalue.

ERROR_QUERY_MSG String W No Specifiestheerror-querymessage.WhentheIviDmmError-QueryVIiscalled,theerrormessagestring.

DRIVER_REV_QUERY String W No Specifiestheinstrumentdriverrevisionmessage.WhentheVIiscalled,theparameterreturnsthisstring.

INSTR_REV_QUERY String W No Specifiesthefirmwarerevisionmessage.WhentheIviDmmRevisionQueryVIiscalled,thefirmwarerevisionreturnsthisstring.

READING_BASE Double W No Specifiesthebasevalueofallcomputergeneratedmeasurements.Simulatedmeasurementsfallbetweentherangeofthisvalueplusthevalueofthe

NISDMM_ATTR_READING_NOISEandthisvalueminusthevalueoftheNISDMM_ATTR_READING_NOISE

NoteThispropertyisignorediftheNISDMM_ATTR_FORCE_OVERRANGEpropertyissettoTRUE.

READING_NOISE Double W No Specifiesthereadingnoiseofallcomputergeneratedmeasurements.SimulatedmeasurementsfallbetweentherangeofthevalueoftheNISDMM_ATTR_READING_BASEplusthisvalueandthevalueoftheNISDMM_ATTR_READING_BASEminusthethisvalue.

NoteThispropertyisignorediftheNISDMM_ATTR_FORCE_OVERRANGEpropertyissettoTRUE.

FORCE_OVERRANGE Boolean W No Specifieswhethertoreturnandoverrangevalueforallcomputergeneratedmeasurements.Whenenabled,allmeasurementVIssimulateameasurementover-loadconditionbyreturningavalueofIVI_VAL_NANasthemeasurementandanoverrangewarningasthestatuscode.

SIMULATE_STATUS_CODE Boolean W No SpecifieswhethertosimulatereturncodesfromtheIviDmmdriverVIs.RefertotheIviDmmPropertiesforStatusSimulationtable.

IviDmmSimulatorSetupDialogBoxTwosetsofpropertiesexistforusewiththeIviDmmSimulationDriver.YouusethedialogboxshownbelowtoconfigurethemeasurementsimulationfortheIviDmmSimulatordriver.Scrolldowntoseeadescriptionofeachcontrol.

AlwayspromptforoutputdatasimulationLeavingthiscontrolselectedcausesthepaneltoappearateverymeasurementacquisitioneventinyourprogram.Allsimulatedacquisitionsintheprogramusethesamemeasurementconfigurationinformation.Unselectingthiscontrolcausesthemeasurementsimulationpaneltoneverappearagainduringthecourseofyourprogram.ForceOver-RangeSelectthiscontrolifyouwanttoforceanoverrangeconditiontooccurduringmeasurementevents.Whenenabled,allmeasurementssimulateameasurementover-loadconditionbyreturningNotaNumber(Nan)valueasthemeasurementandanoverrangewarningasthereturnstatus.MeasurementBaseEnterthemeasurementbasetouseforallcomputergeneratedmeasurements.AllcomputergeneratedmeasurementvaluesfallwithintherangeofthisvalueplusorminusthevalueoftheMeasurementNoisecontrol.ValidRange:anyvalueMeasurementNoiseEnterthereadingnoisetouseforallcomputergeneratedmeasurements.AllcomputergeneratedmeasurementvaluesfallwithintherangeofthevalueoftheMeasurementBasecontrolplusorminusthisvalue.ValidRange:anypositivevalue

PropertiesforStatusSimulationinIviDmmWhenanIviDmmdriverVIiscalled,thedriverquerieswhetherNISDMM_ATTR_SIMULATE_STATUS_CODEisenabled.Ifenabled,thedrivergetstheappropriateVI'ssimulationstatuscode.Ifthevalueofthesimulationstatuscoderepresentsawarning(hasapositivevalue),thenitisreturnedastheVI'sreturnstatusonlyifnoothererrororwarningoccurredbeforetheVIends.Ifthevalueofthesimulationstatuscoderepresentsanerror(hasanegativevalue),thenitisreturnedastheVI'sreturnstatusonlyifnoothererroroccurredbeforetheVIends.ThefollowingIviDmmVIsdonotsupportstatuscodesimulation:

IviDmmGetErrorIviDmmClearErrorIviDmmGetNextInterchangeWarningIviDmmResetNextInterchangeWarningIviDmmClearNextInterchangeWarningIviDmmGetNextCoercionRecord

EachVIsupportedbytheIviDmmclassdriverhasacorrespondingpropertythatdeterminesthestatuscodetoreturnwhenstatuscodesimulationisenabled.ThefollowingtableliststhestatuscodepropertiesandtheVIforwhichtheyreturnavalue.ThesepropertiesarealloftypeViInt32,non-readable,andnon-channelbased.

NoteInthefollowingtable,theliteralstringNISDMM_ATTR_precedesallpropertynames.

IviDmmPropertiesforStatusSimulationProperty VIINIT_STATUS IviDmm

Initialize,IviDmmInitializeWithOptions

CLOSE_STATUS IviDmmCloseRESET_STATUS IviDmmResetSELF_TEST_STATUS IviDmmSelf-TestERROR_QUERY_STATUS IviDmmError-

QueryERROR_MESSAGE_STATUS IviDmmError

MessageREVISION_QUERY_STATUS IviDmmRevision

QueryRESET_DEFAULT_STATUS IviDmmReset

WithDefaultsDISABLE_STATUS IviDmmDisableINVALIDATE_STATUS IviDmm

CONFIGURE_MEASUREMENT_STATUS IviDmmConfigureMeasurement

CONFIGURE_TRIGGER_STATUS IviDmmConfigureTrigger

READ_STATUS IviDmmReadFETCH_STATUS IviDmmFetchABORT_STATUS IviDmmAbortINITIATE_STATUS IviDmmInitiateIS_OVER_RANGE_STATUS IviDmmIsOver-

RangeCONFIGURE_AC_BANDWIDTH_STATUS IviDmm

ConfigureACBandwidth

CONFIGURE_FREQUENCY_VOLTAGE_RANGE_STATUS IviDmmConfigureFrequencyVoltageRange

CONFIGURE_TRANSDUCER_TYPE_STATUS IviDmmConfigureTransducerType

CONFIGURE_FIXED_REF_JUNCTION_STATUS IviDmm

ConfigureFixedRefJunction

CONFIGURE_THERMOCOUPLE_STATUS IviDmmConfigureThermocouple

CONFIGURE_RTD_STATUS IviDmmConfigureRTD

CONFIGURE_THERMISTOR_STATUS IviDmmConfigureThermistor

CONFIGURE_MEAS_COMPLETE_DEST_STATUS IviDmmConfigureMeasCompleteDest

CONFIGURE_MULTI_POINT_STATUS IviDmmConfigureMultiPoint

READ_MULTI_POINT_STATUS IviDmmReadMultiPoint

FETCH_MULTI_POINT_STATUS IviDmmFetchMultiPoint

CONFIGURE_TRIGGER_SLOPE_STATUS IviDmmConfigureTriggerSlope

SEND_SOFTWARE_TRIGGER_STATUS IviDmmSendSoftwareTrigger

GET_APERTURE_TIME_INFO_STATUS IviDmmGetApertureTimeInfo

GET_AUTO_RANGE_VALUE_STATUS IviDmmGetAutoRangeValue

CONFIGURE_AUTO_ZERO_MODE_STATUS IviDmmConfigureAutoZeroMode

CONFIGURE_POWER_LINE_FREQUENCY_STATUS IviDmm

ConfigurePowerLineFrequency

IviFgenClassDriverReferenceforLabVIEWConceptsIviFgenClassDriverOverviewIviFgenExtensionCapabilityGroupsIviFgenBehaviorModels

IviFgenVIandPropertyReferenceIviFgenVITreeIviFgenPropertiesbyGroupIviFgenPropertyValueDefinitionsIviFgenErrorandCompletionCodesOtherReferenceInterchangeabilityCheckingSimulation

IviFgenClassDriverOverviewThisinstrumentdriverprovidesprogrammingsupportfortheIviFgenClass.TheIviFgenclassdriverconceptualizesafunctiongeneratorasaninstrumentcapableofgeneratingananalogvoltagewaveform,andcanbeappliedtoawiderangeofinstruments.Theoutputsignalistypicallyfunctionalinnature(forexamplesinusoidalorsquare).Someinstrumentssupportthegenerationofarbitrarywaveforms,whichconsistofuser-specifieddata.Ifthefunctiongeneratoralsosupportsthegenerationofarbitrarywaveformsequences,theoutputsignalcanconsistofasequenceofrepeatedarbitrarywaveforms.TheIviFgenclassdriverisdividedintobasecapabilitiesandextensions.Thebasecapabilitiesconfigureafunctiongeneratorforbasicsignaloutput.Withtheextensions,youcanconfigureafunctiongeneratortogenerateaspecifictypeofwaveform.AninstrumentdrivermustsupporteithertheIviFgenStdFuncorIviFgenArbWfmextension.ThedrivercontainsalltheVIsthattheIVIFoundationrequiresfortheIviFgenspecification.ThisdriverrequiresNI-VISAandtheIVICompliancePackagetobeinstalled.Usethisdrivertodevelopprogramsthatareindependentofaparticularfunctiongenerator.YoucanusethisclassdriverwithanyfunctiongeneratorthathasanIVIinstrumentspecificdriverthatiscompliantwiththeIviFgenclass.TheIviFgenclassdriveraccessesthespecificdriverforyourinstrumentusingtheconfigurationinformationyousupplywithMAX.TheIviFgenclassdriverdividesinstrumentcapabilitiesintoaIviFgenBasecapabilitygroupandmultipleextensioncapabilitygroups.TheIviFgenBasegroupsupportsfunctiongeneratorscapableofconfiguringoutputimpedancesandthereferenceclocksource,andenablinganddisablingthefunctiongenerator'soutputs.Thebasecapabilitiesalonedonotsupportgeneratinganoutputsignal.Instead,afunctiongeneratormustsupportatleastoneofthesignaloutputextensions:IviFgenStdFunc,IviFgenArbWfm,orIviFgenArbSeq.ThebasegroupconsistsofthefollowingVIsandproperties.TheseVIsandpropertiesareimplementedbyallfunctiongeneratorinstrumentdriversthatarecompliantwiththeIviFgenclass.

IviFgenExtensionCapabilityGroupsTheIviFgenclassdriveridentifiesVIsandpropertiesthatbelongtoanextensiongroupwiththefollowingabbreviations.Instrumentspecificdriversarenotrequiredtoimplementanyoftheextensioncapabilitygroups.IfyouuseVIsandpropertiesthatbelongtoextensioncapabilitygroups,everyinstrumentspecificdriverthatyouusemustimplementthoseextensions.

GroupName Abbreviation DescriptionIviFgenStdFunc [STD] Forinstrumentscapableof

generatingstandardperiodicwaveforms.

IviFgenArbWfm [ARB] Forinstrumentscapableofgeneratinguser-definedarbitrarywaveforms.

IviFgenArbFrequency [AF] Forinstrumentscapableofspecifyingtherateatwhichthefunctiongeneratorproducesanentirecycleofanarbitrarywaveform.

IviFgenArbSeq [SEQ] Forinstrumentscapableofgeneratingauser-definedsequenceofarbitrarywaveforms.

IviFgenTrigger [TRG] Forinstrumentscapableofproducingasignaluponreceiptofatrigger.

IviFgenInternalTrigger [IT] Forinstrumentscapableofproducingasignaluponreceiptofatriggerfromaninternaltriggersource.

IviFgenSoftwareTrigger [SWT] Forinstrumentscapableofproducingasignaluponreceiptofasoftwaretrigger.

IviFgenBurst [BST] Forinstrumentscapableofgeneratingafixednumberofwaveformcyclessignalupon

receiptofatrigger.IviFgenModulateAM [AM] Forinstrumentscapableof

applyingamplitudemodulationtoanoutputsignal.

IviFgenModulateFM [FM] Forinstrumentscapableofapplyingfrequencymodulationtoanoutputsignal.

RelatedTopicsIVIInherentClassCapabilitiesStandardFunctionWaveformDescriptionOverviewArbitraryWaveformOverviewArbitrarySequenceOverviewAmplitudeModulationOverviewFrequencyModulationOverviewOutputStageOverview

StandardFunctionWaveformDescriptionOverviewInstrumentvendorstypicallyhavedifferentdefinitionsforwaveformproperties.Inordertoachieveaconsistentwaveformdescriptionbetweendifferentinstrumentvendors,thisclassdriverprovideswaveformpropertydefinitionsthatmustbefollowedwhendevelopinginstrumentdrivers.Thedefinitionsforthesewaveformpropertiesareasfollows:WaveformType—Theoverall"shape"ofoneperiodofthestandardwaveform.Thisspecificationdefinessixwaveformtypes:Sine,Square,Triangle,RampUp,RampDown,andDC.Amplitude—Thedifferencebetweenthemaximumandminimumwaveformvalues,orthepeak-to-peakvoltagevalue.DCOffset—Thedifferencebetweentheaverageofthemaximumandminimumwaveformvaluesandthex-axis(0volts).ApositiveDCoffsetplacesthemiddleofthewaveformabovethex-axis,whileanegativeDCoffsetplacesthemiddleofthewaveformbelowthex-axis.Frequency—Thenumberofwaveformcyclesgeneratedinonesecond.StartPhase—Specifiesthewaveform'shorizontaloffset.Theunitsaredegreesofonewaveformcycle.Forexample,a180degreephaseoffsetmeansoutputgenerationbeginshalfwaythroughthewaveform.Astartphaseof360degreesoffsetstheoutputbyanentirewaveformcycle.Itisthereforeidenticaltoastartphaseof0degrees.Thefollowingillustrationdiagramstheseproperties.

IllustrationofBasicWaveformPropertiesDutyCycle—Asquarewaveformrequiresanadditionalparametertoconfigurethedutycycleofthewaveform.Dutycycleisdefinedasthepercentageoftimeduringonecycleforwhichthesquarewaveisatitshighvalue.

SquareWaveformwith75percentDutyCycle

ArbitraryWaveformOverviewTheIviFgenArbWfmExtensionGroupsupportsfunctiongeneratorscapableofproducinguser-definedarbitrarywaveforms.Youcanmodifyparametersofthearbitrarywaveformsuchassamplerate,waveformgain,andwaveformoffset.TheIviFgenArbWfmextensiongroupincludesVIsforcreating,configuring,andgeneratingarbitrarywaveforms,andforreturninginformationaboutarbitrarywaveformcreation.ThisextensionaffectsinstrumentbehaviorwhentheIviFgenOutputModepropertyissettoIVIFGEN_VAL_OUTPUT_ARBorIVIFGEN_VAL_OUTPUT_SEQ.Beforeafunctiongeneratorcanproduceanarbitrarywaveform,youmustconfiguresomesignalgenerationproperties.Thisspecificationprovidesdefinitionsforarbitrarywaveformpropertiesthatmustbefollowedwhendevelopinginstrumentdrivers.Thedefinitionofanarbitrarywaveformanditspropertiesaregiveninthefollowinglist:

ArbitraryWaveform—Auser-definedseriesofsequentialdatapoints,between-1.0and1.0inclusive,thatdescribeanoutputwaveform.Gain—Thefactorbywhichthefunctiongeneratorscalesthearbitrarywaveformdata.Forexample,againvalueof2.0causesthewaveformdatatorangefrom-2.0Vto+2.0V.Offset—Thevaluethefunctiongeneratoraddstothescaledarbitrarywaveformdata.Forexample,scaledarbitrarywaveformdatathatrangesfrom-1.0Vto+1.0Visgeneratedfrom0.0Vto2.0Vwhentheenduserspecifiesawaveformoffsetof1.0V.NoteTheoffsetisaddedtoanyinherentoffsetinthearbitrarywaveformdata.

Thefollowingfiguresillustratethedefinitionsforarbitrarywaveformproperties.

ExamplesofNormalized,Scaled,andOffsetData

Size,SampleRate,andTimeElementsofaWaveformThesamplerateisthereciprocaloftheamountoftimeforwhichpointsin

thearbitrarywaveformisgenerated.Thefrequencyatwhichthefunctiongeneratorproducesonecycleofanarbitrarywaveformcanbeexpressedbytheequation:

ArbitrarySequenceOverviewInadditiontoallowingyoutospecifyanarbitrarywaveform,somefunctiongeneratorsallowyoutospecifyasequenceofarbitrarywaveformsforthefunctiongeneratortoproduce.Thisclassdriverdefinesanarbitrarysequenceasalistofarbitrarywaveformstoproduce.Eachwaveforminthesequenceisrepeatedadiscretenumberoftimesbeforeproducingthenextwaveform.Whengeneratinganarbitrarysequence,thewaveformpropertiesofGain,Offset,andSampleRate,definedintheArbitraryWaveformOverviewapplytoallwaveformsinthesequence.Thefollowingfigureillustratesthedefinitionofanarbitrarysequence.

WaveformSequencing

AmplitudeModulationOverviewAmplitudemodulationisaccomplishedbyvaryingtheamplitudeofacarrierwaveformaccordingtotheamplitudeofamodulatingwaveform.Thegeneralequationforapplyingamplitudemodulationtoawaveformis:AM(t)=[M(t)+1]×C(t),whereC(t)isthecarrierwaveform,M(t)isthemodulatingwaveform,andAM(t)isthemodulatedsignal.Thisclassdriverprovidesmodulatingwaveformpropertydefinitionsthatmustbefollowedwhendevelopingspecificinstrumentdrivers.Thecarrierwaveformisdefinedasthewaveformthatthefunctiongeneratorproduceswithoutanymodulation.Themodulatingwaveformisdefinedbythefollowingproperties:WaveformType—Theoverall"shape"ofoneperiodofthemodulatingwaveform.Thisclassdriverdefinesfivemodulatingwaveformtypes:Sine,Square,Triangle,RampUp,andRampDown.Frequency—Thenumberofmodulatingwaveformcyclesgeneratedinonesecond.ModulationDepth—Theextenttowhichthemodulatingwaveformaffectstheamplitudeofthecarrierwaveform.Thisvalueisexpressedasapercentageoftotalmodulation.Atthemaximumpeakofthemodulatingwaveform,theamplitudeoftheoutputsignalisequalto(100.0+ModulationDepth)percentofthecarriersignalamplitude.Attheminimumpeakofthemodulatingwaveform,theamplitudeoftheoutputsignalisequalto(100.0–ModulationDepth)percentofthecarriersignalamplitude.Atamodulationdepthof0percent,themodulatingwaveformhasnoeffectonthecarrierwaveform.Atamodulationdepthof100percent,theamplitudeoftheoutputsignalvariesbetween0.0Vandtwicetheamplitudeofthecarriersignal.Thefollowingdiagramillustratestheeffectofamplitudemodulationonacarriersignal,andtheeffectontheoutputsignalofvaryingthemodulationdepth.

OnekHzCarrierSineWaveanda100percentAmplitudeModulated

FrequencyModulationOverviewFrequencymodulationisaccomplishedbyvaryingthefrequencyofacarrierwaveformaccordingtotheamplitudeofamodulatingwaveform.Thegeneralequationforafrequencymodulatedwaveformis:FM(t)=C[t+(M(t))],whereC(t)isthecarrierwaveform,M(t)isthemodulatingwaveform,andFM(t)isthefrequencymodulatedsignal.Thisclassdriverprovidesmodulatingwaveformpropertydefinitionsthatmustbefollowedwhendevelopingspecificinstrumentdrivers.Thecarrierwaveformisdefinedasthewaveformthefunctiongeneratorproduceswithoutanymodulation.Themodulatingwaveformisdefinedbythefollowingproperties:

WaveformType—Theoverall"shape"ofoneperiodofthemodulatingwaveform.Thisclassdriverdefinesfivemodulationwaveformtypes:Sine,Square,Triangle,RampUp,andRampDown.

Frequency—Thenumberofmodulatingwaveformcyclesgeneratedinonesecond.

PeakFrequencyDeviation—Thevariationoffrequencythemodulatingwaveformappliestothecarrierwaveform.Thisvalueisexpressedinhertz.At0hertzdeviation,themodulatingwaveformhasnoeffectonthecarrierwaveform.Asfrequencydeviationincreases,thefrequencyvariationinthemodulatedwaveformincreases.Atthemaximumpeakofthemodulatingsignal,thefrequencyoftheoutputsignalisequaltothefrequencyofthecarriersignalplusthefrequencyofthemodulatingsignal.Attheminimumpeakofthemodulatingsignal,thefrequencyoftheoutputsignalisequaltothefrequencyofthecarriersignalminusthefrequencyofthemodulatingsignal.Thefollowingdiagramillustratestheeffectoffrequencymodulationonacarriersignal,andtheeffectontheoutputsignalofvaryingthepeakfrequencydeviation.

OnekHzCarrierSineWaveandaFrequencyModulatedWaveat20HzPeakDeviation

OutputStageOverviewThisclassdrivermodelstheoutputstageofthefunctiongeneratorwiththefollowingproperties:OutputVoltage,OutputImpedance,andSystemImpedance.Thedefinitionsofthesepropertiesareasfollows:

OutputVoltage—Thevoltageofthewaveformattheoutputterminalwhenconnectedtoamatchedtermination.OutputImpedance—Theimpedanceofthefunctiongeneratorattheoutputterminal.SystemImpedance—Theimpedanceofthesystemattachedtotheoutputterminal.

Thesepropertiesareshowninthefollowingillustration.

IllustrationofOutputPathPropertiesThecombinationoftheoutputimpedanceofthefunctiongeneratorandtheimpedanceofthesystemattachedtotheoutputterminalofthefunctiongeneratorformavoltagedividernetwork.Theactualvoltageacrossthesystemimpedancedependsonthisvoltagedividernetwork.Theamplitudeofthesignalthefunctiongeneratorproducesisbasedontheassumptionthatthesystemimpedancematchesthefunctiongenerator'soutputimpedance.Ifthesystemimpedancediffersfromtheoutputimpedance,youmustconsiderthisfactortoachievethedesiredoutputvoltage.Theactualoutputvoltagecanbefoundbyusingthefollowingequations:

Whentheoutputloadmatchesthesystemload(inotherwords, ,

),theinstrumentdrivercalculatesthecorrectvaluefor toresultin beingsettotherequesteduservalue.Ifyouhavenotmatchedthesystemimpedancetotheoutputimpedance,youmustcalculatetheoutputvoltageonyourown.Forexample,considerthecasewhere ismuchlargerthan ,aswhenaveryhighsystemimpedanceisattached

totheoutputterminal.Inthiscase, .However,becausethe

instrumentdriverhasassumedamatchedload(inotherwords, )theoutputvoltageistwicetherequestedvalue.Inthiscase,youshouldrequestanoutputvoltagethatishalfofthedesiredoutputvaluetoachievetheintendedoutput.

IviFgenExtensionCapabilityGroupsTheIviFgenclassdriveridentifiesVIsandpropertiesthatbelongtoanextensiongroupwiththefollowinggroupnames.Instrumentspecificdriversarenotrequiredtoimplementanyoftheextensioncapabilitygroups.IfyouuseVIsandpropertiesthatbelongtoextensioncapabilitygroups,everyinstrumentspecificdriverthatyouusemustimplementthoseextensions.