如何缩短ESP32的BLE连接距离至1米内并实现超距自动断开

核心前提：BLE没有硬件强制的距离锁止机制，所有范围控制都是基于接收信号强度（RSSI）的近似判断，只要按步骤校准，完全能实现1米的连接范围要求

第一步：从硬件层面压缩基础连接距离 #

在写软件逻辑之前，先把ESP32的BLE发射功率压到最低，从根源上拉低最大连接的距离上限：

• ESP32的BLE发射功率档位覆盖-12dBm（最低）到9dBm（最高），直接在初始化BLE栈时调用功率设置接口，把全局默认发射功率设为最低档：
  esp_ble_tx_power_set(ESP_BLE_PWR_TYPE_DEFAULT, ESP_PWR_LVL_N12)
• 调整完功率后，实际测试无遮挡环境下的最大连接距离，这个配置下通常最大连接距离会被压缩到3-4米，作为后续软件阈值判断的基础。
• 注意不要把ESP32模块安装在金属外壳、大面积金属遮挡物附近，否则会出现信号衰减非线性，导致RSSI和实际距离的对应关系完全失准。

第二步：实机校准RSSI与距离的对应阈值 #

没有通用的RSSI参数可以直接套用，必须在实际使用场景下做校准：

• 把ESP32和测试用的手机放在和实际使用环境一致的无遮挡平面上，分别固定在0.5米、1米、1.5米的位置，每个位置停留30秒。
• 分别读取两个方向的平均RSSI值：ESP32端读取手机广播的RSSI、手机端读取ESP32广播的RSSI，记录平均值。通常最低发射功率配置下，无遮挡时1米位置的双向平均RSSI在-65dBm ~ -70dBm区间，1.5米位置的RSSI会比1米位置低7~10dBm。
• 最终把允许连接的RSSI阈值设为和1米位置测量值齐平，把超距断开的阈值设为比1米测量值低5dBm（对应实际距离约1.2米，留缓冲避免误断）。

第三步：实现连接前的范围校验 #

不要等连接建立完成再做判断，直接在连接请求阶段就做范围过滤：

• ESP32收到手机发来的连接请求时，不立刻回应连接，先读取当前请求设备的实时RSSI值。
• 如果RSSI值高于校准好的1米连接阈值，说明设备在1米范围内，正常回应连接请求，建立链路。
• 如果RSSI值低于连接阈值，直接丢弃请求，不建立连接。

第四步：连接建立后的超距自动断开逻辑 #

RSSI会因为遮挡、环境干扰出现瞬时波动，不能因为单次值低就断开连接：

• 连接保持阶段，每1秒采样一次当前连接对端的RSSI值，用5次采样值的滑动平均值做判断，抵消瞬时波动的影响。
• 当连续3次滑动平均结果都低于校准好的超距断开阈值时，主动调用esp_gap_ble_disconnect() 断开当前连接。
• 这个采样和判断逻辑可以过滤掉临时遮挡（比如行人走过导致的信号短暂衰减）带来的误触发，不会出现人只是从设备旁边走过就断连的问题。

常见踩坑提醒 #

• 不要直接照搬网上别人分享的RSSI阈值，不同批次ESP32的板载天线匹配度差异能达到3dBm以上，硬套参数要么实际可连5米，要么站在0.8米就触发断开。
• 如果需要更高精度的距离控制，可以选用带BLE 5.1 测角（AoA/AoD）功能的ESP32型号，靠角度计算的距离误差可以控制在0.2米以内，普通场景用校准后的RSSI方案完全够用。

内容的提问来源于stack exchange，提问作者Hafiz