NI DAQMX System Configuration

System Configuration

• DAQmxGetAnalogPowerUpStates
• DAQmxGetDigitalLogicFamilyPowerUpState
• DAQmxGetDigitalPowerUpStates
• DAQmxGetDigitalPullUpPullDownStates
• DAQmxSetAnalogPowerUpStates
• DAQmxSetDigitalLogicFamilyPowerUpState
• DAQmxSetDigitalPowerUpStates
• DAQmxSetDigitalPullUpPullDownStates

DAQmxGetAnalogPowerUpStates

int32 DAQmxGetAnalogPowerUpStates (const char deviceName[], const char channelName[], float64 *state, int32 channelType, ...);

Purpose

Gets the power-up states for analog physical channels.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
channelName	const char []	The physical channel to get the power-up state from. You can specify a list or range of channels.
Output
state	float64 *	The power-up state for the channel in channelName.
channelType	int32	The channel type for the channel in channelName.

Value		Description
DAQmx_Val_ChannelVoltage		Voltage
DAQmx_Val_ChannelCurrent		Current

moreChannelsAndStates	any type (passed by value)	Pairs of additional channels and the states to get when the device powers up or when the device is reset. You must pass NULL at the end of the argument list. If you do not want to pass additional channels and states, the function call can be similar to the following example: DAQmxGetAnalogPowerUpStates ("Dev1", "Dev1/ao0", &state, DAQmx_Val_ChannelVoltage, NULL); If you pass additional channels and states, the function call can be similar to the following example: DAQmxGetAnalogPowerUpStates ("Dev1", "Dev1/ao0", &state_ao0, DAQmx_Val_ChannelVoltage, "Dev1/ao1", &state_ao1, DAQmx_Val_ChannelCurrent, NULL);

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxGetDigitalLogicFamilyPowerUpState

int32 DAQmxGetDigitalLogicFamilyPowerUpState (const char deviceName[], int32 *logicFamily);

Purpose

Gets the digital logic family for a device.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
Output
logicFamily	int32 *	The logic family of the device when it powers up. A logic family corresponds to voltage thresholds that are compatible with a group of voltage standards. Refer to device documentation for information on the logic high and logic low voltages for these logic families.

Value		Description
DAQmx_Val_2point5V		2.5 V (compatible with CMOS signals)
DAQmx_Val_3point3V		3.3 V (compatible with LVTTL and LVCMOS signals)
DAQmx_Val_5V		5 V (compatible with TTL and CMOS signals)

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxGetDigitalPowerUpStates

int32 DAQmxGetDigitalPowerUpStates (const char deviceName[], const char channelName[], int32 *state, ...);

Purpose

Gets the power-up states for digital physical lines.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
channelName	const char []	The digital line or port to get the power-up state from. You can specify a list or range of channels.
Output
state	int32 *	The power-up state for the channel in channelName.

Value		Description
DAQmx_Val_High		High logic
DAQmx_Val_Low		Low logic
DAQmx_Val_Tristate		High-impedance state. You can select this state only on devices with bidirectional ports, and you can select it only for entire ports. You cannot select this state for dedicated digital output lines.

moreChannelsAndStates	any type (passed by value)	Pairs of additional channels and the states to get when the device powers up or when the device is reset. You must pass NULL at the end of the argument list. If you do not want to pass additional channels and states, the function call can be similar to the following example: DAQmxGetDigitalPowerUpStates ("Dev1", "Dev1/do0", &state, NULL); If you pass additional channels and states, the function call can be similar to the following example: DAQmxGetDigitalPowerUpStates ("Dev1", "Dev1/do0", &state_do0, "Dev1/do1", &state_do1, NULL);

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxGetDigitalPullUpPullDownStates

int32 DAQmxGetDigitalPullUpPullDownStates (const char deviceName[], const char channelName[], int32 *state, ...);

Purpose

Gets the resistor level for lines when they are in tristate logic.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
channelName	const char []	The digital line or port to get the power-up state from. You can specify a list or range of channels.
Output
state	int32 *	The power-up state for the channel in channelName.

Value		Description
DAQmx_Val_PullUp		High logic
DAQmx_Val_PullDown		Low logic

moreChannelsAndStates	any type (passed by value)	Pairs of additional channels and the states to get when the device powers up or when the device is reset. You must pass NULL at the end of the argument list. If you do not want to pass additional channels and states, the function call can be similar to the following example: DAQmxGetDigitalPullUpPullDownStates ("Dev1", "Dev1/do0", &state, NULL); If you pass additional channels and states, the function call can be similar to the following example: DAQmxGetDigitalPullUpPullDownStates ("Dev1", "Dev1/do0", &state_do0, "Dev1/do1", &state_do1, NULL);

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxSetAnalogPowerUpStates

int32 DAQmxSetAnalogPowerUpStates (const char deviceName[], const char channelNames[], float64 state, int32 channelType, ...);

Purpose

Updates the states that analog physical channels on a device are set to when the device powers up or when the device is reset. Power-up states are stored in EEPROMs that you can write to only a limited number of times. Therefore, you should use this function as infrequently as possible. This function writes to the EEPROM only if a setting you request is different from the one currently stored on the EEPROM. This function writes power-up states in sequential order. Therefore, if a physical channel has multiple entries, the last entry is used.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
channelNames	const char []	The physical channel to modify. You can specify a list or range of channels.
state	float64	The power-up state to set for the channel(s) in channelNames.
channelType	int32	The channel type for the channel(s) in channelNames.

Value		Description
DAQmx_Val_ChannelVoltage		Voltage output. You can set voltage power-up states only for physical channels that support voltage output.
DAQmx_Val_ChannelCurrent		Current output. You can set current power-up states only for physical channels that support current output.

moreChannelsStatesAndTypes	any type (passed by value)	Combinations of additional channels and states and types to set the channels to when the device powers up or when the device is reset. You must pass NULL at the end of the argument list. If you do not want to pass additional channels and states, the function call can be similar to the following example: DAQmxSetAnalogPowerUpStates ("Dev1", "Dev1/ao0", 0.0, DAQmx_Val_ChannelVoltage, NULL); If you pass additional channels and states, the function call can be similar to the following example: DAQmxSetAnalogPowerUpStates ("Dev1", "Dev1/ao0", 0.0, DAQmx_Val_ChannelVoltage, "Dev1/ao1", 1.0, DAQmx_Val_ChannelCurrent, NULL);

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxSetDigitalLogicFamilyPowerUpState

int32 DAQmxSetDigitalLogicFamilyPowerUpState (const char deviceName[], int32 logicFamily);

Purpose

Sets the digital logic family to use when the device powers up.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
logicFamily	int32	Specifies the logic family to set the device to when it powers up. A logic family corresponds to voltage thresholds that are compatible with a group of voltage standards. Refer to device documentation for information on the logic high and logic low voltages for these logic families.

Value		Description
DAQmx_Val_2point5V		2.5 V (compatible with CMOS signals)
DAQmx_Val_3point3V		3.3 V (compatible with LVTTL and LVCMOS signals)
DAQmx_Val_5V		5 V (compatible with TTL and CMOS signals)

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxSetDigitalPowerUpStates

int32 DAQmxSetDigitalPowerUpStates (const char deviceName[], const char channelNames[], int32 state, ...);

Purpose

Updates the state that digital physical channels on static DIO devices are set to when the device powers up or when the device is reset. Power-up states are stored in EEPROMs that you can write to only a limited number of times. Therefore, you should use this function as infrequently as possible. This function writes to the EEPROM only if a setting you request is different from the one currently stored on the EEPROM. This function writes power-up states in sequential order. Therefore, if a physical channel has multiple entries, the last entry is used.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
channelNames	const char []	The digital line or port to modify. You cannot set power-up states for dedicated digital input lines. You can specify a list or range of channels.
state	int32	The power-up state to set for the channel(s) in channelNames.

Value		Description
DAQmx_Val_High		High logic
DAQmx_Val_Low		Low logic
DAQmx_Val_Tristate		High-impedance state. You can select this state only on devices with bidirectional ports, and you can select it only for entire ports. You cannot select this state for dedicated digital output lines.

moreChannelsAndStates	any type (passed by value)	Pairs of additional channels and the states to set the channels to when the device powers up or when the device is reset. You must pass NULL at the end of the argument list. If you do not want to pass additional channels and states, the function call can be similar to the following example: DAQmxSetDigitalPowerUpStates ("Dev1", "Dev1/do0", DAQmx_Val_High, NULL); If you pass additional channels and states, the function call can be similar to the following example: DAQmxSetDigitalPowerUpStates ("Dev1", "Dev1/do0", DAQmx_Val_High, "Dev1/do1", DAQmx_Val_Tristate, NULL);

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.

DAQmxSetDigitalPullUpPullDownStates

int32 DAQmxSetDigitalPullUpPullDownStates (const char deviceName[], const char channelNames[], int32 state, ...);

Purpose

Sets the resistor level to pull up or pull down for lines when they are in tristate logic. Power-up states are stored in EEPROMs that you can write to only a limited number of times. Therefore, you should use this function as infrequently as possible. This function writes to the EEPROM only if a setting you request is different from the one currently stored on the EEPROM. This function writes power-up states in sequential order. Therefore, if a physical channel has multiple entries, the last entry is used.

Parameters

Input
Name	Type	Description
deviceName	const char []	Specifies the name to assign to the device. If unspecified, NI-DAQmx chooses the device name.
channelNames	const char []	The digital line or port to modify. You cannot set power-up states for dedicated digital input lines. You can specify a list or range of channels.
state	int32	The power-up state to set for the channel(s) in channelNames.

Value		Description
DAQmx_Val_PullUp		High logic
DAQmx_Val_PullDown		Low logic

moreChannelsAndStates	any type (passed by value)	Pairs of additional channels and the states to set the channels to when the device powers up or when the device is reset. You must pass NULL at the end of the argument list. If you do not want to pass additional channels and states, the function call can be similar to the following example: DAQmxSetDigitalPullUpPullDownStates ("Dev1", "Dev1/do0", DAQmx_Val_PullUp, NULL); If you pass additional channels and states, the function call can be similar to the following example: DAQmxSetDigitalPullUpPullDownStates ("Dev1", "Dev1/do0", DAQmx_Val_PullUp, "Dev1/do1", DAQmx_Val_PullDown, NULL);

Return Value

Name	Type	Description
status	int32	The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.