424 lines
17 KiB
C
424 lines
17 KiB
C
/**
|
|
******************************************************************************
|
|
* @file stm32h7xx_ll_dma.c
|
|
* @author MCD Application Team
|
|
* @brief DMA LL module driver.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* Copyright (c) 2017 STMicroelectronics.
|
|
* All rights reserved.
|
|
*
|
|
* This software is licensed under terms that can be found in the LICENSE file
|
|
* in the root directory of this software component.
|
|
* If no LICENSE file comes with this software, it is provided AS-IS.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
#if defined(USE_FULL_LL_DRIVER)
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "stm32h7xx_ll_dma.h"
|
|
#include "stm32h7xx_ll_bus.h"
|
|
#ifdef USE_FULL_ASSERT
|
|
#include "stm32_assert.h"
|
|
#else
|
|
#define assert_param(expr) ((void)0U)
|
|
#endif
|
|
|
|
/** @addtogroup STM32H7xx_LL_Driver
|
|
* @{
|
|
*/
|
|
|
|
#if defined (DMA1) || defined (DMA2)
|
|
|
|
/** @addtogroup DMA_LL
|
|
* @{
|
|
*/
|
|
|
|
/* Private types -------------------------------------------------------------*/
|
|
/* Private variables ---------------------------------------------------------*/
|
|
/* Private constants ---------------------------------------------------------*/
|
|
/* Private macros ------------------------------------------------------------*/
|
|
/** @addtogroup DMA_LL_Private_Macros
|
|
* @{
|
|
*/
|
|
#define IS_LL_DMA_DIRECTION(__VALUE__) (((__VALUE__) == LL_DMA_DIRECTION_PERIPH_TO_MEMORY) || \
|
|
((__VALUE__) == LL_DMA_DIRECTION_MEMORY_TO_PERIPH) || \
|
|
((__VALUE__) == LL_DMA_DIRECTION_MEMORY_TO_MEMORY))
|
|
|
|
#define IS_LL_DMA_MODE(__VALUE__) (((__VALUE__) == LL_DMA_MODE_NORMAL) || \
|
|
((__VALUE__) == LL_DMA_MODE_CIRCULAR) || \
|
|
((__VALUE__) == LL_DMA_MODE_PFCTRL))
|
|
|
|
#define IS_LL_DMA_PERIPHINCMODE(__VALUE__) (((__VALUE__) == LL_DMA_PERIPH_INCREMENT) || \
|
|
((__VALUE__) == LL_DMA_PERIPH_NOINCREMENT))
|
|
|
|
#define IS_LL_DMA_MEMORYINCMODE(__VALUE__) (((__VALUE__) == LL_DMA_MEMORY_INCREMENT) || \
|
|
((__VALUE__) == LL_DMA_MEMORY_NOINCREMENT))
|
|
|
|
#define IS_LL_DMA_PERIPHDATASIZE(__VALUE__) (((__VALUE__) == LL_DMA_PDATAALIGN_BYTE) || \
|
|
((__VALUE__) == LL_DMA_PDATAALIGN_HALFWORD) || \
|
|
((__VALUE__) == LL_DMA_PDATAALIGN_WORD))
|
|
|
|
#define IS_LL_DMA_MEMORYDATASIZE(__VALUE__) (((__VALUE__) == LL_DMA_MDATAALIGN_BYTE) || \
|
|
((__VALUE__) == LL_DMA_MDATAALIGN_HALFWORD) || \
|
|
((__VALUE__) == LL_DMA_MDATAALIGN_WORD))
|
|
|
|
#define IS_LL_DMA_NBDATA(__VALUE__) ((__VALUE__) <= 0x0000FFFFU)
|
|
|
|
#if defined(TIM24)
|
|
#define IS_LL_DMA_REQUEST(REQUEST) (((REQUEST) <= LL_DMAMUX1_REQ_TIM24_TRIG))
|
|
#elif defined(ADC3)
|
|
#define IS_LL_DMA_REQUEST(REQUEST) (((REQUEST) <= LL_DMAMUX1_REQ_ADC3))
|
|
#else
|
|
#define IS_LL_DMA_REQUEST(REQUEST) (((REQUEST) <= LL_DMAMUX1_REQ_USART10_TX))
|
|
#endif /* TIM24 */
|
|
|
|
#define IS_LL_DMA_PRIORITY(__VALUE__) (((__VALUE__) == LL_DMA_PRIORITY_LOW) || \
|
|
((__VALUE__) == LL_DMA_PRIORITY_MEDIUM) || \
|
|
((__VALUE__) == LL_DMA_PRIORITY_HIGH) || \
|
|
((__VALUE__) == LL_DMA_PRIORITY_VERYHIGH))
|
|
|
|
#define IS_LL_DMA_ALL_STREAM_INSTANCE(INSTANCE, STREAM) ((((INSTANCE) == DMA1) && \
|
|
(((STREAM) == LL_DMA_STREAM_0) || \
|
|
((STREAM) == LL_DMA_STREAM_1) || \
|
|
((STREAM) == LL_DMA_STREAM_2) || \
|
|
((STREAM) == LL_DMA_STREAM_3) || \
|
|
((STREAM) == LL_DMA_STREAM_4) || \
|
|
((STREAM) == LL_DMA_STREAM_5) || \
|
|
((STREAM) == LL_DMA_STREAM_6) || \
|
|
((STREAM) == LL_DMA_STREAM_7) || \
|
|
((STREAM) == LL_DMA_STREAM_ALL))) || \
|
|
(((INSTANCE) == DMA2) && \
|
|
(((STREAM) == LL_DMA_STREAM_0) || \
|
|
((STREAM) == LL_DMA_STREAM_1) || \
|
|
((STREAM) == LL_DMA_STREAM_2) || \
|
|
((STREAM) == LL_DMA_STREAM_3) || \
|
|
((STREAM) == LL_DMA_STREAM_4) || \
|
|
((STREAM) == LL_DMA_STREAM_5) || \
|
|
((STREAM) == LL_DMA_STREAM_6) || \
|
|
((STREAM) == LL_DMA_STREAM_7) || \
|
|
((STREAM) == LL_DMA_STREAM_ALL))))
|
|
|
|
#define IS_LL_DMA_FIFO_MODE_STATE(STATE) (((STATE) == LL_DMA_FIFOMODE_DISABLE ) || \
|
|
((STATE) == LL_DMA_FIFOMODE_ENABLE))
|
|
|
|
#define IS_LL_DMA_FIFO_THRESHOLD(THRESHOLD) (((THRESHOLD) == LL_DMA_FIFOTHRESHOLD_1_4) || \
|
|
((THRESHOLD) == LL_DMA_FIFOTHRESHOLD_1_2) || \
|
|
((THRESHOLD) == LL_DMA_FIFOTHRESHOLD_3_4) || \
|
|
((THRESHOLD) == LL_DMA_FIFOTHRESHOLD_FULL))
|
|
|
|
#define IS_LL_DMA_MEMORY_BURST(BURST) (((BURST) == LL_DMA_MBURST_SINGLE) || \
|
|
((BURST) == LL_DMA_MBURST_INC4) || \
|
|
((BURST) == LL_DMA_MBURST_INC8) || \
|
|
((BURST) == LL_DMA_MBURST_INC16))
|
|
|
|
#define IS_LL_DMA_PERIPHERAL_BURST(BURST) (((BURST) == LL_DMA_PBURST_SINGLE) || \
|
|
((BURST) == LL_DMA_PBURST_INC4) || \
|
|
((BURST) == LL_DMA_PBURST_INC8) || \
|
|
((BURST) == LL_DMA_PBURST_INC16))
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/* Private function prototypes -----------------------------------------------*/
|
|
|
|
/* Exported functions --------------------------------------------------------*/
|
|
/** @addtogroup DMA_LL_Exported_Functions
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup DMA_LL_EF_Init
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief De-initialize the DMA registers to their default reset values.
|
|
* @param DMAx DMAx Instance
|
|
* @param Stream This parameter can be one of the following values:
|
|
* @arg @ref LL_DMA_STREAM_0
|
|
* @arg @ref LL_DMA_STREAM_1
|
|
* @arg @ref LL_DMA_STREAM_2
|
|
* @arg @ref LL_DMA_STREAM_3
|
|
* @arg @ref LL_DMA_STREAM_4
|
|
* @arg @ref LL_DMA_STREAM_5
|
|
* @arg @ref LL_DMA_STREAM_6
|
|
* @arg @ref LL_DMA_STREAM_7
|
|
* @arg @ref LL_DMA_STREAM_ALL
|
|
* @retval An ErrorStatus enumeration value:
|
|
* - SUCCESS: DMA registers are de-initialized
|
|
* - ERROR: DMA registers are not de-initialized
|
|
*/
|
|
uint32_t LL_DMA_DeInit(DMA_TypeDef *DMAx, uint32_t Stream)
|
|
{
|
|
DMA_Stream_TypeDef *tmp;
|
|
ErrorStatus status = SUCCESS;
|
|
|
|
/* Check the DMA Instance DMAx and Stream parameters */
|
|
assert_param(IS_LL_DMA_ALL_STREAM_INSTANCE(DMAx, Stream));
|
|
|
|
if (Stream == LL_DMA_STREAM_ALL)
|
|
{
|
|
if (DMAx == DMA1)
|
|
{
|
|
/* Force reset of DMA clock */
|
|
LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_DMA1);
|
|
|
|
/* Release reset of DMA clock */
|
|
LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_DMA1);
|
|
}
|
|
else if (DMAx == DMA2)
|
|
{
|
|
/* Force reset of DMA clock */
|
|
LL_AHB1_GRP1_ForceReset(LL_AHB1_GRP1_PERIPH_DMA2);
|
|
|
|
/* Release reset of DMA clock */
|
|
LL_AHB1_GRP1_ReleaseReset(LL_AHB1_GRP1_PERIPH_DMA2);
|
|
}
|
|
else
|
|
{
|
|
status = ERROR;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
/* Disable the selected Stream */
|
|
LL_DMA_DisableStream(DMAx, Stream);
|
|
|
|
/* Get the DMA Stream Instance */
|
|
tmp = (DMA_Stream_TypeDef *)(__LL_DMA_GET_STREAM_INSTANCE(DMAx, Stream));
|
|
|
|
/* Reset DMAx_Streamy configuration register */
|
|
LL_DMA_WriteReg(tmp, CR, 0U);
|
|
|
|
/* Reset DMAx_Streamy remaining bytes register */
|
|
LL_DMA_WriteReg(tmp, NDTR, 0U);
|
|
|
|
/* Reset DMAx_Streamy peripheral address register */
|
|
LL_DMA_WriteReg(tmp, PAR, 0U);
|
|
|
|
/* Reset DMAx_Streamy memory address register */
|
|
LL_DMA_WriteReg(tmp, M0AR, 0U);
|
|
|
|
/* Reset DMAx_Streamy memory address register */
|
|
LL_DMA_WriteReg(tmp, M1AR, 0U);
|
|
|
|
/* Reset DMAx_Streamy FIFO control register */
|
|
LL_DMA_WriteReg(tmp, FCR, 0x00000021U);
|
|
|
|
/* Reset Channel register field for DMAx Stream */
|
|
LL_DMA_SetPeriphRequest(DMAx, Stream, LL_DMAMUX1_REQ_MEM2MEM);
|
|
|
|
if (Stream == LL_DMA_STREAM_0)
|
|
{
|
|
/* Reset the Stream0 pending flags */
|
|
DMAx->LIFCR = 0x0000003FU;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_1)
|
|
{
|
|
/* Reset the Stream1 pending flags */
|
|
DMAx->LIFCR = 0x00000F40U;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_2)
|
|
{
|
|
/* Reset the Stream2 pending flags */
|
|
DMAx->LIFCR = 0x003F0000U;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_3)
|
|
{
|
|
/* Reset the Stream3 pending flags */
|
|
DMAx->LIFCR = 0x0F400000U;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_4)
|
|
{
|
|
/* Reset the Stream4 pending flags */
|
|
DMAx->HIFCR = 0x0000003FU;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_5)
|
|
{
|
|
/* Reset the Stream5 pending flags */
|
|
DMAx->HIFCR = 0x00000F40U;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_6)
|
|
{
|
|
/* Reset the Stream6 pending flags */
|
|
DMAx->HIFCR = 0x003F0000U;
|
|
}
|
|
else if (Stream == LL_DMA_STREAM_7)
|
|
{
|
|
/* Reset the Stream7 pending flags */
|
|
DMAx->HIFCR = 0x0F400000U;
|
|
}
|
|
else
|
|
{
|
|
status = ERROR;
|
|
}
|
|
}
|
|
|
|
return (uint32_t)status;
|
|
}
|
|
|
|
/**
|
|
* @brief Initialize the DMA registers according to the specified parameters in DMA_InitStruct.
|
|
* @note To convert DMAx_Streamy Instance to DMAx Instance and Streamy, use helper macros :
|
|
* @arg @ref __LL_DMA_GET_INSTANCE
|
|
* @arg @ref __LL_DMA_GET_STREAM
|
|
* @param DMAx DMAx Instance
|
|
* @param Stream This parameter can be one of the following values:
|
|
* @arg @ref LL_DMA_STREAM_0
|
|
* @arg @ref LL_DMA_STREAM_1
|
|
* @arg @ref LL_DMA_STREAM_2
|
|
* @arg @ref LL_DMA_STREAM_3
|
|
* @arg @ref LL_DMA_STREAM_4
|
|
* @arg @ref LL_DMA_STREAM_5
|
|
* @arg @ref LL_DMA_STREAM_6
|
|
* @arg @ref LL_DMA_STREAM_7
|
|
* @param DMA_InitStruct pointer to a @ref LL_DMA_InitTypeDef structure.
|
|
* @retval An ErrorStatus enumeration value:
|
|
* - SUCCESS: DMA registers are initialized
|
|
* - ERROR: Not applicable
|
|
*/
|
|
uint32_t LL_DMA_Init(DMA_TypeDef *DMAx, uint32_t Stream, LL_DMA_InitTypeDef *DMA_InitStruct)
|
|
{
|
|
/* Check the DMA Instance DMAx and Stream parameters */
|
|
assert_param(IS_LL_DMA_ALL_STREAM_INSTANCE(DMAx, Stream));
|
|
|
|
/* Check the DMA parameters from DMA_InitStruct */
|
|
assert_param(IS_LL_DMA_DIRECTION(DMA_InitStruct->Direction));
|
|
assert_param(IS_LL_DMA_MODE(DMA_InitStruct->Mode));
|
|
assert_param(IS_LL_DMA_PERIPHINCMODE(DMA_InitStruct->PeriphOrM2MSrcIncMode));
|
|
assert_param(IS_LL_DMA_MEMORYINCMODE(DMA_InitStruct->MemoryOrM2MDstIncMode));
|
|
assert_param(IS_LL_DMA_PERIPHDATASIZE(DMA_InitStruct->PeriphOrM2MSrcDataSize));
|
|
assert_param(IS_LL_DMA_MEMORYDATASIZE(DMA_InitStruct->MemoryOrM2MDstDataSize));
|
|
assert_param(IS_LL_DMA_NBDATA(DMA_InitStruct->NbData));
|
|
assert_param(IS_LL_DMA_REQUEST(DMA_InitStruct->PeriphRequest));
|
|
assert_param(IS_LL_DMA_PRIORITY(DMA_InitStruct->Priority));
|
|
assert_param(IS_LL_DMA_FIFO_MODE_STATE(DMA_InitStruct->FIFOMode));
|
|
|
|
/* Check the memory burst, peripheral burst and FIFO threshold parameters only
|
|
when FIFO mode is enabled */
|
|
if (DMA_InitStruct->FIFOMode != LL_DMA_FIFOMODE_DISABLE)
|
|
{
|
|
assert_param(IS_LL_DMA_FIFO_THRESHOLD(DMA_InitStruct->FIFOThreshold));
|
|
assert_param(IS_LL_DMA_MEMORY_BURST(DMA_InitStruct->MemBurst));
|
|
assert_param(IS_LL_DMA_PERIPHERAL_BURST(DMA_InitStruct->PeriphBurst));
|
|
}
|
|
|
|
/*---------------------------- DMAx SxCR Configuration ------------------------
|
|
* Configure DMAx_Streamy: data transfer direction, data transfer mode,
|
|
* peripheral and memory increment mode,
|
|
* data size alignment and priority level with parameters :
|
|
* - Direction: DMA_SxCR_DIR[1:0] bits
|
|
* - Mode: DMA_SxCR_CIRC bit
|
|
* - PeriphOrM2MSrcIncMode: DMA_SxCR_PINC bit
|
|
* - MemoryOrM2MDstIncMode: DMA_SxCR_MINC bit
|
|
* - PeriphOrM2MSrcDataSize: DMA_SxCR_PSIZE[1:0] bits
|
|
* - MemoryOrM2MDstDataSize: DMA_SxCR_MSIZE[1:0] bits
|
|
* - Priority: DMA_SxCR_PL[1:0] bits
|
|
*/
|
|
LL_DMA_ConfigTransfer(DMAx, Stream, DMA_InitStruct->Direction | \
|
|
DMA_InitStruct->Mode | \
|
|
DMA_InitStruct->PeriphOrM2MSrcIncMode | \
|
|
DMA_InitStruct->MemoryOrM2MDstIncMode | \
|
|
DMA_InitStruct->PeriphOrM2MSrcDataSize | \
|
|
DMA_InitStruct->MemoryOrM2MDstDataSize | \
|
|
DMA_InitStruct->Priority
|
|
);
|
|
|
|
if (DMA_InitStruct->FIFOMode != LL_DMA_FIFOMODE_DISABLE)
|
|
{
|
|
/*---------------------------- DMAx SxFCR Configuration ------------------------
|
|
* Configure DMAx_Streamy: fifo mode and fifo threshold with parameters :
|
|
* - FIFOMode: DMA_SxFCR_DMDIS bit
|
|
* - FIFOThreshold: DMA_SxFCR_FTH[1:0] bits
|
|
*/
|
|
LL_DMA_ConfigFifo(DMAx, Stream, DMA_InitStruct->FIFOMode, DMA_InitStruct->FIFOThreshold);
|
|
|
|
/*---------------------------- DMAx SxCR Configuration --------------------------
|
|
* Configure DMAx_Streamy: memory burst transfer with parameters :
|
|
* - MemBurst: DMA_SxCR_MBURST[1:0] bits
|
|
*/
|
|
LL_DMA_SetMemoryBurstxfer(DMAx, Stream, DMA_InitStruct->MemBurst);
|
|
|
|
/*---------------------------- DMAx SxCR Configuration --------------------------
|
|
* Configure DMAx_Streamy: peripheral burst transfer with parameters :
|
|
* - PeriphBurst: DMA_SxCR_PBURST[1:0] bits
|
|
*/
|
|
LL_DMA_SetPeriphBurstxfer(DMAx, Stream, DMA_InitStruct->PeriphBurst);
|
|
}
|
|
|
|
/*-------------------------- DMAx SxM0AR Configuration --------------------------
|
|
* Configure the memory or destination base address with parameter :
|
|
* - MemoryOrM2MDstAddress: DMA_SxM0AR_M0A[31:0] bits
|
|
*/
|
|
LL_DMA_SetMemoryAddress(DMAx, Stream, DMA_InitStruct->MemoryOrM2MDstAddress);
|
|
|
|
/*-------------------------- DMAx SxPAR Configuration ---------------------------
|
|
* Configure the peripheral or source base address with parameter :
|
|
* - PeriphOrM2MSrcAddress: DMA_SxPAR_PA[31:0] bits
|
|
*/
|
|
LL_DMA_SetPeriphAddress(DMAx, Stream, DMA_InitStruct->PeriphOrM2MSrcAddress);
|
|
|
|
/*--------------------------- DMAx SxNDTR Configuration -------------------------
|
|
* Configure the peripheral base address with parameter :
|
|
* - NbData: DMA_SxNDT[15:0] bits
|
|
*/
|
|
LL_DMA_SetDataLength(DMAx, Stream, DMA_InitStruct->NbData);
|
|
|
|
/*--------------------------- DMA SxCR_CHSEL Configuration ----------------------
|
|
* Configure the peripheral base address with parameter :
|
|
* - PeriphRequest: DMA_SxCR_CHSEL[3:0] bits
|
|
*/
|
|
LL_DMA_SetPeriphRequest(DMAx, Stream, DMA_InitStruct->PeriphRequest);
|
|
|
|
return (uint32_t)SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* @brief Set each @ref LL_DMA_InitTypeDef field to default value.
|
|
* @param DMA_InitStruct Pointer to a @ref LL_DMA_InitTypeDef structure.
|
|
* @retval None
|
|
*/
|
|
void LL_DMA_StructInit(LL_DMA_InitTypeDef *DMA_InitStruct)
|
|
{
|
|
/* Set DMA_InitStruct fields to default values */
|
|
DMA_InitStruct->PeriphOrM2MSrcAddress = 0x00000000U;
|
|
DMA_InitStruct->MemoryOrM2MDstAddress = 0x00000000U;
|
|
DMA_InitStruct->Direction = LL_DMA_DIRECTION_PERIPH_TO_MEMORY;
|
|
DMA_InitStruct->Mode = LL_DMA_MODE_NORMAL;
|
|
DMA_InitStruct->PeriphOrM2MSrcIncMode = LL_DMA_PERIPH_NOINCREMENT;
|
|
DMA_InitStruct->MemoryOrM2MDstIncMode = LL_DMA_MEMORY_NOINCREMENT;
|
|
DMA_InitStruct->PeriphOrM2MSrcDataSize = LL_DMA_PDATAALIGN_BYTE;
|
|
DMA_InitStruct->MemoryOrM2MDstDataSize = LL_DMA_MDATAALIGN_BYTE;
|
|
DMA_InitStruct->NbData = 0x00000000U;
|
|
DMA_InitStruct->PeriphRequest = LL_DMAMUX1_REQ_MEM2MEM;
|
|
DMA_InitStruct->Priority = LL_DMA_PRIORITY_LOW;
|
|
DMA_InitStruct->FIFOMode = LL_DMA_FIFOMODE_DISABLE;
|
|
DMA_InitStruct->FIFOThreshold = LL_DMA_FIFOTHRESHOLD_1_4;
|
|
DMA_InitStruct->MemBurst = LL_DMA_MBURST_SINGLE;
|
|
DMA_InitStruct->PeriphBurst = LL_DMA_PBURST_SINGLE;
|
|
}
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* DMA1 || DMA2 */
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* USE_FULL_LL_DRIVER */
|
|
|