blob: 0fe465fe5b075f2068249859ccec4603718ec4e5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
GATT feature API for btshell
============================
GATT(GENERIC ATTRIBUTE PROFILE) describes a service framework using the Attribute Protocol for discovering services,
and for reading and writing characteristic values on a peer device. There are 11 features defined in the GATT Profile,
and each of the features is mapped to procedures and sub-procedures:
Available commands
~~~~~~~~~~~~~~~~~~
Parameters default values (if applicable) are marked red.
Configuration
-------------
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **Command** | **Parmeters** | \*\* Possible values\*\* | **Description** |
+====================================+=================+============================+===========================================================+
| **gatt-discover-characteristic** | | | Discover GATT characteristics |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | uuid | [UINT16] | Characteristic UUID |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | start | [UINT16] | Discovery start handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | end | [UINT16] | Discovery end handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-discover-descriptor** | | | Discover GATT descriptors |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | start | [UINT16] | Discovery start handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | end | [UINT16] | Discovery end handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-discover-service** | | | Discover services |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | uuid16 | [UINT16] | Service UUID |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-discover-full** | | | Discover services, characteristic and descriptors |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-find-included-services** | | | Find included services |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | start | [UINT16] | Discovery start handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | end | [UINT16] | Discovery end handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-exchange-mtu** | | | Initiate ATT MTU exchange procedure |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-read** | | | Read attribute |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | long | [``0``-1] | Long read |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | attr | [UINT16] | Attribute handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | offset | [UINT16] | Long read offset value |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | uuid | [UINT16] | Characteristic UUID |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | start | [UINT16] | Discovery start handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | end | [UINT16] | Discovery end handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-notify** | | | Send notification or indication to all subscribed peers |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | attr | [UINT16] | Attribute handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-service-changed** | | | Send Services Changed notification |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | start | [UINT16] | Start handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | end | [UINT16] | End handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-service-visibility** | | | Set service visibility |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | handle | [UINT16] | Service handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | visibility | [``0``-1] | Service visibility |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-show** | | | Show remote devices discovered databases structure |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-show-local** | | | Show local database structure |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| **gatt-write** | | | Write attribute |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | conn | [UINT16] | Connection handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | no\_rsp | [``0``-1] | Use Write Without Response |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | long | [``0``-1] | Use Long Write procedure |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | attr | [UINT16] | Attribute handle |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | offset | [UINT16] | Long write offset value |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
| | value | XX:XX:XX... | Data to write |
+------------------------------------+-----------------+----------------------------+-----------------------------------------------------------+
|