Skip to content

NI DAQMX System Configuration

Greg Stoll edited this page Sep 6, 2021 · 1 revision

System Configuration

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.

Table of Contents

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally