configureCallback

为与 Bluetooth 设备的通信设置回调函数和触发条件

全页折叠

语法

configureCallback(device,"terminator",callbackFcn)
configureCallback(device,"byte",count,callbackFcn)
configureCallback(device,"off")

说明

configureCallback(device,"terminator",callbackFcn) 将回调函数 callbackFcn 设置为每当可从指定的 Bluetooth® 设备读取终止符时触发。该语法将 device 的 BytesAvailableFcnMode 属性设置为 "terminator"，将 BytesAvailableFcn 属性设置为 callbackFcn。

使用 configureTerminator 设置终止符字符。

示例

configureCallback(device,"byte",count,callbackFcn) 将回调函数 callbackFcn 设置为每当有新的 count 个字节可供读取时触发。该语法将 device 的 BytesAvailableFcnMode 属性设置为 "byte"，将 BytesAvailableFcnCount 属性设置为 count，将 BytesAvailableFcn 属性设置为 callbackFcn。

示例

configureCallback(device,"off") 关闭回调。该语法将 device 的 BytesAvailableFcnMode 属性设置为 "off"。

示例

示例

全部折叠

创建到附近的 Bluetooth 设备的连接。 

device = bluetooth("TestDevice")
device = 
  bluetooth with properties:

                 Name: "TestDevice"
              Address: "BC275C50533C"
              Channel: 1
    NumBytesAvailable: 0
      NumBytesWritten: 0

  Show all properties

将回调设置为当终止符可供读取时触发。

configureCallback(device,"terminator",@callbackFcn)

查看属性以确认更改。

device.BytesAvailableFcnMode
device.BytesAvailableFcn
ans = 

    "terminator"


ans =

  function_handle with value:

    @callbackFcn

关闭回调。

configureCallback(device,"off")

验证回调已关闭。

device.BytesAvailableFcnMode
ans = 

    "off"

创建到附近的 Bluetooth 设备的连接。 

device = bluetooth("TestDevice")
device = 
  bluetooth with properties:

                 Name: "TestDevice"
              Address: "BC275C50533C"
              Channel: 1
    NumBytesAvailable: 0
      NumBytesWritten: 0

  Show all properties

将回调设置为当有 50 个字节的数据可供读取时触发。

configureCallback(device,"byte",50,@callbackFcn)

查看属性以确认更改。

device.BytesAvailableFcnMode
device.BytesAvailableFcnCount
device.BytesAvailableFcn
ans = 

    "byte"


ans =

    50


ans =

  function_handle with value:

    @callbackFcn

关闭回调。

configureCallback(device,"off")

验证回调已关闭。

device.BytesAvailableFcnMode
ans = 

    "off"

输入参数

全部折叠

Bluetooth 设备连接，指定为 bluetooth 对象。

示例: configureCallback(device,"byte",128,@callbackFcn) 将 callbackFcn 回调设置为每当有 128 个字节的新数据可从 Bluetooth 连接 device 读取时触发。

触发回调的可用数据字节数，指定为正整数值。使用此参量设置 BytesAvailableFcnCount 属性。

示例: configureCallback(device,"byte",128,@callbackFcn) 将 callbackFcn 回调设置为每当有 128 个字节的新数据可供读取时触发。

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

满足触发条件时运行的回调函数，指定为函数句柄。函数句柄可以是命名函数句柄，也可以是带输入参量的匿名函数。使用此参量设置 BytesAvailableFcn 属性。

示例: configureCallback(device,"terminator",@callbackFcn) 将 callbackFcn 回调设置为当终止符可供读取时触发。

数据类型: function_handle

版本历史记录

在 R2020b 中推出

另请参阅

函数