55.1 初学者重要提示
# [2 ?& _, F$ {, L8 i  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
7 W% u/ N. R, _& b/ k; r  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张
. Z$ S7 e# c4 x! X  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
* F2 t, B" s2 c+ s9 X0 Q  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
- h& A- A2 M3 l5 t4 h55.2 DMA2D基础知识
DMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。
  C$ I' h! I- R5 _+ w
  DMA数据传输
4 ~* t. w3 W8 ~, I. {6 M+ ~6 R主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。

  2D图形加速功能
支持硬件的颜色格式转换和Alpha混合效果。

2 `& E9 }' Z2 @8 C55.2.1 DMA2D硬件框图
: e' R% L0 Q' R  X, X认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：
" C) ~6 q+ r1 z& o! G) f" \

% s$ m5 n) W: U+ b
- R5 F. a! l% _' }  i+ R; J( J通过这个框图，我们可以得到如下信息：

  dma2d_aclk
% ^' G1 M, i' y) w8 ^$ QAXI 总线时钟输入。
, J0 {# K5 i/ v5 }1 `8 K) I3 X
  dma2d_gbl_it
DMA2D全局中断输出。
9 y, k, t, P" y" g* W5 ~
  dma2d_clut_trg
4 P! [/ n% W+ Q; J6 ~6 Y2 h  eCLUT传输完成信号输出，可以触发MDMA。
: `" n8 X! j) r
6 a0 ^( n% g( z$ d+ l  dma2d_tc_trg
) N9 V' _; `* h& z; R传输完成信号输出，可以触发MDMA。

  dma2d_tw_trg
传输watermark信号输出，可以触发MDMA。

$ m8 B4 Z1 e7 D% G  r将这个硬件框图简化一下，就是下面这样：

* d' h" _5 z7 v* z, w

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

55.2.2 DMA2D工作模式
DMA2D支持的工作模式如下：
. N+ i- s. I2 @8 d. q6 [+ h5 F
  模式1：寄存器到存储器模式
% \3 W4 C4 J1 g4 I& X这个模式主要用于清屏，也即是将显示屏清为单色效果。
5 ~$ L; q% |1 j* u3 _2 F6 ~
  模式2：存储器到存储器模式
9 ?% A$ \4 q, Y/ M' x- ?这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。
# x/ f; f3 K: B' |  I
3 E. x1 }, g7 {  z% u1 [/ a: U  模式3：存储器到存储器模式，带颜色格式转换
) V* D: u9 F. z这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。
. h3 V2 K; |9 I# W$ U6 {# ]
& Y5 K, s9 n9 ]  模式4：存储器到存储器模式，带颜色格式转换和混合
这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。
  F/ Y  |. {$ G6 m# e- K4 d6 d( j
  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
0 W. s) l: R. o同模式4，只是前景色的颜色值是固定的。

55.2.3 前景层和背景层的输入以及颜色格式转换
前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。

DMA2D支持的输入颜色格式如下，前景层和背景层一样：

% _/ `9 V& z: [

前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：
* N9 e. S# W" z' a) r: ~
  L4 (4-bit luminance or CLUT)
4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。

  A4和A8
A4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。
! m* ~; S0 n8 J( K; D% U+ L
  YCbCr
这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。
; Y; a$ V: _4 ]% J- ~
9 z& N" t4 y; X; h2 K  {! [这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
: V/ n. p  ?* q* ]2 ]* l
# p" h" _6 f6 R7 }0 D0 j0 {55.2.4 前景层和背景层混合
DMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：

9 q5 I1 K$ A2 u( V
55.2.5 DMA2D输出颜色格式
DMA2D支持的输出颜色格式如下：
  t2 W) e+ G4 J+ I) T
- K5 P. K" ~0 V$ {

. r( x" B: |5 x0 S3 z
这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

55.3 DMA2D的HAL库用法
DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。

55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
7 i% [3 w# ^& I) y9 D# c( GDMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：

# k$ X$ S, \3 U* U

1. typedef struct
   - ~0 D3 Z7 J; P7 m/ ^; R5 m
2. {
   9 ~7 x8 g: m. X" ]
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   3 }5 v8 z) y6 j+ Q* z4 d
4.   __IO uint32_t ISR;           /*!< DMA2D Interrupt Status Register,                Address offset: 0x04 */
   7 T) @7 D0 Q1 D8 Z3 _( I! Y
5.   __IO uint32_t IFCR;          /*!< DMA2D Interrupt Flag Clear Register,            Address offset: 0x08 */
   " W) q* x$ R, _; d. [
6.   __IO uint32_t FGMAR;         /*!< DMA2D Foreground Memory Address Register,       Address offset: 0x0C */
   , t4 Z1 Y+ X9 U. S4 p5 A4 k
7.   __IO uint32_t FGOR;          /*!< DMA2D Foreground Offset Register,               Address offset: 0x10 */
   . }5 o; {% B% U+ x8 n
8.   __IO uint32_t BGMAR;         /*!< DMA2D Background Memory Address Register,       Address offset: 0x14 */
   
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 */
    - t6 e0 x4 F) K1 S' @
11.   __IO uint32_t FGCOLR;        /*!< DMA2D Foreground Color Register,                Address offset: 0x20 */
    & e- I& a% h; v; s, g. |
12.   __IO uint32_t BGPFCCR;       /*!< DMA2D Background PFC Control Register,          Address offset: 0x24 */
    $ g  u( E) ~2 ^$ b
13.   __IO uint32_t BGCOLR;        /*!< DMA2D Background Color Register,                Address offset: 0x28 */
    0 c6 U1 W( r* N' q
14.   __IO uint32_t FGCMAR;        /*!< DMA2D Foreground CLUT Memory Address Register,  Address offset: 0x2C */
    
15.   __IO uint32_t BGCMAR;        /*!< DMA2D Background CLUT Memory Address Register,  Address offset: 0x30 */
    ' {8 u% m2 N5 P# _2 E
16.   __IO uint32_t OPFCCR;        /*!< DMA2D Output PFC Control Register,              Address offset: 0x34 */
    ) C% `  ^- f( q3 N5 w4 s2 p
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 */
    
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 */
    / f& x! M5 q1 P
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    # C, ~# c, X1 {* o( X, A* O
24.   __IO uint32_t FGCLUT[256];   /*!< DMA2D Foreground CLUT,                          Address offset:400-7FF */
    6 X& P+ L6 u9 Q0 E) E9 k6 P
25.   __IO uint32_t BGCLUT[256];   /*!< DMA2D Background CLUT,                          Address offset:800-BFF */
    2 f# C0 @' d1 I
26. } DMA2D_TypeDef;

复制代码

: }9 ]4 _5 U9 u3 B9 u$ j  V8 x__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：
$ [4 n2 b; f  m. j3 X  ^0 U
7 i( l/ @% Q# x( h9 }; @8 r

1. #define     __O     volatile             /*!< Defines 'write only' permissions */
   
2. #define     __IO    volatile             /*!< Defines 'read / write' permissions */

复制代码

( V$ U2 G; a4 ^% x下面我们再看DMA2D的定义，在stm32h743xx.h文件。

1. #define PERIPH_BASE              ((uint32_t)0x40000000)
   & v: O/ {2 R/ [8 E( j
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   - E) ?7 a: @' Y4 t
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

5 z9 n8 \' |/ O我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。
6 d% {  W# {/ |" h9 I3 `8 ?
# e/ G+ O9 o1 S! C! o( q2 B' z55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
此结构体用于配置DMA2D的基本参数，具体定义如下：

( f9 h6 B$ n  p% N( H

1. typedef struct
   * c' l! A; L9 Y$ X
2. {
   
3.   uint32_t             Mode;              
   
4.   uint32_t             ColorMode;        
   
5.   uint32_t             OutputOffset;      
   , e# B, q* V/ S* m) L' U
6.   uint32_t             AlphaInverted;   
   3 q6 k7 U% I0 V! s  r5 _: y0 ^
7.   uint32_t             RedBlueSwap;      
   
8. } DMA2D_InitTypeDef;

复制代码

$ i3 E! S; t2 N( m8 Z. |8 D下面将这几个参数逐一为大家做个说明：

  uint32_t   Mode
  j. f/ g( A; ]9 o( _此参数用于设置DMA2D的传输模式，具体支持的参数如下：

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   & e1 E- J! y, T- _. |' o$ A
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   

复制代码

8 C9 f, @% K+ B1 U: `1 }8 K# x. B
2 k6 D  r2 @! g- \& I& D  uint32_t   ColorMode
8 f! N3 Z( f1 c此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：

  }2 F3 v9 F' M" X! }

1. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   
2. #define DMA2D_OUTPUT_RGB888         DMA2D_OPFCCR_CM_0                     /* RGB888 */
   
3. #define DMA2D_OUTPUT_RGB565         DMA2D_OPFCCR_CM_1                     /* RGB565 */
   
4. #define DMA2D_OUTPUT_ARGB1555       (DMA2D_OPFCCR_CM_0|DMA2D_OPFCCR_CM_1) /* ARGB1555 */
   
5. #define DMA2D_OUTPUT_ARGB4444       DMA2D_OPFCCR_CM_2                     /* ARGB4444 */
   

复制代码

  uint32_t   OutputOffset
$ ^9 @0 K9 l/ D9 ]  f, ^此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。
' {- ]$ E% w. t" b$ h* L
" |# I  o/ s2 F2 a4 t# V  uint32_t   AlphaInverted
) @! L' |7 ^8 T, r( R$ e# {此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

  uint32_t   RedBlueSwap
  m0 Z9 q, _5 M0 {7 `  l' h! y此参数用于设置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) */

复制代码

55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
此结构体用于配置前景色和背景色。
) m* U. t/ u7 P* v

1. typedef struct
   
2. {
   
3.   uint32_t             InputOffset;      
   " {; s- b; g1 F( }* d+ W
4.   uint32_t             InputColorMode;   
   . T+ i/ K) F* i5 Q
5.   uint32_t             AlphaMode;        
   
6.   uint32_t             InputAlpha;        
   
7.   uint32_t             AlphaInverted;   
   8 ^( \( o5 l$ c  E) I1 D
8.   uint32_t             RedBlueSwap;      
   3 }/ o5 i. z5 D( l4 v, I; g" n; z
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

1 D( v, A. ~2 }, n下面将这几个参数逐一为大家做个说明。
9 |6 j& e. p& v% C" R
  uint32_t  InputOffset
% J# v: t* D( ]7 q) v  x( p设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
3 Q! Q- q5 L- {7 M$ ]
  uint32_t  InputColorMode
( ^7 p& o) a) w' b: B+ F1 U% [7 G+ p设置前景色或者背景色的输入颜色格式，具体支持的参数如下：

$ K1 G& D6 ^3 I5 Q& L

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   7 p- i/ G; F, x
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   - t5 {. m; |' N+ Y8 i1 o
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   + N! h' O, y7 `, R# K7 e
4. #define DMA2D_INPUT_ARGB1555        ((uint32_t)0x00000003U)  /* ARGB1555 */
   
5. #define DMA2D_INPUT_ARGB4444        ((uint32_t)0x00000004U)  /* ARGB4444 */
   
6. #define DMA2D_INPUT_L8              ((uint32_t)0x00000005U)  /* L8       */
   ( f! u5 `0 I* X  N/ j: Z8 S" W" x
7. #define DMA2D_INPUT_AL44            ((uint32_t)0x00000006U)  /* AL44     */
   
8. #define DMA2D_INPUT_AL88            ((uint32_t)0x00000007U)  /* AL88     */
   & M4 \, C- B) u2 ]  o& T
9. #define DMA2D_INPUT_L4              ((uint32_t)0x00000008U)  /* L4       */
   
10. #define DMA2D_INPUT_A8              ((uint32_t)0x00000009U)  /* A8       */
    ) m8 V# i# K; h
11. #define DMA2D_INPUT_A4              ((uint32_t)0x0000000AU)  /* A4       */
    
12. #define DMA2D_INPUT_YCBCR           ((uint32_t)0x0000000BU)  /* YCbCr    */

复制代码

  uint32_t AlphaMode
) C, W7 I' w6 H设置前景色或者背景色的Alpha模式，具体支持的参数如下：
1 d/ b$ C8 P/ e' ~' V4 N

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   9 T, V! J& R% b3 I# u- q( ]
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

  uint32_t  InputAlpha
设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。

  uint32_t AlphaInverted
8 x* m; T/ g" x* Q" z设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
5 Q- h* b# v2 t6 g, Y5 u
. D4 w, P0 K$ W5 ]/ W

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   5 }6 N7 J; d) M9 s5 N2 P2 j  [* j
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */     

复制代码

( |& l% S$ g- q9 x, |5 j; R+ J  uint32_t   RedBlueSwap
, G' C( `3 o6 S  a! ^设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：
- q" A* F* Q9 X( G+ v! F

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   ' L) j9 K& u0 v/ r
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

  uint32_t   ChromaSubSampling
2 Y) ~+ ^, i3 f7 X2 k设置前景色或者背景色中YCbCr 颜色模式的采样格式，具体支持的参数如下：

1. #define DMA2D_NO_CSS               ((uint32_t)0x00000000)  /* 4:4:4 */
   - @: j9 f! [! N3 }' a
2. #define DMA2D_CSS_422              ((uint32_t)0x00000001)  /* 4:2:2 */
   - \3 ^  N' M& {* o3 C( r4 w/ V* J
3. #define DMA2D_CSS_420              ((uint32_t)0x00000002)  /* 4:2:0 */  

复制代码

55.3.4 DMA2D句柄结构体DMA2D_HandleTypeDef
HAL库在DMA2D_TypeDef， DMA2D_InitTypeDef和DMA2D_LayerCfgTypeDef的基础上封装了一个结构体DMA2D_HandleTypeDef，定义如下：

1. typedef struct __DMA2D_HandleTypeDef
   
2. {
   ( b( @+ u2 h2 }0 Z% t
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   
4.   DMA2D_InitTypeDef           Init;                                                        
   / r- g4 h! E. @5 B' |
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   3 D! a& a- C( N% ?* }
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   , k- D1 I3 }7 i$ _8 F
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    

复制代码

下面将这几个参数逐一做个说明。
' ^! c7 O0 A- n! z5 s5 u
  DMA2D_TypeDef  *Instance
4 D: I4 f# D  z这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

9 w6 g: a+ E$ r8 @& u% A  DMA2D_InitTypeDef  Init;  
这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。
* \7 T' O( j# m, T% @, d/ u. H
" o# N; F- l+ a4 }) K# `  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
5 L- }  d& w8 f7 }% b  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。

+ O, W5 a, n2 Q) V" c  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
; p" D0 J9 e7 K6 d" b5 G5 |- Y这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。
7 B& a$ t% n8 J9 h# E
  HAL_LockTypeDef   Lock
__IO uint32_t    State;

__IO uint32_t    ErrorCode
! O6 R  X/ @& b: c; c: G) [  y
这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。
( A; ?( G2 U) c% i" g
55.3.5 DMA2D初始化流程总结
对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

55.4 源文件stm32h7xx_hal_dma2d.c
, g: C3 J# w& N% i/ X! p4 P( s这里把我们把如下几个常用到的函数做个说明：
7 d% h* `, [$ @' i( s$ Z
# v8 D' E" Z& @; p5 ^, P; T" g; s, Y  HAL_DMA2D_Init
  HAL_DMA2D_ConfigLayer
  HAL_DMA2D_Start_IT
  HAL_DMA2D_BlendingStart_IT
+ R& L; A2 y; K* }$ q$ S& Y7 q1 f
55.4.1 函数HAL_DMA2D_Init
; N% I) p6 N0 B( k函数原型：

9 t3 ~- Z, _3 K5 v' s5 ]+ p

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   
2. {
   $ F1 |8 Z4 [% z/ U9 O; G7 J
3. 
   
4. /*  检测参数是否有效 */
   
5.   if(hdma2d == NULL)
   
6.   {
   
7.      return HAL_ERROR;
   
8.   }
   
9. 
   $ S6 a8 k% }+ F$ t) f" Z( W
10.   /* 检测函数形参 */
    : r8 Z4 L1 i7 r6 L7 }
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    - z. V$ {5 x1 c
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. 
    
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    / r# \9 N: R  v9 w
17.   {
    
18.     hdma2d->Lock = HAL_UNLOCKED;
    
19.     /* 初始化GPIO，NVIC等 */
    
20.     HAL_DMA2D_MspInit(hdma2d);
    
21.   }
    
22. 
    
23.   /* 设置DAM2D外设状态 */
    % d  n* e/ I# F. u. D9 x* E* r+ o
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
      X2 ]8 @' X" w# U7 r
25. 
    8 C3 B4 i* F. A/ b( _7 J! y
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    
28. 
    0 ]. n9 B2 e  v2 p  X4 P' c: e2 \
29.   /* 设置输出颜色格式 ---------------------------------------*/
    
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
    
31. 
    + D- F" I& x0 y. K: t3 l! Z/ u
32.   /* 设置输出偏移 ------------------------------------------*/  
    " [; x! p9 u1 z2 X
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
    % E5 L/ Z6 b+ u
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    
37. 
    4 J! p1 F2 t  x1 i; c+ d6 W: `4 B+ {
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    
39. 
    4 P! k& O5 E% G4 T: X
40. 
    
41.   /* 无错误 */
    
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    
43. 
    9 m% b3 ?' F2 C5 E- ]4 t
44.   /* DAM2D就绪 */
    
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    
46. 
    
47.   return HAL_OK;
    
48. }

复制代码

函数描述：

此函数用于初始化DMA2D的工作模式和输出颜色格式。
9 k' N& V) j- P" a+ B, ]
函数参数：
! ~  c( Q9 ]! Z! J4 r% t5 Z# k6 z
0 Y4 V0 N5 R; s9 e& \$ y$ F, F/ v% ]  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
: d0 o) I1 i2 u5 U2 W  k: O( M! t注意事项：

函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
" v$ N# I& ?& s5 h. K, @' t& Z4 r如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。

解决办法有三

2 c; M" p8 S) x) q/ M方法1：用户自己初始DMA2D底层。

方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。

方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   
2. {
   ) g7 B2 g6 ?( [* H- }$ \, b
3.     Error_Handler();
     K+ [! }" u4 k& c6 N
4. }  
   
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   6 G! Z1 r. L9 o1 f* L+ X. g
6. {
   $ v# z! x& R/ u; M$ N+ G" a
7.     Error_Handler();
   9 o- H6 a0 q' l! I+ Q, j8 u# d' [
8. }

复制代码

# l& X, |" e+ m$ d, S6 ^5 ^
使用举例：

1. DMA2D_HandleTypeDef Dma2dHandle;
   # T3 w  e5 X/ t1 `) \5 F/ P0 R
2. 
   
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
4. Dma2dHandle.Instance = DMA2D;
   6 Q" b" W9 C' x) A
5. 
   + ]  p2 k& k1 k8 L! b4 C6 S
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    ' f8 L* c+ }  u2 T: C5 ^$ p3 s/ U  H
11. 
    - O% ]. E  G7 H+ B& b
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    ( K; `) l  `5 c- t5 v  t& D* ?5 g
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    ! \* d! C' U+ _) M4 g; o# u
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    
16. /*##-3- 前景层配置 ###########################################*/
    ; ?. c8 ]( {5 q, d& R' v0 K( D
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    8 \' m7 R' b  c% }4 C3 `5 B( a. C* l
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    7 e- o. B4 O9 ~. Y/ `$ R
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    . I, v& Z7 {- }
23. 
    
24. 
    $ G* j: [; W# V3 G: @( N
25. /*##-4- DMA2D 初始化 ###############################################*/
    
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    5 Z7 s+ r1 J/ Q; [+ O
28.     Error_Handler();
    ; s( n4 T3 t# T) x
29. }

复制代码

55.4.2 函数HAL_DMA2D_ConfigLayer
( Q6 M* V5 ], s3 c6 o函数原型：
5 [: o/ F3 K6 ?! U9 N( V

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   
2. {
   6 O6 v" s5 a2 R& `2 p6 U, n: ]! l
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   ) c; U$ A/ _# X2 y2 z4 k
4. 
   
5.   uint32_t regMask = 0, regValue = 0;
   
6. 
   
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   4 E, x8 U# K% j6 l- t
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    
11.   {  
    9 ]- a9 T1 {  U/ l" o) U
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    
14.     {
    2 e* A& O2 h" `  Y6 {( o4 |" }- O
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    2 B' R& s+ }% Z. M. `0 d; J
16.     }
    
17.   }
    : J# m7 l: v+ m  S- I2 F
18. 
    , ^  \9 Y8 G0 u3 H6 _; Z+ v
19.   /* 上锁 */
    
20.   __HAL_LOCK(hdma2d);
    8 X5 _( E( h9 T% u9 `  n8 `7 R
21. 
    ( |2 e2 o; {0 b$ h" Y; o
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
24. 
    
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
      U5 v% d9 f& E+ v1 Q
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    4 |3 n4 D5 v' D1 j' ?+ T: Q8 |7 Q8 Q
29. 
    
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    
31. 
    ) {0 _/ q" t% n. g) L% x
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    ( q9 ~' p5 H+ T  J
35.   }
    
36.   else
    # Q% n/ d" i! i
37.   {
    6 M' Z4 D# g) p' j: X2 Y& A
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    ; c# n/ t) y5 W
39.   }
    
40. 
    0 P6 Y( H" l% i6 A9 _. I; z4 `
41.   /* 配置背景层 */
    
42.   if(LayerIdx == 0)
    ! c8 Q2 G3 d7 F9 u, N5 `4 x& r  l# h
43.   {
    
44.     /* DMA2D BGPFCCR 寄存器 */
    $ U! I: a4 s7 Y
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    6 G0 ]8 D. Z, E# H6 Q( E' X# r
46. 
    % Y: M6 N- m3 T4 w0 k6 O
47.     /* DMA2D BGOR 寄存器 */  
    
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    
49. 
    
50.     /* DMA2D BGCOLR 寄存器 */
    . p% J  }3 c3 {: x* O# R8 X# y  N
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
52.     {   
    2 ~3 H# W( ?! a+ u) k4 A
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    ; g' l9 V7 m1 `7 x0 {4 u
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    
55.     }   
    
56.   }
    
57.   /* 配置前景层 */
    
58.   else
    $ _' p3 _8 r. s' o) B6 t
59.   {
    - K8 x$ L7 }6 A- y- M( G. J
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    6 p+ U/ u: b" ]9 U
61.     {
    
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    " B/ }4 d7 B8 n7 E' q
64.     }
    
65. 
    
66.      /* DMA2D FGPFCCR 寄存器 */
    ' N  H: G1 c1 Y) ?8 s
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    & u5 Y1 s$ [" V( r
68. 
      }6 D7 j2 a8 I' [4 H
69.     /* DMA2D FGOR 寄存器 */
    0 m! |5 f$ v- s, [3 Y2 O, B
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    ; ~) \' p) [1 _) A! n
74.     {
    5 e  [$ h+ v+ C+ r
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    
77.     }   
    
78.   }   
    0 _5 @3 K9 L+ R! k: X1 W
79.   /* DMA2D就绪 */
    : W. m* q/ q/ ?7 @7 ]
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    9 F* C$ Y/ j6 t( {( t1 @) n
81. 
    , M/ M, Y" G( T0 R* |7 [! n
82.   /* 解锁 */
    
83.   __HAL_UNLOCK(hdma2d);  
    2 z5 ]1 ~6 _% a/ q; k* \; c
84. 
    ; ^9 u2 b" P- X# v$ @6 I7 {
85.   return HAL_OK;
    
86. }

复制代码

函数描述：
, Y, C! B7 S- E: W/ i4 n
9 a1 J% S. h  E0 J$ Y- G此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。

函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
5 O4 d  x! S1 k# M2 \  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
3 q6 U; I6 w. U. Z% Y

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   
3. 
   
4. 
   
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
6. Dma2dHandle.Instance = DMA2D;
   9 S- k- \( X5 z8 i4 k0 ~; E5 o# W% v# w
7. 
   , h$ l! k+ N7 T, w3 `
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   ' s) H5 F  @0 I- E7 _
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   - k) N/ }, {3 j4 t; T/ x/ ~3 R
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    
11. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    
12. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
13. 
    * s' d* G+ W/ ?9 X* V: ]% K
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    3 o$ g3 g/ |  w4 d7 X7 y
16. Dma2dHandle.XferErrorCallback = TransferError;
    ! B1 }8 Q7 R! n$ e0 S/ m  e
17. 
    
18. /*##-3- 前景层配置 ###########################################*/
    8 a; C- w2 I/ {" ^  L
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    ) b! g: c5 G+ d+ O6 G
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    ! F" \  o5 r6 I5 R
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    6 D. {6 O1 R6 X0 s, _5 W8 M
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
25. 
    
26. /*##-4- DMA2D 初始化 ###############################################*/
    
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
28. {
    8 x( J' g8 f& K
29.     Error_Handler();
    ; }6 q& [) w: e6 y
30. }
    6 R) Y/ l+ X$ {9 Z
31. 
    " _* B7 ~0 i! b! [3 F
32. /* 配置前景层  */
    
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    
34. {
    7 x4 |3 M5 X- _8 G" q1 M8 x. J
35.    Error_Handler();
    
36. }

复制代码

2 x4 ]) [8 Y) d% N  U
2 @: O& M& S# f  B1 w8 p55.4.3 函数HAL_DMA2D_Start_IT
函数原型：

9 D! s6 o3 ~) H5 }  W( A

1. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   7 E7 C  s, B6 j
2. {
   ' f* Q8 A  ~2 p8 I
3.   /* 检测函数形参 */
   % O- j$ {( L3 z  U
4.   assert_param(IS_DMA2D_LINE(Height));
   
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   $ i$ p% G: `+ d1 x) f$ o# q1 F* W
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   " p" }4 Z8 K$ |) _
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    0 V. F) ]+ b% S1 M/ f, K- x
12. 
    * Z# }; E6 k# t( O
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    4 w6 j  Z/ c  M) f+ E. |- j8 s
15. 
    
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    4 `3 `' Z' D) r" l: Q2 k9 [
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    - e& }( F9 J3 l: @+ u
18. 
    
19.   /* 使能DMA2D */
    
20.   __HAL_DMA2D_ENABLE(hdma2d);
    
21. 
    
22.   return HAL_OK;
    
23. }

复制代码

函数描述：
2 }# E* H7 x& `" X+ a
/ g6 \* s; g6 ?6 x2 ^, v2 ~此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。

函数参数：
6 J( S* I. a3 d$ ?& \
0 C: _* M( u0 F3 m+ N4 [, I# v  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
7 N5 k' ~% o/ q) R$ H% c  第2个参数是源数据地址。
* e$ [1 e! g. Q0 P' I  第3个参数是目的数据地址。
  第4个参数是源数据的长度，即每行的像素个数。
# F2 c* M8 h; r" b7 r. u; W/ w5 e4 g. ?3 j  第5个参数是源数据的高度，即行数。
+ r0 @  U' `* C8 Y  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
9 b" s9 ^% c. |- Y& D使用举例：
8 x. ]) _- g: I- R

1. DMA2D_HandleTypeDef Dma2dHandle;
   ) _* o+ v6 i1 P# k9 s$ d! Z
2. 
   
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   0 ]6 c! E8 q* ^' n" N
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   
7.                       SIZE_Y)                  /* 源数据行数 */
   
8.    != HAL_OK)
   6 W2 \3 ]! ~. @) {+ ^' x
9. {
   ! g- e. @" f0 e
10.    Error_Handler();
    
11. }

复制代码

  P5 X, K3 S" |0 |55.4.4 函数HAL_DMA2D_BlendingStart_IT
函数原型：
9 h' V- t( N6 ?/ M
. V5 i# @4 d3 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)
   0 x7 h. V2 `5 f: J- D4 ^/ P
2. {
   
3.   /* 检测参数 */
   3 R$ h7 f; u  e3 k
4.   assert_param(IS_DMA2D_LINE(Height));
   3 T- e% t5 P& f
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   . ~' p% r/ N* F3 i
9. 
   
10.   /* 设置DMA2D外设状态 */
    " ~6 f2 L, w6 Y" c3 x
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    
13.   /* 配置DMA2D源地址2 */
    7 Y$ I! `' g  [/ ?
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    
16.   /* 配置源地址1，目的地址和数据大小 */
    5 E  F( Y4 ?1 L; |
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    
18. 
    # G8 u  V0 X" h5 x7 Y
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
21. 
    + G! }; p4 I; W, x7 }) q
22.   /* 使能DMA2D */
    
23.   __HAL_DMA2D_ENABLE(hdma2d);
    
24. 
    
25.   return HAL_OK;
    
26. }

复制代码

4 Q( I. S0 z9 g0 m5 w8 W2 G* P函数描述：
/ J$ M- i& D% K8 Y. b! I! v5 n
此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
6 u5 b. \; V$ L
0 A/ Y" f! S/ r5 h" ^! P: B函数参数：

/ k! f, ~: N, `* G  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址1。
  第3个参数是源数据地址2。
& K. o$ M* ~/ g4 n! Y  第4个参数是目的数据地址。
  第5个参数是源数据的长度，即每行的像素个数。
9 z, M0 x0 v& T- M9 ^2 d) z- U  第6个参数是源数据的高度，即行数。
# u( g, K/ y* G! x9 f4 W9 A  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
, k# _7 X: M! a3 H& o使用举例：

0 W; ^, l% [3 W& z

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   2 ]0 v2 u8 d' o4 h( |3 Y. p# v
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   ; C$ [, x; b: {6 K7 y; s& G
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   & T& i" N5 V; O& g
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   $ M3 v5 B$ a# Z
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   
8.                               SIZE_Y)                 /* 源数据行数 */
   0 d0 v3 j+ [; z' n  O
9.    != HAL_OK)
   ) l' F. o. Y3 {# w
10. {
    - W2 k  X! d6 L
11.    Error_Handler();
    " O& u+ F4 B. g% _1 O
12. }

复制代码

" {7 E0 M" M+ f' ?) |' U& V
! }) Y1 X. O! M9 [55.5 总结
# b9 H/ D7 i  G+ s2 y5 x本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。
% A0 E5 O$ K' g; F, Q: n; |

7 |3 p% p8 @  Q8 Q. Q
- ^8 T7 }% S8 B+ M