55.1 初学者重要提示
' f6 o, q! q8 f' m( P  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张
- w( S( I( ^: a4 N+ r& ]% {  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
* g- C/ H  a" A( `2 J; W55.2 DMA2D基础知识
( Q' V9 @0 E% ^4 V! O9 sDMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。
! S. _- _5 s; }: M
' ?  @, ^$ D) d6 f9 [' z0 N- I  DMA数据传输
+ R* D/ w# T/ H% j8 C; H主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。

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

55.2.1 DMA2D硬件框图
2 A1 G5 U7 v$ w! d2 s( G7 ^* ~认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

9 ?- z( P8 B9 U$ U6 _
6 g) S2 b/ V; P! R) a通过这个框图，我们可以得到如下信息：
4 A% N6 Z% }- W# C* ^6 |1 ?
  B% q( D& l$ ?) ~: L* |3 P# Z4 J9 w( d  dma2d_aclk
; g; ]- o8 A6 JAXI 总线时钟输入。
$ X$ S, Z( ^- s6 ]1 {1 L
( K" `0 I0 N1 F$ \  dma2d_gbl_it
: B9 q+ y3 c! k3 [- q, c7 jDMA2D全局中断输出。

3 \& h9 l, d$ H+ `0 S4 L  dma2d_clut_trg
8 D0 k9 R) _1 [: z1 ]CLUT传输完成信号输出，可以触发MDMA。
: q) o- o8 s5 l1 M) d. x! s
! q# ~5 T) B- q/ H4 }  dma2d_tc_trg
传输完成信号输出，可以触发MDMA。
4 ]! `: L7 G. |& }  S
4 I; z9 t( Z9 G# Y  dma2d_tw_trg
6 D4 N* Q5 F5 w5 I传输watermark信号输出，可以触发MDMA。
5 ~0 Q& Z' t( A# c
6 z; h. C- C3 d将这个硬件框图简化一下，就是下面这样：
  D# N6 k* v8 Z! N9 H; q  P
0 F/ L. t* f! n7 D

9 Y7 Z8 {2 B; i+ v9 {! R5 n6 K
下面按照简化的硬件框图，对每个部分做个说明。

55.2.2 DMA2D工作模式
  Z; D) B* s% R3 L# \0 TDMA2D支持的工作模式如下：
/ U4 |4 \) J9 {: S+ c: Q
  模式1：寄存器到存储器模式
这个模式主要用于清屏，也即是将显示屏清为单色效果。
) N: ?. J4 [& [! ]; t# r
" c  u) J. E2 a+ s  模式2：存储器到存储器模式
9 Y1 {2 {8 k6 a) u0 O这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。
% P' B) R+ W# Y' R  h
  模式3：存储器到存储器模式，带颜色格式转换
这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。

& N- @8 ~1 b* s  ^  模式4：存储器到存储器模式，带颜色格式转换和混合
. h3 T: k+ E) \# c: r9 F/ i这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。
1 Q/ }- u- P9 a0 F, x" Z$ ~+ T
0 `2 N# E6 s1 h, `. e7 k* d' v7 F4 y  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
9 [. f' n4 M. u) K+ r* C同模式4，只是前景色的颜色值是固定的。

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

7 Z" l9 T4 s  D( P. g9 S# g4 H  KDMA2D支持的输入颜色格式如下，前景层和背景层一样：
5 w, d+ O, e" z1 h" j
# p+ b+ S  `" Q# e. W

9 M6 b0 C* Y7 a% h( k# S
前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：

- x+ M  |+ A, r5 d* k4 P  L4 (4-bit luminance or CLUT)
4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。
/ z3 @, R# v: i" z, D
  A4和A8
( c' ~, Y  [( IA4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。

  YCbCr
" t3 l( d+ ]7 }这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。
7 G: ?! z7 y: ~1 W+ ^& _5 A
8 p& S: e* o. N8 T: @这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

% `- K* O; u- L$ G* L3 l$ `2 q; _55.2.4 前景层和背景层混合
% |' X6 d. Y  V, B- J; KDMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：

- O: d; v+ k' n# B* ?7 {8 t6 k

55.2.5 DMA2D输出颜色格式
( n4 {: `" T* oDMA2D支持的输出颜色格式如下：

! Y6 n- n( D$ J6 ^" f2 F

; F' N; I2 t* Q. b5 R: Z* C4 k! Y这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

55.3 DMA2D的HAL库用法
DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。
( Z& n% j( Y4 T& W0 C, u
3 M4 p0 k# i& G7 ?6 {55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
4 H0 I5 [) n2 aDMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：

1. typedef struct
   . n7 G! Q* Q" n4 n2 V3 c" ~" \( r
2. {
   ' X4 ?* ~; N' ?9 S8 _5 Q% j
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   ' k8 R" T  i2 p- ?# ^: A$ J/ K) n( f/ y/ {# f
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 */
   ( k* `, b+ _. Y( U' T6 V2 T
6.   __IO uint32_t FGMAR;         /*!< DMA2D Foreground Memory Address Register,       Address offset: 0x0C */
   ! ^7 r- ]# _: b: W
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 */
   8 m6 o0 G4 e" `- P  }4 v( X
9.   __IO uint32_t BGOR;          /*!< DMA2D Background Offset Register,               Address offset: 0x18 */
   $ H: d1 d& J+ r6 u
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
    
11.   __IO uint32_t FGCOLR;        /*!< DMA2D Foreground Color Register,                Address offset: 0x20 */
    + L/ v; n* a8 X& O. C
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 */
    ; ~' |/ e& C' h% l1 |# f" Q
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 */
    " _+ ^( D% n7 J) J" U% ^! ^" x4 t
17.   __IO uint32_t OCOLR;         /*!< DMA2D Output Color Register,                    Address offset: 0x38 */
    * R" h5 A) z3 d4 f. ^+ i
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 */
    2 I5 E/ Z* y' X5 p/ E1 y. O
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 */
    . S6 k/ M3 P4 R3 D$ H0 M" O4 r* e
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    - ^; ^7 s" U; x2 ^, Q
24.   __IO uint32_t FGCLUT[256];   /*!< DMA2D Foreground CLUT,                          Address offset:400-7FF */
    
25.   __IO uint32_t BGCLUT[256];   /*!< DMA2D Background CLUT,                          Address offset:800-BFF */
    1 K9 Q; [0 d4 S& Q: S+ e  x
26. } DMA2D_TypeDef;

复制代码

5 L+ M2 ?+ N9 I. G
1 L$ K2 @. m1 R/ w__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：

8 Q$ @1 `! d; `" D5 C0 f; t

1. #define     __O     volatile             /*!< Defines 'write only' permissions */
   ; y( o9 O" K" E$ j; s7 z
2. #define     __IO    volatile             /*!< Defines 'read / write' permissions */

复制代码

# K6 }4 t* i4 y4 X下面我们再看DMA2D的定义，在stm32h743xx.h文件。

1. #define PERIPH_BASE              ((uint32_t)0x40000000)
   
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   $ D1 ?" F4 V( p/ i
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   & N$ L/ l; L( C! s
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

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

55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
此结构体用于配置DMA2D的基本参数，具体定义如下：

& h  _/ K, ^" \# Q7 E6 t6 x6 m' g

1. typedef struct
   # w6 Y0 m: R8 z
2. {
   4 ]  y4 k; y; R0 v) ]3 Y4 v
3.   uint32_t             Mode;              
   
4.   uint32_t             ColorMode;        
   . e+ D- D( ^4 Q: g0 C
5.   uint32_t             OutputOffset;      
   
6.   uint32_t             AlphaInverted;   
   ! z5 Z) x$ P) V1 Z3 ^3 A
7.   uint32_t             RedBlueSwap;      
   7 y* I; @3 `" b3 x: E; r, |9 L
8. } DMA2D_InitTypeDef;

复制代码

下面将这几个参数逐一为大家做个说明：

! h- Y) ^2 a, ~: e/ H  uint32_t   Mode
此参数用于设置DMA2D的传输模式，具体支持的参数如下：
( e& T5 @. T' x; G
5 @0 o6 f3 {4 [, u+ M

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   8 O$ I0 d$ I! e7 D9 _* d) @
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   1 J) F* s% [2 S5 y" J, F
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   

复制代码

+ [& e& b; l; P% t' v6 q3 A
& M% m2 O  v4 y2 o5 R  uint32_t   ColorMode
' _, j/ D* f; x, n! }4 N此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：

+ D$ b: E* V. m& k

1. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   5 L% z) I7 Z+ p1 _7 C
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 */
   / z. K% y& q5 C' z+ s

复制代码

. s4 N1 [$ H7 P/ g' ]
( U+ E& E+ l; G( O/ w( L. c  uint32_t   OutputOffset
此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。

  uint32_t   AlphaInverted
此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
* P. j5 w7 m2 N. ]7 J

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   # [# u9 @# S9 Q) s/ w7 j7 S/ _
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

  G2 _+ i. r6 v0 ]/ d: N  uint32_t   RedBlueSwap
. F  x# c2 P) F2 Q此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：
7 \( a  q* T0 C2 ^5 H

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   ) f" l# A( U& P1 g- R& H. N9 b: d
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

9 U1 a5 X# \! _. N; T55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
此结构体用于配置前景色和背景色。

1. typedef struct
   
2. {
   , U1 A  c' O7 o6 J9 z: _
3.   uint32_t             InputOffset;      
   
4.   uint32_t             InputColorMode;   
   8 D3 `# I3 V: A) }* P
5.   uint32_t             AlphaMode;        
   
6.   uint32_t             InputAlpha;        
   
7.   uint32_t             AlphaInverted;   
   
8.   uint32_t             RedBlueSwap;      
   ) A. `( R+ p7 W8 Z; p% @# I, Y9 R
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

下面将这几个参数逐一为大家做个说明。

  uint32_t  InputOffset
设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
9 G/ ~8 ?4 V0 [+ j. i- @/ h
! \8 h. x2 `3 G  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：
9 W/ s9 K' z5 b  @, H. L, a

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   ) n3 e3 }, U  `- H5 M: w4 ?
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   8 n2 d) r' B# q" X$ E# F
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   ; F" C) J! v+ j5 _2 [: [  d% Y
4. #define DMA2D_INPUT_ARGB1555        ((uint32_t)0x00000003U)  /* ARGB1555 */
   6 u2 g9 t+ ?) j( ?, t4 j
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     */
   
9. #define DMA2D_INPUT_L4              ((uint32_t)0x00000008U)  /* L4       */
   7 H' f+ i1 X) F  H
10. #define DMA2D_INPUT_A8              ((uint32_t)0x00000009U)  /* A8       */
    
11. #define DMA2D_INPUT_A4              ((uint32_t)0x0000000AU)  /* A4       */
    8 Z) N. _3 g* G2 ?4 Q. D" s
12. #define DMA2D_INPUT_YCBCR           ((uint32_t)0x0000000BU)  /* YCbCr    */

复制代码

0 N7 _$ |; h! w7 J" x. z  uint32_t AlphaMode
' q1 p. I* B6 B( R设置前景色或者背景色的Alpha模式，具体支持的参数如下：
" D7 R  ?! }' i# ^) d: d6 b
( Y. Z/ v* v% Z; u7 }

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   / j0 H9 ~$ S4 K& H8 A$ e- \5 a, v- c0 M9 C
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

7 p' O# C/ a/ l- }  uint32_t  InputAlpha
9 t9 @7 B- O7 Q+ m* K1 k, M; Y设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。

  uint32_t AlphaInverted
  \& m; @( @5 {1 |: `9 u设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
* I7 b7 a0 M! ^4 p! i" l' O+ k
4 k- J0 _2 D- s4 ~

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

复制代码

  uint32_t   RedBlueSwap
设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：
/ G/ U$ Q3 M2 f
6 o; ?% f6 k' T, i! m

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   . u. c* ^& y2 v7 ^6 F- S: s
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

9 s' z7 M  L. r* C0 F  uint32_t   ChromaSubSampling
设置前景色或者背景色中YCbCr 颜色模式的采样格式，具体支持的参数如下：

1. #define DMA2D_NO_CSS               ((uint32_t)0x00000000)  /* 4:4:4 */
   8 _4 m& W' U( b
2. #define DMA2D_CSS_422              ((uint32_t)0x00000001)  /* 4:2:2 */
   
3. #define DMA2D_CSS_420              ((uint32_t)0x00000002)  /* 4:2:0 */  

复制代码

: e- u! b/ D8 g) y+ o0 K# f* Z55.3.4 DMA2D句柄结构体DMA2D_HandleTypeDef
HAL库在DMA2D_TypeDef， DMA2D_InitTypeDef和DMA2D_LayerCfgTypeDef的基础上封装了一个结构体DMA2D_HandleTypeDef，定义如下：

1. typedef struct __DMA2D_HandleTypeDef
   
2. {
   ( B/ C1 \% ?4 e1 N
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   + o/ \% ?5 d' p" z5 B
4.   DMA2D_InitTypeDef           Init;                                                        
   
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   $ Y2 ~5 Q* @: g/ b
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   / s- f1 v2 d5 L7 |0 l" k5 ^
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   " E- ?8 D& b9 v) h, a" `
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
     V3 X( c0 E- V- p% S* C
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    

复制代码

2 @5 _/ U. e3 j2 K- s' z下面将这几个参数逐一做个说明。

. W4 l2 H# Z3 ?* n  DMA2D_TypeDef  *Instance
这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。
1 `$ B) I' j2 Y) f  \3 `( _, N
  DMA2D_InitTypeDef  Init;  
3 r9 T/ V; ]/ o- B5 c$ q这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。
6 {# h; o8 S* q2 }3 Q2 y+ M8 ~( O" Z
" K: e6 }9 x+ k7 Q  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
/ o& x% E  x  I5 E- \  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。
$ ~3 a8 k' t1 i+ Q
  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。

  HAL_LockTypeDef   Lock
__IO uint32_t    State;
: `* x3 t5 @0 U- D- G$ k
__IO uint32_t    ErrorCode
( P: O; H3 x7 c" W. y
4 g6 Y, M8 x3 Q& `这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。

- R& p+ O4 K5 w: b3 {55.3.5 DMA2D初始化流程总结
& b  }# L; U% J; j# W对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

55.4 源文件stm32h7xx_hal_dma2d.c
0 B$ `( N2 j+ ]* Z( |) }6 H: b这里把我们把如下几个常用到的函数做个说明：

  HAL_DMA2D_Init
8 T! }- V. j- z  X- H- i  HAL_DMA2D_ConfigLayer
& e" ~1 p! O* I0 a0 l" v  HAL_DMA2D_Start_IT
  HAL_DMA2D_BlendingStart_IT

2 z4 R9 V" b) ?. X2 `8 F( c55.4.1 函数HAL_DMA2D_Init
函数原型：
; H$ v% @: \3 J- M9 n  ]! r
, W: S( K% a9 Z3 W& m9 z4 ^/ W' d9 n

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   
2. {
   
3. 
   # C; ~' |3 a7 n: P' A3 j% B( G, `' h
4. /*  检测参数是否有效 */
   " A9 q* ?( {! d0 j5 H
5.   if(hdma2d == NULL)
   
6.   {
   
7.      return HAL_ERROR;
   2 e: o, _. k' @0 o9 h- b4 C
8.   }
   
9. 
   6 K1 l' ~) N) o/ R- x% r$ |
10.   /* 检测函数形参 */
    / e- V- V) L0 o" m' W8 O# q
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    ( b# Z! _4 r3 P6 s- \# Y9 l% f+ j
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    2 J9 |: R' u" G4 P/ a
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    
15. 
    ! H3 m) Q* ?5 ~. }
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    
17.   {
    
18.     hdma2d->Lock = HAL_UNLOCKED;
    
19.     /* 初始化GPIO，NVIC等 */
    9 O0 ~) ?/ r7 M- g9 ~
20.     HAL_DMA2D_MspInit(hdma2d);
    2 ?6 x* G, V7 \% u) H/ ^+ C
21.   }
    
22. 
    
23.   /* 设置DAM2D外设状态 */
    
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
25. 
    
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    . _2 t( [. n3 Z# R, ^4 M- [
28. 
    
29.   /* 设置输出颜色格式 ---------------------------------------*/
    
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
    
31. 
    1 [6 b" G8 M2 b
32.   /* 设置输出偏移 ------------------------------------------*/  
    
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
    7 X+ m! D: \  o! k
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    
37. 
    5 A+ U! r9 f7 A9 G- B6 e
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    
39. 
    
40. 
    
41.   /* 无错误 */
    
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    - g! S( Q3 M, f$ U
43. 
    
44.   /* DAM2D就绪 */
    8 H/ p* E% O  @) X( |+ u
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    - K9 v1 t& X; L4 g. z
46. 
    * Q! ?5 m. r! @8 n% q& ?5 L) I& l+ [) g+ p
47.   return HAL_OK;
    
48. }

复制代码

函数描述：

此函数用于初始化DMA2D的工作模式和输出颜色格式。
" i% i4 i) J, K" S; O0 j% j0 g
5 I1 Y: z2 ~$ Q; ?9 T, ]3 n5 ^% R& A# S函数参数：
' L  m% V7 d/ m
# p/ [. t+ C5 X4 N  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
注意事项：
# o) ~% o' P# Q
. {6 C+ ~& \0 k" M函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
5 L1 q# r/ |$ ~# y. b0 c对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。

解决办法有三

方法1：用户自己初始DMA2D底层。
- C( Z4 A  {. Q- A# |- I
* V: g$ M, t3 s6 z1 i3 \. d; j方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。
# r. p6 D1 X( q
7 _; x: @6 t; J5 n' d! S& U! p方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   0 @3 r" x7 E) G) m! @1 g+ I, c
2. {
   8 ~* F( n+ v* h: q& ]
3.     Error_Handler();
   
4. }  
   ' r2 Z6 `! s: E3 _8 A2 f# S
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   / n- K8 F! @' M4 D- J
6. {
   / A0 |' @, ~; n4 b3 H) o
7.     Error_Handler();
   
8. }

复制代码

- ?, j4 L( ~9 G  N使用举例：
  f  e) {/ o4 l3 E+ e& c8 T/ `, |

1. DMA2D_HandleTypeDef Dma2dHandle;
   $ t/ K/ |& o: s9 w2 U0 X* D
2. 
   4 P9 T7 m( W) C+ H; ~/ L
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
4. Dma2dHandle.Instance = DMA2D;
   
5. 
   
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   0 `7 U4 `! [: |/ |, K* t0 Q' m0 u
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   - I/ G+ u- c* H1 J9 [
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   % u! F/ P% S# e
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   / S2 p& h) g- H5 E5 F: {, m
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
11. 
    
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
14. Dma2dHandle.XferErrorCallback = TransferError;
    $ l5 t5 N6 ]6 P  g7 T; K3 D# k
15. 
    $ k9 i' W2 S9 t) Z; D) r8 Z
16. /*##-3- 前景层配置 ###########################################*/
    % ^) P" T9 H5 T5 C
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    
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通过不切换*/
    # Y2 y, Q8 C7 {, Y
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    - o+ j: }' L$ J' C: `! ]
23. 
    ; C/ ?; C* p: l! z! `7 i
24. 
    
25. /*##-4- DMA2D 初始化 ###############################################*/
    $ H' W1 ?% N5 `' Z; U
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    
28.     Error_Handler();
    % x7 Z8 \1 N  M! r
29. }

复制代码

55.4.2 函数HAL_DMA2D_ConfigLayer
: y" p. F. H& Y- `+ T$ [' k函数原型：
5 O. ~+ p5 E" t  d: \9 j
8 A; S! D. L+ o8 ^% A# X6 A8 E

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   
2. {
   6 D/ t& N8 w# {- o# p% Q
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   
4. 
   ! ~/ D% E# j; f) c3 v
5.   uint32_t regMask = 0, regValue = 0;
   : I5 g" e* I5 I& Q( v. w
6. 
   
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    ; F) O9 v* C4 i0 _; a
11.   {  
    
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    ! }7 B% u" e  S8 |2 @
14.     {
    % q9 N1 H6 }) G: K3 H! W
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    3 T4 P3 v2 d9 j* |' A7 {( ~& s
16.     }
    
17.   }
    
18. 
    5 Y- a- p! P7 B( S% k7 A8 {% n
19.   /* 上锁 */
    ! U: y1 m! C; K5 F  m* Y
20.   __HAL_LOCK(hdma2d);
    
21. 
    % l9 C! q3 `  w# a
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    * g+ z( y" v3 z, u+ q- d. w$ P6 F
24. 
    
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    ( R- n, R+ L3 s9 t- y/ t3 p' Y
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    
29. 
    
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    
31. 
    & b- K* ?* g5 R# A' p
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    8 Z! b- X. Y; Q* x" I
35.   }
    % ]% |1 c/ `8 Y: L
36.   else
    
37.   {
    - z" f+ T; V" y0 R6 u
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    
39.   }
    
40. 
    3 j& O3 N" g) f, k# x2 R# l+ w( W+ m
41.   /* 配置背景层 */
    
42.   if(LayerIdx == 0)
    
43.   {
    
44.     /* DMA2D BGPFCCR 寄存器 */
    
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    
46. 
    
47.     /* DMA2D BGOR 寄存器 */  
    
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    
49. 
    
50.     /* DMA2D BGCOLR 寄存器 */
    * [8 C8 c) e3 x- d  |& F8 E
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
52.     {   
    1 E; e5 y  b" Z* }: n, b" z* n+ I
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    
55.     }   
    - w5 e6 S: ^- ~4 ]- C' K/ V, V. T
56.   }
    , j" E& N8 N  ?. }9 p" `
57.   /* 配置前景层 */
    8 v0 m9 X$ y& ^( i1 p( S$ _
58.   else
    
59.   {
    
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    
61.     {
    
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    " \) c9 |" J; U; O
65. 
    : d9 }; [% ]' w5 s+ L
66.      /* DMA2D FGPFCCR 寄存器 */
    
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    8 e: h% P8 Z- Q5 Q, y
68. 
    
69.     /* DMA2D FGOR 寄存器 */
    
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    
71. 
    1 s7 M. K3 ]# u0 ~( w
72.     /* DMA2D FGCOLR 寄存器 */   
    + o( g3 N5 N( p6 s+ U: R5 z
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    0 K% P1 N2 l7 w, e, @5 Y! c
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    
77.     }   
    % y; F& Q& O( @. v
78.   }   
    
79.   /* DMA2D就绪 */
    
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    
81. 
    
82.   /* 解锁 */
    ! I) U( A3 A- K3 {; M2 m+ |. c+ F1 ]
83.   __HAL_UNLOCK(hdma2d);  
    
84. 
    
85.   return HAL_OK;
    
86. }

复制代码

) D9 I2 X# d2 e4 K函数描述：

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

! A9 S9 ]/ d) R  Z0 G/ ~函数参数：
: [5 x' D% `( P
' y# E( |1 ~# _$ O) J( ?  T  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
( B# A$ Y& W5 D使用举例：
$ M3 Y% O9 {9 p" P% J  d

1. 
   % U: N# y4 B$ ~
2. DMA2D_HandleTypeDef Dma2dHandle;
   
3. 
   ; a7 n6 i6 T9 U. ^
4. 
   7 O& K: g7 ]' L$ l: E
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
6. Dma2dHandle.Instance = DMA2D;
   , y+ k2 g5 T9 S
7. 
   
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   1 m2 Q  H& m! x
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   0 o7 C# e- K# w6 N4 q8 T
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    # l! c* T' N' s
11. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    
12. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    % h$ F0 u; W8 k6 \& }4 m
13. 
    7 m+ |- V+ ~9 B' }
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    " D& Q& S& |; N; Y1 T
16. Dma2dHandle.XferErrorCallback = TransferError;
    
17. 
    ; r8 U8 H& h) p8 R% Q9 s3 ~
18. /*##-3- 前景层配置 ###########################################*/
    0 g9 y- _0 i3 D; R7 Z" x
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    9 K' s( _; c' M! B5 s( c
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    9 B0 N" C) ^& R1 _! p- e8 j
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    1 [( r- ~' N. k% T4 O0 E/ T# I
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    % c7 c6 B. B" ~7 O2 T$ I7 ~
25. 
    
26. /*##-4- DMA2D 初始化 ###############################################*/
    
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    : v2 u7 t/ |& U9 Z
28. {
    5 F! @0 h0 U! t3 Q& C$ `
29.     Error_Handler();
    + `' p# W5 j' \+ H0 s: c
30. }
    
31. 
    # f0 j; u1 X) z5 l
32. /* 配置前景层  */
    
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    
34. {
    ! {6 F: R6 E) Y% |: \; h: f5 p
35.    Error_Handler();
    
36. }

复制代码

55.4.3 函数HAL_DMA2D_Start_IT
9 D$ }) b+ F  v/ N2 V& k函数原型：
7 G9 {. w1 z7 f& y6 G2 a

1. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   
2. {
   
3.   /* 检测函数形参 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   
5.   assert_param(IS_DMA2D_PIXEL(Width));
   # H3 \. m$ V  T% l
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    ) m- K, _" ]" ]7 h
12. 
    
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
18. 
    
19.   /* 使能DMA2D */
    * a- \. H- S$ ^; h' P
20.   __HAL_DMA2D_ENABLE(hdma2d);
    
21. 
    
22.   return HAL_OK;
    4 {8 Y( e' l' k. I+ C3 m. A" t
23. }

复制代码

3 V, S0 L$ y" L: y+ a/ k函数描述：

0 x5 A! t3 c6 o# x, S7 N此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
' r5 q$ O7 T/ ~6 g" i6 v" c
, k7 R( S- U6 T, u函数参数：
& N/ a' {% U- B* C* B+ Y) S
# Y- B8 {! M6 c) K  Z  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
; }8 E: U) F) \3 Y' g  第2个参数是源数据地址。
  第3个参数是目的数据地址。
  第4个参数是源数据的长度，即每行的像素个数。
. j7 A3 b* c2 ]6 C9 ?6 s  第5个参数是源数据的高度，即行数。
* ]- V9 r. j; m  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
5 b% s5 v5 ~2 U# ]( {# G

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   ! u1 y" k+ A; A# B' P
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   . S" [; O, ]$ S1 [- M
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   
7.                       SIZE_Y)                  /* 源数据行数 */
   - D( G, N* t" w+ K& c4 t
8.    != HAL_OK)
   & y1 i. Q$ O0 f2 P3 Z* s! |
9. {
   $ p( a: i. D( z- n& s
10.    Error_Handler();
    % T( j& w; C/ s. u) K
11. }

复制代码

4 b$ w$ @5 r& A( z55.4.4 函数HAL_DMA2D_BlendingStart_IT
函数原型：

1 T4 Q. a, k1 b7 X  f

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)
   
2. {
   3 j) s3 ~1 v: Y; t4 B3 g
3.   /* 检测参数 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   - e6 h; m* W0 q. O: A1 J7 ]
5.   assert_param(IS_DMA2D_PIXEL(Width));
   : B* K4 N' G; `* \4 O# ?2 w
6. 
   
7.   /* 上锁 */
   4 m! E; D% a' D' ~  A
8.   __HAL_LOCK(hdma2d);
   - N8 J3 r  b$ U% C' O# b
9. 
   * M, P% v# N; T, A+ _
10.   /* 设置DMA2D外设状态 */
    ! }# E& [8 _+ B, v
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    7 t# V6 a3 B+ x5 M2 N- ~, w* h
12. 
    
13.   /* 配置DMA2D源地址2 */
    
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    ; _. Q$ `5 a" W9 c5 A% b
16.   /* 配置源地址1，目的地址和数据大小 */
    
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    
18. 
    
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    ' Z' l' b- u( g
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    : {. q- ]# ~- W, |
21. 
    - X' b8 t) s: B' c" T9 y
22.   /* 使能DMA2D */
    0 w  ?/ P" s1 P% Z" P3 O
23.   __HAL_DMA2D_ENABLE(hdma2d);
    
24. 
    
25.   return HAL_OK;
    1 l" T! ^8 {+ V5 F5 k- b
26. }

复制代码

函数描述：
& {1 \( ~; v$ J) V9 q
6 i' x& c  j1 w6 ~! F此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
. {7 |& ^( ^/ ~) V5 z! a
$ H6 R# B- |: ]5 @' I: H: q; T函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
5 m! `8 M7 I0 }1 m5 b" [3 t. C  第2个参数是源数据地址1。
2 H0 @. E% k) s0 P* l, I9 Z  第3个参数是源数据地址2。
  第4个参数是目的数据地址。
  第5个参数是源数据的长度，即每行的像素个数。
  第6个参数是源数据的高度，即行数。
) }% w# c: e8 J, b  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
; ~" N4 |3 }  R4 x4 @# u使用举例：
! T0 Y+ `% ~5 H2 y2 X

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   ! s! b5 l  e, H
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   2 M5 ?! Y; `$ l0 Z$ K7 Z
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   + B) |; _1 S0 v* O( D9 y
8.                               SIZE_Y)                 /* 源数据行数 */
   2 t+ f' f: Y$ q6 ^, F4 a' G
9.    != HAL_OK)
   & e; Y0 p) Z, e# R
10. {
    
11.    Error_Handler();
    1 c2 [0 h$ o, k1 U6 X
12. }

复制代码

55.5 总结
本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。
; k! J8 h0 ]5 s+ x2 o6 s7 V4 c