/** ************************************************************************** * @file at32f421_dma.h * @brief at32f421 dma header file ************************************************************************** * Copyright notice & Disclaimer * * The software Board Support Package (BSP) that is made available to * download from Artery official website is the copyrighted work of Artery. * Artery authorizes customers to use, copy, and distribute the BSP * software and its related documentation for the purpose of design and * development in conjunction with Artery microcontrollers. Use of the * software is governed by this copyright notice and the following disclaimer. * * THIS SOFTWARE IS PROVIDED ON "AS IS" BASIS WITHOUT WARRANTIES, * GUARANTEES OR REPRESENTATIONS OF ANY KIND. ARTERY EXPRESSLY DISCLAIMS, * TO THE FULLEST EXTENT PERMITTED BY LAW, ALL EXPRESS, IMPLIED OR * STATUTORY OR OTHER WARRANTIES, GUARANTEES OR REPRESENTATIONS, * INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. * ************************************************************************** */ /** at32f421 dma1 channel request(fixed) as folleow : ------------------------------------------------------------------------------------------------------ peripherals | channel1 | channel2 | channel3 | channel4 | channel5 ------------------------------------------------------------------------------------------------------ adc | adc | | | | ------------------------------------------------------------------------------------------------------ spi/i2s | | spi1/i2s1_rx | spi1/i2s1_tx | spi2/i2s2_rx | spi2/i2s2_tx ------------------------------------------------------------------------------------------------------ usart1 | | usart1_tx | usart1_rx | usart1_tx | usart1_rx ------------------------------------------------------------------------------------------------------ usart2 | | | | usart2_tx | usart2_rx ------------------------------------------------------------------------------------------------------ i2c | | i2c1_tx | i2c1_rx | i2c2_tx | i2c2_rx ------------------------------------------------------------------------------------------------------ | | | | tmr1_ch4 | tmr1_ch3 tmr1 | | tmr1_ch1 | tmr1_ch2 | tmr1_trig | tmr1_overflow | | | | tmr1_hall | ------------------------------------------------------------------------------------------------------ tmr3 | | tmr3_ch3 | tmr3_ch4 | tmr3_ch1 | | | | tmr3_overflow | tmr3_trig | ------------------------------------------------------------------------------------------------------ tmr6 | | | tmr6_overflow | | ------------------------------------------------------------------------------------------------------ | | | | | tmr15_ch1 | | | | | tmr15_overflow tmr15 | | | | | tmr15_trig | | | | | tmr15_hall | | | | | tmr15_ch2 ------------------------------------------------------------------------------------------------------ tmr16 | | | tmr16_ch1 | tmr16_ch1 | | | |tmr16_overflow |tmr16_overflow | ------------------------------------------------------------------------------------------------------ tmr17 | tmr17_ch1 | tmr17_ch1 | | | |tmr17_overflow | tmr17_overflow | | | ------------------------------------------------------------------------------------------------------ */ /* Define to prevent recursive inclusion -------------------------------------*/ #ifndef __AT32F421_DMA_H #define __AT32F421_DMA_H #ifdef __cplusplus extern "C" { #endif /* Includes ------------------------------------------------------------------*/ #include "at32f421.h" /** @addtogroup AT32F421_periph_driver * @{ */ /** @addtogroup DMA * @{ */ /** @defgroup DMA_interrupts_definition * @brief dma interrupt * @{ */ #define DMA_FDT_INT ((uint32_t)0x00000002) /*!< dma full data transfer interrupt */ #define DMA_HDT_INT ((uint32_t)0x00000004) /*!< dma half data transfer interrupt */ #define DMA_DTERR_INT ((uint32_t)0x00000008) /*!< dma errorr interrupt */ /** * @} */ /** @defgroup DMA_flags_definition * @brief dma flag * @{ */ #define DMA1_GL1_FLAG ((uint32_t)0x00000001) /*!< dma1 channel1 global flag */ #define DMA1_FDT1_FLAG ((uint32_t)0x00000002) /*!< dma1 channel1 full data transfer flag */ #define DMA1_HDT1_FLAG ((uint32_t)0x00000004) /*!< dma1 channel1 half data transfer flag */ #define DMA1_DTERR1_FLAG ((uint32_t)0x00000008) /*!< dma1 channel1 error flag */ #define DMA1_GL2_FLAG ((uint32_t)0x00000010) /*!< dma1 channel2 global flag */ #define DMA1_FDT2_FLAG ((uint32_t)0x00000020) /*!< dma1 channel2 full data transfer flag */ #define DMA1_HDT2_FLAG ((uint32_t)0x00000040) /*!< dma1 channel2 half data transfer flag */ #define DMA1_DTERR2_FLAG ((uint32_t)0x00000080) /*!< dma1 channel2 error flag */ #define DMA1_GL3_FLAG ((uint32_t)0x00000100) /*!< dma1 channel3 global flag */ #define DMA1_FDT3_FLAG ((uint32_t)0x00000200) /*!< dma1 channel3 full data transfer flag */ #define DMA1_HDT3_FLAG ((uint32_t)0x00000400) /*!< dma1 channel3 half data transfer flag */ #define DMA1_DTERR3_FLAG ((uint32_t)0x00000800) /*!< dma1 channel3 error flag */ #define DMA1_GL4_FLAG ((uint32_t)0x00001000) /*!< dma1 channel4 global flag */ #define DMA1_FDT4_FLAG ((uint32_t)0x00002000) /*!< dma1 channel4 full data transfer flag */ #define DMA1_HDT4_FLAG ((uint32_t)0x00004000) /*!< dma1 channel4 half data transfer flag */ #define DMA1_DTERR4_FLAG ((uint32_t)0x00008000) /*!< dma1 channel4 error flag */ #define DMA1_GL5_FLAG ((uint32_t)0x00010000) /*!< dma1 channel5 global flag */ #define DMA1_FDT5_FLAG ((uint32_t)0x00020000) /*!< dma1 channel5 full data transfer flag */ #define DMA1_HDT5_FLAG ((uint32_t)0x00040000) /*!< dma1 channel5 half data transfer flag */ #define DMA1_DTERR5_FLAG ((uint32_t)0x00080000) /*!< dma1 channel5 error flag */ /** * @} */ /** @defgroup DMA_exported_types * @{ */ /** * @brief dma direction type */ typedef enum { DMA_DIR_PERIPHERAL_TO_MEMORY = 0x0000, /*!< dma data transfer direction:peripheral to memory */ DMA_DIR_MEMORY_TO_PERIPHERAL = 0x0010, /*!< dma data transfer direction:memory to peripheral */ DMA_DIR_MEMORY_TO_MEMORY = 0x4000 /*!< dma data transfer direction:memory to memory */ } dma_dir_type; /** * @brief dma peripheral incremented type */ typedef enum { DMA_PERIPHERAL_INC_DISABLE = 0x00, /*!< dma peripheral increment mode disable */ DMA_PERIPHERAL_INC_ENABLE = 0x01 /*!< dma peripheral increment mode enable */ } dma_peripheral_inc_type; /** * @brief dma memory incremented type */ typedef enum { DMA_MEMORY_INC_DISABLE = 0x00, /*!< dma memory increment mode disable */ DMA_MEMORY_INC_ENABLE = 0x01 /*!< dma memory increment mode enable */ } dma_memory_inc_type; /** * @brief dma peripheral data size type */ typedef enum { DMA_PERIPHERAL_DATA_WIDTH_BYTE = 0x00, /*!< dma peripheral databus width 8bit */ DMA_PERIPHERAL_DATA_WIDTH_HALFWORD = 0x01, /*!< dma peripheral databus width 16bit */ DMA_PERIPHERAL_DATA_WIDTH_WORD = 0x02 /*!< dma peripheral databus width 32bit */ } dma_peripheral_data_size_type; /** * @brief dma memory data size type */ typedef enum { DMA_MEMORY_DATA_WIDTH_BYTE = 0x00, /*!< dma memory databus width 8bit */ DMA_MEMORY_DATA_WIDTH_HALFWORD = 0x01, /*!< dma memory databus width 16bit */ DMA_MEMORY_DATA_WIDTH_WORD = 0x02 /*!< dma memory databus width 32bit */ } dma_memory_data_size_type; /** * @brief dma priority level type */ typedef enum { DMA_PRIORITY_LOW = 0x00, /*!< dma channel priority: low */ DMA_PRIORITY_MEDIUM = 0x01, /*!< dma channel priority: mediue */ DMA_PRIORITY_HIGH = 0x02, /*!< dma channel priority: high */ DMA_PRIORITY_VERY_HIGH = 0x03 /*!< dma channel priority: very high */ } dma_priority_level_type; /** * @brief dma init type */ typedef struct { uint32_t peripheral_base_addr; /*!< base addrress for peripheral */ uint32_t memory_base_addr; /*!< base addrress for memory */ dma_dir_type direction; /*!< dma transmit direction, peripheral as source or as destnation */ uint16_t buffer_size; /*!< counter to transfer */ confirm_state peripheral_inc_enable; /*!< periphera address increment after one transmit */ confirm_state memory_inc_enable; /*!< memory address increment after one transmit */ dma_peripheral_data_size_type peripheral_data_width; /*!< peripheral data width for transmit */ dma_memory_data_size_type memory_data_width; /*!< memory data width for transmit */ confirm_state loop_mode_enable; /*!< when circular mode enable, buffer size will reload if count to 0 */ dma_priority_level_type priority; /*!< dma priority can choose from very high, high, dedium or low */ } dma_init_type; /** * @brief type define dma register */ typedef struct { /** * @brief dma sts register, offset:0x00 */ union { __IO uint32_t sts; struct { __IO uint32_t gf1 : 1; /* [0] */ __IO uint32_t fdtf1 : 1; /* [1] */ __IO uint32_t hdtf1 : 1; /* [2] */ __IO uint32_t dterrf1 : 1; /* [3] */ __IO uint32_t gf2 : 1; /* [4] */ __IO uint32_t fdtf2 : 1; /* [5] */ __IO uint32_t hdtf2 : 1; /* [6] */ __IO uint32_t dterrf2 : 1; /* [7] */ __IO uint32_t gf3 : 1; /* [8] */ __IO uint32_t fdtf3 : 1; /* [9] */ __IO uint32_t hdtf3 : 1; /* [10] */ __IO uint32_t dterrf3 : 1; /* [11] */ __IO uint32_t gf4 : 1; /* [12] */ __IO uint32_t fdtf4 : 1; /* [13] */ __IO uint32_t hdtf4 : 1; /* [14] */ __IO uint32_t dterrf4 : 1; /* [15] */ __IO uint32_t gf5 : 1; /* [16] */ __IO uint32_t fdtf5 : 1; /* [17] */ __IO uint32_t hdtf5 : 1; /* [18] */ __IO uint32_t dterrf5 : 1; /* [19] */ __IO uint32_t reserved1 : 12; /* [31:20] */ } sts_bit; }; /** * @brief dma clr register, offset:0x04 */ union { __IO uint32_t clr; struct { __IO uint32_t gfc1 : 1; /* [0] */ __IO uint32_t fdtfc1 : 1; /* [1] */ __IO uint32_t hdtfc1 : 1; /* [2] */ __IO uint32_t dterrfc1 : 1; /* [3] */ __IO uint32_t gfc2 : 1; /* [4] */ __IO uint32_t fdtfc2 : 1; /* [5] */ __IO uint32_t hdtfc2 : 1; /* [6] */ __IO uint32_t dterrfc2 : 1; /* [7] */ __IO uint32_t gfc3 : 1; /* [8] */ __IO uint32_t fdtfc3 : 1; /* [9] */ __IO uint32_t hdtfc3 : 1; /* [10] */ __IO uint32_t dterrfc3 : 1; /* [11] */ __IO uint32_t gfc4 : 1; /* [12] */ __IO uint32_t fdtfc4 : 1; /* [13] */ __IO uint32_t hdtfc4 : 1; /* [14] */ __IO uint32_t dterrfc4 : 1; /* [15] */ __IO uint32_t gfc5 : 1; /* [16] */ __IO uint32_t fdtfc5 : 1; /* [17] */ __IO uint32_t hdtfc5 : 1; /* [18] */ __IO uint32_t dterrfc5 : 1; /* [19] */ __IO uint32_t reserved1 : 12; /* [31:20] */ } clr_bit; }; } dma_type; /** * @brief type define dma channel register all */ typedef struct { /** * @brief dma ctrl register, offset:0x08+20*(x-1) x=1...5 */ union { __IO uint32_t ctrl; struct { __IO uint32_t chen : 1; /* [0] */ __IO uint32_t fdtien : 1; /* [1] */ __IO uint32_t hdtien : 1; /* [2] */ __IO uint32_t dterrien : 1; /* [3] */ __IO uint32_t dtd : 1; /* [4] */ __IO uint32_t lm : 1; /* [5] */ __IO uint32_t pincm : 1; /* [6] */ __IO uint32_t mincm : 1; /* [7] */ __IO uint32_t pwidth : 2; /* [9:8] */ __IO uint32_t mwidth : 2; /* [11:10] */ __IO uint32_t chpl : 2; /* [13:12] */ __IO uint32_t m2m : 1; /* [14] */ __IO uint32_t reserved1 : 17;/* [31:15] */ } ctrl_bit; }; /** * @brief dma dtcnt register, offset:0x0C+20*(x-1) x=1...5 */ union { __IO uint32_t dtcnt; struct { __IO uint32_t cnt : 16;/* [15:0] */ __IO uint32_t reserved1 : 16;/* [31:16] */ } dtcnt_bit; }; /** * @brief dma cpba register, offset:0x10+20*(x-1) x=1...5 */ union { __IO uint32_t paddr; struct { __IO uint32_t paddr : 32;/* [31:0] */ } paddr_bit; }; /** * @brief dma cmba register, offset:0x14+20*(x-1) x=1...5 */ union { __IO uint32_t maddr; struct { __IO uint32_t maddr : 32;/* [31:0] */ } maddr_bit; }; } dma_channel_type; /** * @} */ #define DMA1 ((dma_type *) DMA1_BASE) #define DMA1_CHANNEL1 ((dma_channel_type *) DMA1_CHANNEL1_BASE) #define DMA1_CHANNEL2 ((dma_channel_type *) DMA1_CHANNEL2_BASE) #define DMA1_CHANNEL3 ((dma_channel_type *) DMA1_CHANNEL3_BASE) #define DMA1_CHANNEL4 ((dma_channel_type *) DMA1_CHANNEL4_BASE) #define DMA1_CHANNEL5 ((dma_channel_type *) DMA1_CHANNEL5_BASE) /** @defgroup DMA_exported_functions * @{ */ void dma_reset(dma_channel_type* dmax_channely); void dma_data_number_set(dma_channel_type* dmax_channely, uint16_t data_number); uint16_t dma_data_number_get(dma_channel_type* dmax_channely); void dma_interrupt_enable(dma_channel_type* dmax_channely, uint32_t dma_int, confirm_state new_state); void dma_channel_enable(dma_channel_type* dmax_channely, confirm_state new_state); flag_status dma_flag_get(uint32_t dmax_flag); void dma_flag_clear(uint32_t dmax_flag); void dma_default_para_init(dma_init_type* dma_init_struct); void dma_init(dma_channel_type* dmax_channely, dma_init_type* dma_init_struct); /** * @} */ /** * @} */ /** * @} */ #ifdef __cplusplus } #endif #endif