write

Запишите данные к характеристике или дескриптору на Bluetooth Низкое энергетическое периферийное устройство

Описание

Запишите характеристические значения

пример

write(c,data) пишет заданный data к характеристике периферийного устройства Bluetooth® Low Energy. Attributes свойство входного объекта c характеристики должен быть "Write" и/или "WriteWithoutResponse".

пример

write(c,data,type) задает, ожидает ли устройство ответ назад с помощью type.

пример

write(c,data,precision) задает точность записанных данных.

пример

write(c,data,precision,type) задает и тип ответа и точность данных.

Запишите значения дескриптора

пример

write(d,data) пишет заданный data к дескриптору Bluetooth Низкое энергетическое периферийное устройство. Дескриптор d должен иметь "Write" в его Attributes свойство.

пример

write(d,data,precision) задает точность записанных данных.

Примеры

свернуть все

Запишите данные к характеристике на Bluetooth Низкое энергетическое Периферийное устройство.

Создайте связь с соседним Bluetooth Низкое энергетическое периферийное устройство.

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

Интерпретируйте данные путем обращения к спецификации для этой характеристики на веб-сайте SIG Bluetooth. 0 представляет штекер и 1 представляет розетку. Запишите 1 к характеристике, чтобы указать на розетку.

write(c,1)

Можно читать из характеристики снова, чтобы наблюдать изменение в данных.

data = read(c)
data = 1

Запишите данные к дескриптору на Bluetooth Низкое энергетическое Периферийное устройство.

Создайте связь с соседним Bluetooth Низкое энергетическое периферийное устройство.

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

Интерпретируйте эти данные путем обращения к спецификации для этого дескриптора на веб-сайте SIG Bluetooth.

Это значение изменяется когда уведомление или изменения состояния индикации. Например, запишите в это значение, чтобы включить уведомление для "Heart Rate Measurement" характеристика. Затем наблюдайте изменение в значениях путем чтения дескриптора снова.

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

     1     0

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

свернуть все

Характеристика Bluetooth Низкое энергетическое периферийное устройство в виде a characteristic объект.

Данные, чтобы записать в характеристику или дескриптор в виде скаляра или массива чисел. Обратитесь к своей характеристике или техническим требованиям дескриптора, чтобы определить какой данные, чтобы записать.

Пример: write(c,[1 0]) пишет массив чисел к характеристическому c.

Типы данных: double | uint8 | uint16 | uint32 | uint64

Опция ответа вводит для характеристики в виде "withresponse" или "withoutresponse". Если вы задаете "withresponse", периферийное устройство ожидает ответ от устройства, указывающего, что запись успешна. Если вы задаете "withoutresponse", периферийное устройство не ожидает ответа. Значение по умолчанию зависит от Attributes свойство характеристики.

c.Attributestype по умолчанию
"Write""withresponse"
"WriteWithoutResponse""withoutresponse"
"Write" и "WriteWithoutResponse""withresponse"

Пример: write(c,5,"withoutresponse") записывает данные к характеристике, не получая ответ назад.

Точность данных в виде "uint8"uint16uint32, или "uint64".

Пример: write(d,300,"uint16") записывает данные к характеристике как 16-битное целое число без знака.

Дескриптор Bluetooth Низкое энергетическое периферийное устройство в виде a descriptor объект.

Введенный в R2019b