advertising

广告是设备可以广播的 BLE 的第一阶段

to_hex(seq)

Pretty 将字节序列打印为十六进制值。

to_bytes_literal(seq)

将字节序列打印为仅使用十六进制编码的 Python 字节文字。

decode_data(data, *, key_encoding='B')

使用给定键编码将长度编码结构解码为字典的助手。

compute_length(data_dict, *, key_encoding='B')

计算编码数据字典的长度。

encode_data(data_dict, *, key_encoding='B')

使用给定密钥编码将字典编码为长度编码结构的助手。

class AdvertisingDataField

位于广告或其子类中的任何描述符类的顶级类。

class AdvertisingFlag(bit_position)

AdvertisingFlags 对象中的单个位标志。

class AdvertisingFlags(advertisement, advertising_data_type)

标准广告旗

limited_discovery

只能在有限的时间内发现。

general_discovery

将广告直到发现。

le_only

不支持 BR/EDR。

class String(*, advertising_data_type)

广告中的 UTF-8 编码字符串。

编码后非空终止,因为长度总是被传输。

class Struct(struct_format, *, advertising_data_type)

struct广告中的编码数据。

class LazyObjectField(cls, attribute_name, *, advertising_data_type, **kwargs)

用于将复杂对象延迟绑定到广告对象的非数据描述符。

advertising_data_type

返回用于指示此字段的数据类型值。

class Advertisement(*, entry=None)

核心广告类型。

match_prefixes如果不是 None,则类属性是字节串前缀的元组,以匹配广告中的多个数据结构。

match_prefixes = ()

对于广告, matches将始终返回 True。子类可能会覆盖此值。

short_name

简短的本地设备名称(缩短以适应)。

complete_name

完整的本地设备名称。

tx_power

发射功率电平

appearance

外貌。

rssi

扫描广告的信号强度。仅适用于从 返回的广告 BLERadio.start_scan()。(只读)

classmethod get_prefix_bytes()

将 match_prefixes 的合并版本作为单个字节对象返回,并带有长度标头。

classmethod matches(entry)

返回 True给定的_bleio.ScanEntry 广告字段是否与 match_prefixes元组属性中的所有给定前缀匹配。子类可以覆盖它以匹配任何而不是全部。

classmethod matches_prefixes(entry, *, all_)

返回 True给定的 _bleio.ScanEntry 广告字段是否与 match_prefixes元组属性中的任何或所有给定前缀匹配。如果all_True,则所有前缀必须匹配。如果all_False, True如果至少有一个前缀匹配,则返回。

standard

该模块提供 BLE 标准定义的广告。广告是单一用途的,即使多个用途实际上可能存在于单个数据包中。

class BoundServiceList(advertisement, *, standard_services, vendor_services)

服务 UUID 对象的类序列对象。它存储标准和供应商 UUID。

append(service)

将服务附加到列表中。

extend(services)

将 iterable 中的所有服务附加到列表中。

class ServiceList(*, standard_services, vendor_services)

延迟绑定相应 BoundServiceList 的服务 UUID 列表的描述符。

class ProvideServicesAdvertisement(*services, entry=None)

通告设备在连接时提供哪些服务。

services

设备可以提供的服务列表。

classmethod matches(entry)

在 ProvideServicesAdvertisement 中只需要存在一种服务列表,因此覆盖默认行为并匹配任何前缀,而不是全部。

class SolicitServicesAdvertisement(*services, entry=None)

通告设备希望通过连接使用哪些服务。

solicited_services

设备想要使用的服务列表。

class ManufacturerData(obj, *, advertising_data_type=255, company_id, key_encoding='B')

封装制造商特定的键控数据字节。制造商由 company_id 标识,数据的结构类似于具有可配置密钥格式的广告。序列化的数据的顺序由顺序所确定的 ManufacturerDataField这可能是有用的-属性在设置 match_prefixes在一个 Advertisement子类。

class ManufacturerDataField(key, value_format, field_names=None)

制造商特定数据中的单个数据。格式可以重复。

class ServiceData(service)

封装服务数据。它被读取为内存视图,可以操作或设置为字节数组以更改大小。

adafruit

该模块提供了 Adafruit 定义的广告。

Adafruit 制造数据与广告数据和 Apple 制造数据一样是关键编码的。但是,密钥是 16 位的,可以实现许多不同的用途。Adafruit 客户可以将 0xf000 以上的密钥用于他们自己的数据。

class AdafruitColor(*, entry=None)

广播单个 RGB 颜色。

color

以 RGB 整数形式广播的颜色。