Main Content

write

Write data to Bluetooth device

Since R2020b

collapse all in page

Syntax

write(device,data)
write(device,data,datatype)

Description

write(device,data) writes the row or column vector data to the Bluetooth® connection device.

example

write(device,data,datatype) writes data in the form specified by datatype, regardless of the format in data.

example

Examples

collapse all

Create a connection to a nearby Bluetooth device. In this example, the HC-06 Bluetooth module is configured as a loopback device.

device = bluetooth("HC-06")
device = 
  bluetooth with properties:

                 Name: "HC-06"
              Address: "98D331FB3B77"
              Channel: 1
    NumBytesAvailable: 0
      NumBytesWritten: 0

  Show all properties

Write the values 1:10 to the device.

write(device,1:10)

Since the device is configured as a loopback device, the data you write to the device is returned to MATLAB®. Read all the data.

read(device,10)
ans = 1×10

     1     2     3     4     5     6     7     8     9    10

Create a connection to a nearby Bluetooth device. In this example, the HC-06 Bluetooth module is configured as a loopback device.

device = bluetooth("HC-06")
device = 
  bluetooth with properties:

                 Name: "HC-06"
              Address: "98D331FB3B77"
              Channel: 1
    NumBytesAvailable: 0
      NumBytesWritten: 0

  Show all properties

Write the string "helloworld" to the device.

write(device,"helloworld","string")

Since the device is configured as a loopback device, the data written to the device is returned to MATLAB. Read the first five values of data as a string.

read(device,5,"string")
ans = 

    "hello"

Use the read command again to read the next five values of data.

read(device,5,"string")
ans = 

    "world"

Input Arguments

collapse all

Bluetooth device connection, specified as a bluetooth object.

Example: write(device,10) writes to the Bluetooth connection device.

Numeric or ASCII data, specified as a 1-by-N vector of numeric values or as a character vector or string scalar of text. For all numeric datatype types, data is a row vector of values.

Example: write(device,300) writes the value 300.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

Size and format of each value, specified as a character vector or string. datatype determines the number of bytes to write for each value and the interpretation of those bytes as a MATLAB data type.

For any read or write operation, the data type is converted to uint8 for the data transfer. After the transfer, the data type reverts to the specified datatype.

Example: write(device,1:5,"double") writes the values [1,2,3,4,5] as double data.

Data Types: char | string

Version History

Introduced in R2020b

See Also

Functions