RFmxInstrMX.SelectActiveExternalAttenuationTable Method
- Updated2024-07-17
- 2 minute(s) read
RFmx
Activates the external attenuation table set by the tableName parameter in the calibration plane specified by the selectorString parameter. On a MIMO session, this method selects the active external attenuation table for the specified MIMO port. The specified table will be used for amplitude correction during measurement.
supporteddevices: PXIe-5663/5663E, PXIe-5665, PXIe-5668, PXIe-5644/5645/5646, PXIe-5830/5831/5832/5840/5841/5842/5860
supporteddevices: PXIe-5663/5663E, PXIe-5665, PXIe-5668, PXIe-5644/5645/5646, PXIe-5830/5831/5832/5840/5841/5842/5860
Namespace: NationalInstruments.RFmx.InstrMX
Assembly: NationalInstruments.RFmx.InstrMX.Fx40 (in NationalInstruments.RFmx.InstrMX.Fx40.dll) Version: 24.5.0.49285 (24.5.0.49285)
Syntax
public int SelectActiveExternalAttenuationTable( string selectorString, string tableName )
Public Function SelectActiveExternalAttenuationTable ( selectorString As String, tableName As String ) As Integer
Parameters
- selectorString String
-
Specifies the calibration plane name in which either the S-parameter table or 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.
On a MIMO session, the default "" (empty string) selects the active external attenuation table for all the MIMO Ports. To configure external attenuation type 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 is "calplane::<calplaneName>/port::<portName>". For a MIMO port, the valid selector string is "calplane::<calplaneName>/port::<deviceName>/<channelNumber>/<portName>". If you specify "port::all", all ports are considered configured. Use RFmxInstrMX.GetAvailablePorts method 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"
- tableName String
- 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.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.