Page 1
niDCPowerInitializeCreatesanewIVIinstrumentdriversessiontothepowersupplyspecifiedinresourcenameandreturnsasessionhandleyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.ThisVIalsosendsinitializationcommandstosetthepowersupplytothestatenecessaryforNI-DCPowertooperate.Toplacethepowersupplyinaknownstartupstatewhencreatinganewsession,setresetdevicetoTRUE.ThisactionisequivalenttousingtheniDCPowerResetVI.Toopenasessionandleavethedeviceinitsexistingconfigurationwithoutpassingthroughatransitionaloutputstate,setresetdevicetoFALSE,andthenimmediatelycalltheniDCPowerAbortVI.Toapplyanewconfigurationwithoutdisruptingtheoutputchannelsofthedevice,configurethedeviceinDelayedConfigurationmodeasintheprevioussessionchangingonlythedesiredsettings,andthencalltheniDCPowerInitiateVI.
resourcenamespecifiestheresourcenameassignedbyMeasurement&AutomationExplorer(MAX),forexamplePXI1Slot3,wherePXI1Slot3isaninstrumentresourcename.resourcenamecanalsobealogicalIVIname.idqueryspecifieswhetherthedeviceisqueriedtodetermineifthedeviceisavalidinstrumentforNI-DCPower.ThedefaultisTRUE.resetdevicespecifieswhethertoresetthepowersupplyduringtheinitializationprocedure.ThedefaultisTRUE.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 2
mostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutreturnsahandlethatyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 3
niDCPowerCloseClosesthesessionspecifiedininstrumenthandleanddeallocatestheresourcesthatNI-DCPowerreserved.IfpoweroutputisenabledwhenyoucallthisVI,theoutputchannelsremainintheircurrentstateandcontinueprovidingpower.UsetheniDCPowerConfigureOutputEnabledVItodisablepoweroutputonaperchannelbasis.UsetheniDCPowerResetVItodisablepoweronalloutputchannels.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerroror
Page 5
niDCPowerConfigureOutputEnabledEnablesordisablesgenerationonthespecifiedchannel(s).Dependingontheselectedoutputfunction,thevoltagelevelorthecurrentlevelmustbesetinadditiontoenablingtheoutputtogeneratethedesiredlevel.RefertotheniDCPowerConfigureVoltageLevelVI,niDCPowerConfigureCurrentLevelVI,andtheniDCPowerConfigureOutputFunctionVIformoreinformationaboutconfiguringthedesiredoutputlevel.
NoteIfthedeviceisinDelayedConfigurationmode,enablingtheoutputwillnottakeeffectuntilyoucalltheniDCPowerInitiateVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.outputenabledspecifieswhethertheoutputchannelenabledordisabled.
true Enablesgenerationonthespecifiedoutputchannel(s).false Disablesgenerationonthespecifiedoutputchannel(s).
DefaultValue:false
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerror
Page 6
occurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 7
niDCPowerConfigureOutputFunctionConfiguresthefunctionthedeviceattemptstogenerateforthespecifiedchannel.Details
channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.outputfunctionconfiguresthefunctiontogenerateforthespecifiedchannel(s).
DCVoltage SetstheoutputfunctiontoDCvoltage.DCCurrent SetstheoutputfunctiontoDCcurrent.
DefaultValue:DCVoltage
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythe
Page 8
sessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 9
DetailsWhenDCVoltageisselected,thedevicegeneratesthedesiredvoltagelevelontheoutputaslongastheoutputcurrentisbelowthecurrentlimit.ThefollowingVIscanbeusedtoconfigurethechannelwhenDCVoltageisselected:
niDCPowerConfigureVoltageLevelniDCPowerConfigureCurrentLimitniDCPowerConfigureVoltageLevelRangeniDCPowerConfigureCurrentLimitRange
WhenDCCurrentisselected,thedevicegeneratesthedesiredcurrentlevelontheoutputaslongastheoutputvoltageisbelowthevoltagelimit.ThefollowingfunctionscanbeusedtoconfigurethechannelwhenDCCurrentisselected:
niDCPowerConfigureCurrentLevelniDCPowerConfigureVoltageLimitniDCPowerConfigureCurrentLevelRangeniDCPowerConfigureVoltageLimitRange
Page 10
niDCPowerMeasureMultipleReturnsarraysofthemeasuredvoltageandcurrentvaluesonthespecifiedoutputchannel(s).EachcalltothisVIblocksotherVIcallsuntilthemeasurementsarereturnedfromthepowersupply.Theorderofthemeasurementsreturnedinthearraycorrespondstotheorderofthespecifiedoutputchannels.ThemeasurementspeedofthepowersupplyandtheSamplestoAveragepropertydictatesthelengthoftimethatameasurementtakes.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchannelstomeasure.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.
Page 11
voltagemeasurementsreturnsanarrayofvoltagemeasurements.Themeasurementsinthearrayarereturnedinthesameorderasthechannelsspecifiedinchannelname.currentmeasurementsreturnsanarrayofcurrentmeasurements.Themeasurementsinthearrayarereturnedinthesameorderasthechannelsspecifiedinchannelname.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 12
niDCPowerConfigureSenseSpecifieswhethertouselocalorremotesensingoftheoutputvoltageonthespecifiedchannel(s).RefertotheDevicestopicspecifictoyourdeviceintheNIDCPowerSuppliesandSMUsHelptofindoutmoreinformationaboutsensingonsupportedchannels.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.sensespecifieslocalorremotesensingonthespecifiedchannel(s).
Local LocalsensingRemote Remotesensing
DefaultValue:Local
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.
Page 13
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 14
niDCPowerInitiateCommitstheconfiguredsettingstohardwareandplacesthepowersupplyinImmediatemode.AnyconfigurationcallsmadeafterthisVIareappliedimmediately.Tocommitsimultaneoushardwaresettingsonmultipleoutputchannels,calltheniDCPowerAbortVI,configurethepowersupply,andthencallthisVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 15
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 16
niDCPowerAbortPlacesthepowersupplyinDelayedConfigurationmode.AnyconfigurationVIscalledafterthisVIarenotapplieduntiltheniDCPowerInitiateVIiscalled.IfpoweroutputisenabledwhenyoucalltheniDCPowerAbortVI,theoutputchannelsremainintheircurrentstateandcontinueprovidingpower.UsetheniDCPowerConfigureOutputEnabledVItodisablepoweroutputonaperchannelbasis.UsetheniDCPowerResetVItodisablepoweroutputonallchannels.WhileinDelayedConfigurationmode,NI-DCPowerperformsonlygenericparametervalidation.AnyconflictingconfigurationcallsarenotvalidateduntiltheniDCPowerInitiateVIiscalled.Ifthesameconfigurationissetmultipletimestodifferentvalues,NI-DCPowerusesthelastconfigurationcall.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI
Page 17
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 18
niDCPowerPropertyNodeSetsorgetspropertiesofthedevice.RefertoUsingPropertiesandAttributesformoreinformation.
Page 19
Channel-BasedPropertiesToaccessachannel-basedproperty,youmustwireanActiveChannelofanNI-DCPowerpropertynode.TheActiveChannelislistedfirstinthepropertynode.Toaccessadevice-basedproperty,donotwireanActiveChannelorwireanemptystring.
Page 20
PropertieswithMultipleChannelsYoucanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinActiveChannel.
Page 21
NI-DCPowerExpressConfiguresandgeneratesasignalusingNI-DCPowerwithNationalInstrumentsDCpowersuppliesandSMUs.
DialogBoxOptionsBlockDiagramInputsBlockDiagramOutputs
Page 22
DialogBoxOptionsParameter DescriptionMeasurements Displaysthevoltageandcurrentmeasurementsona
perchannelbasis.Configuration Containsthefollowingoptions:
Device—Containstheresourcenameofthedevice.Enable/Disablealloutputs—Specifieswhetheralloutputchannelsareenabledordisabled.ChannelConfiguration
Channels—Selectchannelbyhighlighting.Thechannelconfigurationforselectedchannelisdisplayed.OutputFunction—Configuresthefunctiontogenerateonthespecifiedchannel(s).OutputEnabled—Specifieswhethertheoutputisenabledordisabled.VoltageLevel(V)—Specifiesthevoltagelevel,involts,thedeviceattemptstogenerateonthespecifiedchannel(s).Validvaluesforthevoltagelevelaredefinedbythevoltagelevelrange.CurrentLimit(A)—Specifiesthecurrentlimit,inamps,fortheoutputnottoexceedwhengeneratingthedesiredvoltageonthespecifiedchannel(s).Validvaluesforcurrentlimitaredefinedbythecurrentlimitrange.VoltageLevelRange(V)—Specifiesthevoltagelevelrange,involts,forthespecifiedchannel(s).Therangedefinesthevalidvaluestowhichthevoltagelevelcanbeset.CurrentLimitRange(A)—Specifiesthecurrentlimitrange,inamps,forthespecifiedchannel(s).Therange
Page 23
BlockDiagramInputsParameter DescriptionClose(T) Specifieswhetherthesessiontothedeviceremainsopen
aftertheVIfinishesexecution.SetClose(T)toTRUEtocloseallreferencesandreinitializethedeviceforeachiteration.SetClose(T)toFALSEforalliterationsexceptthelastiterationforloopoptimization.ThedefaultisTRUE.
errorin DescribeserrorconditionsthatoccurbeforethisVIruns.
Page 24
BlockDiagramOutputsParameter DescriptionMeasuredVoltage
Returnsthevoltagevaluesmeasuredonalloutputchannels.
MeasuredCurrent
Returnsthecurrentvaluesmeasuredonalloutputchannels.
errorout Containserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisExpressVIran,erroroutcontainsthesameerrorinformation.Otherwise,erroroutdescribestheerrorstatusthatthisExpressVIproduces.
Page 25
niDCPowerConfigureVoltageLevelConfiguresthevoltagelevelthedeviceattemptstogenerateforthespecifiedchannel(s).Thechannelmustbeenabledforthespecifiedvoltageleveltotakeeffect.RefertotheniDCPowerConfigureOutputEnabledVIformoreinformationaboutenablingtheoutputchannel.ThevoltagelevelsettingisapplicableonlyifthechannelissettotheDCVoltageoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.Thedeviceactivelyregulatesthevoltageatthespecifiedlevelunlessdoingsocausesacurrentdropgreaterthanthecurrentlimitacrossthechannels'outputterminals.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.voltagelevelspecifiesthevoltagelevel,involts,fortheoutputchannelgeneration.ThevalidvaluesforthisparameteraredefinedbythevoltagelevelrangethatisselectedusingtheniDCPowerConfigureVoltageLevelRangeVI.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.
Page 26
codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 27
niDCPowerConfigureVoltageLevelRangeConfiguresthevoltagelevelrangeforthespecifiedchannel(s).TheconfiguredrangedefinesthevalidvaluesthevoltagelevelcanbesettousingtheniDCPowerConfigureVoltageLevelVI.ThevoltagelevelrangesettingisapplicableonlyifthechannelissettotheDCVoltageoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.UsetheVoltageLevelAutorangepropertytoenableautomaticselectionofthevoltagelevelrange.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.voltagelevelrangespecifiesthevoltagelevelrange,involts,onthespecifiedchannel(s).NIPXI-4110Channel VoltageLevelRange VoltageLevel0 6 0to+6V1 20 0to+20V2 20 0to-20VNIPXI-4130Channel VoltageLevelRange VoltageLevel0 6 0to+6V1 6 -6to+6V
Page 28
20 -20to+20V
NoteIfarangeotherthanwhatislistedintheprecedingtableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe10VvoltagelevelrangeonChannel1ontheNI-PXI4130coercesthevoltagelevelrangeto20V.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 29
niDCPowerConfigureCurrentLimitConfiguresthecurrentlimitforthespecifiedchannel(s).Thechannelmustbeenabledforthespecifiedcurrentlimittotakeeffect.RefertotheniDCPowerConfigureOutputEnabledVIformoreinformationaboutenablingtheoutputchannel.Thecurrentlimitisthecurrentthattheoutputshouldnotexceedwhengeneratingthedesiredvoltagelevel.ThecurrentlimitsettingisonlyapplicableifthechannelissettotheDCVoltageoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.currentlimitspecifiesthecurrentlimitonthespecifiedchannel(s).ThevalidvaluesforthisparameteraredefinedbythecurrentlimitrangethatisconfiguredusingtheniDCPowerConfigureCurrentLimitRangeVI.
behaviorspecifieshowtheoutputcurrentshouldbehavewhenthecurrentlimitisreached.
Regulate Thepowersupplycontrolstheoutputcurrentsothatitdoesnotexceedthecurrentlimit.Thepowersupplycontinuestogeneratepower,evenifthecurrentlimithasbeenreached.
Page 30
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 31
niDCPowerConfigureCurrentLimitRangeConfiguresthecurrentlimitrangeforthespecifiedchannel(s).TheconfiguredrangedefinesthevalidvaluesthecurrentlimitcanbesettousingtheniDCPowerConfigureCurrentLimitVI.ThecurrentlimitrangesettingisapplicableonlyifthechannelissettotheDCVoltageoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.UsetheCurrentLimitAutorangepropertytoenableautomaticselectionofthecurrentlimitrange.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.currentlimitrangespecifiesthecurrentlimitrange,inamps,forthespecifiedchannel.NIPXI-4110
Channel CurrentLimitRange CurrentLimit0 1A +0.01to+1A1,2 20mA +0.20to+20mA
1A +0.01to+1A
NIPXI-4130
Channel CurrentLimitRange CurrentLimit0 1A +0.01to+1A
Page 32
1 200μA +4to+200μA2mA +0.04to+2mA20mA +0.40to+20mA200mA +4to+200mA2A +0.04to+2A
NoteIfarangeotherthanwhatislistedintheprecedingtableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe100mAcurrentlimitrangeonChannel1ontheNI-PXI4130coercesthecurrentlevelrangeto200mA.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0ora
Page 33
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 34
niDCPowerConfigureCurrentLevelConfiguresthecurrentlevelthedeviceattemptstogenerateforthespecifiedchannel(s).Thechannelmustbeenabledforthespecifiedcurrentleveltotakeeffect.RefertotheniDCPowerConfigureOutputEnabledVIformoreinformationaboutenablingtheoutputchannel.ThecurrentlevelsettingisapplicableonlyifthechannelissettotheDCCurrentoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.Thedeviceactivelyregulatesthecurrentatthespecifiedlevelunlessdoingsocausesavoltagegreaterthanthevoltagelimitacrossthechannels'outputterminals.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.currentlevelspecifiesthecurrentlevel,inamps,togenerateforthespecifiedchannel(s).ThevalidvaluesforthisparameteraredefinedbythecurrentlevelrangethatisselectedusingtheniDCPowerConfigureCurrentLevelRangeVI.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.
Page 35
codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 36
niDCPowerConfigureCurrentLevelRangeConfiguresthecurrentlevelrangeforthespecifiedchannel(s).TheconfiguredrangedefinesthevalidvaluesthecurrentlevelcanbesettousingtheniDCPowerConfigureCurrentLevelVI.ThecurrentlevelrangesettingisapplicableonlyifthechannelissettotheDCCurrentoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.UsetheCurrentLevelAutorangepropertytoenableautomaticselectionofthecurrentlevelrange.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.currentlevelrangespecifiesthecurrentlevelrange,inamps,forthespecifiedchannel.NIPXI-4110
Channel CurrentLevelRange CurrentLevel0 1A +0.01to+1A1 20mA +0.20to+20mA
1A +0.01to+1A2 20mA -0.20to-20mA
1A -0.01to-1A
NIPXI-4130
Page 37
Channel CurrentLevelRange CurrentLevel
0 1A +0.01to+1A1 200μA +4to+200μAand-4to-200μA
2mA +0.04to+2mAand-0.04to-2mA20mA +0.40to+20mAand-0.40to-20
mA200mA +4to+200mAand-4to-200mA2A +0.04to+2Aand-0.04to-2A
NoteIfarangeotherthanwhatislistedintheprecedingtableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe100mAcurrentlevelrangeonChannel1ontheNI-PXI4130coercesthecurrentlevelrangeto200mA.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
Page 38
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 39
niDCPowerConfigureVoltageLimitConfiguresthevoltagelimitforthespecifiedchannel(s).Thechannelmustbeenabledforthespecifiedvoltagelimittotakeeffect.RefertotheniDCPowerConfigureOutputEnabledVIformoreinformationaboutenablingtheoutputchannel.Thevoltagelimitisthevoltagethattheoutputshouldnotexceedwhengeneratingthedesiredcurrentlevel.ThevoltagelimitsettingisapplicableonlyifthechannelissettotheDCCurrentoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.voltagelimitspecifiesthevoltagelimit,involts,onthespecifiedoutputchannel(s).ThevalidvaluesforthisparameteraredefinedbythevoltagelimitrangethatisconfiguredusingtheniDCPowerConfigureVoltageLimitRangeVI.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.
Page 40
codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 41
niDCPowerConfigureVoltageLimitRangeConfiguresthevoltagelimitrangeforthespecifiedchannel(s).TheconfiguredrangedefinesthevalidvaluesthevoltagelimitcanbesettousingtheniDCPowerConfigureVoltageLimitVI.ThevoltagelimitrangesettingisapplicableonlyifthechannelissettotheDCCurrentoutputfunctionusingtheniDCPowerConfigureOutputFunctionVI.UsetheVoltageLimitAutorangepropertytoenableautomaticselectionofthevoltagelimitrange.
channelnamespecifiestowhichoutputchannel(s)toapplythisconfigurationvalue.Youcanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinthisparameter.voltagelimitrangespecifiesthevoltagelimitrange,involts,onthespecifiedchannel(s).NIPXI-4110
Channel VoltageLimitRange(V) VoltageLimit(V)0 6 0to+61,2 20 0to+20
NIPXI-4130
Channel VoltageLimitRange(V) VoltageLimit(V)0 6 0to+61 6 0to+6
20 0to+20
NoteIfarangeotherthanwhatislistedinthepreceding
Page 42
tableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe10VvoltagelimitrangeonChannel1ontheNI-PXI4130coercesthevoltagelimitrangeto20V.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 43
niDCPowerQueryOutputStateQueriesthespecifiedoutputchanneltodetermineiftheoutputchanneliscurrentlyinthestatespecifiedbyoutputstate.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Theoutputstatemayonlybequeriedforonechannelatatime.outputstatespecifiestheoutputstateoftheoutputchannelthatisbeingqueried.
ConstantVoltage
Thechannelismaintainingaconstantvoltageatitsoutput.
ConstantCurrent
Thechannelismaintainingaconstantcurrentatitsoutput.
DefaultValue:ConstantVoltage
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.instate?returnswhetherthepowersupplyoutputchannelisinthe
Page 44
specifiedstate.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 45
niDCPowerMeasureReturnsthemeasuredvalueofeitherthevoltageorcurrentonthespecifiedoutputchannel.EachcalltothisVIblocksotherVIcallsuntilthehardwarereturnsthemeasurement.ThemeasurementspeedofthepowersupplyandtheSamplestoAveragepropertydictatethelengthoftimethatameasurementtakes.Tomeasuremultipleoutputchannels,usetheniDCPowerMeasureMultipleVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltomeasure.OnlyonemeasurementatatimemaybemadewiththeniDCPowerMeasureVI.UsetoniDCPowerMeasureMultipleVItomeasuremultiplechannelsormeasurementtypes.measurementtypespecifieswhetheravoltageorcurrentvalueshouldbemeasured.
Voltage Thepowersupplymeasuresvoltage.Current Thepowersupplymeasurescurrent.
DefaultValue:Voltage
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
Page 46
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.measurementreturnsthevalueofthemeasurement,eitherinvoltsforvoltageorampsforcurrent.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 47
niDCPowerQueryMaxCurrentLimitQueriesthemaximumcurrentlimitonanoutputchanneliftheoutputchannelissettothespecifiedvoltagelevel.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Themaximumcurrentlimitmayonlybequeriedforonechannelatatime.voltagelevelspecifiesthevoltageleveltousewhencalculatingthemaxcurrentlimit.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.maxcurrentlimitreturnsthemaximumcurrentlimitthatcanbesetwiththespecifiedvoltagelevel.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE
Page 48
(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 49
niDCPowerQueryMaxVoltageLevelQueriesthemaximumvoltagelevelonanoutputchanneliftheoutputchannelissettothespecifiedcurrentlimit.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Themaximumvoltagelevelmayonlybequeriedforonechannelatatime.currentlimitspecifiesthecurrentlimittousewhencalculatingthemaxvoltagelevel.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.maxvoltagelevelreturnsthemaximumvoltagelevelthatcanbesetonanoutputchannelwiththespecifiedcurrentlimit.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE
Page 50
(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 51
niDCPowerQueryMinCurrentLimitQueriestheminimumcurrentlimitonanoutputchanneliftheoutputchannelissettothespecifiedvoltagelevel.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Theminimumcurrentlimitmayonlybequeriedforonechannelatatime.voltagelevelspecifiesthevoltageleveltousewhencalculatingthemincurrentlimit.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.mincurrentlimitreturnstheminimumcurrentlimitthatcanbesetonanoutputchannelwiththespecifiedvoltagelevel.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.
Page 52
codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 53
niDCPowerQueryInComplianceQueriesthedevicetoindicateifachannelisoperatingatthecompliancelimit.ThecompliancelimitisthecurrentlimitwhentheoutputfunctionissettoDCVoltage.Iftheoutputisoperatingatthecompliancelimit,theoutputreachesthecurrentlimitbeforethedesiredvoltagelevel.RefertotheniDCPowerConfigureOutputFunctionVIandtheniDCPowerConfigureCurrentLimitVIformoreinformationaboutoutputfunctionandcurrentlimit,respectively.ThecompliancelimitisthevoltagelimitwhentheoutputfunctionissettoDCCurrent.Iftheoutputisoperatingatthecompliancelimit,theoutputreachesthevoltagelimitbeforethedesiredcurrentlevel.RefertotheniDCPowerConfigureOutputFunctionVIandtheniDCPowerConfigureVoltageLimitVIformoreinformationaboutoutputandvoltagelimit,respectively.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Thecompliancestatusmayonlybequeriedforonechannelatatime.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.
Page 54
incompliance?returnswhetherthepowersupplyoutputchannelisincompliance.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 55
niDCPowerInitializeExternalCalibrationIfpasswordisvalid,thisVIcreatesanewIVIinstrumentdriversessiontothepowersupplyspecifiedinresourcenameandreturnsaninstrumenthandleyouusetoidentifythepowersupplyinallsubsequentNI-DCPowerVIcalls.ThisVIalsosendsinitializationcommandstosetthepowersupplytothestatenecessaryfortheoperationofNI-DCPower.Openingacalibrationsessionalwaysperformsareset.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.
resourcenamespecifiestheresourcenameassignedbyMeasurement&AutomationExplorer(MAX),forexamplePXI1Slot3,wherePXI1Slot3isaninstrumentresourcename.resourcenamecanalsobealogicalIVIname.passwordspecifiesthepasswordforopeningacalibrationsession.passwordcanbeamaximumoffouralphanumericcharacters.Theinitialpasswordisfactoryconfiguredto"NI".errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutreturnsahandlethatyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI
Page 56
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 57
niDCPowerCloseExternalCalibrationClosesthesessionspecifiedininstrumenthandleanddeallocatestheresourcesthatNI-DCPowerreservedforcalibration.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.IfanerroroccursbeforethisVI,calibrationcloseactiondefaultstoCancel.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.calibrationcloseactionspecifieshowtousethecalibrationvaluesfromthissessionasthesessionisclosed.
Commit ThenewcalibrationconstantsarestoredintheEEPROM.
Cancel Theoldcalibrationconstantsarekept,andthenewonesarediscarded.
DefaultValue:Cancel
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
Page 58
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 59
niDCPowerCalAdjustVoltageLevelCalculatesthecalibrationconstantsforthevoltagelevelforthespecifiedoutputchannel.ThisVIcomparesthearrayinrequestedoutputstothearrayinmeasuredoutputsandcalculatesthecalibrationconstantsforthevoltageleveloftheoutputchannel.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.ThisVIcanonlybecalledinanexternalcalibrationsession.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.channelnamespecifiestheoutputchanneltowhichthesecalibrationsettingsapply.Onlyonechannelatatimemaybecalibrated.numberofmeasurementsspecifiesthenumberofelementsinrequestedoutputsandmeasuredoutputs.requestedoutputsspecifiesanarrayoftheoutputvaluesrequestedintheniDCPowerConfigureVoltageLevelVI.measuredoutputsspecifiesanarrayoftheoutputvaluesmeasuredbyanexternalprecisiondigitalmultimeter.rangespecifiestherangetocalibratewiththesesettings.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.
Page 60
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 61
niDCPowerCalAdjustVoltageMeasurementCalculatesthecalibrationconstantsforthevoltagemeasurementsreturnedbytheniDCPowerMeasureVIforthespecifiedoutputchannel.ThisVIcomparesthearrayinreportedoutputstothearrayinmeasuredoutputsandcalculatesthecalibrationconstantsforthevoltagemeasurementsreturnedbytheniDCPowerMeasureVI.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.ThisVIcanonlybecalledinanexternalcalibrationsession.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.channelnamespecifiestheoutputchanneltowhichthesecalibrationsettingsapply.Onlyonechannelatatimemaybecalibrated.numberofmeasurementsspecifiesthenumberofelementsinrequestedoutputsandmeasuredoutputs.reportedoutputsspecifiesanarrayoftheoutputvaluesthatwerereturnedbytheniDCPowerMeasureVI.measuredoutputsspecifiesanarrayoftheoutputvaluesmeasuredbyanexternalprecisiondigitalmultimeter.rangespecifiestherangetocalibratewiththesesettings.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,code
Page 62
is0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 63
niDCPowerCalAdjustCurrentLimitCalculatesthecalibrationconstantsforthecurrentlimitforthespecifiedoutputchannelandrange.ThisVIcomparesthearrayinrequestedoutputstothearrayinmeasuredoutputsandcalculatesthecalibrationconstantsforthecurrentlimitreturnedbythepowersupply.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.ThisVIcanonlybecalledfromanexternalcalibrationsession.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.channelnamespecifiestheoutputchanneltowhichthesecalibrationsettingsapply.Onlyonechannelatatimemaybecalibrated.numberofmeasurementsspecifiesthenumberofelementsinrequestedoutputsandmeasuredoutputs.rangespecifiestherangetocalibratewiththesesettings.requestedoutputsspecifiesanarrayoftheoutputvaluesrequestedintheniDCPowerConfigureCurrentLimitVI.measuredoutputsspecifiesanarrayoftheoutputvaluesmeasuredbyanexternalprecisiondigitalmultimeter.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.
Page 64
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 65
niDCPowerCalAdjustCurrentMeasurementCalibratesthecurrentmeasurementsreturnedbytheniDCPowerMeasureVIforthespecifiedoutputchannel.ThisVIcalculatesthecalibrationconstantsforthearrayinreportedoutputstothearrayinmeasuredoutputsandcalculatesthecalibrationconstantsforthecurrentmeasurementsreturnedbytheniDCPowerMeasureVI.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.ThisVIcanonlybecalledinanexternalcalibrationsession.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.channelnamespecifiestheoutputchanneltowhichthesecalibrationsettingsapply.Onlyonechannelatatimemaybecalibrated.numberofmeasurementsspecifiesthenumberofelementsinreportedoutputsandmeasuredoutputs.rangespecifiestherangetocalibratewiththesesettings.reportedoutputsspecifiesanarrayoftheoutputvaluesthatwerereturnedbytheniDCPowerMeasureVI.measuredoutputsspecifiesanarrayoftheoutputvaluesmeasuredbyanexternalprecisiondigitalmultimeter.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,code
Page 66
is0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 67
niDCPowerChangeExtCalPasswordChangesthepasswordthatisrequiredtoinitializeanexternalcalibrationsession.Thepasswordcanbeamaximumoffouralphanumericcharacters.IfyoucallthisVIinaregularsession,passwordischangedimmediately.IfyoucallthisVIinanexternalcalibrationsession,passwordischangedonlyafteryouclosethesessionusingtheniDCPowerCloseExternalCalibrationVIwithcalibrationcloseactionsettoCommit.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.oldpasswordspecifiesthepreviouspasswordusedtoprotectthecalibrationvalues.newpasswordspecifiesthenewpasswordtousetoprotectthecalibrationvalues.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI
Page 68
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 69
niDCPowerGetExtCalRecommendedIntervalReturnstherecommendedmaximuminterval,inmonths,betweenexternalcalibrations.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.monthsspecifiestherecommendedmaximuminterval,inmonths,betweenexternalcalibrations.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 70
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 71
niDCPowerGetExtCalLastDateAndTimeReturnsthedateandtimeofthelastsuccessfulcalibration.Thetimereturnedis24-hour(military)localtime;forexample,ifthepowersupplywascalibratedat2:30PM,thisVIreturns14forhoursand30forminutes.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.yearreturnstheyearinwhichthepowersupplywaslastcalibrated.monthreturnsthemonthinwhichthepowersupplywaslastcalibrated.dayreturnsthedayonwhichthepowersupplywaslastcalibrated.hourreturnsthehour(in24-hourtime)inwhichthepowersupplywaslastcalibrated.minutereturnstheminuteinwhichthepowersupplywaslastcalibrated.
Page 72
erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 73
niDCPowerGetCalUserDefinedInfoMaxSizeReturnsthemaximumnumberofcharactersthatcanbeusedtostoreuser-definedinformationinthepowersupplyonboardEEPROM.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.infosizereturnsthenumberofcharactersthatcanbestoredinthepowersupplyonboardEEPROM.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 74
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 75
niDCPowerSetCalUserDefinedInfoStoresauser-definedstringofcharactersinthepowersupplyonboardEEPROM.Ifthestringislongerthanthemaximumallowablesize,itistruncated.ThisVIoverwritesanyexistinguser-definedinformation.IfyoucallthisVIinaregularsession,infoisimmediatelychanged.IfyoucallthisVIinanexternalcalibrationsession,infoischangedonlyafteryouclosethesessionusingtheniDCPowerCloseExternalCalibrationVIwithcalibrationcloseactionsettoCommit.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.infospecifiesthestringtostoreinthepowersupplyonboardEEPROM.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.
Page 76
codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 77
niDCPowerGetCalUserDefinedInfoReturnstheuser-definedinformationinthepowersupplyonboardEEPROM.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.inforeturnstheuser-definedinformationstoredinthepowersupplyonboardEEPROM.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 78
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 79
niDCPowerReadCurrentTemperatureReturnsthecurrentonboardtemperature,indegreesCelsius,ofthepowersupply.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.temperaturereturnstheonboardtemperature,indegreesCelsius,ofthepowersupply.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 80
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 81
niDCPowerGetExtCalLastTempReturnstheonboardtemperatureofthepowersupply,indegreesCelsius,duringthelastsuccessfulexternalcalibration.
instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.temperaturereturnstheonboardtemperature,indegreesCelsius,ofthepowersupplyduringthelastsuccessfulexternalcalibration.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 82
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 83
niDCPowerInitializeWithOptionsCreatesanewIVIinstrumentdriversessiontothepowersupplyspecifiedinresourcenameandreturnsasessionhandleyouusetoidentifythepowersupplyinallsubsequentNI-DCPowerVIcalls.WiththisVI,youcanoptionallysettheinitialstateofthefollowingsessionproperties:Simulate,DriverSetup,RangeCheck,QueryInstrumentStatus,Cache,andRecordValueCoercions.ThisVIalsosendsinitializationcommandstosetthepowersupplytothestatenecessaryforNI-DCPowertooperate.Toplacethepowersupplyinaknownstartupstatewhencreatinganewsession,setresetdevicetoTRUE.ThisactionisequivalenttousingtheniDCPowerResetVI.Toopenasessionandleavethedeviceinitsexistingconfigurationwithoutpassingthroughatransitionaloutputstate,setresetdevicetoFALSE,andthenimmediatelycalltheniDCPowerAbortVI.Toapplyanewconfigurationwithoutdisruptingtheoutputchannelsofthedevice,configurethedeviceinDelayedConfigurationmodeasintheprevioussessionchangingonlythedesiredsettings,andthencalltheniDCPowerInitiateVI.
resourcenamespecifiestheresourcenameassignedbyMeasurement&AutomationExplorer(MAX),forexamplePXI1Slot3,wherePXI1Slot3isaninstrumentresourcename.resourcenamecanalsobealogicalIVIname.idqueryspecifieswhetherthedeviceisqueriedtodetermineifthedeviceisavalidinstrumentforNI-DCPower.ThedefaultisTRUE.resetdevicespecifieswhethertoresetthepowersupplyduringtheinitializationprocedure.ThedefaultisTRUE.optionstringspecifiestheinitialvalueofcertainpropertiesforthesession.Thesyntaxforoptionstringisalistofpropertieswithanassignedvaluewhere1isTRUEand0isFALSE.Eachproperty/valuecombinationisdelimitedwithacomma(,),asshowninthefollowingexample:Simulate=0,RangeCheck=1,QueryInstrStatus=0,Cache=1
Page 84
Ifyoudonotwirethisinputorpassanemptystring,thesessionassignsthedefaultvalues,shownintheprecedingexample,fortheseproperties.Youdonothavetospecifyavalueforalltheproperties.Ifyoudonotspecifyavalueforaproperty,thedefaultvalueisused.Formoreinformationaboutsimulatingadevice,refertoSimulatingaPowerSupplyorSMU.
errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutreturnsahandlethatyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 85
niDCPowerDisablePlacesthepowersupplyinaquiescentstatewhereithasminimalornoimpactonthesystemtowhichitisconnected.Thepoweroutputandallexportedsignalsaredisabled.ThisVIperformsthesameactionsastheniDCPowerResetVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerroror
Page 87
niDCPowerResetResetsthepowersupplytoaknownstate.ThisVIdisablespowergeneration,resetssessionpropertiestotheirdefaultvalues,clearserrorssuchasovertemperatureandunexpectedlossofauxiliarypower,commitsthesessionproperties,andleavesthesessioninImmediatemode.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,in
Page 88
mostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 89
niDCPowerResetDeviceResetsthepowersupplytoaknownstate.ThisVIdisablespowergeneration,resetssessionpropertiestotheirdefaultvalues,clearserrorssuchasovertemperatureandunexpectedlossofauxiliarypower,commitsthesessionproperties,andleavesthesessioninImmediatemode.ThisVIalsoperformsahardresetonthedeviceanddriversoftware.ThisVIhasthesamefunctionalityasusingresetinMeasurement&AutomationExplorer.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0ora
Page 90
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 91
niDCPowerSelfTestPerformsthepowersupplyself-testroutineandreturnsthetestresult(s).CallingthisVIimplicitlycallstheniDCPowerResetVI.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.selftestresultreturnsthevalueresultfromthepowersupplyself-test.0indicatessuccess.selftestmessagereturnstheselftestresultmessage.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.
Page 92
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 93
niDCPowerRevisionQueryReturnstherevisioninformationofNI-DCPowerandthepowersupplyfirmware.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.firmwarerevreturnsfirmwarerevisioninformationforthepowersupply.instrdriverrevreturnsthedriverrevisioninformationforNI-DCPower.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0ora
Page 94
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 95
niDCPowerResetwithDefaultsResetsthepowersupplytoaknownstate.ThisVIdisablespowergeneration,resetssessionpropertiestotheirdefaultvalues,clearserrorssuchasovertemperatureandunexpectedlossofauxiliarypower,commitsthesessionproperties,andleavesthesessioninImmediatemode.InadditiontoexhibitingthebehavioroftheniDCPowerResetVI,thisVIcanassignuser-defineddefaultvaluesforconfigurablepropertiesfromtheIVIconfiguration.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0ora
Page 96
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 97
niDCPowerGetChannelNameRetrievestheoutputchannelnamethatcorrespondstotherequestedindex.UsetheChannelCountpropertytodeterminetheupperboundofvalidvaluesforindex.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.indexspecifieswhichoutputchannelnametoreturn.Theindexvaluesbeginat1.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.namereturnstheoutputchannelnamethatcorrespondstoindex.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0ora
Page 98
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 99
niDCPowerGetNextCoercionRecordReturnsthecoercioninformationassociatedwiththeIVIsessionandclearstheearliestinstanceinwhichNI-DCPowercoercedavalueyouspecified.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.recordreturnsthenextcoercionrecordfortheIVIsession.Iftherearenocoercionrecords,theVIreturnsanemptystring.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.
Page 100
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 101
niDCPowerClearInterchangeWarningsClearsthelistofcurrentinterchangewarnings.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 102
niDCPowerResetInterchangeCheckConfiguresinterchangeability-checkingalgorithmstoignoreallpreviousconfigurationoptions.ThisVIdoesnotcleartheinterchangeabilitywarningsfromthelistofpreviouslyrecordedinterchangeabilitywarnings.IfyouwanttoguaranteethattheniDCPowerGetNextInterchangeWarningVIonlyreturnsthoseinterchangeabilitywarningsthataregeneratedaftercallingthisVI,clearthelistofinterchangeabilitywarningsbyrepeatedlycallingtheniDCPowerGetNextInterchangeWarningVIuntilnointerchangeabilitywarningsarereturned.Ifyouarenotinterestedinthecontentofthosewarnings,calltheniDCPowerClearInterchangeWarningsVI.Details
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
Page 103
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 104
DetailsWhendevelopingacomplextestsystemthatconsistsofmultipletestmodules,itisgenerallyagoodideatodesignthetestmodulessothattheycanruninanyorder.Todosorequiresensuringthateachtestmodulecompletelyconfiguresthestateofeachinstrumentituses.Ifaparticulartestmoduledoesnotcompletelyconfigurethestateofaninstrument,thestatedependsontheconfigurationfromapreviouslyexecutedtestmodule.Ifyouexecutethetestmodulesinadifferentorder,thebehavioroftheinstrumentandthereforetheentiretestmodulecanchange.Thisbehaviorchangeisgenerallyinstrument-specificandrepresentsaninterchangeabilityproblem.YoucanusetheniDCPowerResetInterchangeCheckVItotestforsuchcases.AfteryouusethisVI,theinterchangeability-checkingalgorithmsinNI-DCPowerignoreallpreviousconfigurationoperations.ByusingthisVIatthebeginningofatestmodule,youcandeterminewhetherthetestmodulehasdependenciesontheoperationofpreviouslyexecutedtestmodules.
Page 105
niDCPowerGetNextInterchangeWarningReturnstheinterchangeabilitywarningassociatedwiththeIVIsession.Itretrievesandclearstheearliestinstanceinwhichtheclassdriverrecordedaninterchangeabilitywarning.Interchangeabilitywarningsindicatethatusingyourapplicationwithadifferentpowersupplymaycauseadifferentbehavior.NI-DCPowerperformsinterchangeabilitycheckingwhentheInterchangeCheckpropertyissettoTRUE.ThisVIreturnsanemptystringinwarningifnointerchangeabilitywarningsremainforthesession.Ingeneral,NI-DCPowergeneratesinterchangeabilitywarningswhenapropertythataffectsthebehaviorofthepowersupplyisinastateyoudidnotspecify.
instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.
statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.warningreturnsthenextinterchangewarningfortheIVIsession.Iftherearenointerchangewarnings,theVIreturnsanemptystring.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI
Page 106
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
Page 107
ExamplesNI-DCPowerexamplesareinstructionaltoolsthatdemonstratepowersupplyfunctionality.Forexamplelocations,refertotheNI-DCPowerReadme.
Page 108
NI-DCPowerPropertiesExpandthissectiontoviewtheNI-DCPowerproperties.RefertoUsingPropertiesandAttributesformoreinformation.
Page 109
Channel-BasedPropertiesToaccessachannel-basedproperty,youmustwireanActiveChannelofanNI-DCPowerpropertynode.TheActiveChannelislistedfirstinthepropertynode.Toaccessadevice-basedproperty,donotwireanActiveChannelorwireanemptystring.
Page 110
PropertieswithMultipleChannelsYoucanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinActiveChannel.