DAQmxCreateTEDSAIPosLVDTChan

NI-DAQmx C Functions

DAQmxCreateTEDSAIPosLVDTChan

int32 DAQmxCreateTEDSAIPosLVDTChan (TaskHandle taskHandle, const char physicalChannel[], const char nameToAssignToChannel[], float64 minVal, float64 maxVal, int32 units, int32 voltageExcitSource, float64 voltageExcitVal, float64 voltageExcitFreq, int32 ACExcitWireMode, const char customScaleName[]);

Purpose

Creates channel(s) that use an LVDT to measure linear position and adds the channel(s) to the task you specify with taskHandle. You must configure the physical channel(s) with TEDS information to use this function.

Parameters

Input
Name Type Description
taskHandle TaskHandle The task used in this function.
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.
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 The units to use to return linear position measurements from the channel.
Name Description
DAQmx_Val_Meters Meters
DAQmx_Val_Inches Inches
DAQmx_Val_FromCustomScale Units a custom scale specifies. Use customScaleName to specify a custom scale.
voltageExcitSource int32 The source of excitation.
Value Description
DAQmx_Val_Internal Use the built-in excitation source of the device. You must use voltageExcitVal 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 voltageExcitVal 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.
voltageExcitVal float64 The amount of excitation, in volts, that the sensor requires.
voltageExcitFreq float64 The excitation frequency, in hertz, that the sensor requires. Refer to the sensor documentation to determine this value.
ACExcitWireMode int32 The number of leads on the sensor. Some sensors may require you to tie leads together to create a 4-wire or 5-wire sensor. Refer to the documentation for your sensor for more information.
Value Description
DAQmx_Val_4Wire 4-wire.
DAQmx_Val_5Wire 5-wire.
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.