Beamforming

SCPI Commands :

CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:MODE
CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:NOLayers
CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:MATRix
class BeamformingCls[source]

Beamforming commands group definition. 3 total commands, 0 Subgroups, 3 group commands

class MatrixStruct[source]

Structure for setting input parameters. Contains optional set arguments. Fields:

  • B_11_Phi: int: numeric Range: 0 deg to 345 deg, Unit: deg

  • B_12_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

  • B_11_Abs: float: Optional setting parameter. numeric Range: 0 to 1

  • B_12_Abs: float: Optional setting parameter. numeric Range: 0 to 1

  • B_21_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

  • B_22_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

  • B_13_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

  • B_14_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

  • B_13_Abs: float: Optional setting parameter. numeric Range: 0 to 1

  • B_14_Abs: float: Optional setting parameter. numeric Range: 0 to 1

  • B_23_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

  • B_24_Phi: int: Optional setting parameter. numeric Range: 0 deg to 345 deg, Unit: deg

get_matrix() → MatrixStruct[source]
# SCPI: CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:MATRix
value: MatrixStruct = driver.configure.connection.pcc.beamforming.get_matrix()
Configures the beamforming matrix coefficients for TM 7 and TM 8.

INTRO_CMD_HELP: There are two types of parameters:

  • <bnmabs> defines the square of the magnitude of the coefficient nm: <bnmabs> = (bnm) 2

  • <bnmphi> defines the phase of the coefficient nm: <bnmphi> = φ(bnm) The phase can be entered in steps of 15 degrees. The setting is rounded, if necessary.

INTRO_CMD_HELP: Depending on the size of your matrix, use the following parameters:

  • 1x1: <b11phi>

  • 1x2: <b11phi>, <b12phi>

  • 2x2: <b11phi>, <b12phi>, <b11abs>, <b12abs>, <b21phi>, <b22phi>

The last six parameters are for future use and can always be omitted.

return:

structure: for return value, see the help for MatrixStruct structure arguments.

get_mode() → BeamformingMode[source]
# SCPI: CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:MODE
value: enums.BeamformingMode = driver.configure.connection.pcc.beamforming.get_mode()
Selects the beamforming mode for TM 7 and 8.

INTRO_CMD_HELP: Depending on other settings, only a subset of the values is allowed, see:

  • TM 7: ‘Beamforming Mode’

  • TM 8: ‘Beamforming Mode’

return:

mode: OFF | ON | TSBF | PMAT OFF: Beamforming is disabled ON: Beamforming is enabled. The configured beamforming matrix is used. TSBF: Beamforming is enabled. The beamforming matrix is selected randomly as defined in 3GPP TS 36.521, annex B.4.1 and B.4.2. PMAT: Beamforming is enabled. A precoding matrix is used as beamforming matrix, see method RsCmwLteSig.Configure.Connection.Pcc.pmatrix.

get_no_layers() → BeamformingNoOfLayers[source]
# SCPI: CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:NOLayers
value: enums.BeamformingNoOfLayers = driver.configure.connection.pcc.beamforming.get_no_layers()

Selects the number of layers for transmission mode 8.

return:

number: L1 | L2 L1: single-layer beamforming L2: dual-layer beamforming

set_matrix(value: MatrixStruct) → None[source]
# SCPI: CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:MATRix
structure = driver.configure.connection.pcc.beamforming.MatrixStruct()
structure.B_11_Phi: int = 1
structure.B_12_Phi: int = 1
structure.B_11_Abs: float = 1.0
structure.B_12_Abs: float = 1.0
structure.B_21_Phi: int = 1
structure.B_22_Phi: int = 1
structure.B_13_Phi: int = 1
structure.B_14_Phi: int = 1
structure.B_13_Abs: float = 1.0
structure.B_14_Abs: float = 1.0
structure.B_23_Phi: int = 1
structure.B_24_Phi: int = 1
driver.configure.connection.pcc.beamforming.set_matrix(value = structure)
Configures the beamforming matrix coefficients for TM 7 and TM 8.

INTRO_CMD_HELP: There are two types of parameters:

  • <bnmabs> defines the square of the magnitude of the coefficient nm: <bnmabs> = (bnm) 2

  • <bnmphi> defines the phase of the coefficient nm: <bnmphi> = φ(bnm) The phase can be entered in steps of 15 degrees. The setting is rounded, if necessary.

INTRO_CMD_HELP: Depending on the size of your matrix, use the following parameters:

  • 1x1: <b11phi>

  • 1x2: <b11phi>, <b12phi>

  • 2x2: <b11phi>, <b12phi>, <b11abs>, <b12abs>, <b21phi>, <b22phi>

The last six parameters are for future use and can always be omitted.

param value:

see the help for MatrixStruct structure arguments.

set_mode(mode: BeamformingMode) → None[source]
# SCPI: CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:MODE
driver.configure.connection.pcc.beamforming.set_mode(mode = enums.BeamformingMode.OFF)
Selects the beamforming mode for TM 7 and 8.

INTRO_CMD_HELP: Depending on other settings, only a subset of the values is allowed, see:

  • TM 7: ‘Beamforming Mode’

  • TM 8: ‘Beamforming Mode’

param mode:

OFF | ON | TSBF | PMAT OFF: Beamforming is disabled ON: Beamforming is enabled. The configured beamforming matrix is used. TSBF: Beamforming is enabled. The beamforming matrix is selected randomly as defined in 3GPP TS 36.521, annex B.4.1 and B.4.2. PMAT: Beamforming is enabled. A precoding matrix is used as beamforming matrix, see method RsCmwLteSig.Configure.Connection.Pcc.pmatrix.

set_no_layers(number: BeamformingNoOfLayers) → None[source]
# SCPI: CONFigure:LTE:SIGNaling<instance>:CONNection[:PCC]:BEAMforming:NOLayers
driver.configure.connection.pcc.beamforming.set_no_layers(number = enums.BeamformingNoOfLayers.L1)

Selects the number of layers for transmission mode 8.

param number:

L1 | L2 L1: single-layer beamforming L2: dual-layer beamforming