Struct nrf52833_hal::Spim

pub struct Spim<T>(/* private fields */);

Interface to a SPIM instance.

This is a very basic interface that comes with the following limitations:

• The SPIM instances share the same address space with instances of SPIS, SPI, TWIM, TWIS, and TWI. You need to make sure that conflicting instances are disabled before using Spim. See product specification, section 15.2.

Implementations

impl<T> Spim<T>

where T: Instance,

pub fn new( spim: T, pins: Pins, frequency: FREQUENCY_A, mode: Mode, orc: u8 ) -> Spim<T>

pub fn transfer( &mut self, chip_select: &mut Pin<Output<PushPull>>, buffer: &mut [u8] ) -> Result<(), Error>

Read and write from a SPI slave, using a single buffer.

This method implements a complete read transaction, which consists of the master transmitting what it wishes to read, and the slave responding with the requested data.

Uses the provided chip select pin to initiate the transaction. Transmits all bytes in buffer, then receives an equal number of bytes.

pub fn transfer_split_even( &mut self, chip_select: &mut Pin<Output<PushPull>>, tx_buffer: &[u8], rx_buffer: &mut [u8] ) -> Result<(), Error>

Read and write from a SPI slave, using separate read and write buffers.

This method implements a complete read transaction, which consists of the master transmitting what it wishes to read, and the slave responding with the requested data.

Uses the provided chip select pin to initiate the transaction. Transmits all bytes in tx_buffer, then receives bytes until rx_buffer is full.

If tx_buffer.len() != rx_buffer.len(), the transaction will stop at the smaller of either buffer.

pub fn transfer_split_uneven( &mut self, chip_select: &mut Pin<Output<PushPull>>, tx_buffer: &[u8], rx_buffer: &mut [u8] ) -> Result<(), Error>

Read and write from a SPI slave, using separate read and write buffers.

This method implements a complete read transaction, which consists of the master transmitting what it wishes to read, and the slave responding with the requested data.

Uses the provided chip select pin to initiate the transaction. Transmits all bytes in tx_buffer, then receives bytes until rx_buffer is full.

This method is more complicated than the other transfer methods because it is allowed to perform transactions where tx_buffer.len() != rx_buffer.len(). If this occurs, extra incoming bytes will be discarded, OR extra outgoing bytes will be filled with the orc value.

pub fn transfer_split_uneven_internal( &mut self, tx_buffer: &[u8], rx_buffer: &mut [u8] ) -> Result<(), Error>

pub fn write( &mut self, chip_select: &mut Pin<Output<PushPull>>, tx_buffer: &[u8] ) -> Result<(), Error>

Write to an SPI slave.

This method uses the provided chip select pin to initiate the transaction, then transmits all bytes in tx_buffer. All incoming bytes are discarded.

pub fn free(self) -> (T, Pins)

Return the raw interface to the underlying SPIM peripheral.

Trait Implementations

impl<T> ErrorType for Spim<T>

type Error = Error

Error type.

impl<T> SpiBus for Spim<T>

where T: Instance,

fn read( &mut self, words: &mut [u8] ) -> Result<(), <Spim<T> as ErrorType>::Error>

Read words from the slave.

fn write(&mut self, words: &[u8]) -> Result<(), <Spim<T> as ErrorType>::Error>

Write words to the slave, ignoring all the incoming words.

fn transfer( &mut self, read: &mut [u8], write: &[u8] ) -> Result<(), <Spim<T> as ErrorType>::Error>

Write and read simultaneously. write is written to the slave on MOSI and words received on MISO are stored in read.

fn transfer_in_place( &mut self, words: &mut [u8] ) -> Result<(), <Spim<T> as ErrorType>::Error>

Write and read simultaneously. The contents of words are written to the slave, and the received words are stored into the same words buffer, overwriting it.

fn flush(&mut self) -> Result<(), <Spim<T> as ErrorType>::Error>

Wait until all operations have completed and the bus is idle.

impl<T> Transfer<u8> for Spim<T>

where T: Instance,

type Error = Error

Error type

fn transfer<'w>(&mut self, words: &'w mut [u8]) -> Result<&'w [u8], Error>

Sends words to the slave. Returns the words received from the slave

impl<T> Write<u8> for Spim<T>

where T: Instance,

type Error = Error

Error type

fn write<'w>(&mut self, words: &'w [u8]) -> Result<(), Error>

Sends words to the slave, ignoring all the incoming words