xref: /btstack/platform/embedded/hci_dump_segger_rtt_binary.c (revision cbf509016daa1295a6a8b22d7314db50b88c6c9a)
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_segger_rtt_binary.c"
39 
40 /**
41  * Dump HCI trace on SEGGER RTT Logging Channel #1
42  */
43 #include "btstack_config.h"
44 
45 #include "hci_dump_segger_rtt_binary.h"
46 
47 #include "btstack_debug.h"
48 #include "hci.h"
49 
50 #include "SEGGER_RTT.h"
51 
52 #include <stdio.h>  // vsnprintf
53 
54 // allow to configure mode, channel, up buffer size in btstack_config.h
55 #ifndef SEGGER_RTT_PACKETLOG_MODE
56 #define SEGGER_RTT_PACKETLOG_MODE SEGGER_RTT_MODE_DEFAULT
57 #endif
58 #ifndef SEGGER_RTT_PACKETLOG_BUFFER_SIZE
59 #define SEGGER_RTT_PACKETLOG_BUFFER_SIZE 1024
60 #endif
61 #ifndef SEGGER_RTT_PACKETLOG_CHANNEL
62 #define SEGGER_RTT_PACKETLOG_CHANNEL 1
63 #endif
64 
65 static char segger_rtt_packetlog_buffer[SEGGER_RTT_PACKETLOG_BUFFER_SIZE];
66 
67 static int  dump_format;
68 static char log_message_buffer[256];
69 
70 static void hci_dump_segger_rtt_binary_log_packet(uint8_t packet_type, uint8_t in, uint8_t *packet, uint16_t len) {
71     if (dump_format == HCI_DUMP_INVALID) return;
72 
73     static union {
74         uint8_t header_bluez[HCI_DUMP_HEADER_SIZE_BLUEZ];
75         uint8_t header_packetlogger[HCI_DUMP_HEADER_SIZE_PACKETLOGGER];
76     } header;
77 
78     uint32_t time_ms = btstack_run_loop_get_time_ms();
79     uint32_t tv_sec  = time_ms / 1000u;
80     uint32_t tv_us   = (time_ms - (tv_sec * 1000)) * 1000;
81     // Saturday, January 1, 2000 12:00:00
82     tv_sec += 946728000UL;
83 
84 #if (SEGGER_RTT_PACKETLOG_MODE == SEGGER_RTT_MODE_NO_BLOCK_SKIP)
85     static const char rtt_warning[] = "RTT buffer full - packet(s) skipped";
86     static bool rtt_packet_skipped = false;
87     if (rtt_packet_skipped){
88         // try to write warning log message
89         rtt_packet_skipped = false;
90         packet_type = LOG_MESSAGE_PACKET;
91         packet      = (uint8_t *) &rtt_warning[0];
92         len         = sizeof(rtt_warning)-1;
93     }
94 #endif
95 
96     uint16_t header_len = 0;
97     switch (dump_format){
98         case HCI_DUMP_BLUEZ:
99             hci_dump_setup_header_bluez(header.header_bluez, tv_sec, tv_us, packet_type, in, len);
100             header_len = HCI_DUMP_HEADER_SIZE_BLUEZ;
101             break;
102         case HCI_DUMP_PACKETLOGGER:
103             hci_dump_setup_header_packetlogger(header.header_packetlogger, tv_sec, tv_us, packet_type, in, len);
104             header_len = HCI_DUMP_HEADER_SIZE_PACKETLOGGER;
105             break;
106         default:
107             return;
108     }
109 
110 #if (SEGGER_RTT_PACKETLOG_MODE == SEGGER_RTT_MODE_NO_BLOCK_SKIP)
111     // check available space in buffer to avoid writing header but not packet
112     unsigned space_free = SEGGER_RTT_GetAvailWriteSpace(SEGGER_RTT_PACKETLOG_CHANNEL);
113     if ((header_len + len) > space_free) {
114         rtt_packet_skipped = true;
115         return;
116     }
117 #endif
118 
119     // write complete header and payload
120     SEGGER_RTT_Write(SEGGER_RTT_PACKETLOG_CHANNEL, &header, header_len);
121     SEGGER_RTT_Write(SEGGER_RTT_PACKETLOG_CHANNEL, packet, len);
122 }
123 
124 static void hci_dump_segger_rtt_binary_log_message(int log_level, const char * format, va_list argptr){
125     UNUSED(log_level);
126     if (dump_format == HCI_DUMP_INVALID) return;
127     int len = vsnprintf(log_message_buffer, sizeof(log_message_buffer), format, argptr);
128     hci_dump_segger_rtt_binary_log_packet(LOG_MESSAGE_PACKET, 0, (uint8_t*) log_message_buffer, len);
129 }
130 
131 //
132 
133 void hci_dump_segger_rtt_binary_open(hci_dump_format_t format){
134     btstack_assert(format == HCI_DUMP_BLUEZ || format == HCI_DUMP_PACKETLOGGER);
135     dump_format = format;
136     SEGGER_RTT_ConfigUpBuffer(SEGGER_RTT_PACKETLOG_CHANNEL, "hci_dump", &segger_rtt_packetlog_buffer[0], SEGGER_RTT_PACKETLOG_BUFFER_SIZE, SEGGER_RTT_PACKETLOG_MODE);
137 }
138 
139 const hci_dump_t * hci_dump_segger_rtt_binary_get_instance(void){
140     static const hci_dump_t hci_dump_instance = {
141         // void (*reset)(void);
142         NULL,
143         // void (*log_packet)(uint8_t packet_type, uint8_t in, uint8_t *packet, uint16_t len);
144         &hci_dump_segger_rtt_binary_log_packet,
145         // void (*log_message)(int log_level, const char * format, va_list argptr);
146         &hci_dump_segger_rtt_binary_log_message,
147     };
148     return &hci_dump_instance;
149 }
150