ModAccResults

Provides methods to fetch and read the ModAcc measurement results.

class nirfmxbluetooth.modacc_results.ModAccResults(signal_obj)

Bases: object

Provides methods to fetch and read the ModAcc measurement results.

fetch_constellation_trace(selector_string, timeout, constellation)

Fetches the demodulated symbols from the enhanced data rate (EDR) portion of the EDR packet. This method is valid only for EDR packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• constellation (numpy.complex64) – This parameter returns the array of demodulated symbols from over the EDR portion of the EDR packet.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

fetch_cs_detrended_phase_trace(selector_string, timeout, cs_detrended_phase)

Fetches the zero-mean Detrended Phase (deg) versus time trace. This method is valid only for low energy CS (LE-CS) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• cs_detrended_phase (numpy.float32) – This parameter returns the array of phase values computed for each samples within CS Tone. This value is expressed in degrees.

Returns:

x0 (float):

This parameter returns the start time. The value is expressed in seconds.

dx (float):

This parameter returns the sample duration. The value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_cs_tone_trace(selector_string, timeout, cs_tone_amplitude, cs_tone_phase)

Fetches the CS Tone Amplitude (dBm) versus time and CS Tone Phase (deg) versus time traces. This method is valid only for low energy CS (LE-CS) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• cs_tone_amplitude (numpy.float32) – This parameter returns the array of amplitude values computed for each samples within CS Tone. The values are expressed in dBm.

• cs_tone_phase (numpy.float32) – This parameter returns the array of amplitude values computed for each samples within CS Tone. The values are expressed in dBm.

Returns:

x0 (float):

This parameter returns the start time. The value is expressed in seconds.

dx (float):

This parameter returns the sample duration. The value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_demodulated_bit_trace(selector_string, timeout)

Fetches the ModAcc demodulated bit trace.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

demodulated_bits (int):

This parameter returns an array of demodulated bits of the packet.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (demodulated_bits, error_code)

fetch_devm(selector_string, timeout)

Fetches ModAcc differential EVM (DEVM) measurement results. These results are valid only for enhanced data rate (EDR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

peak_rms_devm_maximum (float):

This parameter returns the peak of the RMS DEVM values computed on each 50us block of the EDR portion of the EDR packet. When you set AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS DEVM values computed for each averaging count. This value is expressed in percentage.

peak_devm_maximum (float):

This parameter returns the peak of the DEVM values computed on symbols in the EDR portion of the EDR packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the maximum of the peak symbol DEVM values computed for each averaging count. This value is expressed in percentage.

ninetynine_percent_devm (float):

This parameter returns the 99th percentile of the DEVM values computed on symbols of the EDR portion of all measured EDR packets. This value is expressed in percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (peak_rms_devm_maximum, peak_devm_maximum, ninetynine_percent_devm, error_code)

fetch_devm_magnitude_error(selector_string, timeout)

Fetches ModAcc RMS magnitude error results. These results are valid only for enhanced data rate (EDR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

average_rms_magnitude_error_mean (float):

This parameter returns the average of the RMS magnitude error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the average RMS magnitude error values computed for each averaging count. This value is expressed as a percentage.

peak_rms_magnitude_error_maximum (float):

This parameter returns the peak of the RMS magnitude error values computed on each 50 us block of EDR portion of the EDR packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the maximum of the peak RMS magnitude error values computed for each averaging count. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (average_rms_magnitude_error_mean, peak_rms_magnitude_error_maximum, error_code)

fetch_devm_per_symbol_trace(selector_string, timeout)

Fetches the DEVM values for symbols from the enhanced data rate (EDR) portion of the EDR packet. This method is valid only for EDR packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

devm_per_symbol (float):

This parameter returns the array of DEVM values computed over the symbols in the EDR portion of EDR packet. This value is expressed in percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (devm_per_symbol, error_code)

fetch_devm_phase_error(selector_string, timeout)

Fetches ModAcc RMS phase error results. These results are valid only for enhanced data rate (EDR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

average_rms_phase_error_mean (float):

This parameter returns the average of the RMS phase error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the average RMS phase error values computed for each averaging count. This value is expressed in degrees.

peak_rms_phase_error_maximum (float):

This parameter returns the peak of the RMS phase error values computed on each 50 us block of EDR portion of the EDR packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the maximum of the peak RMS phase error values computed for each averaging count. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (average_rms_phase_error_mean, peak_rms_phase_error_maximum, error_code)

fetch_df1(selector_string, timeout)

Fetches the ModAcc df1 measurement results. These results are valid only for basic rate (BR) and low energy (LE) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

df1avg_maximum (float):

This parameter returns the df1avg value computed on the signal. This value is expressed in Hz. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the df1avg results computed for each averaging count.

df1avg_minimum (float):

This parameter returns the df1avg value computed on the signal. This value is expressed in Hz. When you set the ModAcc Averaging Enabled attribute to True, it returns the minimum of the df1avg results computed for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (df1avg_maximum, df1avg_minimum, error_code)

fetch_df1max_trace(selector_string, timeout)

Fetches the df1max versus the time trace. This method is applicable only for basic rate (BR) and low energy (LE) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

time (float):

This parameter returns the array of time instances at which the df1max values are computed. This value is expressed in seconds.

df1max (float):

This parameter returns the array of df1max values computed over the packet at each time instance. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (time, df1max, error_code)

fetch_df2(selector_string, timeout)

Fetches the ModAcc df2 measurement results. These results are valid only for basic rate (BR) and low energy (LE) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

df2avg_minimum (float):

This parameter returns the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the df2avg results computed for each averaging count. This value is expressed in Hz.

percentage_of_symbols_above_df2max_threshold (float):

This parameter returns the percentage of symbols with df2max values that are greater than the df2max threshold defined by the standard. When you set the ModAcc Averaging Enabled attribute to True, it computes this result using the df2max values from all averaging counts. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (df2avg_minimum, percentage_of_symbols_above_df2max_threshold, error_code)

fetch_df2max_trace(selector_string, timeout)

Fetches the df2max versus the time trace. This method is valid only for basic rate (BR) and low energy (LE) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

time (float):

This parameter returns the array of time instances at which the df2max values are computed. This value is expressed in seconds.

df2max (float):

This parameter returns the array of df2max values computed over the packet at each time instance. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (time, df2max, error_code)

fetch_df4avg_trace(selector_string, timeout)

Fetches the df4avg versus the time trace. This method is valid only for LE-CS Packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

time (float):

This parameter returns the array of time instances at which the df4avg values are computed. This value is expressed in seconds.

df4avg (float):

This parameterreturns the array of df4avg values computed over the packet at each time instance. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (time, df4avg, error_code)

fetch_evm_per_symbol_trace(selector_string, timeout)

Fetches the EVM values for symbols from the payload portion including the payload header of the LE-HDT packet. This method is valid only for LE-HDT packet.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

evm_per_symbol (float):

This parameter returns the EVM values for symbols from the payload portion including the payload header of the LE-HDT packet. The values are expressed in dB.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (evm_per_symbol, error_code)

fetch_frequency_error_br(selector_string, timeout)

Fetches the ModAcc frequency error trace for basic rate (BR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

initial_frequency_error_maximum (float):

This parameter returns the initial frequency error value computed on the preamble of the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of absolute initial frequency error values computed for each averaging count. This value is expressed in Hz.

peak_frequency_drift_maximum (float):

This parameter returns the peak frequency drift value computed on the BR packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute peak frequency drift values computed for each averaging count. This value is expressed in Hz.

peak_frequency_drift_rate_maximum (float):

This parameter returns the peak frequency drift rate value computed on the BR packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute peak frequency drift rate values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (initial_frequency_error_maximum, peak_frequency_drift_maximum, peak_frequency_drift_rate_maximum, error_code)

fetch_frequency_error_edr(selector_string, timeout)

Fetches ModAcc frequency error measurement results for enhanced data rate (EDR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

header_frequency_error_wi_maximum (float):

This parameter returns the frequency error value computed on the header of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of absolute header frequency error values computed for each averaging count. This value is expressed in Hz.

peak_frequency_error_wi_plus_w0_maximum (float):

This parameter returns the peak frequency error value computed on the EDR portion of the EDR packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute peak frequency error values computed for each averaging count. This value is expressed in Hz.

peak_frequency_error_w0_maximum (float):

This parameter returns the peak frequency error value computed on the EDR portion of the EDR packet, relative to the header frequency error. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute peak frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (header_frequency_error_wi_maximum, peak_frequency_error_wi_plus_w0_maximum, peak_frequency_error_w0_maximum, error_code)

fetch_frequency_error_le(selector_string, timeout)

Fetches ModAcc frequency error measurement results for low energy (LE) or low energy - channel sounding (LE-CS) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

peak_frequency_error_maximum (float):

This parameter when you set the DIRECTION_FINDING_MODE attribute to Disabled, it returns the peak frequency error value computed on the preamble and payload portion of the LE packet. When you set the Direction Finding Mode attribute to Angle of Arrival, it returns the peak frequency error value computed on the Constant tone extension field of the LE packet. When you set the AVERAGING_ENABLED attribute to True, , it returns the value corresponding to the maximum of absolute peak frequency error values computed for each averaging count. This value is expressed in Hz.

initial_frequency_drift_maximum (float):

This parameter returns the initial frequency drift value computed on the LE packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute initial frequency drift values computed for each averaging count. This value is expressed in Hz.

peak_frequency_drift_maximum (float):

This parameter returns the peak frequency drift value computed on the LE packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute peak frequency drift values computed for each averaging count. This value is expressed in Hz.

peak_frequency_drift_rate_maximum (float):

This parameter returns the peak frequency drift rate value computed on the LE packet. When you set the ModAcc Averaging Enabled attribute to True, it returns the value corresponding to the maximum of absolute peak frequency drift rate values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (peak_frequency_error_maximum, initial_frequency_drift_maximum, peak_frequency_drift_maximum, peak_frequency_drift_rate_maximum, error_code)

fetch_frequency_error_trace_br(selector_string, timeout)

Fetches the ModAcc frequency error trace for basic rate (BR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

time (float):

This parameter returns an array of time instances corresponding to the start of the bit blocks at which the frequency error values are computed. This value is expressed in seconds.

frequency_error (float):

This parameter returns an array of frequency errors computed over the packet. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (time, frequency_error, error_code)

fetch_frequency_error_trace_le(selector_string, timeout)

Fetches the ModAcc frequency error trace for low energy (LE) or low energy - channel sounding (LE-CS) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

time (float):

This parameter returns an array of time instances corresponding to the start of the bit blocks at which the frequency error values are computed. This value is expressed in seconds.

frequency_error (float):

This parameter returns the array of frequency errors computed over the packet. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (time, frequency_error, error_code)

fetch_frequency_error_wi_plus_w0_trace_edr(selector_string, timeout)

Fetches the ModAcc frequency error trace for enhanced data rate (EDR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

time (float):

This parameter returns an array of time instances corresponding to the start of the 50us blocks of the EDR portion of EDR packet at which the frequency error values are computed. This value is expressed in seconds.

frequency_error_wi_plus_w0 (float):

This parameter returns the array of frequency errors wi+w0 computed over the packet. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (time, frequency_error_wi_plus_w0, error_code)

fetch_frequency_trace(selector_string, timeout, frequency)

Fetches the frequency versus time trace. This trace is valid for basic rate (BR), low energy (LE) and low energy - channel sounding (LE-CS) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

• frequency (numpy.float32) – This parameter returns the frequency at each time instance. This value is expressed in Hz.

Returns:

x0 (float):

This parameter returns the start time. This value is expressed in seconds.

dx (float):

This parameter returns the sample duration. This value is expressed in seconds.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (x0, dx, error_code)

fetch_rms_devm_trace(selector_string, timeout)

Fetches the RMS DEVM values from each 50us block of EDR portion of EDR packet. This method is valid only for enhanced data rate (EDR) packets.

Parameters:

• selector_string (string) –

  This parameter specifies a Selector String comprising of the result name.

  Example:

  ”result::r1”

  You can use the build_result_string() method to build the selector string.

• timeout (float) – This parameter specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the method waits until the measurement is complete. The default value is 10.

Returns:

rms_devm (float):

This parameter returns the array of RMS DEVM values computed on each 50us block of the EDR portion of the EDR packet. This value is expressed in percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (rms_devm, error_code)

get_99_percent_devm(selector_string)

Gets the 99th percentile of the differential EVM (DEVM) values computed on symbols of the EDR portion of all measured EDR packets. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the 99th percentile of the differential EVM (DEVM) values computed on symbols of the EDR portion of all measured EDR packets. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_average_rms_magnitude_error_mean(selector_string)

Gets the average of the RMS magnitude error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the average RMS magnitude error values computed for each averaging count. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the average of the RMS magnitude error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the average RMS magnitude error values computed for each averaging count. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_average_rms_phase_error_mean(selector_string)

Return the average of the RMS phase error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the average RMS phase error values computed for each averaging count. This value is expressed in degrees.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Return the average of the RMS phase error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the average RMS phase error values computed for each averaging count. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_br_initial_frequency_error_maximum(selector_string)

Gets the initial frequency error value computed on the preamble portion of the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute initial frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the initial frequency error value computed on the preamble portion of the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute initial frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_br_peak_frequency_drift_maximum(selector_string)

Gets the peak frequency drift value computed on the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak frequency drift value computed on the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_br_peak_frequency_drift_rate_maximum(selector_string)

Gets the peak frequency drift rate value computed on the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift rate values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak frequency drift rate value computed on the BR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift rate values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_clock_drift_mean(selector_string)

Gets the clock drift estimated over the LE-CS packet. This value is expressed in ppm. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the clock drift values computed for each averaging count.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the clock drift estimated over the LE-CS packet. This value is expressed in ppm. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the clock drift values computed for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_control_header_rms_evm_mean(selector_string)

Gets the RMS EVM value computed on the control header portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS EVM values computed for each averaging count. This value is expressed in dB. This result is valid only for LE-HDT packet.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS EVM value computed on the control header portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS EVM values computed for each averaging count. This value is expressed in dB. This result is valid only for LE-HDT packet.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df1avg_maximum(selector_string)

Gets the df1avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the df1avg results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df1avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the df1avg results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df1avg_mean(selector_string)

Gets the df1avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the df1avg results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df1avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the df1avg results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df1avg_minimum(selector_string)

Gets the df1avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the df1avg results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df1avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the df1avg results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df2avg_maximum(selector_string)

Gets the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the df2avg results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the df2avg results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df2avg_mean(selector_string)

Gets the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the df2avg results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the df2avg results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df2avg_minimum(selector_string)

Gets the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the df2avg results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df2avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the df2avg results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_df3avg_mean(selector_string)

Gets the df3avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the df3avg results computed for each averaging count. This value is expressed in Hz. This result is valid only for LE-CS packet with data rate 2 Mbps and when bandwidth bit period product is set to 2.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the df3avg value computed on the signal. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the df3avg results computed for each averaging count. This value is expressed in Hz. This result is valid only for LE-CS packet with data rate 2 Mbps and when bandwidth bit period product is set to 2.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_edr_header_frequency_error_wi_maximum(selector_string)

Gets the frequency error value computed on the header of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute header frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the frequency error value computed on the header of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute header frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_edr_peak_frequency_error_w0_maximum(selector_string)

Gets the peak frequency error value computed on the EDR portion of the EDR packet, relative to the header frequency error. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum absolute of the peak frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak frequency error value computed on the EDR portion of the EDR packet, relative to the header frequency error. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum absolute of the peak frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_edr_peak_frequency_error_wi_plus_w0_maximum(selector_string)

Gets the peak frequency error value computed on the EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak frequency error value computed on the EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_fractional_time_offset_mean(selector_string)

Gets the fractional time offset value computed on the sounding sequence portion of the LE CS Packet. This value is expressed in seconds. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the fractional time offset values for each averaging count.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the fractional time offset value computed on the sounding sequence portion of the LE CS Packet. This value is expressed in seconds. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the fractional time offset values for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_frequency_error_w0_plus_w1_maximum(selector_string)

Gets the total frequency error for the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the total frequency error for the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_gain_imbalance_mean(selector_string)

Gets the IQ gain imbalance estimated over preamble portion of the LE-HDT packets. This value is expressed in dB. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the IQ gain imbalance values computed for each averaging count.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the IQ gain imbalance estimated over preamble portion of the LE-HDT packets. This value is expressed in dB. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the IQ gain imbalance values computed for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_origin_offset_mean(selector_string)

Gets the I/Q origin offset estimated over the EDR portion of the EDR packets and preamble portion of the LE-HDT packets. This value is expressed in dB. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the I/Q origin offset values computed for each averaging count.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the I/Q origin offset estimated over the EDR portion of the EDR packets and preamble portion of the LE-HDT packets. This value is expressed in dB. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the I/Q origin offset values computed for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_le_initial_frequency_drift_maximum(selector_string)

Gets the initial frequency drift value computed on the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute initial frequency drift values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the initial frequency drift value computed on the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute initial frequency drift values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_le_initial_frequency_error_maximum(selector_string)

Gets the initial frequency error value computed on the preamble portion of the LE or LE-CS packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute initial frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the initial frequency error value computed on the preamble portion of the LE or LE-CS packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute initial frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_le_peak_frequency_drift_maximum(selector_string)

Gets the peak frequency drift value computed on the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak frequency drift value computed on the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_le_peak_frequency_drift_rate_maximum(selector_string)

Gets the peak frequency drift rate value computed on the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift rate values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak frequency drift rate value computed on the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of the absolute peak frequency drift rate values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_le_peak_frequency_error_maximum(selector_string)

When you set the DIRECTION_FINDING_MODE attribute to Disabled, it returns the peak frequency error value computed on the preamble and payload portion of the LE or LE-CS packet. When you set the Direction Finding Mode attribute to Angle of Arrival, it returns the peak frequency error value computed on the Constant tone extension field of the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of absolute the peak frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

When you set the DIRECTION_FINDING_MODE attribute to Disabled, it returns the peak frequency error value computed on the preamble and payload portion of the LE or LE-CS packet. When you set the Direction Finding Mode attribute to Angle of Arrival, it returns the peak frequency error value computed on the Constant tone extension field of the LE packet. When you set the AVERAGING_ENABLED attribute to True, it returns the value corresponding to the maximum of absolute the peak frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_minimum_df1max_minimum(selector_string)

Gets the minimum df1max value computed on the signal. The measurement computes df1max deviation values on a packet and reports the minimum value. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the Min df1max results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the minimum df1max value computed on the signal. The measurement computes df1max deviation values on a packet and reports the minimum value. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the Min df1max results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_minimum_df2max_minimum(selector_string)

Gets the minimum df2max value computed on the signal. The measurement computes df2max deviation values on a packet and reports the minimum value. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the Min df2max results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the minimum df2max value computed on the signal. The measurement computes df2max deviation values on a packet and reports the minimum value. When you set the AVERAGING_ENABLED attribute to True, it returns the minimum of the Min df2max results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_payload_frequency_error_w1_maximum(selector_string)

Gets the frequency error value computed on the payload portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute payload frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the frequency error value computed on the payload portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute payload frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_payload_rms_evm_mean(selector_string)

Gets the RMS EVM value computed on the payload portion including the payload header of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS EVM values computed for each averaging count. This value is expressed in dB. This result is valid only for LE-HDT packet.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS EVM value computed on the payload portion including the payload header of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS EVM values computed for each averaging count. This value is expressed in dB. This result is valid only for LE-HDT packet.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_devm_maximum(selector_string)

Gets the peak of the differential EVM (DEVM) values computed on symbols in the EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak symbol differential EVM (DEVM) values computed for each averaging count. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak of the differential EVM (DEVM) values computed on symbols in the EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak symbol differential EVM (DEVM) values computed for each averaging count. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_df1max_maximum(selector_string)

Gets the peak df1max value computed on the signal. The measurement computes df1max deviation values on a packet and reports the peak value. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak df1max results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak df1max value computed on the signal. The measurement computes df1max deviation values on a packet and reports the peak value. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak df1max results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_df2max_maximum(selector_string)

Gets the peak df2max value computed on the signal. The measurement computes df2max deviation values on a packet and reports the peak value. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak df2max results computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak df2max value computed on the signal. The measurement computes df2max deviation values on a packet and reports the peak value. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak df2max results computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_rms_devm_maximum(selector_string)

Gets the peak of the RMS differential EVM (DEVM) values computed on each 50us block of the EDR portion of the EDR packet. When you set AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS differential EVM (DEVM) values computed for each averaging count. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the EDR Differential EVM concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak of the RMS differential EVM (DEVM) values computed on each 50us block of the EDR portion of the EDR packet. When you set AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS differential EVM (DEVM) values computed for each averaging count. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_rms_magnitude_error_maximum(selector_string)

Gets the peak of the RMS magnitude error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS Magnitude error values computed for each averaging count. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the peak of the RMS magnitude error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS Magnitude error values computed for each averaging count. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_peak_rms_phase_error_maximum(selector_string)

Return the peak of the RMS phase error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS phase error values computed for each averaging count. This value is expressed in degrees.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Return the peak of the RMS phase error values computed on each 50 us block of EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the maximum of the peak RMS phase error values computed for each averaging count. This value is expressed in degrees.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_percentage_of_symbols_above_df1max_threshold(selector_string)

Gets the percentage of symbols with df1max values that are greater than the df1max threshold defined by the standard. This result is valid only for the LE packet with a data rate of 125 Kbps. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the df1max values from all averaging counts. This value expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the percentage of symbols with df1max values that are greater than the df1max threshold defined by the standard. This result is valid only for the LE packet with a data rate of 125 Kbps. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the df1max values from all averaging counts. This value expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_percentage_of_symbols_above_df2max_threshold(selector_string)

Gets the percentage of symbols with df2max values that are greater than the df2max threshold defined by the standard. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the df2max values from all averaging counts. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the percentage of symbols with df2max values that are greater than the df2max threshold defined by the standard. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the df2max values from all averaging counts. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_percentage_of_symbols_above_df4avg_threshold(selector_string)

Gets the percentage of symbols with df4avg values that are greater than the df4avg threshold defined by the standard. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the df4avg values from all averaging counts. This value is expressed as a percentage. This result is valid only for LE-CS packet with data rate 2 Mbps and when bandwidth bit period product is set to 2.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the df1 and df2 concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the percentage of symbols with df4avg values that are greater than the df4avg threshold defined by the standard. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the df4avg values from all averaging counts. This value is expressed as a percentage. This result is valid only for LE-CS packet with data rate 2 Mbps and when bandwidth bit period product is set to 2.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_percentage_of_symbols_below_99_percent_devm_limit(selector_string)

Gets the percentage of symbols in the EDR portion of all the measured EDR packets with differential EVM (DEVM) less than or equal to 99% DEVM threshold as defined in section 4.5.11 of the Bluetooth Test Specification RF.TS.p33.. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the symbol DEVM values from all averaging counts. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the percentage of symbols in the EDR portion of all the measured EDR packets with differential EVM (DEVM) less than or equal to 99% DEVM threshold as defined in section 4.5.11 of the Bluetooth Test Specification RF.TS.p33.. When you set the AVERAGING_ENABLED attribute to True, it computes this result using the symbol DEVM values from all averaging counts. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_preamble_frequency_error_w0_maximum(selector_string)

Gets the frequency error value computed on the preamble portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute preamble frequency error values computed for each averaging count. This value is expressed in Hz.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the Frequency Error Measurement concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the frequency error value computed on the preamble portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns a value corresponding to the maximum of the absolute preamble frequency error values computed for each averaging count. This value is expressed in Hz.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_preamble_rms_evm_mean(selector_string)

Gets the RMS EVM value computed on the preamble portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS EVM values computed for each averaging count. This value is expressed in dB. This result is valid only for LE-HDT packet.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS EVM value computed on the preamble portion of the LE-HDT packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS EVM values computed for each averaging count. This value is expressed in dB. This result is valid only for LE-HDT packet.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_preamble_start_time_mean(selector_string)

Gets the start time of the preamble of LE-CS packet. This value is expressed in seconds. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the preamble start time values computed for each averaging count.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the start time of the preamble of LE-CS packet. This value is expressed in seconds. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the preamble start time values computed for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_quadrature_error_mean(selector_string)

Gets the quadrature error estimated over preamble portion of the LE-HDT packets. This value is expressed in degree. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the quadrature error values computed for each averaging count.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the quadrature error estimated over preamble portion of the LE-HDT packets. This value is expressed in degree. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the quadrature error values computed for each averaging count.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_rms_devm_mean(selector_string)

Gets the RMS differential EVM (DEVM) value computed on the EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS differential EVM (DEVM) values computed for each averaging count. This value is expressed as a percentage.

You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector String topic for information about the string syntax for named signals and results. Refer to the EDR Differential EVM concept topic for more details.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Returns the RMS differential EVM (DEVM) value computed on the EDR portion of the EDR packet. When you set the AVERAGING_ENABLED attribute to True, it returns the mean of the RMS differential EVM (DEVM) values computed for each averaging count. This value is expressed as a percentage.

error_code (int):

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)