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 | [ | 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 | [ | 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 | [ | Use Write Without Response | |
| long | [ | Use Long Write procedure | |
| attr | [UINT16] | Attribute handle | |
| offset | [UINT16] | Long write offset value | |
| value | XX:XX:XX… | Data to write | 
