RFmx Instruments VIs

Table of Contents

RFmxInstr Configure External Attenuation Table (VI)

  • Updated2024-04-10
  • 3 minute(s) read

RFmxInstr Configure External Attenuation Table (VI)

Owning Palette: External Attenuation Table

Stores the external attenuation table in the calibration plane specified by the Selector String parameter. On a MIMO session, the external attenuation table is stored for each MIMO port in the specified calibration plane.

If there is only one table configured in any calibration plane, it is automatically selected as the active table.

Supported devices: PXIe-5663/5663E, PXIe-5665, PXIe-5668, PXIe-5644/5645/5646, PXIe-5830/5831/5832/5840/5841/5842

RFmxInstr Configure External Attenuation Table

cio.gif

Instrument Handle In identifies the instrument session. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI or the RFmxInstr Initialize NIRFSA (Array) VI.

cstr.gif

Table Name specifies the name to be associated with external attenuation table within a calibration plane. Provide a unique name, such as "table1" to configure the table. The default value is "" (empty string).

Example:

""

"table1"

c1ddbl.gif

Frequency specifies an array of frequencies in the external attenuation table. This value is expressed in Hz.

c1ddbl.gif

External Attenuation specifies an array of attenuations corresponding to the frequency specified by the Frequency parameter. This value is expressed in dB.

cstr.gif

Selector String specifies the calibration plane name in which the external attenuation table is stored. This input accepts the calibration plane name with the "calplane::" prefix. If you do not specify the calibration plane name, the default calibration plane instance is used. The default value is "" (empty string).

On a MIMO session if you do not specify the port name, this configuration is applied to all MIMO ports in the session for the default calibration plane instance. To configure external attenuation table for a specific MIMO port, use the port specifier with or without the calplane name. Example: "calplane::plane1/port::myrfsa1/0".

Note   For PXIe-5830/5831/5832 devices, port names should also be specified along with Calplane names. Hence, the valid selector string is "calplane::<calplaneName>/port::<portName>". If you specify "port::all", all ports are considered configured. For a MIMO port, the valid selector string is "calplane::<calplaneName>/port::<deviceName>/<channelNumber>/<portName>". If you specify "port::all", all MIMO ports are considered configured. Use RFmxInstr Get Available Ports VI to get the valid port names.

Example:

""

"calplane::plane0"

"calplane::plane0/port::if0"

"port::if0"

"calplane::plane0/port::all"

"calplane::plane0/port::myrfsa1/0"

"calplane::plane0/port::myrfsa1/0, port::myrfsa2/0"

"calplane::plane0/port::myrfsa1/0/if0"

cerrcodeclst.gif

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

iio.gif

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

ierrcodeclst.gif

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

Log in to get a better experience