BLE_GAP_ReadTxPowerLevel
C
uint16_t BLE_GAP_ReadTxPowerLevel(uint16_t connHandle, uint8_t phy, int8_t *p_txPower, int8_t *p_txPowerMax);Description
Reads the current and maximum transmit power levels for a specific LE connection handle. (Unit: dBm)
Parameters
| Parameter | Description |
|---|---|
| [in] connHandle | Connection handle associated with this connection. |
| [in] phy | The PHY for which to read the power levels. See Transmitter PHY type. |
| [out] p_txPower | Pointer to the current transmit power level. (Unit: dBm) |
| [out] p_txPowerMax | Pointer to the maximum transmit power level. (Unit: dBm) |
Return values
| Return value | Description |
|---|---|
| MBA_RES_SUCCESS | Successfully retrieves the 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. |