Module stm32h7xx_hal::spi

Serial Peripheral Interface (SPI)

This module implements the embedded-hal traits for master mode SPI.

Usage

In the simplest case, SPI can be initialised from the device peripheral and the GPIO pins.

use stm32h7xx_hal::spi;

let dp = ...;                   // Device peripherals
let (sck, miso, mosi) = ...;    // GPIO pins

let spi = dp.SPI1.spi((sck, miso, mosi), spi::MODE_0, 1.mhz(), ccdr.peripheral.SPI1, &ccdr.clocks);

The GPIO pins should be supplied as a tuple in the following order:

• Serial Clock (SCK)
• Master In Slave Out (MISO)
• Master Out Slave In (MOSI)

If one of the pins is not required, explicitly pass one of the filler types instead:

let spi = dp.SPI1.spi((sck, spi::NoMiso, mosi), spi::MODE_0, 1.mhz(), ccdr.peripheral.SPI1, &ccdr.clocks);

Word Sizes

The word size used by the SPI controller must be indicated to the compiler. This can be done either using an explicit type annotation, or with a type hint. The possible word sizes are 8 bits (u8) or 16 bits (u16).

For example, an explict type annotation:

let _: spi:Spi<_, _, u8> = dp.SPI1.spi((sck, spi::NoMiso, mosi), spi::MODE_0, 1.mhz(), ccdr.peripheral.SPI1, &ccdr.clocks);

Clocks

The bitrate calculation is based upon the clock currently assigned in the RCC CCIP register. The default assignments are:

• SPI1, SPI2, SPI3: PLL1 Q CK
• SPI4, SPI5: APB
• SPI6: PCLK4

Structs

Config	A structure for specifying SPI configuration.
Disabled	Disabled SPI peripheral (type state)
Enabled	Enabled SPI peripheral (type state)
Mode	SPI mode
NoMiso	A filler type for when the Miso pin is unnecessary
NoMosi	A filler type for when the Mosi pin is unnecessary
NoSck	A filler type for when the SCK pin is unnecessary
Spi

Enums

CommunicationMode	Specifies the communication mode of the SPI interface.
Error	SPI error
Event	Interrupt events
Phase	Clock phase
Polarity	Clock polarity

Constants

MODE_0	Helper for CPOL = 0, CPHA = 0
MODE_1	Helper for CPOL = 0, CPHA = 1
MODE_2	Helper for CPOL = 1, CPHA = 0
MODE_3	Helper for CPOL = 1, CPHA = 1

Traits

PinMiso
PinMosi
PinSck
Pins
SpiExt