org.lsst.ccs.drivers.i2c

Class I2cImplUsb

java.lang.Object

org.lsst.ccs.drivers.i2c.I2cImplUsb

public class I2cImplUsb
extends Object

Routines for communicating with an I2C device via the USB-I2C adaptor

Author:

Owen Saxton

Constructor Summary

Constructors

Constructor and Description
I2cImplUsb()

Method Summary

Modifier and Type	Method and Description
void	close() Closes the connection.
void	open(I2c.ConnType connType, String ident, int param) Opens a connection.
int	read(int addr) Reads a byte from a device without registers.
int	read(int addr, byte[] buff, int count) Reads multiple bytes from a device without registers.
int	read(int addr, int reg, byte[] buff, int count) Reads multiple bytes from a device with 1-byte register numbers.
int	read2(int addr, int reg, byte[] buff, int count) Reads multiple bytes from a device with 2-byte register numbers.
void	setTimeout(double timeout) Sets the read timeout.
void	write(int addr, int value) Writes a byte to a device without registers.
void	write(int addr, int reg, byte[] buff, int count) Writes multiple bytes to a device with 1-byte register numbers.
void	write2(int addr, int reg, byte[] buff, int count) Writes multiple bytes to a device with 2-byte register numbers.

Methods inherited from class java.lang.Object

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

Constructor Detail

I2cImplUsb

public I2cImplUsb()

Method Detail

open

public void open(I2c.ConnType connType,
                 String ident,
                 int param)
          throws org.lsst.ccs.drivers.commons.DriverException

Opens a connection.

Parameters:

connType - The enumerated connection type: USBFTDI or USBSERIAL

ident - The USB ID (FTDI) or port name (SERIAL)

param - Open parameter (not used)

Throws:

org.lsst.ccs.drivers.commons.DriverException

close

public void close()
           throws org.lsst.ccs.drivers.commons.DriverException

Closes the connection.

Throws:

org.lsst.ccs.drivers.commons.DriverException

setTimeout

public void setTimeout(double timeout)
                throws org.lsst.ccs.drivers.commons.DriverException

Sets the read timeout.

Parameters:

timeout - The timeout (secs). 0 means no timeout.

Throws:

org.lsst.ccs.drivers.commons.DriverException

write

public void write(int addr,
                  int value)
           throws org.lsst.ccs.drivers.commons.DriverException

Writes a byte to a device without registers.

Parameters:

addr - The I2C address

value - The byte value to write

Throws:

org.lsst.ccs.drivers.commons.DriverException

read

public int read(int addr)
         throws org.lsst.ccs.drivers.commons.DriverException

Reads a byte from a device without registers.

Parameters:

addr - The I2C address

Returns:

The unsigned read value, or -1 if a timeout occurred

Throws:

org.lsst.ccs.drivers.commons.DriverException

read

public int read(int addr,
                byte[] buff,
                int count)
         throws org.lsst.ccs.drivers.commons.DriverException

Reads multiple bytes from a device without registers.

Parameters:

addr - The I2C address

buff - The read buffer

count - The number of bytes to read

Returns:

The number of bytes read. If less than count, a timeout occurred.

Throws:

org.lsst.ccs.drivers.commons.DriverException

write

public void write(int addr,
                  int reg,
                  byte[] buff,
                  int count)
           throws org.lsst.ccs.drivers.commons.DriverException

Writes multiple bytes to a device with 1-byte register numbers.

Parameters:

addr - The I2C address

reg - The register number

buff - The write buffer

count - The number of bytes to write

Throws:

org.lsst.ccs.drivers.commons.DriverException

read

public int read(int addr,
                int reg,
                byte[] buff,
                int count)
         throws org.lsst.ccs.drivers.commons.DriverException

Reads multiple bytes from a device with 1-byte register numbers.

Parameters:

addr - The I2C address

reg - The register number

buff - The read buffer

count - The number of bytes to read

Returns:

The number of bytes read. If less than count, a timeout occurred.

Throws:

org.lsst.ccs.drivers.commons.DriverException

write2

public void write2(int addr,
                   int reg,
                   byte[] buff,
                   int count)
            throws org.lsst.ccs.drivers.commons.DriverException

Writes multiple bytes to a device with 2-byte register numbers.

Parameters:

addr - The I2C address

reg - The register number

buff - The read buffer

count - The number of bytes to write

Throws:

org.lsst.ccs.drivers.commons.DriverException

read2

public int read2(int addr,
                 int reg,
                 byte[] buff,
                 int count)
          throws org.lsst.ccs.drivers.commons.DriverException

Reads multiple bytes from a device with 2-byte register numbers.

Parameters:

addr - The I2C address

reg - The register number

buff - The read buffer

count - The number of bytes to read

Returns:

The number of bytes read. If less than count, a timeout occurred.

Throws:

org.lsst.ccs.drivers.commons.DriverException