【亲测免费】 Bleak 项目安装和配置指南

1. 项目基础介绍和主要编程语言

项目介绍

Bleak 是一个跨平台的蓝牙低功耗（Bluetooth Low Energy, BLE）客户端，专为 Python 设计。它使用 asyncio 库来提供异步的 API，使得开发者可以轻松地连接和与 BLE 设备进行通信。Bleak 支持 Windows、Linux 和 macOS 等多个操作系统，并且兼容 Android 平台。

主要编程语言

Bleak 项目主要使用 Python 编程语言。

2. 项目使用的关键技术和框架

关键技术

• Python: 项目的主要编程语言。
• asyncio: Python 的异步 I/O 库，用于处理异步操作。
• BlueZ: Linux 上的蓝牙协议栈，Bleak 在 Linux 上使用 BlueZ 进行 BLE 通信。
• Core Bluetooth: macOS 和 iOS 上的蓝牙框架，Bleak 在 macOS 上使用 Core Bluetooth 进行 BLE 通信。

框架

• Bleak: 提供了一个跨平台的 BLE 客户端 API，支持读取、写入和获取 GATT 服务器的通知。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. Python 环境: 确保你已经安装了 Python 3.7 或更高版本。你可以通过以下命令检查 Python 版本：

   python --version
   

   如果没有安装 Python，可以从 Python 官方网站 下载并安装。

2. pip: 确保你已经安装了 pip，Python 的包管理工具。你可以通过以下命令检查 pip 版本：

   pip --version
   

   如果没有安装 pip，可以通过以下命令安装：

   python -m ensurepip --upgrade
   

3. 操作系统要求:

   • Windows: 需要 Windows 10 版本 16299（Fall Creators Update）或更高版本。
   • Linux: 需要 BlueZ 5.43 或更高版本。
   • macOS: 需要 macOS 10.11 或更高版本。

详细安装步骤

1. 安装 Bleak 使用 pip 安装 Bleak：

   pip install bleak
   

2. 验证安装 安装完成后，可以通过以下代码验证 Bleak 是否安装成功：

   import asyncio
   from bleak import BleakScanner
   
   async def main():
       devices = await BleakScanner.discover()
       for d in devices:
           print(d)
   
   asyncio.run(main())
   

   运行上述代码，如果能够成功发现附近的 BLE 设备，说明 Bleak 安装成功。

配置和使用

1. 连接到 BLE 设备 以下是一个简单的示例，展示如何连接到一个 BLE 设备并读取其型号号码：

   import asyncio
   from bleak import BleakClient
   
   address = "24:71:89:cc:09:05"  # 替换为你的 BLE 设备地址
   MODEL_NBR_UUID = "2A24"  # 替换为你的 BLE 设备型号号码的 UUID
   
   async def main(address):
       async with BleakClient(address) as client:
           model_number = await client.read_gatt_char(MODEL_NBR_UUID)
           print("Model Number: {}".format("".join(map(chr, model_number))))
   
   asyncio.run(main(address))
   

2. 处理 BLE 设备的通知 以下是一个示例，展示如何处理 BLE 设备的通知：

   import asyncio
   from bleak import BleakClient
   
   address = "24:71:89:cc:09:05"  # 替换为你的 BLE 设备地址
   NOTIFICATION_UUID = "2A37"  # 替换为你的 BLE 设备通知的 UUID
   
   def notification_handler(sender, data):
       print(f"Notification from {sender}: {data}")
   
   async def main(address):
       async with BleakClient(address) as client:
           await client.start_notify(NOTIFICATION_UUID, notification_handler)
           await asyncio.sleep(10.0)  # 等待 10 秒以接收通知
   
   asyncio.run(main(address))
   

通过以上步骤，你可以成功安装和配置 Bleak 项目，并开始与 BLE 设备进行通信。