sl_bt_evt_connection_remote_tx_powerConnection#

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

Data Structures#

struct  

sl_bt_evt_connection_remote_tx_power_s

Data structure of the remote_tx_power event.

Macros#

#define 

sl_bt_evt_connection_remote_tx_power_id   0x070600a0

Identifier of the remote_tx_power event.

Detailed Description#

Reports a transmit power change on the remote 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_remote_tx_power_s#

struct sl_bt_evt_connection_remote_tx_power_s

Data structure of the remote_tx_power event.

Data Fields

uint8_t

connection

Handle of the connection

uint8_t

phy

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

  • sl_bt_gap_1m_phy_uncoded (0x1): 1M PHY

  • sl_bt_gap_2m_phy_uncoded (0x2): 2M PHY

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

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

int8_t

power_level

Transmit power level. Values:

Range -127 to 20: The transmit power level in dBm

SL_BT_CONNECTION_TX_POWER_UNMANAGED (0x7E): Remote device is not managing power levels on this PHY.

SL_BT_CONNECTION_TX_POWER_UNAVAILABLE (0x7F): Transmit power level is not available.

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_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:

  • (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