write

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.

Version History

Introduced in R2019b