Main Content

write

Write data to serial device

collapse all in page

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

Syntax

write(serialdevObj,dataIn)
write(serialdevObj,dataIn,precision)

Description

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

example

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

example

Examples

collapse all

This example uses:

Open Live Script

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]);

This example uses:

Open Live Script

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

collapse all

Serial device connection specified as a device object.

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.

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

collapse all

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

See Also

| |