stm32f30x_dma.c File Reference

This file provides firmware functions to manage the following functionalities of the Direct Memory Access controller (DMA): More...

#include "stm32f30x_dma.h"

Include dependency graph for stm32f30x_dma.c:

Go to the source code of this file.

Macros
#define	CCR_CLEAR_MASK   ((uint32_t)0xFFFF800F) /* DMA Channel config registers Masks */
#define	DMA1_CHANNEL1_IT_MASK   ((uint32_t)(DMA_ISR_GIF1 | DMA_ISR_TCIF1 | DMA_ISR_HTIF1 | DMA_ISR_TEIF1))
#define	DMA1_CHANNEL2_IT_MASK   ((uint32_t)(DMA_ISR_GIF2 | DMA_ISR_TCIF2 | DMA_ISR_HTIF2 | DMA_ISR_TEIF2))
#define	DMA1_CHANNEL3_IT_MASK   ((uint32_t)(DMA_ISR_GIF3 | DMA_ISR_TCIF3 | DMA_ISR_HTIF3 | DMA_ISR_TEIF3))
#define	DMA1_CHANNEL4_IT_MASK   ((uint32_t)(DMA_ISR_GIF4 | DMA_ISR_TCIF4 | DMA_ISR_HTIF4 | DMA_ISR_TEIF4))
#define	DMA1_CHANNEL5_IT_MASK   ((uint32_t)(DMA_ISR_GIF5 | DMA_ISR_TCIF5 | DMA_ISR_HTIF5 | DMA_ISR_TEIF5))
#define	DMA1_CHANNEL6_IT_MASK   ((uint32_t)(DMA_ISR_GIF6 | DMA_ISR_TCIF6 | DMA_ISR_HTIF6 | DMA_ISR_TEIF6))
#define	DMA1_CHANNEL7_IT_MASK   ((uint32_t)(DMA_ISR_GIF7 | DMA_ISR_TCIF7 | DMA_ISR_HTIF7 | DMA_ISR_TEIF7))
#define	DMA2_CHANNEL1_IT_MASK   ((uint32_t)(DMA_ISR_GIF1 | DMA_ISR_TCIF1 | DMA_ISR_HTIF1 | DMA_ISR_TEIF1))
#define	DMA2_CHANNEL2_IT_MASK   ((uint32_t)(DMA_ISR_GIF2 | DMA_ISR_TCIF2 | DMA_ISR_HTIF2 | DMA_ISR_TEIF2))
#define	DMA2_CHANNEL3_IT_MASK   ((uint32_t)(DMA_ISR_GIF3 | DMA_ISR_TCIF3 | DMA_ISR_HTIF3 | DMA_ISR_TEIF3))
#define	DMA2_CHANNEL4_IT_MASK   ((uint32_t)(DMA_ISR_GIF4 | DMA_ISR_TCIF4 | DMA_ISR_HTIF4 | DMA_ISR_TEIF4))
#define	DMA2_CHANNEL5_IT_MASK   ((uint32_t)(DMA_ISR_GIF5 | DMA_ISR_TCIF5 | DMA_ISR_HTIF5 | DMA_ISR_TEIF5))
#define	FLAG_Mask   ((uint32_t)0x10000000) /* DMA2 FLAG mask */

Functions
void	DMA_ClearFlag (uint32_t DMAy_FLAG)
	Clears the DMAy Channelx's pending flags. More...
void	DMA_ClearITPendingBit (uint32_t DMAy_IT)
	Clears the DMAy Channelx's interrupt pending bits. More...
void	DMA_Cmd (DMA_Channel_TypeDef *DMAy_Channelx, FunctionalState NewState)
	Enables or disables the specified DMAy Channelx. More...
void	DMA_DeInit (DMA_Channel_TypeDef *DMAy_Channelx)
	Deinitializes the DMAy Channelx registers to their default reset values. More...
uint16_t	DMA_GetCurrDataCounter (DMA_Channel_TypeDef *DMAy_Channelx)
	Returns the number of remaining data units in the current DMAy Channelx transfer. More...
FlagStatus	DMA_GetFlagStatus (uint32_t DMAy_FLAG)
	Checks whether the specified DMAy Channelx flag is set or not. More...
ITStatus	DMA_GetITStatus (uint32_t DMAy_IT)
	Checks whether the specified DMAy Channelx interrupt has occurred or not. More...
void	DMA_Init (DMA_Channel_TypeDef *DMAy_Channelx, DMA_InitTypeDef *DMA_InitStruct)
	Initializes the DMAy Channelx according to the specified parameters in the DMA_InitStruct. More...
void	DMA_ITConfig (DMA_Channel_TypeDef *DMAy_Channelx, uint32_t DMA_IT, FunctionalState NewState)
	Enables or disables the specified DMAy Channelx interrupts. More...
void	DMA_SetCurrDataCounter (DMA_Channel_TypeDef *DMAy_Channelx, uint16_t DataNumber)
	Sets the number of data units in the current DMAy Channelx transfer. More...
void	DMA_StructInit (DMA_InitTypeDef *DMA_InitStruct)
	Fills each DMA_InitStruct member with its default value. More...

Detailed Description

This file provides firmware functions to manage the following functionalities of the Direct Memory Access controller (DMA):

Author

MCD Application Team

Version

V1.1.1

Date

04-April-2014

• Initialization and Configuration
• Data Counter
• Interrupts and flags management

===============================================================================
                      ##### How to use this driver #####
===============================================================================
   [..]
   (#) Enable The DMA controller clock using 
       RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE) function for DMA1 or 
       using RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA2, ENABLE) function for DMA2.
   (#) Enable and configure the peripheral to be connected to the DMA channel
       (except for internal SRAM / FLASH memories: no initialization is necessary). 
   (#) For a given Channel, program the Source and Destination addresses,  
       the transfer Direction, the Buffer Size, the Peripheral and Memory
       Incrementation mode and Data Size, the Circular or Normal mode, 
       the channel transfer Priority and the Memory-to-Memory transfer 
       mode (if needed) using the DMA_Init() function.
   (#) Enable the NVIC and the corresponding interrupt(s) using the function 
       DMA_ITConfig() if you need to use DMA interrupts.
   (#) Enable the DMA channel using the DMA_Cmd() function.
   (#) Activate the needed channel Request using PPP_DMACmd() function for
       any PPP peripheral except internal SRAM and FLASH (ie. SPI, USART ...)
       The function allowing this operation is provided in each PPP peripheral
       driver (ie. SPI_DMACmd for SPI peripheral).
   (#) Optionally, you can configure the number of data to be transferred
       when the channel is disabled (ie. after each Transfer Complete event
       or when a Transfer Error occurs) using the function DMA_SetCurrDataCounter().
       And you can get the number of remaining data to be transferred using 
       the function DMA_GetCurrDataCounter() at run time (when the DMA channel is
       enabled and running).
   (#) To control DMA events you can use one of the following two methods:
       (##) Check on DMA channel flags using the function DMA_GetFlagStatus().
       (##) Use DMA interrupts through the function DMA_ITConfig() at initialization
            phase and DMA_GetITStatus() function into interrupt routines in
            communication phase.
            After checking on a flag you should clear it using DMA_ClearFlag()
            function. And after checking on an interrupt event you should 
            clear it using DMA_ClearITPendingBit() function.

Attention

© COPYRIGHT 2014 STMicroelectronics

Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); You may not use this file except in compliance with the License. You may obtain a copy of the License at:

   http://www.st.com/software_license_agreement_liberty_v2

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Definition in file stm32f30x_dma.c.