NI-DAQmx .NET Framework 4.0 API Reference

DaqSystem.SetDevicePowerUpState Method (String, String[], Double[], String[], Double[])

  • Updated2023-02-21
  • 2 minute(s) read
DaqSystem.SetDevicePowerUpState Method (String, String[], Double[], String[], Double[])
Updates the power up states to which to set analog physical channels on a device when the device powers up or when you reset the device.

Namespace:  NationalInstruments.DAQmx
Assembly:  NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302

Syntax

public void SetDevicePowerUpState(
	string deviceName,
	string[] voltageChannels,
	double[] voltageValues,
	string[] currentChannels,
	double[] currentValues
)
Public Sub SetDevicePowerUpState ( 
	deviceName As String,
	voltageChannels As String(),
	voltageValues As Double(),
	currentChannels As String(),
	currentValues As Double()
)

Parameters

deviceName
Type: SystemString
The name, as configured in Measurement Automation Explorer (MAX), of the device to which this operation applies.
voltageChannels
Type: SystemString
The voltage channels for which to set new power up values. Each value in this array specifies a virtual channel string that is assigned the voltage at the corresponding position in the voltageValues parameter. You can set voltage power up states only for physical channels that support voltage output.
voltageValues
Type: SystemDouble
The voltages to set. Each value in this array applies to the virtual channel name at the corresponding position of the voltageChannels parameter. You can set voltage power up states only for physical channels that support voltage output.
currentChannels
Type: SystemString
The current channels for which to set new power up values. Each value in this array specifies a virtual channel string that is assigned the current at the corresponding position in the currentValues parameter. You can set current power up states only for physical channels that support current output.
currentValues
Type: SystemDouble
The currents to set. Each value in this array applies to the virtual channel name at the corresponding position of the currentChannels parameter. You can set current power up states only for physical channels that support current output.

Exceptions

ExceptionCondition
DaqExceptionThe NI-DAQmx driver returned an error.

Remarks

Power up states are stored in EEPROMs that you can write to only a limited number of times. Therefore, you should use this method as infrequently as possible. This method writes to the EEPROM only if a setting you request is different from the one currently stored on the EEPROM. This method writes power up states in the sequential order of the power up states array. Therefore, any physical channels with multiple entries in that array use the highest array index.

When you call this method, you can choose to not set either voltages or currents by passing in for the voltage or current parameters, but not both.

See Also

Log in to get a better experience