55.1 初学者重要提示
8 J# q  Q: D# Q2 I( u: ~, ?  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
1 W: |( \* J9 r  y* u5 P  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张
8 o" Q: S2 i+ B/ k6 x2 l+ s  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
6 O# L. E7 Q7 P55.2 DMA2D基础知识
DMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。
( D! S% N* m9 D* g
  DMA数据传输
主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。
. t. h9 T7 T/ o6 z/ m* c9 I  \
  2D图形加速功能
支持硬件的颜色格式转换和Alpha混合效果。

/ A8 c! ?% R9 E, X" T9 m55.2.1 DMA2D硬件框图
8 I$ R  \. H" |' l认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

  t( [  q* I. W+ T- {! x通过这个框图，我们可以得到如下信息：

  dma2d_aclk
AXI 总线时钟输入。

  dma2d_gbl_it
DMA2D全局中断输出。

$ m% r, R: U/ n3 p% @6 d0 j  dma2d_clut_trg
CLUT传输完成信号输出，可以触发MDMA。
% z# g% \9 t% o$ o5 C, t$ P
. C' N+ P" I. X  dma2d_tc_trg
传输完成信号输出，可以触发MDMA。
% O7 f4 h- S! q5 n4 v6 |
  dma2d_tw_trg
, n  S) g# T9 I传输watermark信号输出，可以触发MDMA。

5 Y5 E8 a! L, z% m. d$ g将这个硬件框图简化一下，就是下面这样：
0 c) S2 {3 i& b7 x) \8 M6 s7 B
! G* h! L  }9 j8 `  R' U/ G3 H

! s4 {* q8 \( ]0 |" J, L5 W下面按照简化的硬件框图，对每个部分做个说明。
% }* }7 T2 P/ R  U
2 Z0 j# ^; ?' @, l0 E) ~4 c55.2.2 DMA2D工作模式
DMA2D支持的工作模式如下：
7 w& A/ w& O' |; x0 m
5 V1 q% E7 ^8 [* q( e2 p  模式1：寄存器到存储器模式
! W- J, X! c0 e1 R" w- M+ u' v1 S这个模式主要用于清屏，也即是将显示屏清为单色效果。

  模式2：存储器到存储器模式
- A, W: D+ i* a4 j# ~6 Q& c  h9 J这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。
9 z1 U: W3 j0 n& G& u; N  z( Z
0 }& L- w/ K8 A& r- \  V) S9 v  模式3：存储器到存储器模式，带颜色格式转换
& t) e* f' E* P4 V/ ]  K这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。
  h; ~( b  v3 `  ?' O  \/ f( }
  模式4：存储器到存储器模式，带颜色格式转换和混合
9 H+ y/ ]( k4 u8 l2 b. Z这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。

5 Z( j) T$ K* v- g+ r. I, S) y6 x  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
# j# T- t( ?# a; [$ s# N% e" Y5 ]同模式4，只是前景色的颜色值是固定的。

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

DMA2D支持的输入颜色格式如下，前景层和背景层一样：
* ~) r/ y8 S) S

5 J  ^. T5 I% D1 A
, k/ Q9 G9 X8 g1 \7 |' c前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：
- R: o- z: y# k& B7 e
  L4 (4-bit luminance or CLUT)
& ?+ r' ^( `9 Y& r+ j7 `* E8 V4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。
, v* p) a4 i' n0 ?1 i6 s' x
% [9 u; T  p+ S4 w, {2 h# i* O" H  A4和A8
A4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。
* y- E  q. v& A) t4 P
! M% J0 u5 r4 ?/ f( H) [1 J2 B; B: C  YCbCr
0 E# C# `, @5 h3 m这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。
% U3 G7 \+ b. u8 |
这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
( e8 m4 l! X% ]/ i: |6 k- f+ R8 |
8 a' e+ b' o8 q7 @55.2.4 前景层和背景层混合
DMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：

( t+ U* y# c3 J# B

, U% q1 h* b$ y+ H- V. C2 b
55.2.5 DMA2D输出颜色格式
DMA2D支持的输出颜色格式如下：
' X# C& I* `* W! {7 v, Z) J
; G% T$ I3 b* I% _. J

* c0 o) v0 U- G6 t
% Q8 H& p; r0 g1 B' _这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
) V- K) K/ }) q1 Y( N% Y4 ^) @
+ z  [: _, k! E0 \- y55.3 DMA2D的HAL库用法
( s. d. ~& ~; Q( z, A* V6 }DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。
) g7 q! o$ X1 I0 w
55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
DMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：

1. typedef struct
   
2. {
   1 l  @8 J% |; }# E/ u0 `7 [) U
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   # I  G" ~( E* c; U: J5 N  Q7 p3 M8 Q
4.   __IO uint32_t ISR;           /*!< DMA2D Interrupt Status Register,                Address offset: 0x04 */
   8 }: F/ w$ ~* G, `" K
5.   __IO uint32_t IFCR;          /*!< DMA2D Interrupt Flag Clear Register,            Address offset: 0x08 */
   . ^) N4 R8 K& y& K% D2 E* o
6.   __IO uint32_t FGMAR;         /*!< DMA2D Foreground Memory Address Register,       Address offset: 0x0C */
   9 e2 T0 |# n" R
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 */
   
9.   __IO uint32_t BGOR;          /*!< DMA2D Background Offset Register,               Address offset: 0x18 */
   $ K0 j! r4 q3 J1 N% d" j
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
    3 ]& N) c, M' ?: K
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 */
    
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 */
    
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 */
    " }" N. s8 D# i5 y7 z
17.   __IO uint32_t OCOLR;         /*!< DMA2D Output Color Register,                    Address offset: 0x38 */
    & F: D! ^  J; P' u
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 */
    ! e4 B& I. X, V0 w( j* n
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    8 H+ D9 K' Z0 H4 a; }3 S  ]
24.   __IO uint32_t FGCLUT[256];   /*!< DMA2D Foreground CLUT,                          Address offset:400-7FF */
    + |$ W! n. [7 R4 y7 e! {
25.   __IO uint32_t BGCLUT[256];   /*!< DMA2D Background CLUT,                          Address offset:800-BFF */
    # L; v1 ]' S, Q7 K5 @
26. } DMA2D_TypeDef;

复制代码

. Z) c6 ?) J4 v, T# K. l
9 j: `" H$ E7 m! {# m__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：

6 ^9 r( f1 Z! ?8 z

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)
   / W& T* x/ r1 v- W- y, {) R
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   , ^: p& F: @* [7 ]0 a5 t4 j
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。

55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
此结构体用于配置DMA2D的基本参数，具体定义如下：
# Z- j$ B2 i! {
1 ?8 D( n9 q8 U$ S3 R# p

1. typedef struct
   
2. {
   / V, E% k4 I3 V* r9 ^8 \4 _
3.   uint32_t             Mode;              
   ! k% b+ J  R5 t1 \/ @2 ?; k9 f
4.   uint32_t             ColorMode;        
   
5.   uint32_t             OutputOffset;      
   
6.   uint32_t             AlphaInverted;   
   & y4 S$ l$ r: j$ [9 P3 ^
7.   uint32_t             RedBlueSwap;      
   / C, z- _. q& o7 M" @9 D8 r" L
8. } DMA2D_InitTypeDef;

复制代码

* w- p% Q  Z6 r9 g; n+ |" r下面将这几个参数逐一为大家做个说明：

  uint32_t   Mode
此参数用于设置DMA2D的传输模式，具体支持的参数如下：

! k1 {/ F7 Z' k7 M1 L3 o, i

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   7 {. e6 b2 Q' M" O, i* P8 t
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           /* 寄存器到存储器传输模式 */
   . F3 I! n8 n  k! X4 ~+ e

复制代码

4 L* ?- _, \1 B7 s& Q& o0 Z" m
" U5 U/ |: J5 p9 c: ^  uint32_t   ColorMode
此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：

3 _* D1 _: r6 e

1. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   ; r0 n+ O! F) X8 U5 d% g
2. #define DMA2D_OUTPUT_RGB888         DMA2D_OPFCCR_CM_0                     /* RGB888 */
   
3. #define DMA2D_OUTPUT_RGB565         DMA2D_OPFCCR_CM_1                     /* RGB565 */
   5 a  \5 x( f1 j5 T' U
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
4 i( k9 ]% t  j8 Y' f" ?% y' |此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。

8 a: X* w' k& H( R+ D  N  uint32_t   AlphaInverted
$ N& o$ N3 C9 b4 G; C此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

: R: I  [- s9 z/ a" u- z

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   * I6 N: w  v' h' F' U
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

: Q( Y" `5 c1 b! V6 q( f7 y  uint32_t   RedBlueSwap
, I; l& |: m+ Z4 M# b此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：
* O8 J; B: P+ q

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

' |, x- V- h( |% ^% a55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
' d, k) @0 Z: Q! I5 n& C! B; j此结构体用于配置前景色和背景色。
% A& T- Y# a! k8 G' i' J8 @/ |

1. typedef struct
   
2. {
   % W% B, W" k# F' l6 ?' y' `
3.   uint32_t             InputOffset;      
   5 \, G: o  z# u& H
4.   uint32_t             InputColorMode;   
   7 g/ ^) j$ k, i& `+ F
5.   uint32_t             AlphaMode;        
   1 t5 O: H7 i7 D, B, |, d1 T
6.   uint32_t             InputAlpha;        
   2 ?) r9 n% a8 T5 T+ s
7.   uint32_t             AlphaInverted;   
   
8.   uint32_t             RedBlueSwap;      
   
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

下面将这几个参数逐一为大家做个说明。
0 J4 o' y8 `) X0 A& u$ Q: h, [& H+ m
  uint32_t  InputOffset
设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
1 M$ R; X5 T) p  D# c+ j3 R  M
9 d& r5 m9 H8 m4 ]  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：
, y2 K/ q8 I: J
4 a# A' o. J0 {3 ^

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   : s% V+ E5 x$ v/ F: n& `5 q
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   3 i/ `/ P' n" i% u5 ]
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 h: S4 X' U/ U. b8 S
8. #define DMA2D_INPUT_AL88            ((uint32_t)0x00000007U)  /* AL88     */
   
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    */

复制代码

7 p3 n5 M5 P" q: M, F  \, o2 i  uint32_t AlphaMode
+ U* b: z" K& M# @$ ^设置前景色或者背景色的Alpha模式，具体支持的参数如下：
6 w/ R# P1 Q3 k3 e* [% I* H

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   & n( E* [7 C8 A; p! p3 d
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

5 Y2 `# _/ p7 c  uint32_t  InputAlpha
9 E3 y9 r) }6 c6 w设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。

( e9 _- B. p) D' n  w+ s, C. V  uint32_t AlphaInverted
设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
; {$ r+ z9 |: N4 a$ H- C

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
     r; C1 D9 r: _+ t  ]4 F8 g4 e. f
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */     

复制代码

  uint32_t   RedBlueSwap
设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   $ w0 ^, y) q2 r
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

$ ], g$ W$ B6 z: t  uint32_t   ChromaSubSampling
' ~: L/ y, Z3 A& D* \) v设置前景色或者背景色中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，定义如下：

1. typedef struct __DMA2D_HandleTypeDef
   - a' E& M/ p# z: x/ n* `8 C
2. {
   
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   
4.   DMA2D_InitTypeDef           Init;                                                        
   
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   . P: r* G: `- `) ]) Q2 ]8 x( i5 i
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   2 n% }; Q4 E8 {! M6 H- _
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    

复制代码

+ x# z5 t* B& L6 j下面将这几个参数逐一做个说明。
  {6 K" G6 s+ P8 |: E% H1 t
( F& {9 j9 b: T2 V$ w  DMA2D_TypeDef  *Instance
这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。
! }" @: S5 b  }$ o* P& v  w! N- h1 V
) Q: E6 N. x# \* ~" Y! f0 O  DMA2D_InitTypeDef  Init;  
+ A* Z7 [# H$ _这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。
: x/ ~8 j. p; s0 P  |3 P- o5 U5 @
  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
7 \9 i0 H1 ^; a7 i$ i; IDMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。

  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
' k# z- K- Q6 J. S% R这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。

$ U% @" m/ b8 k9 f. r7 W$ M' \5 f  HAL_LockTypeDef   Lock
2 X, V2 ~( S% z__IO uint32_t    State;
$ H+ E4 }: t+ p  \# k0 p( R
! r- S& [/ j  A__IO uint32_t    ErrorCode
* {0 I( K2 [9 e5 y% s/ c
这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。
. z! y) I: w6 x* x
- P2 N4 V! ?, R55.3.5 DMA2D初始化流程总结
% ]0 X! Y- _) _% y1 N* \0 I: b4 S对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

& c% {8 m2 H8 x4 B  E5 o- [55.4 源文件stm32h7xx_hal_dma2d.c
9 h4 o. b0 F. e, p$ ~. O" j4 k% v这里把我们把如下几个常用到的函数做个说明：

! ^7 _/ q& H. }4 Q/ l) V9 u  HAL_DMA2D_Init
9 Y; S- z/ g$ A5 N: N/ w0 |  HAL_DMA2D_ConfigLayer
  HAL_DMA2D_Start_IT
; S& x0 W0 ~( n0 R4 `  HAL_DMA2D_BlendingStart_IT
4 {9 }2 ]5 c8 z: N  x
: _0 e" P8 A" |, ~55.4.1 函数HAL_DMA2D_Init
函数原型：
7 j/ k! u4 c4 h: x  M( D+ Y1 b; J
, o, G3 I3 ~5 x

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   
2. {
   
3. 
   : k* M" [) B+ H& C
4. /*  检测参数是否有效 */
   
5.   if(hdma2d == NULL)
   
6.   {
   / t& r7 O% w. t" j: F3 t
7.      return HAL_ERROR;
   
8.   }
   : {, Z; p' u! y( m
9. 
   
10.   /* 检测函数形参 */
    . ^& E% v6 o8 [3 Y$ ^5 {$ Z
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    $ d1 O6 a, z3 Y9 X# ~
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    2 i% M7 @; w: R1 c! U" D  k; `3 N
15. 
    
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    ; k3 M5 ^8 b7 _, y
17.   {
    9 k* ]4 o5 Z  i0 r( R: ~
18.     hdma2d->Lock = HAL_UNLOCKED;
    1 }9 L; P1 V; l
19.     /* 初始化GPIO，NVIC等 */
    / ?" ]" Y1 v- ^
20.     HAL_DMA2D_MspInit(hdma2d);
    4 D% ^# n7 U& X* ]! t$ q
21.   }
    
22. 
    
23.   /* 设置DAM2D外设状态 */
    
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
25. 
    3 S9 C7 r" w& [& Q3 D" Z4 F5 X- S) O) q
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    + R4 f7 a/ B0 Q4 t$ }0 u
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);
    
31. 
    % d; i0 S8 y, A$ u4 q
32.   /* 设置输出偏移 ------------------------------------------*/  
      D/ x. N" {- D8 [* e
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    / W2 i* H5 f0 A
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
    8 @3 h( q% w9 W# k! Q4 E
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    . O8 N" j0 n9 G& z1 P) [
37. 
    ' l5 o% Z- X( P8 O8 v& b
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    + q  Y: U  B9 J! \
39. 
    
40. 
    
41.   /* 无错误 */
    / |* ^0 _7 C; a9 z8 |: b; I
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    : \7 V$ h0 c. N4 e# {  R
43. 
    
44.   /* DAM2D就绪 */
    0 l3 i) r7 p* K' ]7 W* J
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    
46. 
    * ~( M# }) D5 b
47.   return HAL_OK;
    
48. }

复制代码

函数描述：

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

函数参数：
4 G  A7 g1 c9 E$ u
; L% m, O1 U7 p# J. v8 y4 h  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
注意事项：
6 [. k; ^" `9 ^5 [0 h. Q
函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
+ k$ s. C3 j* l5 F& N对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。
$ R4 d+ J- s% B3 p) m
: O" U% d8 h1 H: b; R解决办法有三
- q: m; o& `' `* i7 }3 c) E
" L! `. U- F' L6 B. e9 s3 k- K/ n方法1：用户自己初始DMA2D底层。

; n8 t  g) g6 U+ C  C% d, s6 X方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。
5 ?! [9 \0 f. A
( w8 f" H1 Y+ s5 j( t方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   
2. {
   6 a1 \7 p: z5 R/ v3 I0 H2 ]8 X
3.     Error_Handler();
   + S2 ^' h0 Q+ \) _6 M) p
4. }  
   7 `: C; Y# B1 s* o& t7 X4 w1 h
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   2 `' \' j. f7 b8 \+ e; H& M
6. {
   
7.     Error_Handler();
   9 F, m; |0 i& M$ R9 i
8. }

复制代码

! S( p$ k  u- o$ Q" X
5 ?$ S" q% J3 q3 l: d使用举例：

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   : Y0 L% F5 j; D( W9 f; R
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   ( R5 E3 V* N3 ?! |9 a2 u
4. Dma2dHandle.Instance = DMA2D;
   
5. 
   
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   ; P. j$ P4 ~. R0 C6 B
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    4 j4 Y* y  ?! o# J8 q
11. 
    
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    % R' V6 p8 K; u" D# d$ U
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    " ^6 u. e1 k6 f) b! U9 ], E
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    0 \2 }" f, s- d# f3 T, u: _
16. /*##-3- 前景层配置 ###########################################*/
    1 B! C9 }; q! ~/ }2 A' B0 S
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    - Q  n. ?. O1 K  U% V: h
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通过不切换*/
    * u( ~! l8 \% T. Z% o. F
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
23. 
      ~. P( Z7 `8 v  K% v1 [7 _
24. 
    ) w6 y; P! T" v& Z
25. /*##-4- DMA2D 初始化 ###############################################*/
    * r& b5 m+ x7 k4 ]5 e
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    
28.     Error_Handler();
    ' a1 P1 C9 N  ^0 M2 D, L
29. }

复制代码

& d7 ^1 x9 I+ k. s/ G7 x& E! \55.4.2 函数HAL_DMA2D_ConfigLayer
/ r( c: N! y1 R函数原型：

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   3 e6 t- B& E( f& i2 d
2. {
   
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   5 K3 t: V$ A7 ^$ f
4. 
   
5.   uint32_t regMask = 0, regValue = 0;
   
6. 
   
7.   /* 检查参数 */
   , I* k* n7 q' }9 v
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    * b2 a& j0 @) g# _0 ~% q
11.   {  
    
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    0 `+ l* Y) b4 k' W
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    
14.     {
    3 ~5 z' Z5 ?8 Q+ N* M
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    / l% u: Z! Z9 l  X# v
16.     }
    ) \$ f! z0 I% @& L
17.   }
    
18. 
    1 s  U4 y; E* R, V: w4 \
19.   /* 上锁 */
    3 |' K) W, e$ [0 s- p/ A; p& x
20.   __HAL_LOCK(hdma2d);
    
21. 
    
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
24. 
    . G) {0 o1 \2 ~# n0 w
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    ( i* u& B! y; x3 t8 x
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    
29. 
    4 _/ I0 f; k) W. ~7 k* Z& ]
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    
31. 
    4 {8 `5 W+ x7 G$ J* H  s
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    - `; Y* n) l- s' a
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    4 C: l6 [# }9 A1 m
35.   }
    6 }4 G1 x( s: l/ X) N. `% }
36.   else
    2 l1 S: H+ T$ n# l- q8 t
37.   {
    / Y0 A/ [7 K; z7 u/ o& k. j8 a6 V
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    
39.   }
    - X: A5 [5 X" [) W( }) k
40. 
    , u4 ^2 o7 J2 I
41.   /* 配置背景层 */
    / T8 y/ \  \0 ]; a
42.   if(LayerIdx == 0)
    ) C2 P' }- W0 b9 J
43.   {
    1 C, |# [8 e5 L% x% x6 o
44.     /* DMA2D BGPFCCR 寄存器 */
    
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    
46. 
    . Z2 b: v0 j1 s! C# r; b. k
47.     /* DMA2D BGOR 寄存器 */  
    ; y! q! k0 h0 Z9 @* A
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    
49. 
    . W4 q/ {& U' s1 j
50.     /* DMA2D BGCOLR 寄存器 */
    
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    - T7 B% ^+ t/ K  x9 z: w
52.     {   
    
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    : Z# j% c- z' N  `& m3 D
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    : ^1 C: M2 c4 x* @
55.     }   
    ) i; k- z* U+ X* Y8 b- m3 z8 y* A7 ]
56.   }
    
57.   /* 配置前景层 */
    ! @" _% ]; g& i4 u6 O
58.   else
    2 R5 u. Q3 N0 I
59.   {
    " ^! Q1 ^. j7 b; Q: D
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
      Q. G  {$ X( s
61.     {
    
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    9 b. h6 }& `( n  |6 G
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    7 {% j4 C6 m- {9 t
65. 
    
66.      /* DMA2D FGPFCCR 寄存器 */
    $ J' K  ^" s7 ]5 p
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    
68. 
    5 r4 @5 j2 `& {; h
69.     /* DMA2D FGOR 寄存器 */
    
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    8 K6 o( _$ \: k
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    . _0 C* g$ i' s6 o; e/ T
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    + P6 s% C7 q8 ]4 V- `% |+ `
77.     }   
    
78.   }   
    ( X5 T, w8 i$ z" ]
79.   /* DMA2D就绪 */
    / C8 W1 H: Z# g# G" _' s
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    
81. 
    % |* f6 S" V3 `% W% o
82.   /* 解锁 */
    8 I/ K* D& f" J+ G
83.   __HAL_UNLOCK(hdma2d);  
    
84. 
    6 @2 e' Q$ E/ H0 l# L' i) A5 t
85.   return HAL_OK;
    + Y/ |2 @) W4 W+ Y0 r5 W) U' e
86. }

复制代码

函数描述：

此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。
; Z1 O9 q/ h+ l: X! l  ~
函数参数：

/ x6 S8 F$ S8 Z/ W3 J3 s) ?" Z+ W6 D  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
- A" d. G* [: e1 B8 X, d6 G$ c  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
# I  A2 `# D" c) F1 _使用举例：

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   
3. 
   " D1 H# F  C5 j: e2 d2 z
4. 
   7 b; x9 a  V4 R7 [5 e% O  k2 C
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   $ G) t1 _4 U% u, F# Q$ u
6. Dma2dHandle.Instance = DMA2D;
   
7. 
   
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   5 @7 }7 Z, \5 v5 R+ X
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    * s( Y) J1 V/ U2 |) @
11. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    1 A" j; L9 r  P. T" I' Q- |/ b3 P
12. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
13. 
    
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    + k0 q1 s8 ]1 {% {1 D/ x( d. g) P9 R( p
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    ) m+ H$ q$ O- N/ l6 u$ j) `/ k1 [' S+ Z
16. Dma2dHandle.XferErrorCallback = TransferError;
    
17. 
    $ B2 E2 i! u, k, q" c5 M6 r7 d
18. /*##-3- 前景层配置 ###########################################*/
    : x3 s, J) s2 `* y; i/ D1 P" s
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    4 p9 `: X: u1 b  S+ G
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    . ?7 u, [% @) u2 q
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    * q' j! s0 w0 L+ h7 g% y
25. 
    ( g  B* ]& I6 y; m
26. /*##-4- DMA2D 初始化 ###############################################*/
    
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    + }; U6 H/ e/ h% D$ j( q3 G5 q
28. {
    ; Q. L( v% M5 C
29.     Error_Handler();
    
30. }
    
31. 
    3 T4 X- R7 p2 j. s5 y2 k
32. /* 配置前景层  */
    9 I5 Z; v3 C" _! V
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
      S* S* f  C. M3 J
34. {
    & t8 t/ T8 {) }0 N5 L
35.    Error_Handler();
    & t2 d, L* ]4 |) i& `. [9 M
36. }

复制代码

* w9 k3 C: O2 a4 y3 h% z
# Q9 R% |6 C) t5 x- z* {55.4.3 函数HAL_DMA2D_Start_IT
函数原型：

! F3 e) E2 u: s9 c' O/ B: z

1. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   
2. {
   
3.   /* 检测函数形参 */
   8 F( M' D: J7 a0 K
4.   assert_param(IS_DMA2D_LINE(Height));
   # N( k7 e% f' W/ @$ R
5.   assert_param(IS_DMA2D_PIXEL(Width));
   5 b5 u3 `* R' D& t0 ], J  q
6. 
   & s% k/ Z/ Z; ~# l5 X# b
7.   /* 上锁 */
   7 u! s$ J; n8 w( s; W  {/ \
8.   __HAL_LOCK(hdma2d);
   ; W9 k" s# `+ F4 G; z
9. 
   
10.   /* 设置DMA2D外设状态 */
    1 r0 I2 `! A  E
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    / X2 _' R. N7 B2 r- B  i2 h
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    6 o; I  y% C2 W+ [+ F7 M2 F
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
18. 
    
19.   /* 使能DMA2D */
    
20.   __HAL_DMA2D_ENABLE(hdma2d);
    
21. 
    4 W' N, _; ~* \
22.   return HAL_OK;
    ! \5 ~& i, J* ~& Q7 L+ G; Q2 l  f$ p
23. }

复制代码

: A7 _( G) D7 }4 w函数描述：
/ h4 X' H# i) x& h9 }" Y5 V
6 x& C  L8 d) T- b此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。

函数参数：
) O  e; G' U( Y( P; x
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址。
7 V) E) L4 m" X+ [: L3 Q8 E2 U0 Y0 k3 A+ `  第3个参数是目的数据地址。
  第4个参数是源数据的长度，即每行的像素个数。
- R* W% A9 y- D  第5个参数是源数据的高度，即行数。
* ?1 r; C  k0 _" ?$ l3 P0 ~' m; [  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

" O9 M0 \2 Y' d

1. DMA2D_HandleTypeDef Dma2dHandle;
   ( @' L' b% T$ K2 r+ K
2. 
     E6 A: x# H6 C! L
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   3 Y5 Y9 b) s7 v0 O
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   . q  i4 m2 Q2 P. M$ K- N" {( _
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   . r2 d5 R( |: }) E0 R
7.                       SIZE_Y)                  /* 源数据行数 */
   " `1 ]; e5 m; t6 _- C+ K; U
8.    != HAL_OK)
   5 G$ I# ], s$ T7 B* a% J
9. {
   - n& w  j+ e" w) `, @
10.    Error_Handler();
    
11. }

复制代码

55.4.4 函数HAL_DMA2D_BlendingStart_IT
函数原型：
( k+ \' ], \, Z3 c
6 a) M/ h6 `& q; F( |. p' V

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)
   # T  R. b7 d- @; Z, {4 H* E8 b
2. {
   
3.   /* 检测参数 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   1 T9 l$ ?9 V# `
5.   assert_param(IS_DMA2D_PIXEL(Width));
   2 ?/ k: y; v- }+ E" S& E( g
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    6 @& \/ N+ a" l; E3 E# _0 r
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    0 e# o* t3 L4 f
13.   /* 配置DMA2D源地址2 */
    ( H5 B! e, N! |! Q5 [  A# I- U2 U* h
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    
16.   /* 配置源地址1，目的地址和数据大小 */
    4 Y8 f* z$ x% b: d
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    
18. 
    
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    9 A; ^4 f% |3 [* Y# p3 t& M
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    7 \2 }/ K& @8 B, p7 {& r1 u  s
21. 
    $ Q, W) `% j$ y7 m- w0 z8 [
22.   /* 使能DMA2D */
    5 r6 u3 E1 k; k. c) h
23.   __HAL_DMA2D_ENABLE(hdma2d);
    
24. 
    4 ^1 q, b1 t# N" s. n- j
25.   return HAL_OK;
    
26. }

复制代码

函数描述：
) m% x* F0 |. ~. _
0 A, S$ F7 q; h5 @$ ]" D此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
# r+ T. M  J& D- ^
函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址1。
  ?' i$ v4 E) r3 i* `, K0 h  第3个参数是源数据地址2。
. b& H1 q: `' m3 D$ Q& N  第4个参数是目的数据地址。
  第5个参数是源数据的长度，即每行的像素个数。
4 H% V; F' E7 e8 m, y  第6个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

6 l- _5 G* o4 A4 p& [) f

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   ) H& x/ X2 {' u: \7 b9 U) A  V6 D: a
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   , E# Q# G2 L3 d4 I5 ?+ Y& z
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   0 L, P8 }" V& M# }8 F6 O
8.                               SIZE_Y)                 /* 源数据行数 */
   
9.    != HAL_OK)
   , Q/ q9 M) Y* X6 `9 d9 F2 B
10. {
    , |- P" i7 J0 A
11.    Error_Handler();
    
12. }

复制代码

. p2 P) o/ j, }8 @& R
55.5 总结
3 z0 x: m, g+ z' ~$ d  O本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。

; T+ v8 m1 x# M& _
3 w/ i: s& p1 a* R
" f" E% M7 X) S( y