主要内容

读

对象上的特征或描述符数据蓝牙低能耗周边设备

在页面中全部折叠

语法

characteristicData = read(c)
characteristicData = read(c,mode)
[characteristicData,timestamp] = read(时间戳)＿＿＿）
descriptorData = read(d)

描述

读取特征值

例子

characteristicData=阅读(c）从蓝牙读取特征值®低能耗外围设备。读取的数据取决于属性属性的输入特征对象c．的所有可能行为的更多信息读,请参阅characteristicData．

例子

characteristicData=阅读(c，模式）指定模式作为读取模式。

例子

［characteristicData，时间戳=读(＿＿＿）读取任何前面语法的时间戳。

读取描述符值

例子

descriptorData=阅读(d）从蓝牙低能外围设备读取描述符值。

例子

全部折叠

打开实时脚本

访问外设设备上的特性并读取其数据。

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

B = ble)“页面”）
名称:"Thingy"地址:"F2DF635320F6"连接:1服务:[9×2 table]特征:[38×5 table]显示服务和特征

创建一个特征对象来表示“温度”的特点。

C =特征(b，“气象站服务”，“温度”）
名称:"Temperature" UUID: "EF680201-9B35-4933-9B10-52FFA9740042"属性:"Notify"描述符:[1x3 table] DataAvailableFcn:[]显示描述符

因为这个特征支持万博1manbetx“通知”，你可以使用读获取最新数据。

数据=读取(c)
data =1×275年23

您还可以返回最新数据的时间戳。

[data,timestamp] = read(c)
data =1×273年23
时间戳=datetime16 - 5 - 2019 16:20:00

用摄氏度解释数据。第一个字节表示温度的整数部分，第二个字节表示分辨率为0.01的小数部分。

温度=数据(1)+数据(2)*0.01
温度= 23.7300
打开实时脚本

访问外设设备上的一个特征并创建一个回调函数来读取其数据。

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

B = ble)“页面”）
名称:"Thingy"地址:"F2DF635320F6"连接:1服务:[9×2 table]特征:[38×5 table]显示服务和特征

创建一个特征对象来表示“温度”的特点。

C =特征(b，“气象站服务”，“温度”）
名称:"Temperature" UUID: "EF680201-9B35-4933-9B10-52FFA9740042"属性:"Notify"描述符:[1x3 table] DataAvailableFcn:[]显示描述符

因为这个特征支持万博1manbetx“通知”，可以创建回调函数。命名函数名称displayCharacteristicData定义如下。指定读模式为“古老的”而不是“最新”．调用“最新”数据可能导致回调函数错误，这是由于刷新以前的数据造成的。

函数displaycharacterticdata (src,evt) [data,timestamp] = read(src, evt)“古老的”）;disp(数据);disp(时间戳);结束

使用@对象的函数句柄DataAvailableFcn特性的性质。当有新的通知可用时，数据将出现在命令窗口中。

c.DataAvailableFcn = @displayCharacteristicData
UUID: "EF680201-9B35-4933-9B10-52FFA9740042"属性:"Notify"描述符:[1x3 table] DataAvailableFcn: displayCharacteristicData显示描述符

在使用完该特性之后，使用退订．

退订(c)
打开实时脚本

访问外设设备上的描述符并读取其数据。

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

B = ble)“DemoDev”）
名称:"DemoDev"地址:"FF548EA5658F"连接:1服务:[5×2 table]特征:[10×5 table]显示服务和特征

创建一个特征对象来表示“心率测量”的特点。

C =特征(b，“心跳”，“心率测量”）
c =具有属性的特征:名称:“心率测量”UUID:“2A37”属性:“通知”描述符:[1x3表]DataAvailableFcn:[]显示描述符

对象创建描述符对象“客户端特性配置”描述符。

D =描述符(c，“客户端特性配置”）
d =有属性的描述符:名称:"Client Characteristic Configuration" UUID: "2902"属性:["Read" "Write"]

此描述符包含关于是否启用或禁用通知和指示的信息。你可以用读获取当前数据。

数据=读取(d)
data =1×20 0

的蓝牙核心规范中找到的此描述符的规范来解释此数据蓝牙SIG网站．

当通知或指示状态更改时，此值也会更改。例如，使用订阅通知订阅．然后，通过再次读取描述符观察值的变化。

订阅(c,“通知”）;数据=读取(d)
data =1×21 0

输入参数

全部折叠

蓝牙低能耗外围设备的特点，指定为特征对象。

的属性属性的特征对象必须包含“读”，“通知”,或“显示”读取数据。

例子:数据=读取(c)读取特征对象的值c．

读取模式，指定为“最新”或“古老的”．使用“最新”返回最近的数据并刷新以前的数据。使用“古老的”返回自最后一次读取以来最老的数据。

请注意

使用“古老的”在DataAvailableFcn回调函数，以避免由于刷新以前的数据而导致的错误。

例子:Data = read(c，'old ')读取特征对象上自最后一次读取以来的最老值c．

数据类型:字符|字符串

蓝牙低能外围设备的描述符，指定为描述符对象。

的属性描述符对象的属性必须包含“读”读取数据。

例子:读(d)读取描述符对象的值d．

输出参数

全部折叠

来自外围设备的特征数据，作为数字或数字数组返回。

读取的数据取决于属性属性和指定的读取模式．

c.Attributes 读(c)或读(c,“最新”) 读(c,“古老的”)

  • “读”

 当前数据。 不受支持万博1manbetx的。

  • “通知”，“显示”，或两者都有

最新的通知或指示数据。

  • 如果通知或指示未启用且这是第一次调用读，然后自动启动通知或指示。

  • 刷新以前的数据。

自上次读取以来最早的通知或指示数据。

  • 如果通知或指示未启用且这是第一次调用读，然后自动启动通知或指示。

  • “读”

    而且

  • “通知”，“显示”，或两者都有

  • 如果通知或指示未启用，则characteristicData当前数据。

  • 如果启用了通知或指示，则characteristicData是最新的通知或指示。

  • 如果通知或指示未启用，则读(c,“古老的”)不支持。万博1manbetx

  • 如果启用了通知或指示，则characteristicData是自上一次读取和刷新之前的数据以来最老的通知或指示数据。

数据类型:双

表示接收到计算机上的特征或描述符数据的时间戳，作为数据返回datetime数组中。

数据类型:datetime

来自外围设备的描述符数据，作为数字返回。

数据类型:双

版本历史

在R2019b中引入

另请参阅

||||

主题