DAQmxSetDigitalPowerUpStates

NI-DAQmx C Functions

previous page next page

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 []

The name of the device, as configured in Measurement & Automation Explorer (MAX), to which this operation applies.

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.

previous page start next page