BLE_GAP_ReadRemoteTxPowerLevel
C
uint16_t BLE_GAP_ReadRemoteTxPowerLevel(uint16_t connHandle, uint8_t phy);Description
Requests the transmit power level used by the remote device on a specific connection.
Note
This command should only be used after receiving the BLE_GAP_EVT_FEATURE_EXCHANGE_COMPL event.
Events generated
BLE_GAP_EVT_TRANSMIT_POWER_REPORTING is generated to provide Tx power level information.
Parameters
| 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 values
| 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. |