BLE IAS

This section defines the database of Immediate Alert Service and manages the write event of Alert Level Characteristic from a peer device. More...

Overview

This section defines the database of Immediate Alert Service and manages the write event of Alert Level Characteristic from a peer device.

Terms and Acronyms

Terms	Details
IAS	Immediate Alert Service. This service exposes a control point to allow a peer device to cause the device to immediately alert.

How to use this module

• Step 1. Add IAS service to the application's GATT service database. And then return the bt_gatts_service_t pointer to GATTS stack by implementing the user-defined callback bt_get_gatt_server().
  • Sample Code:

    // The GATTS collects all services.
    const bt_gatts_service_t * ble_gatt_server[] = {
        &ble_gap_service,  // handle range: 0x0001 to 0x0009.
        &ble_gatt_service, // handle range: 0x0011 to 0x0015.
        &ble_ias_service,  // handle range: 0x0040 to 0x0042.
        NULL
     };
     const bt_gatts_service_t** bt_get_gatt_server()
     { 
         return ble_gatt_server;
     }

• Step 2. Implement the user-defined callback ble_ias_alert_level_write_callback() to listen to the write event of the Alert Level Characteristic.
  • Sample Code:

    void ble_ias_alert_level_write_callback(uint16_t conn_handle, uint8_t alert_level)
    {
        if (conn_handle) {
            // Save the alert level.
        }
    }

Functions
void	ble_ias_alert_level_write_callback (uint16_t conn_handle, uint8_t alert_level)
	This function is a user-defined callback for the application to listen to the write event of Alert Level Characteristic. More...

Variables
BT_EXTERN_C_BEGIN const bt_gatts_service_t	ble_ias_service

Function Documentation

void ble_ias_alert_level_write_callback	(	uint16_t	conn_handle,
		uint8_t	alert_level
	)

This function is a user-defined callback for the application to listen to the write event of Alert Level Characteristic.

Parameters

[in]	conn_handle	is the connection handle.
[in]	alert_level	is the alert level value written by the remote device.

Returns

void.