DAQmxCreateAIForceBridgeTwoPointLinChan
- Updated2023-03-16
- 3 minute(s) read
int32 DAQmxCreateAIForceBridgeTwoPointLinChan(TaskHandle taskHandle, const char physicalChannel[], const char nameToAssignToChannel[], float64 minVal, float64 maxVal, int32 units, int32 bridgeConfig, int32 voltageExcitSource, float64 voltageExcitVal, float64 nominalBridgeResistance, float64 firstElectricalVal, float64 secondElectricalVal, int32 electricalUnits, float64 firstPhysicalVal, float64 secondPhysicalVal, int32 physicalUnits, const char customScaleName[]);
Purpose
Creates channel(s) that use a Wheatstone bridge to measure force or load.
Use this instance with sensors whose specifications do not provide a polynomial for scaling or a table of electrical and physical values.
When you use this scaling type, NI-DAQmx uses two points of electrical and physical values to calculate the slope and y-intercept of a linear equation and uses that equation to scale electrical values to physical values.
Specify different values for units and physicalUnits if the sensor specifications provide physical values in one unit, but you want NI-DAQmx to scale data to a different unit.
Parameters
| Input | |||||||||||||||||
| Name | Type | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| taskHandle | TaskHandle | The task to which to add the channels that this function creates. | |||||||||||||||
| physicalChannel | The names of the physical channels to use to create virtual channels. You can specify a list or range of physical channels. | ||||||||||||||||
| nameToAssignToChannel | 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 | Specifies in which unit to return force measurements from the channel.
|
|||||||||||||||
| bridgeConfig | int32 | Specifies the Wheatstone bridge configuration connected to the channel.
|
|||||||||||||||
| voltageExcitSource | int32 | The source of excitation.
|
|||||||||||||||
| voltageExcitVal | float64 | Specifies in volts the amount of excitation supplied to the sensor. Refer to the sensor documentation to determine appropriate excitation values. | |||||||||||||||
| nominalBridgeResistance | float64 | Specifies in ohms the resistance of the bridge while not under load. | |||||||||||||||
| firstElectricalVal | float64 | The first electrical value, corresponding to firstPhysicalVal. Specify this value in the unit indicated by electricalUnits. | |||||||||||||||
| secondElectricalVal | float64 | The second electrical value, corresponding to secondPhysicalVal. Specify this value in the unit indicated by electricalUnits. | |||||||||||||||
| electricalUnits | int32 | Specifies from which electrical unit to scale data. Select the same unit that the sensor data sheet or calibration certificate uses for electrical values.
|
|||||||||||||||
| firstPhysicalVal | float64 | The first physical value, corresponding to firstElectricalVal. Specify this value in the unit indicated by physicalUnits. | |||||||||||||||
| secondPhysicalVal | float64 | The second physical value, corresponding to secondElectricalValue. Specify this value in the unit indicated by physicalUnits. | |||||||||||||||
| physicalUnits | int32 | Specifies to which physical units to scale electrical data. Select the same unit that the sensor data sheet or calibration certificate uses for physical values.
|
|||||||||||||||
| customScaleName | 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. |