如何使用 esp_bt_gap_read_rssi_delta 函数从 ESP32 获取蓝牙经典 RSSI？

Question

ESP-IDF 框架中的经典蓝牙 GAP API 有一个功能：

#include "esp_gap_bt_api.h"
esp_err_t esp_bt_gap_read_rssi_delta(esp_bd_addr_t remote_addr)

带有以下描述：

"连接后调用该函数按地址读取RSSI增量。ESP_BT_GAP_READ_RSSI_DELTA_EVT返回的RSSI值。

返回：ESP_OK：成功； ESP_FAIL: 其他

参数：remote_addr：-远程设备地址，对应某个连接句柄。"

好的，我在做什么（连接到 BT 设备后）： 定义我认为的结构将包含我需要的结果：

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 in range -128 ~127*/
} read_rssi_delta; /*read rssi parameter struct */

并调用函数：

esp_err_t err_code = esp_bt_gap_read_rssi_delta((uint8_t*)esp_bt_dev_get_address());

它返回 err_code = ESP_OK (0, success) 但 read_rssi_delta 结构只包含全零。

我觉得我做错了，因为还应该涉及一件事：ESP_BT_GAP_READ_RSSI_DELTA_EVT（参见上面的描述）。它在枚举中定义：

enum esp_bt_gap_cb_event_t //BT GAP callback events.
..... skip some
ESP_BT_GAP_READ_RSSI_DELTA_EVT //read rssi event
..... etc.

在某些来源中它被称为“事件”，在其他来源中称为“回调函数”，但没有说明如何使用它！

所以，问题是：如何将所有这些东西放在一起以从设备获取 RSSI？

注意：蓝牙是经典的，不是 BLE！

Answer 1

经过几次尝试，我得到了 esp_bt_gap_read_rssi_delta() 的工作。

首先要了解（如果您还没有得到它）​​是回调/事件的事情。回调函数是代码中的一个函数，当发生特殊事件（事件）时，ESP-IDF 将调用该函数。初始化蓝牙堆栈后调用 esp_bt_gap_register_callback() 注册回调函数。

当您调用 esp_bt_gap_read_rssi_delta() 时（连接到设备后），它会立即返回正常或错误状态。实际的 RSSI 读数将在稍后由调用您的回调函数的框架返回。

回调函数有两个参数。第一个标识发生的事件，第二个标识与事件关联的数据。第二个参数是指向 esp_bt_gap_cb_param_t 联合中定义的结构之一的指针。

这是 Arduino IDE 的一些框架代码（不测试返回码等），使用 BluetoothSerial 进行连接：

#include "esp_gap_bt_api.h"
#include "BluetoothSerial.h"

BluetoothSerial SerialBT;
byte addr[6] = { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };

void setup() {
  Serial.begin (115200);
  SerialBT.begin();
  esp_bt_gap_register_callback (gap_callback);
}

void loop() {
  delay(100);
  if (SerialBT.hasClient()) {
    esp_bt_gap_read_rssi_delta (addr);
    delay (10000);    
  }
}

void gap_callback (esp_bt_gap_cb_event_t event, esp_bt_gap_cb_param_t *param) {
  if (event == ESP_BT_GAP_READ_RSSI_DELTA_EVT) {
    Serial.println (param->read_rssi_delta.rssi_delta);
  }
}

Answer 2

所以我的问题的最终解决方案（感谢@dquadros）是：

//ESP32, Classic Bluetooth, SPP
#include "BluetoothSerial.h"
#include "esp_gap_bt_api.h"
#include <esp_spp_api.h>

BluetoothSerial SerialBT;
byte rssi; //RSSI
byte addr[6] = {0,0,0,0,0,0}; //to keep MAC address of the remote device

//RSSI callback function
void gap_callback (esp_bt_gap_cb_event_t event, esp_bt_gap_cb_param_t *param)
{
  if (event == ESP_BT_GAP_READ_RSSI_DELTA_EVT) rssi = param->read_rssi_delta.rssi_delta;
}

//SPP service callback function (to get remote MAC address)
void spp_callback (esp_spp_cb_event_t event, esp_spp_cb_param_t *param)
{
  if (event == ESP_SPP_SRV_OPEN_EVT) memcpy(addr, param->srv_open.rem_bda, 6);
}

void setup()
{
  Serial.begin(9600);
  SerialBT.begin("ESP32");
  //register RSSI callback function:
  esp_bt_gap_register_callback (gap_callback);
  //register SPP service callback to get remote address:
  SerialBT.register_callback(spp_callback);
}

void loop()
{
  //when we need RSSI call this:
  esp_bt_gap_read_rssi_delta (addr); //now variable rssi contains RSSI level
  byte b = rssi; //etc....
}