sd_ble_gap_tx_power_set()

uint32_t sd_ble_gap_tx_power_set	(	uint8_t	role,
		uint16_t	handle,
		int8_t	tx_power )

#include <ble_gap.h>

Set the radio's transmit power.

Parameters

[in]	role	The role to set the transmit power for, see BLE_GAP_TX_POWER_ROLES for possible roles.
[in]	handle	The handle parameter is interpreted depending on role: If role is BLE_GAP_TX_POWER_ROLE_CONN, this value is the specific connection handle. If role is BLE_GAP_TX_POWER_ROLE_ADV, the advertising set identified with the advertising handle, will use the specified transmit power, and include it in the advertising packet headers if ble_gap_adv_properties_t::include_tx_power set. For all other roles, handle is ignored.
[in]	tx_power	Radio transmit power in dBm (see Product Specification for supported values).

Note

Power will be set to supported value that is less than or equal to requested value, clamping at minimum supported power.

The initiator will have the same transmit power as the scanner.

When a connection is created it will inherit the transmit power from the initiator or advertiser leading to the connection.

Return values

NRF_SUCCESS	Successfully changed the transmit power.
NRF_ERROR_INVALID_PARAM	Invalid parameter(s) supplied.
BLE_ERROR_INVALID_ADV_HANDLE	Advertising handle not found.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied.