com.pi4j.io.i2c.impl

Class I2CDeviceImpl

java.lang.Object

com.pi4j.io.i2c.impl.I2CDeviceImpl

All Implemented Interfaces:

I2CDevice

public class I2CDeviceImpl
extends Object
implements I2CDevice

Implementation of i2c device. This class only holds reference to i2c bus (so it can use its handle) and device address.

Author:

Daniel Sendula

Constructor Summary

Constructors

Constructor and Description
I2CDeviceImpl(I2CBusImpl bus, int address) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected String	makeDescription() This helper method creates a string describing bus file name and device address (in hex).
protected String	makeDescription(int address) This helper method creates a string describing bus file name, device address (in hex) and local i2c address.
int	read() This method reads one byte from the i2c device.
int	read(byte[] buffer, int offset, int size) This method reads bytes from the i2c device to given buffer at asked offset.
int	read(int address) This method reads one byte from the i2c device.
int	read(int address, byte[] buffer, int offset, int size) This method reads bytes from the i2c device to given buffer at asked offset.
void	write(byte data) This method writes one byte to i2c device.
void	write(byte[] buffer, int offset, int size) This method writes several bytes to the i2c device from given buffer at given offset.
void	write(int address, byte data) This method writes one byte to i2c device.
void	write(int address, byte[] buffer, int offset, int size) This method writes several bytes to the i2c device from given buffer at given offset.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

I2CDeviceImpl

public I2CDeviceImpl(I2CBusImpl bus,
             int address)

Constructor.

Parameters:

bus - i2c bus

address - i2c device address

Method Detail

write

public void write(byte data)
           throws IOException

This method writes one byte to i2c device.

Specified by:

write in interface I2CDevice

Parameters:

b - byte to be written

Throws:

IOException - thrown in case byte cannot be written to the i2c device or i2c bus

write

public void write(byte[] buffer,
         int offset,
         int size)
           throws IOException

This method writes several bytes to the i2c device from given buffer at given offset.

Specified by:

write in interface I2CDevice

Parameters:

buffer - buffer of data to be written to the i2c device in one go

offset - offset in buffer

size - number of bytes to be written

Throws:

IOException - thrown in case byte cannot be written to the i2c device or i2c bus

write

public void write(int address,
         byte data)
           throws IOException

This method writes one byte to i2c device.

Specified by:

write in interface I2CDevice

Parameters:

address - local address in the i2c device

b - byte to be written

Throws:

IOException - thrown in case byte cannot be written to the i2c device or i2c bus

write

public void write(int address,
         byte[] buffer,
         int offset,
         int size)
           throws IOException

This method writes several bytes to the i2c device from given buffer at given offset.

Specified by:

write in interface I2CDevice

Parameters:

address - local address in the i2c device

buffer - buffer of data to be written to the i2c device in one go

offset - offset in buffer

size - number of bytes to be written

Throws:

IOException - thrown in case byte cannot be written to the i2c device or i2c bus

read

public int read()
         throws IOException

This method reads one byte from the i2c device. Result is between -128 and 127.

Specified by:

read in interface I2CDevice

Returns:

Throws:

IOException - thrown in case byte cannot be read from the i2c device or i2c bus

read

public int read(byte[] buffer,
       int offset,
       int size)
         throws IOException

This method reads bytes from the i2c device to given buffer at asked offset.

Note: Current implementation calls read(int). That means for each read byte i2c bus will send (next) address to i2c device.

Specified by:

read in interface I2CDevice

Parameters:

buffer - buffer of data to be read from the i2c device in one go

offset - offset in buffer

size - number of bytes to be read

Returns:

number of bytes read

Throws:

IOException - thrown in case byte cannot be read from the i2c device or i2c bus

read

public int read(int address)
         throws IOException

This method reads one byte from the i2c device. Result is between -128 and 127.

Specified by:

read in interface I2CDevice

Parameters:

address - local address in the i2c device

Returns:

Throws:

IOException - thrown in case byte cannot be read from the i2c device or i2c bus

read

public int read(int address,
       byte[] buffer,
       int offset,
       int size)
         throws IOException

This method reads bytes from the i2c device to given buffer at asked offset.

Note: Current implementation calls read(int). That means for each read byte i2c bus will send (next) address to i2c device.

Specified by:

read in interface I2CDevice

Parameters:

address - local address in the i2c device

buffer - buffer of data to be read from the i2c device in one go

offset - offset in buffer

size - number of bytes to be read

Returns:

number of bytes read

Throws:

IOException - thrown in case byte cannot be read from the i2c device or i2c bus

makeDescription

protected String makeDescription()

This helper method creates a string describing bus file name and device address (in hex).

Returns:

string with all details

makeDescription

protected String makeDescription(int address)

This helper method creates a string describing bus file name, device address (in hex) and local i2c address.

Parameters:

address - local address in i2c device

Returns:

string with all details