niWLANA_RFSAAutoRange
- Updated2023-02-21
- 2 minute(s) read
int32 __stdcall niWLANA_RFSAAutoRange (niWLANAnalysisSession session, char wlanChannelString[], ViSession rfsaSession, char hwChannelString[]);
Purpose
Analyzes the incoming signal to measure the maximum input power and acquisition length of the burst and sets these values to the NIWLANA_RESULT_AUTORANGE_MAX_INPUT_RANGE and NIWLANA_RESULT_AUTORANGE_ACQUISITION_LENGTH attributes, respectively.
You must configure the NIWLANA_AUTORANGE_MAX_ACQUISITION_LENGTH attribute before using this function. This function queries the NIRFSA_ATTR_IQ_RATE attribute, multiplies this value by the NIWLANA_AUTORANGE_MAX_ACQUISITION_LENGTH value, and sets the result equal to the NIRFSA_ATTR_NUMBER_OF_SAMPLES attribute.
You must configure the NIWLANA_AUTORANGE_MAX_IDLE_TIME attribute before using this function. This function sets the timeout parameter on the niRFSA_Fetch_IQ function equal to the sum of the values of both the NIWLANA_AUTORANGE_MAX_IDLE_TIME and NIWLANA_AUTORANGE_MAX_ACQUISITION_LENGTH attributes.
You must configure the NIRFSA_ATTR_REF_TRIGGER_TYPE attribute before using the niWLANA_RFSAAutoRange function. The toolkit supports the NIRFSA_VAL_NONE, NIRFSA_VAL_DIGITAL_EDGE, and NIRFSA_VAL_IQ_POWER_EDGE Reference trigger types that are specified in the NIRFSA_ATTR_REF_TRIGGER_TYPE attribute.
This function is not available for non-gated spectrum mode.
Parameters
| Input | ||
| Name | Type | Description |
| session | niWLANAnalysisSession | Specifies the niWLAN analysis session refnum. |
| wlanChannelString | char[] | Specifies the WLAN channel to be used for configuration. Refer to the Configuring Active Channels (LabWindows™/CVI™) topic for more information about configuring active channels. |
| rfsaSession | ViSession | Specifies a reference to an NI-RFSA instrument session. This parameter is obtained from the niRFSA_init or niRFSA_InitWithOptions functions and identifies a particular instrument session. |
| hwChannelString | char[] | Specifies the RFSA device channel. Set this parameter to "" (empty string) or NULL. |
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 niWLAN 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 niWLANA_GetErrorString function. The general meaning of the status code is as follows:
|
||||||||