55.1 初学者重要提示
  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张。
  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
0 j! h. u  D2 z55.2 DMA2D基础知识
  k% S! Z+ f6 M" {DMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。

  DMA数据传输
主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。

/ @$ \( M6 [* {9 A6 M6 q  2D图形加速功能
支持硬件的颜色格式转换和Alpha混合效果。

9 T! ^2 X  }! B55.2.1 DMA2D硬件框图
认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

8 K3 {. k* }3 ^* A8 O

通过这个框图，我们可以得到如下信息：
3 M% m% F+ ]/ ]# i
7 C5 h" Q1 ]: f  dma2d_aclk
AXI 总线时钟输入。

  dma2d_gbl_it
DMA2D全局中断输出。

  dma2d_clut_trg
CLUT传输完成信号输出，可以触发MDMA。

" _! k& m/ k4 d  dma2d_tc_trg
传输完成信号输出，可以触发MDMA。
0 i* S4 }6 s& h& q6 i( B
3 h* x( L5 s2 D, k4 ?; G1 \  dma2d_tw_trg
3 `% S' g9 p8 e5 f. \6 w$ h, _传输watermark信号输出，可以触发MDMA。

8 o8 `1 i5 Y8 o/ g, M* U9 Y将这个硬件框图简化一下，就是下面这样：

下面按照简化的硬件框图，对每个部分做个说明。

55.2.2 DMA2D工作模式
8 W: ?2 |  l. N) f! b2 j1 aDMA2D支持的工作模式如下：
: C. b  b$ m7 O- h- R4 t/ F( i3 e
0 k: D0 u9 s  ^7 `. T' t6 `" y  模式1：寄存器到存储器模式
" D- q0 B) o. ]2 R# T: G! h- Q; d+ W这个模式主要用于清屏，也即是将显示屏清为单色效果。
3 f" r: j0 ^! \: Q. \
  模式2：存储器到存储器模式
8 P, n! t7 {8 K这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。

  模式3：存储器到存储器模式，带颜色格式转换
, F% M& |+ H# q! _: N$ B: M; k1 B这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。
' n7 F  e( ?0 w: n
( v  u9 \$ v2 H; C& h  模式4：存储器到存储器模式，带颜色格式转换和混合
1 B9 t1 a: ]* N; g1 E/ j8 H这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。

  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
同模式4，只是前景色的颜色值是固定的。

55.2.3 前景层和背景层的输入以及颜色格式转换
* G" z* c: h) b; J( X# k前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。
. A0 q' J- h( I& t2 ]9 }
$ G3 f9 w& Q2 u8 XDMA2D支持的输入颜色格式如下，前景层和背景层一样：

% s9 B) D  Y5 U. G

, p. S! |" x# l* u
# k: W( a* g  X2 m& G, M2 t$ h前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：
9 P2 X7 c0 @& t1 E9 n# C. c
" K5 X6 @- I! @- j3 d- E2 s( Z  L4 (4-bit luminance or CLUT)
4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。

  A4和A8
, u4 o7 p2 Y! ~1 hA4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。
( m# B/ A* m7 _8 y' K; M3 S9 E" Y. g
  YCbCr
- S& y/ ^# f" {8 s& g; a6 a这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。

这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
: A2 E& F( I8 x* a$ I: P
55.2.4 前景层和背景层混合
& c6 X1 N) W8 |' }DMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：
4 N0 L+ |* V6 ?1 U
. Z/ J. ]! Y6 o, c; T. g+ Y

0 j8 ]- j$ [* n) a55.2.5 DMA2D输出颜色格式
5 r/ [0 p2 U5 o# B) H. {$ bDMA2D支持的输出颜色格式如下：
! P$ X* g2 y. |' l2 d6 n1 i

2 S: b8 {1 y% @" T0 K2 ^
这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
" ]8 ^" z) J. L, j/ z
$ Y/ s+ [) [* q7 m; ~# \55.3 DMA2D的HAL库用法
DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。

55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
DMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：
9 L6 M& P1 Z8 X7 O6 }$ E

1. typedef struct
   
2. {
   6 p5 Q, j! O: g0 |: _9 D. I$ m; U
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   * A" T; {8 ^! G1 X9 i
4.   __IO uint32_t ISR;           /*!< DMA2D Interrupt Status Register,                Address offset: 0x04 */
   6 \3 I" ]- B1 o$ [4 O3 {: i
5.   __IO uint32_t IFCR;          /*!< DMA2D Interrupt Flag Clear Register,            Address offset: 0x08 */
   
6.   __IO uint32_t FGMAR;         /*!< DMA2D Foreground Memory Address Register,       Address offset: 0x0C */
   7 D2 y  B2 D, m0 u  A/ K
7.   __IO uint32_t FGOR;          /*!< DMA2D Foreground Offset Register,               Address offset: 0x10 */
   
8.   __IO uint32_t BGMAR;         /*!< DMA2D Background Memory Address Register,       Address offset: 0x14 */
   & z4 u% ^- a. O1 t4 t
9.   __IO uint32_t BGOR;          /*!< DMA2D Background Offset Register,               Address offset: 0x18 */
   
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
    
11.   __IO uint32_t FGCOLR;        /*!< DMA2D Foreground Color Register,                Address offset: 0x20 */
    9 G% E4 N* p0 E( @  J7 Y6 h1 ?
12.   __IO uint32_t BGPFCCR;       /*!< DMA2D Background PFC Control Register,          Address offset: 0x24 */
    
13.   __IO uint32_t BGCOLR;        /*!< DMA2D Background Color Register,                Address offset: 0x28 */
    
14.   __IO uint32_t FGCMAR;        /*!< DMA2D Foreground CLUT Memory Address Register,  Address offset: 0x2C */
    8 P( L& h, C2 W! s: D& ^( x
15.   __IO uint32_t BGCMAR;        /*!< DMA2D Background CLUT Memory Address Register,  Address offset: 0x30 */
      J* z' m! @; k5 s6 }/ X: b
16.   __IO uint32_t OPFCCR;        /*!< DMA2D Output PFC Control Register,              Address offset: 0x34 */
    
17.   __IO uint32_t OCOLR;         /*!< DMA2D Output Color Register,                    Address offset: 0x38 */
    
18.   __IO uint32_t OMAR;          /*!< DMA2D Output Memory Address Register,           Address offset: 0x3C */
    
19.   __IO uint32_t OOR;           /*!< DMA2D Output Offset Register,                   Address offset: 0x40 */
    
20.   __IO uint32_t NLR;           /*!< DMA2D Number of Line Register,                  Address offset: 0x44 */
    8 \# W% c/ }+ F  W7 [
21.   __IO uint32_t LWR;           /*!< DMA2D Line Watermark Register,                  Address offset: 0x48 */
    
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    ( n0 G3 R1 n0 p8 N$ Z, I
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    & X# T+ }; d  F9 R, P8 _8 U7 q  j
24.   __IO uint32_t FGCLUT[256];   /*!< DMA2D Foreground CLUT,                          Address offset:400-7FF */
    4 A, P! K% N: }( J2 O
25.   __IO uint32_t BGCLUT[256];   /*!< DMA2D Background CLUT,                          Address offset:800-BFF */
    
26. } DMA2D_TypeDef;
    - r& T3 c  @5 Y' e- m- N4 b

复制代码

) O: `  Z& N6 \% _8 X
8 I7 E/ L3 J) v) g__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：

, N! M. [2 c* e  Y

1. #define     __O     volatile             /*!< Defines 'write only' permissions */
   ) c, I) }8 P  L) z2 H
2. #define     __IO    volatile             /*!< Defines 'read / write' permissions */

复制代码

下面我们再看DMA2D的定义，在stm32h743xx.h文件。

1. #define PERIPH_BASE              ((uint32_t)0x40000000)
   ; ?- H0 N$ s& K3 l/ ?
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   ( Z) n8 Q' y, P- y" i3 o& V
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   " L: t7 e0 b8 \6 l
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000
   * R; Y9 J+ b1 ?) N) ^

复制代码

% X7 k# Q% c6 i3 I我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。

1 U. {3 `8 _, ~55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
6 r( J2 ]" v$ S. m! x+ R此结构体用于配置DMA2D的基本参数，具体定义如下：

1. typedef struct
   ; r' |& E+ Z% S! g* X5 r3 K0 M
2. {
   
3.   uint32_t             Mode;              
   8 @- d% @. j6 e/ A
4.   uint32_t             ColorMode;        
   
5.   uint32_t             OutputOffset;      
   
6.   uint32_t             AlphaInverted;   
   
7.   uint32_t             RedBlueSwap;      
   
8. } DMA2D_InitTypeDef;

复制代码

6 G9 X0 [$ g3 F4 n4 r! C; o下面将这几个参数逐一为大家做个说明：
/ {% R$ m5 p1 [$ Q# Y$ e+ `+ d
  uint32_t   Mode
此参数用于设置DMA2D的传输模式，具体支持的参数如下：
: ^7 \: U$ O* k
& l1 i" G. s" }

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   " }  Y9 r2 O- o4 Y5 u* y: n
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   ! `8 a& M8 i! q+ R$ A/ h* E( Z) }
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */

复制代码

+ n& ~( @* B. n" ?

  uint32_t   ColorMode
* \0 G4 D; w1 G3 S# T* N$ a0 k9 ?+ f' L% i此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：
6 Y4 @4 S2 r6 ?1 `! V

1. 
   
2. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   
3. #define DMA2D_OUTPUT_RGB888         DMA2D_OPFCCR_CM_0                     /* RGB888 */
   1 E3 _+ q9 r: S, a& l
4. #define DMA2D_OUTPUT_RGB565         DMA2D_OPFCCR_CM_1                     /* RGB565 */
   8 ^8 J9 X& _$ V8 H
5. #define DMA2D_OUTPUT_ARGB1555       (DMA2D_OPFCCR_CM_0|DMA2D_OPFCCR_CM_1) /* ARGB1555 */
   6 M( q! @+ P- I+ ?
6. #define DMA2D_OUTPUT_ARGB4444       DMA2D_OPFCCR_CM_2                     /* ARGB4444 */

复制代码

  uint32_t   OutputOffset
此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。
5 [) j( w  W! K" _' s; t
3 N6 W0 l) @5 v  L  uint32_t   AlphaInverted
此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   4 W& j" ^5 B! X6 ]% Q& v, y
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

6 s7 {6 s  ], }$ w# m  uint32_t   RedBlueSwap
此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */
   5 Z+ r* z7 c% |, m

复制代码

55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
此结构体用于配置前景色和背景色。

1. typedef struct
   . A, ?6 ~% u& m; ?
2. {
   & Y8 j. ]* Q! M/ a5 J
3.   uint32_t             InputOffset;      
   
4.   uint32_t             InputColorMode;   
   & H! Z- X! f7 \" E3 h# L6 n4 _
5.   uint32_t             AlphaMode;        
   8 r2 A% u% p4 s' }; ~7 t
6.   uint32_t             InputAlpha;        
   
7.   uint32_t             AlphaInverted;   
   ' b- c$ g. x) v) n# Q" h% a( \4 `
8.   uint32_t             RedBlueSwap;      
   
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

- B6 B; P7 |' h( d
) d/ A) _2 e& ^$ u1 P, g% Y
7 ?9 ?' W0 {: a5 j7 K( x, ]/ I- o下面将这几个参数逐一为大家做个说明。
7 A$ `( c* W. v% O( Y
  uint32_t  InputOffset
& ?6 ^" K- |* q" }6 T设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
+ F0 W, X$ y% {0 d$ Q6 _3 E" |
  uint32_t  InputColorMode
) G( M) v# b. X( |2 A5 x设置前景色或者背景色的输入颜色格式，具体支持的参数如下：
+ T8 [  i; m! y; m* s
  H9 v2 I4 A& g

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   
4. #define DMA2D_INPUT_ARGB1555        ((uint32_t)0x00000003U)  /* ARGB1555 */
   3 P: n- M8 @2 z; r" P2 k' e/ r
5. #define DMA2D_INPUT_ARGB4444        ((uint32_t)0x00000004U)  /* ARGB4444 */
   
6. #define DMA2D_INPUT_L8              ((uint32_t)0x00000005U)  /* L8       */
   / p& P" c! X" C( k  v
7. #define DMA2D_INPUT_AL44            ((uint32_t)0x00000006U)  /* AL44     */
   " W+ h+ j/ |: R/ |& j! I
8. #define DMA2D_INPUT_AL88            ((uint32_t)0x00000007U)  /* AL88     */
   5 r( c" N$ j% M+ v3 z# _7 F" K; u) D
9. #define DMA2D_INPUT_L4              ((uint32_t)0x00000008U)  /* L4       */
   
10. #define DMA2D_INPUT_A8              ((uint32_t)0x00000009U)  /* A8       */
    , j# ^! Z7 v; c. G: w. H
11. #define DMA2D_INPUT_A4              ((uint32_t)0x0000000AU)  /* A4       */
    
12. #define DMA2D_INPUT_YCBCR           ((uint32_t)0x0000000BU)  /* YCbCr    */
    ! @$ P; }- t# C( r7 @

复制代码

' b( P5 p: T  U5 R. O; g! I( V  uint32_t AlphaMode
设置前景色或者背景色的Alpha模式，具体支持的参数如下：

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

' c& p2 e# w! ]. R4 |

  uint32_t  InputAlpha
/ C2 y, l7 U: ^5 \# e设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。

  uint32_t AlphaInverted
设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   * X2 k2 a3 p6 g' c0 r+ K4 ?
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */     

复制代码

7 h. o" {# g3 F. X: l6 a: Q
" C) `2 f8 Y: a& k; @$ L0 f* o  uint32_t   RedBlueSwap
设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：

1. 
   # \2 Q! x1 n3 n0 d
2. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   
3. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */
   

复制代码

! L" S) a/ d% Q+ X, H& P
0 Z/ B/ a5 B; r% p8 n0 K& a  uint32_t   ChromaSubSampling
设置前景色或者背景色中YCbCr 颜色模式的采样格式，具体支持的参数如下：

" J8 w: E$ J6 S: F

1. #define DMA2D_NO_CSS               ((uint32_t)0x00000000)  /* 4:4:4 */
   
2. #define DMA2D_CSS_422              ((uint32_t)0x00000001)  /* 4:2:2 */
   4 D- ]( S1 A/ ~
3. #define DMA2D_CSS_420              ((uint32_t)0x00000002)  /* 4:2:0 */  
   $ c5 r: {, \( z# i

复制代码

, R4 t# W+ `; v; c# h3 K55.3.4 DMA2D句柄结构体DMA2D_HandleTypeDef
7 u1 F& a2 t( c( QHAL库在DMA2D_TypeDef， DMA2D_InitTypeDef和DMA2D_LayerCfgTypeDef的基础上封装了一个结构体DMA2D_HandleTypeDef，定义如下：
5 }& \# n2 l9 T/ B: s
3 [/ \) h# f1 B' r, J7 D7 e

1. typedef struct __DMA2D_HandleTypeDef
   
2. {
   & z! P: r: z: `7 W
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   
4.   DMA2D_InitTypeDef           Init;                                                        
   
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   1 x+ w& I7 M6 v$ E6 ]/ ^
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   . Q- z4 Q4 {- q2 i; ]! K- S  o8 F
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   % D4 x; u1 Z. f/ x! E+ [/ Y
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;

复制代码

5 n8 F  |9 w* n. k8 u3 M/ }
$ u3 ?5 U4 r# `9 Y; |' R" X' o7 ]
* w6 e* H. {: X下面将这几个参数逐一做个说明。

  DMA2D_TypeDef  *Instance
) U) D& b4 e$ M3 l* M这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

! M" b: E/ H: s0 P" e3 @  DMA2D_InitTypeDef  Init;  
这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。
$ a2 B: v& S4 ]+ u$ r1 l
  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
1 {6 W& U+ e* B1 r# z  f" v  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
) x3 L( L2 f) b  mDMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。

  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
- M. ~5 |' x$ j/ ^  w这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。

  HAL_LockTypeDef   Lock
5 \, L2 w* K& R__IO uint32_t    State;

__IO uint32_t    ErrorCode

7 r, Q) J0 V& m/ `- a这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。
. T, ~. ]4 M& O- m
55.3.5 DMA2D初始化流程总结
2 C/ |; w# W; Z8 z0 X  F对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

/ X) N# h% R" A1 r55.4 源文件stm32h7xx_hal_dma2d.c
& ~* F+ l% [1 \' v/ H5 t这里把我们把如下几个常用到的函数做个说明：
5 W. L' h  Q& P0 E- @
( O' E; T# u$ ]: N, B3 g  HAL_DMA2D_Init
. t  n+ v$ ~: N8 c0 s6 `  HAL_DMA2D_ConfigLayer
5 O0 l. k& \& J/ ~: F  HAL_DMA2D_Start_IT
  HAL_DMA2D_BlendingStart_IT
55.4.1 函数HAL_DMA2D_Init
) v5 X. b8 ?6 E/ p$ \1 D6 v7 l函数原型：
, ^7 {. p. [: U0 g

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   
2. {
   
3. 
     w9 N$ X1 R4 F2 G# Q
4. /*  检测参数是否有效 */
   
5.   if(hdma2d == NULL)
   
6.   {
   : v- A/ s! J% Y0 Q) u
7.      return HAL_ERROR;
   ' ~" O, F/ ~! c) A1 F% @; R
8.   }
   1 O7 a/ h! i3 c. j- K
9. 
   $ C- D6 n; Z! ]( S2 g
10.   /* 检测函数形参 */
    
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    
15. 
    # @$ h" c1 J9 c# l
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    
17.   {
    
18.     hdma2d->Lock = HAL_UNLOCKED;
    4 Q' q3 Q4 t. t# u2 e# J
19.     /* 初始化GPIO，NVIC等 */
    ' N: F: Y9 u/ ^- D9 f6 t
20.     HAL_DMA2D_MspInit(hdma2d);
    
21.   }
    0 [+ L& T) \2 \1 v$ b  y2 F
22. 
    # X5 ]& x  ~( D% V& A# y
23.   /* 设置DAM2D外设状态 */
    
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    8 D6 s) V1 _8 P, Z% K% S& X, g
25. 
    ' y5 z/ }6 A5 @7 X" S9 _+ n* }) Y
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    
28. 
    1 J0 [* e, ?5 \- G$ ~, g  h: I
29.   /* 设置输出颜色格式 ---------------------------------------*/
    8 l, ^# g' i- W0 r% o% h
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
    : T8 ^. ?* `- v8 R% l- K) v5 A
31. 
    
32.   /* 设置输出偏移 ------------------------------------------*/  
    
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    8 A) K9 Y2 D0 `3 U! {7 Z
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
    
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    % O) e' o( U/ S3 \+ C3 g
37. 
    
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    ) M3 _5 c7 G: D# \* x0 K4 ]& ~
39. 
    # V3 s' V  s/ c# {
40. 
    
41.   /* 无错误 */
    ' j4 S9 f1 s  k) B
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    
43. 
    ) X4 v- K5 k  Y$ {! \8 K- x5 c
44.   /* DAM2D就绪 */
    
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    
46. 
    * m6 c4 r) i  ^9 k* |; {; k
47.   return HAL_OK;
    # }) `/ j, N6 G6 f1 C* @
48. }

复制代码

, k& ~  ]% y% s  r! Z! w2 i% B# j; W
函数描述：

此函数用于初始化DMA2D的工作模式和输出颜色格式。

函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
+ ?) c$ v0 j3 V5 R2 O  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
注意事项：
- J" N& }0 [& F0 |/ ^4 q( b
' v# r3 f4 P3 K函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
4 i; X" J6 U7 j/ q. C; S5 H如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
% O/ N- c; N7 Q$ a& ~4 T对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。

- ^) O$ i6 n) x( A0 x8 [% _: G5 P- A解决办法有三

' v' Z8 g" p6 X$ a; j- k方法1：用户自己初始DMA2D底层。
. R6 Y( u  o. r' `' G( S# Z0 Y  r
, C/ C* q# t9 E2 p- V方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。
5 X7 u5 G4 A5 q5 k; c
3 l+ N$ s) e) W* o, u3 A! m5 N方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   ; v; ~' ?" q* o: r
2. {
   
3.     Error_Handler();
   - y: L6 {- Z; W# Q
4. }  
   6 F! f* `  T% l! @
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   
6. {
   
7.     Error_Handler();
   
8. }

复制代码

! r/ |8 M, {0 K9 [
$ r/ u; b- P7 O, N6 Y* q( _
使用举例：
+ k3 B; \: f9 f+ Q8 A4 P5 L: d* t

1. DMA2D_HandleTypeDef Dma2dHandle;
   8 ^* @5 @2 Q! x
2. 
   0 e3 h$ {; {+ g3 o5 @# P; I6 a' N
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
4. Dma2dHandle.Instance = DMA2D;
   ' ~% v5 A; P+ m) L/ U7 K) d# U
5. 
   ) f; p$ s( S: r  c- G, _
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   # B3 S) H2 K5 o! X9 ]4 ?9 v) W
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   $ g2 X- H1 G. m0 V0 N' |1 W
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
11. 
    
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    
16. /*##-3- 前景层配置 ###########################################*/
    
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    4 Y) ~3 j( e2 G9 A) y: h' p
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    / G) }" E+ }6 q& r4 D
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    ) d+ f  }$ k! P5 V: n8 c8 r7 M
23. 
    1 s, j3 r+ V( ~; i$ X3 M! a$ A
24. 
      v" V- |+ K, T7 Q6 K0 g& G& F  L" I
25. /*##-4- DMA2D 初始化 ###############################################*/
    ) {3 Q2 R& t4 Z) U' j' D$ p6 K
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    1 |: O' Z5 M5 P7 i0 ]5 ]! o
27. {
    ) }5 a# _6 i8 [) {. W1 f
28.     Error_Handler();
    
29. }

复制代码

2 ~( T4 I; D4 l) _
) n& C0 N; h& ^; `55.4.2 函数HAL_DMA2D_ConfigLayer
函数原型：

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   
2. {
   
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   
4. 
   
5.   uint32_t regMask = 0, regValue = 0;
   
6. 
   , I' {8 A. _+ q- ^0 g9 Y1 i
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   7 J/ K8 ?8 E+ E7 z
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    $ @6 k; G5 }; _+ I) e6 n0 [5 A! ~# j
11.   {  
    
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    4 R" h+ o$ {, |/ H
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    1 M/ j# |  j1 n
14.     {
    . U5 @0 s, z6 v0 p1 {7 Y
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    
16.     }
    . c6 p4 a! ^; H4 v, o) h
17.   }
    ! d) I3 I) N$ m
18. 
    
19.   /* 上锁 */
    
20.   __HAL_LOCK(hdma2d);
    . a' E) |6 N# \
21. 
    
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
24. 
    , ]/ d2 l  |* X  r" H2 \/ Z
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    8 p' V+ D# A8 Z- [
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    7 F& f* r) J$ z
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    ) y/ ^& P( E, n. C' `/ v7 y" v5 m
29. 
    : n. C, O- i2 n4 H2 K
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    
31. 
    
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    , G9 \& \4 {) O4 q) e
35.   }
    
36.   else
    0 v4 l' |" m, e0 t* M1 [5 G6 F
37.   {
    
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    
39.   }
    2 K8 P0 C0 k8 r7 ?2 N5 Z
40. 
    $ y$ m" ?( t+ o, i$ Q
41.   /* 配置背景层 */
    
42.   if(LayerIdx == 0)
    
43.   {
    
44.     /* DMA2D BGPFCCR 寄存器 */
    7 r8 X+ d/ B7 J- y4 u4 W
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    
46. 
    
47.     /* DMA2D BGOR 寄存器 */  
    
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    0 @: r- S) P$ n: C. x/ [
49. 
    
50.     /* DMA2D BGCOLR 寄存器 */
    ; i- x  f; v* f; r
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
52.     {   
    
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    
55.     }   
    0 L: P) S/ J, ]% g+ p
56.   }
    
57.   /* 配置前景层 */
    * U: t+ R" B( |. w: H
58.   else
    
59.   {
    
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    
61.     {
    
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    
65. 
    $ J& `9 R8 ?0 v9 T, p
66.      /* DMA2D FGPFCCR 寄存器 */
    ! ~  k: ]2 F0 g1 r' ^1 p
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    
68. 
    
69.     /* DMA2D FGOR 寄存器 */
    
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    6 J" E0 E- v4 E7 J0 l
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    8 H$ Z. ~2 D& A2 ]2 y
77.     }   
    ) f4 @1 N, s- b8 ^" j, k
78.   }   
    
79.   /* DMA2D就绪 */
    , F. n9 n! x* f% S5 I1 X  z
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    1 s  u2 B  s  x
81. 
    / b) B: T+ `% U: E$ f+ k6 i4 g4 g
82.   /* 解锁 */
    8 Y2 n- o! p' ?% z* G+ ?: H
83.   __HAL_UNLOCK(hdma2d);  
    
84. 
    . W) c2 h. S( U. u( f% a
85.   return HAL_OK;
    4 N6 @/ Q7 r7 V& _
86. }

复制代码

' A) r' h  Q. _; r, p4 |
0 r; B' m7 t2 k
函数描述：
" V; `8 S1 X3 W5 t
: y2 K" t7 J" [  @2 x0 ]此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。

- z. C) ^0 K9 @5 c* t: G函数参数：

4 m" E- Q1 p' l8 C  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
0 `0 b( u0 L( c) Q( U/ |$ o  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

0 [  b& v. h1 K' }( {4 S9 X

1. DMA2D_HandleTypeDef Dma2dHandle;
   - z: O5 c- g2 Q7 o( u# U
2. 
   
3. 
   
4. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
5. Dma2dHandle.Instance = DMA2D;
   ! f" ^! o6 M( M1 i
6. 
   ! K/ \! E8 ~# y8 i; S
7. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   , y8 t4 j0 \9 q' t
8. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   4 \' M. w  E. z9 s
9. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   % V4 N9 V- T* a& Z" z; X  E
10. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    
11. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
12. 
    
13. /*##-2- DMA2D 回调函数配置 ######################################*/
    
14. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
15. Dma2dHandle.XferErrorCallback = TransferError;
    5 K4 G/ [& R* }' s, ?8 d
16. 
    
17. /*##-3- 前景层配置 ###########################################*/
    9 x# s/ ]6 J! ^3 q* G4 {
18. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    ; w; G% |* x( Z& }7 \; z
19. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
20. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    1 c' s. B  v+ `  N( E! T; R
21. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    + V4 B) y+ m  h. c3 x
22. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
23. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
24. 
    
25. /*##-4- DMA2D 初始化 ###############################################*/
    ' i% _- @7 m! Y! [, f" m
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    ( s7 B+ {# z0 U3 @( h  l
28.     Error_Handler();
    6 X$ l, E3 P. @. b
29. }
    ; x! G& l2 {$ @1 B7 H: }; D% W
30. 
    8 {: I) r5 Z0 S
31. /* 配置前景层  */
    / K1 u7 G' \2 z0 t7 n: W( W9 @
32. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    
33. {
    
34.    Error_Handler();
    
35. }

复制代码

; U! b# ]+ A; f/ ^3 O8 R& B# O
# f/ P/ _' [' i4 ?4 K, `% Q
; g4 E3 z, h; M: l6 }& h' f, K; c" z9 m55.4.3 函数HAL_DMA2D_Start_IT
函数原型：

1. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   6 p( r* n$ B% O0 d$ a7 C' G; _3 {$ Z. t
2. {
   
3.   /* 检测函数形参 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   1 W$ n7 d2 A6 O  E. s) B; r
5.   assert_param(IS_DMA2D_PIXEL(Width));
   " a- @+ w6 O/ W! S/ u+ @4 y
6. 
   
7.   /* 上锁 */
   ' n: u) \! }7 O7 I  g
8.   __HAL_LOCK(hdma2d);
   ( ^) a" j  t3 u$ g0 Z5 ~
9. 
   
10.   /* 设置DMA2D外设状态 */
    , H$ \+ F$ z, x, x) C
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    # o' @: _  c. y6 j- ]* `
12. 
    6 p( \$ \/ u& Z4 {
13.   /* 设置源地址，目的地址和数据大小 */
    " U( ?8 c+ w& Q& Q# L' d4 N
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    4 Z4 h7 l$ D. y; ]' K- t; ~
15. 
    
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    5 U. K- H' n' g* g/ \
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    / q) Q' @1 @0 H: e! i+ h
18. 
    . ?) J; f* |( [3 L+ ?/ c
19.   /* 使能DMA2D */
    
20.   __HAL_DMA2D_ENABLE(hdma2d);
    0 \6 V+ f/ T; E
21. 
    
22.   return HAL_OK;
    
23. }

复制代码

3 C% Q/ n% m% p  l# |
. |" w9 }7 `7 ?0 l/ H, z; F( y
$ Z# \* @! P* h* M% w函数描述：
( q* H$ h0 r, b" ?$ R+ @- O  I
+ i; n% u6 q  M8 f7 M& K此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
; n( h1 e& {: G& y
函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址。
  第3个参数是目的数据地址。
  第4个参数是源数据的长度，即每行的像素个数。
4 S8 e" J4 G' s  i  U* k- g  第5个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
. m8 B" w8 r8 `6 {

1. DMA2D_HandleTypeDef Dma2dHandle;
   : d) j, z" B$ N; v2 a  v+ R3 I
2. 
   
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   / i5 C( y, {2 U8 |% _4 o
7.                       SIZE_Y)                  /* 源数据行数 */
   
8.    != HAL_OK)
   
9. {
   
10.    Error_Handler();
    9 q$ \& }. o- h. ?6 x" L
11. }
    

复制代码

- c& y6 I5 \# o6 _2 H; a) C
55.4.4 函数HAL_DMA2D_BlendingStart_IT
9 {- I, k, V* o2 b函数原型：

% X" ?+ F6 ?: k0 t" y/ y

1. HAL_StatusTypeDef HAL_DMA2D_BlendingStart_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t SrcAddress1, uint32_t  SrcAddress2, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   % q. K' V5 h) {4 p
2. {
   
3.   /* 检测参数 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   % G; {+ Q; A+ c9 `* L
9. 
   
10.   /* 设置DMA2D外设状态 */
    0 o1 d+ C1 d7 Q. a* _: u0 [
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    7 e5 d  V- @  D
12. 
    $ Q1 D2 l* F% L" ?
13.   /* 配置DMA2D源地址2 */
      R+ H3 P' {- L7 U+ T( e' w
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    
16.   /* 配置源地址1，目的地址和数据大小 */
    
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    1 d- n( O+ _; b: c  v4 {- b
18. 
    
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
21. 
    
22.   /* 使能DMA2D */
    / K; f, Y/ }. Q5 S3 g0 O
23.   __HAL_DMA2D_ENABLE(hdma2d);
    
24. 
    
25.   return HAL_OK;
    
26. }

复制代码

1 |/ o: I7 W+ e" }, M* w
; r2 |! T1 {( c% k
函数描述：

此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
2 q+ k' Q, V0 T( A0 n1 d
5 c5 S7 z5 o: j# v5 W7 @. b函数参数：

" X4 A$ `) X3 |9 Y2 S9 h; q7 ?  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址1。
8 {" ^4 w* [/ X+ P7 k: }  第3个参数是源数据地址2。
: N6 ^' A4 W6 |7 b1 O  第4个参数是目的数据地址。
  第5个参数是源数据的长度，即每行的像素个数。
% c9 I4 E6 s$ p% U6 y; Z" i5 I! @8 R  第6个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   4 L9 y1 E. b% y' X% }3 G, c% J- |
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   - q" h  @8 S4 _* E: F3 X  L
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   : J+ g# X5 k/ N! P
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   
8.                               SIZE_Y)                 /* 源数据行数 */
   4 T) O. i. O: L6 R  {, \4 y
9.    != HAL_OK)
   
10. {
    ) H* ~% W$ @, L2 D& O- p
11.    Error_Handler();
    
12. }

复制代码

3 f* C. v6 I; [! i% T) _" |
! y' F4 t0 G; X  Y, X4 n( |
55.5 总结
本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。
0 E) C8 x6 x9 c1 l7 J