1/*
2 * Copyright (C) 2013 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17
18#ifndef ANDROID_INCLUDE_BT_GATT_SERVER_H
19#define ANDROID_INCLUDE_BT_GATT_SERVER_H
20
21#include <stdint.h>
22
23#include "bt_gatt_types.h"
24
25__BEGIN_DECLS
26
27/** GATT value type used in response to remote read requests */
28typedef struct
29{
30    uint8_t           value[BTGATT_MAX_ATTR_LEN];
31    uint16_t          handle;
32    uint16_t          offset;
33    uint16_t          len;
34    uint8_t           auth_req;
35} btgatt_value_t;
36
37/** GATT remote read request response type */
38typedef union
39{
40    btgatt_value_t attr_value;
41    uint16_t            handle;
42} btgatt_response_t;
43
44/** BT-GATT Server callback structure. */
45
46/** Callback invoked in response to register_server */
47typedef void (*register_server_callback)(int status, int server_if,
48                bt_uuid_t *app_uuid);
49
50/** Callback indicating that a remote device has connected or been disconnected */
51typedef void (*connection_callback)(int conn_id, int server_if, int connected,
52                                    bt_bdaddr_t *bda);
53
54/** Callback invoked in response to create_service */
55typedef void (*service_added_callback)(int status, int server_if,
56                btgatt_srvc_id_t *srvc_id, int srvc_handle);
57
58/** Callback indicating that an included service has been added to a service */
59typedef void (*included_service_added_callback)(int status, int server_if,
60                int srvc_handle, int incl_srvc_handle);
61
62/** Callback invoked when a characteristic has been added to a service */
63typedef void (*characteristic_added_callback)(int status, int server_if,
64                bt_uuid_t *uuid, int srvc_handle, int char_handle);
65
66/** Callback invoked when a descriptor has been added to a characteristic */
67typedef void (*descriptor_added_callback)(int status, int server_if,
68                bt_uuid_t *uuid, int srvc_handle, int descr_handle);
69
70/** Callback invoked in response to start_service */
71typedef void (*service_started_callback)(int status, int server_if,
72                                         int srvc_handle);
73
74/** Callback invoked in response to stop_service */
75typedef void (*service_stopped_callback)(int status, int server_if,
76                                         int srvc_handle);
77
78/** Callback triggered when a service has been deleted */
79typedef void (*service_deleted_callback)(int status, int server_if,
80                                         int srvc_handle);
81
82/**
83 * Callback invoked when a remote device has requested to read a characteristic
84 * or descriptor. The application must respond by calling send_response
85 */
86typedef void (*request_read_callback)(int conn_id, int trans_id, bt_bdaddr_t *bda,
87                                      int attr_handle, int offset, bool is_long);
88
89/**
90 * Callback invoked when a remote device has requested to write to a
91 * characteristic or descriptor.
92 */
93typedef void (*request_write_callback)(int conn_id, int trans_id, bt_bdaddr_t *bda,
94                                       int attr_handle, int offset, int length,
95                                       bool need_rsp, bool is_prep, uint8_t* value);
96
97/** Callback invoked when a previously prepared write is to be executed */
98typedef void (*request_exec_write_callback)(int conn_id, int trans_id,
99                                            bt_bdaddr_t *bda, int exec_write);
100
101/**
102 * Callback triggered in response to send_response if the remote device
103 * sends a confirmation.
104 */
105typedef void (*response_confirmation_callback)(int status, int handle);
106
107typedef struct {
108    register_server_callback        register_server_cb;
109    connection_callback             connection_cb;
110    service_added_callback          service_added_cb;
111    included_service_added_callback included_service_added_cb;
112    characteristic_added_callback   characteristic_added_cb;
113    descriptor_added_callback       descriptor_added_cb;
114    service_started_callback        service_started_cb;
115    service_stopped_callback        service_stopped_cb;
116    service_deleted_callback        service_deleted_cb;
117    request_read_callback           request_read_cb;
118    request_write_callback          request_write_cb;
119    request_exec_write_callback     request_exec_write_cb;
120    response_confirmation_callback  response_confirmation_cb;
121} btgatt_server_callbacks_t;
122
123/** Represents the standard BT-GATT server interface. */
124typedef struct {
125    /** Registers a GATT server application with the stack */
126    bt_status_t (*register_server)( bt_uuid_t *uuid );
127
128    /** Unregister a server application from the stack */
129    bt_status_t (*unregister_server)(int server_if );
130
131    /** Create a connection to a remote peripheral */
132    bt_status_t (*connect)(int server_if, const bt_bdaddr_t *bd_addr, bool is_direct );
133
134    /** Disconnect an established connection or cancel a pending one */
135    bt_status_t (*disconnect)(int server_if, const bt_bdaddr_t *bd_addr,
136                    int conn_id );
137
138    /** Create a new service */
139    bt_status_t (*add_service)( int server_if, btgatt_srvc_id_t *srvc_id, int num_handles);
140
141    /** Assign an included service to it's parent service */
142    bt_status_t (*add_included_service)( int server_if, int service_handle, int included_handle);
143
144    /** Add a characteristic to a service */
145    bt_status_t (*add_characteristic)( int server_if,
146                    int service_handle, bt_uuid_t *uuid,
147                    int properties, int permissions);
148
149    /** Add a descriptor to a given service */
150    bt_status_t (*add_descriptor)(int server_if, int service_handle,
151                                  bt_uuid_t *uuid, int permissions);
152
153    /** Starts a local service */
154    bt_status_t (*start_service)(int server_if, int service_handle,
155                                 int transport);
156
157    /** Stops a local service */
158    bt_status_t (*stop_service)(int server_if, int service_handle);
159
160    /** Delete a local service */
161    bt_status_t (*delete_service)(int server_if, int service_handle);
162
163    /** Send value indication to a remote device */
164    bt_status_t (*send_indication)(int server_if, int attribute_handle,
165                                   int conn_id, int len, int confirm,
166                                   char* p_value);
167
168    /** Send a response to a read/write operation */
169    bt_status_t (*send_response)(int conn_id, int trans_id,
170                                 int status, btgatt_response_t *response);
171} btgatt_server_interface_t;
172
173__END_DECLS
174
175#endif /* ANDROID_INCLUDE_BT_GATT_CLIENT_H */
176