RFmxWCDMA_CfgIQPowerEdgeTrigger
- Updated2024-10-14
- 2 minute(s) read
RFmxWCDMA_CfgIQPowerEdgeTrigger
int32 __stdcall RFmxWCDMA_CfgIQPowerEdgeTrigger (niRFmxInstrHandle instrumentHandle, char selectorString[], char IQPowerEdgeSource[], int32 IQPowerEdgeSlope, float64 IQPowerEdgeLevel, float64 triggerDelay, int32 minimumQuietTimeMode, float64 minimumQuietTime, int32 IQPowerEdgeLevelType, int32 enableTrigger);
Purpose
Configures the device to wait for the complex power of the I/Q data to cross the specified threshold and then marks a reference point within the record.
To trigger on bursty signals, specify a minimum quiet time, which ensures that the trigger does not occur in the middle of the burst signal. The quiet time must be set to a value smaller than the time between bursts, but large enough to ignore power changes within a burst.
Parameters
| Input | ||||||
| Name | Type | Description | ||||
| instrumentHandle | niRFmxInstrHandle | Specifies the instrument session. The RFmx driver obtains this parameter from the RFmxWCDMA_Initialize function. | ||||
| selectorString | char[] | Specifies a selector string comprising of the signal name. If you do not specify the signal name, the default signal instance is used. Example: "signal::sig1" You can use the RFmxWCDMA_BuildSignalString function to build the selector string. |
||||
| IQPowerEdgeSource | char[] | Specifies the channel from which the device monitors the trigger. |
||||
| IQPowerEdgeSlope | int32 | Specifies whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify.
|
||||
| IQPowerEdgeLevel | float64 | Specifies the power level at which the device triggers. The value is expressed in dB if IQPowerEdgeLevelType is set to RFMXEVDO_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE or in dBm if it is set to RFMXEVDO_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE. The device asserts the trigger when the signal exceeds the level specified by the value of this parameter, taking into consideration the specified slope. |
||||
| triggerDelay | float64 | Specifies the trigger delay time. This value is expressed in seconds. |
||||
| minimumQuietTimeMode | int32 | Specifies whether the measurement computes the minimum quiet time used for triggering. |
||||
| minimumQuietTime | float64 | Specifies the duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. If you set the IQPowerEdgeSlope parameter to RFMXWCDMA_VAL_IQ_POWER_EDGE_RISING_SLOPE, the signal is quiet when it is below the trigger level. If you set the IQPowerEdgeSlope parameter to RFMXWCDMA_VAL_IQ_POWER_EDGE_FALLING_SLOPE, the signal is quiet when it is above the trigger level. This value is expressed in seconds. |
||||
| IQPowerEdgeLevelType | int32 | Specifies the reference for the IQPowerEdgeLevel parameter.
The IQ Power Edge Level Type parameter is used only when you set the RFMXWCDMA_ATTR_TRIGGER_TYPE attribute to RFMXWCDMA_VAL_TRIGGER_TYPE_IQ_POWER_EDGE.
|
||||
| enableTrigger | int32 | Specifies whether to enable the trigger. |
||||
Return Value
| Name | Type | Description | ||||||||
| status | int32 | Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred. To obtain a text description of the status code and additional information about the error condition, call the RFmxWCDMA_GetError function. The general meaning of the status code is as follows:
|
||||||||