StmSpi.h File Reference

STM32 SPI Bus+Device wrapper — wraps STM32 HAL SPI via CubeMX handle. More...

#include "BaseSpi.h"
#include "StmTypes.h"
#include "PlatformMutex.h"
#include "SoftChipSelectGuard.h"
#include <vector>
#include <memory>

Include dependency graph for StmSpi.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	StmSpiBusLock
	RAII exclusive ownership of one StmSpiBus (RTOS mutex). More...
class	StmSpiDevice
	Soft-CS SPI slave on a shared StmSpiBus. More...
class	StmSpiBus
	One MCU SPI peripheral + its soft-CS device collection. More...

Detailed Description

STM32 SPI Bus+Device wrapper — wraps STM32 HAL SPI via CubeMX handle.

Bus/Device architecture:

• StmSpiBus: wraps one SPI_HandleTypeDef*, manages device collection
• StmSpiDevice: inherits BaseSpi, manages CS pin, delegates SPI I/O to bus
• StmSpiBusLock / SoftChipSelectGuard: RAII for bus mutex and soft-CS

Usage

extern SPI_HandleTypeDef hspi1;
 
hf_spi_bus_config_t bus_cfg(&hspi1);
StmSpiBus spiBus(bus_cfg);
spiBus.Initialize();
 
hf_spi_device_config_t dev_cfg;
dev_cfg.cs_port = GPIOA;
dev_cfg.cs_pin  = GPIO_PIN_4;
int idx = spiBus.CreateDevice(dev_cfg);
BaseSpi* sensor = spiBus.GetDevice(idx);
sensor->Initialize();
 
uint8_t tx = 0x80, rx = 0;
sensor->Transfer(&tx, &rx, 1);  // bus lock + SoftCs RAII inside

Author

HardFOC

Date

2025

Copyright

HardFOC — Licensed under GPL v3.0 or later.