Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

ble

连接到低功耗 Bluetooth 外围设备

说明

ble 对象表示从您的计算机连接到低功耗 Bluetooth® 外围设备。使用 blelist 查找附近可连接的设备。

创建对象

说明

示例

b = ble(name) 使用低功耗 Bluetooth 设备的名称连接到该设备。

示例

b = ble(address) 使用低功耗 Bluetooth 设备的地址连接到该设备。

输入参数

全部展开

设备名称,指定为字符向量或字符串标量。使用 blelist 返回的信息确定您要连接的外围设备的名称。如果设备没有 name,则使用其地址来连接它。

示例: b = ble("Tile") 连接到名为“Tile”的外围设备。

数据类型: char | string

设备地址,指定为字符向量或字符串标量。使用 blelist 返回的信息确定您要连接的外围设备的地址。如果设备没有 name,则使用其地址来连接它。

示例: b = ble("5A8769A09DA6") 连接到 Windows® 计算机上具有 MAC 地址“5A8769A09DA6”的外围设备。

示例: b = ble("121B0BAC-0DE7-4FB1-909A-EEA6877DBC5C") 连接到 macOS 计算机上具有操作系统随机分配的地址“121B0BAC-0DE7-4FB1-909A-EEA6877DBC5C”的外围设备。

数据类型: char | string

属性

全部展开

此属性为只读

外围设备名称,以字符串标量形式返回。

数据类型: string

此属性为只读

外围设备地址,以字符串标量形式返回。在 Windows 上,此值是设备的 48 位 Bluetooth MAC 地址。在 macOS 上,此值是操作系统随机分配的 128 位地址。

数据类型: string

此属性为只读

外围设备连接状态,以数值或逻辑值 1 (true) 或 0 (false) 形式返回。

数据类型: logical

此属性为只读

外围设备上包含的服务,以表形式返回。该表包含以下列。

说明
ServiceName外围设备上包含的服务的名称,以字符串形式返回
ServiceUUID外围设备上包含的服务的 UUID,以字符串形式返回

有关标准服务及其 UUID 的完整列表,请参阅 Bluetooth SIG 网站。所有自定义服务都具有名称“Custom”,因而这些服务是根据其 UUID 值进行区分的。

注意

macOS 上,“Generic Access”和“Generic Attributes”服务及其特征处于隐藏状态。ServicesCharacteristics 属性不显示它们。

数据类型: table

此属性为只读

外围设备上包含的特征,以表形式返回。要访问表中列出的特定特征,请使用 characteristic 创建一个对象。该表包含以下列。

说明
ServiceName外围设备上包含的服务的名称,以字符串形式返回
ServiceUUID外围设备上包含的服务的 UUID,以字符串形式返回
CharacteristicName外围设备上包含的特征的名称,以字符串形式返回
CharacteristicUUID外围设备上包含的特征的 UUID,以字符串形式返回
Attributes支持的对特征的操作,以元胞数组形式返回。有关可能的值,请参阅Attributes属性

有关标准特征及其解释的完整列表,请访问 Bluetooth SIG 网站。所有自定义特征在 Characteristics 表中都具有名称“Custom”,因而这些特征是根据其 UUID 值进行区分的。

注意

macOS 上,“Generic Access”和“Generic Attributes”服务及其特征处于隐藏状态。ServicesCharacteristics 属性不显示它们。

数据类型: table

对象函数

characteristic访问低功耗 Bluetooth 外围设备的特征

示例

全部折叠

搜索低功耗蓝牙外围设备并与之建立连接。

使用 blelist 扫描附近名为 "Gear Fit2 (E16A)" 的外围设备。

blelist("Name","Gear Fit2 (E16A)")
ans=1×5 table
    Index           Name              Address        RSSI    Advertisement
    _____    __________________    ______________    ____    _____________

      1      "Gear Fit2 (E16A)"    "8498663EE16A"    -61     [1×1 struct] 

创建与设备的连接。

b = ble("Gear Fit2 (E16A)")
b = 
  ble with properties:

               Name: "Gear Fit2 (E16A)"
            Address: "8498663EE16A"
          Connected: 1
           Services: [2×2 table]
    Characteristics: [3×5 table]

Show services and characteristics

搜索低功耗蓝牙外围设备并与之建立连接。

使用 blelist 扫描附近名为 "Gear Fit2 (E16A)" 的外围设备。

blelist("Name","Gear Fit2 (E16A)")
ans=1×5 table
    Index           Name              Address        RSSI    Advertisement
    _____    __________________    ______________    ____    _____________

      1      "Gear Fit2 (E16A)"    "8498663EE16A"    -58     [1×1 struct] 

创建与地址为 "8498663EE16A" 的设备的连接。在 Windows 计算机上,此地址表示外围设备的 48 位蓝牙 MAC 地址。

b = ble("8498663EE16A")
b = 
  ble with properties:

               Name: "Gear Fit2 (E16A)"
            Address: "8498663EE16A"
          Connected: 1
           Services: [2×2 table]
    Characteristics: [3×5 table]

Show services and characteristics

搜索低功耗蓝牙外围设备并与之建立连接。

使用 blelist 扫描附近名为 "Gear Fit2 (E16A)" 的外围设备。

blelist("Name","Gear Fit2 (E16A)")
ans=1×5 table
    Index           Name                          Address                    RSSI    Advertisement
    _____    __________________    ______________________________________    ____    _____________

      1      "Gear Fit2 (E16A)"    "2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA"    -49     [1×1 struct] 

创建与地址为 "2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA" 的设备的连接。在 macOS 计算机上,该地址表示操作系统为外围设备随机分配的 128 位地址。

b = ble("2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA")
b = 
  ble with properties:

               Name: "Gear Fit2 (E16A)"
            Address: "2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA"
          Connected: 1
           Services: []
    Characteristics: []

Show services and characteristics

版本历史记录

在 R2019b 中推出