feat(nimble): ADD BLE HCI logging support for ESP Insights

components/bt/common/hci_log/bt_hci_log.c

@@ -40,6 +40,16 @@ static const char s_hex_to_char_mapping[16] = {
 static bt_hci_log_t g_bt_hci_log_data_ctl  = {0};
 static bt_hci_log_t g_bt_hci_log_adv_ctl  = {0};
 
+uint8_t bt_hci_log_h4_type_to_data_type(uint8_t h4_type)
+{
+    switch (h4_type) {
+    case 0x05:
+        return HCI_LOG_DATA_TYPE_ISO_DATA;
+    default:
+        return h4_type;
+    }
+}
+
 esp_err_t bt_hci_log_init(void)
 {
     uint8_t *g_bt_hci_log_data_buffer = NULL;

components/bt/common/hci_log/bt_hci_log_insights.c

@@ -0,0 +1,90 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <stdint.h>
+#include <stdio.h>
+#include <string.h>
+
+#include "freertos/FreeRTOS.h"
+#include "freertos/portmacro.h"
+
+#include "esp_timer.h"
+#include "bt_ble_insights.h"
+#include "bt_common.h"
+#include "hci_log/bt_hci_log.h"
+
+#if (BT_HCI_LOG_INCLUDED == TRUE) && BT_HCI_INSIGHTS_INCLUDED
+static uint8_t s_hci_log_seq_num = 0;
+static portMUX_TYPE s_hci_log_mux = portMUX_INITIALIZER_UNLOCKED;
+
+#define HCI_LOG_INSIGHTS_LINE_SIZE 128U
+#define HCI_LOG_INSIGHTS_TS_LEN 8U
+
+static const char *bt_hci_log_insights_label(uint8_t data_type)
+{
+    switch (data_type) {
+    case HCI_LOG_DATA_TYPE_COMMAND:
+        return "C";
+    case HCI_LOG_DATA_TYPE_H2C_ACL:
+        return "H";
+    case HCI_LOG_DATA_TYPE_SCO:
+        return "S";
+    case HCI_LOG_DATA_TYPE_EVENT:
+        return "E";
+    case HCI_LOG_DATA_TYPE_ADV:
+        return "ADV";
+    case HCI_LOG_DATA_TYPE_C2H_ACL:
+        return "D";
+    case HCI_LOG_DATA_TYPE_ISO_DATA:
+        return "I";
+    default:
+        return NULL;
+    }
+}
+
+void bt_hci_log_record_insights(uint8_t data_type, const uint8_t *data, uint16_t data_len)
+{
+    const char *label = bt_hci_log_insights_label(data_type);
+    char line[HCI_LOG_INSIGHTS_LINE_SIZE];
+    uint8_t ts_bytes[HCI_LOG_INSIGHTS_TS_LEN];
+    uint64_t timestamp;
+    uint8_t seq_num;
+    int offset;
+
+    if (!BT_BLE_INSIGHTS_AVAILABLE || label == NULL || data == NULL || data_len == 0) {
+        return;
+    }
+
+    portENTER_CRITICAL(&s_hci_log_mux);
+    seq_num = ++s_hci_log_seq_num;
+    portEXIT_CRITICAL(&s_hci_log_mux);
+
+    timestamp = esp_timer_get_time();
+    memcpy(ts_bytes, &timestamp, sizeof(ts_bytes));
+
+    offset = snprintf(line, sizeof(line), "%02x %s:", (unsigned int)seq_num, label);
+    if (offset < 0 || (size_t)offset >= sizeof(line) - 1) {
+        return;
+    }
+
+    for (size_t i = 0; i < sizeof(ts_bytes) && offset <= (int)sizeof(line) - 3; i++) {
+        offset += snprintf(&line[offset], sizeof(line) - offset, "%02x", ts_bytes[i]);
+    }
+
+    if (offset < 0 || (size_t)offset >= sizeof(line) - 1) {
+        return;
+    }
+
+    line[offset++] = ' ';
+    line[offset] = '\0';
+
+    for (uint16_t i = 0; i < data_len && offset <= (int)sizeof(line) - 3; i++) {
+        offset += snprintf(&line[offset], sizeof(line) - offset, "%02X", data[i]);
+    }
+
+    ble_insights_log(line);
+}
+#endif

components/bt/common/hci_log/include/hci_log/bt_hci_log.h

@@ -102,6 +102,17 @@ esp_err_t bt_hci_log_record_hci_data(uint8_t data_type, uint8_t *data, uint16_t
  */
 esp_err_t bt_hci_log_record_hci_adv(uint8_t data_type, uint8_t *data, uint8_t data_len);
 
+/**
+ *
+ * @brief           Convert HCI H4 packet type to HCI log data type.
+ *
+ * @param h4_type : HCI H4 packet type byte
+ *
+ * @return          corresponding HCI log data type
+ *
+ */
+uint8_t bt_hci_log_h4_type_to_data_type(uint8_t h4_type);
+
 #ifdef __cplusplus
 }
 #endif