write

R2026b

Write data to I2C bus

Syntax

write(dev,dataIn)

write(dev,dataIn,precision)

Description

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

write(dev,dataIn) writes data to the I2C bus.

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

Examples

Write Data to an I2C device on Arduino Hardware

Create a connection to an I2C device on Arduino hardware.

a = arduino('COM9','Uno','Libraries','I2C');

Updating server code on board Uno (COM9). This may take a few minutes.

Use an address to create the I2C device connection.

dev = device(a,'I2CAddress','0x55');

Write data to the I2C device.

dataIn = [0 1 2 3 4 5];
write(dev,dataIn);

Specify Precision to Write Data to an I2C Device on Arduino Hardware

Create a connection to an I2C device on Arduino hardware.

a = arduino('COM9','Uno','Libraries','I2C');

Use an address to create the I2C device connection.

dev = device(a,'I2CAddress','0x55');

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

dataIn = [0 500];
write(dev,dataIn,'uint16');

Input Arguments

dev — I2C device connection

device object

I2C device connection specified as a device object.

dataIn — Data to write to I2C device

scalar | vector

Data to write to the I2C device, specified as a scalar, vector, hexadecimal or binary. 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

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 the I2C peripherals and write data to I2C bus. You can use the app in the installed version of MATLAB and MATLAB Online™.

Version History

Introduced in R2014b