Main Content

write

将数据写入低功耗 Bluetooth 外围设备的特征或描述符

自 R2019b 起

说明

写入特征值

示例

write(c,data) 将指定的 data 写入低功耗 Bluetooth® 外围设备的特征。输入特征对象 cAttributes 属性必须为 "Write" 和/或 "WriteWithoutResponse"

示例

write(c,data,type) 指定设备是否期望收到使用 type 的响应。

示例

write(c,data,precision) 指定写入数据的精度。

示例

write(c,data,precision,type) 指定响应类型和数据精度。

写入描述符值

示例

write(d,data) 将指定的 data 写入低功耗 Bluetooth 外围设备的描述符。描述符 d 必须在其 Attributes 属性中包含 "Write"

示例

write(d,data,precision) 指定写入数据的精度。

示例

全部折叠

将数据写入低功耗蓝牙外围设备上的特征。

创建与附近低功耗蓝牙外围设备的连接。

b = ble("DemoDevice")
b = 
  ble with properties:

               Name: "DemoDevice"
            Address: "5A0B858BC07C"
          Connected: 1
           Services: [5×2 table]
    Characteristics: [12×5 table]

Show services and characteristics

创建一个表示 "Gender" 特征的特征对象。

c = characteristic(b,"User Data","Gender")
c = 
  Characteristic with properties:

             Name: "Gender"
             UUID: "2A8C"
       Attributes: "Read" "Write"
      Descriptors: []

由于此特征为可读可写特征,因此您可以向它写入数据并验证值的变化。使用 read 获取最新数据。

data = read(c)
data = 0

请参考 Bluetooth SIG 网站上的用户数据服务中提供的关于此特征的设定来解释数据。0 表示男性,1 表示女性。将 1 写入特征以表示女性。

write(c,1)

您可以再次读取特征以观测数据的变化。

data = read(c)
data = 1

将数据写入低功耗蓝牙耗外围设备上的描述符。

创建与附近低功耗蓝牙外围设备的连接。

b = ble("DemoDev")
b = 
  ble with properties:

               Name: "DemoDev"
            Address: "FF548EA5658F"
          Connected: 1
           Services: [5×2 table]
    Characteristics: [10×5 table]

Show services and characteristics

创建一个表示 "Heart Rate Measurement" 特征的特征对象。

c = characteristic(b,"Heart Rate","Heart Rate Measurement")
c = 
  Characteristic with properties:

             Name: "Heart Rate Measurement"
             UUID: "2A37"
       Attributes: "Notify"
      Descriptors: [1x3 table]
 DataAvailableFcn: []

Show descriptors

创建一个表示 "Client Characteristic Configuration" 描述符的描述符对象。

d = descriptor(c,"Client Characteristic Configuration")
d = 
  Descriptor with properties:

          Name: "Client Characteristic Configuration"
          UUID: "2902"
    Attributes: ["Read"    "Write"]

该描述符包含关于通知或指示是启用还是禁用的信息。您可以使用 read 获取当前数据。

data = read(d)
data = 1×2

     0     0

请参考 Bluetooth SIG 网站上蓝牙核设定中此描述符的设定来解释这些数据。

当通知或指示状态更改时,此值也会更改。例如,写入此值以对 "Heart Rate Measurement" 特征启用通知。然后,通过再次读取描述符,观测值的变化。

write(d,[1 0])
data = read(d)
data = 1×2

     1     0

输入参数

全部折叠

低功耗 Bluetooth 外围设备的特征,指定为 characteristic 对象。

要写入特征或描述符的数据,指定为标量或数值数组。请参考您的特征或 Bluetooth SIG 网站上的描述符设定,以确定要写入的数据类型。

示例: write(c,[1 0]) 将数值数组写入特征 c

数据类型: double | uint8 | uint16 | uint32 | uint64

特征的响应选项类型,指定为 "withresponse""withoutresponse"。如果您指定 "withresponse",则表示外围设备期望收到设备指示写入成功的响应。如果您指定 "withoutresponse",则表示外围设备不期望响应。默认值取决于特征的 Attributes 属性。

c.Attributes默认值 type
"Write""withresponse"
"WriteWithoutResponse""withoutresponse"
"Write""WriteWithoutResponse""withresponse"

示例: write(c,5,"withoutresponse") 将数据写入特征,但不接收响应。

数据精度,指定为 "uint8""uint16""uint32""uint64"

示例: write(d,300,"uint16") 将数据作为无符号 16 位整数写入特征。

低功耗 Bluetooth 外围设备的描述符,指定为 descriptor 对象。

版本历史记录

在 R2019b 中推出