From 32fa421cfc7ae961a8dd8cc1aadf7b730c0ffc06 Mon Sep 17 00:00:00 2001 From: gongyantao Date: Mon, 22 Dec 2025 10:49:08 +0800 Subject: [PATCH] change(bt): Mark RSSI threshold-related macros as deprecated --- .../bt/host/bluedroid/api/include/api/esp_gap_bt_api.h | 6 +----- .../migration-guides/release-6.x/6.0/bluetooth-classic.rst | 6 ++++++ .../migration-guides/release-6.x/6.0/bluetooth-classic.rst | 6 ++++++ 3 files changed, 13 insertions(+), 5 deletions(-) diff --git a/components/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h b/components/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h index d15b26d2b5b..1054e4c9f66 100644 --- a/components/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h +++ b/components/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h @@ -15,10 +15,6 @@ extern "C" { #endif -/// RSSI threshold -#define ESP_BT_GAP_RSSI_HIGH_THRLD -20 /*!< High RSSI threshold */ -#define ESP_BT_GAP_RSSI_LOW_THRLD -45 /*!< Low RSSI threshold */ - /// Class of device typedef struct { uint32_t reserved_2: 2; /*!< undefined */ @@ -363,7 +359,7 @@ typedef union { struct read_rssi_delta_param { esp_bd_addr_t bda; /*!< remote bluetooth device address*/ esp_bt_status_t stat; /*!< read rssi status */ - int8_t rssi_delta; /*!< rssi delta value range -128 ~127, The value zero indicates that the RSSI is inside the Golden Receive Power Range, the Golden Receive Power Range is from ESP_BT_GAP_RSSI_LOW_THRLD to ESP_BT_GAP_RSSI_HIGH_THRLD */ + int8_t rssi_delta; /*!< rssi delta value range -128 ~127, The value zero indicates that the RSSI is inside the Golden Receive Power Range */ } read_rssi_delta; /*!< read rssi parameter struct */ /** diff --git a/docs/en/migration-guides/release-6.x/6.0/bluetooth-classic.rst b/docs/en/migration-guides/release-6.x/6.0/bluetooth-classic.rst index 252d8d16b50..b814c054f0b 100644 --- a/docs/en/migration-guides/release-6.x/6.0/bluetooth-classic.rst +++ b/docs/en/migration-guides/release-6.x/6.0/bluetooth-classic.rst @@ -31,6 +31,12 @@ Bluedroid - Sending indicator reports to the HFP client API has been replaced by ``esp_hf_ag_ciev_report(...)``. + - :component_file:`/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h` + + - Remove ``ESP_BT_GAP_RSSI_HIGH_THRLD`` and ``ESP_BT_GAP_RSSI_LOW_THRLD`` + + - Macros of low and high RSSI threshold have been removed. + The following Bluedroid API have been changed: - :component_file:`/bt/host/bluedroid/api/include/api/esp_sdp_api.h` diff --git a/docs/zh_CN/migration-guides/release-6.x/6.0/bluetooth-classic.rst b/docs/zh_CN/migration-guides/release-6.x/6.0/bluetooth-classic.rst index ea592e4ca3b..55e46c5b299 100644 --- a/docs/zh_CN/migration-guides/release-6.x/6.0/bluetooth-classic.rst +++ b/docs/zh_CN/migration-guides/release-6.x/6.0/bluetooth-classic.rst @@ -31,6 +31,12 @@ Bluedroid - 向 HFP 客户端发送指标报告 API 已被替换为 ``esp_hf_ag_ciev_report(...)``。 + - :component_file:`/bt/host/bluedroid/api/include/api/esp_gap_bt_api.h` + + - 移除 ``ESP_BT_GAP_RSSI_HIGH_THRLD`` 和 ``ESP_BT_GAP_RSSI_LOW_THRLD`` + + - 表示接受信号强度阈值的宏 ``ESP_BT_GAP_RSSI_HIGH_THRLD`` 和 ``ESP_BT_GAP_RSSI_LOW_THRLD`` 已经被移除。 + 以下 Bluedroid API 发生变更 - :component_file:`/bt/host/bluedroid/api/include/api/esp_sdp_api.h`