Prach

SCPI Commands :

CONFigure:LTE:MEASurement<Instance>:PRACh:TOUT
CONFigure:LTE:MEASurement<Instance>:PRACh:REPetition
CONFigure:LTE:MEASurement<Instance>:PRACh:SCONdition
CONFigure:LTE:MEASurement<Instance>:PRACh:MOEXception
CONFigure:LTE:MEASurement<Instance>:PRACh:PCINdex
CONFigure:LTE:MEASurement<Instance>:PRACh:SSYMbol
CONFigure:LTE:MEASurement<Instance>:PRACh:NOPReambles
CONFigure:LTE:MEASurement<Instance>:PRACh:POPReambles
class PrachCls[source]

Prach commands group definition. 34 total commands, 6 Subgroups, 8 group commands

get_mo_exception() bool[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:MOEXception
value: bool = driver.configure.prach.get_mo_exception()

Specifies whether measurement results that the R&S CMW identifies as faulty or inaccurate are rejected.

return:

meas_on_exception: OFF | ON OFF: Faulty results are rejected. ON: Results are never rejected.

get_no_preambles() int[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:NOPReambles
value: int = driver.configure.prach.get_no_preambles()

Specifies the number of preambles to be captured per measurement interval.

return:

number_preamble: numeric Range: 1 to 400

get_pc_index() int[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:PCINdex
value: int = driver.configure.prach.get_pc_index()

The PRACH configuration index identifies the PRACH configuration used by the UE (preamble format, which resources in the time domain are allowed for transmission of preambles etc.) .

INTRO_CMD_HELP: For the combined signal path scenario, use:

  • CONFigure:LTE:SIGN<i>:CELL:PRACh:PCINdex:FDD

  • CONFigure:LTE:SIGN<i>:CELL:PRACh:PCINdex:TDD

return:

prach_conf_index: numeric Range: 0 to 63 for FDD / 57 for TDD

get_po_preambles() PeriodPreamble[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:POPReambles
value: enums.PeriodPreamble = driver.configure.prach.get_po_preambles()

Specifies the periodicity of preambles to be captured for multi-preamble result views.

return:

period_preamble: MS05 | MS10 | MS20 MS05: 5 ms MS10: 10 ms MS20: 20 ms

get_repetition() Repeat[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:REPetition
value: enums.Repeat = driver.configure.prach.get_repetition()

Specifies the repetition mode of the measurement. The repetition mode specifies whether the measurement is stopped after a single shot or repeated continuously. Use CONFigure:..:MEAS<i>:…:SCOunt to determine the number of measurement intervals per single shot.

return:

repetition: SINGleshot | CONTinuous SINGleshot: Single-shot measurement CONTinuous: Continuous measurement

get_scondition() StopCondition[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:SCONdition
value: enums.StopCondition = driver.configure.prach.get_scondition()

Qualifies whether the measurement is stopped after a failed limit check or continued. SLFail means that the measurement is stopped and reaches the RDY state when one of the results exceeds the limits.

return:

stop_condition: NONE | SLFail NONE: Continue measurement irrespective of the limit check. SLFail: Stop measurement on limit failure.

get_ssymbol() int[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:SSYMbol
value: int = driver.configure.prach.get_ssymbol()

Selects the OFDM symbol to be evaluated for single-symbol modulation result diagrams. The number of OFDM symbols in the preamble (<no of symbols>) depends on the preamble format, see Table ‘Preambles in the time domain’.

return:

selected_symbol: numeric Range: 0 to no of symbols -1

get_timeout() float[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:TOUT
value: float = driver.configure.prach.get_timeout()

Defines a timeout for the measurement. The timer is started when the measurement is initiated via a READ or INIT command. It is not started if the measurement is initiated manually. When the measurement has completed the first measurement cycle (first single shot) , the statistical depth is reached and the timer is reset. If the first measurement cycle has not been completed when the timer expires, the measurement is stopped. The measurement state changes to RDY. The reliability indicator is set to 1, indicating that a measurement timeout occurred. Still running READ, FETCh or CALCulate commands are completed, returning the available results. At least for some results, there are no values at all or the statistical depth has not been reached. A timeout of 0 s corresponds to an infinite measurement timeout.

return:

timeout: numeric Unit: s

set_mo_exception(meas_on_exception: bool) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:MOEXception
driver.configure.prach.set_mo_exception(meas_on_exception = False)

Specifies whether measurement results that the R&S CMW identifies as faulty or inaccurate are rejected.

param meas_on_exception:

OFF | ON OFF: Faulty results are rejected. ON: Results are never rejected.

set_no_preambles(number_preamble: int) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:NOPReambles
driver.configure.prach.set_no_preambles(number_preamble = 1)

Specifies the number of preambles to be captured per measurement interval.

param number_preamble:

numeric Range: 1 to 400

set_pc_index(prach_conf_index: int) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:PCINdex
driver.configure.prach.set_pc_index(prach_conf_index = 1)

The PRACH configuration index identifies the PRACH configuration used by the UE (preamble format, which resources in the time domain are allowed for transmission of preambles etc.) .

INTRO_CMD_HELP: For the combined signal path scenario, use:

  • CONFigure:LTE:SIGN<i>:CELL:PRACh:PCINdex:FDD

  • CONFigure:LTE:SIGN<i>:CELL:PRACh:PCINdex:TDD

param prach_conf_index:

numeric Range: 0 to 63 for FDD / 57 for TDD

set_po_preambles(period_preamble: PeriodPreamble) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:POPReambles
driver.configure.prach.set_po_preambles(period_preamble = enums.PeriodPreamble.MS05)

Specifies the periodicity of preambles to be captured for multi-preamble result views.

param period_preamble:

MS05 | MS10 | MS20 MS05: 5 ms MS10: 10 ms MS20: 20 ms

set_repetition(repetition: Repeat) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:REPetition
driver.configure.prach.set_repetition(repetition = enums.Repeat.CONTinuous)

Specifies the repetition mode of the measurement. The repetition mode specifies whether the measurement is stopped after a single shot or repeated continuously. Use CONFigure:..:MEAS<i>:…:SCOunt to determine the number of measurement intervals per single shot.

param repetition:

SINGleshot | CONTinuous SINGleshot: Single-shot measurement CONTinuous: Continuous measurement

set_scondition(stop_condition: StopCondition) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:SCONdition
driver.configure.prach.set_scondition(stop_condition = enums.StopCondition.NONE)

Qualifies whether the measurement is stopped after a failed limit check or continued. SLFail means that the measurement is stopped and reaches the RDY state when one of the results exceeds the limits.

param stop_condition:

NONE | SLFail NONE: Continue measurement irrespective of the limit check. SLFail: Stop measurement on limit failure.

set_ssymbol(selected_symbol: int) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:SSYMbol
driver.configure.prach.set_ssymbol(selected_symbol = 1)

Selects the OFDM symbol to be evaluated for single-symbol modulation result diagrams. The number of OFDM symbols in the preamble (<no of symbols>) depends on the preamble format, see Table ‘Preambles in the time domain’.

param selected_symbol:

numeric Range: 0 to no of symbols -1

set_timeout(timeout: float) None[source]
# SCPI: CONFigure:LTE:MEASurement<Instance>:PRACh:TOUT
driver.configure.prach.set_timeout(timeout = 1.0)

Defines a timeout for the measurement. The timer is started when the measurement is initiated via a READ or INIT command. It is not started if the measurement is initiated manually. When the measurement has completed the first measurement cycle (first single shot) , the statistical depth is reached and the timer is reset. If the first measurement cycle has not been completed when the timer expires, the measurement is stopped. The measurement state changes to RDY. The reliability indicator is set to 1, indicating that a measurement timeout occurred. Still running READ, FETCh or CALCulate commands are completed, returning the available results. At least for some results, there are no values at all or the statistical depth has not been reached. A timeout of 0 s corresponds to an infinite measurement timeout.

param timeout:

numeric Unit: s

Cloning the Group

# Create a clone of the original group, that exists independently
group2 = driver.configure.prach.clone()

Subgroups