物联网AI MicroPython学习之语法 bluetooth蓝牙

学物联网,来万物简单IoT物联网!!

bluetooth 介绍

该模块为板上的蓝牙控制器提供了相关接口。目前支持低功耗蓝牙 (BLE)的Central(中央), Peripheral(外设), Broadcaster(广播者), 和Observer (观察者)角色,以及 GATT 的服务器(Server)和客户端(Client)。

  • 注意事项: 当前该模块只支持低功耗蓝牙(BLE),经典蓝牙部分暂时不支持。

接口说明

BLE - 创建BLE对象

bluetooth.BLE

类功能: 该类为低功耗蓝牙(BLE),是bluetooth模块中主要的类。

  • 函数功能: 创建BLE对象。
  • 函数原型:ble = bluetooth.BLE()
  • 参数说明: 无
  • 返回值: BLE对象成功,返回单例的BLE对象;BLE对象创建失败,返回None
  • 示例代码:
python 复制代码
import bluetooth 
ble = bluetooth.BLE()

active - 启动/关闭BLE

  • 函数功能: 启动或关闭BLE,并返回当前状态。
  • 注意事项: 在使用此类上的任何其他方法之前,必须打开BLE。
  • 函数原型:BLE.active(status)
  • 参数说明:
参数 类型 必选参数? 说明
status 布尔型 True:打开BLE False: 关闭BLE
  • 返回值: 无
  • 示例:
python 复制代码
import bluetooth 
ble = bluetooth.BLE() 
ble.active(True)

config - 获取或配置BLE相关参数

  • 函数功能: 获取或设置 BLE 接口的配置值。要获得一个值,参数名称应为一个字符串,并且一次只查询一个参数。要设置值,请使用关键字语法,并且一次可以设置一个或多个参数。

  • 注意事项: 需确保BLE打开。如果不使用此函数配置将使用空值或默认值。

  • 函数原型:BLE.config('param' ) BLE.config(*, param=value, ...)

  • 参数说明: 当前支持的值是:

    'mac':当前使用的地址,取决于当前的地址模式。这将返回一个元组。(addr_type, addr)

    'addr_mode': 设置地址模式。值可以是:
    0x00 - PUBLIC - 使用控制器的公共地址。 0x01 - RANDOM - 使用生成的静态地址。 0x02 - RPA - 使用可解析的私有地址。 0x03 - NRPA - 使用不可解析的私有地址。 默认情况下使用 PUBLIC 地址,否则将使用 RANDOM 地址。

    'gap_name': 获取/设置服务0x1800使用的GAP设备名称,特征0x2a00。这可以随时设置并多次更改。

    'rxbuf':获取/设置用于存储传入事件的内部缓冲区的大小(以字节为单位)。该缓冲区对整个 BLE 驱动程序是全局的。此项配置值改大可以更好地处理突发传入数据(例如扫描结果)和接收更大特征值的能力。

    'mtu':获取/设置将在 ATT MTU 交换期间使用的 MTU。生成的 MTU 将是该 MTU 和远程设备的 MTU 中的最小值。ATT MTU 交换不会自动发生(除非远程设备通过gattc_exchange_mtu启动它)。

    'bond':设置配对时是否启用绑定。启用后,配对请求将设置"绑定"标志,并且密钥将由两个设备存储。

    'mitm': 设置配对是否需要 MITM 保护。

    'io':设置此设备的 I/O 功能。

    可用选项有:
    _IO_CAPABILITY_DISPLAY_ONLY = const(0) _IO_CAPABILITY_DISPLAY_YESNO = const(1) _IO_CAPABILITY_KEYBOARD_ONLY = const(2) _IO_CAPABILITY_NO_INPUT_OUTPUT = const(3) _IO_CAPABILITY_KEYBOARD_DISPLAY = const(4)

    'le_secure':设置是否需要"LE Secure"配对。默认为 false(即允许"传统配对")。

  • 返回值: 无

  • 示例:

python 复制代码
import bluetooth 
ble = bluetooth.BLE() 
ble.active(True) 
ble.config(rxbuf=1024)

irq - 事件处理

  • 函数功能: 注册一个BLE协议栈的事件回调。回调函数带两个参数: event - 事件码 和 data - 事件值的元组类型。
  • 注意事项: 在元组中的addr, adv_data,char_data,notify_data,和uuid 是只读的,指向bluetooth的内部ringbuffer,并且仅在IRQ处理函数的调用期间有效。如果程序需要保存这些值,以在 IRQ 处理程序返回后访问(例如,通过将其保存在类实例或全局变量中),那么它需要通过使用bytes() 或bluetooth.UUID()等方式获取数据的副本,像这样:

connected_addr = bytes(addr) # equivalently: adv_data, char_data, or notify_data matched_uuid = bluetooth.UUID(uuid)

例如,扫描结果的 IRQ 处理程序可能会检查adv_data 以决定它是否是正确的设备,然后才复制地址数据以在程序的其他地方使用。并且需要从 IRQ 处理程序中打印数据 print(bytes(addr))。

  • 函数原型:BLE.irq(handler)
  • 参数说明:
参数 类型 必选参数? 说明
handler 函数型 函数带两个输入参数event和data
  • 返回值: 无
  • 示例:
python 复制代码
def bt_irq(event, data):     
	if event == _IRQ_CENTRAL_CONNECT:         
        # A central has connected to this peripheral.         
        conn_handle, addr_type, addr = data     
	elif event == _IRQ_CENTRAL_DISCONNECT:         
    	# A central has disconnected from this peripheral.         
    	conn_handle, addr_type, addr = data    
	elif event == _IRQ_SCAN_RESULT:         
    	# A single scan result.         
    	addr_type, addr, adv_type, rssi, adv_data = data     
	elif event == _IRQ_SCAN_DONE:         
    	# Scan duration finished or manually stopped.         
    	pass     
	elif event == _IRQ_PERIPHERAL_CONNECT:         
    	# A successful gap_connect().         
    	conn_handle, addr_type, addr = data     
	elif event == _IRQ_PERIPHERAL_DISCONNECT:         
    	# Connected peripheral has disconnected.         
    	conn_handle, addr_type, addr = data 
BLE.irq(bt_irq)

事件代码是:

python 复制代码
from micropython import const
_IRQ_CENTRAL_CONNECT = const(1)
_IRQ_CENTRAL_DISCONNECT = const(2)
_IRQ_GATTS_WRITE = const(3)
_IRQ_GATTS_READ_REQUEST = const(4)
_IRQ_SCAN_RESULT = const(5)
_IRQ_SCAN_DONE = const(6)
_IRQ_PERIPHERAL_CONNECT = const(7)
_IRQ_PERIPHERAL_DISCONNECT = const(8)
_IRQ_GATTC_SERVICE_RESULT = const(9)
_IRQ_GATTC_SERVICE_DONE = const(10)
_IRQ_GATTC_CHARACTERISTIC_RESULT = const(11)
_IRQ_GATTC_CHARACTERISTIC_DONE = const(12)
_IRQ_GATTC_DESCRIPTOR_RESULT = const(13)
_IRQ_GATTC_DESCRIPTOR_DONE = const(14)
_IRQ_GATTC_READ_RESULT = const(15)
_IRQ_GATTC_READ_DONE = const(16)
_IRQ_GATTC_WRITE_DONE = const(17)
_IRQ_GATTC_NOTIFY = const(18)
_IRQ_GATTC_INDICATE = const(19)
_IRQ_GATTS_INDICATE_DONE = const(20)
_IRQ_MTU_EXCHANGED = const(21)
_IRQ_L2CAP_ACCEPT = const(22)
_IRQ_L2CAP_CONNECT = const(23)
_IRQ_L2CAP_DISCONNECT = const(24)
_IRQ_L2CAP_RECV = const(25)
_IRQ_L2CAP_SEND_READY = const(26)
_IRQ_CONNECTION_UPDATE = const(27)
_IRQ_ENCRYPTION_UPDATE = const(28)
_IRQ_GET_SECRET = const(29)
_IRQ_SET_SECRET = const(30)

gap_advertise - 开启或关闭BLE广播

  • 函数功能: 设置一个特定的广播间隔(单位是微秒)开启BLE广播,此间隔最低为625us。 关闭BLE广播时,将广播间隔参数(interval_us)设为None。
  • 注意事项: 广播者角色时使用
  • 函数原型:*BLE.gap_advertise(interval_us, adv_data=None, , resp_data=None, connectable=True)
  • 参数说明:
参数 类型 必选参数? 说明
interval_us 整型 广播间隔,为None时关闭广播
adv_data string adv_data可指向实现缓冲协议的任何类型(例如bytes,bytearray,str),为None时则使用上一次调用时候的值
resp_data string resp_data可指向实现缓冲协议的任何类型(例如bytes,bytearray,str),为None时则使用上一次调用时候的值
connectable 布尔型 表示是否可连接
  • 返回值: 无
  • 示例:
python 复制代码
import bluetooth
ble = bluetooth.BLE()
ble.active(True)
# payload 需要具体定义
ble.gap_advertise(500000, adv_data=payload)

gap_scan - BLE扫描

  • 函数功能: 以一个特定的间隔(interval_us)和 窗口(window_us)执行BLE扫描操作; 扫描器将每interval_us微秒运行window_us 微秒,总共持续duration_ms毫秒。默认间隔和窗口分别为 1.28 秒和 11.25 毫秒(后台扫描)
  • 注意事项: 对于每个扫描结果,将触发_IRQ_SCAN_RESULT事件,并带有事件数据(addr_type, addr, adv_type, rssi, adv_data)。 当扫描停止时(由于持续时间完成或明确停止),将触发_IRQ_SCAN_DONE事件。 观察者角色时使用。

addr_type 值表示公共或随机地址:
0x00 - 公共 0x01 - RANDOM(静态、RPA 或 NRPA,类型在地址本身中编码)

adv_type 值对应于蓝牙规范:
0x00 - ADV_IND - 可连接和可扫描的无向广告 0x01 - ADV_DIRECT_IND - 可连接的定向广告 0x02 - ADV_SCAN_IND - 可扫描的无向广告 0x03 - ADV_NONCONN_IND - 不可连接的无向广告 0x04 - SCAN_RSP - 扫描响应

  • 函数原型:BLE.gap_scan( duration_ms , interval_us=1280000 , window_us=11250 , active=False )
  • 参数说明:
参数 类型 必选参数? 说明
duration_ms 整型 扫描持续时间,单位为毫秒,当设为0时,无限期扫描;当设为None时停止扫描
interval_us 整型 扫描间隔时间,单位为微秒
window_us 整型 扫描窗口时间,单位为微秒
active 布尔型 设为True时,表示要在结果中接受扫描响应(scan_rsp),默认为False
  • 返回值: 无
  • 示例:
python 复制代码
import bluetooth
ble = bluetooth.BLE()
ble.active(True)

ble.gap_scan(2000, 30000, 20000)

gap_connect - 连接BLE外围设备

  • 函数功能: 连接BLE外围设备
  • 注意事项: 中央设备(Central)以观察者角色通过gap_scan方法获得外围设备信息,或者已知外围设备地址, 之后可通过设备信息触发BLE连接请求。 成功后,将触发_IRQ_PERIPHERAL_CONNECT事件,该事件data中带有连接句柄。
  • 函数原型:BLE.gap_connect( addr_type , addr , scan_duration_ms=2000 , min_conn_interval_us=None , max_conn_interval_us=None )
  • 参数说明:
参数 类型 必选参数? 说明
addr_type 枚举型 0x00 - 公共地址;0x01 - 随机地址
addr string 要连接的设备地址
scan_duration_ms 整型 设备将等待最多scan_duration_ms以从设备接收广播负载
min_conn_interval_us 整型 连接间隔的最小值,单位为微秒
max_conn_interval_us 整型 连接间隔的最大值,单位为微秒
  • 返回值: 无
  • 示例:
python 复制代码
import bluetooth
ble = bluetooth.BLE()
ble.active(True)
# addr = xx:xx:xx:xx:xx:xx
ble.connect(0x00, addr)

gap_disconnect - 断开BLE外围设备

  • 函数功能:

    断开指定连接句柄的BLE连接。可以是从中央设备发起,也可是由外围设备发起。

  • 注意事项:

    成功后,将触发_IRQ_PERIPHERAL_DISCONNECT 或者 _IRQ_CENTRAL_DISCONNECT事件

  • 函数原型:

BLE.gap_disconnect(conn_handle)

  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
  • 返回值:

    False: 该连接句柄未连接;

    True: 表示调用成功;

  • 示例:

Python 复制代码
import bluetooth
ble = bluetooth.BLE()
...
ble.gap_disconnect(handle)

gatts_register_services - 注册GATT服务

一个 GATT 服务器有一组注册服务。每个服务可能包含一个或多个特性,每个特性都有一个值。特征还可以包含描述符,描述符本身也具有值。 这些值存储在本地,并由服务注册期间生成的"值句柄"访问。它们也可以从远程客户端设备读取或写入。此外,服务器可以通过连接句柄主动向连接的客户端"通知"特征。 在大多数情况下,外围设备充当GATT 服务器。

  • 函数功能: 使用指定的服务配置服务器
  • 注意事项: 在注册服务之前必须停BLE广播。每个服务都是一个两个元素的元组,其中一个是UUID, 另一个是特征值的列表。 每个特征值都是一个两个或三个元素的元组,包含一个UUID, 一个标示值,另一个可选的描述符列表; 每个描述符都一个两个元素的元组,包含一个UUID, 一个标示值。 这些标示值是由下面定义的标示按位或的组合,他们设置了特征或者描述符的行为及安全和隐私要求。
python 复制代码
 from micropython import const
_FLAG_BROADCAST = const(0x0001)
_FLAG_READ = const(0x0002)
_FLAG_WRITE_NO_RESPONSE = const(0x0004)
_FLAG_WRITE = const(0x0008)
_FLAG_NOTIFY = const(0x0010)
_FLAG_INDICATE = const(0x0020)
_FLAG_AUTHENTICATED_SIGNED_WRITE = const(0x0040)

_FLAG_AUX_WRITE = const(0x0100)
_FLAG_READ_ENCRYPTED = const(0x0200)
_FLAG_READ_AUTHENTICATED = const(0x0400)
_FLAG_READ_AUTHORIZED = const(0x0800)
_FLAG_WRITE_ENCRYPTED = const(0x1000)
_FLAG_WRITE_AUTHENTICATED = const(0x2000)
_FLAG_WRITE_AUTHORIZED = const(0x4000)
  • 函数原型:BLE.gatts_register_services( services_definition )
  • 参数说明:
参数 类型 必选参数? 说明
services_definition 列表 服务列表
  • 返回值: 一个元组列表, 每个元组代表一个服务,元组中的每个元素对应一个值句柄,特征和描述符句柄按照定义的顺序平展为同一个元组。 以下示例注册了两个服务(HR 和 UART),这三个值句柄(hr, tx, rx)可用于gatts_read, gatts_write, gatts_notify和gatts_indicate。
  • 示例:
python 复制代码
HR_UUID = bluetooth.UUID(0x180D)
HR_CHAR = (bluetooth.UUID(0x2A37), bluetooth.FLAG_READ | bluetooth.FLAG_NOTIFY,)
HR_SERVICE = (HR_UUID, (HR_CHAR,),)
UART_UUID = bluetooth.UUID('6E400001-B5A3-F393-E0A9-E50E24DCCA9E')
UART_TX = (bluetooth.UUID('6E400003-B5A3-F393-E0A9-E50E24DCCA9E'), bluetooth.FLAG_READ | bluetooth.FLAG_NOTIFY,)
UART_RX = (bluetooth.UUID('6E400002-B5A3-F393-E0A9-E50E24DCCA9E'), bluetooth.FLAG_WRITE,)
UART_SERVICE = (UART_UUID, (UART_TX, UART_RX,),)
SERVICES = (HR_SERVICE, UART_SERVICE,)
( (hr,), (tx, rx,), ) = bt.gatts_register_services(SERVICES)

gatts_read - 读取本地值

  • 函数功能: 读取本地GATT服务中的特征值
  • 注意事项: 这个值可能是通过本地gatts_write写入的,也可能是通过远程客户端写入的。
  • 函数原型:BLE.gatts_read(value_handle)
  • 参数说明:
参数 类型 必选参数? 说明
value_handle 整型 值句柄
  • 返回值: 无
  • 示例: 无

gatts_write - 写入本地值

  • 函数功能: 写入本地GATT服务中的特征值
  • 注意事项: 写入后,客户端可以读取该值。
  • 函数原型:BLE.gatts_write( value_handle , data , send_update=False )
  • 参数说明:
参数 类型 必选参数? 说明
value_handle 整型 值句柄
data string 写入数据
send_update 布尔型 为True时,任何订阅此值的此客户端都将收到该特征值写入的通知
  • 返回值: 无
  • 示例: 无

gatts_notify - 发送通知请求

  • 函数功能: 向连接的客户端发送通知请求
  • 注意事项: 无论客户端是否订阅了此特征值,都会发送通知。
  • 函数原型:BLE.gatts_notify( conn_handle , value_handle , data=None )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
value_handle 整型 值句柄
data string 如果data不为None,则将该值发送给客户端,本地值不会被修改。如果data为None,则将发送当前本地值给客户端
  • 返回值: 无
  • 示例: 无

gatts_indicate - 发送指示请求

  • 函数功能: 向连接的客户端发送指示请求
  • 注意事项: 无论客户端是否订阅了此特征值,都会发送通知。 在确认(或失败,如超时)时,将触发_IRQ_GATTS_INDICATE_DONE 事件
  • 函数原型:BLE.gatts_indicate( conn_handle , value_handle )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
value_handle 整型 值句柄
  • 返回值: 无
  • 示例: 无

gatts_set_buffer - 设置缓冲区

  • 函数功能: 设置值的内部缓冲区大小(与Byte为单位),默认值是20.
  • 注意事项: 无
  • 函数原型:BLE.gatts_set_buffer ( value_handle , len , append = False)
  • 参数说明:
参数 类型 必选参数? 说明
value_handle 整型 值句柄
len 整型 缓冲区大小
append 布尔值 为True时,将使所有远程写入追加到当前值,而不是覆盖当前值,执行gatts_read读取值后该值清零
  • 返回值: 无
  • 示例: 无

gattc_discover_services - 查询服务

GATT 客户端(Client)可发现和读取/写入远程GATT服务上的特征。 一般情况下,Central 角色充当GATT 客户端。

  • 函数功能: 查询已连接GATT服务器的服务
  • 注意事项: 每发现一个服务,都将触发 _IRQ_GATTC_SERVICE_RESULT 事件,服务操作完毕后,将触发_IRQ_GATTC_SERVICE_DONE 事件。
  • 函数原型:BLE.gattc_discover_services( conn_handle , uuid=None )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
uuid string 指定服务的uuid, 当uuid不为None时,仅查询该服务
  • 返回值: 无
  • 示例: 无

gattc_discover_characteristics - 查询特征

  • 函数功能: 查询连接的服务器以获取指定范围内的特征
  • 注意事项: 每发现一个特征,都将触发 _IRQ_GATTC_CHARACTERISTIC_RESULT 事件,发现特征操作完毕后,将触发 _IRQ_GATTC_CHARACTERISTIC_DONE 事件。
  • 函数原型:BLE.gattc_discover_characteristics( conn_handle , start_handle , end_handle , uuid=None )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
start_handle 整型 起始的特征句柄
end_handle 整型 结束的特征句柄
uuid string 指定特征的uuid, 当uuid不为None时,仅查询该特征
  • 返回值: 无
  • 示例: 无

gattc_discover_descriptors - 查询描述符

  • 函数功能: 向连接的服务器查询指定范围内的描述符
  • 注意事项: 每发现一个描述符,都将触发 _IRQ_GATTC_DESCRIPTOR_RESULT 事件,发现描述符操作结束后,将触发 _IRQ_GATTC_DESCRIPTOR_DONE 事件。
  • 函数原型:BLE.gattc_discover_descriptors( conn_handle , start_handle , end_handle )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
start_handle 整型 起始的特征句柄
end_handle 整型 结束的特征句柄
  • 返回值: 无
  • 示例: 无

gattc_read - GATT远程读操作

  • 函数功能: 向连接的服务器发出远程读取
  • 注意事项: 当值可用时,将触发 _IRQ_GATTC_READ_RESULT 事件,里面带有读取的结果。此外,读取完毕将触发_IRQ_GATTC_READ_DONE 事件。
  • 函数原型:BLE.gattc_read( conn_handle , value_handle )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
value_handle 整型 要读取的特征的句柄
  • 返回值: 无
  • 示例: 无

gattc_write - GATT远程写操作

  • 函数功能: 向连接的服务器发出远程写
  • 注意事项: 如果收到来自远程服务器的响应,将触发 _IRQ_GATTC_WRITE_DONE 事件。
  • 函数原型:BLE.gattc_write( conn_handle , value_handle , data , mode=0 )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
value_handle 整型 要写的特征的句柄
mode 整型 mode=0(默认值),是无响应写入,对方不返回确认,也不会触发任何事件; mode=1是 write-with-response,远程服务器发送它收到数据的响应/确认
  • 返回值: 无
  • 示例: 无

gattc_exchange_mtu - 交换MTU

  • 函数功能: 触发MTU交换流程,使用之前config的MTU值。
  • 注意事项: 当MTU交换完成后,将触发 _IRQ_MTU_EXCHANGED 事件。 MTU交换通常由Central 角色设备发起。有些底层协议栈不支持MTU交换功能。
  • 函数原型:BLE.gattc_exchange_mtu( conn_handle )
  • 参数说明:
参数 类型 必选参数? 说明
conn_handle 整型 连接句柄
  • 返回值: 无
  • 示例: 无

bluetooth.UUID

  • 类功能: 创建具有指定值的UUID实例。
  • 注意事项: UUID可以是一个16位整数,例如 0x2908; 也可以是128位的UUID字符,例如'6E400001-B5A3-F393-E0A9-E50E24DCCA9E'
  • 示例:
python 复制代码
HR_UUID = bluetooth.UUID(0x180D)
HR_CHAR = (bluetooth.UUID(0x2A37), bluetooth.FLAG_READ | bluetooth.FLAG_NOTIFY,)
HR_SERVICE = (HR_UUID, (HR_CHAR,),)
UART_UUID = bluetooth.UUID('6E400001-B5A3-F393-E0A9-E50E24DCCA9E')
UART_TX = (bluetooth.UUID('6E400003-B5A3-F393-E0A9-E50E24DCCA9E'), bluetooth.FLAG_READ | bluetooth.FLAG_NOTIFY,)
UART_RX = (bluetooth.UUID('6E400002-B5A3-F393-E0A9-E50E24DCCA9E'), bluetooth.FLAG_WRITE,)
UART_SERVICE = (UART_UUID, (UART_TX, UART_RX,),)
SERVICES = (HR_SERVICE, UART_SERVICE,)
( (hr,), (tx, rx,), ) = bt.gatts_register_services(SERVICES)
相关推荐
DREAM依旧7 分钟前
隐马尔科夫模型|前向算法|Viterbi 算法
人工智能
ROBOT玲玉11 分钟前
Milvus 中,FieldSchema 的 dim 参数和索引参数中的 “nlist“ 的区别
python·机器学习·numpy
超能力MAX12 分钟前
IIC驱动EEPROM
单片机·嵌入式硬件·fpga开发
QQ54717605215 分钟前
stm32实现回调功能
stm32·单片机·嵌入式硬件
GocNeverGiveUp20 分钟前
机器学习2-NumPy
人工智能·机器学习·numpy
虾球xz1 小时前
游戏引擎学习第55天
学习·游戏引擎
Kai HVZ1 小时前
python爬虫----爬取视频实战
爬虫·python·音视频
古希腊掌管学习的神1 小时前
[LeetCode-Python版]相向双指针——611. 有效三角形的个数
开发语言·python·leetcode
m0_748244831 小时前
StarRocks 排查单副本表
大数据·数据库·python
oneouto1 小时前
selenium学习笔记(二)
笔记·学习·selenium