UM1770 datasheet(32/56 Pages) STMICROELECTRONICS

32 / 56 page

Profile – application interface functions

UM1770

32/56

DocID026385 Rev 2

6.4.10

ANS_Update_Unread_Alert_Category()

Description

The application calls this to update the unread alert category with the new bitmask. It returns

BLE_STATUS_SUCCESS if the update is successfully started and

BLE_STATUS_INVALID_PARAMS if a bitmask for an invalid category is set.

Parameters

Length: length of the category field; it must be 0 or 1.

Category: bitmask of the categories supported. The bitmasks are split across two

octets with the meanings described in the bluetooth assigned numbers documentation.

6.4.11

ANS_Update_New_Alert()

Description

The application calls this to update the number of new alerts for the category specified in the

new alert characteristic. If the category ID specified is not valid or the text information is

longer than 18 octets, BLE_STATUS_INVALID_PARAMS is returned. On successful write,

BLE_STATUS_SUCCESS is returned.

Parameters

alertCount: alert count for the category specified. The application must maintain the

count of new alerts.

categoryID: category which is affected by the command.

TextInfo: textual information corresponding to the alert.

6.4.12

ANS_Update_Unread_Alert_Status()

Description

The application calls this to update the number of unread alerts for the category specified in

the new alert characteristic. If the category ID specified is not valid,

BLE_STATUS_INVALID_PARAMS is returned. On successful write to the alert status,

BLE_STATUS_SUCCESS is returned.

Parameters

categoryID: category which is affected by the command.

AlertCount: alert count for the category specified. The application must maintain the

count of unread alerts.

UM1770 Datasheet(PDF) 32 Page - STMicroelectronics