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 #include <cstdint> 23 24 #include "stack/include/bt_hdr.h" 25 26 static const char BTSNOOP_MODULE[] = "btsnoop_module"; 27 28 typedef struct btsnoop_t { 29 // Capture |packet| and dump it to the btsnoop logs. If |is_received| is 30 // true, the packet is marked as incoming. Otherwise, the packet is marked 31 // as outgoing. 32 void (*capture)(const BT_HDR* packet, bool is_received); 33 34 // Set a L2CAP channel as allowlisted, allowing packets with that L2CAP CID 35 // to show up in the snoop logs. 36 void (*allowlist_l2c_channel)(uint16_t conn_handle, uint16_t local_cid, 37 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, 50 uint16_t remote_cid); 51 52 // Clear an L2CAP channel from being filtered. 53 void (*clear_l2cap_allowlist)(uint16_t conn_handle, uint16_t local_cid, 54 uint16_t remote_cid); 55 } btsnoop_t; 56 57 const btsnoop_t* btsnoop_get_interface(void); 58