TX Power Service

nRF5 SDK v14.2.0

TX Power Service module. More...

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 state of the Sensor Contact Detected bit. 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 state of the Sensor Contact Detected bit.

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.