1 /******************************************************************************
2  *
3  *  Copyright 2014 Google, Inc.
4  *
5  *  Licensed under the Apache License, Version 2.0 (the "License");
6  *  you may not use this file except in compliance with the License.
7  *  You may obtain a copy of the License at:
8  *
9  *  http://www.apache.org/licenses/LICENSE-2.0
10  *
11  *  Unless required by applicable law or agreed to in writing, software
12  *  distributed under the License is distributed on an "AS IS" BASIS,
13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  *  See the License for the specific language governing permissions and
15  *  limitations under the License.
16  *
17  ******************************************************************************/
18 
19 #pragma once
20 
21 #include <stdbool.h>
22 
23 #include <cstdint>
24 
25 #include "stack/include/bt_hdr.h"
26 
27 static const char BTSNOOP_MODULE[] = "btsnoop_module";
28 
29 typedef struct btsnoop_t {
30   // Capture |packet| and dump it to the btsnoop logs. If |is_received| is
31   // true, the packet is marked as incoming. Otherwise, the packet is marked
32   // as outgoing.
33   void (*capture)(const BT_HDR* packet, bool is_received);
34 
35   // Set a L2CAP channel as allowlisted, allowing packets with that L2CAP CID
36   // to show up in the snoop logs.
37   void (*allowlist_l2c_channel)(uint16_t conn_handle, uint16_t local_cid, uint16_t remote_cid);
38 
39   // Set a RFCOMM dlci as allowlisted, allowing packets with that RFCOMM CID
40   // to show up in the snoop logs. The local_cid is used to associate it with
41   // its corrisponding ACL connection. The dlci is the channel with direction
42   // so there is no chance of a collision if two services are using the same
43   // channel but in different directions.
44   void (*allowlist_rfc_dlci)(uint16_t local_cid, uint8_t dlci);
45 
46   // Indicate that the provided L2CAP channel is being used for RFCOMM.
47   // If packets with the provided L2CAP CID are encountered, they will be
48   // filtered on RFCOMM based on channels provided to |filter_rfc_channel|.
49   void (*add_rfc_l2c_channel)(uint16_t conn_handle, uint16_t local_cid, uint16_t remote_cid);
50 
51   // Clear an L2CAP channel from being filtered.
52   void (*clear_l2cap_allowlist)(uint16_t conn_handle, uint16_t local_cid, uint16_t remote_cid);
53 } btsnoop_t;
54 
55 const btsnoop_t* btsnoop_get_interface(void);
56