niRFSA_init
From NI RF Vector Signal Analyzers
niRFSA_init
ViStatus = niRFSA_init ( ViRsrc resourceName, ViBoolean IDQuery, ViBoolean reset, ViSession* vi);
Purpose
Creates a new session for the device. This function performs the following initialization actions:
- Creates a new instrument driver session to the RF signal analyzer, using the downconverter resource name you specify.
- Sends initialization commands to reset both hardware modules to a known state necessary for NI-RFSA operation.
| Note Before initializing the NI 5661, an NI 5142 IF digitizer module must be associated with the NI 5600 downconverter module in MAX. After association, pass the NI 5600 device name to this VI to initialize both modules. To change the digitizer association, modify the NI 5600 Properties page in MAX, or use this function to override the association in MAX. Refer to the NI RF Vector Signal Analyzers Getting Started Guide, installed at Start»Programs»National Instruments»NI-RFSA»Documentation for information on MAX association. |
Parameters
| Input | |||||||||||||
| Name | Type | Description | |||||||||||
| resourceName | ViRsrc | Specifies the resource name of the device to initialize.
For NI-DAQmx devices, the syntax is the device name specified in MAX, as shown in Example 1. Typical default names for NI-DAQmx devices in MAX are Dev1 or PXI1Slot1. You can rename an NI-DAQmx device by right-clicking on the name in MAX and entering a new name. You can also pass in the name of an IVI logical name configured with the IVI Configuration utility. For additional information, refer to the IVI topic in the Measurement & Automation Explorer Help.
|
|||||||||||
| IDQuery | ViBoolean | Specifies whether NI-RFSA performs an ID query. | |||||||||||
| reset | ViBoolean | Specifies whether you want the to reset the NI-RFSA device during the initialization procedure. TRUE means that the device is reset; FALSE means that the device is not reset. FALSE is the default value. | |||||||||||
| Output | |||||||||||||
| Name | Type | Description | |||||||||||
| vi | ViSession | Identifies your instrument session. |
Return Value
| Name | Type | Description | ||
| status | ViStatus | Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. You examine the status code from each call to an instrument driver function to determine if an error occurred. To obtain a text description of the status code, call the niRFSA_error_message function. To obtain additional information about the error condition, call the niRFSA_GetError function. To clear the error information from the driver, call the niRFSA_ClearError function. The general meaning of the status code is as follows:
|
Meaning | |
|---|---|---|---|---|
| 0 | Success | |||
| Positive Values | Warnings | |||
| Negative Values | Errors |