Struct ftdi_embedded_hal::I2c

pub struct I2c<'a, Device: MpsseCmdExecutor> { /* private fields */ }

FTDI I2C interface.

This is created by calling FtHal::i2c.

Implementations

impl<'a, Device, E> I2c<'a, Device>where
    Device: MpsseCmdExecutor<Error = E>,
    E: Error,
    Error<E>: From<E>,

pub fn set_stop_start_len(&mut self, start_stop_cmds: u8)

Set the length of start and stop conditions.

This is an advanced feature that most people will not need to touch. I2C start and stop conditions are generated with a number of MPSSE commands. This sets the number of MPSSE command generated for each stop and start condition. An increase in the number of MPSSE commands roughtly correlates to an increase in the duration.

Example

use ftdi_embedded_hal as hal;

let device = libftd2xx::Ft2232h::with_description("Dual RS232-HS A")?;
let hal = hal::FtHal::init_freq(device, 3_000_000)?;
let mut i2c = hal.i2c()?;
i2c.set_stop_start_len(10);

pub fn set_fast(&mut self, fast: bool)

Enable faster I2C transactions by sending commands in a single write.

This is disabled by default.

Normally the I2C methods will send commands with a delay after each slave ACK to read from the USB device. Enabling this will send I2C commands without a delay, but slave ACKs will only be checked at the end of each call to read, write, or write_read.

Example

use ftdi_embedded_hal as hal;

let device = ftdi::find_by_vid_pid(0x0403, 0x6014)
    .interface(ftdi::Interface::A)
    .open()?;

let hal = hal::FtHal::init_freq(device, 3_000_000)?;
let mut i2c = hal.i2c()?;
i2c.set_fast(true);

Trait Implementations

impl<'a, Device: Debug + MpsseCmdExecutor> Debug for I2c<'a, Device>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a, Device, E> Read<u8> for I2c<'a, Device>where
    Device: MpsseCmdExecutor<Error = E>,
    E: Error,
    Error<E>: From<E>,

type Error = Error<E>

Error type

fn read(&mut self, address: u8, buffer: &mut [u8]) -> Result<(), Error<E>>

Reads enough bytes from slave with address to fill buffer

impl<'a, Device, E> Write<u8> for I2c<'a, Device>where
    Device: MpsseCmdExecutor<Error = E>,
    E: Error,
    Error<E>: From<E>,

type Error = Error<E>

Error type

fn write(&mut self, addr: u8, bytes: &[u8]) -> Result<(), Error<E>>

Writes bytes to slave with address address

impl<'a, Device, E> WriteRead<u8> for I2c<'a, Device>where
    Device: MpsseCmdExecutor<Error = E>,
    E: Error,
    Error<E>: From<E>,

type Error = Error<E>

Error type

fn write_read(
    &mut self,
    address: u8,
    bytes: &[u8],
    buffer: &mut [u8]
) -> Result<(), Error<E>>

Writes bytes to slave with address address and then reads enough bytes to fill buffer in a single transaction