Trait i2cdev::core::I2CDevice [] [src]

pub trait I2CDevice {
    fn read(&mut self, data: &mut [u8]) -> I2CResult<()>;
    fn write(&mut self, data: &[u8]) -> I2CResult<()>;

    fn smbus_write_quick(&mut self, bit: bool) -> I2CResult<()> { ... }
    fn smbus_read_byte(&mut self) -> I2CResult<u8> { ... }
    fn smbus_write_byte(&mut self, value: u8) -> I2CResult<()> { ... }
    fn smbus_read_byte_data(&mut self, register: u8) -> I2CResult<u8> { ... }
    fn smbus_write_byte_data(&mut self, register: u8, value: u8) -> I2CResult<()> { ... }
    fn smbus_read_word_data(&mut self, register: u8) -> I2CResult<u16> { ... }
    fn smbus_write_word_data(&mut self, register: u8, value: u16) -> I2CResult<()> { ... }
    fn smbus_process_word(&mut self, register: u8, value: u16) -> I2CResult<u16> { ... }
    fn smbus_read_block_data(&mut self, register: u8) -> I2CResult<Vec<u8>> { ... }
    fn smbus_write_block_data(&mut self, register: u8, values: &[u8]) -> I2CResult<()> { ... }
    fn smbus_process_block(&mut self, register: u8, values: &[u8]) -> I2CResult<()> { ... }
}

Interface to an I2C Slave Device from an I2C Master

Typical implementations will store state with references to the bus in use and the address of the slave device. The trait is based on the Linux i2cdev interface.

Required Methods

fn read(&mut self, data: &mut [u8]) -> I2CResult<()>

Read data from the device to fill the provided slice

fn write(&mut self, data: &[u8]) -> I2CResult<()>

Write the provided buffer to the device

Provided Methods

fn smbus_write_quick(&mut self, bit: bool) -> I2CResult<()>

This sends a single bit to the device, at the place of the Rd/Wr bit

fn smbus_read_byte(&mut self) -> I2CResult<u8>

Read a single byte from a device, without specifying a device register

Some devices are so simple that this interface is enough; for others, it is a shorthand if you want to read the same register as in the previous SMBus command.

fn smbus_write_byte(&mut self, value: u8) -> I2CResult<()>

Write a single byte to a device, without specifying a device register

This is the opposite operation as smbus_read_byte. As with read_byte, no register is specified.

fn smbus_read_byte_data(&mut self, register: u8) -> I2CResult<u8>

Read a single byte from a device, from a designated register

The register is specified through the Comm byte.

fn smbus_write_byte_data(&mut self, register: u8, value: u8) -> I2CResult<()>

Write a single byte to a specific register on a device

The register is specified through the Comm byte.

fn smbus_read_word_data(&mut self, register: u8) -> I2CResult<u16>

Read 2 bytes form a given register on a device (lsb first)

fn smbus_write_word_data(&mut self, register: u8, value: u16) -> I2CResult<()>

Write 2 bytes to a given register on a device (lsb first)

fn smbus_process_word(&mut self, register: u8, value: u16) -> I2CResult<u16>

Select a register, send 16 bits of data to it, and read 16 bits of data

fn smbus_read_block_data(&mut self, register: u8) -> I2CResult<Vec<u8>>

Read a block of up to 32 bytes from a device

The actual number of bytes available to read is returned in the count byte. This code returns a correctly sized vector containing the count bytes read from the device.

fn smbus_write_block_data(&mut self, register: u8, values: &[u8]) -> I2CResult<()>

Write a block of up to 32 bytes to a device

The opposite of the Block Read command, this writes up to 32 bytes to a device, to a designated register that is specified through the Comm byte. The amount of data is specified in the Count byte.

fn smbus_process_block(&mut self, register: u8, values: &[u8]) -> I2CResult<()>

Select a register, send 1 to 31 bytes of data to it, and reads 1 to 31 bytes of data from it.

Implementors