User guide

Silicon Labs Page of 3 21
Table of Contents
1 Version history _________________________________________________________________________ 4
2 Introduction ___________________________________________________________________________ 5
2.1 Understanding Profile, Services, Characteristics and the Attribute Protocol _____________________ 5
2.1.1 GATT-Based Bluetooth Profiles ________________________________________________ 5
2.1.2 Services ___________________________________________________________________ 5
2.1.3 Characteristics ______________________________________________________________ 5
2.1.4 The Attribute Protocol ________________________________________________________ 6
2.1.5 The Profile Toolkit ___________________________________________________________ 7
3 GATT Database file (gatt.xml) _____________________________________________________________ 8
3.1 Generic GATT Limitations ___________________________________________________________ 8
3.2 Defining Services __________________________________________________________________ 9
3.2.1 <service>: Service Definition element ____________________________________________ 9
3.2.2 <description> : Service Description element ______________________________________ 10
3.2.3 <include> : Service Include element ____________________________________________ 10
3.3 Defining Characteristics ____________________________________________________________ 11
3.3.1 <characteristic> : Characteristic Definition element ________________________________ 11
3.3.2 <properties> : Characteristic Properties element __________________________________ 12
3.3.3 <value> : Characteristic Value Definition element __________________________________ 14
3.3.4 <description> : Characteristic User Description element ____________________________ 16
3.3.5 <aggregate> : Characteristic Aggregated Format Definition element ___________________ 16
3.3.6 <descriptor> : Characteristic Descriptor Definition element __________________________ 16
3.3.7 Notes ____________________________________________________________________ 17
3.4 Examples _______________________________________________________________________ 18