如何使用Python BlueZ配置树莓派一次仅连接一个BLE设备

一、Python控制BLE广播/可发现状态，实现单设备连接 #

BlueZ核心通过D-Bus提供管理接口，直接操作D-Bus比调用bluetoothctl脚本更稳定，适合嵌入到你的GATT Server逻辑中。

1. 先安装依赖 #

确保D-Bus Python绑定已安装：

sudo apt-get install python3-dbus

2. 连接成功后停止广播与可发现 #

在你的BLE服务代码中添加连接监听逻辑，检测到设备连接时立即关闭广播和可发现：

import dbus
import dbus.mainloop.glib
from gi.repository import GLib

def handle_device_connection(path, properties):
    if 'Connected' in properties and properties['Connected']:
        print(f"设备 {path} 已连接，停止广播与可发现")
        
        # 操作BlueZ的广播管理接口，停止广播
        bus = dbus.SystemBus()
        adv_manager = bus.get_object('org.bluez', '/org/bluez/hci0')
        adv_manager_iface = dbus.Interface(adv_manager, 'org.bluez.LEAdvertisingManager1')
        
        # 替换为你实际注册的广播实例路径
        try:
            adv_manager_iface.UnregisterAdvertisement('/org/bluez/your_service/advertisement')
        except dbus.exceptions.DBusException as e:
            print(f"停止广播失败: {e}")
        
        # 关闭适配器的可发现性
        adapter = bus.get_object('org.bluez', '/org/bluez/hci0')
        adapter_iface = dbus.Interface(adapter, 'org.bluez.Adapter1')
        adapter_iface.SetDiscoverable(False)
        adapter_iface.SetPairable(False)  # 可选：关闭配对，进一步限制连接

def main():
    dbus.mainloop.glib.DBusGMainLoop(set_as_default=True)
    bus = dbus.SystemBus()
    
    # 监听设备连接状态变化
    bus.add_signal_receiver(
        handle_device_connection,
        signal_name='PropertiesChanged',
        dbus_interface='org.freedesktop.DBus.Properties',
        path_keyword='path'
    )
    
    # 这里启动你的GATT Server逻辑...
    
    loop = GLib.MainLoop()
    loop.run()

if __name__ == '__main__':
    main()

3. 设备断开后恢复广播（可选） #

如果需要断开后重新允许连接，添加断开监听逻辑：

def handle_device_disconnection(path, properties):
    if 'Connected' in properties and not properties['Connected']:
        print(f"设备 {path} 已断开，恢复广播与可发现")
        bus = dbus.SystemBus()
        
        # 重新注册广播实例（需提前定义你的Advertisement类）
        # adv_manager_iface.RegisterAdvertisement(your_advertisement_path, {})
        
        adapter = bus.get_object('org.bluez', '/org/bluez/hci0')
        adapter_iface = dbus.Interface(adapter, 'org.bluez.Adapter1')
        adapter_iface.SetDiscoverable(True)

二、BlueZ Python相关资源 #

因为你熟悉嵌入式C，推荐从BlueZ官方接口入手，Python只是对D-Bus接口的封装：

• BlueZ官方D-Bus文档：这是最权威的参考，所有Python操作都基于这些接口。可以通过man bluez查看，或直接看BlueZ源码中doc/dbus-api目录下的接口定义（比如adapter-api.txt、le-advertising-api.txt）
• BlueZ官方Python示例：BlueZ源码的test目录下有现成的Python示例（如example-gatt-server.py），直接参考官方实现比第三方库更可靠
• 第三方封装库（可选）：如果不想直接写D-Bus代码，可以试试bluezero或pybluez，但注意这些库依赖特定BlueZ版本，稳定性不如直接调用原生D-Bus接口

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