BLE_GAP_ReadRemoteTxPowerLevel

C

uint16_t BLE_GAP_ReadRemoteTxPowerLevel(uint16_t connHandle, uint8_t phy);

Requests the transmit power level used by the remote device on a specific connection.

This command should only be used after receiving the BLE_GAP_EVT_FEATURE_EXCHANGE_COMPL event.

BLE_GAP_EVT_TRANSMIT_POWER_REPORTING is generated to provide Tx power level information.


Parameter	Description
[in] connHandle	Connection handle associated with this connection.
[in] phy	The PHY for which to request the power level. See Transmitter PHY type.


Return value	Description
MBA_RES_SUCCESS	Successfully issues the request for the remote device's transmit power level.
MBA_RES_OOM	Internal memory allocation failure occurred.
MBA_RES_INVALID_PARA	The parameters provided are invalid.
MBA_RES_COMMAND_DISALLOWED	Command disallowed due to a conflicting operation or state.