3140 lines
97 KiB
C
3140 lines
97 KiB
C
|
/**
|
||
|
******************************************************************************
|
||
|
* @file stm32h7xx_hal_spi.c
|
||
|
* @author MCD Application Team
|
||
|
* @version V1.2.0
|
||
|
* @date 29-December-2017
|
||
|
* @brief SPI HAL module driver.
|
||
|
* This file provides firmware functions to manage the following
|
||
|
* functionalities of the Serial Peripheral Interface (SPI) peripheral:
|
||
|
* + Initialization and de-initialization functions
|
||
|
* + IO operation functions
|
||
|
* + Peripheral Control functions
|
||
|
* + Peripheral State functions
|
||
|
*
|
||
|
@verbatim
|
||
|
==============================================================================
|
||
|
##### How to use this driver #####
|
||
|
==============================================================================
|
||
|
[..]
|
||
|
The SPI HAL driver can be used as follows:
|
||
|
|
||
|
(#) Declare a SPI_HandleTypeDef handle structure, for example:
|
||
|
SPI_HandleTypeDef hspi;
|
||
|
|
||
|
(#)Initialize the SPI low level resources by implementing the HAL_SPI_MspInit() API:
|
||
|
(##) Enable the SPIx interface clock
|
||
|
(##) SPI pins configuration
|
||
|
(+++) Enable the clock for the SPI GPIOs
|
||
|
(+++) Configure these SPI pins as alternate function push-pull
|
||
|
(##) NVIC configuration if you need to use interrupt process
|
||
|
(+++) Configure the SPIx interrupt priority
|
||
|
(+++) Enable the NVIC SPI IRQ handle
|
||
|
(##) DMA Configuration if you need to use DMA process
|
||
|
(+++) Declare a DMA_HandleTypeDef handle structure for the transmit or receive Stream/Channel
|
||
|
(+++) Enable the DMAx clock
|
||
|
(+++) Configure the DMA handle parameters
|
||
|
(+++) Configure the DMA Tx or Rx Stream/Channel
|
||
|
(+++) Associate the initialized hdma_tx handle to the hspi DMA Tx or Rx handle
|
||
|
(+++) Configure the priority and enable the NVIC for the transfer complete interrupt on the DMA Tx or Rx Stream/Channel
|
||
|
|
||
|
(#) Program the Mode, BidirectionalMode , Data size, Baudrate Prescaler, NSS
|
||
|
management, Clock polarity and phase, FirstBit and CRC configuration in the hspi Init structure.
|
||
|
|
||
|
(#) Initialize the SPI registers by calling the HAL_SPI_Init() API:
|
||
|
(++) This API configures also the low level Hardware GPIO, CLOCK, CORTEX...etc)
|
||
|
by calling the customized HAL_SPI_MspInit() API.
|
||
|
|
||
|
[..]
|
||
|
Circular mode restriction:
|
||
|
(+) The DMA circular mode cannot be used when the SPI is configured in these modes:
|
||
|
(++) Master 2Lines RxOnly
|
||
|
(++) Master 1Line Rx
|
||
|
(+) The CRC feature is not managed when the DMA circular mode is enabled
|
||
|
(+) The functions HAL_SPI_DMAPause()/ HAL_SPI_DMAResume() are not supported. Return always
|
||
|
HAL_ERROR with ErrorCode set to HAL_SPI_ERROR_NOT_SUPPORTED.
|
||
|
Those functions are maintained for backward compatibility reasons.
|
||
|
|
||
|
@endverbatim
|
||
|
******************************************************************************
|
||
|
* @attention
|
||
|
*
|
||
|
* <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
|
||
|
*
|
||
|
* Redistribution and use in source and binary forms, with or without modification,
|
||
|
* are permitted provided that the following conditions are met:
|
||
|
* 1. Redistributions of source code must retain the above copyright notice,
|
||
|
* this list of conditions and the following disclaimer.
|
||
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
||
|
* this list of conditions and the following disclaimer in the documentation
|
||
|
* and/or other materials provided with the distribution.
|
||
|
* 3. Neither the name of STMicroelectronics nor the names of its contributors
|
||
|
* may be used to endorse or promote products derived from this software
|
||
|
* without specific prior written permission.
|
||
|
*
|
||
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
||
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||
|
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||
|
*
|
||
|
******************************************************************************
|
||
|
*/
|
||
|
|
||
|
/* Includes ------------------------------------------------------------------*/
|
||
|
#include "stm32h7xx_hal.h"
|
||
|
|
||
|
/** @addtogroup STM32H7xx_HAL_Driver
|
||
|
* @{
|
||
|
*/
|
||
|
|
||
|
/** @defgroup SPI SPI
|
||
|
* @brief SPI HAL module driver
|
||
|
* @{
|
||
|
*/
|
||
|
#ifdef HAL_SPI_MODULE_ENABLED
|
||
|
|
||
|
/* Private typedef -----------------------------------------------------------*/
|
||
|
/* Private defines -----------------------------------------------------------*/
|
||
|
/** @defgroup SPI_Private_Constants SPI Private Constants
|
||
|
* @{
|
||
|
*/
|
||
|
#define SPI_DEFAULT_TIMEOUT 100U
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/* Private macros ------------------------------------------------------------*/
|
||
|
/* Private variables ---------------------------------------------------------*/
|
||
|
/* Private function prototypes -----------------------------------------------*/
|
||
|
/** @defgroup SPI_Private_Functions SPI Private Functions
|
||
|
* @{
|
||
|
*/
|
||
|
static void SPI_DMATransmitCplt(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMAReceiveCplt(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMATransmitReceiveCplt(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMAHalfTransmitCplt(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMAHalfReceiveCplt(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMAHalfTransmitReceiveCplt(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMAError(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMAAbortOnError(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMATxAbortCallback(DMA_HandleTypeDef *hdma);
|
||
|
static void SPI_DMARxAbortCallback(DMA_HandleTypeDef *hdma);
|
||
|
static HAL_StatusTypeDef SPI_WaitOnFlagUntilTimeout(SPI_HandleTypeDef *hspi, uint32_t Flag, FlagStatus FlagStatus,
|
||
|
uint32_t Timeout, uint32_t Tickstart);
|
||
|
static void SPI_TxISR_8BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_TxISR_16BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_TxISR_32BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_RxISR_8BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_RxISR_16BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_RxISR_32BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_2linesRxISR_8BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_2linesTxISR_8BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_2linesTxISR_16BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_2linesTxISR_32BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_2linesRxISR_16BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_2linesRxISR_32BIT(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_AbortTransfer(SPI_HandleTypeDef *hspi);
|
||
|
static void SPI_CloseTransfer(SPI_HandleTypeDef *hspi);
|
||
|
static uint32_t SPI_GetPacketSize(SPI_HandleTypeDef *hspi);
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/* Exported functions --------------------------------------------------------*/
|
||
|
/** @defgroup SPI_Exported_Functions SPI Exported Functions
|
||
|
* @{
|
||
|
*/
|
||
|
|
||
|
/** @defgroup SPI_Exported_Functions_Group1 Initialization and de-initialization functions
|
||
|
* @brief Initialization and Configuration functions
|
||
|
*
|
||
|
@verbatim
|
||
|
===============================================================================
|
||
|
##### Initialization and de-initialization functions #####
|
||
|
===============================================================================
|
||
|
[..] This subsection provides a set of functions allowing to initialize and
|
||
|
de-initialize the SPIx peripheral:
|
||
|
|
||
|
(+) User must implement HAL_SPI_MspInit() function in which he configures
|
||
|
all related peripherals resources (CLOCK, GPIO, DMA, IT and NVIC ).
|
||
|
|
||
|
(+) Call the function HAL_SPI_Init() to configure the selected device with
|
||
|
the selected configuration:
|
||
|
(++) Mode
|
||
|
(++) Direction
|
||
|
(++) Data Size
|
||
|
(++) Clock Polarity and Phase
|
||
|
(++) NSS Management
|
||
|
(++) BaudRate Prescaler
|
||
|
(++) FirstBit
|
||
|
(++) TIMode
|
||
|
(++) CRC Calculation
|
||
|
(++) CRC Polynomial if CRC enabled
|
||
|
(++) CRC Length, used only with Data8 and Data16
|
||
|
(++) FIFO reception threshold
|
||
|
(++) FIFO transmission threshold
|
||
|
|
||
|
(+) Call the function HAL_SPI_DeInit() to restore the default configuration
|
||
|
of the selected SPIx peripheral.
|
||
|
|
||
|
@endverbatim
|
||
|
* @{
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @brief Initialize the SPI according to the specified parameters
|
||
|
* in the SPI_InitTypeDef and initialize the associated handle.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Init(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
uint32_t crc_length = 0;
|
||
|
uint32_t packet_length = 0;
|
||
|
|
||
|
/* Check the SPI handle allocation */
|
||
|
if (hspi == NULL)
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/* Check the parameters */
|
||
|
assert_param(IS_SPI_ALL_INSTANCE(hspi->Instance));
|
||
|
assert_param(IS_SPI_MODE(hspi->Init.Mode));
|
||
|
assert_param(IS_SPI_DIRECTION(hspi->Init.Direction));
|
||
|
assert_param(IS_SPI_DATASIZE(hspi->Init.DataSize));
|
||
|
assert_param(IS_SPI_FIFOTHRESHOLD(hspi->Init.FifoThreshold));
|
||
|
assert_param(IS_SPI_NSS(hspi->Init.NSS));
|
||
|
assert_param(IS_SPI_NSSP(hspi->Init.NSSPMode));
|
||
|
assert_param(IS_SPI_BAUDRATE_PRESCALER(hspi->Init.BaudRatePrescaler));
|
||
|
assert_param(IS_SPI_FIRST_BIT(hspi->Init.FirstBit));
|
||
|
assert_param(IS_SPI_TIMODE(hspi->Init.TIMode));
|
||
|
if (hspi->Init.TIMode == SPI_TIMODE_DISABLE)
|
||
|
{
|
||
|
assert_param(IS_SPI_CPOL(hspi->Init.CLKPolarity));
|
||
|
assert_param(IS_SPI_CPHA(hspi->Init.CLKPhase));
|
||
|
}
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
assert_param(IS_SPI_CRC_CALCULATION(hspi->Init.CRCCalculation));
|
||
|
if (hspi->Init.CRCCalculation == SPI_CRCCALCULATION_ENABLE)
|
||
|
{
|
||
|
assert_param(IS_SPI_CRC_POLYNOMIAL(hspi->Init.CRCPolynomial));
|
||
|
assert_param(IS_SPI_CRC_LENGTH(hspi->Init.CRCLength));
|
||
|
assert_param(IS_SPI_CRC_INITIALIZATION_PATTERN(hspi->Init.TxCRCInitializationPattern));
|
||
|
assert_param(IS_SPI_CRC_INITIALIZATION_PATTERN(hspi->Init.RxCRCInitializationPattern));
|
||
|
}
|
||
|
#else
|
||
|
hspi->Init.CRCCalculation = SPI_CRCCALCULATION_DISABLE;
|
||
|
#endif /* USE_SPI_CRC */
|
||
|
|
||
|
/* Verify that the SPI instance supports Data Size higher than 16bits */
|
||
|
if ((!IS_SPI_HIGHEND_INSTANCE(hspi->Instance)) && (hspi->Init.DataSize > SPI_DATASIZE_16BIT))
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/* Verify that the SPI instance supports requested data packing */
|
||
|
packet_length = SPI_GetPacketSize(hspi);
|
||
|
if (((!IS_SPI_HIGHEND_INSTANCE(hspi->Instance)) && (packet_length > SPI_LOWEND_FIFO_SIZE )) ||
|
||
|
(( IS_SPI_HIGHEND_INSTANCE(hspi->Instance)) && (packet_length > SPI_HIGHEND_FIFO_SIZE)) )
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
if (hspi->Init.CRCCalculation == SPI_CRCCALCULATION_ENABLE)
|
||
|
{
|
||
|
/* Verify that the SPI instance supports CRC Length higher than 16bits */
|
||
|
if ((!IS_SPI_HIGHEND_INSTANCE(hspi->Instance)) && (hspi->Init.CRCLength > SPI_CRC_LENGTH_16BIT))
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/* Align the CRC Length on the data size */
|
||
|
if (hspi->Init.CRCLength == SPI_CRC_LENGTH_DATASIZE)
|
||
|
{
|
||
|
crc_length = (hspi->Init.DataSize >> SPI_CFG1_DSIZE_Pos) << SPI_CFG1_CRCSIZE_Pos;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
crc_length = hspi->Init.CRCLength;
|
||
|
}
|
||
|
|
||
|
/* Verify that the CRC Length is higher than DataSize */
|
||
|
if ((hspi->Init.DataSize >> SPI_CFG1_DSIZE_Pos) > (crc_length >> SPI_CFG1_CRCSIZE_Pos))
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
#endif /* USE_SPI_CRC */
|
||
|
|
||
|
if (hspi->State == HAL_SPI_STATE_RESET)
|
||
|
{
|
||
|
/* Allocate lock resource and initialize it */
|
||
|
hspi->Lock = HAL_UNLOCKED;
|
||
|
|
||
|
/* Init the low level hardware : GPIO, CLOCK, NVIC... */
|
||
|
HAL_SPI_MspInit(hspi);
|
||
|
}
|
||
|
|
||
|
hspi->State = HAL_SPI_STATE_BUSY;
|
||
|
|
||
|
/* Disable the selected SPI peripheral */
|
||
|
__HAL_SPI_DISABLE(hspi);
|
||
|
|
||
|
/*----------------------- SPIx CR1 & CR2 Configuration ---------------------*/
|
||
|
/* Configure : SPI Mode, Communication Mode, Clock polarity and phase, NSS management,
|
||
|
Communication speed, First bit, CRC calculation state, CRC Length */
|
||
|
|
||
|
if ((hspi->Init.NSS == SPI_NSS_SOFT) && (hspi->Init.Mode == SPI_MODE_MASTER) && (hspi->Init.NSSPolarity == SPI_NSS_POLARITY_LOW))
|
||
|
{
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_SSI);
|
||
|
}
|
||
|
|
||
|
/* SPIx CFG1 Configuration */
|
||
|
WRITE_REG(hspi->Instance->CFG1, (hspi->Init.BaudRatePrescaler | hspi->Init.CRCCalculation | crc_length |
|
||
|
hspi->Init.FifoThreshold | hspi->Init.DataSize));
|
||
|
|
||
|
/* SPIx CFG2 Configuration */
|
||
|
WRITE_REG(hspi->Instance->CFG2, (hspi->Init.NSSPMode | hspi->Init.TIMode | hspi->Init.NSSPolarity |
|
||
|
hspi->Init.NSS | hspi->Init.CLKPolarity | hspi->Init.CLKPhase |
|
||
|
hspi->Init.FirstBit | hspi->Init.Mode | hspi->Init.MasterInterDataIdleness |
|
||
|
hspi->Init.Direction | hspi->Init.MasterSSIdleness | hspi->Init.IOSwap));
|
||
|
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
/*---------------------------- SPIx CRCPOLY Configuration ------------------*/
|
||
|
/* Configure : CRC Polynomial */
|
||
|
if (hspi->Init.CRCCalculation == SPI_CRCCALCULATION_ENABLE)
|
||
|
{
|
||
|
/* Initialize TXCRC Pattern Initial Value */
|
||
|
if (hspi->Init.TxCRCInitializationPattern == SPI_CRC_INITIALIZATION_ALL_ONE_PATTERN)
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_TCRCINI);
|
||
|
else
|
||
|
CLEAR_BIT(hspi->Instance->CR1, SPI_CR1_TCRCINI);
|
||
|
|
||
|
/* Initialize RXCRC Pattern Initial Value */
|
||
|
if (hspi->Init.RxCRCInitializationPattern == SPI_CRC_INITIALIZATION_ALL_ONE_PATTERN)
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_RCRCINI);
|
||
|
else
|
||
|
CLEAR_BIT(hspi->Instance->CR1, SPI_CR1_RCRCINI);
|
||
|
|
||
|
/* Enable 33/17 bits CRC computation */
|
||
|
if (((!IS_SPI_HIGHEND_INSTANCE(hspi->Instance)) && (crc_length == SPI_CRC_LENGTH_16BIT)) ||
|
||
|
((IS_SPI_HIGHEND_INSTANCE(hspi->Instance)) && (crc_length == SPI_CRC_LENGTH_32BIT)) )
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CRC33_17);
|
||
|
else
|
||
|
CLEAR_BIT(hspi->Instance->CR1, SPI_CR1_CRC33_17);
|
||
|
|
||
|
/* Write CRC polynomial in SPI Register */
|
||
|
WRITE_REG(hspi->Instance->CRCPOLY, hspi->Init.CRCPolynomial);
|
||
|
}
|
||
|
#endif /* USE_SPI_CRC */
|
||
|
|
||
|
/* Insure that Underrun configuration is managed only by Salve */
|
||
|
if (hspi->Init.Mode == SPI_MODE_SLAVE)
|
||
|
{
|
||
|
/* Set Default Underrun configuration */
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
if (hspi->Init.CRCCalculation == SPI_CRCCALCULATION_DISABLE)
|
||
|
#endif
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CFG1, SPI_CFG1_UDRDET, SPI_CFG1_UDRDET_0);
|
||
|
}
|
||
|
MODIFY_REG(hspi->Instance->CFG1, SPI_CFG1_UDRCFG, SPI_CFG1_UDRCFG_1);
|
||
|
}
|
||
|
|
||
|
#if defined(SPI_I2SCFGR_I2SMOD)
|
||
|
/* Activate the SPI mode (Make sure that I2SMOD bit in I2SCFGR register is reset) */
|
||
|
CLEAR_BIT(hspi->Instance->I2SCFGR, SPI_I2SCFGR_I2SMOD);
|
||
|
#endif /* SPI_I2SCFGR_I2SMOD */
|
||
|
|
||
|
/* Insure that AFCNTR is managed only by Master */
|
||
|
if ((hspi->Init.Mode & SPI_MODE_MASTER) == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Alternate function GPIOs control */
|
||
|
MODIFY_REG(hspi->Instance->CFG2, SPI_CFG2_AFCNTR, (hspi->Init.MasterKeepIOState));
|
||
|
}
|
||
|
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
return HAL_OK;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief De-Initialize the SPI peripheral.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_DeInit(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Check the SPI handle allocation */
|
||
|
if (hspi == NULL)
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/* Check SPI Instance parameter */
|
||
|
assert_param(IS_SPI_ALL_INSTANCE(hspi->Instance));
|
||
|
|
||
|
hspi->State = HAL_SPI_STATE_BUSY;
|
||
|
|
||
|
/* Disable the SPI Peripheral Clock */
|
||
|
__HAL_SPI_DISABLE(hspi);
|
||
|
|
||
|
/* DeInit the low level hardware: GPIO, CLOCK, NVIC... */
|
||
|
HAL_SPI_MspDeInit(hspi);
|
||
|
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->State = HAL_SPI_STATE_RESET;
|
||
|
|
||
|
/* Release Lock */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
return HAL_OK;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Initialize the SPI MSP.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_MspInit(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_MspInit should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief De-Initialize the SPI MSP.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_MspDeInit(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_MspDeInit should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/** @defgroup SPI_Exported_Functions_Group2 IO operation functions
|
||
|
* @brief Data transfers functions
|
||
|
*
|
||
|
@verbatim
|
||
|
==============================================================================
|
||
|
##### IO operation functions #####
|
||
|
===============================================================================
|
||
|
[..]
|
||
|
This subsection provides a set of functions allowing to manage the SPI
|
||
|
data transfers.
|
||
|
|
||
|
[..] The SPI supports master and slave mode :
|
||
|
|
||
|
(#) There are two modes of transfer:
|
||
|
(##) Blocking mode: The communication is performed in polling mode.
|
||
|
The HAL status of all data processing is returned by the same function
|
||
|
after finishing transfer.
|
||
|
(##) No-Blocking mode: The communication is performed using Interrupts
|
||
|
or DMA, These APIs return the HAL status.
|
||
|
The end of the data processing will be indicated through the
|
||
|
dedicated SPI IRQ when using Interrupt mode or the DMA IRQ when
|
||
|
using DMA mode.
|
||
|
The HAL_SPI_TxCpltCallback(), HAL_SPI_RxCpltCallback() and HAL_SPI_TxRxCpltCallback() user callbacks
|
||
|
will be executed respectively at the end of the transmit or Receive process
|
||
|
The HAL_SPI_ErrorCallback()user callback will be executed when a communication error is detected
|
||
|
|
||
|
(#) APIs provided for these 2 transfer modes (Blocking mode or Non blocking mode using either Interrupt or DMA)
|
||
|
exist for 1Line (simplex) and 2Lines (full duplex) modes.
|
||
|
|
||
|
@endverbatim
|
||
|
* @{
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @brief Transmit an amount of data in blocking mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pData: pointer to data buffer
|
||
|
* @param Size: amount of data to be sent
|
||
|
* @param Timeout: Timeout duration
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout)
|
||
|
{
|
||
|
uint32_t tickstart = 0U;
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_TXONLY(hspi->Init.Direction));
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
/* Init tickstart for timeout management*/
|
||
|
tickstart = HAL_GetTick();
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_READY)
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_TX;
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pTxBuffPtr = (uint8_t *)pData;
|
||
|
hspi->TxXferSize = Size;
|
||
|
hspi->TxXferCount = Size;
|
||
|
|
||
|
/*Init field not used in handle to zero */
|
||
|
hspi->pRxBuffPtr = NULL;
|
||
|
hspi->RxXferSize = 0U;
|
||
|
hspi->RxXferCount = 0U;
|
||
|
hspi->TxISR = NULL;
|
||
|
hspi->RxISR = NULL;
|
||
|
|
||
|
/* Configure communication direction : 1Line */
|
||
|
if (hspi->Init.Direction == SPI_DIRECTION_1LINE)
|
||
|
{
|
||
|
SPI_1LINE_TX(hspi);
|
||
|
}
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Transmit data in 32 Bit mode */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
/* Transmit data in 32 Bit mode */
|
||
|
while (hspi->TxXferCount > 0U)
|
||
|
{
|
||
|
/* Wait until TXE flag is set to send data */
|
||
|
if (__HAL_SPI_GET_FLAG(hspi, SPI_FLAG_TXE))
|
||
|
{
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount--;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Timeout management */
|
||
|
if ((Timeout == 0U) || ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout)))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/* Transmit data in 16 Bit mode */
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
/* Transmit data in 16 Bit mode */
|
||
|
while (hspi->TxXferCount > 0U)
|
||
|
{
|
||
|
/* Wait until TXE flag is set to send data */
|
||
|
if (__HAL_SPI_GET_FLAG(hspi, SPI_FLAG_TXE))
|
||
|
{
|
||
|
if ( (hspi->TxXferCount > 1U) && (hspi->Init.FifoThreshold > SPI_FIFO_THRESHOLD_01DATA))
|
||
|
{
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((__IO uint16_t *)&hspi->Instance->TXDR) = *((uint16_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->TxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Timeout management */
|
||
|
if ((Timeout == 0U) || ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout)))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/* Transmit data in 8 Bit mode */
|
||
|
else
|
||
|
{
|
||
|
while (hspi->TxXferCount > 0U)
|
||
|
{
|
||
|
/* Wait until TXE flag is set to send data */
|
||
|
if (__HAL_SPI_GET_FLAG(hspi, SPI_FLAG_TXE))
|
||
|
{
|
||
|
if ((hspi->TxXferCount > 3U) && (hspi->Init.FifoThreshold > SPI_FIFO_THRESHOLD_03DATA))
|
||
|
{
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount-=4;
|
||
|
}
|
||
|
else if ((hspi->TxXferCount > 1U) && (hspi->Init.FifoThreshold > SPI_FIFO_THRESHOLD_01DATA))
|
||
|
{
|
||
|
*((__IO uint16_t *)&hspi->Instance->TXDR) = *((uint16_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->TxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((__IO uint8_t *)&hspi->Instance->TXDR) = *((uint8_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->TxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Timeout management */
|
||
|
if ((Timeout == 0U) || ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout)))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Wait for Tx (and CRC) data to be sent */
|
||
|
if (SPI_WaitOnFlagUntilTimeout(hspi, SPI_FLAG_EOT, RESET, tickstart, Timeout) != HAL_OK)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_FLAG);
|
||
|
}
|
||
|
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
if (hspi->ErrorCode != HAL_SPI_ERROR_NONE)
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
return HAL_OK;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Receive an amount of data in blocking mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pData: pointer to data buffer
|
||
|
* @param Size: amount of data to be received
|
||
|
* @param Timeout: Timeout duration
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout)
|
||
|
{
|
||
|
uint32_t tickstart = 0U;
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_RXONLY(hspi->Init.Direction));
|
||
|
|
||
|
if ((hspi->Init.Mode == SPI_MODE_MASTER) && (hspi->Init.Direction == SPI_DIRECTION_2LINES))
|
||
|
{
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_RX;
|
||
|
/* Call transmit-receive function to send Dummy data on Tx line and generate clock on CLK line */
|
||
|
return HAL_SPI_TransmitReceive(hspi, pData, pData, Size, Timeout);
|
||
|
}
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
/* Init tickstart for timeout management*/
|
||
|
tickstart = HAL_GetTick();
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_READY)
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_RX;
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pRxBuffPtr = (uint8_t *)pData;
|
||
|
hspi->RxXferSize = Size;
|
||
|
hspi->RxXferCount = Size;
|
||
|
|
||
|
/*Init field not used in handle to zero */
|
||
|
hspi->pTxBuffPtr = NULL;
|
||
|
hspi->TxXferSize = 0U;
|
||
|
hspi->TxXferCount = 0U;
|
||
|
hspi->RxISR = NULL;
|
||
|
hspi->TxISR = NULL;
|
||
|
|
||
|
/* Configure communication direction: 1Line */
|
||
|
if (hspi->Init.Direction == SPI_DIRECTION_1LINE)
|
||
|
{
|
||
|
SPI_1LINE_RX(hspi);
|
||
|
}
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Receive data in 32 Bit mode */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
/* Transfer loop */
|
||
|
while (hspi->RxXferCount > 0U)
|
||
|
{
|
||
|
/* Check the RXWNE/EOT flag */
|
||
|
if (hspi->Instance->SR & (SPI_FLAG_RXWNE|SPI_FLAG_EOT))
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount--;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Timeout management */
|
||
|
if ((Timeout == 0U) || ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout)))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/* Receive data in 16 Bit mode */
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
/* Transfer loop */
|
||
|
while (hspi->RxXferCount > 0U)
|
||
|
{
|
||
|
/* Check the RXWNE/FRLVL flag */
|
||
|
if (hspi->Instance->SR & (SPI_FLAG_RXWNE|SPI_FLAG_FRLVL))
|
||
|
{
|
||
|
if (hspi->Instance->SR & SPI_FLAG_RXWNE)
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = *((__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->RxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Timeout management */
|
||
|
if ((Timeout == 0U) || ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout)))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/* Receive data in 8 Bit mode */
|
||
|
else
|
||
|
{
|
||
|
/* Transfer loop */
|
||
|
while (hspi->RxXferCount > 0U)
|
||
|
{
|
||
|
/* Check the RXWNE/FRLVL flag */
|
||
|
if (hspi->Instance->SR & (SPI_FLAG_RXWNE|SPI_FLAG_FRLVL))
|
||
|
{
|
||
|
if (hspi->Instance->SR & SPI_FLAG_RXWNE)
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount-=4;
|
||
|
}
|
||
|
else if ((hspi->Instance->SR & SPI_FLAG_FRLVL) > SPI_FRLVL_QUARTER_FULL)
|
||
|
{
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = *((__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->RxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((uint8_t *)hspi->pRxBuffPtr) = *((__IO uint8_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->RxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Timeout management */
|
||
|
if ((Timeout == 0U) || ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout)))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
if (hspi->Init.CRCCalculation == SPI_CRCCALCULATION_ENABLE)
|
||
|
{
|
||
|
/* Wait for crc data to be received */
|
||
|
if (SPI_WaitOnFlagUntilTimeout(hspi, SPI_FLAG_EOT, RESET, tickstart, Timeout) != HAL_OK)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_FLAG);
|
||
|
}
|
||
|
}
|
||
|
#endif /* USE_SPI_CRC */
|
||
|
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
if (hspi->ErrorCode != HAL_SPI_ERROR_NONE)
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
return HAL_OK;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Transmit and Receive an amount of data in blocking mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pTxData: pointer to transmission data buffer
|
||
|
* @param pRxData: pointer to reception data buffer
|
||
|
* @param Size: amount of data to be sent and received
|
||
|
* @param Timeout: Timeout duration
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size,
|
||
|
uint32_t Timeout)
|
||
|
{
|
||
|
uint32_t tickstart = 0U;
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES(hspi->Init.Direction));
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
/* Init tickstart for timeout management*/
|
||
|
tickstart = HAL_GetTick();
|
||
|
|
||
|
if (!((hspi->State == HAL_SPI_STATE_READY) || \
|
||
|
((hspi->Init.Mode == SPI_MODE_MASTER) && (hspi->Init.Direction == SPI_DIRECTION_2LINES) && (hspi->State == HAL_SPI_STATE_BUSY_RX))))
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pTxData == NULL) || (pRxData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Don't overwrite in case of HAL_SPI_STATE_BUSY_RX */
|
||
|
if (hspi->State != HAL_SPI_STATE_BUSY_RX)
|
||
|
{
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_TX_RX;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pRxBuffPtr = (uint8_t *)pRxData;
|
||
|
hspi->RxXferCount = Size;
|
||
|
hspi->RxXferSize = Size;
|
||
|
hspi->pTxBuffPtr = (uint8_t *)pTxData;
|
||
|
hspi->TxXferCount = Size;
|
||
|
hspi->TxXferSize = Size;
|
||
|
|
||
|
/*Init field not used in handle to zero */
|
||
|
hspi->RxISR = NULL;
|
||
|
hspi->TxISR = NULL;
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Transmit and Receive data in 32 Bit mode */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
while ((hspi->TxXferCount > 0U) || (hspi->RxXferCount > 0U))
|
||
|
{
|
||
|
/* Check TXE flag */
|
||
|
if ((hspi->TxXferCount > 0U) && (__HAL_SPI_GET_FLAG(hspi, SPI_FLAG_TXE)))
|
||
|
{
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount --;
|
||
|
}
|
||
|
|
||
|
/* Check RXWNE/EOT flag */
|
||
|
if ((hspi->RxXferCount > 0U) && (hspi->Instance->SR & (SPI_FLAG_RXWNE|SPI_FLAG_EOT)))
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount --;
|
||
|
}
|
||
|
|
||
|
if ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/* Transmit and Receive data in 16 Bit mode */
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
while ((hspi->TxXferCount > 0U) || (hspi->RxXferCount > 0U))
|
||
|
{
|
||
|
/* Check TXE flag */
|
||
|
if ((hspi->TxXferCount > 0U) && (__HAL_SPI_GET_FLAG(hspi, SPI_FLAG_TXE)))
|
||
|
{
|
||
|
if ( (hspi->TxXferCount > 1U) && (hspi->Init.FifoThreshold > SPI_FIFO_THRESHOLD_01DATA))
|
||
|
{
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((__IO uint16_t *)&hspi->Instance->TXDR) = *((uint16_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->TxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Check RXWNE/FRLVL flag */
|
||
|
if ((hspi->RxXferCount > 0U) && (hspi->Instance->SR & (SPI_FLAG_RXWNE|SPI_FLAG_FRLVL)))
|
||
|
{
|
||
|
if (hspi->Instance->SR & SPI_FLAG_RXWNE)
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = *((__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->RxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
if ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
/* Transmit and Receive data in 8 Bit mode */
|
||
|
else
|
||
|
{
|
||
|
while ((hspi->TxXferCount > 0U) || (hspi->RxXferCount > 0U))
|
||
|
{
|
||
|
/* check TXE flag */
|
||
|
if ((hspi->TxXferCount > 0U) && (__HAL_SPI_GET_FLAG(hspi, SPI_FLAG_TXE)))
|
||
|
{
|
||
|
if ((hspi->TxXferCount > 3U) && (hspi->Init.FifoThreshold > SPI_FIFO_THRESHOLD_03DATA))
|
||
|
{
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount-=4;
|
||
|
}
|
||
|
else if ((hspi->TxXferCount > 1U) && (hspi->Init.FifoThreshold > SPI_FIFO_THRESHOLD_01DATA))
|
||
|
{
|
||
|
*((__IO uint16_t *)&hspi->Instance->TXDR) = *((uint16_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->TxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((__IO uint8_t *)&hspi->Instance->TXDR) = *((uint8_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->TxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Wait until RXWNE/FRLVL flag is reset */
|
||
|
if ((hspi->RxXferCount > 0U) && (hspi->Instance->SR & (SPI_FLAG_RXWNE|SPI_FLAG_FRLVL)))
|
||
|
{
|
||
|
if (hspi->Instance->SR & SPI_FLAG_RXWNE)
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount-=4;
|
||
|
}
|
||
|
else if ((hspi->Instance->SR & SPI_FLAG_FRLVL) > SPI_FRLVL_QUARTER_FULL)
|
||
|
{
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = *((__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->RxXferCount-=2;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
*((uint8_t *)hspi->pRxBuffPtr) = *((__IO uint8_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->RxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
if ((Timeout != HAL_MAX_DELAY) && ((HAL_GetTick() - tickstart) >= Timeout))
|
||
|
{
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_TIMEOUT);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Wait for Tx/Rx (and CRC) data to be sent/received */
|
||
|
if (SPI_WaitOnFlagUntilTimeout(hspi, SPI_FLAG_EOT, RESET, tickstart, Timeout) != HAL_OK)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_FLAG);
|
||
|
}
|
||
|
|
||
|
/* Call standard close procedure with error check */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
if (hspi->ErrorCode != HAL_SPI_ERROR_NONE)
|
||
|
{
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
return HAL_OK;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Transmit an amount of data in non-blocking mode with Interrupt.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pData: pointer to data buffer
|
||
|
* @param Size: amount of data to be sent
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Transmit_IT(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_TXONLY(hspi->Init.Direction));
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
if ((pData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_READY)
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_TX;
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pTxBuffPtr = (uint8_t *)pData;
|
||
|
hspi->TxXferSize = Size;
|
||
|
hspi->TxXferCount = Size;
|
||
|
|
||
|
/* Init field not used in handle to zero */
|
||
|
hspi->pRxBuffPtr = NULL;
|
||
|
hspi->RxXferSize = 0U;
|
||
|
hspi->RxXferCount = 0U;
|
||
|
hspi->RxISR = NULL;
|
||
|
|
||
|
/* Set the function for IT treatment */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
hspi->TxISR = SPI_TxISR_32BIT;
|
||
|
}
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
hspi->TxISR = SPI_TxISR_16BIT;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
hspi->TxISR = SPI_TxISR_8BIT;
|
||
|
}
|
||
|
|
||
|
/* Configure communication direction : 1Line */
|
||
|
if (hspi->Init.Direction == SPI_DIRECTION_1LINE)
|
||
|
{
|
||
|
SPI_1LINE_TX(hspi);
|
||
|
}
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
/* Enable EOT, TXE and UDR interrupt */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, (SPI_IT_EOT | SPI_IT_TXE | SPI_IT_UDR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Receive an amount of data in non-blocking mode with Interrupt.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pData: pointer to data buffer
|
||
|
* @param Size: amount of data to be sent
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Receive_IT(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_RXONLY(hspi->Init.Direction));
|
||
|
|
||
|
if ((hspi->Init.Direction == SPI_DIRECTION_2LINES) && (hspi->Init.Mode == SPI_MODE_MASTER))
|
||
|
{
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_RX;
|
||
|
/* Call transmit-receive function to send Dummy data on Tx line and generate clock on CLK line */
|
||
|
return HAL_SPI_TransmitReceive_IT(hspi, pData, pData, Size);
|
||
|
}
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_READY)
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_RX;
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pRxBuffPtr = (uint8_t *)pData;
|
||
|
hspi->RxXferSize = Size;
|
||
|
hspi->RxXferCount = Size;
|
||
|
|
||
|
/* Init field not used in handle to zero */
|
||
|
hspi->pTxBuffPtr = NULL;
|
||
|
hspi->TxXferSize = 0U;
|
||
|
hspi->TxXferCount = 0U;
|
||
|
hspi->TxISR = NULL;
|
||
|
|
||
|
/* Set the function for IT treatment */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
hspi->RxISR = SPI_RxISR_32BIT;
|
||
|
}
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
hspi->RxISR = SPI_RxISR_16BIT;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
hspi->RxISR = SPI_RxISR_8BIT;
|
||
|
}
|
||
|
|
||
|
/* Configure communication direction : 1Line */
|
||
|
if (hspi->Init.Direction == SPI_DIRECTION_1LINE)
|
||
|
{
|
||
|
SPI_1LINE_RX(hspi);
|
||
|
}
|
||
|
|
||
|
/* Note : The SPI must be enabled after unlocking current process
|
||
|
to avoid the risk of SPI interrupt handle execution before current
|
||
|
process unlock */
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
/* Enable EOT, RXNE and OVR interrupt */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, (SPI_IT_EOT | SPI_IT_RXNE | SPI_IT_OVR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Transmit and Receive an amount of data in non-blocking mode with Interrupt.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pTxData: pointer to transmission data buffer
|
||
|
* @param pRxData: pointer to reception data buffer
|
||
|
* @param Size: amount of data to be sent and received
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES(hspi->Init.Direction));
|
||
|
|
||
|
/* Process locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
if (!((hspi->State == HAL_SPI_STATE_READY) || \
|
||
|
((hspi->Init.Mode == SPI_MODE_MASTER) && (hspi->Init.Direction == SPI_DIRECTION_2LINES) && (hspi->State == HAL_SPI_STATE_BUSY_RX))))
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pTxData == NULL) || (pRxData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Don't overwrite in case of HAL_SPI_STATE_BUSY_RX */
|
||
|
if (hspi->State != HAL_SPI_STATE_BUSY_RX)
|
||
|
{
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_TX_RX;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pTxBuffPtr = (uint8_t *)pTxData;
|
||
|
hspi->TxXferSize = Size;
|
||
|
hspi->TxXferCount = Size;
|
||
|
hspi->pRxBuffPtr = (uint8_t *)pRxData;
|
||
|
hspi->RxXferSize = Size;
|
||
|
hspi->RxXferCount = Size;
|
||
|
|
||
|
/* Set the function for IT treatment */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
hspi->RxISR = SPI_2linesRxISR_32BIT;
|
||
|
hspi->TxISR = SPI_2linesTxISR_32BIT;
|
||
|
}
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
hspi->RxISR = SPI_2linesRxISR_16BIT;
|
||
|
hspi->TxISR = SPI_2linesTxISR_16BIT;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
hspi->RxISR = SPI_2linesRxISR_8BIT;
|
||
|
hspi->TxISR = SPI_2linesTxISR_8BIT;
|
||
|
}
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
/* Enable EOT, TXE, RXNE, UDR and OVR interrupt */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, (SPI_IT_EOT | SPI_IT_TXE | SPI_IT_RXNE | SPI_IT_UDR | SPI_IT_OVR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Transmit an amount of data in non-blocking mode with DMA.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pData: pointer to data buffer
|
||
|
* @param Size: amount of data to be sent
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Transmit_DMA(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_TXONLY(hspi->Init.Direction));
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_READY)
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_TX;
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pTxBuffPtr = (uint8_t *)pData;
|
||
|
hspi->TxXferSize = Size;
|
||
|
hspi->TxXferCount = Size;
|
||
|
|
||
|
/* Init field not used in handle to zero */
|
||
|
hspi->pRxBuffPtr = NULL;
|
||
|
hspi->TxISR = NULL;
|
||
|
hspi->RxISR = NULL;
|
||
|
hspi->RxXferSize = 0U;
|
||
|
hspi->RxXferCount = 0U;
|
||
|
|
||
|
/* Configure communication direction : 1Line */
|
||
|
if (hspi->Init.Direction == SPI_DIRECTION_1LINE)
|
||
|
{
|
||
|
SPI_1LINE_TX(hspi);
|
||
|
}
|
||
|
|
||
|
/* Packing mode management is enabled by the DMA settings */
|
||
|
if (((hspi->Init.DataSize > SPI_DATASIZE_16BIT) && (hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_WORD)) || \
|
||
|
((hspi->Init.DataSize > SPI_DATASIZE_8BIT) && ((hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_HALFWORD) && \
|
||
|
(hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_WORD))))
|
||
|
{
|
||
|
/* Restriction the DMA data received is not allowed in this mode */
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Adjust XferCount according to DMA alignement / Data size */
|
||
|
if (hspi->Init.DataSize <= SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
if (hspi->hdmatx->Init.MemDataAlignment == DMA_MDATAALIGN_HALFWORD)
|
||
|
{
|
||
|
hspi->TxXferCount = (hspi->TxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
if (hspi->hdmatx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->TxXferCount = (hspi->TxXferCount + 3U) >> 2U;
|
||
|
}
|
||
|
}
|
||
|
else if (hspi->Init.DataSize <= SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
if (hspi->hdmatx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->TxXferCount = (hspi->TxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Set the SPI TxDMA Half transfer complete callback */
|
||
|
hspi->hdmatx->XferHalfCpltCallback = SPI_DMAHalfTransmitCplt;
|
||
|
|
||
|
/* Set the SPI TxDMA transfer complete callback */
|
||
|
hspi->hdmatx->XferCpltCallback = SPI_DMATransmitCplt;
|
||
|
|
||
|
/* Set the DMA error callback */
|
||
|
hspi->hdmatx->XferErrorCallback = SPI_DMAError;
|
||
|
|
||
|
/* Set the DMA AbortCpltCallback */
|
||
|
hspi->hdmatx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Clear TXDMAEN bit*/
|
||
|
CLEAR_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN);
|
||
|
|
||
|
/* Enable the Tx DMA Stream/Channel */
|
||
|
HAL_DMA_Start_IT(hspi->hdmatx, (uint32_t)hspi->pTxBuffPtr, (uint32_t)&hspi->Instance->TXDR, hspi->TxXferCount);
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
if (hspi->hdmatx->Init.Mode == DMA_CIRCULAR)
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, 0);
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
}
|
||
|
|
||
|
/* Enable Tx DMA Request */
|
||
|
SET_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN);
|
||
|
|
||
|
/* Enable the SPI Error Interrupt Bit */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, (SPI_IT_UDR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Receive an amount of data in non-blocking mode with DMA.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pData: pointer to data buffer
|
||
|
* @note When the CRC feature is enabled the pData Length must be Size + 1.
|
||
|
* @param Size: amount of data to be sent
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Receive_DMA(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES_OR_1LINE_2LINES_RXONLY(hspi->Init.Direction));
|
||
|
|
||
|
if ((hspi->Init.Direction == SPI_DIRECTION_2LINES) && (hspi->Init.Mode == SPI_MODE_MASTER))
|
||
|
{
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_RX;
|
||
|
/* Call transmit-receive function to send Dummy data on Tx line and generate clock on CLK line */
|
||
|
return HAL_SPI_TransmitReceive_DMA(hspi, pData, pData, Size);
|
||
|
}
|
||
|
|
||
|
/* Process Locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_READY)
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_RX;
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pRxBuffPtr = (uint8_t *)pData;
|
||
|
hspi->RxXferSize = Size;
|
||
|
hspi->RxXferCount = Size;
|
||
|
|
||
|
/*Init field not used in handle to zero */
|
||
|
hspi->RxISR = NULL;
|
||
|
hspi->TxISR = NULL;
|
||
|
hspi->TxXferSize = 0U;
|
||
|
hspi->TxXferCount = 0U;
|
||
|
|
||
|
/* Configure communication direction : 1Line */
|
||
|
if (hspi->Init.Direction == SPI_DIRECTION_1LINE)
|
||
|
{
|
||
|
SPI_1LINE_RX(hspi);
|
||
|
}
|
||
|
|
||
|
/* Packing mode management is enabled by the DMA settings */
|
||
|
if (((hspi->Init.DataSize > SPI_DATASIZE_16BIT) && (hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_WORD)) || \
|
||
|
((hspi->Init.DataSize > SPI_DATASIZE_8BIT) && ((hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_HALFWORD) && \
|
||
|
(hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_WORD))))
|
||
|
{
|
||
|
/* Restriction the DMA data received is not allowed in this mode */
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Clear RXDMAEN bit */
|
||
|
CLEAR_BIT(hspi->Instance->CFG1, SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Adjust XferCount according to DMA alignement / Data size */
|
||
|
if (hspi->Init.DataSize <= SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
if (hspi->hdmarx->Init.MemDataAlignment == DMA_MDATAALIGN_HALFWORD)
|
||
|
{
|
||
|
hspi->RxXferCount = (hspi->RxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
if (hspi->hdmarx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->RxXferCount = (hspi->RxXferCount + 3U) >> 2U;
|
||
|
}
|
||
|
}
|
||
|
else if (hspi->Init.DataSize <= SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
if (hspi->hdmarx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->RxXferCount = (hspi->RxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Set the SPI RxDMA Half transfer complete callback */
|
||
|
hspi->hdmarx->XferHalfCpltCallback = SPI_DMAHalfReceiveCplt;
|
||
|
|
||
|
/* Set the SPI Rx DMA transfer complete callback */
|
||
|
hspi->hdmarx->XferCpltCallback = SPI_DMAReceiveCplt;
|
||
|
|
||
|
/* Set the DMA error callback */
|
||
|
hspi->hdmarx->XferErrorCallback = SPI_DMAError;
|
||
|
|
||
|
/* Set the DMA AbortCpltCallback */
|
||
|
hspi->hdmarx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Enable the Rx DMA Stream/Channel */
|
||
|
HAL_DMA_Start_IT(hspi->hdmarx, (uint32_t)&hspi->Instance->RXDR, (uint32_t)hspi->pRxBuffPtr, hspi->RxXferCount);
|
||
|
|
||
|
/* Set the number if data at current transfer */
|
||
|
if (hspi->hdmarx->Init.Mode == DMA_CIRCULAR)
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, 0);
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
}
|
||
|
|
||
|
/* Enable Rx DMA Request */
|
||
|
SET_BIT(hspi->Instance->CFG1, SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Enable the SPI Error Interrupt Bit */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, (SPI_IT_OVR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Transmit and Receive an amount of data in non-blocking mode with DMA.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param pTxData: pointer to transmission data buffer
|
||
|
* @param pRxData: pointer to reception data buffer
|
||
|
* @note When the CRC feature is enabled the pRxData Length must be Size + 1
|
||
|
* @param Size: amount of data to be sent
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData,
|
||
|
uint16_t Size)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode = HAL_OK;
|
||
|
|
||
|
/* Check Direction parameter */
|
||
|
assert_param(IS_SPI_DIRECTION_2LINES(hspi->Init.Direction));
|
||
|
|
||
|
/* Process locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
if (!((hspi->State == HAL_SPI_STATE_READY) ||
|
||
|
((hspi->Init.Mode == SPI_MODE_MASTER) && (hspi->Init.Direction == SPI_DIRECTION_2LINES) && (hspi->State == HAL_SPI_STATE_BUSY_RX))))
|
||
|
{
|
||
|
errorcode = HAL_BUSY;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
if ((pTxData == NULL) || (pRxData == NULL) || (Size == 0U))
|
||
|
{
|
||
|
errorcode = HAL_ERROR;
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Don't overwrite in case of HAL_SPI_STATE_BUSY_RX */
|
||
|
if (hspi->State != HAL_SPI_STATE_BUSY_RX)
|
||
|
{
|
||
|
hspi->State = HAL_SPI_STATE_BUSY_TX_RX;
|
||
|
}
|
||
|
|
||
|
/* Set the transaction information */
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
hspi->pTxBuffPtr = (uint8_t *)pTxData;
|
||
|
hspi->TxXferSize = Size;
|
||
|
hspi->TxXferCount = Size;
|
||
|
hspi->pRxBuffPtr = (uint8_t *)pRxData;
|
||
|
hspi->RxXferSize = Size;
|
||
|
hspi->RxXferCount = Size;
|
||
|
|
||
|
/* Init field not used in handle to zero */
|
||
|
hspi->RxISR = NULL;
|
||
|
hspi->TxISR = NULL;
|
||
|
|
||
|
/* Reset the Tx/Rx DMA bits */
|
||
|
CLEAR_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN | SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Packing mode management is enabled by the DMA settings */
|
||
|
if (((hspi->Init.DataSize > SPI_DATASIZE_16BIT) && (hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_WORD)) || \
|
||
|
((hspi->Init.DataSize > SPI_DATASIZE_8BIT) && ((hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_HALFWORD) && \
|
||
|
(hspi->hdmarx->Init.MemDataAlignment != DMA_MDATAALIGN_WORD))))
|
||
|
{
|
||
|
/* Restriction the DMA data received is not allowed in this mode */
|
||
|
errorcode = HAL_ERROR;
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/* Adjust XferCount according to DMA alignement / Data size */
|
||
|
if (hspi->Init.DataSize <= SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
if (hspi->hdmatx->Init.MemDataAlignment == DMA_MDATAALIGN_HALFWORD)
|
||
|
{
|
||
|
hspi->TxXferCount = (hspi->TxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
if (hspi->hdmatx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->TxXferCount = (hspi->TxXferCount + 3U) >> 2U;
|
||
|
}
|
||
|
if (hspi->hdmarx->Init.MemDataAlignment == DMA_MDATAALIGN_HALFWORD)
|
||
|
{
|
||
|
hspi->RxXferCount = (hspi->RxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
if (hspi->hdmarx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->RxXferCount = (hspi->RxXferCount + 3U) >> 2U;
|
||
|
}
|
||
|
}
|
||
|
else if (hspi->Init.DataSize <= SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
if (hspi->hdmatx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->TxXferCount = (hspi->TxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
if (hspi->hdmarx->Init.MemDataAlignment == DMA_MDATAALIGN_WORD)
|
||
|
{
|
||
|
hspi->RxXferCount = (hspi->RxXferCount + 1U) >> 1U;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Check if we are in Rx only or in Rx/Tx Mode and configure the DMA transfer complete callback */
|
||
|
if (hspi->State == HAL_SPI_STATE_BUSY_RX)
|
||
|
{
|
||
|
/* Set the SPI Rx DMA Half transfer complete callback */
|
||
|
hspi->hdmarx->XferHalfCpltCallback = SPI_DMAHalfReceiveCplt;
|
||
|
hspi->hdmarx->XferCpltCallback = SPI_DMAReceiveCplt;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Set the SPI Tx/Rx DMA Half transfer complete callback */
|
||
|
hspi->hdmarx->XferHalfCpltCallback = SPI_DMAHalfTransmitReceiveCplt;
|
||
|
hspi->hdmarx->XferCpltCallback = SPI_DMATransmitReceiveCplt;
|
||
|
}
|
||
|
|
||
|
/* Set the DMA error callback */
|
||
|
hspi->hdmarx->XferErrorCallback = SPI_DMAError;
|
||
|
|
||
|
/* Set the DMA AbortCallback */
|
||
|
hspi->hdmarx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Enable the Rx DMA Stream/Channel */
|
||
|
HAL_DMA_Start_IT(hspi->hdmarx, (uint32_t)&hspi->Instance->RXDR, (uint32_t)hspi->pRxBuffPtr, hspi->RxXferCount);
|
||
|
|
||
|
/* Enable Rx DMA Request */
|
||
|
SET_BIT(hspi->Instance->CFG1, SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Set the SPI Tx DMA transfer complete callback as NULL because the communication closing
|
||
|
is performed in DMA reception complete callback */
|
||
|
hspi->hdmatx->XferHalfCpltCallback = NULL;
|
||
|
hspi->hdmatx->XferCpltCallback = NULL;
|
||
|
hspi->hdmatx->XferErrorCallback = NULL;
|
||
|
hspi->hdmatx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Enable the Tx DMA Stream/Channel */
|
||
|
HAL_DMA_Start_IT(hspi->hdmatx, (uint32_t)hspi->pTxBuffPtr, (uint32_t)&hspi->Instance->TXDR, hspi->TxXferCount);
|
||
|
|
||
|
if (hspi->hdmatx->Init.Mode == DMA_CIRCULAR)
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, 0);
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
MODIFY_REG(hspi->Instance->CR2, SPI_CR2_TSIZE, Size);
|
||
|
}
|
||
|
|
||
|
/* Enable Tx DMA Request */
|
||
|
SET_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN);
|
||
|
|
||
|
/* Enable the SPI Error Interrupt Bit */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, (SPI_IT_OVR | SPI_IT_UDR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
/* Enable SPI peripheral */
|
||
|
__HAL_SPI_ENABLE(hspi);
|
||
|
|
||
|
if (hspi->Init.Mode == SPI_MODE_MASTER)
|
||
|
{
|
||
|
/* Master transfer start */
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSTART);
|
||
|
}
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Abort ongoing transfer (blocking mode).
|
||
|
* @param hspi SPI handle.
|
||
|
* @note This procedure could be used for aborting any ongoing transfer (Tx and Rx),
|
||
|
* started in Interrupt or DMA mode.
|
||
|
* @note This procedure performs following operations :
|
||
|
* + Disable SPI Interrupts (depending of transfer direction)
|
||
|
* + Disable the DMA transfer in the peripheral register (if enabled)
|
||
|
* + Abort DMA transfer by calling HAL_DMA_Abort (in case of transfer in DMA mode)
|
||
|
* + Set handle State to READY.
|
||
|
* @note This procedure is executed in blocking mode : when exiting function, Abort is considered as completed.
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Abort(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode;
|
||
|
__IO uint32_t count;
|
||
|
|
||
|
/* Process locked */
|
||
|
__HAL_LOCK(hspi);
|
||
|
|
||
|
/* Set hspi->state to aborting to avoid any interaction */
|
||
|
hspi->State = HAL_SPI_STATE_ABORT;
|
||
|
|
||
|
/* Initialized local variable */
|
||
|
errorcode = HAL_OK;
|
||
|
count = SPI_DEFAULT_TIMEOUT * (SystemCoreClock / 24U / 1000U);
|
||
|
|
||
|
/* If master communication on going, make sure current frame is done before closing the connection */
|
||
|
if (HAL_IS_BIT_SET(hspi->Instance->CR1, SPI_CR1_CSTART))
|
||
|
{
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSUSP);
|
||
|
do
|
||
|
{
|
||
|
if (count-- == 0U)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_ABORT);
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
while (HAL_IS_BIT_SET(hspi->Instance->CR1, SPI_CR1_CSTART));
|
||
|
}
|
||
|
|
||
|
/* Disable the SPI DMA Tx request if enabled */
|
||
|
if (HAL_IS_BIT_SET(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN))
|
||
|
{
|
||
|
if (hspi->hdmatx != NULL)
|
||
|
{
|
||
|
/* Abort the SPI DMA Tx Stream/Channel : use blocking DMA Abort API (no callback) */
|
||
|
hspi->hdmatx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Abort DMA Tx Handle linked to SPI Peripheral */
|
||
|
if (HAL_DMA_Abort(hspi->hdmatx) != HAL_OK)
|
||
|
{
|
||
|
if (HAL_DMA_GetError(hspi->hdmatx) == HAL_DMA_ERROR_TIMEOUT)
|
||
|
{
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_ABORT;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Disable the SPI DMA Rx request if enabled */
|
||
|
if (HAL_IS_BIT_SET(hspi->Instance->CFG1, SPI_CFG1_RXDMAEN))
|
||
|
{
|
||
|
if (hspi->hdmarx != NULL)
|
||
|
{
|
||
|
/* Abort the SPI DMA Rx Stream/Channel : use blocking DMA Abort API (no callback) */
|
||
|
hspi->hdmarx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Abort DMA Rx Handle linked to SPI Peripheral */
|
||
|
if (HAL_DMA_Abort(hspi->hdmarx) != HAL_OK)
|
||
|
{
|
||
|
if (HAL_DMA_GetError(hspi->hdmarx) == HAL_DMA_ERROR_TIMEOUT)
|
||
|
{
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_ABORT;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Proceed with abort procedure */
|
||
|
SPI_AbortTransfer(hspi);
|
||
|
|
||
|
/* Check error during Abort procedure */
|
||
|
if (hspi->ErrorCode == HAL_SPI_ERROR_ABORT)
|
||
|
{
|
||
|
/* return HAL_Error in case of error during Abort procedure */
|
||
|
errorcode = HAL_ERROR;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Reset errorCode */
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
}
|
||
|
|
||
|
/* Process Unlocked */
|
||
|
__HAL_UNLOCK(hspi);
|
||
|
|
||
|
/* Restore hspi->state to ready */
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Abort ongoing transfer (Interrupt mode).
|
||
|
* @param hspi SPI handle.
|
||
|
* @note This procedure could be used for aborting any ongoing transfer (Tx and Rx),
|
||
|
* started in Interrupt or DMA mode.
|
||
|
* @note This procedure performs following operations :
|
||
|
* + Disable SPI Interrupts (depending of transfer direction)
|
||
|
* + Disable the DMA transfer in the peripheral register (if enabled)
|
||
|
* + Abort DMA transfer by calling HAL_DMA_Abort_IT (in case of transfer in DMA mode)
|
||
|
* + Set handle State to READY
|
||
|
* + At abort completion, call user abort complete callback.
|
||
|
* @note This procedure is executed in Interrupt mode, meaning that abort procedure could be
|
||
|
* considered as completed only when user abort complete callback is executed (not when exiting function).
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_Abort_IT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
HAL_StatusTypeDef errorcode;
|
||
|
__IO uint32_t count;
|
||
|
uint32_t dma_tx_abort_done = 1, dma_rx_abort_done = 1;
|
||
|
|
||
|
/* Set hspi->state to aborting to avoid any interaction */
|
||
|
hspi->State = HAL_SPI_STATE_ABORT;
|
||
|
|
||
|
/* Initialized local variable */
|
||
|
errorcode = HAL_OK;
|
||
|
count = SPI_DEFAULT_TIMEOUT * (SystemCoreClock / 24U / 1000U);
|
||
|
|
||
|
/* If master communication on going, make sure current frame is done before closing the connection */
|
||
|
if (HAL_IS_BIT_SET(hspi->Instance->CR1, SPI_CR1_CSTART))
|
||
|
{
|
||
|
SET_BIT(hspi->Instance->CR1, SPI_CR1_CSUSP);
|
||
|
do
|
||
|
{
|
||
|
if (count-- == 0U)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_ABORT);
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
while (HAL_IS_BIT_SET(hspi->Instance->CR1, SPI_CR1_CSTART));
|
||
|
}
|
||
|
|
||
|
/* Reset Callbacks */
|
||
|
hspi->hdmarx->XferAbortCallback = NULL;
|
||
|
hspi->hdmatx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* If DMA Tx and/or DMA Rx Handles are associated to SPI Handle, DMA Abort complete callbacks should be initialised
|
||
|
before any call to DMA Abort functions */
|
||
|
|
||
|
if ((hspi->hdmatx != NULL) && HAL_IS_BIT_SET(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN))
|
||
|
{
|
||
|
/* Set DMA Abort Complete callback if UART DMA Tx request if enabled */
|
||
|
hspi->hdmatx->XferAbortCallback = SPI_DMATxAbortCallback;
|
||
|
}
|
||
|
|
||
|
if ((hspi->hdmarx != NULL) && HAL_IS_BIT_SET(hspi->Instance->CFG1, SPI_CFG1_RXDMAEN))
|
||
|
{
|
||
|
/* Set DMA Abort Complete callback if UART DMA Rx request if enabled */
|
||
|
hspi->hdmarx->XferAbortCallback = SPI_DMARxAbortCallback;
|
||
|
}
|
||
|
|
||
|
/* Disable the SPI DMA Tx request if enabled */
|
||
|
if ((hspi->hdmatx != NULL) && HAL_IS_BIT_SET(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN))
|
||
|
{
|
||
|
dma_tx_abort_done = 0;
|
||
|
|
||
|
/* Abort DMA Tx Handle linked to SPI Peripheral */
|
||
|
if (HAL_DMA_Abort_IT(hspi->hdmatx) != HAL_OK)
|
||
|
{
|
||
|
if (HAL_DMA_GetError(hspi->hdmatx) == HAL_DMA_ERROR_NO_XFER)
|
||
|
{
|
||
|
dma_tx_abort_done = 1;
|
||
|
hspi->hdmatx->XferAbortCallback = NULL;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Disable the SPI DMA Rx request if enabled */
|
||
|
if ((hspi->hdmarx != NULL) && HAL_IS_BIT_SET(hspi->Instance->CFG1, SPI_CFG1_RXDMAEN))
|
||
|
{
|
||
|
dma_rx_abort_done = 0;
|
||
|
|
||
|
/* Abort DMA Rx Handle linked to SPI Peripheral */
|
||
|
if (HAL_DMA_Abort_IT(hspi->hdmarx) != HAL_OK)
|
||
|
{
|
||
|
if (HAL_DMA_GetError(hspi->hdmarx) == HAL_DMA_ERROR_NO_XFER)
|
||
|
{
|
||
|
dma_rx_abort_done = 1;
|
||
|
hspi->hdmarx->XferAbortCallback = NULL;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* If no running DMA transfer, finish cleanup and call callbacks */
|
||
|
if ((dma_tx_abort_done == 1) && (dma_rx_abort_done == 1))
|
||
|
{
|
||
|
/* Proceed with abort procedure */
|
||
|
SPI_AbortTransfer(hspi);
|
||
|
|
||
|
/* Check error during Abort procedure */
|
||
|
if (hspi->ErrorCode == HAL_SPI_ERROR_ABORT)
|
||
|
{
|
||
|
/* return HAL_Error in case of error during Abort procedure */
|
||
|
errorcode = HAL_ERROR;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Reset errorCode */
|
||
|
hspi->ErrorCode = HAL_SPI_ERROR_NONE;
|
||
|
}
|
||
|
|
||
|
/* Restore hspi->state to ready */
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
/* Call user Abort complete callback */
|
||
|
HAL_SPI_AbortCpltCallback(hspi);
|
||
|
}
|
||
|
|
||
|
return errorcode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Pause the DMA Transfer.
|
||
|
* This API is supported, it is maintained for backward compatibility.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified SPI module.
|
||
|
* @retval HAL_ERROR
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_DMAPause(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Set error code to not supported */
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_NOT_SUPPORTED);
|
||
|
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Resume the DMA Transfer.
|
||
|
* This API is supported, it is maintained for backward compatibility.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified SPI module.
|
||
|
* @retval HAL_ERROR
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_DMAResume(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Set error code to not supported */
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_NOT_SUPPORTED);
|
||
|
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Stop the DMA Transfer.
|
||
|
* This API is supported, it is maintained for backward compatibility.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified SPI module.
|
||
|
* @retval HAL_ERROR
|
||
|
*/
|
||
|
HAL_StatusTypeDef HAL_SPI_DMAStop(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Set error code to not supported */
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_NOT_SUPPORTED);
|
||
|
|
||
|
return HAL_ERROR;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Handle SPI interrupt request.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
void HAL_SPI_IRQHandler(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
uint32_t itsource = hspi->Instance->IER;
|
||
|
uint32_t itflag = hspi->Instance->SR;
|
||
|
uint32_t trigger = itsource & itflag;
|
||
|
uint32_t cfg1 = hspi->Instance->CFG1;
|
||
|
uint32_t handled = 0;
|
||
|
|
||
|
HAL_SPI_StateTypeDef State = hspi->State;
|
||
|
|
||
|
/* SPI in mode Receiver ----------------------------------------------------*/
|
||
|
if (HAL_IS_BIT_CLR(trigger, SPI_FLAG_OVR) && HAL_IS_BIT_SET(trigger, SPI_FLAG_RXNE))
|
||
|
{
|
||
|
hspi->RxISR(hspi);
|
||
|
handled = 1;
|
||
|
}
|
||
|
|
||
|
/* SPI in mode Transmitter -------------------------------------------------*/
|
||
|
if (HAL_IS_BIT_CLR(trigger, SPI_FLAG_UDR) && HAL_IS_BIT_SET(trigger, SPI_FLAG_TXE))
|
||
|
{
|
||
|
hspi->TxISR(hspi);
|
||
|
handled = 1;
|
||
|
}
|
||
|
|
||
|
if (handled != 0)
|
||
|
return;
|
||
|
|
||
|
/* SPI End Of Transfer: DMA or IT based transfer */
|
||
|
if (HAL_IS_BIT_SET(trigger, SPI_FLAG_EOT))
|
||
|
{
|
||
|
/* Clear EOT/TXTF/SUSP flag */
|
||
|
__HAL_SPI_CLEAR_EOTFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_TXTFFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_SUSPFLAG(hspi);
|
||
|
|
||
|
/* Disable EOT interrupt */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_EOT);
|
||
|
|
||
|
/* DMA Normal Mode */
|
||
|
if( HAL_IS_BIT_CLR(cfg1, SPI_CFG1_TXDMAEN|SPI_CFG1_RXDMAEN) || // IT based transfer is done
|
||
|
((State != HAL_SPI_STATE_BUSY_RX) && (hspi->hdmatx->Init.Mode == DMA_NORMAL)) || // DMA is used in normal mode
|
||
|
((State != HAL_SPI_STATE_BUSY_TX) && (hspi->hdmarx->Init.Mode == DMA_NORMAL)) ) // DMA is used in normal mode
|
||
|
{
|
||
|
/* For the IT based receive extra polling maybe required for last packet */
|
||
|
if (HAL_IS_BIT_CLR(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN|SPI_CFG1_RXDMAEN))
|
||
|
{
|
||
|
/* Pooling remaining data */
|
||
|
while (hspi->RxXferCount != 0)
|
||
|
{
|
||
|
/* Receive data in 32 Bit mode */
|
||
|
if (hspi->Init.DataSize > SPI_DATASIZE_16BIT)
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
}
|
||
|
/* Receive data in 16 Bit mode */
|
||
|
else if (hspi->Init.DataSize > SPI_DATASIZE_8BIT)
|
||
|
{
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = *((__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
}
|
||
|
/* Receive data in 8 Bit mode */
|
||
|
else
|
||
|
{
|
||
|
*((uint8_t *)hspi->pRxBuffPtr) = *((__IO uint8_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint8_t);
|
||
|
}
|
||
|
hspi->RxXferCount--;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Call SPI Standard close procedure */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
if (hspi->ErrorCode != HAL_SPI_ERROR_NONE)
|
||
|
{
|
||
|
HAL_SPI_ErrorCallback(hspi);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Call appropriate user callback */
|
||
|
if (State == HAL_SPI_STATE_BUSY_TX_RX)
|
||
|
{
|
||
|
HAL_SPI_TxRxCpltCallback(hspi);
|
||
|
}
|
||
|
else if (State == HAL_SPI_STATE_BUSY_RX)
|
||
|
{
|
||
|
HAL_SPI_RxCpltCallback(hspi);
|
||
|
}
|
||
|
else if (State == HAL_SPI_STATE_BUSY_TX)
|
||
|
{
|
||
|
HAL_SPI_TxCpltCallback(hspi);
|
||
|
}
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (HAL_IS_BIT_SET(itsource, SPI_FLAG_EOT) && HAL_IS_BIT_SET(itflag, SPI_FLAG_SUSP ))
|
||
|
{
|
||
|
/* Abort on going, clear SUSP flag to avoid infinit looping */
|
||
|
__HAL_SPI_CLEAR_SUSPFLAG(hspi);
|
||
|
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
/* SPI in Error Treatment --------------------------------------------------*/
|
||
|
if ((trigger & (SPI_FLAG_MODF | SPI_FLAG_OVR | SPI_FLAG_FRE | SPI_FLAG_UDR)) != RESET)
|
||
|
{
|
||
|
/* SPI Overrun error interrupt occurred ----------------------------------*/
|
||
|
if ((trigger & SPI_FLAG_OVR) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_OVR);
|
||
|
__HAL_SPI_CLEAR_OVRFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
/* SPI Mode Fault error interrupt occurred -------------------------------*/
|
||
|
if ((trigger & SPI_FLAG_MODF) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_MODF);
|
||
|
__HAL_SPI_CLEAR_MODFFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
/* SPI Frame error interrupt occurred ------------------------------------*/
|
||
|
if ((trigger & SPI_FLAG_FRE) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_FRE);
|
||
|
__HAL_SPI_CLEAR_FREFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
/* SPI Underrun error interrupt occurred ------------------------------------*/
|
||
|
if ((trigger & SPI_FLAG_UDR) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_UDR);
|
||
|
__HAL_SPI_CLEAR_UDRFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
if (hspi->ErrorCode != HAL_SPI_ERROR_NONE)
|
||
|
{
|
||
|
/* Disable SPI peripheral */
|
||
|
__HAL_SPI_DISABLE(hspi);
|
||
|
|
||
|
/* Disable all interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_EOT | SPI_IT_RXNE | SPI_IT_TXE | SPI_IT_MODF | SPI_IT_OVR | SPI_IT_FRE | SPI_IT_UDR);
|
||
|
|
||
|
/* Disable the SPI DMA requests if enabled */
|
||
|
if (HAL_IS_BIT_SET(cfg1, SPI_CFG1_TXDMAEN|SPI_CFG1_RXDMAEN))
|
||
|
{
|
||
|
/* Disable the SPI DMA requests */
|
||
|
CLEAR_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN | SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Abort the SPI DMA Rx channel */
|
||
|
if (hspi->hdmarx != NULL)
|
||
|
{
|
||
|
/* Set the SPI DMA Abort callback :
|
||
|
will lead to call HAL_SPI_ErrorCallback() at end of DMA abort procedure */
|
||
|
hspi->hdmarx->XferAbortCallback = SPI_DMAAbortOnError;
|
||
|
HAL_DMA_Abort_IT(hspi->hdmarx);
|
||
|
}
|
||
|
/* Abort the SPI DMA Tx channel */
|
||
|
if (hspi->hdmatx != NULL)
|
||
|
{
|
||
|
/* Set the SPI DMA Abort callback :
|
||
|
will lead to call HAL_SPI_ErrorCallback() at end of DMA abort procedure */
|
||
|
hspi->hdmatx->XferAbortCallback = SPI_DMAAbortOnError;
|
||
|
HAL_DMA_Abort_IT(hspi->hdmatx);
|
||
|
}
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Restore hspi->State to Ready */
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
/* Call user error callback */
|
||
|
HAL_SPI_ErrorCallback(hspi);
|
||
|
}
|
||
|
}
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Tx Transfer completed callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_TxCpltCallback should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Rx Transfer completed callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_RxCpltCallback should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Tx and Rx Transfer completed callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_TxRxCpltCallback should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Tx Half Transfer completed callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_TxHalfCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_TxHalfCpltCallback should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Rx Half Transfer completed callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_RxHalfCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_RxHalfCpltCallback() should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Tx and Rx Half Transfer callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_TxRxHalfCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_TxRxHalfCpltCallback() should be implemented in the user file
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief SPI error callback.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_ErrorCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_ErrorCallback should be implemented in the user file
|
||
|
*/
|
||
|
/* NOTE : The ErrorCode parameter in the hspi handle is updated by the SPI processes
|
||
|
and user can use HAL_SPI_GetError() API to check the latest error occurred
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief SPI Abort Complete callback.
|
||
|
* @param hspi SPI handle.
|
||
|
* @retval None
|
||
|
*/
|
||
|
__weak void HAL_SPI_AbortCpltCallback(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Prevent unused argument(s) compilation warning */
|
||
|
UNUSED(hspi);
|
||
|
|
||
|
/* NOTE : This function should not be modified, when the callback is needed,
|
||
|
the HAL_SPI_AbortCpltCallback can be implemented in the user file.
|
||
|
*/
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/** @defgroup SPI_Exported_Functions_Group3 Peripheral State and Errors functions
|
||
|
* @brief SPI control functions
|
||
|
*
|
||
|
@verbatim
|
||
|
===============================================================================
|
||
|
##### Peripheral State and Errors functions #####
|
||
|
===============================================================================
|
||
|
[..]
|
||
|
This subsection provides a set of functions allowing to control the SPI.
|
||
|
(+) HAL_SPI_GetState() API can be helpful to check in run-time the state of the SPI peripheral
|
||
|
(+) HAL_SPI_GetError() check in run-time Errors occurring during communication
|
||
|
@endverbatim
|
||
|
* @{
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @brief Return the SPI handle state.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval SPI state
|
||
|
*/
|
||
|
HAL_SPI_StateTypeDef HAL_SPI_GetState(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Return SPI handle state */
|
||
|
return hspi->State;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Return the SPI error code.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval SPI error code in bitmap format
|
||
|
*/
|
||
|
uint32_t HAL_SPI_GetError(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Return SPI ErrorCode */
|
||
|
return hspi->ErrorCode;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/** @addtogroup SPI_Private_Functions
|
||
|
* @brief Private functions
|
||
|
* @{
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI transmit process complete callback.
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMATransmitCplt(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_ABORT)
|
||
|
{
|
||
|
if (hspi->hdmatx->Init.Mode == DMA_CIRCULAR)
|
||
|
{
|
||
|
HAL_SPI_TxCpltCallback(hspi);
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Enable EOT interrupt */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, SPI_IT_EOT);
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI receive process complete callback.
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMAReceiveCplt(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_ABORT)
|
||
|
{
|
||
|
if (hspi->hdmarx->Init.Mode == DMA_CIRCULAR)
|
||
|
{
|
||
|
HAL_SPI_RxCpltCallback(hspi);
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Enable EOT interrupt */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, SPI_IT_EOT);
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI transmit receive process complete callback.
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMATransmitReceiveCplt(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
if (hspi->State != HAL_SPI_STATE_ABORT)
|
||
|
{
|
||
|
if (hspi->hdmatx->Init.Mode == DMA_CIRCULAR)
|
||
|
{
|
||
|
HAL_SPI_TxRxCpltCallback(hspi);
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
/* Enable EOT interrupt */
|
||
|
__HAL_SPI_ENABLE_IT(hspi, SPI_IT_EOT);
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI half transmit process complete callback.
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMAHalfTransmitCplt(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
HAL_SPI_TxHalfCpltCallback(hspi);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI half receive process complete callback
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMAHalfReceiveCplt(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
HAL_SPI_RxHalfCpltCallback(hspi);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI half transmit receive process complete callback.
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMAHalfTransmitReceiveCplt(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
HAL_SPI_TxRxHalfCpltCallback(hspi);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI communication error callback.
|
||
|
* @param hdma: pointer to a DMA_HandleTypeDef structure that contains
|
||
|
* the configuration information for the specified DMA module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMAError(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
/* if DMA error is FIFO error ignore it */
|
||
|
if(HAL_DMA_GetError(hdma) != HAL_DMA_ERROR_FE)
|
||
|
{
|
||
|
/* Call SPI standard close procedure */
|
||
|
SPI_CloseTransfer(hspi);
|
||
|
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_DMA);
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
HAL_SPI_ErrorCallback(hspi);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI communication abort callback, when initiated by HAL services on Error
|
||
|
* (To be called at end of DMA Abort procedure following error occurrence).
|
||
|
* @param hdma DMA handle.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMAAbortOnError(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
hspi->RxXferCount = 0U;
|
||
|
hspi->TxXferCount = 0U;
|
||
|
|
||
|
/* Restore hspi->State to Ready */
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
HAL_SPI_ErrorCallback(hspi);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI Tx communication abort callback, when initiated by user
|
||
|
* (To be called at end of DMA Tx Abort procedure following user abort request).
|
||
|
* @note When this callback is executed, User Abort complete call back is called only if no
|
||
|
* Abort still ongoing for Rx DMA Handle.
|
||
|
* @param hdma DMA handle.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMATxAbortCallback(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
hspi->hdmatx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Check if an Abort process is still ongoing */
|
||
|
if (hspi->hdmarx != NULL)
|
||
|
{
|
||
|
if (hspi->hdmarx->XferAbortCallback != NULL)
|
||
|
{
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Call the Abort procedure */
|
||
|
SPI_AbortTransfer(hspi);
|
||
|
|
||
|
/* Restore hspi->State to Ready */
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
/* Call user Abort complete callback */
|
||
|
HAL_SPI_AbortCpltCallback(hspi);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief DMA SPI Rx communication abort callback, when initiated by user
|
||
|
* (To be called at end of DMA Rx Abort procedure following user abort request).
|
||
|
* @note When this callback is executed, User Abort complete call back is called only if no
|
||
|
* Abort still ongoing for Tx DMA Handle.
|
||
|
* @param hdma DMA handle.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_DMARxAbortCallback(DMA_HandleTypeDef *hdma)
|
||
|
{
|
||
|
SPI_HandleTypeDef *hspi = (SPI_HandleTypeDef *)((DMA_HandleTypeDef *)hdma)->Parent;
|
||
|
|
||
|
hspi->hdmarx->XferAbortCallback = NULL;
|
||
|
|
||
|
/* Check if an Abort process is still ongoing */
|
||
|
if (hspi->hdmatx != NULL)
|
||
|
{
|
||
|
if (hspi->hdmatx->XferAbortCallback != NULL)
|
||
|
{
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Call the Abort procedure */
|
||
|
SPI_AbortTransfer(hspi);
|
||
|
|
||
|
/* Restore hspi->State to Ready */
|
||
|
hspi->State = HAL_SPI_STATE_READY;
|
||
|
|
||
|
/* Call user Abort complete callback */
|
||
|
HAL_SPI_AbortCpltCallback(hspi);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Rx 8-bit handler for Transmit and Receive in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_2linesRxISR_8BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Receive data in 8 Bit mode */
|
||
|
*((uint8_t *)hspi->pRxBuffPtr) = *((__IO uint8_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->RxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->RxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable RXNE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_RXNE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Rx 16-bit handler for Transmit and Receive in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_2linesRxISR_16BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Receive data in 16 Bit mode */
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = *((__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->RxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->RxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable RXNE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_RXNE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Rx 32-bit handler for Transmit and Receive in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_2linesRxISR_32BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Receive data in 32 Bit mode */
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = *((__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->RxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable RXNE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_RXNE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Tx 8-bit handler for Transmit and Receive in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_2linesTxISR_8BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Transmit data in 8 Bit mode */
|
||
|
*(__IO uint8_t *)&hspi->Instance->TXDR = *((uint8_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->TxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->TxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable TXE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_TXE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Tx 16-bit handler for Transmit and Receive in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_2linesTxISR_16BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Transmit data in 16 Bit mode */
|
||
|
*((__IO uint16_t *)&hspi->Instance->TXDR) = *((uint16_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->TxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->TxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable TXE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_TXE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Tx 32-bit handler for Transmit and Receive in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_2linesTxISR_32BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Transmit data in 32 Bit mode */
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->TxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable TXE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_TXE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Manage the receive 8-bit in Interrupt context.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_RxISR_8BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
*((uint8_t *)hspi->pRxBuffPtr) = (*(__IO uint8_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->RxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->RxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable RXNE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_RXNE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Manage the 16-bit receive in Interrupt context.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_RxISR_16BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
*((uint16_t *)hspi->pRxBuffPtr) = (*(__IO uint16_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->RxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->RxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable RXNE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_RXNE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Manage the 32-bit receive in Interrupt context.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_RxISR_32BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
*((uint32_t *)hspi->pRxBuffPtr) = (*(__IO uint32_t *)&hspi->Instance->RXDR);
|
||
|
hspi->pRxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->RxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->RxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable RXNE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_RXNE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Handle the data 8-bit transmit in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_TxISR_8BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
*(__IO uint8_t *)&hspi->Instance->TXDR = *((uint8_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint8_t);
|
||
|
hspi->TxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->TxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable TXE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_TXE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Handle the data 16-bit transmit in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_TxISR_16BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Transmit data in 16 Bit mode */
|
||
|
*((__IO uint16_t *)&hspi->Instance->TXDR) = *((uint16_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint16_t);
|
||
|
hspi->TxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->TxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable TXE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_TXE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Handle the data 32-bit transmit in Interrupt mode.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_TxISR_32BIT(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Transmit data in 16 Bit mode */
|
||
|
*((__IO uint32_t *)&hspi->Instance->TXDR) = *((uint32_t *)hspi->pTxBuffPtr);
|
||
|
hspi->pTxBuffPtr += sizeof(uint32_t);
|
||
|
hspi->TxXferCount--;
|
||
|
|
||
|
/* Disable IT if no more data excepted */
|
||
|
if (hspi->TxXferCount == 0U)
|
||
|
{
|
||
|
/* Disable TXE interrupts */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, SPI_IT_TXE);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Abort Transfer and clear flags.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval None
|
||
|
*/
|
||
|
static void SPI_AbortTransfer(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
/* Disable SPI peripheral */
|
||
|
__HAL_SPI_DISABLE(hspi);
|
||
|
|
||
|
/* Disable ITs */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, (SPI_IT_EOT | SPI_IT_TXE | SPI_IT_RXNE | SPI_IT_UDR | SPI_IT_OVR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
/* Clear the Status flags in the SR register */
|
||
|
__HAL_SPI_CLEAR_EOTFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_TXTFFLAG(hspi);
|
||
|
|
||
|
/* Disable Tx DMA Request */
|
||
|
CLEAR_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN|SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Clear the Error flags in the SR register */
|
||
|
__HAL_SPI_CLEAR_OVRFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_UDRFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_FREFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_MODFFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_SUSPFLAG(hspi);
|
||
|
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
__HAL_SPI_CLEAR_CRCERRFLAG(hspi);
|
||
|
#endif /* USE_SPI_CRC */
|
||
|
|
||
|
hspi->TxXferCount = 0U;
|
||
|
hspi->RxXferCount = 0U;
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @brief Close Transfer and clear flags.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval HAL_ERROR: if any error detected
|
||
|
* HAL_OK: if nothing detected
|
||
|
*/
|
||
|
static void SPI_CloseTransfer(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
uint32_t itflag = hspi->Instance->SR;
|
||
|
|
||
|
__HAL_SPI_CLEAR_EOTFLAG(hspi);
|
||
|
__HAL_SPI_CLEAR_TXTFFLAG(hspi);
|
||
|
|
||
|
/* Disable SPI peripheral */
|
||
|
__HAL_SPI_DISABLE(hspi);
|
||
|
|
||
|
/* Disable ITs */
|
||
|
__HAL_SPI_DISABLE_IT(hspi, (SPI_IT_EOT | SPI_IT_TXE | SPI_IT_RXNE | SPI_IT_UDR | SPI_IT_OVR | SPI_IT_FRE | SPI_IT_MODF));
|
||
|
|
||
|
/* Disable Tx DMA Request */
|
||
|
CLEAR_BIT(hspi->Instance->CFG1, SPI_CFG1_TXDMAEN|SPI_CFG1_RXDMAEN);
|
||
|
|
||
|
/* Report UnderRun error for non RX Only communication */
|
||
|
if (hspi->State != HAL_SPI_STATE_BUSY_RX)
|
||
|
{
|
||
|
if ((itflag & SPI_FLAG_UDR) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_UDR);
|
||
|
__HAL_SPI_CLEAR_UDRFLAG(hspi);
|
||
|
}
|
||
|
}
|
||
|
|
||
|
/* Report OverRun error for non TX Only communication */
|
||
|
if (hspi->State != HAL_SPI_STATE_BUSY_TX)
|
||
|
{
|
||
|
if ((itflag & SPI_FLAG_OVR) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_OVR);
|
||
|
__HAL_SPI_CLEAR_OVRFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
#if (USE_SPI_CRC != 0U)
|
||
|
/* Check if CRC error occurred */
|
||
|
if (hspi->Init.CRCCalculation == SPI_CRCCALCULATION_ENABLE)
|
||
|
{
|
||
|
if ((itflag & SPI_FLAG_CRCERR) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_CRC);
|
||
|
__HAL_SPI_CLEAR_CRCERRFLAG(hspi);
|
||
|
}
|
||
|
}
|
||
|
#endif /* USE_SPI_CRC */
|
||
|
}
|
||
|
|
||
|
/* SPI Mode Fault error interrupt occurred -------------------------------*/
|
||
|
if ((itflag & SPI_FLAG_MODF) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_MODF);
|
||
|
__HAL_SPI_CLEAR_MODFFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
/* SPI Frame error interrupt occurred ------------------------------------*/
|
||
|
if ((itflag & SPI_FLAG_FRE) != RESET)
|
||
|
{
|
||
|
SET_BIT(hspi->ErrorCode, HAL_SPI_ERROR_FRE);
|
||
|
__HAL_SPI_CLEAR_FREFLAG(hspi);
|
||
|
}
|
||
|
|
||
|
hspi->TxXferCount = 0U;
|
||
|
hspi->RxXferCount = 0U;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Handle SPI Communication Timeout.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @param Flag: SPI flag to check
|
||
|
* @param Status: flag state to check
|
||
|
* @param Timeout: Timeout duration
|
||
|
* @param Tickstart: Tick start value
|
||
|
* @retval HAL status
|
||
|
*/
|
||
|
static HAL_StatusTypeDef SPI_WaitOnFlagUntilTimeout(SPI_HandleTypeDef *hspi, uint32_t Flag, FlagStatus Status,
|
||
|
uint32_t Tickstart, uint32_t Timeout)
|
||
|
{
|
||
|
/* Wait until flag is set */
|
||
|
while((__HAL_SPI_GET_FLAG(hspi, Flag) ? SET : RESET) == Status)
|
||
|
{
|
||
|
/* Check for the Timeout */
|
||
|
if(Timeout != HAL_MAX_DELAY)
|
||
|
{
|
||
|
if((Timeout == 0U) || ((HAL_GetTick()-Tickstart) > Timeout))
|
||
|
{
|
||
|
return HAL_TIMEOUT;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
return HAL_OK;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @brief Compute configurated packet size from fifo prespective.
|
||
|
* @param hspi: pointer to a SPI_HandleTypeDef structure that contains
|
||
|
* the configuration information for SPI module.
|
||
|
* @retval Packet size occuppied in the fifo
|
||
|
*/
|
||
|
static uint32_t SPI_GetPacketSize(SPI_HandleTypeDef *hspi)
|
||
|
{
|
||
|
uint32_t fifo_threashold = (hspi->Init.FifoThreshold>>SPI_CFG1_FTHLV_Pos) + 1;
|
||
|
uint32_t data_size = (hspi->Init.DataSize >>SPI_CFG1_DSIZE_Pos) + 1;
|
||
|
|
||
|
/* Convert data size to Byte */
|
||
|
data_size = (data_size+7)/8;
|
||
|
|
||
|
return data_size * fifo_threashold;
|
||
|
}
|
||
|
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
#endif /* HAL_SPI_MODULE_ENABLED */
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/**
|
||
|
* @}
|
||
|
*/
|
||
|
|
||
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|