niWLANA_RFSAMultipleDeviceInitiate
- Updated2023-02-21
- 2 minute(s) read
int32 __stdcall niWLANA_RFSAMultipleDeviceInitiate (niWLANAnalysisSession session, ViSession rfsaSessions[], int32 noOfChannels);
Purpose
Commits settings to hardware, waits for hardware settling, and starts multi-device synchronized acquisition. This function is called by the niWLANA_RFSAMIMOMeasure function.
If you use PXIe-5644, PXIe-5645, or PXIe-5646 RF vector signal transceiver devices, the function completes the following tasks:
- It commits the device settings to the master device by calling the niRFSA_Commit function.
- It then initializes acquisition for slave devices first and then for the master device by calling the niRFSA_Initiate function in a loop.
If you use PXIe-5663/5663E, PXIe-5665, PXIe-5668, PXIe-5840, PXIe-5841, PXIe-5820, PXIe-5830, or PXIe-5831, the function completes the following tasks:
- If NIWLANA_TCLK_SYNCHRONIZATION_ENABLED attribute is set to NIWLANA_VAL_TCLK_SYNCHRONIZATION_ENABLED_TRUE, this function uses the niWLANA_RFSA_ConfigureForHomogeneousTriggers function, niWLANA_RFSA_Synchronize_TClk function, and niTClk_Initiate function. For additional information, refer to NI-TClk Synchronization Help section of NI RF Vector Signal Analyzers Help.
- If NIWLANA_TCLK_SYNCHRONIZATION_ENABLED attribute is set to NIWLANA_VAL_TCLK_SYNCHRONIZATION_ENABLED_FALSE, then it calls niRFSA_Initiate function in a loop for non-synchronized acquisition.
Parameters
| Input | ||
| Name | Type | Description |
| session | niWLANAnalysisSession | Specifies the niWLAN analysis session refnum. |
| rfsaSessions | ViSession[] | Specifies an array of references to multiple NI-RFSA instrument sessions. This parameter is obtained from the niRFSA_init or niRFSA_InitWithOptions function and identifies a particular instrument session. |
| noOfChannels | int32 | Specifies the number of channels (waveforms) to process during analysis measurements. The number of received channels must be less than or equal to the number of channels acquired. |
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:
|
||||||||