【雕爷学编程】MicroPython手册之特定的库 bluetooth — 低级蓝牙

驴友花雕

已于 2023-12-19 11:27:30 修改

阅读量987

点赞数 2

分类专栏： MicroPython手册文章标签：单片机嵌入式硬件 python MicroPython 特定的库 bluetooth

于 2023-09-14 03:43:33 首次发布

本文链接：https://blog.csdn.net/weixin_41659040/article/details/132834122

版权

MicroPython手册专栏收录该内容

843 篇文章 167 订阅

订阅专栏

在这里插入图片描述

MicroPython是为了在嵌入式系统中运行Python 3编程语言而设计的轻量级版本解释器。与常规Python相比，MicroPython解释器体积小(仅100KB左右)，通过编译成二进制Executable文件运行，执行效率较高。它使用了轻量级的垃圾回收机制并移除了大部分Python标准库，以适应资源限制的微控制器。

MicroPython主要特点包括:
1、语法和功能与标准Python兼容,易学易用。支持Python大多数核心语法。
2、对硬件直接访问和控制,像Arduino一样控制GPIO、I2C、SPI等。
3、强大的模块系统,提供文件系统、网络、图形界面等功能。
4、支持交叉编译生成高效的原生代码,速度比解释器快10-100倍。
5、代码量少,内存占用小,适合运行在MCU和内存小的开发板上。
6、开源许可,免费使用。Shell交互环境为开发测试提供便利。
7、内置I/O驱动支持大量微控制器平台，如ESP8266、ESP32、STM32、micro:bit、掌控板和PyBoard等。有活跃的社区。

MicroPython的应用场景包括:
1、为嵌入式产品快速构建原型和用户交互。
2、制作一些小型的可 programmable 硬件项目。
3、作为教育工具,帮助初学者学习Python和物联网编程。
4、构建智能设备固件,实现高级控制和云连接。
5、各种微控制器应用如物联网、嵌入式智能、机器人等。

使用MicroPython需要注意:
1、内存和Flash空间有限。
2、解释执行效率不如C语言。
3、部分库函数与标准版有差异。
4、针对平台优化语法,订正与标准Python的差异。
5、合理使用内存资源,避免频繁分配大内存块。
6、利用原生代码提升速度关键部位的性能。
7、适当使用抽象来封装底层硬件操作。

总体来说,MicroPython让Python进入了微控制器领域，是一项重要的创新，既降低了编程门槛，又提供了良好的硬件控制能力。非常适合各类物联网和智能硬件的开发。

在这里插入图片描述
MicroPython 的 bluetooth 模块是一个用于控制板上蓝牙控制器的接口。它主要支持低功耗蓝牙（BLE）技术，可以在中央、外设、广播和观察者角色中使用，也可以同时扮演多个角色。

低功耗蓝牙（BLE）是一种无线通信技术，它可以在短距离内连接各种智能设备，如手表、健身追踪器、传感器等。它的优点是低功耗、低成本、低复杂度和高安全性。

主要特点:

支持主从蓝牙设备角色,可以作为客户端或服务器端。
实现了经典蓝牙和BLE蓝牙协议栈。
支持扫描、连接远程设备,发送接收数据。
通过回调函数可以自定义协议数据的处理。

应用场景:

连接配件进行无线通信,如蓝牙游戏手柄。
打造心率计、体重秤等蓝牙外设产品。
构建联网门锁、信标等IoT设备。
制作蓝牙遥控和智能家居设备。

MicroPython 的 bluetooth 模块可以用于开发各种基于 BLE 的应用程序，例如：

智能家居：利用 MicroPython 的 bluetooth 模块，可以实现对家庭中的智能设备（如灯光、空调、门锁等）的远程控制和监测。例如，可以使用一个 MicroPython 开发板作为中央设备，通过 BLE 连接多个外设设备，如温湿度传感器、红外遥控器等，然后通过手机或平板电脑上的应用程序来控制和查看这些设备的状态。
健康监测：利用 MicroPython 的 bluetooth 模块，可以实现对人体健康状况的实时监测和分析。例如，可以使用一个 MicroPython 开发板作为外设设备，通过 BLE 连接一个心率传感器，然后将心率数据发送给一个中央设备，如手机或平板电脑上的应用程序，来显示和记录心率曲线，并提供相应的建议和提醒。
物联网：利用 MicroPython 的 bluetooth 模块，可以实现对物联网中的各种设备的连接和交互。例如，可以使用一个 MicroPython 开发板作为观察者设备，通过 BLE 扫描周围的广播设备，如 iBeacon 或 Eddystone 等，然后根据不同的广播信息来执行相应的动作，如打开网页、显示通知或执行任务等。

使用 MicroPython 的 bluetooth 模块时，需要注意以下事项：

在使用该模块上的任何其他方法之前，必须先调用 active 方法来激活 BLE 无线电。
在设置或获取配置值时，需要使用 config 方法，并注意不同的参数和值的含义和范围。
在注册事件回调函数时，需要使用 irq 方法，并注意不同的事件类型和数据格式。
在进行扫描、连接、服务发现、特征读写等操作时，需要注意不同的方法和参数的用法和返回值。
在处理数据时，需要注意数据类型和长度的限制和转换。

在这里插入图片描述

以下是MicroPython的bluetooth几个实际运用程序案例：

案例1：心率监测器：这是一个使用 MicroPython 的 bluetooth 模块作为外设设备，通过 BLE 连接一个心率传感器，并将心率数据发送给一个中央设备的程序案例。假设心率传感器是一个模拟输入引脚，并且使用了 Heart Rate Service 的标准 UUID 和特征。

# 导入 bluetooth 模块
import bluetooth
# 导入 time 模块
import time
# 导入 machine 模块
import machine

# 创建一个 BLE 对象
ble = bluetooth.BLE()
# 激活 BLE 无线电
ble.active(True)

# 定义心率服务的 UUID
HEART_RATE_SERVICE_UUID = bluetooth.UUID(0x180D)
# 定义心率测量特征的 UUID
HEART_RATE_MEASUREMENT_CHAR_UUID = bluetooth.UUID(0x2A37)
# 定义心率测量特征的属性和权限
HEART_RATE_MEASUREMENT_CHAR = (
    HEART_RATE_MEASUREMENT_CHAR_UUID,
    bluetooth.FLAG_READ | bluetooth.FLAG_NOTIFY,
)
# 定义心率服务的特征列表
HEART_RATE_SERVICE = (
    HEART_RATE_SERVICE_UUID,
    (HEART_RATE_MEASUREMENT_CHAR,),
)

# 定义一个函数，用于计算心率值
def get_heart_rate():
    # 读取模拟输入引脚 A0 的电压值
    adc = machine.ADC(0)
    # 将电压值转换为心率值，这里假设有一个简单的线性关系
    # 实际情况可能需要更复杂的算法
    heart_rate = adc.read() * 0.1 + 60
    # 返回心率值，保留整数部分
    return int(heart_rate)

# 定义一个函数，用于发送心率数据
def send_heart_rate():
    # 获取心率值
    heart_rate = get_heart_rate()
    # 打印心率值，用于调试
    print("Heart rate:", heart_rate, "bpm")
    # 创建一个字节对象，用于存储心率数据
    # 第一个字节是标志位，表示心率值是 UINT8 类型
    # 第二个字节是心率值
    heart_rate_data = bytearray([0x00, heart_rate])
    # 通过特征对象发送心率数据
    hr_char.value(heart_rate_data)

# 创建一个服务对象，传入心率服务的定义
service = ble.service(HEART_RATE_SERVICE)
# 获取特征对象，传入心率测量特征的 UUID
hr_char = service.characteristic(HEART_RATE_MEASUREMENT_CHAR_UUID)

# 创建一个定时器对象，传入定时器 ID 和模式（周期性）
tim = machine.Timer(0, mode=machine.Timer.PERIODIC)
# 启动定时器，设置回调函数和周期（1000 毫秒）
tim.start(send_heart_rate, period=1000)

# 设置广播名称为 "MicroPython-HRM"
ble.config(gap_name="MicroPython-HRM")
# 开始广播
ble.gap_advertise(100, adv_data=service.advertise())

案例2：温度传感器：这是一个使用 MicroPython 的 bluetooth 模块作为中央设备，通过 BLE 连接一个温度传感器，并读取温度数据的程序案例。假设温度传感器是一个外设设备，并且使用了 Health Thermometer Service 的标准 UUID 和特征。:

# 导入 bluetooth 模块
import bluetooth

# 创建一个 BLE 对象
ble = bluetooth.BLE()
# 激活 BLE 无线电
ble.active(True)

# 定义温度服务的 UUID
TEMPERATURE_SERVICE_UUID = bluetooth.UUID(0x1809)
# 定义温度测量特征的 UUID
TEMPERATURE_MEASUREMENT_CHAR_UUID = bluetooth.UUID(0x2A1C)

# 定义一个回调函数，用于处理扫描结果
def scan_callback(data):
    # 如果扫描结果是一个广播数据包
    if data.type == bluetooth.BLE.GAP_SCAN_RESULT:
        # 获取广播数据包的地址、地址类型、RSSI 和数据
        addr, addr_type, rssi, adv_data = data.data
        # 如果广播数据包包含温度服务的 UUID
        if TEMPERATURE_SERVICE_UUID in bluetooth.decode_field(adv_data, bluetooth.BLE.GAP_ADTYPE_16BIT_SERVICE_UUID_COMPLETE):
            # 停止扫描
            ble.gap_scan(None)
            # 打印扫描到的设备的地址和 RSSI，用于调试
            print("Found a device with temperature service:", addr, rssi)
            # 尝试连接该设备，设置回调函数和超时时间（10 秒）
            ble.gap_connect(addr_type, addr, 2000, scan_callback, timeout=10000)

    # 如果扫描结果是一个连接事件
    elif data.type == bluetooth.BLE.GAP_CONNECT_RESULT:
        # 获取连接事件的状态、地址、地址类型和连接句柄
        status, addr, addr_type, conn_handle = data.data
        # 如果连接成功
        if status == 0:
            # 打印连接成功的信息，用于调试
            print("Connected to", addr)
            # 尝试发现该设备的服务，设置回调函数
            ble.gattc_discover_services(conn_handle, scan_callback)

    # 如果扫描结果是一个服务发现事件
    elif data.type == bluetooth.BLE.GATTC_SERVICE_RESULT:
        # 获取服务发现事件的连接句柄、起始句柄、结束句柄和 UUID
        conn_handle, start_handle, end_handle, uuid = data.data
        # 如果服务的 UUID 是温度服务的 UUID
        if uuid == TEMPERATURE_SERVICE_UUID:
            # 打印发现温度服务的信息，用于调试
            print("Found temperature service")
            # 尝试发现该服务的特征，设置回调函数
            ble.gattc_discover_characteristics(conn_handle, start_handle, end_handle, scan_callback)

    # 如果扫描结果是一个特征发现事件
    elif data.type == bluetooth.BLE.GATTC_CHARACTERISTIC_RESULT:
        # 获取特征发现事件的连接句柄、声明句柄、值句柄、属性和 UUID
        conn_handle, def_handle, value_handle, properties, uuid = data.data
        # 如果特征的 UUID 是温度测量特征的 UUID
        if uuid == TEMPERATURE_MEASUREMENT_CHAR_UUID:
            # 打印发现温度测量特征的信息，用于调试
            print("Found temperature measurement characteristic")
            # 尝试读取该特征的值，设置回调函数
            ble.gattc_read(conn_handle, value_handle, scan_callback)

    # 如果扫描结果是一个读取事件
    elif data.type == bluetooth.BLE.GATTC_READ_RESULT:
        # 获取读取事件的连接句柄、值句柄和数据
        conn_handle, value_handle, data = data.data
        # 打印读取到的数据，用于调试
        print("Read data:", data)
        # 解析数据，获取温度值，假设数据是一个 4 字节的浮点数（IEEE 754 格式）
        temperature = int.from_bytes(data[:4], "little") / 100.0
        # 打印温度值，保留两位小数
        print("Temperature:", "{:.2f}".format(temperature), "°C")

# 注册事件回调函数，传入扫描回调函数
ble.irq(scan_callback)
# 开始扫描，设置扫描时间（10 秒）
ble.gap_scan(10000)

案例3：用于通过 BLE 连接一个 LED 控制器，并控制 LED 的亮度和颜色。请注意，这个程序可能不是完整的或最优的，仅供参考。

假设 LED 控制器是一个外设设备，并且使用了一个自定义的服务和特征，其 UUID 和数据格式如下：

服务 UUID：6E400001-B5A3-F393-E0A9-E50E24DCCA9E
特征 UUID：6E400002-B5A3-F393-E0A9-E50E24DCCA9E
数据格式：[R, G, B, BRIGHTNESS]，其中 R, G, B 是红、绿、蓝三色的值（0-255），BRIGHTNESS 是亮度的值（0-100）

# 导入 bluetooth 模块
import bluetooth

# 创建一个 BLE 对象
ble = bluetooth.BLE()
# 激活 BLE 无线电
ble.active(True)

# 定义 LED 服务的 UUID
LED_SERVICE_UUID = bluetooth.UUID("6E400001-B5A3-F393-E0A9-E50E24DCCA9E")
# 定义 LED 特征的 UUID
LED_CHAR_UUID = bluetooth.UUID("6E400002-B5A3-F393-E0A9-E50E24DCCA9E")

# 定义一个回调函数，用于处理扫描结果
def scan_callback(data):
    # 如果扫描结果是一个广播数据包
    if data.type == bluetooth.BLE.GAP_SCAN_RESULT:
        # 获取广播数据包的地址、地址类型、RSSI 和数据
        addr, addr_type, rssi, adv_data = data.data
        # 如果广播数据包包含 LED 服务的 UUID
        if LED_SERVICE_UUID in bluetooth.decode_field(adv_data, bluetooth.BLE.GAP_ADTYPE_16BIT_SERVICE_UUID_COMPLETE):
            # 停止扫描
            ble.gap_scan(None)
            # 打印扫描到的设备的地址和 RSSI，用于调试
            print("Found a device with LED service:", addr, rssi)
            # 尝试连接该设备，设置回调函数和超时时间（10 秒）
            ble.gap_connect(addr_type, addr, 2000, scan_callback, timeout=10000)

    # 如果扫描结果是一个连接事件
    elif data.type == bluetooth.BLE.GAP_CONNECT_RESULT:
        # 获取连接事件的状态、地址、地址类型和连接句柄
        status, addr, addr_type, conn_handle = data.data
        # 如果连接成功
        if status == 0:
            # 打印连接成功的信息，用于调试
            print("Connected to", addr)
            # 尝试发现该设备的服务，设置回调函数
            ble.gattc_discover_services(conn_handle, scan_callback)

    # 如果扫描结果是一个服务发现事件
    elif data.type == bluetooth.BLE.GATTC_SERVICE_RESULT:
        # 获取服务发现事件的连接句柄、起始句柄、结束句柄和 UUID
        conn_handle, start_handle, end_handle, uuid = data.data
        # 如果服务的 UUID 是 LED 服务的 UUID
        if uuid == LED_SERVICE_UUID:
            # 打印发现 LED 服务的信息，用于调试
            print("Found LED service")
            # 尝试发现该服务的特征，设置回调函数
            ble.gattc_discover_characteristics(conn_handle, start_handle, end_handle, scan_callback)

    # 如果扫描结果是一个特征发现事件
    elif data.type == bluetooth.BLE.GATTC_CHARACTERISTIC_RESULT:
        # 获取特征发现事件的连接句柄、声明句柄、值句柄、属性和 UUID
        conn_handle, def_handle, value_handle, properties, uuid = data.data
        # 如果特征的 UUID 是 LED 特征的 UUID
        if uuid == LED_CHAR_UUID:
            # 打印发现 LED 特征的信息，用于调试
            print("Found LED characteristic")
            # 定义一个函数，用于控制 LED 的亮度和颜色
            def control_led(r, g, b, brightness):
                # 创建一个字节对象，用于存储 LED 的数据
                # 数据格式是 [R, G, B, BRIGHTNESS]
                led_data = bytearray([r, g, b, brightness])
                # 通过特征对象写入 LED 的数据
                ble.gattc_write(conn_handle, value_handle, led_data)
            # 调用控制 LED 的函数，设置 LED 为红色，亮度为 50%
            control_led(255, 0, 0, 50)

# 注册事件回调函数，传入扫描回调函数
ble.irq(scan_callback)
# 开始扫描，设置扫描时间（10 秒）
ble.gap_scan(10000)

案例4：BLE心率传感器

from ble import BLE
from micropython import const

SERVICE_UUID = const(0x180D)
CHAR_UUID = const(0x2A37)

ble = BLE()
srv = ble.gatts_register_services((SERVICE_UUID,))

while True:
  ble.gap_advertise(20_000)
  conn = ble.gap_connect(timeout=10)
  if conn:
    while conn.connected():
      ble.gatts_notify(conn, srv, CHAR_UUID, get_heart_rate())

在这里插入图片描述

案例5:经典蓝牙遥控车

from bluetooth import BLUETOOTH

bt = BLUETOOTH()
bt.start_scan(-1) 

if bt.is_scanned():
  bt.connect(addr) 
  while True:
    data = bt.recv(64)
    if data[0] == 1: 
      motor1.forward(data[1])
    #...

案例6:iBeacon 信标

from bluetooth import BLE
from micropython import const

SIGNAL_UUID = const(0xAABBCCDD)
MAJOR_ID = const(1000)
MINOR_ID = const(1)

ble = BLE()
ble.config_ibeacon(SIGNAL_UUID, MAJOR_ID, MINOR_ID, -59)

while True:
  ble.advertise()
  sleep(1)

这些案例展示了MicroPython蓝牙编程的一些应用场景,包括BLE和经典蓝牙协议栈的使用。

案例7：蓝牙设备发现：

import bluetooth

# 搜索附近的蓝牙设备
devices = bluetooth.discover_devices()

# 打印搜索到的设备信息
for device in devices:
    print("发现设备：", bluetooth.lookup_name(device), "(", device, ")")

在这个例子中，我们使用bluetooth.discover_devices()函数搜索附近的蓝牙设备，并将搜索到的设备存储在devices列表中。然后，使用bluetooth.lookup_name()函数获取设备的名称，并打印设备信息。

案例8：蓝牙设备配对：:

import bluetooth

# 搜索附近的蓝牙设备
devices = bluetooth.discover_devices()

# 选择要配对的设备
device = devices[0]

# 配对设备
bluetooth.pair(device)

# 打印配对成功的消息
print("设备配对成功！")

在这个例子中，我们使用bluetooth.discover_devices()函数搜索附近的蓝牙设备，并将搜索到的设备存储在devices列表中。然后，选择要配对的设备，并使用bluetooth.pair()函数对设备进行配对。最后，打印配对成功的消息。

案例9：蓝牙数据传输：:

import bluetooth

# 选择要连接的蓝牙设备
server_address = "00:11:22:33:44:55"

# 连接到蓝牙设备
sock = bluetooth.BluetoothSocket(bluetooth.RFCOMM)
sock.connect((server_address, 1))

# 发送数据到设备
data = "Hello, Bluetooth!"
sock.send(data)

# 接收设备发送的数据
received_data = sock.recv(1024)

# 打印接收到的数据
print("接收到的数据：", received_data)

# 关闭连接
sock.close()

在这个例子中，我们选择要连接的蓝牙设备，并使用bluetooth.BluetoothSocket()函数创建一个蓝牙套接字。然后，使用sock.connect()方法连接到选择的设备。接下来，我们可以使用sock.send()方法发送数据到设备，并使用sock.recv()方法接收设备发送的数据。最后，通过调用sock.close()方法关闭连接。

要测试Micropython的经典蓝牙功能，可以使用bluetooth模块，它提供了一些低级的API来配置和控制蓝牙无线电。您可以使用这些API来创建和管理连接，发送和接收数据，以及处理事件。

例如，您可以使用bluetooth.BT()构造函数来创建一个BT对象，然后使用active()方法来激活或停用蓝牙无线电。您还可以使用config()方法来设置或获取蓝牙接口的一些配置值，如地址模式，设备名称，安全模式等。您可以使用irq()方法来注册一个回调函数，用于处理来自蓝牙堆栈的事件，如连接，断开，数据接收等。您可以使用connect()方法来发起一个到远程设备的连接，或者使用listen()方法来等待一个传入的连接。您可以使用send()方法来发送数据，或者使用recv()方法来接收数据。您可以使用disconnect()方法来断开一个连接。

以下是一个简单的参考示例，展示了如何使用Micropython的经典蓝牙模块来创建一个回显服务器，它会将收到的数据原样返回给客户端：

案例10：使用Micropython的经典蓝牙模块来创建一个回显服务器

# Create a BT object
bt = bluetooth.BT()

# Activate the BT radio
bt.active(True)

# Register a callback function to handle events
def bt_irq(event, data):
    # Check the event type
    if event == bluetooth._IRQ_BT_CONNECT:
        # A connection has been established
        conn_handle, addr_type, addr = data
        print("Connected to", addr)
    elif event == bluetooth._IRQ_BT_DISCONNECT:
        # A connection has been terminated
        conn_handle, addr_type, addr = data
        print("Disconnected from", addr)
    elif event == bluetooth._IRQ_BT_DATA_RECEIVED:
        # Data has been received
        conn_handle, data = data
        print("Received", data)
        # Echo the data back
        bt.send(conn_handle, data)

# Set the callback function
bt.irq(bt_irq)

# Set the device name
bt.config(gap_name="Micropython Echo Server")

# Listen for incoming connections
bt.listen()

# Wait for events
while True:
    pass

请注意，以上案例只是为了拓展思路，可能存在不能编译、错误或不适用的情况。不同的硬件平台、使用场景和MicroPython版本可能会导致不同的使用方法。在实际编程中，您需要根据您的硬件配置和具体需求进行调整，并进行多次实际测试。需要正确连接硬件并了解所使用的传感器和设备的规范和特性非常重要。对于涉及到硬件操作的代码，请确保在使用之前充分了解和确认所使用的引脚和电平等参数的正确性和安全性。

在这里插入图片描述

驴友花雕

关注

2
点赞
踩
8

收藏

觉得还不错? 一键收藏
打赏
10
评论
【雕爷学编程】MicroPython手册之特定的库 bluetooth — 低级蓝牙

例如，可以使用一个 MicroPython 开发板作为观察者设备，通过 BLE 扫描周围的广播设备，如 iBeacon 或 Eddystone 等，然后根据不同的广播信息来执行相应的动作，如打开网页、显示通知或执行任务等。例如，可以使用一个 MicroPython 开发板作为外设设备，通过 BLE 连接一个心率传感器，然后将心率数据发送给一个中央设备，如手机或平板电脑上的应用程序，来显示和记录心率曲线，并提供相应的建议和提醒。最后，打印配对成功的消息。请注意，这个程序可能不是完整的或最优的，仅供参考。
复制链接

扫一扫