1 /* 2 * Copyright (C) 2014-2020 BlueKitchen GmbH 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. Neither the name of the copyright holders nor the names of 14 * contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 4. Any redistribution, use, or modification is done solely for 17 * personal benefit and not for any commercial purpose or for 18 * monetary gain. 19 * 20 * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 23 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BLUEKITCHEN 24 * GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 26 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 27 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 30 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31 * SUCH DAMAGE. 32 * 33 * Please inquire about commercial licensing options at 34 * [email protected] 35 * 36 */ 37 38 #define BTSTACK_FILE__ "hci_dump_posix_fs.c" 39 40 /* 41 * hci_dump_posix_fs.c 42 * 43 * Dump HCI trace in various formats into a file: 44 * 45 * - BlueZ's hcidump format 46 * - Apple's PacketLogger 47 * - stdout hexdump 48 * 49 */ 50 51 #include "btstack_config.h" 52 53 // enable POSIX functions (needed for -std=c99) 54 #define _POSIX_C_SOURCE 200809 55 56 #include "hci_dump_posix_fs.h" 57 58 #include "btstack_debug.h" 59 #include "btstack_util.h" 60 #include "hci_cmd.h" 61 62 #include <time.h> 63 #include <stdio.h> // printf 64 #include <fcntl.h> // open 65 #include <unistd.h> // write 66 #include <errno.h> // errno 67 #include <sys/time.h> // for timestamps 68 #include <sys/stat.h> // file modes 69 70 static int dump_file = -1; 71 static int dump_format; 72 static char log_message_buffer[256]; 73 74 static void hci_dump_posix_fs_reset(void){ 75 btstack_assert(dump_file >= 0); 76 (void) lseek(dump_file, 0, SEEK_SET); 77 int err = ftruncate(dump_file, 0); 78 UNUSED(err); 79 } 80 81 // provide summary for ISO Data Packets if not supported by fileformat/viewer yet 82 static uint16_t hci_dump_iso_summary(uint8_t in, uint8_t *packet, uint16_t len){ 83 uint16_t conn_handle = little_endian_read_16(packet, 0) & 0xfff; 84 uint8_t pb = (packet[1] >> 4) & 3; 85 uint8_t ts = (packet[1] >> 6) & 1; 86 uint16_t pos = 4; 87 uint32_t time_stamp = 0; 88 if (ts){ 89 time_stamp = little_endian_read_32(packet, pos); 90 pos += 4; 91 } 92 uint16_t packet_sequence = little_endian_read_16(packet, pos); 93 pos += 2; 94 uint16_t iso_sdu_len = little_endian_read_16(packet, pos); 95 uint8_t packet_status_flag = packet[pos+1] >> 6; 96 return snprintf(log_message_buffer,sizeof(log_message_buffer), "ISO %s, handle %04x, pb %u, ts 0x%08x, sequence 0x%04x, packet status %u, iso len %u", 97 in ? "IN" : "OUT", conn_handle, pb, time_stamp, packet_sequence, packet_status_flag, iso_sdu_len); 98 } 99 100 static void hci_dump_posix_fs_log_packet(uint8_t packet_type, uint8_t in, uint8_t *packet, uint16_t len) { 101 if (dump_file < 0) return; 102 103 static union { 104 uint8_t header_bluez[HCI_DUMP_HEADER_SIZE_BLUEZ]; 105 uint8_t header_packetlogger[HCI_DUMP_HEADER_SIZE_PACKETLOGGER]; 106 uint8_t header_btsnoop[HCI_DUMP_HEADER_SIZE_BTSNOOP+1]; 107 } header; 108 109 uint32_t tv_sec = 0; 110 uint32_t tv_us = 0; 111 uint64_t ts_usec; 112 113 // get time 114 struct timeval curr_time; 115 gettimeofday(&curr_time, NULL); 116 tv_sec = curr_time.tv_sec; 117 tv_us = curr_time.tv_usec; 118 119 uint16_t header_len = 0; 120 switch (dump_format){ 121 case HCI_DUMP_BLUEZ: 122 // ISO packets not supported 123 if (packet_type == HCI_ISO_DATA_PACKET){ 124 len = hci_dump_iso_summary(in, packet, len); 125 packet_type = LOG_MESSAGE_PACKET; 126 packet = (uint8_t*) log_message_buffer; 127 } 128 hci_dump_setup_header_bluez(header.header_bluez, tv_sec, tv_us, packet_type, in, len); 129 header_len = HCI_DUMP_HEADER_SIZE_BLUEZ; 130 break; 131 case HCI_DUMP_PACKETLOGGER: 132 // ISO packets not supported 133 if (packet_type == HCI_ISO_DATA_PACKET){ 134 len = hci_dump_iso_summary(in, packet, len); 135 packet_type = LOG_MESSAGE_PACKET; 136 packet = (uint8_t*) log_message_buffer; 137 } 138 hci_dump_setup_header_packetlogger(header.header_packetlogger, tv_sec, tv_us, packet_type, in, len); 139 header_len = HCI_DUMP_HEADER_SIZE_PACKETLOGGER; 140 break; 141 case HCI_DUMP_BTSNOOP: 142 // log messages not supported 143 if (packet_type == LOG_MESSAGE_PACKET) return; 144 ts_usec = 0xdcddb30f2f8000LLU + 1000000LLU * curr_time.tv_sec + curr_time.tv_usec; 145 // append packet type to pcap header 146 hci_dump_setup_header_btsnoop(header.header_btsnoop, ts_usec >> 32, ts_usec & 0xFFFFFFFF, 0, packet_type, in, len+1); 147 header.header_btsnoop[HCI_DUMP_HEADER_SIZE_BTSNOOP] = packet_type; 148 header_len = HCI_DUMP_HEADER_SIZE_BTSNOOP + 1; 149 break; 150 default: 151 btstack_unreachable(); 152 return; 153 } 154 155 ssize_t bytes_written; 156 bytes_written = write(dump_file, &header, header_len); 157 UNUSED(bytes_written); 158 bytes_written = write(dump_file, packet, len ); 159 UNUSED(bytes_written); 160 } 161 162 static void hci_dump_posix_fs_log_message(const char * format, va_list argptr){ 163 if (dump_file < 0) return; 164 int len = vsnprintf(log_message_buffer, sizeof(log_message_buffer), format, argptr); 165 hci_dump_posix_fs_log_packet(LOG_MESSAGE_PACKET, 0, (uint8_t*) log_message_buffer, len); 166 } 167 168 // returns system errno 169 int hci_dump_posix_fs_open(const char *filename, hci_dump_format_t format){ 170 btstack_assert(format == HCI_DUMP_BLUEZ || format == HCI_DUMP_PACKETLOGGER || format == HCI_DUMP_BTSNOOP); 171 172 dump_format = format; 173 int oflags = O_WRONLY | O_CREAT | O_TRUNC; 174 #ifdef _WIN32 175 oflags |= O_BINARY; 176 #endif 177 dump_file = open(filename, oflags, S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH ); 178 if (dump_file < 0){ 179 printf("failed to open file %s, errno = %d\n", filename, errno); 180 return errno; 181 } 182 183 if (format == HCI_DUMP_BTSNOOP){ 184 // write BTSnoop file header 185 const uint8_t file_header[] = { 186 // Identification Pattern: "btsnoop\0" 187 0x62, 0x74, 0x73, 0x6E, 0x6F, 0x6F, 0x70, 0x00, 188 // Version: 1 189 0x00, 0x00, 0x00, 0x01, 190 // Datalink Type: 1002 - H4 191 0x00, 0x00, 0x03, 0xEA, 192 }; 193 ssize_t bytes_written = write(dump_file, &file_header, sizeof(file_header)); 194 UNUSED(bytes_written); 195 } 196 return 0; 197 } 198 199 void hci_dump_posix_fs_close(void){ 200 close(dump_file); 201 dump_file = -1; 202 } 203 204 const hci_dump_t * hci_dump_posix_fs_get_instance(void){ 205 static const hci_dump_t hci_dump_instance = { 206 // void (*reset)(void); 207 &hci_dump_posix_fs_reset, 208 // void (*log_packet)(uint8_t packet_type, uint8_t in, uint8_t *packet, uint16_t len); 209 &hci_dump_posix_fs_log_packet, 210 // void (*log_message)(int log_level, const char * format, va_list argptr); 211 &hci_dump_posix_fs_log_message, 212 }; 213 return &hci_dump_instance; 214 } 215