1.1.2.1.1.4.39 BLE_GAP_SetAdvTxPowerLevel

C

uint16_t BLE_GAP_SetAdvTxPowerLevel(int8_t advTxPower, int8_t *p_selectedTxPower);

Description

Set RF Tx power level preset value for Advertising physical channel PDUs. (Advertising physical channel PDUs means all of advertising, scanning and initiating PDU). Advertising PDU Tx power setting for specific Advertising handle can be revised by BLE_GAP_SetExtAdvParams. It is recommended to called during application code initialization.

Parameters

ParameterDescription
[in] advTxPowerThe advertising transmit power.
[out] p_selectedTxPowerPoint to the real transmit power level. (Unit: dBm)

Return values

Return valueDescription
MBA_RES_SUCCESSSuccessfully set the transmit power level.
MBA_RES_OOMInternal memory allocation failure.
MBA_RES_INVALID_PARAInvalid parameters.