Viewer

org.bluetooth.characteristic.new_alert

Name: New Alert

Type: org.bluetooth.characteristic.new_alertDownload / View

Assigned Number: 0x2A46

Abstract:

This characteristic defines the category of the alert and how many new alerts of that category have occurred in the server device. Brief text information may also be included for the last alert in the category.

Summary:

This characteristic consists of “Category ID”, “uint8”, and “UTF-8 string” fields. The size of this characteristic is dynamic because of the variable length text (“UTF-8”) field. The minimum length of “UTF-8 string” is 0 octets and maximum length of “UTF-8 string” is 18 octets.

Example:

The value 0x01, 0x04, 0x52, 0x69, 0x63, 0x68, 0x61, 0x72, 0x64 are interpreted that the server has 4 new email messages and the last message was sent by “Richard”.

Value Fields

Names Field Requirement Format Minimum Value Maximum Value Additional Information
Category ID
Information:
This field shows the category of the new alert.
Mandatory
org.bluetooth.characteristic.alert_category_id N/A N/A None
Number of New Alert
Information:
This field provides the number of new alerts in the server.
Mandatory
uint8 0 255 None
Text String Information
Information:
The field provides brief text information for the last alert.
Optional
utf8s N/A N/A None

Note:

The fields in the above table are in the order of LSO to MSO. Where LSO = Least Significant Octet and MSO = Most Significant Octet.

Note:

Recommended Usage for Text String Information Field in New Incoming Alert:

The usage of this text is up to the implementation, but the recommended text for the category is defined as following for best user experience:

Category: Simple Alert - The title of the alert

Category: Email - Sender name

Category: News - Title of the news feed

Category: Call - Caller name or caller ID

Category: Missed call - Caller name or caller ID

Category: SMS - Sender name or caller ID

Category: Voice mail - Sender name or caller ID

Category: Schedule - Title of the schedule

Category Hig:h Prioritized Aler - Title of the alert

Category: Instant Messaging - Sender name