write

Write data to a characteristic on a Bluetooth Low Energy Peripheral Device.

Create a connection to a nearby Bluetooth Low Energy peripheral device.

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

Create a characteristic object that represents the "Gender" characteristic.

c = characteristic(b,"User Data","Gender")

c = 
  Characteristic with properties:

             Name: "Gender"
             UUID: "2A8C"
       Attributes: "Read" "Write"
      Descriptors: []

Because this characteristic is readable and writable, you can write data to it and verify the change in values. Use read to get the latest data.

data = read(c)

data = 0

Interpret the data by referring to the specification for this characteristic found in the User Data Service on the Bluetooth SIG website. 0 represents male and 1 represents female. Write 1 to the characteristic to indicate female.

write(c,1)

You can read from the characteristic again to observe the change in the data.

data = read(c)

data = 1

Write data to a descriptor on a Bluetooth Low Energy Peripheral Device.

Create a connection to a nearby Bluetooth Low Energy peripheral device.

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

Create a characteristic object that represents the "Heart Rate Measurement" characteristic.

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

Create a descriptor object that represents the "Client Characteristic Configuration" descriptor.

d = descriptor(c,"Client Characteristic Configuration")

d = 
  Descriptor with properties:

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

This descriptor contains information about whether notification or indication are enabled or disabled. You can use read to get the current data.

data = read(d)

data = 1×2

     0     0

Interpret this data by referring to the specification for this descriptor found in the Bluetooth Core Specification on the Bluetooth SIG website.

This value changes when the notification or indication status changes. For example, write to this value to enable notification for the "Heart Rate Measurement" characteristic. Then, observe the change in values by reading the descriptor again.

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

data = 1×2

     1     0