AIChannelCollection.CreateTedsForceIepeChannel Method (String, String, AITerminalConfiguration, Double, Double, AIForceUnits, AIExcitationSource, Double)
- Updated2023-02-21
- 2 minute(s) read
Creates an
AIChannel
that uses an IEPE force sensor to measure force or load.
You must configure the physical channel(s) with TEDS information to use this method. This method adds one or more physical channels to the
AIChannelCollection.
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.45.49302
Syntax
public AIChannel CreateTedsForceIepeChannel( string physicalChannelName, string nameToAssignChannel, AITerminalConfiguration terminalConfiguration, double minimumValue, double maximumValue, AIForceUnits units, AIExcitationSource currentExcitationSource, double currentExcitationValue )
Public Function CreateTedsForceIepeChannel ( physicalChannelName As String, nameToAssignChannel As String, terminalConfiguration As AITerminalConfiguration, minimumValue As Double, maximumValue As Double, units As AIForceUnits, currentExcitationSource As AIExcitationSource, currentExcitationValue As Double ) As AIChannel
Parameters
- physicalChannelName
- Type: SystemString
The names of one or more physical channels to use to create one or more local virtual channels. - nameToAssignChannel
- Type: SystemString
One or more names to assign to the created local virtual channels. To use the physical channel name as the local virtual channel name, set this value to Empty. - terminalConfiguration
- Type: NationalInstruments.DAQmxAITerminalConfiguration
The input terminal configuration. To use the default terminal configuration for the physical channel(s) being used, pass a value of 1 casted to an AITerminalConfiguration. - minimumValue
- Type: SystemDouble
The minimum value you expect to measure, in units. - maximumValue
- Type: SystemDouble
The maximum value you expect to measure, in units. - units
- Type: NationalInstruments.DAQmxAIForceUnits
The units to use to return the measurement. - currentExcitationSource
- Type: NationalInstruments.DAQmxAIExcitationSource
The source of excitation. - currentExcitationValue
- Type: SystemDouble
The amount of excitation in amperes that the sensor requires.
Return Value
Type: AIChannelThe newly created AIChannel.
Exceptions
| Exception | Condition |
|---|---|
| DaqException | The NI-DAQmx driver returned an error. |
Remarks
The NI-DAQmx driver does not determine if the requested settings are possible until the task is verified. This method does not throw an exception for parameter values that are not compatible with your hardware or other settings in your task. To determine if all of the settings for a Task are valid, you must verify the task by starting the task, either with Start or by reading from or writing to the task, or by calling Control(TaskAction) with Verify.