Struct esp32c3_hal::spi::Spi

pub struct Spi<'d, T, M> { /* private fields */ }

SPI peripheral driver

Implementations

impl<'d, T> Spi<'d, T, FullDuplexMode>where T: Instance,

pub fn new<SCK, MOSI, MISO, CS>( spi: impl Peripheral<P = T> + 'd, sck: impl Peripheral<P = SCK> + 'd, mosi: impl Peripheral<P = MOSI> + 'd, miso: impl Peripheral<P = MISO> + 'd, cs: impl Peripheral<P = CS> + 'd, frequency: Rate<u32, 1, 1>, mode: SpiMode, peripheral_clock_control: &mut PeripheralClockControl, clocks: &Clocks<'_> ) -> Spi<'d, T, FullDuplexMode>where SCK: OutputPin, MOSI: OutputPin, MISO: InputPin, CS: OutputPin,

Constructs an SPI instance in 8bit dataframe mode.

pub fn new_no_cs<SCK, MOSI, MISO>( spi: impl Peripheral<P = T> + 'd, sck: impl Peripheral<P = SCK> + 'd, mosi: impl Peripheral<P = MOSI> + 'd, miso: impl Peripheral<P = MISO> + 'd, frequency: Rate<u32, 1, 1>, mode: SpiMode, peripheral_clock_control: &mut PeripheralClockControl, clocks: &Clocks<'_> ) -> Spi<'d, T, FullDuplexMode>where SCK: OutputPin, MOSI: OutputPin, MISO: InputPin,

Constructs an SPI instance in 8bit dataframe mode without CS pin.

pub fn new_no_cs_no_miso<SCK, MOSI>( spi: impl Peripheral<P = T> + 'd, sck: impl Peripheral<P = SCK> + 'd, mosi: impl Peripheral<P = MOSI> + 'd, frequency: Rate<u32, 1, 1>, mode: SpiMode, peripheral_clock_control: &mut PeripheralClockControl, clocks: &Clocks<'_> ) -> Spi<'d, T, FullDuplexMode>where SCK: OutputPin, MOSI: OutputPin,

Constructs an SPI instance in 8bit dataframe mode without CS and MISO pin.

pub fn new_mosi_only<MOSI>( spi: impl Peripheral<P = T> + 'd, mosi: impl Peripheral<P = MOSI> + 'd, frequency: Rate<u32, 1, 1>, mode: SpiMode, peripheral_clock_control: &mut PeripheralClockControl, clocks: &Clocks<'_> ) -> Spi<'d, T, FullDuplexMode>where MOSI: OutputPin,

Constructs an SPI instance in 8bit dataframe mode with only MOSI connected. This might be useful for (ab)using SPI to implement other protocols by bitbanging (WS2812B, onewire, generating arbitrary waveforms…)

pub fn change_bus_frequency( &mut self, frequency: Rate<u32, 1, 1>, clocks: &Clocks<'_> )

impl<'d, T> Spi<'d, T, HalfDuplexMode>where T: ExtendedInstance,

pub fn new_half_duplex<SCK, MOSI, MISO, SIO2, SIO3, CS>( spi: impl Peripheral<P = T> + 'd, sck: Option<impl Peripheral<P = SCK> + 'd>, mosi: Option<impl Peripheral<P = MOSI> + 'd>, miso: Option<impl Peripheral<P = MISO> + 'd>, sio2: Option<impl Peripheral<P = SIO2> + 'd>, sio3: Option<impl Peripheral<P = SIO3> + 'd>, cs: Option<impl Peripheral<P = CS> + 'd>, frequency: Rate<u32, 1, 1>, mode: SpiMode, peripheral_clock_control: &mut PeripheralClockControl, clocks: &Clocks<'_> ) -> Spi<'d, T, HalfDuplexMode>where SCK: OutputPin, MOSI: OutputPin + InputPin, MISO: OutputPin + InputPin, SIO2: OutputPin + InputPin, SIO3: OutputPin + InputPin, CS: OutputPin,

Constructs an SPI instance in half-duplex mode.

All pins are optional. Pass crate::gpio::NO_PIN if you don’t need the given pin.

pub fn change_bus_frequency( &mut self, frequency: Rate<u32, 1, 1>, clocks: &Clocks<'_> )

Trait Implementations

impl<T, M> FullDuplex<u8> for Spi<'_, T, M>where T: Instance, M: IsFullDuplex,

type Error = Error

An enumeration of SPI errors

fn read( &mut self ) -> Result<u8, Error<<Spi<'_, T, M> as FullDuplex<u8>>::Error>>

Reads the word stored in the shift register

fn send( &mut self, word: u8 ) -> Result<(), Error<<Spi<'_, T, M> as FullDuplex<u8>>::Error>>

Sends a word to the slave

impl<T, M> HalfDuplexReadWrite for Spi<'_, T, M>where T: Instance, M: IsHalfDuplex,

type Error = Error

fn read( &mut self, data_mode: SpiDataMode, cmd: Command, address: Address, dummy: u8, buffer: &mut [u8] ) -> Result<(), <Spi<'_, T, M> as HalfDuplexReadWrite>::Error>

Half-duplex read.

fn write( &mut self, data_mode: SpiDataMode, cmd: Command, address: Address, dummy: u8, buffer: &[u8] ) -> Result<(), <Spi<'_, T, M> as HalfDuplexReadWrite>::Error>

Half-duplex write.

impl<T, M> Transfer<u8> for Spi<'_, T, M>where T: Instance, M: IsFullDuplex,

type Error = Error

Error type

fn transfer<'w>( &mut self, words: &'w mut [u8] ) -> Result<&'w [u8], <Spi<'_, T, M> as Transfer<u8>>::Error>

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

impl<'d, T, C, M> WithDmaSpi2<'d, T, C, M> for Spi<'d, T, M>where T: Instance + Spi2Instance, C: ChannelTypes, <C as ChannelTypes>::P: SpiPeripheral + Spi2Peripheral, M: DuplexMode,

fn with_dma(self, channel: Channel<'d, C>) -> SpiDma<'d, T, C, M>

impl<T, M> Write<u8> for Spi<'_, T, M>where T: Instance, M: IsFullDuplex,

type Error = Error

Error type

fn write( &mut self, words: &[u8] ) -> Result<(), <Spi<'_, T, M> as Write<u8>>::Error>

Sends words to the slave, ignoring all the incoming words