DAQmxCreateAIForceIEPEChan

Download PDF

Updated2023-03-16
2 minute(s) read

int32 DAQmxCreateAIForceIEPEChan(TaskHandle taskHandle, const char physicalChannel[], const char nameToAssignToChannel[], int32 terminalConfig, float64 minVal, float64 maxVal, int32 units, float64 sensitivity, int32 sensitivityUnits, int32 currentExcitSource, float64 currentExcitVal, const char customScaleName[]);

Purpose

Creates channel(s) that use an IEPE force sensor to measure force or load.

Parameters

Input

Name

Type

Description

taskHandle

TaskHandle

The task to which to add the channels that this function creates.

physicalChannel

const char []

The names of the physical channels to use to create virtual channels. You can specify a list or range of physical channels.

nameToAssignToChannel

const char []

The name(s) to assign to the created virtual channel(s). If you do not specify a name, NI-DAQmx uses the physical channel name as the virtual channel name. If you specify your own names for nameToAssignToChannel, you must use the names when you refer to these channels in other NI-DAQmx functions.
If you create multiple virtual channels with one call to this function, you can specify a list of names separated by commas. If you provide fewer names than the number of virtual channels you create, NI-DAQmx automatically assigns names to the virtual channels.

terminalConfig

int32

The input terminal configuration for the channel.

Value		Description
DAQmx_Val_Cfg_Default		At run time, NI-DAQmx chooses the default terminal configuration for the channel.
DAQmx_Val_RSE		Referenced single-ended mode
DAQmx_Val_NRSE		Non-referenced single-ended mode
DAQmx_Val_Diff		Differential mode
DAQmx_Val_PseudoDiff		Pseudodifferential mode

minVal

float64

The minimum value, in units, that you expect to measure.

maxVal

float64

The maximum value, in units, that you expect to measure.

units

int32

Specifies in which unit to return force measurements from the channel.

Name		Description
DAQmx_Val_Newtons		newtons
DAQmx_Val_Pounds		pounds
DAQmx_Val_FromCustomScale		Units a custom scale specifies. Use customScaleName to specify a custom scale.

sensitivity

float64

The sensitivity of the sensor. This value is in the units you specify with the sensitivityUnits input. Refer to the sensor documentation to determine this value.

sensitivityUnits

int32

The units of sensitivity input.

Name		Description
DAQmx_Val_mVoltsPerNewton		millivolts per newton
DAQmx_Val_mVoltsPerPound		millivolts per pound

currentExcitSource

int32

The source of excitation.

Value		Description
DAQmx_Val_Internal		Use the built-in excitation source of the device. You must use currentExcitVal to specify the amount of excitation.
DAQmx_Val_External		Use an excitation source other than the built-in excitation source of the device. You must use currentExcitVal to specify the amount of excitation.
DAQmx_Val_None		Supply no excitation to the channel. You cannot use this value if the sensor requires excitation.

currentExcitVal

float64

The amount of excitation, in amperes, that the sensor requires.

customScaleName

const char []

The name of a custom scale to apply to the channel. To use this parameter, you must set units to DAQmx_Val_FromCustomScale. If you do not set units to DAQmx_Val_FromCustomScale, you must set customScaleName to 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.

NI-DAQ™mx C Reference

Table of Contents

DAQmxCreateAIForceIEPEChan

Purpose

Parameters

Return Value