spi.h

Go to the documentation of this file.

 
/* -- Includes -- */
#include <stdint.h>
#include "stm32f4xx.h"
#include "defines.h"
 
/* -- Structs -- */
struct __attribute__((packed)) SPIRegs {
  REG32 CR1;
  REG32 CR2;
  REG32 SR;
  REG32 DR;
  REG32 CRCPR;
  REG32 RXCRCR;
  REG32 TXCRCR;
  REG32 I2SCFGR;
  REG32 I2SPR;
};
 
_Static_assert((sizeof(struct SPIRegs)) == (sizeof(uint32_t) * 9U),
               "SPI Register struct size mismatch. Is it aligned?");
 
#define SPI(ADDR) (struct SPIRegs *)(ADDR);
 
struct __attribute__((packed)) SPIISR {
  _Bool ERR  : 1; 
  _Bool RXNE : 1; 
  _Bool TXE  : 1; 
};
 
_Static_assert((sizeof(struct SPIISR)) == (sizeof(uint8_t) * 1U),
               "SPI ISR struct size mismatch. Is it aligned?");
 
struct __attribute__((packed)) SPIConfig {
  /* Data */
  _Bool Use16Bits : 1; 
  _Bool LSBFirst  : 1; 
  _Bool TIMode    : 1; 
  /* CRC */
  _Bool UseCRC : 1; 
  uint16_t CRCPoly; 
};
 
_Static_assert((sizeof(struct SPIConfig)) == (sizeof(uint8_t) * 3U),
               "SPI Config struct size mismatch. Is it aligned?");
 
/* -- Enums -- */
typedef enum spi_peripheral {
#ifdef SPI1_BASE
  SPI_PERIPH_1 = 0x0,
#endif
#ifdef SPI2_BASE
  SPI_PERIPH_2,
#endif
#ifdef SPI3_BASE
  SPI_PERIPH_3,
#endif
#ifdef SPI4_BASE
  SPI_PERIPH_4,
#endif
#ifdef SPI5_BASE
  SPI_PERIPH_5,
#endif
#ifdef SPI6_BASE
  SPI_PERIPH_6,
#endif
  SPI_PERIPH_LEN
} spi_peripheral_t;
 
typedef enum spi_communication {
  SPI_COMM_FULLDUPLEX = 0x0,
  SPI_COMM_HALFDUPLEX_RX,
  SPI_COMM_HALFDUPLEX_TX,
  SPI_COMM_SIMPLEX_RX,
  SPI_COMM_SIMPLEX_TX
} spi_communication_t;
 
typedef enum spi_nss_mode {
  SPI_NSS_SOFT = 0x0,
  SPI_NSS_HARD_OE,
  SPI_NSS_HARD_OD
} spi_nss_mode_t;
 
typedef enum spi_prescaler {
  SPI_PRESC_DIV2 = 0x0,
  SPI_PRESC_DIV4,
  SPI_PRESC_DIV8,
  SPI_PRESC_DIV16,
  SPI_PRESC_DIV32,
  SPI_PRESC_DIV64,
  SPI_PRESC_DIV128,
  SPI_PRESC_DIV256
} spi_prescaler_t;
 
void spi_set_interrupts(const spi_peripheral_t spi, const struct SPIISR config);
 
void spi_configure_communication(const spi_peripheral_t spi,
                                 const spi_communication_t com,
                                 const spi_nss_mode_t nss);
 
void spi_configure_clk(const spi_peripheral_t spi, const spi_prescaler_t div,
                       _Bool polarity, _Bool phase);
 
void spi_set_ssi_state(const spi_peripheral_t spi, const _Bool state);
 
void spi_set_dma(const spi_peripheral_t spi, const _Bool forTX,
                 const _Bool forRX);
 
void spi_configure_options(const spi_peripheral_t spi,
                           const struct SPIConfig config);
 
void spi_tx_data(const spi_peripheral_t spi, const uint16_t data);
 
uint16_t spi_rx_data(const spi_peripheral_t spi);
 
uint16_t spi_trx_data(const spi_peripheral_t spi, const uint16_t data);
 
void spi_start(const spi_peripheral_t spi, const _Bool master);
 
void spi_stop(const spi_peripheral_t spi);