descriptor

Доступ к дескриптору на периферийном устройстве Bluetooth Low Energy

Описание

A descriptor объект представляет дескриптор Bluetooth® Низкоэнергетическое периферийное устройство. Если чтение или запись поддерживаются в объекте Attributes свойство, вы можете считать данные используя read или записать данные используя write.

Создание

Описание

пример

d = descriptor(c,descriptorName) создает объект, который представляет дескриптор, заданный его именем. Идентифицируйте descriptorName при просмотре Descriptors свойство characteristic c объекта.

пример

d = descriptor(c,descriptorUUID) создает объект, который представляет дескриптор, заданный его UUID. Идентифицируйте descriptorUUID при просмотре Descriptors свойство characteristic c объекта.

Входные параметры

расширить все

Характеристика периферийного устройства Bluetooth Low Energy, заданная как characteristic объект.

Имя дескриптора, заданное как вектор символов или строковый скаляр. Идентифицируйте descriptorName в Descriptors таблицы characteristic объект. The DescriptorName в столбце перечислены допустимые значения.

Пример: d = descriptor(c,"Client Characteristic Configuration") создает объект, который представляет "Client Characteristic Configuration"дескриптор характеристики c.

Типы данных: char | string

Дескриптор UUID, заданный как вектор символов или строковый скаляр. Идентифицируйте descriptorUUID в Descriptors таблицы characteristic объект. The DescriptorUUID в столбце перечислены допустимые значения.

Пример: d = descriptor(c,"2902") создает объект, который представляет дескриптор с UUID "2902"на характеристике c.

Типы данных: char | string

Свойства

расширить все

Это свойство доступно только для чтения.

Имя дескриптора, возвращенное как строковый скаляр.

Типы данных: string

Это свойство доступно только для чтения.

Дескриптор UUID, возвращенный как строковый скаляр. Это значение характерно для каждого дескриптора.

Типы данных: string

Это свойство доступно только для чтения.

Атрибуты дескриптора, которые описывают разрешения на чтение и запись, возвращенные как строковые массивы. Следующие возможные значения.

ЗначениеОписание
"Read"Дескриптор можно считать используя read
"Write"Дескриптор можно записать, используя write

Типы данных: string

Функции объекта

readЧтение данных характеристики или дескриптора на периферийном устройстве Bluetooth Low Energy
writeЗапись данных в характеристику или дескриптор на периферийном устройстве Bluetooth Low Energy

Примеры

свернуть все

Создайте соединение с ближайшим периферийным устройством Bluetooth Low Energy.

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

               Name: "Thingy"
            Address: "F2DF635320F6"
          Connected: 1
           Services: [9×2 table]
    Characteristics: [38×5 table]

Show services and characteristics

Создайте объект характеристики, который представляет "Temperature" характеристика.

c = characteristic(b,"Weather Station Service","Temperature")
c = 
  Characteristic with properties:

             Name: "Temperature"
             UUID: "EF680201-9B35-4933-9B10-52FFA9740042"
       Attributes: "Notify"
      Descriptors: [1x3 table]
 DataAvailableFcn: []

Show descriptors

Перечислите дескрипторы для характеристики.

c.Descriptors
ans=1×3 table
               DescriptorName                DescriptorUUID     Attributes 
    _____________________________________    ______________    ____________

    "Client Characteristic Configuration"        "2902"        {1×2 string}

Создайте объект дескриптора, который представляет "Client Characteristic Configuration".

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

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

Кроме того, для создания объекта можно использовать UUID вместо имени.

d = descriptor(c,"2902")
d = 
  Descriptor with properties:

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

Этот объект представляет "Client Characteristic Configuration" дескриптор. Так как у него оба Read и Write атрибуты, которые можно использовать read или write.

Введенный в R2019b
Для просмотра документации необходимо авторизоваться на сайте