writeRegister

Write data to I2C device register

Syntax

writeRegister(i2cdevObj,registerAddress,dataIn)

writeRegister(i2cdevObj,registerAddress,dataIn,precision)

Description

writeRegister(i2cdevObj,registerAddress,dataIn) writes data to the register on I2C device, specified as a device object.

writeRegister(i2cdevObj,registerAddress,dataIn,precision) writes data to the register on I2C device, specified as a device object, based on the data precision.

Examples

Write Data to I2C Device Register

Create object for an I2C device that is already connected to I2C bus.

microbitObj = microbit('COM3');
scanI2CBus(microbitObj)

ans =  
  1×2 string array 
    "0xE"    "0x1D" 

i2cdev1 = device(microbitObj, 'I2CAddress',"0xE");

i2cdev1 =  

  device with properties: 

             Interface: "I2C" 
            I2CAddress: 14 ("0xE") 
                SCLPin: "P19" 
                SDAPin: "P20" 
               BitRate: 100000 (bits/s) 
 

Use the I2C device object to write data to the I2C device register at address 20.

dataIn = [0 1 2 3 4 5];
writeRegister(i2cdev1, 20, dataIn)

Specify the Precision to Write Data to I2C Device Register

Write data to the I2C device register at address 20, with a precision of uint16.

dataIn = [0 500];
writeRegister(i2cdev1, 20, dataIn, 'uint16')

Input Arguments

i2cdevObj — I2C device connection

device object

Device connection to an I2C device, specified as a device object, connected to the I2C bus on the BBC micro:bit board. The I2C device object is created using the device function.

dataIn — Data to write

scalar | vector

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

Data Types: double

registerAddress — Address of I2C device register

positive scalar integer from 0 through 255

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

Data Types: double

precision — Data precision

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

Precision of data to write to the I2C device register.