412 lines
15 KiB
C
412 lines
15 KiB
C
/**
|
|
******************************************************************************
|
|
* @file HAL_dma.h
|
|
* @author IC Applications Department
|
|
* @version V0.8
|
|
* @date 2019_08_02
|
|
* @brief This file contains all the functions prototypes for the DMA firmware
|
|
* library.
|
|
******************************************************************************
|
|
* @copy
|
|
*
|
|
* THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
|
|
* WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
|
|
* TIME. AS A RESULT, HOLOCENE SHALL NOT BE HELD LIABLE FOR ANY
|
|
* DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
|
|
* FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
|
|
* CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
|
|
*
|
|
* <h2><center>© COPYRIGHT 2016 HOLOCENE</center></h2>
|
|
*/
|
|
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
|
#ifndef __HAL_DMA_H
|
|
#define __HAL_DMA_H
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "HAL_device.h"
|
|
|
|
/** @addtogroup StdPeriph_Driver
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup DMA
|
|
* @{
|
|
*/
|
|
|
|
/** @defgroup DMA_Exported_Types
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief DMA Init structure definition
|
|
*/
|
|
|
|
typedef struct
|
|
{
|
|
uint32_t DMA_PeripheralBaseAddr;
|
|
uint32_t DMA_MemoryBaseAddr;
|
|
uint32_t DMA_DIR;
|
|
uint32_t DMA_BufferSize;
|
|
uint32_t DMA_PeripheralInc;
|
|
uint32_t DMA_MemoryInc;
|
|
uint32_t DMA_PeripheralDataSize;
|
|
uint32_t DMA_MemoryDataSize;
|
|
uint32_t DMA_Mode;
|
|
uint32_t DMA_Priority;
|
|
uint32_t DMA_M2M;
|
|
}DMA_InitTypeDef;
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_Exported_Constants
|
|
* @{
|
|
*/
|
|
|
|
#define IS_DMA_ALL_PERIPH(PERIPH) (((*(uint32_t*)&(PERIPH)) == DMA1_Channel1_BASE) || \
|
|
((*(uint32_t*)&(PERIPH)) == DMA1_Channel2_BASE) || \
|
|
((*(uint32_t*)&(PERIPH)) == DMA1_Channel3_BASE) || \
|
|
((*(uint32_t*)&(PERIPH)) == DMA1_Channel4_BASE) || \
|
|
((*(uint32_t*)&(PERIPH)) == DMA1_Channel5_BASE))
|
|
|
|
|
|
|
|
/** @defgroup DMA_data_transfer_direction
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_DIR_PeripheralDST ((uint32_t)0x00000010) //mtop
|
|
#define DMA_DIR_PeripheralSRC ((uint32_t)0x00000000) //ptom
|
|
#define IS_DMA_DIR(DIR) (((DIR) == DMA_DIR_PeripheralDST) || \
|
|
((DIR) == DMA_DIR_PeripheralSRC))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_peripheral_incremented_mode
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_PeripheralInc_Enable ((uint32_t)0x00000040)
|
|
#define DMA_PeripheralInc_Disable ((uint32_t)0x00000000)
|
|
#define IS_DMA_PERIPHERAL_INC_STATE(STATE) (((STATE) == DMA_PeripheralInc_Enable) || \
|
|
((STATE) == DMA_PeripheralInc_Disable))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_memory_incremented_mode
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_MemoryInc_Enable ((uint32_t)0x00000080)
|
|
#define DMA_MemoryInc_Disable ((uint32_t)0x00000000)
|
|
#define IS_DMA_MEMORY_INC_STATE(STATE) (((STATE) == DMA_MemoryInc_Enable) || \
|
|
((STATE) == DMA_MemoryInc_Disable))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_peripheral_data_size
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_PeripheralDataSize_Byte ((uint32_t)0x00000000)
|
|
#define DMA_PeripheralDataSize_HalfWord ((uint32_t)0x00000100)
|
|
#define DMA_PeripheralDataSize_Word ((uint32_t)0x00000200)
|
|
#define IS_DMA_PERIPHERAL_DATA_SIZE(SIZE) (((SIZE) == DMA_PeripheralDataSize_Byte) || \
|
|
((SIZE) == DMA_PeripheralDataSize_HalfWord) || \
|
|
((SIZE) == DMA_PeripheralDataSize_Word))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_memory_data_size
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_MemoryDataSize_Byte ((uint32_t)0x00000000)
|
|
#define DMA_MemoryDataSize_HalfWord ((uint32_t)0x00000400)
|
|
#define DMA_MemoryDataSize_Word ((uint32_t)0x00000800)
|
|
#define IS_DMA_MEMORY_DATA_SIZE(SIZE) (((SIZE) == DMA_MemoryDataSize_Byte) || \
|
|
((SIZE) == DMA_MemoryDataSize_HalfWord) || \
|
|
((SIZE) == DMA_MemoryDataSize_Word))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_circular_normal_mode
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_Mode_Circular ((uint32_t)0x00000020)
|
|
#define DMA_Mode_Normal ((uint32_t)0x00000000)
|
|
#define IS_DMA_MODE(MODE) (((MODE) == DMA_Mode_Circular) || ((MODE) == DMA_Mode_Normal))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_priority_level
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_Priority_VeryHigh ((uint32_t)0x00003000)
|
|
#define DMA_Priority_High ((uint32_t)0x00002000)
|
|
#define DMA_Priority_Medium ((uint32_t)0x00001000)
|
|
#define DMA_Priority_Low ((uint32_t)0x00000000)
|
|
#define IS_DMA_PRIORITY(PRIORITY) (((PRIORITY) == DMA_Priority_VeryHigh) || \
|
|
((PRIORITY) == DMA_Priority_High) || \
|
|
((PRIORITY) == DMA_Priority_Medium) || \
|
|
((PRIORITY) == DMA_Priority_Low))
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_memory_to_memory
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_M2M_Enable ((uint32_t)0x00004000)
|
|
#define DMA_M2M_Disable ((uint32_t)0x00000000)
|
|
#define IS_DMA_M2M_STATE(STATE) (((STATE) == DMA_M2M_Enable) || ((STATE) == DMA_M2M_Disable))
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_interrupts_definition
|
|
* @{
|
|
*/
|
|
|
|
#define DMA_IT_TC ((uint32_t)0x00000002)
|
|
#define DMA_IT_HT ((uint32_t)0x00000004)
|
|
#define DMA_IT_TE ((uint32_t)0x00000008)
|
|
#define IS_DMA_CONFIG_IT(IT) ((((IT) & 0xFFFFFFF1) == 0x00) && ((IT) != 0x00))
|
|
|
|
/**
|
|
* @brief For DMA1
|
|
*/
|
|
|
|
#define DMA1_IT_GL1 ((uint32_t)0x00000001)
|
|
#define DMA1_IT_TC1 ((uint32_t)0x00000002)
|
|
#define DMA1_IT_HT1 ((uint32_t)0x00000004)
|
|
#define DMA1_IT_TE1 ((uint32_t)0x00000008)
|
|
#define DMA1_IT_GL2 ((uint32_t)0x00000010)
|
|
#define DMA1_IT_TC2 ((uint32_t)0x00000020)
|
|
#define DMA1_IT_HT2 ((uint32_t)0x00000040)
|
|
#define DMA1_IT_TE2 ((uint32_t)0x00000080)
|
|
#define DMA1_IT_GL3 ((uint32_t)0x00000100)
|
|
#define DMA1_IT_TC3 ((uint32_t)0x00000200)
|
|
#define DMA1_IT_HT3 ((uint32_t)0x00000400)
|
|
#define DMA1_IT_TE3 ((uint32_t)0x00000800)
|
|
#define DMA1_IT_GL4 ((uint32_t)0x00001000)
|
|
#define DMA1_IT_TC4 ((uint32_t)0x00002000)
|
|
#define DMA1_IT_HT4 ((uint32_t)0x00004000)
|
|
#define DMA1_IT_TE4 ((uint32_t)0x00008000)
|
|
#define DMA1_IT_GL5 ((uint32_t)0x00010000)
|
|
#define DMA1_IT_TC5 ((uint32_t)0x00020000)
|
|
#define DMA1_IT_HT5 ((uint32_t)0x00040000)
|
|
#define DMA1_IT_TE5 ((uint32_t)0x00080000)
|
|
|
|
#define DMA2_IT_GL1 ((uint32_t)0x10000001)
|
|
#define DMA2_IT_TC1 ((uint32_t)0x10000002)
|
|
#define DMA2_IT_HT1 ((uint32_t)0x10000004)
|
|
#define DMA2_IT_TE1 ((uint32_t)0x10000008)
|
|
#define DMA2_IT_GL2 ((uint32_t)0x10000010)
|
|
#define DMA2_IT_TC2 ((uint32_t)0x10000020)
|
|
#define DMA2_IT_HT2 ((uint32_t)0x10000040)
|
|
#define DMA2_IT_TE2 ((uint32_t)0x10000080)
|
|
#define DMA2_IT_GL3 ((uint32_t)0x10000100)
|
|
#define DMA2_IT_TC3 ((uint32_t)0x10000200)
|
|
#define DMA2_IT_HT3 ((uint32_t)0x10000400)
|
|
#define DMA2_IT_TE3 ((uint32_t)0x10000800)
|
|
#define DMA2_IT_GL4 ((uint32_t)0x10001000)
|
|
#define DMA2_IT_TC4 ((uint32_t)0x10002000)
|
|
#define DMA2_IT_HT4 ((uint32_t)0x10004000)
|
|
#define DMA2_IT_TE4 ((uint32_t)0x10008000)
|
|
#define DMA2_IT_GL5 ((uint32_t)0x10010000)
|
|
#define DMA2_IT_TC5 ((uint32_t)0x10020000)
|
|
#define DMA2_IT_HT5 ((uint32_t)0x10040000)
|
|
#define DMA2_IT_TE5 ((uint32_t)0x10080000)
|
|
#define DMA2_IT_GL6 ((uint32_t)0x10100000)
|
|
#define DMA2_IT_TC6 ((uint32_t)0x10200000)
|
|
#define DMA2_IT_HT6 ((uint32_t)0x10400000)
|
|
#define DMA2_IT_TE6 ((uint32_t)0x10800000)
|
|
#define DMA2_IT_GL7 ((uint32_t)0x11000000)
|
|
#define DMA2_IT_TC7 ((uint32_t)0x12000000)
|
|
#define DMA2_IT_HT7 ((uint32_t)0x14000000)
|
|
#define DMA2_IT_TE7 ((uint32_t)0x18000000)
|
|
|
|
#define DMA2_IT_GL8 ((uint32_t)0x10000001)
|
|
#define DMA2_IT_TC8 ((uint32_t)0x20000001)
|
|
#define DMA2_IT_HT8 ((uint32_t)0x40000001)
|
|
#define DMA2_IT_TE8 ((uint32_t)0x80000001)
|
|
|
|
#define IS_DMA_CLEAR_IT(IT) (((((IT) & 0xF0000000) == 0x00) || (((IT) & 0xEFF00000) == 0x00)) && ((IT) != 0x00))
|
|
|
|
#define IS_DMA_GET_IT(IT) (((IT) == DMA1_IT_GL1) || ((IT) == DMA1_IT_TC1) || \
|
|
((IT) == DMA1_IT_HT1) || ((IT) == DMA1_IT_TE1) || \
|
|
((IT) == DMA1_IT_GL2) || ((IT) == DMA1_IT_TC2) || \
|
|
((IT) == DMA1_IT_HT2) || ((IT) == DMA1_IT_TE2) || \
|
|
((IT) == DMA1_IT_GL3) || ((IT) == DMA1_IT_TC3) || \
|
|
((IT) == DMA1_IT_HT3) || ((IT) == DMA1_IT_TE3) || \
|
|
((IT) == DMA1_IT_GL4) || ((IT) == DMA1_IT_TC4) || \
|
|
((IT) == DMA1_IT_HT4) || ((IT) == DMA1_IT_TE4) || \
|
|
((IT) == DMA1_IT_GL5) || ((IT) == DMA1_IT_TC5) || \
|
|
((IT) == DMA1_IT_HT5) || ((IT) == DMA1_IT_TE5))
|
|
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_flags_definition
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @brief For DMA1
|
|
*/
|
|
|
|
#define DMA1_FLAG_GL1 ((uint32_t)0x00000001)
|
|
#define DMA1_FLAG_TC1 ((uint32_t)0x00000002)
|
|
#define DMA1_FLAG_HT1 ((uint32_t)0x00000004)
|
|
#define DMA1_FLAG_TE1 ((uint32_t)0x00000008)
|
|
#define DMA1_FLAG_GL2 ((uint32_t)0x00000010)
|
|
#define DMA1_FLAG_TC2 ((uint32_t)0x00000020)
|
|
#define DMA1_FLAG_HT2 ((uint32_t)0x00000040)
|
|
#define DMA1_FLAG_TE2 ((uint32_t)0x00000080)
|
|
#define DMA1_FLAG_GL3 ((uint32_t)0x00000100)
|
|
#define DMA1_FLAG_TC3 ((uint32_t)0x00000200)
|
|
#define DMA1_FLAG_HT3 ((uint32_t)0x00000400)
|
|
#define DMA1_FLAG_TE3 ((uint32_t)0x00000800)
|
|
#define DMA1_FLAG_GL4 ((uint32_t)0x00001000)
|
|
#define DMA1_FLAG_TC4 ((uint32_t)0x00002000)
|
|
#define DMA1_FLAG_HT4 ((uint32_t)0x00004000)
|
|
#define DMA1_FLAG_TE4 ((uint32_t)0x00008000)
|
|
#define DMA1_FLAG_GL5 ((uint32_t)0x00010000)
|
|
#define DMA1_FLAG_TC5 ((uint32_t)0x00020000)
|
|
#define DMA1_FLAG_HT5 ((uint32_t)0x00040000)
|
|
#define DMA1_FLAG_TE5 ((uint32_t)0x00080000)
|
|
#define DMA1_FLAG_GL6 ((uint32_t)0x00100000)
|
|
#define DMA1_FLAG_TC6 ((uint32_t)0x00200000)
|
|
#define DMA1_FLAG_HT6 ((uint32_t)0x00400000)
|
|
#define DMA1_FLAG_TE6 ((uint32_t)0x00800000)
|
|
#define DMA1_FLAG_GL7 ((uint32_t)0x01000000)
|
|
#define DMA1_FLAG_TC7 ((uint32_t)0x02000000)
|
|
#define DMA1_FLAG_HT7 ((uint32_t)0x04000000)
|
|
#define DMA1_FLAG_TE7 ((uint32_t)0x08000000)
|
|
|
|
#define DMA1_FLAG_GL8 ((uint32_t)0x10000000)
|
|
#define DMA1_FLAG_TC8 ((uint32_t)0x20000000)
|
|
#define DMA1_FLAG_HT8 ((uint32_t)0x40000000)
|
|
#define DMA1_FLAG_TE8 ((uint32_t)0x80000000)
|
|
|
|
#define DMA2_FLAG_GL1 ((uint32_t)0x10000001)
|
|
#define DMA2_FLAG_TC1 ((uint32_t)0x10000002)
|
|
#define DMA2_FLAG_HT1 ((uint32_t)0x10000004)
|
|
#define DMA2_FLAG_TE1 ((uint32_t)0x10000008)
|
|
#define DMA2_FLAG_GL2 ((uint32_t)0x10000010)
|
|
#define DMA2_FLAG_TC2 ((uint32_t)0x10000020)
|
|
#define DMA2_FLAG_HT2 ((uint32_t)0x10000040)
|
|
#define DMA2_FLAG_TE2 ((uint32_t)0x10000080)
|
|
#define DMA2_FLAG_GL3 ((uint32_t)0x10000100)
|
|
#define DMA2_FLAG_TC3 ((uint32_t)0x10000200)
|
|
#define DMA2_FLAG_HT3 ((uint32_t)0x10000400)
|
|
#define DMA2_FLAG_TE3 ((uint32_t)0x10000800)
|
|
#define DMA2_FLAG_GL4 ((uint32_t)0x10001000)
|
|
#define DMA2_FLAG_TC4 ((uint32_t)0x10002000)
|
|
#define DMA2_FLAG_HT4 ((uint32_t)0x10004000)
|
|
#define DMA2_FLAG_TE4 ((uint32_t)0x10008000)
|
|
#define DMA2_FLAG_GL5 ((uint32_t)0x10010000)
|
|
#define DMA2_FLAG_TC5 ((uint32_t)0x10020000)
|
|
#define DMA2_FLAG_HT5 ((uint32_t)0x10040000)
|
|
#define DMA2_FLAG_TE5 ((uint32_t)0x10080000)
|
|
#define DMA2_FLAG_GL6 ((uint32_t)0x10100000)
|
|
#define DMA2_FLAG_TC6 ((uint32_t)0x10200000)
|
|
#define DMA2_FLAG_HT6 ((uint32_t)0x10400000)
|
|
#define DMA2_FLAG_TE6 ((uint32_t)0x10800000)
|
|
#define DMA2_FLAG_GL7 ((uint32_t)0x11000000)
|
|
#define DMA2_FLAG_TC7 ((uint32_t)0x12000000)
|
|
#define DMA2_FLAG_HT7 ((uint32_t)0x14000000)
|
|
#define DMA2_FLAG_TE7 ((uint32_t)0x18000000)
|
|
|
|
#define DMA2_FLAG_GL8 ((uint32_t)0x10000001)
|
|
#define DMA2_FLAG_TC8 ((uint32_t)0x20000001)
|
|
#define DMA2_FLAG_HT8 ((uint32_t)0x40000001)
|
|
#define DMA2_FLAG_TE8 ((uint32_t)0x80000001)
|
|
|
|
|
|
|
|
#define IS_DMA_CLEAR_FLAG(FLAG) (((((FLAG) & 0xF0000000) == 0x00) || (((FLAG) & 0xEFF00000) == 0x00)) && ((FLAG) != 0x00))
|
|
|
|
#define IS_DMA_GET_FLAG(FLAG) (((FLAG) == DMA1_FLAG_GL1) || ((FLAG) == DMA1_FLAG_TC1) || \
|
|
((FLAG) == DMA1_FLAG_HT1) || ((FLAG) == DMA1_FLAG_TE1) || \
|
|
((FLAG) == DMA1_FLAG_GL2) || ((FLAG) == DMA1_FLAG_TC2) || \
|
|
((FLAG) == DMA1_FLAG_HT2) || ((FLAG) == DMA1_FLAG_TE2) || \
|
|
((FLAG) == DMA1_FLAG_GL3) || ((FLAG) == DMA1_FLAG_TC3) || \
|
|
((FLAG) == DMA1_FLAG_HT3) || ((FLAG) == DMA1_FLAG_TE3) || \
|
|
((FLAG) == DMA1_FLAG_GL4) || ((FLAG) == DMA1_FLAG_TC4) || \
|
|
((FLAG) == DMA1_FLAG_HT4) || ((FLAG) == DMA1_FLAG_TE4) || \
|
|
((FLAG) == DMA1_FLAG_GL5) || ((FLAG) == DMA1_FLAG_TC5) || \
|
|
((FLAG) == DMA1_FLAG_HT5) || ((FLAG) == DMA1_FLAG_TE5))
|
|
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_Buffer_Size
|
|
* @{
|
|
*/
|
|
|
|
#define IS_DMA_BUFFER_SIZE(SIZE) (((SIZE) >= 0x1) && ((SIZE) < 0x10000))
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_Exported_Macros
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/** @defgroup DMA_Exported_Functions
|
|
* @{
|
|
*/
|
|
|
|
void DMA_DeInit(DMA_Channel_TypeDef* DMAy_Channelx);
|
|
void DMA_Init(DMA_Channel_TypeDef* DMAy_Channelx, DMA_InitTypeDef* DMA_InitStruct);
|
|
void DMA_StructInit(DMA_InitTypeDef* DMA_InitStruct);
|
|
void DMA_Cmd(DMA_Channel_TypeDef* DMAy_Channelx, FunctionalState NewState);
|
|
void DMA_ITConfig(DMA_Channel_TypeDef* DMAy_Channelx, uint32_t DMA_IT, FunctionalState NewState);
|
|
uint16_t DMA_GetCurrDataCounter(DMA_Channel_TypeDef* DMAy_Channelx);
|
|
FlagStatus DMA_GetFlagStatus(uint32_t DMA_FLAG);
|
|
void DMA_ClearFlag(uint32_t DMA_FLAG);
|
|
ITStatus DMA_GetITStatus(uint32_t DMA_IT);
|
|
void DMA_ClearITPendingBit(uint32_t DMA_IT);
|
|
|
|
#endif /*__HAL_DMA_H */
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/*------------------ (C) COPYRIGHT 2016 HOLOCENE ------------------*/
|