write

R2026b

Write data to serial device

Syntax

write(serialdevObj,dataIn)

write(serialdevObj,dataIn,precision)

Description

Add-On Required: This feature requires the MATLAB Support Package for Arduino Hardware add-on.

write(serialdevObj,dataIn) writes data to the serial device.

write(serialdevObj,dataIn,precision) also specifies the precision.

Examples

Write Data to Serial Device Connected to Arduino Hardware

Create an arduino connection.

arduinoObj = arduino("COM16","Leonardo","Libraries",{'SPI','Serial','I2C'});

Create a connection to the serial device on the Arduino hardware.

serialdevObj = device(arduinoObj,'SerialPort',1)

serialdevObj = 
  device with properties:

             Interface: 'Serial'
            SerialPort: 1
                 TxPin: 'D1'
                 RxPin: 'D0'
              BaudRate: 9600 (bits/s) 
     NumBytesAvailable: 0 

Show all properties, functions

Write 3 bytes of data to the serial device.

write(serialdevObj,[88 99 65]);

Specify Precision to Write Data to Serial Device on Arduino Hardware

Create an arduino connection.

arduinoObj = arduino("COM16","Leonardo","Libraries",{'SPI','Serial','I2C'});

Create a connection to the serial device on the Arduino hardware.

serialdevObj = device(arduinoObj,'SerialPort',1)

serialdevObj = 
  device with properties:

             Interface: 'Serial'
            SerialPort: 1
                 TxPin: 'D1'
                 RxPin: 'D0'
              BaudRate: 9600 (bits/s) 
     NumBytesAvailable: 0 

Show all properties, functions

Write data to the serial device with the precision of uint16.

write(serialdevObj,256,'uint16');

Input Arguments

serialdevObj — serial device connection

serial device object

Serial device connection specified as a device object.

dataIn — Data to write to serial device

scalar | vector

Data to write to the serial device, specified as a scalar or vector. The range of the values in the array is based on the precision.

precision — Data precision

'uint8' (default) | 'int8' | 'uint16' | 'int16' | 'uint32' | 'int32' | 'uint64' | 'int64'

Data precision, specified as one of the following character vectors:

• 'uint8'

• 'int8'

• 'uint16'

• 'int16'

• 'uint32'

• 'int32'

• 'uint64'

• 'int64'

Data can be also be specified in the following formats:

• hexadecimal

• binary

• char

• string

For example, write(serialdevObj,0x28) writes data in hexadecimal and write(serialdevObj,0b0010) writes data in binary.

More About

Code Generation Using MATLAB Function Block

• Use write in a MATLAB^® Function block with the Simulink^® Support Package for Arduino^® Hardware to generate code that can be deployed on Arduino Hardware.

• Values of dataIn is not validated against the precision. The dataIn values will be saturated when it goes beyond the range of the specified precision.

Alternative Functionality

App

Use Arduino Explorer to configure serial device and then write data to it. You can use the app in the installed version of MATLAB and MATLAB Online™. For more information, see Connect to Serial Device Using Arduino Explorer App.

Version History

Introduced in R2019b