Struct esp32c3_hal::spi::Spi

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

Implementations

impl<'d, T> Spi<'d, T>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>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>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>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>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<'_>
)

Trait Implementations

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

type Error = Error

An enumeration of SPI errors

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

Reads the word stored in the shift register

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

Sends a word to the slave

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

type Error = Error

Error type

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

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

impl<'d, T, RX, TX, P> WithDmaSpi2<'d, T, RX, TX, P> for Spi<'d, T>where
    T: Instance + Spi2Instance,
    TX: Tx,
    RX: Rx,
    P: SpiPeripheral + Spi2Peripheral,

fn with_dma(self, channel: Channel<TX, RX, P>) -> SpiDma<'d, T, TX, RX, P>

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

type Error = Error

Error type

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

Sends words to the slave, ignoring all the incoming words