readRegister

R2026b

Read data from I2C device register

collapse all in page

Syntax

out = readRegister(dev,register)
out = readRegister(dev,register,precision)

Description

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

out = readRegister(dev,register) returns data read from the I2C device register.

example

out = readRegister(dev,register,precision) also specifies the data precision.

example

Examples

collapse all

This example uses:

Open Live Script

Create an Arduino object and attach an I2C device object to it.

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

Use an address to create the I2C device connection.

dev = device(a,'I2CAddress','0x55')
dev = 
  device with properties:

             Interface: 'I2C'
            I2CAddress: 85 ('0x55')
                   Bus: 0
                SCLPin: 'A5'
                SDAPin: 'A4'
               BitRate: 100000 (bits/s)

Show functions

Write value 10 to the I2C device register at address 20.

writeRegister(dev,20,10);

Read from the I2C device register at address 20.

value = readRegister(dev,20)
value = 
10

This example uses:

Open Live Script

Create an Arduino object and attach an I2C device object to it.

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

Use an address to create the I2C device connection.

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

Write value 224 to the I2C device register at address 20 with the precision of uint16

writeRegister(dev, 20, 224,'uint16');

Read from the I2C device register at address 20 with the precision of uint16.

value = readRegister(dev,20,'uint16')
value = 
224

Input Arguments

collapse all

I2C device connection, specified as a device object.

Address of the I2C device register, specified as a scalar integer, hexadecimal, or binary from 0 through 255.

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

  • 'uint8'

  • 'int8'

  • 'uint16'

  • 'int16'

  • 'uint32'

  • 'int32'

  • 'uint64'

  • 'int64'

Output Arguments

collapse all

Value of data stored at the I2C device register, returned as a scalar.

More About

collapse all

Alternative Functionality

App

Use Arduino Explorer to configure the I2C peripherals and read data from the I2C device register. You can use the app in the installed version of MATLAB and MATLAB Online™. You can also use the Plot pane of the app to interactively view data read from the board. For more information, see Connect to I2C Device Using Arduino Explorer App.

Version History

Introduced in R2014b

See Also

| | | |

Topics