-
Version: V10r00
-
Version Date: 2011-06-21
-
Prepared By: PUID WG
Revision History
Revision |
Date(yy-mm-dd) |
Comments |
---|---|---|
D09r01 |
2010-05-05 |
First draft of Immediate Alert service |
D09r02 |
2010-05-17 |
Comments from Tim Howes |
D09r03 |
2010-05-18 |
Additional comments from Tim Howes |
D09r04 |
2010-05-19 |
Comments from Reto Galli and Frank Berntsen |
D09r05 |
2010-11-08 |
Updated following approval of Proximity UCRDD |
D09r06 |
2010-11-18 |
Added GATT requirements to 1.4 |
D09r07 |
2010-11-24 |
Updated to match revised template from GPA WG |
D09r08 |
2010-11-25 |
Further correction |
D09r09 |
2010-12-01 |
Comments from RH & MW, plus responses |
D09r10 |
2010-12-02 |
Comments from DT, plus responses, and update from PUID call |
D09r11 |
2010-12-03 |
Additional change to Section 4 |
D09r12 |
2010-12-06 |
Additional changes from Robin |
D10r01 |
2011-01-24 |
Editorial correction |
D10r02 |
2011-01-24 |
Change table 3.2 to exclude “Read”. |
D10r03 |
2011-03-08 |
Updated security statement in section3. |
D10r04 |
2011-05-25 |
Updated references |
D10r05 |
2011-06-07 |
Removed BR/EDR |
V10r00 |
2011-06-21 |
Adopted by the Bluetooth SIG Board of Directors |
Contributors
Name |
Company |
---|---|
Tim Howes |
Accenture |
Robin Heydon |
CSR Plc |
Jonathan Tanner |
CSR Plc |
Reto Galli |
EM Microelectronic |
Kanji Kerai |
Nokia Corporation |
Steve Davies |
Nokia Corporation |
Frank Berntsen |
Nordic Semiconductor |
Disclaimer and Copyright Notice
The copyright in this specification is owned by the Promoter Members of Bluetooth® Special Interest Group (SIG), Inc. (“Bluetooth SIG”). Use of these specifications and any related intellectual property (collectively, the “Specification”), is governed by the Promoters Membership Agreement among the Promoter Members and Bluetooth SIG (the “Promoters Agreement”), certain membership agreements between Bluetooth SIG and its Adopter and Associate Members (the “Membership Agreements”) and the Bluetooth Specification Early Adopters Agreements (1.2 Early Adopters Agreements) among Early Adopter members of the unincorporated Bluetooth SIG and the Promoter Members (the “Early Adopters Agreement”). Certain rights and obligations of the Promoter Members under the Early Adopters Agreements have been assigned to Bluetooth SIG by the Promoter Members.
Use of the Specification by anyone who is not a member of Bluetooth SIG or a party to an Early Adopters Agreement (each such person or party, a “Member”) is prohibited. The legal rights and obligations of each Member are governed by their applicable Membership Agreement, Early Adopters Agreement or Promoters Agreement. No license, express or implied, by estoppel or otherwise, to any intellectual property rights are granted herein.
Any use of the Specification not in compliance with the terms of the applicable Membership Agreement, Early Adopters Agreement or Promoters Agreement is prohibited and any such prohibited use may result in termination of the applicable Membership Agreement or Early Adopters Agreement and other liability permitted by the applicable agreement or by applicable law to Bluetooth SIG or any of its members for patent, copyright and/or trademark infringement.
THE SPECIFICATION IS PROVIDED “AS IS” WITH NO WARRANTIES WHATSOEVER, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR ANY PARTICULAR PURPOSE, SATISFACTORY QUALITY, OR REASONABLE SKILL OR CARE, OR ANY WARRANTY ARISING OUT OF ANY COURSE OF DEALING, USAGE, TRADE PRACTICE, PROPOSAL, SPECIFICATION OR SAMPLE.
Each Member hereby acknowledges that products equipped with the Bluetooth technology ("Bluetooth products") may be subject to various regulatory controls under the laws and regulations of various governments worldwide. Such laws and regulatory controls may govern, among other things, the combination, operation, use, implementation and distribution of Bluetooth products. Examples of such laws and regulatory controls include, but are not limited to, airline regulatory controls, telecommunications regulations, technology transfer controls and health and safety regulations. Each Member is solely responsible for the compliance by their Bluetooth Products with any such laws and regulations and for obtaining any and all required authorizations, permits, or licenses for their Bluetooth products related to such regulations within the applicable jurisdictions. Each Member acknowledges that nothing in the Specification provides any information or assistance in connection with securing such compliance, authorizations or licenses. NOTHING IN THE SPECIFICATION CREATES ANY WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING SUCH LAWS OR REGULATIONS.
ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHTS OR FOR NONCOMPLIANCE WITH LAWS, RELATING TO USE OF THE SPECIFICATION IS EXPRESSLY DISCLAIMED. BY USE OF THE SPECIFICATION, EACH MEMBER EXPRESSLY WAIVES ANY CLAIM AGAINST BLUETOOTH SIG AND ITS PROMOTER MEMBERS RELATED TO USE OF THE SPECIFICATION.
Bluetooth SIG reserve the right to adopt any changes or alterations to the Specification as it deems necessary or appropriate.
Copyright © 2001–2011. Bluetooth® SIG, Inc. All copyrights in the Bluetooth Specifications themselves are owned by Ericsson AB, Lenovo (Singapore) Pte. Ltd., Intel Corporation, Microsoft Corporation, Motorola Mobility, Inc., Nokia Corporation and Toshiba Corporation.
*Other third-party brands and names are the property of their respective owners.
1. Introduction
The Immediate Alert service uses the Alert Level characteristic (as defined in [1]) to cause an alert when it is written with a value other than “No Alert.”
1.1. Conformance
If a device claims conformance to this service, all capabilities indicated as mandatory for this service shall be supported in the specified manner (process-mandatory). This also applies for all optional and conditional capabilities for which support is indicated. All mandatory capabilities, and optional and conditional capabilities for which support is indicated, are subject to verification as part of the Bluetooth qualification program.
1.2. Service Dependency
This service has no dependencies on other GATT-based services.
1.3. Bluetooth Specification Release Compatibility
This service is compatible with any Bluetooth Core Specification host [1] that includes the Generic Attribute Profile (GATT).
1.4. GATT Sub-Procedure Requirements
Additional GATT Sub-Procedure requirements beyond those required by the GATT are listed in Table 1.1:
GATT Sub-Procedure |
Requirement |
---|---|
Write Without Response |
M |
1.5. Transport Dependencies
This service shall operate over LE transport only.
1.6. Error Codes
This service does not define any application error codes that are used in Attribute Protocol.
2. Service Declaration
The Immediate Alert service shall be instantiated as a «Primary Service». The service UUID shall be set to «Immediate Alert».
The UUID value assigned to «Immediate Alert» is defined in [1].
There shall only be one instance of the Immediate Alert service on a device.
3. Service Characteristics
Characteristic |
Ref. |
Mandatory / Optional |
---|---|---|
Alert Level |
3.1 |
M |
The characteristic in Table 3.1 shall comply with the properties in Table 3.2.
Broadcast |
Read |
Write without Response |
Write |
Notify |
Indicate |
Signed Write |
Reliable Write |
Writable Auxiliaries |
|
---|---|---|---|---|---|---|---|---|---|
Alert Level |
X |
X |
M |
X |
X |
X |
X |
X |
X |
Requirements marked with ‘M’ are mandatory, ‘O’ are optional and ‘X’ are excluded (not permitted).
This service does not impose any security requirements.
There shall be only one instance of the Alert Level characteristic in an Immediate Alert service.
3.1. Alert Level
The Alert Level characteristic is a control point that allows a peer to command this device to alert to a given level.
3.1.1. Characteristic Behavior
The Alert Level characteristic can be written using the GATT Write Without Response sub-procedure with an alert level of either “No Alert," “Mild Alert," “High Alert," to set the written alert level.
4. Service Behaviors
4.1. Writing Alert Level Behavior
When the Alert Level characteristic is written the device shall start alerting to the written alert level.
If the written alert level is “No Alert," no alerting shall be done on this device.
If the written alert level is “Mild Alert," the device shall alert.
If the written alert level is “High Alert," the device shall alert in the strongest possible way.
The specific action that occurs in the device for the mild and high alerts is implementation specific. For example, this could include flashing lights, making noises, moving, or other methods to alert the user.
This alert continues until one of following conditions occurs:
-
An implementation specific timeout.
-
User interaction on this device.
-
A new alert level is written.
-
The physical link is disconnected.
5. Acronyms and Abbreviations
Abbreviation or Acronym |
Meaning |
---|---|
GATT |
Generic Attribute Profile |
LE |
Low Energy |
UUID |
Universally Unique Identifier |
6. References
[1] Bluetooth v4.0 Core Specification
[1] Characteristic and Descriptor descriptions are accessible via the Bluetooth SIG Assigned Numbers web page.