NI RFmx Bluetooth TXP Attributes - ni/grpc-device GitHub Wiki
- RFMXBT_ATTR_TXP_MEASUREMENT_ENABLED
- RFMXBT_ATTR_TXP_BURST_SYNCHRONIZATION_TYPE
- Averaging
- RFMXBT_ATTR_TXP_ALL_TRACES_ENABLED
- RFMXBT_ATTR_TXP_NUMBER_OF_ANALYSIS_THREADS
-
Results
- RFMXBT_ATTR_TXP_RESULTS_AVERAGE_POWER_MEAN
- RFMXBT_ATTR_TXP_RESULTS_AVERAGE_POWER_MAXIMUM
- RFMXBT_ATTR_TXP_RESULTS_AVERAGE_POWER_MINIMUM
- RFMXBT_ATTR_TXP_RESULTS_PEAK_POWER_MAXIMUM
- RFMXBT_ATTR_TXP_RESULTS_PEAK_TO_AVERAGE_POWER_RATIO_MAXIMUM
- RFMXBT_ATTR_TXP_RESULTS_EDR_GFSK_AVERAGE_POWER_MEAN
- RFMXBT_ATTR_TXP_RESULTS_EDR_DPSK_AVERAGE_POWER_MEAN
- RFMXBT_ATTR_TXP_RESULTS_EDR_DPSK_GFSK_AVERAGE_POWER_RATIO_MEAN
- RFMXBT_ATTR_TXP_RESULTS_LE_CTE_REFERENCE_PERIOD_AVERAGE_POWER_MEAN
- RFMXBT_ATTR_TXP_RESULTS_LE_CTE_REFERENCE_PERIOD_PEAK_ABSOLUTE_POWER_DEVIATION_MAXIMUM
- RFMXBT_ATTR_TXP_RESULTS_LE_CTE_TRANSMIT_SLOT_AVERAGE_POWER_MEAN
- RFMXBT_ATTR_TXP_RESULTS_LE_CTE_TRANSMIT_SLOT_PEAK_ABSOLUTE_POWER_DEVIATION_MAXIMUM
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32 |
| Description: | Specifies whether to enable the transmit power (TxP) measurements. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_FALSE. Get Function: RFmxBT_TXPGetMeasurementEnabled Set Function: RFmxBT_TXPSetMeasurementEnabled |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32 |
| Description: | Specifies the type of synchronization used for detecting the start of packet in the transmit power (TXP) measurement. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_TXP_BURST_SYNCHRONIZATION_TYPE_PREAMBLE. Get Function: RFmxBT_TXPGetBurstSynchronizationType Set Function: RFmxBT_TXPSetBurstSynchronizationType |
| Values: | |
|---|---|
| RFMXBT_VAL_TXP_BURST_SYNCHRONIZATION_TYPE_NONE (0) | Specifies that the measurement does not perform synchronization to detect the start of the packet. |
| RFMXBT_VAL_TXP_BURST_SYNCHRONIZATION_TYPE_PREAMBLE (1) | Specifies that the measurement uses the preamble field to detect the start of the packet. |
| RFMXBT_VAL_TXP_BURST_SYNCHRONIZATION_TYPE_SYNC_WORD (2) | Specifies that the measurement uses sync word for the BR/EDR packets and access address for LE packets to detect the start of the packet. For BR /EDR packets, the sync word is derived from the RFMXBT_ATTR_BD_ADDRESS_LAP attribute. |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32 |
| Description: | Specifies whether to enable averaging for the transmit power (TxP) measurements. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_TXP_AVERAGING_ENABLED_FALSE. Get Function: RFmxBT_TXPGetAveragingEnabled Set Function: RFmxBT_TXPSetAveragingEnabled |
| Values: | |
|---|---|
| RFMXBT_VAL_TXP_AVERAGING_ENABLED_FALSE (0) | The measurement is performed on a single acquisition. |
| RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE (1) | The measurement uses the RFMXBT_ATTR_TXP_AVERAGING_COUNT attribute as the number of acquisitions over which the TXP measurement is averaged. |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32 |
| Description: | Specifies the number of acquisitions used for averaging when you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is 10. Get Function: RFmxBT_TXPGetAveragingCount Set Function: RFmxBT_TXPSetAveragingCount |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32 |
| Description: | Specifies whether to enable all the traces used for transmit power (TxP) measurements. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is RFMXBT_VAL_FALSE. Get Function: RFmxBT_TXPGetAllTracesEnabled Set Function: RFmxBT_TXPSetAllTracesEnabled |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxBT_SetAttributeI32 RFmxBT_GetAttributeI32 |
| Description: | Specifies the maximum number of threads used for parallelism for TXP measurement. The number of threads can range from 1 to the number of physical cores. The number of threads you set may not be used in calculations. The actual number of threads used depends on the problem size, system resources, data availability, and other considerations. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals. The default value is 1. Get Function: RFmxBT_TXPGetNumberOfAnalysisThreads Set Function: RFmxBT_TXPSetNumberOfAnalysisThreads |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power computed over the measurement interval. When you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE for LE packets, it will exclude guard period and all the switching slots for the average power computation. This value is expressed in dBm. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the mean of the average power results 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 Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsAveragePowerMean |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power computed over the measurement interval. When you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE for LE packets, it will exclude guard period and all the switching slots for the average power computation. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the maximum of the average power results computed for each averaging count. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsAveragePowerMaximum |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power computed over the measurement interval. When you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE for LE packets, it will exclude guard period and all the switching slots for the average power computation. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the minimum of the average power results computed for each averaging count. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsAveragePowerMinimum |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the peak power computed over the measurement interval. When you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE for LE packets, it will exclude guard period and all the switching slots for the peak power computation. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the maximum of the peak power results computed for each averaging count. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsPeakPowerMaximum |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the peak to average power ratio computed over the measurement interval. When you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE for LE packets, it will exclude guard period and all the switching slots for the peak to average power ratio computation. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the maximum of the peak to average power ratio results computed for each averaging count. This value is expressed in dB. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsPeakToAveragePowerRatioMaximum |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power of the GFSK portion of the EDR packet. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the mean of the GFSK average power results computed for each averaging count. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsEDRGFSKAveragePowerMean |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power of the DPSK portion of the EDR packet. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the mean of the DPSK average power results computed for each averaging count. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsEDRDPSKAveragePowerMean |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the ratio of the average power of the DPSK portion to the average power of the GFSK portion of the EDR packet. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the mean of the DPSK GFSK average power ratio results computed for each averaging count. This value is expressed in dB. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsEDR_DPSK_GFSKAveragePowerRatioMean |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power computed over the reference period in the CTE portion of the LE packet. This result is applicable only when you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the mean of the CTE reference period average power results computed for each averaging count. This value is expressed in dBm. You do not need to use a selector string to read this result for the default signal and result instance. Refer to the Selector Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsLECTEReferencePeriodAveragePowerMean |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the peak absolute power deviation computed over the reference period in the CTE portion of the LE packet. The peak absolute power deviation is the deviation of peak power with respect to the average power in the reference period. This result is applicable only when you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the maximum of the CTE reference period absolute power deviation results 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 Strings topic for information about the string syntax for named signals and results. Get Function: RFmxBT_TXPGetResultsLECTEReferencePeriodPeakAbsolutePowerDeviationMaximum |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the average power computed over each transmit slot in CTE portion of the LE packet. This result is applicable only when you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the mean of the CTE transmit slot average power results computed for each averaging count. This value is expressed in dBm. Use 'slot(k)' as the selector string to read this result. Get Function: RFmxBT_TXPGetResultsLECTETransmitSlotAveragePowerMean |
| Data Type: | float64 |
|---|---|
| Access: | read only |
| Functions: | RFmxBT_GetAttributeF64 |
| Description: | Returns the peak absolute power deviation computed over each transmit slot in the CTE portion of the LE packet. The peak absolute power deviation is the deviation of peak power in each transmit slot with respect to the average power in that transmit slot. This result is applicable only when you set the RFMXBT_ATTR_DIRECTION_FINDING_MODE attribute to RFMXBT_VAL_DIRECTION_FINDING_MODE_ANGLE_OF_DEPARTURE. When you set the RFMXBT_ATTR_TXP_AVERAGING_ENABLED attribute to RFMXBT_VAL_TXP_AVERAGING_ENABLED_TRUE, it returns the maximum of the CTE transmit slot absolute power deviation results computed for each averaging count. This value is expressed as a percentage. Use 'slot(k)' as the selector string to read this result. Get Function: RFmxBT_TXPGetResultsLECTETransmitSlotPeakAbsolutePowerDeviationMaximum |