mbed - my fork

Users » filartrix » Code » mbed

my fork

TARGET_NUCLEO_F401RE/stm32f4xx_hal_dma2d.h@85:024bf7f99721, 2014-06-11 (annotated)

Committer:: bogdanm
Date:: Wed Jun 11 15:14:05 2014 +0100
Revision:: 85:024bf7f99721
Parent:: 81:7d30d6019079
Child:: 90:cb3d968589d8

Release 85 of the mbed library



Main changes:



- K64F Ethernet fixes

- Updated tests

- Fixes for various mbed targets

- Code cleanup: fixed warnings, more consistent code style

- GCC support for K64F



There is a known issue with the I2C interface on some ST targets. If you

find the I2C interface problematic on your ST board, please log a bug

against this on mbed.org.

Who changed what in which revision?

User	Revision	Line number	New contents of line
emilmont	77:869cf507173a	1	/**
emilmont	77:869cf507173a	2	******************************************************************************
emilmont	77:869cf507173a	3	* @file stm32f4xx_hal_dma2d.h
emilmont	77:869cf507173a	4	* @author MCD Application Team
bogdanm	85:024bf7f99721	5	* @version V1.1.0RC2
bogdanm	85:024bf7f99721	6	* @date 14-May-2014
emilmont	77:869cf507173a	7	* @brief Header file of DMA2D HAL module.
emilmont	77:869cf507173a	8	******************************************************************************
emilmont	77:869cf507173a	9	* @attention
emilmont	77:869cf507173a	10	*
emilmont	77:869cf507173a	11	* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
emilmont	77:869cf507173a	12	*
emilmont	77:869cf507173a	13	* Redistribution and use in source and binary forms, with or without modification,
emilmont	77:869cf507173a	14	* are permitted provided that the following conditions are met:
emilmont	77:869cf507173a	15	* 1. Redistributions of source code must retain the above copyright notice,
emilmont	77:869cf507173a	16	* this list of conditions and the following disclaimer.
emilmont	77:869cf507173a	17	* 2. Redistributions in binary form must reproduce the above copyright notice,
emilmont	77:869cf507173a	18	* this list of conditions and the following disclaimer in the documentation
emilmont	77:869cf507173a	19	* and/or other materials provided with the distribution.
emilmont	77:869cf507173a	20	* 3. Neither the name of STMicroelectronics nor the names of its contributors
emilmont	77:869cf507173a	21	* may be used to endorse or promote products derived from this software
emilmont	77:869cf507173a	22	* without specific prior written permission.
emilmont	77:869cf507173a	23	*
emilmont	77:869cf507173a	24	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
emilmont	77:869cf507173a	25	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
emilmont	77:869cf507173a	26	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
emilmont	77:869cf507173a	27	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
emilmont	77:869cf507173a	28	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
emilmont	77:869cf507173a	29	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
emilmont	77:869cf507173a	30	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
emilmont	77:869cf507173a	31	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
emilmont	77:869cf507173a	32	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
emilmont	77:869cf507173a	33	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
emilmont	77:869cf507173a	34	*
emilmont	77:869cf507173a	35	******************************************************************************
emilmont	77:869cf507173a	36	*/
emilmont	77:869cf507173a	37
emilmont	77:869cf507173a	38	/* Define to prevent recursive inclusion -------------------------------------*/
emilmont	77:869cf507173a	39	#ifndef __STM32F4xx_HAL_DMA2D_H
emilmont	77:869cf507173a	40	#define __STM32F4xx_HAL_DMA2D_H
emilmont	77:869cf507173a	41
emilmont	77:869cf507173a	42	#ifdef __cplusplus
emilmont	77:869cf507173a	43	extern "C" {
emilmont	77:869cf507173a	44	#endif
emilmont	77:869cf507173a	45
bogdanm	81:7d30d6019079	46	#if defined(STM32F427xx) \|\| defined(STM32F437xx) \|\| defined(STM32F429xx) \|\| defined(STM32F439xx)
emilmont	77:869cf507173a	47	/* Includes ------------------------------------------------------------------*/
emilmont	77:869cf507173a	48	#include "stm32f4xx_hal_def.h"
emilmont	77:869cf507173a	49
emilmont	77:869cf507173a	50	/** @addtogroup STM32F4xx_HAL_Driver
emilmont	77:869cf507173a	51	* @{
emilmont	77:869cf507173a	52	*/
emilmont	77:869cf507173a	53
emilmont	77:869cf507173a	54	/** @addtogroup DMA2D
emilmont	77:869cf507173a	55	* @{
emilmont	77:869cf507173a	56	*/
emilmont	77:869cf507173a	57
emilmont	77:869cf507173a	58	/* Exported types ------------------------------------------------------------*/
emilmont	77:869cf507173a	59
emilmont	77:869cf507173a	60	#define MAX_DMA2D_LAYER 2
bogdanm	85:024bf7f99721	61
emilmont	77:869cf507173a	62	/**
bogdanm	85:024bf7f99721	63	* @brief DMA2D color Structure definition
emilmont	77:869cf507173a	64	*/
emilmont	77:869cf507173a	65	typedef struct
emilmont	77:869cf507173a	66	{
emilmont	77:869cf507173a	67	uint32_t Blue; /*!< Configures the blue value.
emilmont	77:869cf507173a	68	This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */
emilmont	77:869cf507173a	69
bogdanm	85:024bf7f99721	70	uint32_t Green; /*!< Configures the green value.
emilmont	77:869cf507173a	71	This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */
bogdanm	85:024bf7f99721	72
bogdanm	85:024bf7f99721	73	uint32_t Red; /*!< Configures the red value.
emilmont	77:869cf507173a	74	This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */
emilmont	77:869cf507173a	75	} DMA2D_ColorTypeDef;
emilmont	77:869cf507173a	76
emilmont	77:869cf507173a	77	/**
bogdanm	85:024bf7f99721	78	* @brief DMA2D CLUT Structure definition
emilmont	77:869cf507173a	79	*/
emilmont	77:869cf507173a	80	typedef struct
emilmont	77:869cf507173a	81	{
bogdanm	85:024bf7f99721	82	uint32_t pCLUT; /!< Configures the DMA2D CLUT memory address.*/
emilmont	77:869cf507173a	83
bogdanm	85:024bf7f99721	84	uint32_t CLUTColorMode; /*!< configures the DMA2D CLUT color mode.
emilmont	77:869cf507173a	85	This parameter can be one value of @ref DMA2D_CLUT_CM */
bogdanm	85:024bf7f99721	86
emilmont	77:869cf507173a	87	uint32_t Size; /*!< configures the DMA2D CLUT size.
bogdanm	85:024bf7f99721	88	This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF.*/
emilmont	77:869cf507173a	89	} DMA2D_CLUTCfgTypeDef;
emilmont	77:869cf507173a	90
emilmont	77:869cf507173a	91	/**
bogdanm	85:024bf7f99721	92	* @brief DMA2D Init structure definition
emilmont	77:869cf507173a	93	*/
emilmont	77:869cf507173a	94	typedef struct
emilmont	77:869cf507173a	95	{
emilmont	77:869cf507173a	96	uint32_t Mode; /*!< configures the DMA2D transfer mode.
emilmont	77:869cf507173a	97	This parameter can be one value of @ref DMA2D_Mode */
bogdanm	85:024bf7f99721	98
emilmont	77:869cf507173a	99	uint32_t ColorMode; /*!< configures the color format of the output image.
emilmont	77:869cf507173a	100	This parameter can be one value of @ref DMA2D_Color_Mode */
emilmont	77:869cf507173a	101
emilmont	77:869cf507173a	102	uint32_t OutputOffset; /*!< Specifies the Offset value.
emilmont	77:869cf507173a	103	This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0x3FFF. */
emilmont	77:869cf507173a	104	} DMA2D_InitTypeDef;
emilmont	77:869cf507173a	105
emilmont	77:869cf507173a	106	/**
bogdanm	85:024bf7f99721	107	* @brief DMA2D Layer structure definition
emilmont	77:869cf507173a	108	*/
emilmont	77:869cf507173a	109	typedef struct
emilmont	77:869cf507173a	110	{
emilmont	77:869cf507173a	111	uint32_t InputOffset; /*!< configures the DMA2D foreground offset.
emilmont	77:869cf507173a	112	This parameter must be a number between Min_Data = 0x0000 and Max_Data = 0x3FFF. */
emilmont	77:869cf507173a	113
emilmont	77:869cf507173a	114	uint32_t InputColorMode; /*!< configures the DMA2D foreground color mode .
emilmont	77:869cf507173a	115	This parameter can be one value of @ref DMA2D_Input_Color_Mode */
bogdanm	85:024bf7f99721	116
emilmont	77:869cf507173a	117	uint32_t AlphaMode; /*!< configures the DMA2D foreground alpha mode.
emilmont	77:869cf507173a	118	This parameter can be one value of @ref DMA2D_ALPHA_MODE */
emilmont	77:869cf507173a	119
bogdanm	85:024bf7f99721	120	uint32_t InputAlpha; /*!< Specifies the DMA2D foreground alpha value.
emilmont	77:869cf507173a	121	This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF. */
bogdanm	85:024bf7f99721	122
emilmont	77:869cf507173a	123	} DMA2D_LayerCfgTypeDef;
emilmont	77:869cf507173a	124
emilmont	77:869cf507173a	125	/**
bogdanm	85:024bf7f99721	126	* @brief HAL DMA2D State structures definition
bogdanm	85:024bf7f99721	127	*/
emilmont	77:869cf507173a	128	typedef enum
emilmont	77:869cf507173a	129	{
emilmont	77:869cf507173a	130	HAL_DMA2D_STATE_RESET = 0x00, /!< DMA2D not yet initialized or disabled /
emilmont	77:869cf507173a	131	HAL_DMA2D_STATE_READY = 0x01, /!< Peripheral Initialized and ready for use /
bogdanm	85:024bf7f99721	132	HAL_DMA2D_STATE_BUSY = 0x02, /!< an internal process is ongoing /
bogdanm	85:024bf7f99721	133	HAL_DMA2D_STATE_TIMEOUT = 0x03, /!< Timeout state /
emilmont	77:869cf507173a	134	HAL_DMA2D_STATE_ERROR = 0x04, /!< DMA2D state error /
emilmont	77:869cf507173a	135	HAL_DMA2D_STATE_SUSPEND = 0x05 /!< DMA2D process is suspended /
emilmont	77:869cf507173a	136	}HAL_DMA2D_StateTypeDef;
emilmont	77:869cf507173a	137
emilmont	77:869cf507173a	138	/**
bogdanm	85:024bf7f99721	139	* @brief DMA2D handle Structure definition
bogdanm	85:024bf7f99721	140	*/
emilmont	77:869cf507173a	141	typedef struct __DMA2D_HandleTypeDef
bogdanm	85:024bf7f99721	142	{
emilmont	77:869cf507173a	143	DMA2D_TypeDef Instance; /!< DMA2D Register base address */
bogdanm	85:024bf7f99721	144
emilmont	77:869cf507173a	145	DMA2D_InitTypeDef Init; /!< DMA2D communication parameters /
bogdanm	85:024bf7f99721	146
emilmont	77:869cf507173a	147	void (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d); /!< DMA2D transfer complete callback /
bogdanm	85:024bf7f99721	148
emilmont	77:869cf507173a	149	void (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d); /!< DMA2D transfer error callback /
bogdanm	85:024bf7f99721	150
emilmont	77:869cf507173a	151	DMA2D_LayerCfgTypeDef LayerCfg[MAX_DMA2D_LAYER]; /!< DMA2D Layers parameters /
bogdanm	85:024bf7f99721	152
emilmont	77:869cf507173a	153	HAL_LockTypeDef Lock; /!< DMA2D Lock /
bogdanm	85:024bf7f99721	154
emilmont	77:869cf507173a	155	__IO HAL_DMA2D_StateTypeDef State; /!< DMA2D transfer state /
bogdanm	85:024bf7f99721	156
emilmont	77:869cf507173a	157	__IO uint32_t ErrorCode; /!< DMA2D Error code /
bogdanm	85:024bf7f99721	158	} DMA2D_HandleTypeDef;
emilmont	77:869cf507173a	159
emilmont	77:869cf507173a	160
emilmont	77:869cf507173a	161	/* Exported constants --------------------------------------------------------*/
emilmont	77:869cf507173a	162
emilmont	77:869cf507173a	163	/** @defgroup DMA2D_Exported_Constants
emilmont	77:869cf507173a	164	* @{
bogdanm	85:024bf7f99721	165	*/
emilmont	77:869cf507173a	166
emilmont	77:869cf507173a	167	/** @defgroup DMA2D_Layer
emilmont	77:869cf507173a	168	* @{
emilmont	77:869cf507173a	169	*/
bogdanm	85:024bf7f99721	170	#define IS_DMA2D_LAYER(LAYER) ((LAYER) <= MAX_DMA2D_LAYER)
emilmont	77:869cf507173a	171	/**
emilmont	77:869cf507173a	172	* @}
emilmont	77:869cf507173a	173	*/
emilmont	77:869cf507173a	174
emilmont	77:869cf507173a	175	/** @defgroup DMA2D_Error_Code
emilmont	77:869cf507173a	176	* @{
emilmont	77:869cf507173a	177	*/
emilmont	77:869cf507173a	178	#define HAL_DMA2D_ERROR_NONE ((uint32_t)0x00000000) /!< No error /
emilmont	77:869cf507173a	179	#define HAL_DMA2D_ERROR_TE ((uint32_t)0x00000001) /!< Transfer error /
bogdanm	85:024bf7f99721	180	#define HAL_DMA2D_ERROR_CE ((uint32_t)0x00000002) /!< Configuration error /
emilmont	77:869cf507173a	181	#define HAL_DMA2D_ERROR_TIMEOUT ((uint32_t)0x00000020) /!< Timeout error /
emilmont	77:869cf507173a	182	/**
emilmont	77:869cf507173a	183	* @}
emilmont	77:869cf507173a	184	*/
bogdanm	85:024bf7f99721	185
emilmont	77:869cf507173a	186	/** @defgroup DMA2D_Mode
emilmont	77:869cf507173a	187	* @{
emilmont	77:869cf507173a	188	*/
emilmont	77:869cf507173a	189	#define DMA2D_M2M ((uint32_t)0x00000000) /!< DMA2D memory to memory transfer mode /
emilmont	77:869cf507173a	190	#define DMA2D_M2M_PFC ((uint32_t)0x00010000) /!< DMA2D memory to memory with pixel format conversion transfer mode /
emilmont	77:869cf507173a	191	#define DMA2D_M2M_BLEND ((uint32_t)0x00020000) /!< DMA2D memory to memory with blending transfer mode /
emilmont	77:869cf507173a	192	#define DMA2D_R2M ((uint32_t)0x00030000) /!< DMA2D register to memory transfer mode /
emilmont	77:869cf507173a	193
emilmont	77:869cf507173a	194	#define IS_DMA2D_MODE(MODE) (((MODE) == DMA2D_M2M) \|\| ((MODE) == DMA2D_M2M_PFC) \|\| \
emilmont	77:869cf507173a	195	((MODE) == DMA2D_M2M_BLEND) \|\| ((MODE) == DMA2D_R2M))
emilmont	77:869cf507173a	196	/**
emilmont	77:869cf507173a	197	* @}
bogdanm	85:024bf7f99721	198	*/
emilmont	77:869cf507173a	199
emilmont	77:869cf507173a	200	/** @defgroup DMA2D_Color_Mode
emilmont	77:869cf507173a	201	* @{
emilmont	77:869cf507173a	202	*/
emilmont	77:869cf507173a	203	#define DMA2D_ARGB8888 ((uint32_t)0x00000000) /!< ARGB8888 DMA2D color mode /
emilmont	77:869cf507173a	204	#define DMA2D_RGB888 ((uint32_t)0x00000001) /!< RGB888 DMA2D color mode /
emilmont	77:869cf507173a	205	#define DMA2D_RGB565 ((uint32_t)0x00000002) /!< RGB565 DMA2D color mode /
emilmont	77:869cf507173a	206	#define DMA2D_ARGB1555 ((uint32_t)0x00000003) /!< ARGB1555 DMA2D color mode /
emilmont	77:869cf507173a	207	#define DMA2D_ARGB4444 ((uint32_t)0x00000004) /!< ARGB4444 DMA2D color mode /
emilmont	77:869cf507173a	208
emilmont	77:869cf507173a	209	#define IS_DMA2D_CMODE(MODE_ARGB) (((MODE_ARGB) == DMA2D_ARGB8888) \|\| ((MODE_ARGB) == DMA2D_RGB888) \|\| \
emilmont	77:869cf507173a	210	((MODE_ARGB) == DMA2D_RGB565) \|\| ((MODE_ARGB) == DMA2D_ARGB1555) \|\| \
emilmont	77:869cf507173a	211	((MODE_ARGB) == DMA2D_ARGB4444))
emilmont	77:869cf507173a	212	/**
emilmont	77:869cf507173a	213	* @}
emilmont	77:869cf507173a	214	*/
emilmont	77:869cf507173a	215
emilmont	77:869cf507173a	216	/** @defgroup DMA2D_COLOR_VALUE
emilmont	77:869cf507173a	217	* @{
emilmont	77:869cf507173a	218	*/
emilmont	77:869cf507173a	219
emilmont	77:869cf507173a	220	#define COLOR_VALUE ((uint32_t)0x000000FF) /!< color value mask /
emilmont	77:869cf507173a	221
emilmont	77:869cf507173a	222	#define IS_DMA2D_ALPHA_VALUE(ALPHA_VALUE) ((ALPHA_VALUE) <= COLOR_VALUE)
emilmont	77:869cf507173a	223	#define IS_DMA2D_COLOR(COLOR) ((COLOR) <= COLOR_VALUE)
emilmont	77:869cf507173a	224	/**
emilmont	77:869cf507173a	225	* @}
emilmont	77:869cf507173a	226	*/
emilmont	77:869cf507173a	227
emilmont	77:869cf507173a	228	/** @defgroup DMA2D_SIZE
emilmont	77:869cf507173a	229	* @{
emilmont	77:869cf507173a	230	*/
emilmont	77:869cf507173a	231	#define DMA2D_PIXEL (DMA2D_NLR_PL >> 16) /!< DMA2D pixel per line /
emilmont	77:869cf507173a	232	#define DMA2D_LINE DMA2D_NLR_NL /!< DMA2D number of line /
emilmont	77:869cf507173a	233
emilmont	77:869cf507173a	234	#define IS_DMA2D_LINE(LINE) ((LINE) <= DMA2D_LINE)
emilmont	77:869cf507173a	235	#define IS_DMA2D_PIXEL(PIXEL) ((PIXEL) <= DMA2D_PIXEL)
emilmont	77:869cf507173a	236	/**
emilmont	77:869cf507173a	237	* @}
emilmont	77:869cf507173a	238	*/
emilmont	77:869cf507173a	239
bogdanm	85:024bf7f99721	240	/** @defgroup DMA2D_Offset
emilmont	77:869cf507173a	241	* @{
emilmont	77:869cf507173a	242	*/
emilmont	77:869cf507173a	243	#define DMA2D_OFFSET DMA2D_FGOR_LO /!< Line Offset /
emilmont	77:869cf507173a	244
emilmont	77:869cf507173a	245	#define IS_DMA2D_OFFSET(OOFFSET) ((OOFFSET) <= DMA2D_OFFSET)
emilmont	77:869cf507173a	246	/**
emilmont	77:869cf507173a	247	* @}
emilmont	77:869cf507173a	248	*/
emilmont	77:869cf507173a	249
emilmont	77:869cf507173a	250	/** @defgroup DMA2D_Input_Color_Mode
emilmont	77:869cf507173a	251	* @{
emilmont	77:869cf507173a	252	*/
emilmont	77:869cf507173a	253	#define CM_ARGB8888 ((uint32_t)0x00000000) /!< ARGB8888 color mode /
emilmont	77:869cf507173a	254	#define CM_RGB888 ((uint32_t)0x00000001) /!< RGB888 color mode /
emilmont	77:869cf507173a	255	#define CM_RGB565 ((uint32_t)0x00000002) /!< RGB565 color mode /
emilmont	77:869cf507173a	256	#define CM_ARGB1555 ((uint32_t)0x00000003) /!< ARGB1555 color mode /
emilmont	77:869cf507173a	257	#define CM_ARGB4444 ((uint32_t)0x00000004) /!< ARGB4444 color mode /
emilmont	77:869cf507173a	258	#define CM_L8 ((uint32_t)0x00000005) /!< L8 color mode /
emilmont	77:869cf507173a	259	#define CM_AL44 ((uint32_t)0x00000006) /!< AL44 color mode /
emilmont	77:869cf507173a	260	#define CM_AL88 ((uint32_t)0x00000007) /!< AL88 color mode /
emilmont	77:869cf507173a	261	#define CM_L4 ((uint32_t)0x00000008) /!< L4 color mode /
emilmont	77:869cf507173a	262	#define CM_A8 ((uint32_t)0x00000009) /!< A8 color mode /
emilmont	77:869cf507173a	263	#define CM_A4 ((uint32_t)0x0000000A) /!< A4 color mode /
emilmont	77:869cf507173a	264
emilmont	77:869cf507173a	265	#define IS_DMA2D_INPUT_COLOR_MODE(INPUT_CM) (((INPUT_CM) == CM_ARGB8888) \|\| ((INPUT_CM) == CM_RGB888) \|\| \
emilmont	77:869cf507173a	266	((INPUT_CM) == CM_RGB565) \|\| ((INPUT_CM) == CM_ARGB1555) \|\| \
emilmont	77:869cf507173a	267	((INPUT_CM) == CM_ARGB4444) \|\| ((INPUT_CM) == CM_L8) \|\| \
emilmont	77:869cf507173a	268	((INPUT_CM) == CM_AL44) \|\| ((INPUT_CM) == CM_AL88) \|\| \
emilmont	77:869cf507173a	269	((INPUT_CM) == CM_L4) \|\| ((INPUT_CM) == CM_A8) \|\| \
emilmont	77:869cf507173a	270	((INPUT_CM) == CM_A4))
emilmont	77:869cf507173a	271	/**
emilmont	77:869cf507173a	272	* @}
emilmont	77:869cf507173a	273	*/
emilmont	77:869cf507173a	274
emilmont	77:869cf507173a	275	/** @defgroup DMA2D_ALPHA_MODE
emilmont	77:869cf507173a	276	* @{
emilmont	77:869cf507173a	277	*/
emilmont	77:869cf507173a	278	#define DMA2D_NO_MODIF_ALPHA ((uint32_t)0x00000000) /!< No modification of the alpha channel value /
emilmont	77:869cf507173a	279	#define DMA2D_REPLACE_ALPHA ((uint32_t)0x00000001) /!< Replace original alpha channel value by programmed alpha value /
emilmont	77:869cf507173a	280	#define DMA2D_COMBINE_ALPHA ((uint32_t)0x00000002) /*!< Replace original alpha channel value by programmed alpha value
emilmont	77:869cf507173a	281	with original alpha channel value */
emilmont	77:869cf507173a	282
emilmont	77:869cf507173a	283	#define IS_DMA2D_ALPHA_MODE(AlphaMode) (((AlphaMode) == DMA2D_NO_MODIF_ALPHA) \|\| \
emilmont	77:869cf507173a	284	((AlphaMode) == DMA2D_REPLACE_ALPHA) \|\| \
emilmont	77:869cf507173a	285	((AlphaMode) == DMA2D_COMBINE_ALPHA))
emilmont	77:869cf507173a	286	/**
emilmont	77:869cf507173a	287	* @}
emilmont	77:869cf507173a	288	*/
emilmont	77:869cf507173a	289
emilmont	77:869cf507173a	290	/** @defgroup DMA2D_CLUT_CM
emilmont	77:869cf507173a	291	* @{
emilmont	77:869cf507173a	292	*/
emilmont	77:869cf507173a	293	#define DMA2D_CCM_ARGB8888 ((uint32_t)0x00000000) /!< ARGB8888 DMA2D C-LUT color mode /
emilmont	77:869cf507173a	294	#define DMA2D_CCM_RGB888 ((uint32_t)0x00000001) /!< RGB888 DMA2D C-LUT color mode /
emilmont	77:869cf507173a	295
emilmont	77:869cf507173a	296	#define IS_DMA2D_CLUT_CM(CLUT_CM) (((CLUT_CM) == DMA2D_CCM_ARGB8888) \|\| ((CLUT_CM) == DMA2D_CCM_RGB888))
emilmont	77:869cf507173a	297	/**
emilmont	77:869cf507173a	298	* @}
emilmont	77:869cf507173a	299	*/
emilmont	77:869cf507173a	300
bogdanm	85:024bf7f99721	301	/** @defgroup DMA2D_Size_Clut
emilmont	77:869cf507173a	302	* @{
emilmont	77:869cf507173a	303	*/
emilmont	77:869cf507173a	304	#define DMA2D_CLUT_SIZE (DMA2D_FGPFCCR_CS >> 8) /!< DMA2D C-LUT size /
emilmont	77:869cf507173a	305
emilmont	77:869cf507173a	306	#define IS_DMA2D_CLUT_SIZE(CLUT_SIZE) ((CLUT_SIZE) <= DMA2D_CLUT_SIZE)
emilmont	77:869cf507173a	307	/**
emilmont	77:869cf507173a	308	* @}
emilmont	77:869cf507173a	309	*/
emilmont	77:869cf507173a	310
emilmont	77:869cf507173a	311	/** @defgroup DMA2D_DeadTime
emilmont	77:869cf507173a	312	* @{
emilmont	77:869cf507173a	313	*/
emilmont	77:869cf507173a	314	#define LINE_WATERMARK DMA2D_LWR_LW
emilmont	77:869cf507173a	315
emilmont	77:869cf507173a	316	#define IS_DMA2D_LineWatermark(LineWatermark) ((LineWatermark) <= LINE_WATERMARK)
emilmont	77:869cf507173a	317	/**
emilmont	77:869cf507173a	318	* @}
bogdanm	85:024bf7f99721	319	*/
bogdanm	85:024bf7f99721	320
emilmont	77:869cf507173a	321	/** @defgroup DMA2D_Interrupts
emilmont	77:869cf507173a	322	* @{
emilmont	77:869cf507173a	323	*/
emilmont	77:869cf507173a	324	#define DMA2D_IT_CE DMA2D_CR_CEIE /!< Configuration Error Interrupt /
emilmont	77:869cf507173a	325	#define DMA2D_IT_CTC DMA2D_CR_CTCIE /!< C-LUT Transfer Complete Interrupt /
emilmont	77:869cf507173a	326	#define DMA2D_IT_CAE DMA2D_CR_CAEIE /!< C-LUT Access Error Interrupt /
emilmont	77:869cf507173a	327	#define DMA2D_IT_TW DMA2D_CR_TWIE /!< Transfer Watermark Interrupt /
emilmont	77:869cf507173a	328	#define DMA2D_IT_TC DMA2D_CR_TCIE /!< Transfer Complete Interrupt /
emilmont	77:869cf507173a	329	#define DMA2D_IT_TE DMA2D_CR_TEIE /!< Transfer Error Interrupt /
emilmont	77:869cf507173a	330
emilmont	77:869cf507173a	331	#define IS_DMA2D_IT(IT) (((IT) == DMA2D_IT_CTC) \|\| ((IT) == DMA2D_IT_CAE) \|\| \
emilmont	77:869cf507173a	332	((IT) == DMA2D_IT_TW) \|\| ((IT) == DMA2D_IT_TC) \|\| \
emilmont	77:869cf507173a	333	((IT) == DMA2D_IT_TE) \|\| ((IT) == DMA2D_IT_CE))
emilmont	77:869cf507173a	334	/**
emilmont	77:869cf507173a	335	* @}
emilmont	77:869cf507173a	336	*/
bogdanm	85:024bf7f99721	337
emilmont	77:869cf507173a	338	/** @defgroup DMA2D_Flag
emilmont	77:869cf507173a	339	* @{
emilmont	77:869cf507173a	340	*/
emilmont	77:869cf507173a	341	#define DMA2D_FLAG_CE DMA2D_ISR_CEIF /!< Configuration Error Interrupt Flag /
emilmont	77:869cf507173a	342	#define DMA2D_FLAG_CTC DMA2D_ISR_CTCIF /!< C-LUT Transfer Complete Interrupt Flag /
emilmont	77:869cf507173a	343	#define DMA2D_FLAG_CAE DMA2D_ISR_CAEIF /!< C-LUT Access Error Interrupt Flag /
emilmont	77:869cf507173a	344	#define DMA2D_FLAG_TW DMA2D_ISR_TWIF /!< Transfer Watermark Interrupt Flag /
emilmont	77:869cf507173a	345	#define DMA2D_FLAG_TC DMA2D_ISR_TCIF /!< Transfer Complete Interrupt Flag /
emilmont	77:869cf507173a	346	#define DMA2D_FLAG_TE DMA2D_ISR_TEIF /!< Transfer Error Interrupt Flag /
emilmont	77:869cf507173a	347
emilmont	77:869cf507173a	348	#define IS_DMA2D_GET_FLAG(FLAG) (((FLAG) == DMA2D_FLAG_CTC) \|\| ((FLAG) == DMA2D_FLAG_CAE) \|\| \
emilmont	77:869cf507173a	349	((FLAG) == DMA2D_FLAG_TW) \|\| ((FLAG) == DMA2D_FLAG_TC) \|\| \
emilmont	77:869cf507173a	350	((FLAG) == DMA2D_FLAG_TE) \|\| ((FLAG) == DMA2D_FLAG_CE))
emilmont	77:869cf507173a	351	/**
emilmont	77:869cf507173a	352	* @}
emilmont	77:869cf507173a	353	*/
emilmont	77:869cf507173a	354
emilmont	77:869cf507173a	355	/**
emilmont	77:869cf507173a	356	* @}
emilmont	77:869cf507173a	357	*/
emilmont	77:869cf507173a	358	/* Exported macro ------------------------------------------------------------*/
bogdanm	85:024bf7f99721	359
bogdanm	85:024bf7f99721	360	/** @brief Reset DMA2D handle state
bogdanm	85:024bf7f99721	361	* @param __HANDLE__: specifies the DMA2D handle.
bogdanm	85:024bf7f99721	362	* @retval None
bogdanm	85:024bf7f99721	363	*/
bogdanm	85:024bf7f99721	364	#define __HAL_DMA2D_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_DMA2D_STATE_RESET)
bogdanm	85:024bf7f99721	365
emilmont	77:869cf507173a	366	/**
emilmont	77:869cf507173a	367	* @brief Enable the DMA2D.
emilmont	77:869cf507173a	368	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	369	* @retval None.
emilmont	77:869cf507173a	370	*/
emilmont	77:869cf507173a	371	#define __HAL_DMA2D_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR \|= DMA2D_CR_START)
emilmont	77:869cf507173a	372
emilmont	77:869cf507173a	373	/**
emilmont	77:869cf507173a	374	* @brief Disable the DMA2D.
emilmont	77:869cf507173a	375	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	376	* @retval None.
emilmont	77:869cf507173a	377	*/
emilmont	77:869cf507173a	378	#define __HAL_DMA2D_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~DMA2D_CR_START)
emilmont	77:869cf507173a	379
emilmont	77:869cf507173a	380	/* Interrupt & Flag management */
emilmont	77:869cf507173a	381	/**
emilmont	77:869cf507173a	382	* @brief Get the DMA2D pending flags.
emilmont	77:869cf507173a	383	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	384	* @param __FLAG__: Get the specified flag.
emilmont	77:869cf507173a	385	* This parameter can be any combination of the following values:
emilmont	77:869cf507173a	386	* @arg DMA2D_FLAG_CE: Configuration error flag
emilmont	77:869cf507173a	387	* @arg DMA2D_FLAG_CTC: C-LUT transfer complete flag
emilmont	77:869cf507173a	388	* @arg DMA2D_FLAG_CAE: C-LUT access error flag
emilmont	77:869cf507173a	389	* @arg DMA2D_FLAG_TW: Transfer Watermark flag
emilmont	77:869cf507173a	390	* @arg DMA2D_FLAG_TC: Transfer complete flag
emilmont	77:869cf507173a	391	* @arg DMA2D_FLAG_TE: Transfer error flag
emilmont	77:869cf507173a	392	* @retval The state of FLAG.
emilmont	77:869cf507173a	393	*/
emilmont	77:869cf507173a	394	#define __HAL_DMA2D_GET_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR & (__FLAG__))
emilmont	77:869cf507173a	395
emilmont	77:869cf507173a	396	/**
emilmont	77:869cf507173a	397	* @brief Clears the DMA2D pending flags.
emilmont	77:869cf507173a	398	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	399	* @param __FLAG__: specifies the flag to clear.
emilmont	77:869cf507173a	400	* This parameter can be any combination of the following values:
emilmont	77:869cf507173a	401	* @arg DMA2D_FLAG_CE: Configuration error flag
emilmont	77:869cf507173a	402	* @arg DMA2D_FLAG_CTC: C-LUT transfer complete flag
emilmont	77:869cf507173a	403	* @arg DMA2D_FLAG_CAE: C-LUT access error flag
emilmont	77:869cf507173a	404	* @arg DMA2D_FLAG_TW: Transfer Watermark flag
emilmont	77:869cf507173a	405	* @arg DMA2D_FLAG_TC: Transfer complete flag
emilmont	77:869cf507173a	406	* @arg DMA2D_FLAG_TE: Transfer error flag
emilmont	77:869cf507173a	407	* @retval None
emilmont	77:869cf507173a	408	*/
emilmont	77:869cf507173a	409	#define __HAL_DMA2D_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->IFCR \|= (__FLAG__))
emilmont	77:869cf507173a	410
emilmont	77:869cf507173a	411	/**
emilmont	77:869cf507173a	412	* @brief Enables the specified DMA2D interrupts.
emilmont	77:869cf507173a	413	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	414	* @param __INTERRUPT__: specifies the DMA2D interrupt sources to be enabled.
emilmont	77:869cf507173a	415	* This parameter can be any combination of the following values:
emilmont	77:869cf507173a	416	* @arg DMA2D_IT_CE: Configuration error interrupt mask
emilmont	77:869cf507173a	417	* @arg DMA2D_IT_CTC: C-LUT transfer complete interrupt mask
emilmont	77:869cf507173a	418	* @arg DMA2D_IT_CAE: C-LUT access error interrupt mask
emilmont	77:869cf507173a	419	* @arg DMA2D_IT_TW: Transfer Watermark interrupt mask
emilmont	77:869cf507173a	420	* @arg DMA2D_IT_TC: Transfer complete interrupt mask
emilmont	77:869cf507173a	421	* @arg DMA2D_IT_TE: Transfer error interrupt mask
emilmont	77:869cf507173a	422	* @retval None
emilmont	77:869cf507173a	423	*/
emilmont	77:869cf507173a	424	#define __HAL_DMA2D_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR \|= (__INTERRUPT__))
emilmont	77:869cf507173a	425
emilmont	77:869cf507173a	426	/**
emilmont	77:869cf507173a	427	* @brief Disables the specified DMA2D interrupts.
emilmont	77:869cf507173a	428	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	429	* @param __INTERRUPT__: specifies the DMA2D interrupt sources to be disabled.
emilmont	77:869cf507173a	430	* This parameter can be any combination of the following values:
emilmont	77:869cf507173a	431	* @arg DMA2D_IT_CE: Configuration error interrupt mask
emilmont	77:869cf507173a	432	* @arg DMA2D_IT_CTC: C-LUT transfer complete interrupt mask
emilmont	77:869cf507173a	433	* @arg DMA2D_IT_CAE: C-LUT access error interrupt mask
emilmont	77:869cf507173a	434	* @arg DMA2D_IT_TW: Transfer Watermark interrupt mask
emilmont	77:869cf507173a	435	* @arg DMA2D_IT_TC: Transfer complete interrupt mask
emilmont	77:869cf507173a	436	* @arg DMA2D_IT_TE: Transfer error interrupt mask
emilmont	77:869cf507173a	437	* @retval None
emilmont	77:869cf507173a	438	*/
emilmont	77:869cf507173a	439	#define __HAL_DMA2D_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__))
emilmont	77:869cf507173a	440
emilmont	77:869cf507173a	441	/**
emilmont	77:869cf507173a	442	* @brief Checks whether the specified DMA2D interrupt has occurred or not.
emilmont	77:869cf507173a	443	* @param __HANDLE__: DMA2D handle
emilmont	77:869cf507173a	444	* @param __INTERRUPT__: specifies the DMA2D interrupt source to check.
emilmont	77:869cf507173a	445	* This parameter can be one of the following values:
emilmont	77:869cf507173a	446	* @arg DMA2D_IT_CE: Configuration error interrupt mask
emilmont	77:869cf507173a	447	* @arg DMA2D_IT_CTC: C-LUT transfer complete interrupt mask
emilmont	77:869cf507173a	448	* @arg DMA2D_IT_CAE: C-LUT access error interrupt mask
emilmont	77:869cf507173a	449	* @arg DMA2D_IT_TW: Transfer Watermark interrupt mask
emilmont	77:869cf507173a	450	* @arg DMA2D_IT_TC: Transfer complete interrupt mask
emilmont	77:869cf507173a	451	* @arg DMA2D_IT_TE: Transfer error interrupt mask
emilmont	77:869cf507173a	452	* @retval The state of INTERRUPT.
emilmont	77:869cf507173a	453	*/
bogdanm	81:7d30d6019079	454	#define __HAL_DMA2D_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR & (__INTERRUPT__))
emilmont	77:869cf507173a	455
emilmont	77:869cf507173a	456	/* Exported functions --------------------------------------------------------*/
emilmont	77:869cf507173a	457
emilmont	77:869cf507173a	458	/* Initialization and de-initialization functions *******************************/
emilmont	77:869cf507173a	459	HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	460	HAL_StatusTypeDef HAL_DMA2D_DeInit (DMA2D_HandleTypeDef *hdma2d);
bogdanm	81:7d30d6019079	461	void HAL_DMA2D_MspInit(DMA2D_HandleTypeDef* hdma2d);
bogdanm	81:7d30d6019079	462	void HAL_DMA2D_MspDeInit(DMA2D_HandleTypeDef* hdma2d);
emilmont	77:869cf507173a	463
emilmont	77:869cf507173a	464	/* IO operation functions *******************************************************/
emilmont	77:869cf507173a	465	HAL_StatusTypeDef HAL_DMA2D_Start(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width, uint32_t Heigh);
emilmont	77:869cf507173a	466	HAL_StatusTypeDef HAL_DMA2D_BlendingStart(DMA2D_HandleTypeDef *hdma2d, uint32_t SrcAddress1, uint32_t SrcAddress2, uint32_t DstAddress, uint32_t Width, uint32_t Heigh);
emilmont	77:869cf507173a	467	HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width, uint32_t Heigh);
emilmont	77:869cf507173a	468	HAL_StatusTypeDef HAL_DMA2D_BlendingStart_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t SrcAddress1, uint32_t SrcAddress2, uint32_t DstAddress, uint32_t Width, uint32_t Heigh);
emilmont	77:869cf507173a	469	HAL_StatusTypeDef HAL_DMA2D_Suspend(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	470	HAL_StatusTypeDef HAL_DMA2D_Resume(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	471	HAL_StatusTypeDef HAL_DMA2D_Abort(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	472	HAL_StatusTypeDef HAL_DMA2D_PollForTransfer(DMA2D_HandleTypeDef *hdma2d, uint32_t Timeout);
emilmont	77:869cf507173a	473	void HAL_DMA2D_IRQHandler(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	474
emilmont	77:869cf507173a	475	/* Peripheral Control functions *************************************************/
emilmont	77:869cf507173a	476	HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
emilmont	77:869cf507173a	477	HAL_StatusTypeDef HAL_DMA2D_ConfigCLUT(DMA2D_HandleTypeDef *hdma2d, DMA2D_CLUTCfgTypeDef CLUTCfg, uint32_t LayerIdx);
emilmont	77:869cf507173a	478	HAL_StatusTypeDef HAL_DMA2D_EnableCLUT(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
emilmont	77:869cf507173a	479	HAL_StatusTypeDef HAL_DMA2D_DisableCLUT(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx);
emilmont	77:869cf507173a	480	HAL_StatusTypeDef HAL_DMA2D_ProgramLineEvent(DMA2D_HandleTypeDef *hdma2d, uint32_t Line);
emilmont	77:869cf507173a	481
emilmont	77:869cf507173a	482	/* Peripheral State functions ***************************************************/
emilmont	77:869cf507173a	483	HAL_DMA2D_StateTypeDef HAL_DMA2D_GetState(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	484	uint32_t HAL_DMA2D_GetError(DMA2D_HandleTypeDef *hdma2d);
emilmont	77:869cf507173a	485
bogdanm	81:7d30d6019079	486	#endif /* STM32F427xx \|\| STM32F437xx \|\| STM32F429xx \|\| STM32F439xx */
emilmont	77:869cf507173a	487
emilmont	77:869cf507173a	488	/**
emilmont	77:869cf507173a	489	* @}
emilmont	77:869cf507173a	490	*/
emilmont	77:869cf507173a	491
emilmont	77:869cf507173a	492	/**
emilmont	77:869cf507173a	493	* @}
emilmont	77:869cf507173a	494	*/
emilmont	77:869cf507173a	495
emilmont	77:869cf507173a	496	#ifdef __cplusplus
emilmont	77:869cf507173a	497	}
emilmont	77:869cf507173a	498	#endif
emilmont	77:869cf507173a	499
emilmont	77:869cf507173a	500	#endif /* __STM32F4xx_HAL_DMA2D_H */
emilmont	77:869cf507173a	501
emilmont	77:869cf507173a	502
emilmont	77:869cf507173a	503	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	08 Apr 2015
Imports:	2
Forks:	0
Commits:	98
Dependents:	1
Dependencies:	0
Followers:	1

TARGET_NUCLEO_F401RE/stm32f4xx_hal_dma2d.h@85:024bf7f99721, 2014-06-11 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning