如何通过bluetoothctl调整BLE连接参数？解决连接失败问题

问题背景 #

在树莓派4 Model B上安装BlueZ 5.66后，连接BLE智能锁时出现明显差异：

• 使用hcitool命令可成功连接：

  sudo hcitool lecc --random DE:44:38:02:AA:EA
  

  btmon日志显示连接参数正常，连接状态稳定。
• 使用bluetoothctl或Python bleak库连接均失败，bluetoothctl报错：

  [bluetooth]# connect DE:44:38:02:AA:EA
  Attempting to connect to DE:44:38:02:AA:EA
  Failed to connect: org.bluez.Error.Failed le-connection-abort-by-local
  

  对比btmon日志，两种方式的连接参数存在显著差异。

问题原因 #

核心差异在于不同工具的默认连接参数配置不匹配智能锁的要求：

1. 地址类型不匹配：hcitool通过--random明确指定了随机地址类型，而bluetoothctl/bleak默认可能使用公共地址类型，与智能锁的地址类型冲突。
2. 连接参数范围不符：hcitool的默认连接间隔、监督超时等参数恰好落在智能锁允许的范围内，而bluetoothctl的默认参数超出设备接受阈值，导致本地主动终止连接。

解决步骤 #

一、通过bluetoothctl配置正确参数 #

1. 指定设备地址类型

先在bluetoothctl中设置目标设备的地址类型为随机（匹配hcitool的--random参数）：

bluetoothctl> set-device-parameter DE:44:38:02:AA:EA AddressType random

或者扫描时直接指定随机地址类型：

bluetoothctl> scan le --random

2. 同步hcitool的连接参数

先通过btmon抓取hcitool成功连接时的参数（示例日志提取）：

Connection Interval: 30-50 (单位：1.25ms)，Slave Latency: 0，Supervision Timeout: 4000 (单位：10ms)

在bluetoothctl中设置对应参数：

bluetoothctl> set-connection-parameter DE:44:38:02:AA:EA 30 50 0 4000

参数说明：依次为最小连接间隔、最大连接间隔、从机延迟、监督超时。

3. 执行连接

参数配置完成后，重新尝试连接：

bluetoothctl> connect DE:44:38:02:AA:EA

二、bleak库适配方案 #

在bleak连接时明确指定随机地址类型，示例代码：

from bleak import BleakClient, AddressType
import asyncio

async def connect_smart_lock():
    async with BleakClient(
        "DE:44:38:02:AA:EA",
        address_type=AddressType.RANDOM
    ) as client:
        if client.is_connected:
            print("连接成功")
            # 此处添加开锁相关操作逻辑

asyncio.run(connect_smart_lock())

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