Struct stm32_hal2::spi::Spi
source · [−]pub struct Spi<R> {
pub regs: R,
pub cfg: SpiConfig,
}
Expand description
Represents a Serial Peripheral Interface (SPI) peripheral.
Fields
regs: R
cfg: SpiConfig
Implementations
sourceimpl<R> Spi<R> where
R: Deref<Target = RegisterBlock> + RccPeriph,
impl<R> Spi<R> where
R: Deref<Target = RegisterBlock> + RccPeriph,
sourcepub fn new(regs: R, cfg: SpiConfig, baud_rate: BaudRate) -> Self
pub fn new(regs: R, cfg: SpiConfig, baud_rate: BaudRate) -> Self
Initialize an SPI peripheral, including configuration register writes, and enabling and resetting its RCC peripheral clock.
sourcepub fn disable(&mut self)
pub fn disable(&mut self)
L44 RM, section 40.4.9: “Procedure for disabling the SPI” When SPI is disabled, it is mandatory to follow the disable procedures described in this paragraph. It is important to do this before the system enters a low-power mode when the peripheral clock is stopped. Ongoing transactions can be corrupted in this case. In some modes the disable procedure is the only way to stop continuous communication running.
sourcepub fn read(&mut self) -> Result<u8, Error>
pub fn read(&mut self) -> Result<u8, Error>
Read a single byte if available, or block until it’s available. See L44 RM, section 40.4.9: Data transmission and reception procedures.
sourcepub fn write_one(&mut self, byte: u8) -> Result<(), Error>
pub fn write_one(&mut self, byte: u8) -> Result<(), Error>
Write a single byte if available, or block until it’s available. See L44 RM, section 40.4.9: Data transmission and reception procedures.
sourcepub fn write(&mut self, words: &[u8]) -> Result<(), Error>
pub fn write(&mut self, words: &[u8]) -> Result<(), Error>
Write multiple bytes on the SPI line, blocking until complete. See L44 RM, section 40.4.9: Data transmission and reception procedures.
sourcepub fn transfer<'w>(&mut self, words: &'w mut [u8]) -> Result<(), Error>
pub fn transfer<'w>(&mut self, words: &'w mut [u8]) -> Result<(), Error>
Read multiple bytes to a buffer, blocking until complete. See L44 RM, section 40.4.9: Data transmission and reception procedures.
sourcepub unsafe fn write_dma<D>(
&mut self,
buf: &[u8],
channel: DmaChannel,
channel_cfg: ChannelCfg,
dma: &mut Dma<D>
) where
D: Deref<Target = RegisterBlock>,
pub unsafe fn write_dma<D>(
&mut self,
buf: &[u8],
channel: DmaChannel,
channel_cfg: ChannelCfg,
dma: &mut Dma<D>
) where
D: Deref<Target = RegisterBlock>,
Transmit data using DMA. See L44 RM, section 40.4.9: Communication using DMA.
Note that the channel
argument has no effect on F3 and L4.
sourcepub unsafe fn read_dma<D>(
&mut self,
buf: &mut [u8],
channel: DmaChannel,
channel_cfg: ChannelCfg,
dma: &mut Dma<D>
) where
D: Deref<Target = RegisterBlock>,
pub unsafe fn read_dma<D>(
&mut self,
buf: &mut [u8],
channel: DmaChannel,
channel_cfg: ChannelCfg,
dma: &mut Dma<D>
) where
D: Deref<Target = RegisterBlock>,
Receive data using DMA. See L44 RM, section 40.4.9: Communication using DMA.
Note thay the channel
argument has no effect on F3 and L4.
sourcepub unsafe fn transfer_dma<D>(
&mut self,
buf_write: &[u8],
buf_read: &mut [u8],
channel_write: DmaChannel,
channel_read: DmaChannel,
channel_cfg_write: ChannelCfg,
channel_cfg_read: ChannelCfg,
dma: &mut Dma<D>
) where
D: Deref<Target = RegisterBlock>,
pub unsafe fn transfer_dma<D>(
&mut self,
buf_write: &[u8],
buf_read: &mut [u8],
channel_write: DmaChannel,
channel_read: DmaChannel,
channel_cfg_write: ChannelCfg,
channel_cfg_read: ChannelCfg,
dma: &mut Dma<D>
) where
D: Deref<Target = RegisterBlock>,
Transfer data from DMA; this is the basic reading API, using both write and read transfers: It performs a write with register data, and reads to a buffer.
sourcepub fn stop_dma<D>(&mut self, channel: DmaChannel, dma: &mut Dma<D>) where
D: Deref<Target = RegisterBlock>,
pub fn stop_dma<D>(&mut self, channel: DmaChannel, dma: &mut Dma<D>) where
D: Deref<Target = RegisterBlock>,
Stop a DMA transfer. Stops the channel, and disables the txdmaen
and rxdmaen
bits.
Run this after each transfer completes - you may wish to do this in an interrupt
(eg DMA transfer complete) instead of blocking.
sourcepub fn enable_interrupt(&mut self, interrupt_type: SpiInterrupt)
pub fn enable_interrupt(&mut self, interrupt_type: SpiInterrupt)
Enable an interrupt.
sourcepub fn clear_interrupt(&mut self, interrupt_type: SpiInterrupt)
pub fn clear_interrupt(&mut self, interrupt_type: SpiInterrupt)
Clear an interrupt.
Trait Implementations
sourceimpl<R> FullDuplex<u8> for Spi<R> where
R: Deref<Target = RegisterBlock> + RccPeriph,
impl<R> FullDuplex<u8> for Spi<R> where
R: Deref<Target = RegisterBlock> + RccPeriph,
impl<R> Default<u8> for Spi<R> where
R: Deref<Target = RegisterBlock> + RccPeriph,
impl<R> Default<u8> for Spi<R> where
R: Deref<Target = RegisterBlock> + RccPeriph,
Auto Trait Implementations
impl<R> RefUnwindSafe for Spi<R> where
R: RefUnwindSafe,
impl<R> Send for Spi<R> where
R: Send,
impl<R> Sync for Spi<R> where
R: Sync,
impl<R> Unpin for Spi<R> where
R: Unpin,
impl<R> UnwindSafe for Spi<R> where
R: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<W, S> Transfer<W> for S where
S: Default<W>,
W: Clone,
impl<W, S> Transfer<W> for S where
S: Default<W>,
W: Clone,
type Error = <S as FullDuplex<W>>::Error
type Error = <S as FullDuplex<W>>::Error
Error type