PowerRampResults
Provides methods to fetch and read the PowerRamp measurement results.
- class nirfmxbluetooth.powerramp_results.PowerRampResults(signal_obj)[source]
Bases:
objectProvides 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_ENABLEDattribute 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_ENABLEDattribute 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_ENABLEDattribute 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_ENABLEDattribute 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_ENABLEDattribute 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_ENABLEDattribute 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_ENABLEDattribute 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_ENABLEDattribute 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)