118 lines
3.0 KiB
C
118 lines
3.0 KiB
C
/* USER CODE BEGIN Header */
|
|
/**
|
|
******************************************************************************
|
|
* @file : hal_spi.h
|
|
* @brief : SPI hardware abstraction layer header file
|
|
******************************************************************************
|
|
*/
|
|
/* USER CODE END Header */
|
|
|
|
#ifndef HAL_SPI_H
|
|
#define HAL_SPI_H
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <stdbool.h>
|
|
|
|
/**
|
|
* @brief SPI instance identifier definitions
|
|
*/
|
|
typedef enum {
|
|
HAL_SPI_INSTANCE_1 = 0,
|
|
HAL_SPI_INSTANCE_2,
|
|
HAL_SPI_INSTANCE_3,
|
|
HAL_SPI_INSTANCE_4,
|
|
HAL_SPI_INSTANCE_5,
|
|
HAL_SPI_INSTANCE_6,
|
|
HAL_SPI_INSTANCE_MAX
|
|
} hal_spi_instance_t;
|
|
|
|
/**
|
|
* @brief SPI mode definitions
|
|
*/
|
|
typedef enum {
|
|
HAL_SPI_MODE_MASTER = 0,
|
|
HAL_SPI_MODE_SLAVE
|
|
} hal_spi_mode_t;
|
|
|
|
/**
|
|
* @brief SPI clock polarity definitions
|
|
*/
|
|
typedef enum {
|
|
HAL_SPI_POLARITY_LOW = 0,
|
|
HAL_SPI_POLARITY_HIGH
|
|
} hal_spi_polarity_t;
|
|
|
|
/**
|
|
* @brief SPI clock phase definitions
|
|
*/
|
|
typedef enum {
|
|
HAL_SPI_PHASE_1EDGE = 0,
|
|
HAL_SPI_PHASE_2EDGE
|
|
} hal_spi_phase_t;
|
|
|
|
/**
|
|
* @brief SPI data bits definitions
|
|
*/
|
|
typedef enum {
|
|
HAL_SPI_DATABITS_8 = 0,
|
|
HAL_SPI_DATABITS_16
|
|
} hal_spi_databits_t;
|
|
|
|
/**
|
|
* @brief SPI configuration structure
|
|
*/
|
|
typedef struct {
|
|
hal_spi_instance_t instance;
|
|
hal_spi_mode_t mode;
|
|
uint32_t baudrate;
|
|
hal_spi_polarity_t polarity;
|
|
hal_spi_phase_t phase;
|
|
hal_spi_databits_t databits;
|
|
} hal_spi_config_t;
|
|
|
|
/**
|
|
* @brief Initialize SPI hardware
|
|
* @param instance SPI instance identifier
|
|
* @param config SPI configuration structure
|
|
* @return true if initialization is successful, false otherwise
|
|
*/
|
|
bool hal_spi_init(hal_spi_instance_t instance, const hal_spi_config_t *config);
|
|
|
|
/**
|
|
* @brief Deinitialize SPI hardware
|
|
* @param instance SPI instance identifier
|
|
* @return true if deinitialization is successful, false otherwise
|
|
*/
|
|
bool hal_spi_deinit(hal_spi_instance_t instance);
|
|
|
|
/**
|
|
* @brief Transmit data over specific SPI instance
|
|
* @param instance: SPI instance identifier
|
|
* @param data: Pointer to data buffer
|
|
* @param size: Data length in bytes
|
|
* @return true if transmission is successful, false otherwise
|
|
*/
|
|
bool hal_spi_transmit(hal_spi_instance_t instance, const uint8_t *data, uint16_t size);
|
|
|
|
/**
|
|
* @brief Receive data from specific SPI instance
|
|
* @param instance: SPI instance identifier
|
|
* @param data: Pointer to data buffer
|
|
* @param size: Data length to receive in bytes
|
|
* @return true if reception is successful, false otherwise
|
|
*/
|
|
bool hal_spi_receive(hal_spi_instance_t instance, uint8_t *data, uint16_t size);
|
|
|
|
/**
|
|
* @brief Transmit and receive data simultaneously over specific SPI instance
|
|
* @param instance: SPI instance identifier
|
|
* @param tx_data: Pointer to transmit data buffer
|
|
* @param rx_data: Pointer to receive data buffer
|
|
* @param size: Data length in bytes
|
|
* @return true if transmission and reception are successful, false otherwise
|
|
*/
|
|
bool hal_spi_transmit_receive(hal_spi_instance_t instance, const uint8_t *tx_data, uint8_t *rx_data, uint16_t size);
|
|
|
|
#endif /* HAL_SPI_H */
|