Immediate Alert Service module.
More...
|
#define | BLE_IAS_DEF(_name, _ias_max_clients) |
| Macro for defining a ble_ias instance. More...
|
|
Immediate Alert Service module.
This module implements the Immediate Alert Service with the Alert Level characteristic. During initialization it adds the Immediate Alert Service and Alert Level characteristic to the BLE stack database.
The application must supply an event handler for receiving Immediate Alert Service events. Using this handler, the service will notify the application when the Alert Level characteristic value changes.
The service also provides a function for letting the application poll the current value of the Alert Level characteristic.
- Note
- The application must register this module as BLE event observer using the NRF_SDH_BLE_OBSERVER macro. Example:
-
Attention! To maintain compliance with Nordic Semiconductor ASA Bluetooth profile qualification listings, this section of source code must not be modified.
#define BLE_IAS_DEF |
( |
|
_name, |
|
|
|
_ias_max_clients |
|
) |
| |
Macro for defining a ble_ias instance.
- Parameters
-
| _name | Name of the instance. |
[in] | _ias_max_clients | Maximum number of IAS clients connected at a time. |
Immediate Alert Service event type.
Enumerator |
---|
BLE_IAS_EVT_ALERT_LEVEL_UPDATED |
Alert Level Updated event.
|
uint32_t ble_ias_alert_level_get |
( |
ble_ias_t * |
p_ias, |
|
|
uint16_t |
conn_handle, |
|
|
uint8_t * |
p_alert_level |
|
) |
| |
Function for getting value of the Alert Level characteristic.
- Parameters
-
[in] | p_ias | Immediate Alert Service structure. |
[in] | conn_handle | Connection handle of the destination client. |
[out] | p_alert_level | Alert Level value which has been set by the specific client. |
Function for initializing the Immediate Alert Service.
- Parameters
-
[out] | p_ias | Immediate Alert 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_ias_init | Information needed to initialize the service. |
- Returns
- NRF_SUCCESS on successful initialization of service, otherwise an error code.
void ble_ias_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 Immediate Alert Service.
- Parameters
-
[in] | p_ble_evt | Event received from the BLE stack. |
[in] | p_context | Immediate Alert Service structure. |