PowerRampResults

Provides methods to fetch and read the PowerRamp measurement results.

class nirfmxbluetooth.powerramp_results.PowerRampResults(signal_obj)[source]

Bases: object

Provides methods to fetch and read the PowerRamp measurement results.

get_40db_fall_time_mean(selector_string)[source]

40dB Fall Time returns the fall time of the acquired signal at which transmit power drops 40 dB below average power. The result is valid only for LE-CS packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True, this parameter returns the mean of the 40dB fall time computed for each averaging count. This value is expressed in seconds.

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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

40dB Fall Time returns the fall time of the acquired signal at which transmit power drops 40 dB below average power. The result is valid only for LE-CS packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True, this parameter returns the mean of the 40dB fall time computed for each averaging count. 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 (attr_val, error_code)

get_40db_rise_time_mean(selector_string)[source]

40dB Rise Time returns the time required for the output power to rise from -40 dB to -1 dB relative to the reference output power. The result is valid only for LE-HDT packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True, this parameter returns the mean of the 40dB rise time computed for each averaging count. This value is expressed in seconds.

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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

40dB Rise Time returns the time required for the output power to rise from -40 dB to -1 dB relative to the reference output power. The result is valid only for LE-HDT packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True, this parameter returns the mean of the 40dB rise time computed for each averaging count. 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 (attr_val, error_code)

get_fall_time_mean(selector_string)[source]

Fall Time returns the fall time of the acquired signal that is the amount of time taken for the power envelope to fall from 10 percent to 90 percent of a reference level. The reference level is defined as the peak power for LE-CS packets and the average power for LE-HDT packets. The result is valid only for LE-CS and LE-HDT packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True,this parameter returns the mean of the fall time computed for each averaging countt. This value is expressed in seconds.

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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Fall Time returns the fall time of the acquired signal that is the amount of time taken for the power envelope to fall from 10 percent to 90 percent of a reference level. The reference level is defined as the peak power for LE-CS packets and the average power for LE-HDT packets. The result is valid only for LE-CS and LE-HDT packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True,this parameter returns the mean of the fall time computed for each averaging countt. 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 (attr_val, error_code)

get_rise_time_mean(selector_string)[source]

Rise Time returns the rise time of the acquired signal that is the amount of time taken for the power envelope to rise from 10 percent to 90 percent of a reference level. The reference level is defined as the peak power for LE-CS packets and the average power for LE-HDT packets. The result is valid only for LE-CS and LE-HDT packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True, this parameter returns the mean of the rise time computed for each averaging count. This value is expressed in seconds.

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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):

Rise Time returns the rise time of the acquired signal that is the amount of time taken for the power envelope to rise from 10 percent to 90 percent of a reference level. The reference level is defined as the peak power for LE-CS packets and the average power for LE-HDT packets. The result is valid only for LE-CS and LE-HDT packets. When you set the POWERRAMP_AVERAGING_ENABLED attribute to True, this parameter returns the mean of the rise time computed for each averaging count. 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 (attr_val, error_code)