Creates an RFmx MIMO session to the NI-RFSA supported device(s) you specify through the Resource Names parameter, and returns an Instrument Handle Out that identifies the device(s) in all subsequent RFmx VIs.

Supported devices: PXIe-5840/5841/5842/5860, PXIe-5830/5831/5832


icon

Inputs/Outputs

  • c1divrn.png Resource Names —

    Resource Names specifies the resource names of the devices to initialize.

    The following example shows how to specify the resource names.
    Device Type Syntax
    [myRFmxDevice0, myRFmxDevice1.,] RFmx device, device name is "myRFmxDevice0"

    For NI-DAQmx devices, the syntax is the device name specified in MAX, as shown in the example. Typical default names for NI-DAQmx devices in MAX are Dev1 or PXI1Slot2. You can rename an NI-DAQmx device by right-clicking the name in MAX, selecting Rename from the pull-down menu, and entering a new name. You can also pass the name of an IVI logical name configured with the IVI Configuration utility. For additional information about IVI, refer to the IVI section of the Measurement & Automation Explorer Help.

    Note For multichannel devices such as the PXIe-5860, the resource name must include the channel number to use. The channel number is specified by appending /ChannelNumber to the device name, where ChannelNumber is the channel number (0, 1, etc.). For example, if the device name is PXI1Slot2 and you want to use channel 0, use the resource name PXI1Slot2/0.
  • cstr.png Option String —

    Option String sets the initial value of certain properties for the session.

    The following properties are used in this parameter:

    • RFmxSetup
    • Simulate
    • AnalysisOnly

    For more information about properties used in this parameter, refer to NI RF Vector Signal Analyzers Help.

    The format of this string is "PropertyName=Value", where PropertyName is the name of the property and Value is the value to which the property is set. For example, you can simulate a PXIe-5840 device using the following string:

    "Simulate=1, RFmxSetup=Model:5840"

    To set multiple properties, separate their assignments with a comma.

    To use FPGA extensions, specify the custom LabVIEW FPGA bitfile to use with the bitfile specifier within the RFmxSetup string. For example, "RFmxSetup=bitfile:yourbitfile.lvbitx" specifies that RFmx use yourbitfile.lvbitx as the LabVIEW FPGA bitfile for the session.

    To use AnalysisOnly mode, specify the string as "AnalysisOnly=1;MaxNumWfms:<n>", where "n" represents the maximum number of waveforms that can be used for the MIMO measurement. While using this mode, you are responsible for waveform acquisition and RFmx will perform analysis on the I/Q waveform(s) or Spectrum(s) you specify. You must use personality specific Analyze functions to perform the measurements.

    To use external NI source measure units (SMU) as the noise source power supply for the noise figure (NF) measurement, use "NoiseSourcePowerSupply" as the specifier within the RFmxSetup string. For example, "RFmxSetup= NoiseSourcePowerSupply:myDCPower[0]" configures RFmx to use channel 0 on myDCPower SMU device for powering the noise source. You must allocate a dedicated SMU channel for RFmx.

    Note RFmx supports PXIe-4138, PXIe-4139, PXIe-4139 (40 W), and PXIe-4143 SMUs.
  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • igenclassrntag.png Instrument Handle Out —

    Instrument Handle Out passes a reference of the instrument session to the next VI.

  • ibool.png Created New? —

    Created New? is TRUE if the VI created a new session, or FALSE if the VI returned a reference to an existing session.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.