btleplug 0.12.0

A Cross-Platform Rust Bluetooth Low Energy (BLE) GATT library.
Documentation 
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

#include <zephyr/bluetooth/bluetooth.h>
#include <zephyr/bluetooth/gatt.h>

#include "gatt_profile.h"

/* Forward declarations for callbacks in test_handlers.c */
extern ssize_t read_static(struct bt_conn *, const struct bt_gatt_attr *,
                           void *, uint16_t, uint16_t);
extern ssize_t read_counter(struct bt_conn *, const struct bt_gatt_attr *,
                            void *, uint16_t, uint16_t);
extern ssize_t write_with_resp(struct bt_conn *, const struct bt_gatt_attr *,
                               const void *, uint16_t, uint16_t, uint8_t);
extern ssize_t write_without_resp(struct bt_conn *, const struct bt_gatt_attr *,
                                  const void *, uint16_t, uint16_t, uint8_t);
extern ssize_t read_rw(struct bt_conn *, const struct bt_gatt_attr *,
                       void *, uint16_t, uint16_t);
extern ssize_t write_rw(struct bt_conn *, const struct bt_gatt_attr *,
                        const void *, uint16_t, uint16_t, uint8_t);
extern ssize_t read_long_value(struct bt_conn *, const struct bt_gatt_attr *,
                               void *, uint16_t, uint16_t);
extern ssize_t write_long_value(struct bt_conn *, const struct bt_gatt_attr *,
                                const void *, uint16_t, uint16_t, uint8_t);
extern ssize_t read_descriptor_test_char(struct bt_conn *,
                                         const struct bt_gatt_attr *,
                                         void *, uint16_t, uint16_t);
extern ssize_t read_ro_descriptor(struct bt_conn *, const struct bt_gatt_attr *,
                                  void *, uint16_t, uint16_t);
extern ssize_t read_rw_descriptor(struct bt_conn *, const struct bt_gatt_attr *,
                                  void *, uint16_t, uint16_t);
extern ssize_t write_rw_descriptor(struct bt_conn *, const struct bt_gatt_attr *,
                                   const void *, uint16_t, uint16_t, uint8_t);
extern void notify_ccc_changed(const struct bt_gatt_attr *, uint16_t);
extern void indicate_ccc_changed(const struct bt_gatt_attr *, uint16_t);
extern void configurable_notify_ccc_changed(const struct bt_gatt_attr *, uint16_t);

/* Forward declaration for control point write handler */
extern ssize_t write_control_point(struct bt_conn *, const struct bt_gatt_attr *,
                                   const void *, uint16_t, uint16_t, uint8_t);
extern void control_response_ccc_changed(const struct bt_gatt_attr *, uint16_t);

/* ============================================================
 * Service 1: Control Service
 * ============================================================ */
BT_GATT_SERVICE_DEFINE(control_svc,
    BT_GATT_PRIMARY_SERVICE(BT_UUID_CONTROL_SERVICE),
    /* Control Point — Write */
    BT_GATT_CHARACTERISTIC(BT_UUID_CONTROL_POINT,
        BT_GATT_CHRC_WRITE,
        BT_GATT_PERM_WRITE,
        NULL, write_control_point, NULL),
    /* Control Response — Notify */
    BT_GATT_CHARACTERISTIC(BT_UUID_CONTROL_RESPONSE,
        BT_GATT_CHRC_NOTIFY,
        BT_GATT_PERM_NONE,
        NULL, NULL, NULL),
    BT_GATT_CCC(control_response_ccc_changed,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE),
);

/* ============================================================
 * Service 2: Read/Write Test Service
 * ============================================================ */
BT_GATT_SERVICE_DEFINE(rw_svc,
    BT_GATT_PRIMARY_SERVICE(BT_UUID_RW_SERVICE),
    /* Static Read */
    BT_GATT_CHARACTERISTIC(BT_UUID_STATIC_READ,
        BT_GATT_CHRC_READ,
        BT_GATT_PERM_READ,
        read_static, NULL, NULL),
    /* Counter Read */
    BT_GATT_CHARACTERISTIC(BT_UUID_COUNTER_READ,
        BT_GATT_CHRC_READ,
        BT_GATT_PERM_READ,
        read_counter, NULL, NULL),
    /* Write With Response */
    BT_GATT_CHARACTERISTIC(BT_UUID_WRITE_WITH_RESP,
        BT_GATT_CHRC_WRITE,
        BT_GATT_PERM_WRITE,
        NULL, write_with_resp, NULL),
    /* Write Without Response */
    BT_GATT_CHARACTERISTIC(BT_UUID_WRITE_WITHOUT_RESP,
        BT_GATT_CHRC_WRITE_WITHOUT_RESP,
        BT_GATT_PERM_WRITE,
        NULL, write_without_resp, NULL),
    /* Read/Write */
    BT_GATT_CHARACTERISTIC(BT_UUID_READ_WRITE,
        BT_GATT_CHRC_READ | BT_GATT_CHRC_WRITE,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE,
        read_rw, write_rw, NULL),
    /* Long Value (512 bytes) */
    BT_GATT_CHARACTERISTIC(BT_UUID_LONG_VALUE,
        BT_GATT_CHRC_READ | BT_GATT_CHRC_WRITE,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE,
        read_long_value, write_long_value, NULL),
);

/* ============================================================
 * Service 3: Notification Test Service
 * ============================================================ */
BT_GATT_SERVICE_DEFINE(notify_svc,
    BT_GATT_PRIMARY_SERVICE(BT_UUID_NOTIFY_SERVICE),
    /* Notify Char */
    BT_GATT_CHARACTERISTIC(BT_UUID_NOTIFY_CHAR,
        BT_GATT_CHRC_NOTIFY,
        BT_GATT_PERM_NONE,
        NULL, NULL, NULL),
    BT_GATT_CCC(notify_ccc_changed,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE),
    /* Indicate Char */
    BT_GATT_CHARACTERISTIC(BT_UUID_INDICATE_CHAR,
        BT_GATT_CHRC_INDICATE,
        BT_GATT_PERM_NONE,
        NULL, NULL, NULL),
    BT_GATT_CCC(indicate_ccc_changed,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE),
    /* Configurable Notify */
    BT_GATT_CHARACTERISTIC(BT_UUID_CONFIGURABLE_NOTIFY,
        BT_GATT_CHRC_NOTIFY,
        BT_GATT_PERM_NONE,
        NULL, NULL, NULL),
    BT_GATT_CCC(configurable_notify_ccc_changed,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE),
);

/* ============================================================
 * Service 4: Descriptor Test Service
 * ============================================================ */
BT_GATT_SERVICE_DEFINE(descriptor_svc,
    BT_GATT_PRIMARY_SERVICE(BT_UUID_DESCRIPTOR_SERVICE),
    /* Descriptor Test Char — Read, with custom descriptors */
    BT_GATT_CHARACTERISTIC(BT_UUID_DESCRIPTOR_TEST_CHAR,
        BT_GATT_CHRC_READ,
        BT_GATT_PERM_READ,
        read_descriptor_test_char, NULL, NULL),
    /* Read-Only Descriptor */
    BT_GATT_DESCRIPTOR(BT_UUID_READ_ONLY_DESCRIPTOR,
        BT_GATT_PERM_READ,
        read_ro_descriptor, NULL, NULL),
    /* Read/Write Descriptor */
    BT_GATT_DESCRIPTOR(BT_UUID_RW_DESCRIPTOR,
        BT_GATT_PERM_READ | BT_GATT_PERM_WRITE,
        read_rw_descriptor, write_rw_descriptor, NULL),
);