Definitions and prototypes for the BAS interface. More...
Modules | |
Defines | |
Enumerations | |
Structures | |
Typedefs | |
Functions | |
Definitions and prototypes for the BAS interface.
The Battery Service exposes the state of a battery within a device. This module implements the Battery Service with the Battery Level characteristic.
After bas_init_t variable is initialized, the application must call bas_service_init() to add the Battery Service(s) and Battery Level characteristic(s) to the BLE Stack database. However the value of Battery Level characteristic is stored within bas_init_t::batt_lvl which locates in user space.
The module supports more than one instance of the Battery service with bas_service_init(). When the device has more than one instance, each Battery Level characteristic shall include a Characteristic Presentation Format descriptor to identify the instance. bas_init_t::char_mask shall be set with the mask BAS_CHAR_FORMAT_SUP to add the descriptor to the BLE stack database.
If bas_init_t::char_mask is set with the mask BAS_CHAR_LVL_NTF_SUP, the module will support notification of the Battery Level characteristic through the bas_batt_lvl_update() function. If an event handler is provided by the application, the Battery Service will pass Battery Service events to the application.