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 "bt_types.h" 24 25 static const char BTSNOOP_MODULE[] = "btsnoop_module"; 26 27 typedef struct btsnoop_t { 28 // Capture |packet| and dump it to the btsnoop logs. If |is_received| is 29 // true, the packet is marked as incoming. Otherwise, the packet is marked 30 // as outgoing. 31 void (*capture)(const BT_HDR* packet, bool is_received); 32 33 // Set a L2CAP channel as whitelisted, allowing packets with that L2CAP CID 34 // to show up in the snoop logs. 35 void (*whitelist_l2c_channel)(uint16_t conn_handle, uint16_t local_cid, 36 uint16_t remote_cid); 37 38 // Set a RFCOMM dlci as whitelisted, allowing packets with that RFCOMM CID 39 // to show up in the snoop logs. The local_cid is used to associate it with 40 // its corrisponding ACL connection. The dlci is the channel with direction 41 // so there is no chance of a collision if two services are using the same 42 // channel but in different directions. 43 void (*whitelist_rfc_dlci)(uint16_t local_cid, uint8_t dlci); 44 45 // Indicate that the provided L2CAP channel is being used for RFCOMM. 46 // If packets with the provided L2CAP CID are encountered, they will be 47 // filtered on RFCOMM based on channels provided to |filter_rfc_channel|. 48 void (*add_rfc_l2c_channel)(uint16_t conn_handle, uint16_t local_cid, 49 uint16_t remote_cid); 50 51 // Clear an L2CAP channel from being filtered. 52 void (*clear_l2cap_whitelist)(uint16_t conn_handle, uint16_t local_cid, 53 uint16_t remote_cid); 54 } btsnoop_t; 55 56 const btsnoop_t* btsnoop_get_interface(void); 57