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
mostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.
instrumenthandleoutreturnsahandlethatyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
warning.
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
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.
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
sessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
DetailsWhenDCVoltageisselected,thedevicegeneratesthedesiredvoltagelevelontheoutputaslongastheoutputcurrentisbelowthecurrentlimit.ThefollowingVIscanbeusedtoconfigurethechannelwhenDCVoltageisselected:
niDCPowerConfigureVoltageLevelniDCPowerConfigureCurrentLimitniDCPowerConfigureVoltageLevelRangeniDCPowerConfigureCurrentLimitRange
WhenDCCurrentisselected,thedevicegeneratesthedesiredcurrentlevelontheoutputaslongastheoutputvoltageisbelowthevoltagelimit.ThefollowingfunctionscanbeusedtoconfigurethechannelwhenDCCurrentisselected:
niDCPowerConfigureCurrentLevelniDCPowerConfigureVoltageLimitniDCPowerConfigureCurrentLevelRangeniDCPowerConfigureVoltageLimitRange
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.
voltagemeasurementsreturnsanarrayofvoltagemeasurements.Themeasurementsinthearrayarereturnedinthesameorderasthechannelsspecifiedinchannelname.currentmeasurementsreturnsanarrayofcurrentmeasurements.Themeasurementsinthearrayarereturnedinthesameorderasthechannelsspecifiedinchannelname.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
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.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
niDCPowerPropertyNodeSetsorgetspropertiesofthedevice.RefertoUsingPropertiesandAttributesformoreinformation.
Channel-BasedPropertiesToaccessachannel-basedproperty,youmustwireanActiveChannelofanNI-DCPowerpropertynode.TheActiveChannelislistedfirstinthepropertynode.Toaccessadevice-basedproperty,donotwireanActiveChannelorwireanemptystring.
PropertieswithMultipleChannelsYoucanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinActiveChannel.
NI-DCPowerExpressConfiguresandgeneratesasignalusingNI-DCPowerwithNationalInstrumentsDCpowersuppliesandSMUs.
DialogBoxOptionsBlockDiagramInputsBlockDiagramOutputs
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
BlockDiagramInputsParameter DescriptionClose(T) Specifieswhetherthesessiontothedeviceremainsopen
aftertheVIfinishesexecution.SetClose(T)toTRUEtocloseallreferencesandreinitializethedeviceforeachiteration.SetClose(T)toFALSEforalliterationsexceptthelastiterationforloopoptimization.ThedefaultisTRUE.
errorin DescribeserrorconditionsthatoccurbeforethisVIruns.
BlockDiagramOutputsParameter DescriptionMeasuredVoltage
Returnsthevoltagevaluesmeasuredonalloutputchannels.
MeasuredCurrent
Returnsthecurrentvaluesmeasuredonalloutputchannels.
errorout Containserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisExpressVIran,erroroutcontainsthesameerrorinformation.Otherwise,erroroutdescribestheerrorstatusthatthisExpressVIproduces.
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.
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.
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
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.
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.
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.
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
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
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
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.
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
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.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
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.
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
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.
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
specifiedstate.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.measurementreturnsthevalueofthemeasurement,eitherinvoltsforvoltageorampsforcurrent.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
incompliance?returnswhetherthepowersupplyoutputchannelisincompliance.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
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.
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
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.
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.
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.
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
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.
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
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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
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.
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
warning.
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
mostcases,thenameoftheVIthatproducedtheerrororwarning.
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
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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
warningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
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.
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.
statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
DetailsWhendevelopingacomplextestsystemthatconsistsofmultipletestmodules,itisgenerallyagoodideatodesignthetestmodulessothattheycanruninanyorder.Todosorequiresensuringthateachtestmodulecompletelyconfiguresthestateofeachinstrumentituses.Ifaparticulartestmoduledoesnotcompletelyconfigurethestateofaninstrument,thestatedependsontheconfigurationfromapreviouslyexecutedtestmodule.Ifyouexecutethetestmodulesinadifferentorder,thebehavioroftheinstrumentandthereforetheentiretestmodulecanchange.Thisbehaviorchangeisgenerallyinstrument-specificandrepresentsaninterchangeabilityproblem.YoucanusetheniDCPowerResetInterchangeCheckVItotestforsuchcases.AfteryouusethisVI,theinterchangeability-checkingalgorithmsinNI-DCPowerignoreallpreviousconfigurationoperations.ByusingthisVIatthebeginningofatestmodule,youcandeterminewhetherthetestmodulehasdependenciesontheoperationofpreviouslyexecutedtestmodules.
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
produces.statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.
ExamplesNI-DCPowerexamplesareinstructionaltoolsthatdemonstratepowersupplyfunctionality.Forexamplelocations,refertotheNI-DCPowerReadme.
NI-DCPowerPropertiesExpandthissectiontoviewtheNI-DCPowerproperties.RefertoUsingPropertiesandAttributesformoreinformation.
Channel-BasedPropertiesToaccessachannel-basedproperty,youmustwireanActiveChannelofanNI-DCPowerpropertynode.TheActiveChannelislistedfirstinthepropertynode.Toaccessadevice-basedproperty,donotwireanActiveChannelorwireanemptystring.
PropertieswithMultipleChannelsYoucanspecifymultiplechannelsbyusingachannellistorachannelrange.Achannellistisacomma(,)separatedsequenceofchannelnames(e.g.0,2specifieschannels0and2).Achannelrangeisalowerboundchannelfollowedbyahyphen(-)orcolon(:)followedbyanupperboundchannel(e.g.0-2specifieschannels0,1,and2).InImmediatemode,multipleoutputchannelconfigurationsareperformedsequentiallybasedontheorderspecifiedinActiveChannel.