Bler

SCPI Commands :

BLER:LOAD
BLER:PRESet
BLER:RESult
BLER:STARt
BLER:STATe
BLER:STOP
BLER:STORe
BLER:UNIT
class BlerCls[source]

Bler commands group definition. 18 total commands, 2 Subgroups, 8 group commands

class ResultStruct[source]

Structure for reading output parameters. Fields:

  • Num_Block: int: integer Number of checked data bits.

  • Num_Errors: int: integer Number of error bits.

  • Error_Rate: float: float If no termination criterion has been reached since the beginning of the measurement, display the current quotient of NumErrors (number of error bits) and NumBlock (number of data bits) . When at least one final result has been reached in continuous measurement, display the most recent final result.

  • Meas_Finished: int: integer Status of measurement. 1 Measurement has been terminated, i.e. stopped or the defined number of data bits or error bits has been reached. 0 Measurement has not been terminated.

  • Clock_Detected: int: integer Status of clock line. 1 Clock line active. 0 Clock line not active.

  • Data_Detected: int: integer Status of data line. 1 Data line active. Only clocked data is detected. If the clock signal is missing, a data change is also not detected. 0 Data line is not active.

  • Synchronized: int: integer 1 The measurement is synchronized and the ratio is assumed realistic. That is, the clock and data lines are active and the following apples: NumErrors/NumBlock 0.1. 0 The measurement is not synchronized.

get_result() → ResultStruct[source]
# SCPI: BLER:RESult
value: ResultStruct = driver.bler.get_result()

Queries the result of the last BLER measurement and responds with seven results, separated by commas. The first measurement following the start also queries intermediate results for the number of data bits, error bits and error rate. For method RsSmbv.Bler.Trigger.modeAUTO, only the final results of each single measurement are queried in the following measurements. Note: The restart of a new measurement is delayed until the first measurement result has been queried. The resulting brief measurement interruption is irrelevant because the subsequent measurement is synchronized within 24 data bits.

return

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

get_state() → bool[source]
# SCPI: BLER:STATe
value: bool = driver.bler.get_state()

Activates/deactivates the measurement.

return

state: 1| ON| 0| OFF

get_unit() → RsSmbv.enums.BertUnit[source]
# SCPI: BLER:UNIT
value: enums.BertUnit = driver.bler.get_unit()

No command help available

return

unit: No help available

load(filename: str) → None[source]
# SCPI: BLER:LOAD
driver.bler.load(filename = 'abc')

Loads the selected file from the default or the specified directory. Loaded are files with extension *.ber_bler Refer to ‘Accessing Files in the Default or Specified Directory’ for general information on file handling in the default and in a specific directory.

param filename

string Filename or complete file path; file extension can be omitted

preset() → None[source]
# SCPI: BLER:PRESet
driver.bler.preset()

Sets the parameters of the BERT/BLER test generator to their default values (*RST values specified for the commands) . Not affected is the state set with the command .method RsSmbv.Bert.state/method RsSmbv.Bler.state.

preset_with_opc(opc_timeout_ms: int = - 1) → None[source]
# SCPI: BLER:PRESet
driver.bler.preset_with_opc()

Sets the parameters of the BERT/BLER test generator to their default values (*RST values specified for the commands) . Not affected is the state set with the command .method RsSmbv.Bert.state/method RsSmbv.Bler.state.

Same as preset, but waits for the operation to complete before continuing further. Use the RsSmbv.utilities.opc_timeout_set() to set the timeout value.

param opc_timeout_ms

Maximum time to wait in milliseconds, valid only for this call.

set_state(state: bool) → None[source]
# SCPI: BLER:STATe
driver.bler.set_state(state = False)

Activates/deactivates the measurement.

param state

1| ON| 0| OFF

set_store(filename: str) → None[source]
# SCPI: BLER:STORe
driver.bler.set_store(filename = 'abc')

Saves the current settings into the selected file; the file extension (*.ber_bler) is assigned automatically. Refer to ‘Accessing Files in the Default or Specified Directory’ for general information on file handling in the default and in a specific directory.

param filename

‘filename’ Filename or complete file path.

set_unit(unit: RsSmbv.enums.BertUnit) → None[source]
# SCPI: BLER:UNIT
driver.bler.set_unit(unit = enums.BertUnit.ENGineering)

No command help available

param unit

No help available

start() → None[source]
# SCPI: BLER:STARt
driver.bler.start()

Starts a continuous measurement.

start_with_opc(opc_timeout_ms: int = - 1) → None[source]
# SCPI: BLER:STARt
driver.bler.start_with_opc()

Starts a continuous measurement.

Same as start, but waits for the operation to complete before continuing further. Use the RsSmbv.utilities.opc_timeout_set() to set the timeout value.

param opc_timeout_ms

Maximum time to wait in milliseconds, valid only for this call.

stop() → None[source]
# SCPI: BLER:STOP
driver.bler.stop()

Stops an ongoing measurement.

stop_with_opc(opc_timeout_ms: int = - 1) → None[source]
# SCPI: BLER:STOP
driver.bler.stop_with_opc()

Stops an ongoing measurement.

Same as stop, but waits for the operation to complete before continuing further. Use the RsSmbv.utilities.opc_timeout_set() to set the timeout value.

param opc_timeout_ms

Maximum time to wait in milliseconds, valid only for this call.

Cloning the Group

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

Subgroups