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

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

  2D图形加速功能
1 U* w) `9 H: ]- g支持硬件的颜色格式转换和Alpha混合效果。

55.2.1 DMA2D硬件框图
  B3 T3 Q8 ^+ M5 i认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

. i9 C9 O, A" q4 f: v6 c) Z9 V  C

* p7 ~: M9 _. M, M! ?6 w通过这个框图，我们可以得到如下信息：

  dma2d_aclk
; b: G1 A$ b0 o# s! u) lAXI 总线时钟输入。
' d( I( j- Q. _5 F1 O
  dma2d_gbl_it
DMA2D全局中断输出。
8 F; v( h; C  c) `' y" g
5 f2 \, G! [2 R2 ^  dma2d_clut_trg
) ?5 o4 [, [4 k1 @+ F  }* n( mCLUT传输完成信号输出，可以触发MDMA。
) ]! W/ b+ v9 o- y# u2 Z- D; G
& O$ D/ w9 j7 T/ R5 X  dma2d_tc_trg
传输完成信号输出，可以触发MDMA。
1 Q' ]4 A5 y5 f8 v0 X
  dma2d_tw_trg
0 }9 i# u/ ?& L- P# E/ v5 s( Y传输watermark信号输出，可以触发MDMA。
0 A4 w8 j! A9 Q. v; s9 f6 {
将这个硬件框图简化一下，就是下面这样：

3 r) b! l+ ?& f1 |6 _

  Q/ }) G1 p+ A( J! g8 P# X
4 c4 Z/ p7 J4 F4 V9 T5 J; h5 V6 ^下面按照简化的硬件框图，对每个部分做个说明。
+ ^# X, T8 ]1 _
$ y0 n2 ?) `! G9 ^7 I% z55.2.2 DMA2D工作模式
DMA2D支持的工作模式如下：
  k* b. N% E; Y; b
  模式1：寄存器到存储器模式
这个模式主要用于清屏，也即是将显示屏清为单色效果。

+ W) o" |8 `2 e2 C; [- J0 u  模式2：存储器到存储器模式
& j; x# W% a5 t1 e( ^* B这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。

  模式3：存储器到存储器模式，带颜色格式转换
这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。

. g' \# k  [- [0 S  模式4：存储器到存储器模式，带颜色格式转换和混合
这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。

6 u! [7 [8 v$ ^8 v/ s; w: Z8 f  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
同模式4，只是前景色的颜色值是固定的。
4 u0 n! k! p. `3 a( P: P4 E
+ p! u0 a7 ~4 s. Y55.2.3 前景层和背景层的输入以及颜色格式转换
4 ]. E, p- x4 R/ h前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。

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

3 o, r, q" I% e$ c7 s% l, L7 C前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：

  L4 (4-bit luminance or CLUT)
4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。

  w0 x# O! N) N! c: h$ a0 U  A4和A8
3 @$ I& T  v6 N" `- b4 jA4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。

  YCbCr
$ J& B( S8 h) C; {7 X这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。

2 P9 {; Y' c! [# G. g- \5 {6 u; Q这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

55.2.4 前景层和背景层混合
# |. I8 W; o, K* w. w4 IDMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：
, |' m! ~8 e5 I0 S1 j

) D/ q! e/ D0 H( k) S55.2.5 DMA2D输出颜色格式
9 I$ e* d! D# o$ t: cDMA2D支持的输出颜色格式如下：
4 Q/ A2 O* D+ s

$ l* ~, x* H6 \, M
' `2 H2 R, X& l% Z这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

- d* q5 v; Y+ K/ I& `55.3 DMA2D的HAL库用法
DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。
4 s" W: t* H0 S# t9 d2 Z: T) j
55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
/ Z4 f" h, u3 A9 F: uDMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：

1. typedef struct
   
2. {
   ( F. L; Q4 o5 K; C
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   
4.   __IO uint32_t ISR;           /*!< DMA2D Interrupt Status Register,                Address offset: 0x04 */
   
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.   __IO uint32_t FGOR;          /*!< DMA2D Foreground Offset Register,               Address offset: 0x10 */
   ( J$ e) |* m/ ]4 O5 o
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 */
   $ G# z+ w5 Y9 k  K
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
    8 A  i4 i" ^# l9 _1 D" l
11.   __IO uint32_t FGCOLR;        /*!< DMA2D Foreground Color Register,                Address offset: 0x20 */
    
12.   __IO uint32_t BGPFCCR;       /*!< DMA2D Background PFC Control Register,          Address offset: 0x24 */
    & d: D$ R0 `2 `
13.   __IO uint32_t BGCOLR;        /*!< DMA2D Background Color Register,                Address offset: 0x28 */
    . n7 G. a0 J# Z8 c5 C
14.   __IO uint32_t FGCMAR;        /*!< DMA2D Foreground CLUT Memory Address Register,  Address offset: 0x2C */
    # ~$ l. I9 b' b
15.   __IO uint32_t BGCMAR;        /*!< DMA2D Background CLUT Memory Address Register,  Address offset: 0x30 */
    
16.   __IO uint32_t OPFCCR;        /*!< DMA2D Output PFC Control Register,              Address offset: 0x34 */
    / _2 F4 a8 A5 n( Y8 `" ~. ~
17.   __IO uint32_t OCOLR;         /*!< DMA2D Output Color Register,                    Address offset: 0x38 */
    9 z5 V0 R0 K6 V
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 */
    # C; y" |1 ^6 T# P+ U' y" q! S; y
21.   __IO uint32_t LWR;           /*!< DMA2D Line Watermark Register,                  Address offset: 0x48 */
    5 l( z  r. W( O. x8 E7 j
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    & P' j' m4 {, r! I2 q
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    
24.   __IO uint32_t FGCLUT[256];   /*!< DMA2D Foreground CLUT,                          Address offset:400-7FF */
    ! _3 t3 |5 x! e3 v/ u! \* f# l0 a! i2 N# h
25.   __IO uint32_t BGCLUT[256];   /*!< DMA2D Background CLUT,                          Address offset:800-BFF */
    ( d  F, `/ F0 D9 P
26. } DMA2D_TypeDef;

复制代码

* |0 U6 g0 L" r% b  o+ K! \
__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：

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

复制代码

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

1. #define PERIPH_BASE              ((uint32_t)0x40000000)
   
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

9 L6 O* x1 r% ]! R, W$ K我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。
# E. p6 p- j$ |) m- n
55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
8 d) b( I, z5 m) B此结构体用于配置DMA2D的基本参数，具体定义如下：
4 @9 i% R' N& S' J2 d- G
, H4 f' y, o" x+ @6 m- b$ \, z

1. typedef struct
   ; h" k" ?4 Z  _+ E2 U$ l6 x
2. {
   * M/ U  T, d, P+ W5 o! z8 W
3.   uint32_t             Mode;              
   
4.   uint32_t             ColorMode;        
   3 `) _& h9 w3 G& H' i2 p# a4 r
5.   uint32_t             OutputOffset;      
   
6.   uint32_t             AlphaInverted;   
   
7.   uint32_t             RedBlueSwap;      
   + A* V7 M: g' G0 |, j
8. } DMA2D_InitTypeDef;

复制代码

下面将这几个参数逐一为大家做个说明：
! ]$ f" `/ A" t9 ^# K" i
+ Q& L& a" R' |# e1 F  uint32_t   Mode
. c3 |7 Y2 \$ @0 ^$ \& E/ [此参数用于设置DMA2D的传输模式，具体支持的参数如下：

0 t" w# n; S% o/ J: E! i

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   ; K" |- V( @2 z; e0 o
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   

复制代码

3 Y( @3 ], Q/ N
  uint32_t   ColorMode
此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：
0 \& z( _/ J# P! C! e7 q) V1 w( m
, f# X, Z8 A4 l; |# }1 v( F0 [

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 */
   2 h" E2 {/ ~4 ?0 H" Y  A
5. #define DMA2D_OUTPUT_ARGB4444       DMA2D_OPFCCR_CM_2                     /* ARGB4444 */
   6 P2 l$ |1 m  V- l

复制代码

  uint32_t   OutputOffset
. }9 E; {  D+ V0 D3 e* D9 m此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。
! B/ _  L  w5 h
  uint32_t   AlphaInverted
此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
) H' n1 D8 k3 s
$ t/ i$ p+ L* m! D8 r9 f9 Y

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   , S! H4 B9 A3 V/ p
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

  uint32_t   RedBlueSwap
/ o7 n( J/ x! n+ W此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：

# s" K0 x- h) ~5 q

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   8 P1 n# I- o+ k
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
此结构体用于配置前景色和背景色。
4 B% O+ k5 C$ V! t
6 U# @/ C3 _9 V- j7 x: m. [- _

1. typedef struct
   # ^, P$ l) G) f3 U; K5 {7 r1 @! n! e
2. {
   4 B: S* f3 m# x5 W+ o+ K
3.   uint32_t             InputOffset;      
   0 I) ~/ K+ H, p) {0 M& D
4.   uint32_t             InputColorMode;   
   ( b, b" I9 L; {9 _# x' R
5.   uint32_t             AlphaMode;        
   ' _4 H7 _+ i# _7 A6 s) b$ ?
6.   uint32_t             InputAlpha;        
   5 B3 x; u' [0 d( Y
7.   uint32_t             AlphaInverted;   
   & }$ L. Y3 T, ?0 a7 ]3 S
8.   uint32_t             RedBlueSwap;      
   
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

2 x! H7 Q# C8 E8 x下面将这几个参数逐一为大家做个说明。

, _6 O" m+ l: [- M5 W6 }8 T  uint32_t  InputOffset
设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
3 V# Q" ]% _/ W3 f5 k8 J- D
  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   2 E2 [1 s( k$ \/ o) U
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   
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       */
   
7. #define DMA2D_INPUT_AL44            ((uint32_t)0x00000006U)  /* AL44     */
   
8. #define DMA2D_INPUT_AL88            ((uint32_t)0x00000007U)  /* AL88     */
   3 O! o3 Y: L8 ?5 r- H0 b7 ~
9. #define DMA2D_INPUT_L4              ((uint32_t)0x00000008U)  /* L4       */
   
10. #define DMA2D_INPUT_A8              ((uint32_t)0x00000009U)  /* A8       */
    
11. #define DMA2D_INPUT_A4              ((uint32_t)0x0000000AU)  /* A4       */
    
12. #define DMA2D_INPUT_YCBCR           ((uint32_t)0x0000000BU)  /* YCbCr    */

复制代码

  uint32_t AlphaMode
6 k5 ~* j: }  G7 S/ L4 u7 F) w设置前景色或者背景色的Alpha模式，具体支持的参数如下：

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

复制代码

  uint32_t  InputAlpha
& P" E( Z6 V- Z2 q3 z7 y  ~6 Y设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。
. D; `8 _5 j3 S* X0 i9 C/ S
) x, p2 @" n3 F/ v% O  uint32_t AlphaInverted
6 H$ V% r1 B8 l0 C% F& o设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
- C+ s! J9 t+ O$ O2 j+ u7 X  b6 t

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

复制代码

0 G' S7 T4 k& t; D  uint32_t   RedBlueSwap
# K2 m. b* x3 n# F) P: h0 J: A8 O设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：

% M2 A! }% l. D: H  s

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   $ X5 @9 b* Z$ \; V/ w
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

  uint32_t   ChromaSubSampling
  ?2 Z- R" B: C6 M设置前景色或者背景色中YCbCr 颜色模式的采样格式，具体支持的参数如下：

1. #define DMA2D_NO_CSS               ((uint32_t)0x00000000)  /* 4:4:4 */
   
2. #define DMA2D_CSS_422              ((uint32_t)0x00000001)  /* 4:2:2 */
   
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，定义如下：
- J& P! K. v+ `# i7 Q( B

1. typedef struct __DMA2D_HandleTypeDef
   
2. {
   * _5 K8 [& U" D
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   + Z; s- q7 w9 S! X5 K( q5 m
4.   DMA2D_InitTypeDef           Init;                                                        
     B! k+ g: b9 c0 L/ o  t
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   2 w* A, W0 ]9 G. B7 K$ A
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   0 `; D+ s; N$ K: M+ p& P
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   ' O9 m" \, r) h
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   " n- e. I3 a) Q$ b8 p+ U: h  t" K- ~
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    

复制代码

+ p7 @/ _3 q! _! E下面将这几个参数逐一做个说明。

  DMA2D_TypeDef  *Instance
, z1 J8 c# z+ @8 X$ z$ Y这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

  DMA2D_InitTypeDef  Init;  
这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。

/ {8 k$ [$ D" n% n* O$ P* Z4 F  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
3 E! n+ H0 R% b  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。

4 `5 U) v$ `+ L4 `. J4 ~  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。

' b$ J* t: c7 s. }6 `" F  HAL_LockTypeDef   Lock
__IO uint32_t    State;
, f" `, A" k- J  }; e) f
: q' ^: m3 k8 B" h__IO uint32_t    ErrorCode
4 C1 W. q& k# |. }2 `
这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。
1 P$ _! X; {. _+ P# B) W
) x6 E; ]- {! ]1 L55.3.5 DMA2D初始化流程总结
对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

55.4 源文件stm32h7xx_hal_dma2d.c
这里把我们把如下几个常用到的函数做个说明：

  HAL_DMA2D_Init
8 T" }( g5 j1 t0 w  HAL_DMA2D_ConfigLayer
  HAL_DMA2D_Start_IT
  HAL_DMA2D_BlendingStart_IT
9 j/ I2 e0 r' h4 f1 F9 E" c& i& M
9 v7 i5 }4 p* y( [' v55.4.1 函数HAL_DMA2D_Init
函数原型：
0 c/ p6 k* X3 ^# D; h

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   , g7 _3 e7 C; P3 S+ b
2. {
   
3. 
   ! h6 p3 N8 g) W- N( t) Z# f, X6 d
4. /*  检测参数是否有效 */
   1 m" \" Z& K6 z5 J' P
5.   if(hdma2d == NULL)
   
6.   {
   
7.      return HAL_ERROR;
   9 q# l% F" [5 f' ~& A5 g
8.   }
   6 ?) r) D( v* V% r" x
9. 
   8 y; y  ?) u7 x: H) D( u
10.   /* 检测函数形参 */
    
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    6 p' V8 ~& G# b/ e5 A& C4 M3 R$ |
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    $ [' C4 M% n( C6 V' L' [
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    
15. 
    
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    
17.   {
    1 O7 {/ N/ m6 A. R: Q9 G
18.     hdma2d->Lock = HAL_UNLOCKED;
    
19.     /* 初始化GPIO，NVIC等 */
    
20.     HAL_DMA2D_MspInit(hdma2d);
    
21.   }
    ; T: t' p- n. G
22. 
    
23.   /* 设置DAM2D外设状态 */
    ' n0 b9 }  ]* k6 ?$ Y7 Z
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
25. 
    
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    
28. 
    
29.   /* 设置输出颜色格式 ---------------------------------------*/
    
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
    5 `/ z; L( W6 D4 p# J! w; m+ {
31. 
    . B/ h& C# q' \- [* K$ K8 H, g
32.   /* 设置输出偏移 ------------------------------------------*/  
    6 `, N$ g# _% b9 C
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    ( X2 \( H! w8 p% o: E7 u0 }  A
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
    3 e0 j3 ^0 O- n' ^  f0 `2 [, t% Z( i- \
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    , w' [0 D3 n' \2 w7 j4 D: j
37. 
    " e! h- k' f3 {1 ?# f
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    6 \1 C( J7 D8 ]$ M3 e% T3 p2 @
39. 
    7 [6 L: c% s9 M; Z2 b8 @+ z' _+ C
40. 
    
41.   /* 无错误 */
    
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    # p1 _8 ], Q) [+ k
43. 
    ' L1 ~' v6 U8 i
44.   /* DAM2D就绪 */
    
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    3 r( W2 H. @. w* W: b1 q4 m: Q
46. 
    1 {/ `3 ]" f0 B+ M
47.   return HAL_OK;
    
48. }

复制代码

函数描述：
* s; a$ N$ R; n% R2 |: M9 H
: i, p/ u9 C6 A; n5 C( _" N9 ^此函数用于初始化DMA2D的工作模式和输出颜色格式。
- p4 d) j' E- C
函数参数：

  E5 \1 `: K% o) @5 q* R- L, v  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
注意事项：
8 _# W2 Q# J' }5 h2 k( S+ ]0 F$ U
2 x/ {6 J8 f0 C6 ~# \" C4 k6 X2 b7 F函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。
/ H; c7 h. A- f6 r
解决办法有三

9 p9 X' _5 R- d$ B方法1：用户自己初始DMA2D底层。

6 w! |+ r9 E9 w+ Q! `$ ?方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。

5 Z' e1 T9 ]4 i方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   # ~* ^- C& U5 w" W9 j
2. {
   
3.     Error_Handler();
   
4. }  
   
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   
6. {
   
7.     Error_Handler();
   4 T; l' S9 n( C9 G0 z& ]
8. }

复制代码

$ z! i# U' Z; J5 N8 u6 o" l1 M使用举例：
/ A+ q1 W2 O* @% {# t4 E1 B

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   * n- U! D& i/ S; g/ F1 m" H
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   $ U+ @, t( k2 V5 k  S3 J
4. Dma2dHandle.Instance = DMA2D;
   
5. 
   
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通过不切换 */
   ! t( _3 x; x4 Z
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    1 C9 u' ?( Y7 N) Y7 S9 n
11. 
    : q) y" {+ D5 M2 v' y1 F
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    0 b( V2 l8 P/ l. |5 t5 {4 @
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    - m2 f8 b0 L  O  A1 E7 p" J4 ~# |
16. /*##-3- 前景层配置 ###########################################*/
    % a- w* X- ?" F" R
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    ( \" p  V% D  E' ]. P$ y$ l
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    ' t4 Z9 w. F6 d2 P! y6 N
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    ! w: c& Z! z  K! ~" l5 m$ Y: U
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    5 b2 U- N9 l6 A* C  e
23. 
    3 r3 W& i- u& w  W- A4 X/ [
24. 
    " X2 J# l( l# M0 x5 B$ B
25. /*##-4- DMA2D 初始化 ###############################################*/
    - {3 r. |6 d+ t5 y3 R! ]
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    ! U4 d! G- W6 K
28.     Error_Handler();
    : }* Z* Z( n) I* ]  u/ ]/ k
29. }

复制代码

55.4.2 函数HAL_DMA2D_ConfigLayer
! Y3 l4 U, u- x: K. K' J函数原型：

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   + m2 _( o  \! h9 \, T4 C( J! e
2. {
   
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   8 b7 z4 |- j* Q$ _; @
4. 
   " V8 I3 R* i1 n4 w* E9 i" v& O: K
5.   uint32_t regMask = 0, regValue = 0;
   4 O* H( a7 ~# Q6 t
6. 
   
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   ! L5 I0 W) B3 H) l% j  K
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    " A+ _# j6 i) _+ _, p
11.   {  
    % H/ Z) B: n" c) C5 x5 q
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    ' L! R$ d* S+ k4 r" }
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    + `% G8 Q  W) e8 r
14.     {
    4 L" Q3 `: U8 H  v6 J( {- v
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    
16.     }
    0 e' m- G' V0 Y
17.   }
    / ?' T  }6 D1 k8 k2 k" L" c; q$ z
18. 
    & c% Z* F  R2 ~1 h2 O2 k
19.   /* 上锁 */
    * z) i! y: \: G3 H
20.   __HAL_LOCK(hdma2d);
    - t, L8 W6 C  ]7 a( q- D0 T
21. 
    ) s+ U8 w% I' Q1 p8 G1 H
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
24. 
    6 m5 @- V( r  O8 V5 W8 [. e
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    $ m. l" R- k  `( r' T0 ]7 ^. T
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    5 Z4 D) n! ~9 ]' v# p+ r0 R
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    
29. 
    % t8 f2 M6 @/ o2 b
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    
31. 
    ' ?1 z  B! c% }  C3 `5 U
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    , I& C1 T2 Z; }" e9 K
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    ) O- k7 j) `: N4 S
35.   }
    # J6 j0 ^1 k. y0 A* t. |. _
36.   else
    + @- ?" C0 G) q! v  t! Q3 L
37.   {
    
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    ( |: w% X. I  g, h" ^# O" }! Y
39.   }
    
40. 
    & ^1 [4 a1 @# R8 [( ^; ]' v$ K& A3 G
41.   /* 配置背景层 */
    1 X9 K  B- H" M* U# B$ b! u
42.   if(LayerIdx == 0)
    
43.   {
    ; \, O9 p  `2 V1 F& r6 H  l
44.     /* DMA2D BGPFCCR 寄存器 */
    $ S- T+ j4 b# l2 ?  I
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    
46. 
    
47.     /* DMA2D BGOR 寄存器 */  
    / P& R: J* c- L* s2 o$ `- _
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    " m! z8 @; a! H% R( W4 h) U1 Q  ~
49. 
    4 f; K, I2 C, L; w9 e5 U2 ?
50.     /* DMA2D BGCOLR 寄存器 */
    
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    6 n* P/ L, U) r1 s5 R6 z6 B
52.     {   
    " g* M  i# z' U9 S
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    
55.     }   
    1 ~* ]1 j- h6 x: c# {
56.   }
    ; Q$ J0 W3 u" Q; N8 S  A, ]4 ~8 p
57.   /* 配置前景层 */
    
58.   else
    7 g/ e5 y5 Q8 J9 j
59.   {
    ' |) z, F6 e( \7 a6 Q. A
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    ' {+ ~1 _+ l1 `6 E/ j% k
61.     {
    9 o7 \$ U( C0 L" g
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    
65. 
    
66.      /* DMA2D FGPFCCR 寄存器 */
    
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    7 g& f* M4 r' V- @+ t8 q
68. 
    
69.     /* DMA2D FGOR 寄存器 */
    ( q. W7 p0 L& m4 h
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    & I. l. W6 T3 X5 r) R: W
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    9 W& p9 i" W6 H8 i8 X
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    $ H) D& n: q' Y! {' z; v
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    
77.     }   
    
78.   }   
    
79.   /* DMA2D就绪 */
    
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    
81. 
    ) Y: W7 D- K1 C! ?0 K
82.   /* 解锁 */
    
83.   __HAL_UNLOCK(hdma2d);  
    
84. 
    
85.   return HAL_OK;
    % @1 ^% w5 B* b
86. }

复制代码

+ r5 t: E$ I. j1 p函数描述：

此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。

8 a4 x5 N; ]- a8 G$ l* Y  E" c% O函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
0 Q# `0 p* f5 ~* B. _: F  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   / y! v! k  ^# M7 j; {( K9 C
3. 
   " z8 v8 C6 G2 y% a* t
4. 
   
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
6. Dma2dHandle.Instance = DMA2D;
   ; O  }9 g/ ]5 A  l: b0 R- r! H$ K
7. 
   : t4 V: b: @2 F+ a; q3 I
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   7 _  @: u4 ~6 c
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    2 P9 `4 ~1 N0 F- x9 R7 Z
11. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    
12. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    3 _# f# o7 s( c/ u1 n
13. 
    ) d: b/ r9 s. s/ A  V
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    + t( b$ J6 e+ T% F
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    " ^# H4 `1 p2 `6 q+ l
16. Dma2dHandle.XferErrorCallback = TransferError;
    
17. 
    
18. /*##-3- 前景层配置 ###########################################*/
    
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    4 s$ D# O/ R: {1 n/ v  U( x
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    3 S0 d, [, O3 g+ [! ~& F
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    ( S4 p  Q3 ~7 h2 f
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    + |  i: y; n$ M$ ^* X: B* j8 `
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
25. 
    % D6 h5 H& ]+ d' ^9 s
26. /*##-4- DMA2D 初始化 ###############################################*/
    
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
28. {
    ( a3 i8 T) n- ~- U
29.     Error_Handler();
    5 q4 s$ n) D: X. S/ A  k
30. }
    
31. 
    ( A( J6 m5 ?* i+ Y1 n5 X( z
32. /* 配置前景层  */
    2 D5 F8 b/ X+ j$ f2 e: E
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    
34. {
    - F4 P& z7 x3 _( [0 @% Y
35.    Error_Handler();
    % ^" E. e8 Z) `
36. }

复制代码

1 a. N$ z+ m# n
55.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)
   # a' {7 x- b5 G
2. {
   
3.   /* 检测函数形参 */
   ; T! X& c' m, n  ~
4.   assert_param(IS_DMA2D_LINE(Height));
   + Y1 h! p% L3 k  b: P& s
5.   assert_param(IS_DMA2D_PIXEL(Width));
   : U4 a7 D0 J; U4 v& _; K
6. 
   ( N: e, ~+ c- i- J: ~
7.   /* 上锁 */
   8 d; q: G, R. p3 G& K+ x
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    # ~& D: u2 H7 l6 L- I
12. 
    4 o; a5 {3 z5 j; \
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    * v% `: w, s  l/ `1 ^
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
18. 
    ; q4 V" }! o1 k  r* v! K
19.   /* 使能DMA2D */
    
20.   __HAL_DMA2D_ENABLE(hdma2d);
    
21. 
    8 |& O1 W& b& i+ g# |* a$ B
22.   return HAL_OK;
      |, i" H& @* z  U. M( w
23. }

复制代码

3 g( u( i0 e2 |, ?4 ^函数描述：

2 M) T7 r' m- W% m) U. P  B此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。

8 B" t1 b+ C& U! z& n2 Q函数参数：
( X9 I% t0 k6 j- Q
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
9 K) ?, q8 Q# ]1 {; ~  第2个参数是源数据地址。
6 S6 d0 A  J1 V2 {/ g) u  第3个参数是目的数据地址。
' N. K( B3 J& w: M$ C: X# U  第4个参数是源数据的长度，即每行的像素个数。
8 I- d: I5 E4 {# A  第5个参数是源数据的高度，即行数。
+ [  E; w3 e) @! F: S0 @* q) w5 c  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
. l+ u& {2 ?  p1 N4 [2 @

1. DMA2D_HandleTypeDef Dma2dHandle;
   * [) I5 g, _3 Y/ ^2 D
2. 
   8 z' ~$ l# I" v0 [) N: t
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   6 w4 y9 U0 O4 G. I5 W
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   & ^' e+ H/ C! R* n7 }
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   6 X+ v# l3 L5 F3 s( q6 j
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   
7.                       SIZE_Y)                  /* 源数据行数 */
   9 w: L/ T0 z& U2 h) S  s
8.    != HAL_OK)
   8 ^& F" E; r- a6 H, P
9. {
   " K; [5 w0 w2 V% m& f; _$ o  H
10.    Error_Handler();
    , z* o; ]' W; Z+ K+ |  u1 h
11. }

复制代码

9 |7 s& k; p/ E: D1 g) n5 O55.4.4 函数HAL_DMA2D_BlendingStart_IT
函数原型：

3 z" x) A  H, w$ A

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)
   % l/ w' h" p1 ^- m$ z# e
2. {
   0 s: b* t, c1 [/ B1 |
3.   /* 检测参数 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   . c' O3 V! J& j7 c! `1 N
5.   assert_param(IS_DMA2D_PIXEL(Width));
   7 W/ F/ W- J1 Q
6. 
   # }  }6 `3 F9 z1 U
7.   /* 上锁 */
   5 z  c1 T0 ?5 x5 O$ b; \2 h
8.   __HAL_LOCK(hdma2d);
   
9. 
   ( V" G6 N% q; J3 U7 G* h
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    ' V) d" M+ `# w% o
13.   /* 配置DMA2D源地址2 */
    
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    - W6 ]7 Z( ?2 z& T2 f% }
16.   /* 配置源地址1，目的地址和数据大小 */
    / S( H1 W2 s; B
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    0 Z# r9 s( S/ s( \: l9 l
18. 
    & `% {, a; v$ ?4 \) t
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
21. 
    ' G* G/ n7 {6 Y* s" x! T& q0 z5 d
22.   /* 使能DMA2D */
    
23.   __HAL_DMA2D_ENABLE(hdma2d);
    . E4 {7 O- W! h" T$ R4 W
24. 
    
25.   return HAL_OK;
    : _* \- H+ g; r1 J2 {/ u
26. }

复制代码

- W; _9 V* j9 D; S! O( ]/ K  _函数描述：
' ^2 j4 ~- D1 `
! Z1 E6 u0 k5 n( c- Z此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
7 g! Z$ k) S! ~
/ {6 C$ S( l9 _& ~8 K函数参数：
* {3 F+ c! X, P# v- U: {" M. r
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
+ _4 m# ^; l7 Q3 v/ T  u/ r( R  第2个参数是源数据地址1。
  第3个参数是源数据地址2。
  第4个参数是目的数据地址。
  _- l4 V& |. O. p  G  第5个参数是源数据的长度，即每行的像素个数。
  第6个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
1 a# \- k' T% ?3 A, M. s使用举例：
' r6 b; [. f8 M3 [8 B. q+ n

1. DMA2D_HandleTypeDef Dma2dHandle;
   2 D* I* O- _4 `: V: d5 W8 ]" z' l* Y- z+ ^
2. 
   - u; V/ F* _8 R9 ^! Z3 ~" |, K
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   3 ~! r6 V+ ^) Q( |" ^. ]) K
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   + r0 G' r8 T8 I( ^- h
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   
8.                               SIZE_Y)                 /* 源数据行数 */
   
9.    != HAL_OK)
   1 E* B4 i4 l$ _7 C0 w0 g4 G% q
10. {
    
11.    Error_Handler();
    ; S- |3 c1 H; N  n9 s+ r' v
12. }

复制代码

55.5 总结
3 B: Y+ a" p4 b4 k8 y; {% y& k本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。
$ p* s8 J" ]$ E; k) c+ Y6 m
5 h( c" I, g8 ~+ I
9 D& z! Z8 g0 l  T: N# v; U
! g" l1 _/ K% M. k