IviDigitizer_ConfigureGlitchArmSource
- Updated2023-02-24
- 2 minute(s) read
ViStatus IviDigitizer_ConfigureGlitchArmSource (ViSession instrumentHandle, ViChar _VI_FAR armSource[], ViReal64 armLevel_volts, ViReal64 glitchWidth_sec, ViInt32 glitchPolarity, ViInt32 glitchCondition);
Purpose
This function configures the glitch arm. A glitch arm occurs when the arm signal has a pulse with a width that is less than or greater than the glitch width.
Specify which comparison criterion to use with the glitchCondition parameter. Use the glitchWidth parameter and glitchPolarity parameter to specify the glitch width and the polarity of the pulse, respectively.
The arm does not actually occur until the edge of a pulse that corresponds to the glitchWidth and glitchPolarity crosses the threshold specified in the triggerLevel parameter. This function affects instrument behavior only if the IVIDIGITIZER_ATTR_ARM_TYPE attribute is IVIDIGITIZER_VAL_GLITCH_ARM.
Set the IVIDIGITIZER_ATTR_ARM_TYPE and IVIDIGITIZER_ATTR_ARM_COUPLING attributes before calling this function.
Note: This function is part of the IviDigitizerGlitchArm [GA] extension group.
Parameters
| Input | ||
| Name | Type | Description |
|---|---|---|
| instrumentHandle | ViSession | The ViSession handle that you obtain from the IviDigitizer_init or IviDigitizer_InitWithOptions function. The handle identifies a particular instrument session.
Default Value: None |
| armSource | ViChar[] | Specifies the arm source. The driver uses this value to set the IVIDIGITIZER_ATTR_ACTIVE_ARM_SOURCE attribute.
Default Value: "" Note: You can specify the arm source name as a string variable or as a literal enclosed in double quotes. |
| armLevel_volts | ViReal64 | Specifies the arm level. The driver uses this value to set the IVIDIGITIZER_ATTR_ARM_LEVEL attribute.
Unit: volts Default Value: 1.0 |
| glitchWidth_sec | ViReal64 | Specifies the glitch arming glitch width in seconds. The driver uses this value to set the IVIDIGITIZER_ATTR_GLITCH_ARM_WIDTH attribute.
Unit: seconds Default Value: 0.1 |
| glitchPolarity | ViInt32 | Specifies the glitch polarity. The driver uses this value to set the IVIDIGITIZER_ATTR_GLITCH_ARM_POLARITY attribute.
Valid Values: - IVIDIGITIZER_VAL_GLITCH_POSITIVE—The digitizer triggers on a positive glitch. - IVIDIGITIZER_VAL_GLITCH_NEGATIVE—The digitizer triggers on a negative glitch. - IVIDIGITIZER_VAL_GLITCH_EITHER—The digitizer triggers on either a positive or negative glitch. Default Value: IVIDIGITIZER_VAL_GLITCH_POSITIVE |
| glitchCondition | ViInt32 | Specifies the glitch condition. The driver uses this value to set the IVIDIGITIZER_ATTR_GLITCH_ARM_CONDITION attribute.
Valid Values: - IVIDIGITIZER_VAL_GLITCH_LESS_THAN—The digitizer triggers when the pulse width is less than the value you specify with the IVIDIGITIZER_ATTR_GLITCH_ARM_WIDTH attribute. - IVIDIGITIZER_VAL_GLITCH_GREATER_THAN—The digitizer triggers when the pulse width is greater than the value you specify with the IVIDIGITIZER_ATTR_GLITCH_ARM_WIDTH attribute. Default Value: IVIDIGITIZER_VAL_GLITCH_LESS_THAN |