BLEAK 开源项目安装与使用指南

最新推荐文章于 2024-08-08 07:44:57 发布

管岗化Denise

最新推荐文章于 2024-08-08 07:44:57 发布

阅读量925

点赞数 16

本文链接：https://blog.csdn.net/gitblog_01157/article/details/141009789

版权

BLEAK 开源项目安装与使用指南

bleakA cross platform Bluetooth Low Energy Client for Python using asyncio项目地址:https://gitcode.com/gh_mirrors/bl/bleak

一、项目介绍

BLEAK 是一款GATT客户端软件，专门设计用于连接并通信于作为GATT服务器的蓝牙低功耗（BLE）设备。它提供了一个异步跨平台Python API，可以与各种传感器等设备进行交互。

支持系统环境

Windows: 需要版本10或以上。
Linux: 需要BlueZ库版本至少5.43及以上。
macOS: 通过Core Bluetooth API支持从OS X 10.11或更高版本。
Android: 兼容python-for-android后端。

主要特性

读写操作: 支持从GATT服务器读取数据及向其发送数据。
通知: 可以订阅来自GATT服务器的数据更新通知。
设备发现: 提供功能以查找可连接的BLE设备。

二、项目快速启动

首先确保你的环境中已安装了pip工具，然后执行以下命令来安装bleak：

$ pip install bleak

接下来，你可以通过下面的一段示例代码快速体验一下如何使用bleak来发现周围的BLE设备：

import asyncio
from bleak import BleakScanner


async def scan_ble_devices():
    print("正在扫描附近的蓝牙LE设备...")
    devices = await BleakScanner.discover()
    
    if len(devices):
        print("找到的设备列表:")
        for device_index, device in enumerate(devices):
            print(f"{device_index}. 设备地址: {device.address} 名称: {device.name}")
    else:
        print("没有找到任何设备")

# 运行扫描函数
asyncio.run(scan_ble_devices())

保存这段脚本并运行它。它将搜索并列出所有可用的BLE设备，包括它们的名称和MAC地址。

三、应用案例和最佳实践

假设你要读取一个BLE设备上的特定服务特征值，可以参考以下步骤：

找到目标设备的MAC地址。
使用BleakClient类连接该设备。
获取所需的服务UUID。
写入或者读取相应的特征值。

具体实现代码如下：

from bleak import BleakClient

DEVICE_ADDRESS = "XX:XX:XX:XX:XX:XX" # 替换为你的设备MAC地址
CHARACTERISTIC_UUID = "xxxx-yyyy-zzzz-www-hhhhhh" # 替换为你想要读写的特征UUID

async def read_characteristic_value(client: BleakClient, characteristic_uuid: str):
    value = await client.read_gatt_char(characteristic_uuid)
    print(f"从{characteristic_uuid}读取到的值: {value}")

async def run_client():
    async with BleakClient(DEVICE_ADDRESS) as client:
        await read_characteristic_value(client, CHARACTERISTIC_UUID)

# 连接至BLE设备并读取特征值
asyncio.run(run_client())

确保在实际场景中替换DEVICE_ADDRESS和CHARACTERISTIC_UUID变量值，以匹配你的具体需求。