【Bleak】八、特征的读写

已于 2022-05-19 13:50:35 修改
阅读量2.2k 收藏 6
点赞数 5
分类专栏： Bleak 文章标签： python Windows 低功耗蓝牙 BLE
于 2022-05-15 22:46:11 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43352285/article/details/124787515
版权

1. 前言

如果您阅读本文的时候有障碍或者有疑问，可以评论区留言或者看看本专栏的前部分内容。

从这一章节开始，我们不再仅仅讲解源码当中的例子了，因为越来越深入了。

特征的读写是BLE通讯中较为常用的数据交换手段了，因为源码给的例子中没有专门针对这个部分的内容，所以在这里我们自己制定一个实战DEMO。

2. 涉及到的API

2.1. write_gatt_char

写特征，在对特征进行写时，我们要提前获取到它的UUID或者Handle或者其他能体现特征身份的相关信息。在API里面有这样的解释道：

char_specifier (BleakGATTCharacteristic, int, str or UUID): The characteristic to write
                to, specified by either integer handle, UUID or directly by the
                BleakGATTCharacteristic object representing it.

完整的API源码是这样的：

async def write_gatt_char(
        self,
        char_specifier: Union[BleakGATTCharacteristic, int, str, uuid.UUID],
        data: Union[bytes, bytearray, memoryview],
        response: bool = False,
    ) -> None:
        """Perform a write operation of the specified GATT characteristic.
        Args:
            char_specifier (BleakGATTCharacteristic, int, str or UUID): The characteristic to write
                to, specified by either integer handle, UUID or directly by the
                BleakGATTCharacteristic object representing it.
            data (bytes or bytearray): The data to send.
            response (bool): If write-with-response operation should be done. Defaults to `False`.
        """
        if not isinstance(char_specifier, BleakGATTCharacteristic):
            characteristic = self.services.get_characteristic(char_specifier)
        else:
            characteristic = char_specifier
        if not characteristic:
            raise BleakError("Characteristic {} was not found!".format(char_specifier))

        response = (
            GattWriteOption.WRITE_WITH_RESPONSE
            if response
            else GattWriteOption.WRITE_WITHOUT_RESPONSE
        )
        buf = Buffer(len(data))
        buf.length = buf.capacity
        with memoryview(buf) as mv:
            mv[:] = data
        _ensure_success(
            await characteristic.obj.write_value_with_result_async(buf, response),
            None,
            f"Could not write value {data} to characteristic {characteristic.handle:04X}",
        )

2.2. read_gatt_char

读特征，在对特征进行读取时，同样需要提前获取到它的UUID或者Handle或者其他能体现特征身份的相关信息。

完整的API源码是这样的：

async def read_gatt_char(
        self,
        char_specifier: Union[BleakGATTCharacteristic, int, str, uuid.UUID],
        **kwargs,
    ) -> bytearray:
        """Perform read operation on the specified GATT characteristic.
        Args:
            char_specifier (BleakGATTCharacteristic, int, str or UUID): The characteristic to read from,
                specified by either integer handle, UUID or directly by the
                BleakGATTCharacteristic object representing it.
        Keyword Args:
            use_cached (bool): ``False`` forces Windows to read the value from the
                device again and not use its own cached value. Defaults to ``False``.
        Returns:
            (bytearray) The read data.

        """
        use_cached = kwargs.get("use_cached", False)

        if not isinstance(char_specifier, BleakGATTCharacteristic):
            characteristic = self.services.get_characteristic(char_specifier)
        else:
            characteristic = char_specifier
        if not characteristic:
            raise BleakError("Characteristic {0} was not found!".format(char_specifier))

        value = bytearray(
            _ensure_success(
                await characteristic.obj.read_value_async(
                    BluetoothCacheMode.CACHED
                    if use_cached
                    else BluetoothCacheMode.UNCACHED
                ),
                "value",
                f"Could not read characteristic handle {characteristic.handle}",
            )
        )

        logger.debug(f"Read Characteristic {characteristic.handle:04X} : {value}")

        return value

3. 实战

现在要实现一个这样的功能：
用nRF Connect模拟一个设备，将GATT SERVICE里面一个特征设置成同时可读可写的属性。然后使用Bleak的在电脑上对刚刚模拟的设备进行读写操作（先写数据，再读取出来，看看是不是相同的内容）。

3.1 nRF Connect模拟设备

将Generic Access中的设备名字设置成可读可写属性：
在这里插入图片描述

3.2 代码编写

这次我们基于官方例子 service_explorer.py 进行二次开发，因为在对特征进行读取之前，我们需要先获取到它的句柄或者UUID相关信息。
在这里插入图片描述
对nRF Connect模拟的设备进行连接时，最好是通过名字进行扫描及搜索。对 service_explorer.py 进行一番简化及修改：

  • 通过设备名字扫描设备，获取到其设备地址
  • 通过扫描获取到的设备发起连接
import sys
import platform
import asyncio
import logging

from bleak import BleakClient
from bleak import BleakScanner

logger = logging.getLogger(__name__)

DEVICE_NAME = "dabai"

async def main():
    device = await BleakScanner.find_device_by_filter(
        lambda d, ad: d.name and d.name.lower() == DEVICE_NAME.lower()
    )
    print(device)

    async with BleakClient(device.address) as client:
        logger.info(f"Connected: {client.is_connected}")

        for service in client.services:
            logger.info(f"[Service] {service}")
            for char in service.characteristics:
                if "read" in char.properties:
                    try:
                        value = bytes(await client.read_gatt_char(char.uuid))
                        logger.info(
                            f"\t[Characteristic] {char} ({','.join(char.properties)}), Value: {value}"
                        )
                    except Exception as e:
                        logger.error(
                            f"\t[Characteristic] {char} ({','.join(char.properties)}), Value: {e}"
                        )

                else:
                    value = None
                    logger.info(
                        f"\t[Characteristic] {char} ({','.join(char.properties)}), Value: {value}"
                    )

                for descriptor in char.descriptors:
                    try:
                        value = bytes(
                            await client.read_gatt_descriptor(descriptor.handle)
                        )
                        logger.info(
                            f"\t\t[Descriptor] {descriptor}) | Value: {value}")
                    except Exception as e:
                        logger.error(
                            f"\t\t[Descriptor] {descriptor}) | Value: {e}")


if __name__ == "__main__":
    logging.basicConfig(level=logging.INFO)
    asyncio.run(main())

运行结果，目前仅对目标进行了发现服务特征的操作：

EE:A6:84:0B:23:20: dabai
INFO:bleak.backends.winrt.client:Services resolved for BleakClientWinRT (EE:A6:84:0B:23:20)
INFO:__main__:Connected: True
INFO:__main__:[Service] 00001800-0000-1000-8000-00805f9b34fb (Handle: 1): Generic Access Profile
INFO:__main__:  [Characteristic] 00002a00-0000-1000-8000-00805f9b34fb (Handle: 2):  (read,write), Value: b'dabai'
INFO:__main__:  [Characteristic] 00002a01-0000-1000-8000-00805f9b34fb (Handle: 4):  (read), Value: b'\xc1\x00'
INFO:__main__:  [Characteristic] 00002a04-0000-1000-8000-00805f9b34fb (Handle: 6):  (read), Value: b'P\x00\xa0\x00\x00\x00\x90\x01'
INFO:__main__:  [Characteristic] 00002aa6-0000-1000-8000-00805f9b34fb (Handle: 8):  (read), Value: b'\x01'
INFO:__main__:[Service] 00001801-0000-1000-8000-00805f9b34fb (Handle: 10): Generic Attribute Profile
INFO:__main__:  [Characteristic] 00002a05-0000-1000-8000-00805f9b34fb (Handle: 11):  (indicate), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 13): Client Characteristic Configuration) | Value: b'\x02\x00'
INFO:__main__:[Service] 0000180d-0000-1000-8000-00805f9b34fb (Handle: 14): Heart Rate
INFO:__main__:  [Characteristic] 00002a37-0000-1000-8000-00805f9b34fb (Handle: 15):  (notify), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 17): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 00002a38-0000-1000-8000-00805f9b34fb (Handle: 18):  (read), Value: b'\x03'
INFO:__main__:[Service] 0000180f-0000-1000-8000-00805f9b34fb (Handle: 20): Battery Service
INFO:__main__:  [Characteristic] 00002a19-0000-1000-8000-00805f9b34fb (Handle: 21):  (read), Value: b'a'
INFO:__main__:[Service] 0000180a-0000-1000-8000-00805f9b34fb (Handle: 23): Device Information
INFO:__main__:  [Characteristic] 00002a29-0000-1000-8000-00805f9b34fb (Handle: 24):  (read), Value: b'YFTech'
INFO:__main__:  [Characteristic] 00002a24-0000-1000-8000-00805f9b34fb (Handle: 26):  (read), Value: b'COROS M1D_4R9'
INFO:__main__:  [Characteristic] 00002a25-0000-1000-8000-00805f9b34fb (Handle: 28):  (read), Value: b'4B948172B1E2'
INFO:__main__:  [Characteristic] 00002a27-0000-1000-8000-00805f9b34fb (Handle: 30):  (read), Value: b'UVWbejJZpqrsPtwuvxy'
INFO:__main__:  [Characteristic] 00002a28-0000-1000-8000-00805f9b34fb (Handle: 32):  (read), Value: b'V 2.70.0'
INFO:__main__:[Service] 6e400001-b5a3-f393-e0a9-77656c6f6f70 (Handle: 34): Unknown
INFO:__main__:  [Characteristic] 6e400003-b5a3-f393-e0a9-77656c6f6f70 (Handle: 35):  (notify), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 37): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 6e400002-b5a3-f393-e0a9-77656c6f6f70 (Handle: 38):  (write-without-response,write), Value: None
INFO:__main__:[Service] 6e400001-b5a3-f393-e0a9-77757c7f7f70 (Handle: 40): Unknown
INFO:__main__:  [Characteristic] 6e400003-b5a3-f393-e0a9-77757c7f7f70 (Handle: 41):  (notify), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 43): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 6e400002-b5a3-f393-e0a9-77757c7f7f70 (Handle: 44):  (write-without-response,write), Value: None
INFO:__main__:[Service] 6e400001-b5a3-f393-e0a9-e50e24dcca9e (Handle: 46): Nordic UART Service
INFO:__main__:  [Characteristic] 6e400003-b5a3-f393-e0a9-e50e24dcca9e (Handle: 47):  (notify), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 49): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 6e400002-b5a3-f393-e0a9-e50e24dcca9e (Handle: 50):  (write-without-response,write), Value: None
INFO:__main__:[Service] 0000fee7-0000-1000-8000-00805f9b34fb (Handle: 52): Tencent Holdings Limited
INFO:__main__:  [Characteristic] 0000fea1-0000-1000-8000-00805f9b34fb (Handle: 53):  (read,notify,indicate), Value: b'\x01\x00\x00\x00'   
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 55): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 0000fea2-0000-1000-8000-00805f9b34fb (Handle: 56):  (read,write,indicate), Value: b"\x01\x10'\x00"       
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 58): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 0000fec9-0000-1000-8000-00805f9b34fb (Handle: 59):  (read), Value: b'\xee\xa6\x84\x0b# '
INFO:__main__:[Service] 00001814-0000-1000-8000-00805f9b34fb (Handle: 61): Running Speed and Cadence
INFO:__main__:  [Characteristic] 00002a53-0000-1000-8000-00805f9b34fb (Handle: 62):  (notify), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 64): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 00002a54-0000-1000-8000-00805f9b34fb (Handle: 65):  (read), Value: b'\x05\x00'
INFO:__main__:[Service] 00001816-0000-1000-8000-00805f9b34fb (Handle: 67): Cycling Speed and Cadence
INFO:__main__:  [Characteristic] 00002a5b-0000-1000-8000-00805f9b34fb (Handle: 68):  (notify), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 70): Client Characteristic Configuration) | Value: b'\x00\x00'
INFO:__main__:  [Characteristic] 00002a5c-0000-1000-8000-00805f9b34fb (Handle: 71):  (read), Value: b'\x07\x00'
INFO:__main__:  [Characteristic] 00002a5d-0000-1000-8000-00805f9b34fb (Handle: 73):  (read), Value: b'\x04'
INFO:__main__:  [Characteristic] 00002a55-0000-1000-8000-00805f9b34fb (Handle: 75):  (write,indicate), Value: None
INFO:__main__:          [Descriptor] 00002902-0000-1000-8000-00805f9b34fb (Handle: 77): Client Characteristic Configuration) | Value: b'\x00\x00'

我们主要在意这部分输出结果：
在这里插入图片描述
可以得知我们设置的这个特征的UUID是这样的🎬，Handle 等于 2，属性为可读可写，内容是"dabai"。

现在我们要开始进入正题了，只需添加这几行代码，就可以验证读写接口以及是否操作成功了：

 d_name = "dabaiqianrushi"
 await client.write_gatt_char(2, str.encode(d_name))
 value = bytes(await client.read_gatt_char(2))
 logger.info(f"Value: {value}")

在这里插入图片描述
目的是将Device Name特征值由"dabai" 修改成"dabaiqianrushi"。

输出结果：
在这里插入图片描述
在nRF Connect中读取出来看看，说明我们修改成功了：
在这里插入图片描述

4. 写在最后

本文的内容比较简单，主要使用是两个接口的使用。因为实际项目中比较常用，所以单独列为一章了。

看完觉得有收获点个赞吧 ❤️ 或者关注Bleak专栏查看更多Bleak相关使用⏩

强人电子
关注
  • 5
    点赞
  • 踩
  • 6
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 5
    评论
专栏目录
python 接受连接蓝牙
deep learning
11-01 1555
import asyncio from bleak import BleakClient # address = "24:71:89:cc:09:05" address = "54:6C:0E:53:35:F1" MODEL_NBR_UUID = "00002a24-0000-1000-8000-00805f9b34fb" # MODEL_NBR_UUID ='F000XXXX-0451-4000-B000-000000000000' async def main(address): async
ble 读写特征值特征值_BLE4.0教程二 蓝牙协议之服务与特征值分析
weixin_39587029的博客
12-19 818
1.关于服务与特征值的简述之前说到蓝牙的连接过程，那蓝牙连接之后具体是如何传数据的呢。这里做一下简要说明。蓝牙4.0是以参数来进行数据传输的，即服务端定好一个参数，客户端可以对这个参数进行读，写，通知等操作，这个东西我们称之为特征值(characteristic)，但一个参数不够我们用，比如我们这个特征值是电量的值，另一个特征值是设备读取的温度值。那这时候会有多个特征值，并且我们还会对它们分类，分...
Windows-Python实时获取小米手环4心率，最简单代码
m0_67258728的博客
09-12 2417
小米手环心率的获取
Bluez 的一些概念
tianyexing2008的博客
06-13 1771
下图描述了使用z时Linux上蓝牙的体系结构。正如我们所看到的，Bluez实现蓝牙LE栈的主机层(Host)，控制器通常驻留在芯片, 是计算机的一个组成部分，就像树莓派这样的设备一样或者在外围设备(如USB蓝牙加密狗)中实现。主机上的bluez和底层蓝牙栈之间的通信，是通过称为主机控制器接口的标准逻辑接口进行的，简称HCI(Host Controller Interface)。支持HCI并允许将HCI命令从主机传递到控制器，并将HCI事件从控制器传递到主机，这是标准HCI传输之一，也在核心规范中定义。
探索前沿技术：Bleak - Python中的蓝牙低功耗库
gitblog_00085的博客
04-16 696
探索前沿技术：Bleak - Python中的蓝牙低功耗库 项目地址:https://gitcode.com/zutrinken/bleak Bleak 是一个开源的Python库，专门用于与Bluetooth Low Energy (BLE) 设备进行通信。如果你在寻找一个强大的、跨平台的方式来控制或通信你的BLE设备，Bleak是值得你关注的一个项目。 项目简介 Bleak的目标是提供一个简洁...
windows+python+bleak+BLE低功耗蓝牙通讯连接
热门推荐
rory_wind的博客
01-31 1万+
基于bleak模块实现蓝牙4.0设备的连接及通讯，实现了windows系统下的BLE设备的python环境开发。
ble 读写特征值特征值_BLE添加特征值
weixin_39981632的博客
12-19 3574
一、什么是特征值特征值就是BLE协议栈向外提供的一个数据接口，蓝牙之间的数据传输终落实在特征值上。在BLE协议栈的GATT层中封装了若干服务(service)，而在每一个服务中又有若干特征值(characters)，特征值可以是任意类型的数据。蓝牙之间的数据传输靠协议栈提供的write和read函数，而这两个函数就是在操作特征值二、UUIDUUID就是通用唯一识别码。在蓝牙协议栈中可能会有多个服务...
BRISK特征 学习笔记
格物致知
01-20 9298
BRISK: Binary Robust In variant ScalableKeypoints BRISK特征描述子 1.     简介       BRISK描述子由Stefan Leutenegger等人发表于ICCV11上。(ORB也是ICCV11上出现的)。详见这篇文章： “BRISK: Binary Robust In variant ScalableKeypoints”。
bleak:适用于Python的低功耗蓝牙平台Klient
05-12
安装$ pip install bleak特征支持Windows 10版本16299（秋季创作者更新）或更高版本支持BlueZ> = 5.43Linux发行版至少从OS X版本10.11通过Core Bluetooth API支持OS X / macOS Bleak支持从GATT服务器读取，写入和...
Bleak-crx插件
04-05
语言:English 天气始终会变得更差 漏洞°是在打开新选项卡时显示当地天气的扩展。 因为天气总是变得更糟，所以有一个越来越令人振奋的信息来帮助你。 黯淡知道您自动的地方，但您可以通过单击城市名称手动设置您的...
苍凉「Bleak」-crx插件
03-20
Bleak°是一个扩展，可在打开新标签页时显示您的当地天气。而且由于天气总是会变得越来越糟，因此在您的旅途中，有一条比鼓舞人心的信息对您有所帮助 Bleak°会自动知道您的位置，但是您可以通过单击城市名称来手动...
PyPI 官网下载 | bleak-0.8.0.tar.gz
01-31
《PyPI上的Bleak库解析与应用》 在Python的世界里，PyPI（Python Package Index）是开发者们获取和分享软件包的重要平台。本文将深入探讨一个名为Bleak的Python库，它在版本0.8.0中的具体功能、使用场景以及与之...
Bleak-master_games_visualbasic_l_
10-01
Directory: Other GamesPlat: Visual C++Size: 498KBUploader: N1troDescription: GameGuard Software Development Kit
ble理论（14） ble 扫描详解
剑影的博客
08-19 7011
ble 扫描详解
ble 读写特征值特征值_BLE：使用Android / iOS读取长特征值
weixin_39929635的博客
12-19 249
With a normal Characteristics Read only the MTU Size (20bytes) of data will be read.My customer will offer a characteristics with a larger size (about 100bytes).attclient_read_long command - Starts a ...
【Matlab代码】斑点猫头鹰的生存问题的演化过程
qq_41985559的博客
10-16 588
A=[0 0 0.33;0.18 0 0;0 0.71 0.94]; [pc,lambda]=eig(A);%求A的特征值和对应的特征向量 [Y,I]=sort(diag(abs(lambda)),'descend')%对特征值的绝对值降序排列 temp=diag(lambda); lambda=temp(I)%输出按特征值的绝对值降序排列的特征值 Lambda_norm=[norm(lambda(1);norm(lambda(2));norm(lambda(3))]%对三个特征值的模 pc=pc(:,I)
杰理之蓝牙开启BLE数传编译问题【篇】
u013820168的博客
01-09 408
1234
杰理之数据传输接口BLE、SPP【篇】
u013820168的博客
11-04 221
跟手机端一样的原理，APP流程需要用到的数据传输接口也是由耳机提供，数据传输接口给APP流程提供数据收发服务，但是与手机端不一样的是，在我们讨论的APP应用中，APP流程不能控制BLE和SPP主动发起连接，只能主动断开。
Python爬虫与MongoDB的完美结合
最新发布
weixin_52392194的博客
08-03 668
我们掌握了在Windows和Linux系统下安装MongoDB，设计适合爬虫存储数据的写入规范，并通过实际爬虫示例展示了如何将爬取到的数据存储到MongoDB中。此外，还进行了MongoDB性能优化，提高了数据存储和查询的效率。
python bleak
08-18
Python的bleak模块是一个用于连接蓝牙4.0设备的库，它可以在Windows端使用。可以通过使用setup.py文件进行安装，具体步骤是运行命令"python setup.py install"来安装。另外，你也可以使用pip工具来安装bleak模块。Bleak是一个BLE GATT客户端软件，用于连接作为GATT服务器的BLE设备。你可以从源码下载Bleak，并按照提供的安装方法进行安装。希望这些信息对你有帮助！<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* [windows+python+bleak+BLE低功耗蓝牙通讯连接](https://blog.csdn.net/rory_wind/article/details/128821945)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* *3* [【Bleak】一、简介及安装方法](https://blog.csdn.net/weixin_43352285/article/details/124599999)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

强人电子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值