sl_bt_evt_connection_tx_powerConnection#

Reports a transmit power change on the local device of a connection if transmit power reporting has been enabled.

Data Structures#

struct | sl_bt_evt_connection_tx_power_s | Data structure of the tx_power event.

Macros#

#define | sl_bt_evt_connection_tx_power_id 0x060600a0 | Identifier of the tx_power event.

Detailed Description#

Reports a transmit power change on the local device of a connection if transmit power reporting has been enabled.

Enable or disable transmit power reporting using sl_bt_connection_set_power_reporting command.

Data Structure Documentation#

◆ sl_bt_evt_connection_tx_power_s#

struct sl_bt_evt_connection_tx_power_s#

Data structure of the tx_power event.

Data Fields#

uint8_t | connection |

Handle of the connection

uint8_t | phy |

Enum sl_bt_gap_phy_coding_t. The PHY which the transmit power is reported for. Values:

  • sl_bt_gap_phy_coding_1m_uncoded (0x1): 1M PHY

  • sl_bt_gap_phy_coding_2m_uncoded (0x2): 2M PHY

  • sl_bt_gap_phy_coding_125k_coded (0x4): 125k Coded PHY (S=8)

  • sl_bt_gap_phy_coding_500k_coded (0x8): 500k Coded PHY (S=2)

int8_t | power_level |

Transmit power level. Values:

uint8_t | flags |

Enum sl_bt_connection_tx_power_flag_t. Transmit power level flags. Ignore this field if power_level is set to 0x7E or 0x7F. Values:

  • sl_bt_connection_tx_power_flag_none (0x0): No flag is defined for the reported TX power level

  • sl_bt_connection_tx_power_at_minimum (0x1): Transmit power level is at minimum level.

  • sl_bt_connection_tx_power_at_maximum (0x2): Transmit power level is at maximum level.

int8_t | delta |

Change in transmit power level. Values:

  • SL_BT_CONNECTION_TX_POWER_CHANGE_UNAVAILABLE (0x7F): Change is not available or is out of range.

  • Other values: positive indicates increased power, negative indicates decreased power, and zero indicates unchanged. Units: dB