Main Content

ble

连接到低功耗 Bluetooth 外围设备

自 R2019b 起

全页展开

说明

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

创建对象

语法

b = ble(name)
b = ble(address)

描述

示例

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”服务及其特征处于隐藏状态。Services 和 Characteristics 属性不显示它们。

数据类型: table

此 属性 为只读。

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

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

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

注意

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

数据类型: 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 中推出

另请参阅

|

主题