TX Power Service

TX Power Service module. More...

Modules
	TX Power Service configuration

Data Structures
struct	ble_tps_init_t
	TX Power Service init structure. This contains all options and data needed for initialization of the service. More...
struct	ble_tps_t
	TX Power Service structure. This contains various status information for the service. More...

Macros
#define	BLE_TPS_DEF(_name)
	Macro for defining a ble_tps instance. More...

Functions
uint32_t	ble_tps_init (ble_tps_t *p_hrs, const ble_tps_init_t *p_tps_init)
	Function for initializing the TX Power Service. More...
void	ble_tps_on_ble_evt (ble_evt_t const *p_ble_evt, void *p_context)
	Function for handling the Application's BLE Stack events. More...
uint32_t	ble_tps_tx_power_level_set (ble_tps_t *p_tps, int8_t tx_power_level)
	Function for setting the value of the TX Power Level characteristic. More...

Detailed Description

TX Power Service module.

This module implements the TX Power Service with the TX Power Level characteristic. During initialization it adds the TX Power Service and TX Power Level characteristic with the specified initial value to the BLE stack database.

It provides a function for letting the application update the TX Power Level characteristic.

Note

Attention! To maintain compliance with Nordic Semiconductor ASA Bluetooth profile qualification listings, this section of source code must not be modified.

Macro Definition Documentation

#define BLE_TPS_DEF

(

_name

)

Macro for defining a ble_tps instance.

Parameters

_name

Name of the instance.

Function Documentation

uint32_t ble_tps_init	(	ble_tps_t *	p_hrs,
		const ble_tps_init_t *	p_tps_init
	)

Function for initializing the TX Power Service.

Parameters

[out]	p_hrs	TX Power Service structure. This structure will have to be supplied by the application. It will be initialized by this function, and will later be used to identify this particular service instance.
[in]	p_tps_init	Information needed to initialize the service.

Returns

NRF_SUCCESS on successful initialization of service, otherwise an error code.

void ble_tps_on_ble_evt	(	ble_evt_t const *	p_ble_evt,
		void *	p_context
	)

Function for handling the Application's BLE Stack events.

Handles all events from the BLE stack of interest to the TX Power Service.

Parameters

[in]	p_ble_evt	Event received from the BLE stack.
[in]	p_context	TX Power Service structure.

uint32_t ble_tps_tx_power_level_set	(	ble_tps_t *	p_tps,
		int8_t	tx_power_level
	)

Function for setting the value of the TX Power Level characteristic.

Parameters

[in]	p_tps	TX Power Service structure.
[in]	tx_power_level	New TX Power Level (unit dBm, range -100 to 20).

Returns

NRF_SUCCESS on success, otherwise an error code.