write

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

Описание

Запись значений характеристик

пример

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

пример

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

пример

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

пример

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

Запись значений дескриптора

пример

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

пример

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

Примеры

свернуть все

Запись данных в характеристику на Bluetooth Low Energy Peripheral Device.

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

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

Запись данных в дескриптор на периферийном устройстве с низким энергопотреблением Bluetooth.

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

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 Low Energy, заданная как characteristic объект.

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

Пример: 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 Low Energy, заданный как descriptor объект.

Введенный в R2019b