BLE_GAP_SetAdvTxPowerLevel

C

uint16_t BLE_GAP_SetAdvTxPowerLevel(int8_t advTxPower, int8_t *p_selectedTxPower);

Description

Sets the RF Tx power level for Advertising physical channel PDUs.

Note

Advertising physical channel PDUs encompass advertising, scanning, and initiating PDUs. This setting can be overridden for a specific Advertising handle by using BLE_GAP_SetExtAdvParams. It is recommended to call this function during application initialization.

Parameters

ParameterDescription
[in] advTxPowerThe desired advertising transmit power level.
[out] p_selectedTxPowerPointer to the actual transmit power level set. (Unit: dBm)

Return values

Return valueDescription
MBA_RES_SUCCESSSuccessfully sets the transmit power level.
MBA_RES_OOMInternal memory allocation failure occurred.
MBA_RES_INVALID_PARAThe parameters provided are invalid.