Zephyr API Documentation  3.7.0-rc3
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
att.h
Go to the documentation of this file.
1
5/*
6 * Copyright (c) 2016 Intel Corporation
7 *
8 * SPDX-License-Identifier: Apache-2.0
9 */
10#ifndef ZEPHYR_INCLUDE_BLUETOOTH_ATT_H_
11#define ZEPHYR_INCLUDE_BLUETOOTH_ATT_H_
12
20#include <zephyr/sys/slist.h>
22
23#ifdef __cplusplus
24extern "C" {
25#endif
26
27/* Error codes for Error response PDU
28 *
29 * Defined by The Bluetooth Core Specification, Version 5.4, Vol 3, Part F, Section 3.4.1.1
30 */
32#define BT_ATT_ERR_SUCCESS 0x00
34#define BT_ATT_ERR_INVALID_HANDLE 0x01
36#define BT_ATT_ERR_READ_NOT_PERMITTED 0x02
38#define BT_ATT_ERR_WRITE_NOT_PERMITTED 0x03
40#define BT_ATT_ERR_INVALID_PDU 0x04
42#define BT_ATT_ERR_AUTHENTICATION 0x05
44#define BT_ATT_ERR_NOT_SUPPORTED 0x06
46#define BT_ATT_ERR_INVALID_OFFSET 0x07
48#define BT_ATT_ERR_AUTHORIZATION 0x08
50#define BT_ATT_ERR_PREPARE_QUEUE_FULL 0x09
52#define BT_ATT_ERR_ATTRIBUTE_NOT_FOUND 0x0a
54#define BT_ATT_ERR_ATTRIBUTE_NOT_LONG 0x0b
56#define BT_ATT_ERR_ENCRYPTION_KEY_SIZE 0x0c
58#define BT_ATT_ERR_INVALID_ATTRIBUTE_LEN 0x0d
64#define BT_ATT_ERR_UNLIKELY 0x0e
66#define BT_ATT_ERR_INSUFFICIENT_ENCRYPTION 0x0f
73#define BT_ATT_ERR_UNSUPPORTED_GROUP_TYPE 0x10
75#define BT_ATT_ERR_INSUFFICIENT_RESOURCES 0x11
77#define BT_ATT_ERR_DB_OUT_OF_SYNC 0x12
79#define BT_ATT_ERR_VALUE_NOT_ALLOWED 0x13
80
81/* Common Profile Error Codes
82 *
83 * Defined by the Supplement to the Bluetooth Core Specification (CSS), v11, Part B, Section 1.2.
84 */
86#define BT_ATT_ERR_WRITE_REQ_REJECTED 0xfc
88#define BT_ATT_ERR_CCC_IMPROPER_CONF 0xfd
90#define BT_ATT_ERR_PROCEDURE_IN_PROGRESS 0xfe
92#define BT_ATT_ERR_OUT_OF_RANGE 0xff
93
94/* Version 5.2, Vol 3, Part F, 3.2.9 defines maximum attribute length to 512 */
95#define BT_ATT_MAX_ATTRIBUTE_LEN 512
96
97/* Handle 0x0000 is reserved for future use */
98#define BT_ATT_FIRST_ATTRIBUTE_HANDLE 0x0001
99/* 0xffff is defined as the maximum, and thus last, valid attribute handle */
100#define BT_ATT_LAST_ATTRIBUTE_HANDLE 0xffff
101
118#if defined(CONFIG_BT_ATT_ERR_TO_STR)
119const char *bt_att_err_to_str(uint8_t att_err);
120#else
121static inline const char *bt_att_err_to_str(uint8_t att_err)
122{
123 ARG_UNUSED(att_err);
124
125 return "";
126}
127#endif
128
129#if defined(CONFIG_BT_EATT)
130#if defined(CONFIG_BT_TESTING)
131
132int bt_eatt_disconnect_one(struct bt_conn *conn);
133
134/* Reconfigure all EATT channels on connection */
135int bt_eatt_reconfigure(struct bt_conn *conn, uint16_t mtu);
136
137#endif /* CONFIG_BT_TESTING */
138
154int bt_eatt_connect(struct bt_conn *conn, size_t num_channels);
155
163size_t bt_eatt_count(struct bt_conn *conn);
164
165#endif /* CONFIG_BT_EATT */
166
178};
179
180#ifdef __cplusplus
181}
182#endif
183
188#endif /* ZEPHYR_INCLUDE_BLUETOOTH_ATT_H_ */
Bluetooth connection handling.
size_t bt_eatt_count(struct bt_conn *conn)
Get number of EATT channels connected.
int bt_eatt_connect(struct bt_conn *conn, size_t num_channels)
Connect Enhanced ATT channels.
bt_att_chan_opt
ATT channel option bit field values.
Definition: att.h:171
static const char * bt_att_err_to_str(uint8_t att_err)
Converts a ATT error to string.
Definition: att.h:121
@ BT_ATT_CHAN_OPT_NONE
Both Enhanced and Unenhanced channels can be used
Definition: att.h:173
@ BT_ATT_CHAN_OPT_UNENHANCED_ONLY
Only Unenhanced channels will be used
Definition: att.h:175
@ BT_ATT_CHAN_OPT_ENHANCED_ONLY
Only Enhanced channels will be used
Definition: att.h:177
#define BIT(n)
Unsigned integer with bit position n set (signed in assembly language).
Definition: util_macro.h:44
__UINT8_TYPE__ uint8_t
Definition: stdint.h:88
__UINT16_TYPE__ uint16_t
Definition: stdint.h:89