xref: /nrf52832-nimble/packages/NimBLE-latest/docs/ble_hs/ble_att.rst (revision 042d53a763ad75cb1465103098bb88c245d95138)
1NimBLE Host ATT Client Reference
2--------------------------------
3
4Introduction
5~~~~~~~~~~~~
6
7The Attribute Protocol (ATT) is a mid-level protocol that all BLE devices use to exchange data. Data is exchanged when
8an ATT client reads or writes an attribute belonging to an ATT server. Any device that needs to send or receive data
9must support both the client and server functionality of the ATT protocol. The only devices which do not support ATT
10are the most basic ones: broadcasters and observers (i.e., beaconing devices and listening devices).
11
12Most ATT functionality is not interesting to an application. Rather than use ATT directly, an application uses the
13higher level GATT profile, which sits directly above ATT in the host. NimBLE exposes the few bits of ATT functionality
14which are not encompassed by higher level GATT functions. This section documents the ATT functionality that the NimBLE
15host exposes to the application.
16
17API
18~~~~~~
19
20.. doxygengroup:: bt_host
21    :content-only:
22    :members:
23