Python 连接 iBeacon 蓝牙设备超详细学习笔记

库名称	支持系统	特点	安装命令
BluePy	Linux（树莓派）	轻量、专注 BLE，适合嵌入式场景	`pip install bluepy`
PyBluez	Windows/Linux	跨平台，支持经典蓝牙 + BLE	`pip install pybluez`
Bleak	Windows/macOS/Linux	纯 Python 实现、易上手，推荐新手	`pip install bleak`

推荐选择 ：如果是 Windows/macOS 开发，优先用 Bleak；树莓派等 Linux 嵌入式设备可选择 BluePy；需要兼容经典蓝牙场景选 PyBluez。本文以Bleak为例讲解完整连接流程。

三、Bleak 连接 iBeacon 实操步骤

1. 核心代码实现（扫描 + 连接）

以下是通用的 iBeacon 扫描和连接代码，可直接复制使用，关键步骤已加注释：

python 复制代码

import asyncio
from bleak import BleakScanner, BleakClient

# iBeacon设备的蓝牙MAC地址（需替换为你的设备地址）
IBEACON_MAC = "AA:BB:CC:DD:EE:FF"

async def scan_ibeacon():
    """扫描周边iBeacon设备"""
    print("开始扫描iBeacon设备...")
    # 扫描5秒，获取所有BLE设备
    devices = await BleakScanner.discover(timeout=5)
    
    # 筛选iBeacon设备（通过广播数据特征判断）
    ibeacon_devices = []
    for d in devices:
        # iBeacon的广播数据通常包含特定前缀，可根据实际调整
        if d.metadata.get("manufacturer_data"):
            ibeacon_devices.append({"name": d.name, "address": d.address, "rssi": d.rssi})
    
    if ibeacon_devices:
        print("扫描到的iBeacon设备：")
        for dev in ibeacon_devices:
            print(f"名称：{dev['name']}，地址：{dev['address']}，信号强度：{dev['rssi']}")
    else:
        print("未扫描到iBeacon设备")
    return ibeacon_devices

async def connect_ibeacon(mac_address):
    """连接指定MAC地址的iBeacon设备"""
    try:
        async with BleakClient(mac_address) as client:
            if client.is_connected:
                print(f"成功连接iBeacon设备：{mac_address}")
                # 这里可添加读取iBeacon数据、订阅特征值等操作
                # 示例：获取设备名称
                device_name = await client.read_gatt_char("00002a00-0000-1000-8000-00805f9b34fb")
                print(f"设备名称：{device_name.decode('utf-8')}")
            else:
                print(f"连接{iBeacon设备失败}")
    except Exception as e:
        print(f"连接异常：{str(e)}")

# 主函数
if __name__ == "__main__":
    # 第一步：扫描设备
    scanned_devices = asyncio.run(scan_ibeacon())
    # 第二步：连接指定设备（替换为实际扫描到的MAC）
    if scanned_devices:
        asyncio.run(connect_ibeacon(IBEACON_MAC))

2. 代码关键说明

BleakScanner.discover()：扫描周边 BLE 设备，timeout指定扫描时长（单位：秒）；
BleakClient：创建蓝牙客户端，传入设备 MAC 地址即可尝试连接；
client.is_connected：判断是否连接成功，核心状态校验；
read_gatt_char：读取蓝牙特征值，00002a00-0000-1000-8000-00805f9b34fb是通用的设备名称特征 UUID，可根据 iBeacon 实际特征 UUID 替换。

四、连接失败？超全排查方案（Windows 系统）

使用 Bleak 连接时最常见的问题是 "连接失败 / 扫描不到设备"，按以下步骤逐一排查，99% 能解决：

1. 检查蓝牙应用权限

方法一：系统设置（可视化操作）

按下 Win + I 打开系统设置；
进入「隐私和安全性」→「应用权限」→「蓝牙」；
确保「允许应用使用蓝牙」开关开启；
在应用列表中找到 Python / 你的开发工具（PyCharm/VSCode），确认权限已开启。

方法二：控制面板快速打开蓝牙设置

在命令提示符（CMD）中执行以下命令，直接跳转到蓝牙属性页面：

bash 复制代码

control.exe bthprops.cpl

2. 为 Python 授予管理员 + 防火墙权限

以管理员身份运行：右键点击 CMD/Python/IDE，选择「以管理员身份运行」，避免权限不足导致连接失败；
防火墙放行 Python ：
- 按下 Win + R，输入 wf.msc 打开高级防火墙；
- 检查「入站规则」和「出站规则」，确保 Python.exe 未被阻止；
- 若被阻止，右键选择「启用规则」，或新建规则允许 Python 访问网络。

3. 检查并修复蓝牙服务状态

Windows 蓝牙服务异常是连接失败的高频原因，通过 PowerShell（管理员身份）操作：

bash 复制代码

# 1. 查看所有蓝牙相关服务状态
Get-Service | Where-Object {$_.Name -like "bluetooth"}

# 2. 查看蓝牙适配器状态（确认是否正常）
Get-PnpDevice | Where-Object {$_.Class -like "bluetooth"} | Format-Table Status, FriendlyName

# 3. 重启核心蓝牙服务（关键！）
Restart-Service -Name "BluetoothUserService" -Force
Restart-Service -Name "BthAvctpSvc" -Force

# 若重启失败，去掉-Force重试
Restart-Service -Name "BluetoothUserService"
Restart-Service -Name "BthAvctpSvc"

关键说明 ：BluetoothUserService（蓝牙用户支持服务）是核心，若该服务关闭，蓝牙连接必失败。

五、进阶：后台监测蓝牙服务（解决服务莫名关闭问题）

如果你的蓝牙用户服务总是自动关闭，可编写 Python 脚本实时监测，关闭后自动重启：

python 复制代码

import subprocess
import time
import psutil

def check_bluetooth_service(service_name):
    """检查蓝牙服务状态"""
    try:
        service = psutil.win_service_get(service_name)
        return service.status() == "running"
    except Exception:
        return False

def restart_bluetooth_service(service_name):
    """重启蓝牙服务"""
    try:
        # 以管理员身份执行重启命令
        cmd = f'powershell Restart-Service -Name "{service_name}"'
        subprocess.run(["cmd", "/c", cmd], shell=True, check=True)
        print(f"{service_name} 服务已重启")
    except Exception as e:
        print(f"重启服务失败：{str(e)}")

# 监测主逻辑
if __name__ == "__main__":
    SERVICE_NAME = "BluetoothUserService"
    print("开始监测蓝牙用户服务...")
    while True:
        if not check_bluetooth_service(SERVICE_NAME):
            print(f"{SERVICE_NAME} 服务已关闭，正在重启...")
            restart_bluetooth_service(SERVICE_NAME)
        # 每10秒检查一次
        time.sleep(10)

使用说明：

需安装psutil库：pip install psutil；
以管理员身份运行该脚本，即可后台持续监测；
可根据需要调整检查间隔（time.sleep(10) 改为 5 秒 / 30 秒等）。

总结

关键点回顾

Python 连接 iBeacon 优先选 Bleak 库（跨平台、易上手），Linux 嵌入式场景可选 BluePy；
连接失败核心排查方向：蓝牙权限、防火墙、蓝牙服务状态（尤其是 BluetoothUserService）；
若蓝牙服务频繁关闭，可通过 Python 脚本后台监测并自动重启，解决根本问题。

创作不易，如果本文对你有帮助，欢迎点赞 + 收藏 + 关注～后续会更新 iBeacon 数据解析、定位算法等进阶内容！