Antenna Commands

Although antenna characteristics are set by the respective standard body for most standard models, these commands allow you to customize antenna properties when using a MIMO configuration to better model the actual real world conditions.

Numerical Choices:

FSIMulator[1]|2 – These choices correspond to the Master Setups used in the selected configuration. Only multi-user MIMO uses more than one Master Setup.

RX:ANTenna[1]|2|3|4|5|6|7|8 Refer to the block diagram for your system configuration to determine the I/O output block that you want to configure. 

TX:ANTenna[1]|2|3|4 Refer to the block diagram for your system configuration to determine the I/O input block that you want to configure. 


 

[:SOURce]:FSIMulator[1]|2:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:ANTenna[1]|2|3|4|5|6|7|8:GAIN?

This query reports the gain of the specified antenna. It is especially useful for MIMO OTA test.

 

[:SOURce]:FSIMulator[1]|2:FADer[1]|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16:ANTenna[1]|2|3|4|5|6|7|8:GAIN:REFerence?

This query reports the reference gain of the specified antenna. It is especially useful for MIMO OTA test.

 

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:CLUSter:COUNt?

This query reports the total number of clusters in the current multiprobe configuration.

 

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:PROBe[1]|2|3|4|5|6|7|8:CLUSter[1]|x:WEIGht?

This query reports the power weight assigned to the specified probes in a multiprobe cluster. Multiprobe channel models are represented by one or more clusters. Depending on the probe settings and the channel model, different power weights are assigned to the probes per cluster.

The maximum number of clusters, x, depends on the configuration. Use the cluster count query (FSIMulator:OTA:MPRobe:CLUSter:COUNt?) to find this value.

 

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:CTYPe AUTO|CIRCle|CUSTom

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:CTYPe?

This command sets the probe positioning type.

AUTO

Sets the PXB to calculate optimal positions for the probes. Choosing it will cause Probe Polarization to be set to Single Polarization.

CIRCle

Only available when the PXB is in an 8 Rx antenna configuration. Sets the 8 probes to be positioned in a circle. Choosing it will cause Probe Polarization to be set to Single Polarization.

CUSTom

Allows the user to specify probe positions using the FSIMulator:OTA:MPRobe:PROBe:POSition command.

This command is only valid when the :FSIMulator:OTA:MPRobe:[:STATe] command is set to ON.

 

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:PROBe[1]|2|3|4|5|6|7|8:POSition <val>

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:PROBe[1]|2|3|4|5|6|7|8:POSition?

This command sets the positioning of the probe relative to a 0 reference position in the chamber. Depending on the Antenna Probe Constellation Type, these values may be query-only or user-definable. There are n position settings, one for each Rx antenna, or n/2 settings when Probe Polarization is set to Dual Polarization.

This command is only valid when the :FSIMulator:OTA:MPRobe:[:STATe] command is set to ON.

 

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:POLarization SINGle|DUAL

[:SOURce]:FSIMulator[1]|2:OTA:MPRobe:POLarization?

This command specifies whether the antenna probes are configured in a single or double cluster. When configured in a double cluster, each antenna position has 2 antenna probes.

This command is only valid when the :FSIMulator:OTA:MPRobe:[:STATe] command is set to ON.

 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:PFILe "<filename>"

 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:PFILe?

 

This command selects the user-provided antenna pattern file when :FSIMulator:RX:PATTern is set to USER.

See the Antenna Pattern File Format topic for details, or see the (default) example user antenna pattern file at: C:\<Program Files for Win XP><Program Files (x86) for Win 7>\Agilent\PXB\Infrstructure\Applications\Fading\antenna.txt.

 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:POLarization?

 

This query returns the angle of orientation with respect to the earth's surface and the direction of the waveform for the mobile station antenna.
 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:X <val>

 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:X?

 

This command sets the horizontal spacing of the antenna at the mobile station in terms of wavelength normalized by the carrier wavelength.

The variable <val> is expressed in wavelengths.

Range: ± 10 times the number of receive antennas * λ 

 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:Y <val>

 

[:SOURce]:FSIMulator[1]|2:RX:ANTenna[1]|2|3|4|5|6|7|8:Y?

 

This command sets the vertical spacing of the antenna at the mobile station in terms of wavelength normalized by the carrier frequency.

The variable <val> is expressed in wavelengths.

Range: ± 10 times the number of receive antennas * λ

 

[:SOURce]:FSIMulator[1]|2:RX:CONFig?

 

This query returns the geometrical configuration used for the receive antenna.

ULA

Default geometry for standard configurations

BFORming

Beamforming for WiMAX 4x2 or 2x4 configurations

USER

User defined antenna properties

 

[:SOURce]:FSIMulator[1]|2:RX:NANTennas?

 

This query returns the number of mobile antennas that are used in the configuration.

 

[:SOURce]:FSIMulator[1]|2:RX:PATTern OMN|THR|SIX|UNC|USER

 

[:SOURce]:FSIMulator[1]|2:RX:PATTern?

 

This command sets the radiation pattern to be used for the mobile station to base station antenna.

OMN

This choice selects an omni-directional antenna pattern.

THR

This choice selects a 3-sector antenna pattern.

SIX

This choice selects a 6-sector antenna pattern.

UNC This choice selects an uncorrelated antenna pattern to remove the influence of the antenna in the test system.
USER

This choice selects a user-specified antenna pattern. Use :FSIMulator:RX:ANTenna:PFILe to select the user antenna pattern file.

See also related commands: RANGle, RRANgle, SEANgle, and USPCenter.

 

[:SOURce]:FSIMulator[1]|2:RX:RANGle <val>

 

[:SOURce]:FSIMulator[1]|2:RX:RANGle?

 

This command sets the current position of the antenna array relative to the zero angle (boresight) established during the pattern measurement.

The variable <val> is expressed in degrees.

Range: 0 ≤ n ≤ 360

 

[:SOURce]:FSIMulator[1]|2:RX:RRANgle <val>

 

[:SOURce]:FSIMulator[1]|2:RX:RRANgle?

 

This command sets the rotation angle of the array to be used for power reference during power calibration (usually the angle of maximum gain).

The variable <val> is expressed in degrees.

Range: 0 ≤ n ≤ 360

 

[:SOURce]:FSIMulator[1]|2:RX:SEANgle <val>

 

[:SOURce]:FSIMulator[1]|2:RX:SEANgle?

 

This command sets the 2D projection onto the azimuth plane, of a slice through the origin of a 3D pattern, taken at this angle relative to the azimuth plane.

The variable <val> is expressed in degrees.

Range: 0 ≤ n ≤ 180

 

[:SOURce]:FSIMulator[1]|2:RX:USPCenter 1|0|On|Off

 

[:SOURce]:FSIMulator[1]|2:RX:USPCenter?

 

This command sets the user shared phase center to On if the antenna pattern shares the same phase center (reference point).; otherwise, it is Off.

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:PFILe "<filename>"

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:PFILe?

 

This command selects the user-provided antenna pattern file when :FSIMulator:TX:PATTern is set to USER.

See the Antenna Pattern File Format topic for details, or see the (default) example user antenna pattern file at: C:\<Program Files for Win XP><Program Files (x86) for Win 7>\Agilent\PXB\Infrstructure\Applications\Fading\antenna.txt.

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:POLarization?

 

This query returns the angle of orientation with respect to the earth's surface and the direction of the waveform from the base station antenna.

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:X <val>

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:X?

 

This command sets the horizontal spacing of the antenna at the base station in terms of wavelengths normalized by the carrier frequency.

The variable <val> is expressed in wavelengths.

Range: ± 10 times the number of antennas * λ 

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:Y <val>

 

[:SOURce]:FSIMulator[1]|2:TX:ANTenna[1]|2|3|4:Y?

 

This command sets the vertical spacing of the antenna at the base station in terms of wavelengths normalized by the carrier frequency.

The variable <val> is expressed in wavelengths.

Range: ± 10 times the number of antennas * λ 

 

[:SOURce]:FSIMulator[1]|2:TX:CONFig?

 

This query returns the geometrical configuration used for the base station antennas.

ULA

Default geometry for standard configurations

BFORming

Beamforming used in WiMAX 4x2 or 2x4 configurations only

USER

User defined antenna properties

 

[:SOURce]:FSIMulator[1]|2:TX:NANTennas?

 

This query returns the number of receiver antennas that are used in the configuration.

 

[:SOURce]:FSIMulator[1]|2:TX:PATTern OMN|THR|SIX|UNC|USER

 

[:SOURce]:FSIMulator[1]|2:TX:PATTern?

 

This command sets the radiation pattern to be used for the mobile station to base station antenna.

OMN

This choice selects an omni-directional antenna pattern.

THR

This choice selects a 3-sector antenna pattern.

SIX

This choice selects a 6-sector antenna pattern.

UNC This choice selects an uncorrelated antenna pattern to completely remove the influence of an antenna in the test system.
USER

This choice selects a user-specified antenna pattern. Use :FSIMulator:TX:ANTenna:PFILe to select the user antenna pattern file.

See also the related commands: RANGle, RRANgle, SEANgle, and USPCenter.

 

[:SOURce]:FSIMulator[1]|2:TX:RANGle <val>

 

[:SOURce]:FSIMulator[1]|2:TX:RANGle?

This command sets the current position of the antenna array relative to the zero angle (boresight) established during the pattern measurement.

 

The variable <val> is expressed in degrees.

 

Range: 0 ≤ n ≤ 360

 

Resolution: 0.01

 

[:SOURce]:FSIMulator[1]|2:TX:RRANgle <val>

 

[:SOURce]:FSIMulator[1]|2:TX:RRANgle?

This command sets the rotation angle of the array to be used for power reference during power calibration (usually the angle of maximum gain).

 

The variable <val> is expressed in degrees.

 

Range: 0 ≤ n ≤ 360

 

Resolution: 0.01

 

[:SOURce]:FSIMulator[1]|2:TX:SEANgle <val>

 

[:SOURce]:FSIMulator[1]|2:TX:SEANgle?

This command sets the 2D projection onto the azimuth plane, of a slice through the origin of a 3D pattern, taken at this angle relative to the azimuth plane.

 

The variable <val> is expressed in degrees.

 

Range: 0 ≤ n ≤ 180

 

Resolution: 0.01

[:SOURce]:FSIMulator[1]|2:TX:USPCenter 1|0|ON|OFF

 

[:SOURce]:FSIMulator[1]|2:TX:USPCenter?

This command sets the user shared phase center to On if the antenna pattern shares the same phase center (reference point); otherwise, it is Off.