Download - NI-DCPower LabVIEW Reference Help · niDCPower Close Closes the session specified in instrument handle and deallocates the resources that NI-DCPower reserved. If power output is enabled

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.


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



instrumenthandleoutpassesthehandleusedtoidentifythe

sessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


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.


instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.

NIDCPowerProperties.chm::/pnidcpower_Samples_To_Average.html

voltagemeasurementsreturnsanarrayofvoltagemeasurements.Themeasurementsinthearrayarereturnedinthesameorderasthechannelsspecifiedinchannelname.currentmeasurementsreturnsanarrayofcurrentmeasurements.Themeasurementsinthearrayarereturnedinthesameorderasthechannelsspecifiedinchannelname.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


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


statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.

sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.



niDCPowerInitiateCommitstheconfiguredsettingstohardwareandplacesthepowersupplyinImmediatemode.AnyconfigurationcallsmadeafterthisVIareappliedimmediately.Tocommitsimultaneoushardwaresettingsonmultipleoutputchannels,calltheniDCPowerAbortVI,configurethepowersupply,andthencallthisVI.




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.



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.


statusisTRUE(X)ifanerroroccurredbeforethisVIranorFALSE(checkmark)toindicateawarningorthatnoerroroccurredbeforethisVIran.ThedefaultisFALSE.

codeistheerrororwarningcode.Thedefaultis0.IfstatusisTRUE,codeisanegativeerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.Thedefaultisanemptystring.



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

NIDCPowerProperties.chm::/pnidcpower_Voltage_Level_Autorange.html

20 -20to+20V

NoteIfarangeotherthanwhatislistedintheprecedingtableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe10VvoltagelevelrangeonChannel1ontheNI-PXI4130coercesthevoltagelevelrangeto20V.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.





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.

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

NIDCPowerProperties.chm::/pnidcpower_Current_Limit_Autorange.html

1 200μA +4to+200μA2mA +0.04to+2mA20mA +0.40to+20mA200mA +4to+200mA2A +0.04to+2A

NoteIfarangeotherthanwhatislistedintheprecedingtableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe100mAcurrentlimitrangeonChannel1ontheNI-PXI4130coercesthecurrentlevelrangeto200mA.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.




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.



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

NIDCPowerProperties.chm::/pnidcpower_Current_Level_Autorange.html

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.




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.



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

NIDCPowerProperties.chm::/pnidcpower_Voltage_Limit_Autorange.html

tableisselected,itwillbecoercedtothenext-highestrange.Forexample,requestingthe10VvoltagelimitrangeonChannel1ontheNI-PXI4130coercesthevoltagelimitrangeto20V.RefertotheRangestopicintheNIDCPowerSuppliesandSMUsHelpformoreinformationaboutcoercion.





niDCPowerQueryOutputStateQueriesthespecifiedoutputchanneltodetermineiftheoutputchanneliscurrentlyinthestatespecifiedbyoutputstate.

instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Theoutputstatemayonlybequeriedforonechannelatatime.outputstatespecifiestheoutputstateoftheoutputchannelthatisbeingqueried.

ConstantVoltage

Thechannelismaintainingaconstantvoltageatitsoutput.

ConstantCurrent

Thechannelismaintainingaconstantcurrentatitsoutput.

DefaultValue:ConstantVoltage



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.instate?returnswhetherthepowersupplyoutputchannelisinthe

specifiedstate.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerMeasureReturnsthemeasuredvalueofeitherthevoltageorcurrentonthespecifiedoutputchannel.EachcalltothisVIblocksotherVIcallsuntilthehardwarereturnsthemeasurement.ThemeasurementspeedofthepowersupplyandtheSamplestoAveragepropertydictatethelengthoftimethatameasurementtakes.Tomeasuremultipleoutputchannels,usetheniDCPowerMeasureMultipleVI.

instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltomeasure.OnlyonemeasurementatatimemaybemadewiththeniDCPowerMeasureVI.UsetoniDCPowerMeasureMultipleVItomeasuremultiplechannelsormeasurementtypes.measurementtypespecifieswhetheravoltageorcurrentvalueshouldbemeasured.

Voltage Thepowersupplymeasuresvoltage.Current Thepowersupplymeasurescurrent.

DefaultValue:Voltage



NIDCPowerProperties.chm::/pnidcpower_Samples_To_Average.html

instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.measurementreturnsthevalueofthemeasurement,eitherinvoltsforvoltageorampsforcurrent.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerQueryMaxCurrentLimitQueriesthemaximumcurrentlimitonanoutputchanneliftheoutputchannelissettothespecifiedvoltagelevel.

instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.channelnamespecifiestheoutputchanneltoquery.Themaximumcurrentlimitmayonlybequeriedforonechannelatatime.voltagelevelspecifiesthevoltageleveltousewhencalculatingthemaxcurrentlimit.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


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.


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.


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.


instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.

incompliance?returnswhetherthepowersupplyoutputchannelisincompliance.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerInitializeExternalCalibrationIfpasswordisvalid,thisVIcreatesanewIVIinstrumentdriversessiontothepowersupplyspecifiedinresourcenameandreturnsaninstrumenthandleyouusetoidentifythepowersupplyinallsubsequentNI-DCPowerVIcalls.ThisVIalsosendsinitializationcommandstosetthepowersupplytothestatenecessaryfortheoperationofNI-DCPower.Openingacalibrationsessionalwaysperformsareset.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.

resourcenamespecifiestheresourcenameassignedbyMeasurement&AutomationExplorer(MAX),forexamplePXI1Slot3,wherePXI1Slot3isaninstrumentresourcename.resourcenamecanalsobealogicalIVIname.passwordspecifiesthepasswordforopeningacalibrationsession.passwordcanbeamaximumoffouralphanumericcharacters.Theinitialpasswordisfactoryconfiguredto"NI".errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


instrumenthandleoutreturnsahandlethatyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI

niDCPowerCloseExternalCalibrationClosesthesessionspecifiedininstrumenthandleanddeallocatestheresourcesthatNI-DCPowerreservedforcalibration.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.IfanerroroccursbeforethisVI,calibrationcloseactiondefaultstoCancel.

instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.calibrationcloseactionspecifieshowtousethecalibrationvaluesfromthissessionasthesessionisclosed.

Commit ThenewcalibrationconstantsarestoredintheEEPROM.

Cancel Theoldcalibrationconstantsarekept,andthenewonesarediscarded.

DefaultValue:Cancel




niDCPowerCalAdjustVoltageLevelCalculatesthecalibrationconstantsforthevoltagelevelforthespecifiedoutputchannel.ThisVIcomparesthearrayinrequestedoutputstothearrayinmeasuredoutputsandcalculatesthecalibrationconstantsforthevoltageleveloftheoutputchannel.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.ThisVIcanonlybecalledinanexternalcalibrationsession.

instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.channelnamespecifiestheoutputchanneltowhichthesecalibrationsettingsapply.Onlyonechannelatatimemaybecalibrated.numberofmeasurementsspecifiesthenumberofelementsinrequestedoutputsandmeasuredoutputs.requestedoutputsspecifiesanarrayoftheoutputvaluesrequestedintheniDCPowerConfigureVoltageLevelVI.measuredoutputsspecifiesanarrayoftheoutputvaluesmeasuredbyanexternalprecisiondigitalmultimeter.rangespecifiestherangetocalibratewiththesesettings.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


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.



niDCPowerCalAdjustCurrentLimitCalculatesthecalibrationconstantsforthecurrentlimitforthespecifiedoutputchannelandrange.ThisVIcomparesthearrayinrequestedoutputstothearrayinmeasuredoutputsandcalculatesthecalibrationconstantsforthecurrentlimitreturnedbythepowersupply.RefertothecalibrationprocedureforthepowersupplyyouarecalibratingfordetailedinstructionsontheappropriateuseofthisVI.ThisVIcanonlybecalledfromanexternalcalibrationsession.

instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.channelnamespecifiestheoutputchanneltowhichthesecalibrationsettingsapply.Onlyonechannelatatimemaybecalibrated.numberofmeasurementsspecifiesthenumberofelementsinrequestedoutputsandmeasuredoutputs.rangespecifiestherangetocalibratewiththesesettings.requestedoutputsspecifiesanarrayoftheoutputvaluesrequestedintheniDCPowerConfigureCurrentLimitVI.measuredoutputsspecifiesanarrayoftheoutputvaluesmeasuredbyanexternalprecisiondigitalmultimeter.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


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.



niDCPowerChangeExtCalPasswordChangesthepasswordthatisrequiredtoinitializeanexternalcalibrationsession.Thepasswordcanbeamaximumoffouralphanumericcharacters.IfyoucallthisVIinaregularsession,passwordischangedimmediately.IfyoucallthisVIinanexternalcalibrationsession,passwordischangedonlyafteryouclosethesessionusingtheniDCPowerCloseExternalCalibrationVIwithcalibrationcloseactionsettoCommit.

instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.oldpasswordspecifiesthepreviouspasswordusedtoprotectthecalibrationvalues.newpasswordspecifiesthenewpasswordtousetoprotectthecalibrationvalues.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI

niDCPowerGetExtCalRecommendedIntervalReturnstherecommendedmaximuminterval,inmonths,betweenexternalcalibrations.

instrumenthandleidentifiesaparticularinstrumentcalibrationsession.instrumenthandleisobtainedfromtheniDCPowerInitializeExternalCalibrationVI.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.monthsspecifiestherecommendedmaximuminterval,inmonths,betweenexternalcalibrations.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerGetExtCalLastDateAndTimeReturnsthedateandtimeofthelastsuccessfulcalibration.Thetimereturnedis24-hour(military)localtime;forexample,ifthepowersupplywascalibratedat2:30PM,thisVIreturns14forhoursand30forminutes.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.yearreturnstheyearinwhichthepowersupplywaslastcalibrated.monthreturnsthemonthinwhichthepowersupplywaslastcalibrated.dayreturnsthedayonwhichthepowersupplywaslastcalibrated.hourreturnsthehour(in24-hourtime)inwhichthepowersupplywaslastcalibrated.minutereturnstheminuteinwhichthepowersupplywaslastcalibrated.

niDCPowerGetCalUserDefinedInfoMaxSizeReturnsthemaximumnumberofcharactersthatcanbeusedtostoreuser-definedinformationinthepowersupplyonboardEEPROM.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.infosizereturnsthenumberofcharactersthatcanbestoredinthepowersupplyonboardEEPROM.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerSetCalUserDefinedInfoStoresauser-definedstringofcharactersinthepowersupplyonboardEEPROM.Ifthestringislongerthanthemaximumallowablesize,itistruncated.ThisVIoverwritesanyexistinguser-definedinformation.IfyoucallthisVIinaregularsession,infoisimmediatelychanged.IfyoucallthisVIinanexternalcalibrationsession,infoischangedonlyafteryouclosethesessionusingtheniDCPowerCloseExternalCalibrationVIwithcalibrationcloseactionsettoCommit.

instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.infospecifiesthestringtostoreinthepowersupplyonboardEEPROM.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.



statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.

codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerrororwarning.

niDCPowerGetCalUserDefinedInfoReturnstheuser-definedinformationinthepowersupplyonboardEEPROM.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.inforeturnstheuser-definedinformationstoredinthepowersupplyonboardEEPROM.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerReadCurrentTemperatureReturnsthecurrentonboardtemperature,indegreesCelsius,ofthepowersupply.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.temperaturereturnstheonboardtemperature,indegreesCelsius,ofthepowersupply.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerGetExtCalLastTempReturnstheonboardtemperatureofthepowersupply,indegreesCelsius,duringthelastsuccessfulexternalcalibration.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.temperaturereturnstheonboardtemperature,indegreesCelsius,ofthepowersupplyduringthelastsuccessfulexternalcalibration.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


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

NIDCPowerProperties.chm::/pnidcpower_Simulate.html

NIDCPowerProperties.chm::/pnidcpower_Driver_Setup.html

NIDCPowerProperties.chm::/pnidcpower_Range_Check.html

NIDCPowerProperties.chm::/pnidcpower_Query_Instrument_Status.html

NIDCPowerProperties.chm::/pnidcpower_Cache.html

NIDCPowerProperties.chm::/pnidcpower_Record_Value_Coercions.html

Ifyoudonotwirethisinputorpassanemptystring,thesessionassignsthedefaultvalues,shownintheprecedingexample,fortheseproperties.Youdonothavetospecifyavalueforalltheproperties.Ifyoudonotspecifyavalueforaproperty,thedefaultvalueisused.Formoreinformationaboutsimulatingadevice,refertoSimulatingaPowerSupplyorSMU.



instrumenthandleoutreturnsahandlethatyouusetoidentifythesessioninallsubsequentNI-DCPowerVIcalls.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerDisablePlacesthepowersupplyinaquiescentstatewhereithasminimalornoimpactonthesystemtowhichitisconnected.Thepoweroutputandallexportedsignalsaredisabled.ThisVIperformsthesameactionsastheniDCPowerResetVI.




statusisTRUE(X)ifanerroroccurredorFALSE(checkmark)toindicateawarningorthatnoerroroccurred.codetheerrororwarningcode.IfstatusisTRUE,codeisanon-zeroerrorcode.IfstatusisFALSE,codeis0orawarningcode.sourcedescribestheoriginoftheerrororwarningandis,inmostcases,thenameoftheVIthatproducedtheerroror

warning.

niDCPowerResetResetsthepowersupplytoaknownstate.ThisVIdisablespowergeneration,resetssessionpropertiestotheirdefaultvalues,clearserrorssuchasovertemperatureandunexpectedlossofauxiliarypower,commitsthesessionproperties,andleavesthesessioninImmediatemode.





niDCPowerResetDeviceResetsthepowersupplytoaknownstate.ThisVIdisablespowergeneration,resetssessionpropertiestotheirdefaultvalues,clearserrorssuchasovertemperatureandunexpectedlossofauxiliarypower,commitsthesessionproperties,andleavesthesessioninImmediatemode.ThisVIalsoperformsahardresetonthedeviceanddriversoftware.ThisVIhasthesamefunctionalityasusingresetinMeasurement&AutomationExplorer.





niDCPowerSelfTestPerformsthepowersupplyself-testroutineandreturnsthetestresult(s).CallingthisVIimplicitlycallstheniDCPowerResetVI.



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.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.firmwarerevreturnsfirmwarerevisioninformationforthepowersupply.instrdriverrevreturnsthedriverrevisioninformationforNI-DCPower.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


niDCPowerResetwithDefaultsResetsthepowersupplytoaknownstate.ThisVIdisablespowergeneration,resetssessionpropertiestotheirdefaultvalues,clearserrorssuchasovertemperatureandunexpectedlossofauxiliarypower,commitsthesessionproperties,andleavesthesessioninImmediatemode.InadditiontoexhibitingthebehavioroftheniDCPowerResetVI,thisVIcanassignuser-defineddefaultvaluesforconfigurablepropertiesfromtheIVIconfiguration.





niDCPowerGetChannelNameRetrievestheoutputchannelnamethatcorrespondstotherequestedindex.UsetheChannelCountpropertytodeterminetheupperboundofvalidvaluesforindex.

instrumenthandleidentifiesaparticularinstrumentsession.instrumenthandleisobtainedfromtheniDCPowerInitializeortheniDCPowerInitializeWithOptionsVI.indexspecifieswhichoutputchannelnametoreturn.Theindexvaluesbeginat1.errorin(noerror)describeserrorconditionsthatoccurbeforethisVIruns.


instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.namereturnstheoutputchannelnamethatcorrespondstoindex.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVIproduces.


NIDCPowerProperties.chm::/pnidcpower_Channel_Count.html

niDCPowerGetNextCoercionRecordReturnsthecoercioninformationassociatedwiththeIVIsessionandclearstheearliestinstanceinwhichNI-DCPowercoercedavalueyouspecified.



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.





niDCPowerResetInterchangeCheckConfiguresinterchangeability-checkingalgorithmstoignoreallpreviousconfigurationoptions.ThisVIdoesnotcleartheinterchangeabilitywarningsfromthelistofpreviouslyrecordedinterchangeabilitywarnings.IfyouwanttoguaranteethattheniDCPowerGetNextInterchangeWarningVIonlyreturnsthoseinterchangeabilitywarningsthataregeneratedaftercallingthisVI,clearthelistofinterchangeabilitywarningsbyrepeatedlycallingtheniDCPowerGetNextInterchangeWarningVIuntilnointerchangeabilitywarningsarereturned.Ifyouarenotinterestedinthecontentofthosewarnings,calltheniDCPowerClearInterchangeWarningsVI.Details




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.



instrumenthandleoutpassesthehandleusedtoidentifythesessioninallsubsequentNI-DCPowerVIcalls.warningreturnsthenextinterchangewarningfortheIVIsession.Iftherearenointerchangewarnings,theVIreturnsanemptystring.erroroutcontainserrorinformation.IferrorinindicatesthatanerroroccurredbeforethisVIran,erroroutcontainsthesameerrorinformation.Otherwise,itdescribestheerrorstatusthatthisVI

NIDCPowerProperties.chm::/pnidcpower_Interchange_Check.html

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.

Download - NI-DCPower LabVIEW Reference Help · niDCPower Close Closes the session specified in instrument handle and deallocates the resources that NI-DCPower reserved. If power output is enabled

Top Related