55.1 初学者重要提示
  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
/ Q1 @. T$ D2 w2 j3 k" F  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张
  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
55.2 DMA2D基础知识
; D5 g7 n* W3 N/ u3 t, i% W) @DMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。
7 `+ g% j0 k# c, T+ ^6 E$ D# r! i% s+ }
1 L( P# q+ J% h4 U  DMA数据传输
6 C! ?8 w2 v. I0 A主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。

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

7 N$ y( h# Y- t9 }2 w55.2.1 DMA2D硬件框图
& h5 i, m  S8 d  Y; I' D0 c认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：
, N8 E/ o) s: r- x8 v! L

通过这个框图，我们可以得到如下信息：
8 k, j8 @/ V/ Y, |
  dma2d_aclk
AXI 总线时钟输入。

  dma2d_gbl_it
DMA2D全局中断输出。

  dma2d_clut_trg
CLUT传输完成信号输出，可以触发MDMA。
# f$ m+ l+ f8 f$ e0 R8 _
0 l- ?# l2 r# `. w: f0 Q  dma2d_tc_trg
/ f3 c! |( n$ o传输完成信号输出，可以触发MDMA。

  dma2d_tw_trg
5 n1 I* G7 ~# ~' W2 n$ z; ~传输watermark信号输出，可以触发MDMA。
7 W- C" V/ f: \. ]
! V8 e, L& {5 j" i4 R将这个硬件框图简化一下，就是下面这样：
/ C+ Q$ y  D; O; h  M2 ~; F, ?
6 ?2 N8 d. C& c# e

下面按照简化的硬件框图，对每个部分做个说明。
% A" ~2 p/ I, G
55.2.2 DMA2D工作模式
6 e; b6 @6 t. x# @DMA2D支持的工作模式如下：
; t: b, V$ k$ _
4 K$ W" Z( s" ~( A6 L8 v  模式1：寄存器到存储器模式
这个模式主要用于清屏，也即是将显示屏清为单色效果。
: S" F) i( h9 r+ E/ t+ g* `
+ h/ R( a2 ~* N$ t) `5 a  模式2：存储器到存储器模式
4 j& [0 K1 N7 W9 O; o- ~' Y这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。

! @' _3 q0 @  v$ x. g& |0 r2 J; Q4 G$ g  模式3：存储器到存储器模式，带颜色格式转换
1 W6 d, h. G5 x- [这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。

4 j2 |! @8 n8 D9 |( n1 S) O  模式4：存储器到存储器模式，带颜色格式转换和混合
! d2 x' u- a, u( V# n4 D这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。
: I0 t- Y; o) k5 C$ s: U
2 h; j! Y8 J: X  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
7 L9 B6 }; K( ?' ^4 k( R+ `5 [同模式4，只是前景色的颜色值是固定的。
' e8 l" Y4 d! B; o& M! ]
/ Q6 g+ V) I7 ?: q, B2 `55.2.3 前景层和背景层的输入以及颜色格式转换
  ]- {, s& z5 R前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。

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

! V6 M0 _7 X! z1 e9 @8 h* E

2 I, M) ?, F8 Y+ d% r
  }9 E# D8 n  `. R  _1 b前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：
% g, @  J/ h% v6 M1 @1 V
  L4 (4-bit luminance or CLUT)
4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。
. Q, d; P0 Y, _6 r8 f# o% O5 @' {
- _! b3 ]. b: p* p$ s  b  A4和A8
7 P- W5 k* d( P- O1 K4 SA4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。

  YCbCr
这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。

3 K4 k* F9 k9 T这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
) q9 |& u& Q( u. N- }! E' b
: {" I: r: l, v& Q! e$ C: p55.2.4 前景层和背景层混合
- f0 }* n1 {3 ODMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：

; j- X+ U0 u) g9 y5 X3 Z

! Q  x1 R! v6 U
55.2.5 DMA2D输出颜色格式
/ }5 ]6 [# k) y$ }9 ~DMA2D支持的输出颜色格式如下：

. l# c; g; Z4 s0 s0 d- q
; }) x3 L% r! D2 g9 ^. \这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
$ R# m/ o" O+ y: @  i+ O* z- h( l
: L, `9 U' i% k5 y1 z# L55.3 DMA2D的HAL库用法
DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。

55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
; }9 M$ ?0 s! s9 o" j; q/ J. m# j+ JDMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：
0 R9 o3 `* |7 N/ D5 K

1. typedef struct
   
2. {
   + i! Q* Z) J* v& b
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   5 g+ |" [& l- R( L: G
4.   __IO uint32_t ISR;           /*!< DMA2D Interrupt Status Register,                Address offset: 0x04 */
   & A6 V& o+ C7 Y$ F1 }( g2 z! e
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 */
   
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 */
   3 o( N7 u. T4 O7 F8 S+ y/ q
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
    " |% O) j  P# s8 i7 t1 W
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 */
    & g5 R' D" z+ U
16.   __IO uint32_t OPFCCR;        /*!< DMA2D Output PFC Control Register,              Address offset: 0x34 */
    7 ~- e) m( o* c8 M  _
17.   __IO uint32_t OCOLR;         /*!< DMA2D Output Color Register,                    Address offset: 0x38 */
    
18.   __IO uint32_t OMAR;          /*!< DMA2D Output Memory Address Register,           Address offset: 0x3C */
    
19.   __IO uint32_t OOR;           /*!< DMA2D Output Offset Register,                   Address offset: 0x40 */
    
20.   __IO uint32_t NLR;           /*!< DMA2D Number of Line Register,                  Address offset: 0x44 */
    
21.   __IO uint32_t LWR;           /*!< DMA2D Line Watermark Register,                  Address offset: 0x48 */
    % Y. W# `1 d# M1 j% D
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    3 J4 n1 \9 Y! \# V2 c9 l
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    
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 */
    
26. } DMA2D_TypeDef;

复制代码

2 S5 ?3 p1 m& ?. X. u
__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：

1. #define     __O     volatile             /*!< Defines 'write only' permissions */
   6 n0 D) i5 ^4 ?! i
2. #define     __IO    volatile             /*!< Defines 'read / write' permissions */

复制代码

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

1. #define PERIPH_BASE              ((uint32_t)0x40000000)
   0 P2 s2 m' \2 @( d( Z/ h* L+ F& e& O" _
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   2 g- e, {" A8 `" D/ s  b2 ?$ k" j9 ^
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   $ V3 X& r0 v5 a( v+ h+ `8 X
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。
/ {/ \0 Q6 K$ Z: Z( C5 U" k
55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
% I3 T1 z; O4 A$ R此结构体用于配置DMA2D的基本参数，具体定义如下：
6 Y! Y+ X8 X4 }
7 m4 Y! Y- w3 P; }

1. typedef struct
   - B* X6 |! V( y+ T& A1 |6 {2 H
2. {
   - N/ r/ S3 d) E
3.   uint32_t             Mode;              
   
4.   uint32_t             ColorMode;        
   3 H! \: W$ N% ^( q7 \
5.   uint32_t             OutputOffset;      
   
6.   uint32_t             AlphaInverted;   
   
7.   uint32_t             RedBlueSwap;      
   3 p, o- X6 D& @) A: ~
8. } DMA2D_InitTypeDef;

复制代码

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

  uint32_t   Mode
/ L6 w3 \4 y8 D8 b9 u. q此参数用于设置DMA2D的传输模式，具体支持的参数如下：
  T4 K% p7 Y/ g" [

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   2 J' L" r- v4 w3 [( y& S8 l
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   0 w. @0 t- W. o0 \
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   # f* X& O& g6 S! o

复制代码

$ X2 C& `; s% x( ]4 ~
5 d8 u8 J4 s, W) K) [; P$ j  uint32_t   ColorMode
# H% I3 J8 A' c* c, C此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：

, P9 q# v6 [  y6 B* J8 G

1. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   # W: M1 K- c8 I7 O5 ~, r0 S8 c
2. #define DMA2D_OUTPUT_RGB888         DMA2D_OPFCCR_CM_0                     /* RGB888 */
   * }1 E1 F. F) s/ ?  H1 c( k
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 */
   

复制代码

( h1 @0 x. `1 G0 t' P3 b0 j# \4 F) U  uint32_t   OutputOffset
此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。
# T3 I4 }3 Y! M' M
  uint32_t   AlphaInverted
) E* E2 u4 }8 L0 O( A此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

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

复制代码

  uint32_t   RedBlueSwap
此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：
8 x" T* V1 w' t+ T, q7 b! i* B
- g$ o; o1 l* }/ z$ D0 w( D" `

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   # o2 }' f. q* A' ?
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

9 i4 P/ x, q2 G, M( _! X9 [55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
8 Y! |: G" G/ z9 ~/ x& Q! R此结构体用于配置前景色和背景色。
# M: \2 ?) V3 ?4 v$ t

1. typedef struct
   
2. {
   
3.   uint32_t             InputOffset;      
   
4.   uint32_t             InputColorMode;   
   % M: o7 U6 ~" G4 R' `
5.   uint32_t             AlphaMode;        
   
6.   uint32_t             InputAlpha;        
   
7.   uint32_t             AlphaInverted;   
   
8.   uint32_t             RedBlueSwap;      
   
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

下面将这几个参数逐一为大家做个说明。
$ f8 ?' x2 N; l# V3 D! X+ S& u
  uint32_t  InputOffset
$ t# m4 t8 V4 s3 E$ w. I设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
3 Q6 J& i/ _/ o
; I# B. n  V1 R( [  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   $ y0 A+ d: V0 D
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   " o% P0 v( [$ V- q) c' E2 G# z" \; H+ Y) Z
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     */
   # D; X2 o( F5 p+ U
8. #define DMA2D_INPUT_AL88            ((uint32_t)0x00000007U)  /* AL88     */
   ! e; b: Y4 `/ t! C7 F+ z
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    */

复制代码

5 G5 X. T$ r& H6 F  uint32_t AlphaMode
设置前景色或者背景色的Alpha模式，具体支持的参数如下：

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   7 a* j3 R  S( {' A/ h0 f
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   * a; i7 n+ F5 g. T9 g+ d
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

  uint32_t  InputAlpha
  ~# y: x' U4 v( H7 a+ i9 {7 {设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。

, k* u2 M; `' H  uint32_t AlphaInverted
设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
0 w- N6 ~1 H. `* x$ x( s% l
, X$ h0 W( T6 w! x  ?; s

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

复制代码

" m& N3 |* J* C4 }7 ]  uint32_t   RedBlueSwap
. w7 u* d* G% E: Z. I设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：

5 a' d& y1 s* I0 S; b" a

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

复制代码

2 e& @" n8 Y% y, i  ^  uint32_t   ChromaSubSampling
设置前景色或者背景色中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，定义如下：
" r0 x) I8 S, e5 p& G; P: W0 ]
$ q9 ]( P9 L! K2 M( J% S3 I  s

1. typedef struct __DMA2D_HandleTypeDef
   $ M, o" `$ H8 S5 H
2. {
   ) t' p, n7 p2 |8 [# h' G1 {  N
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   ) @% W9 k% N  `% h; Q
4.   DMA2D_InitTypeDef           Init;                                                        
   1 R8 p' \4 V8 P9 k! _7 O& k
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   9 A1 s7 ~2 m# Y0 f7 Q
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   * i) `# R5 k' E6 Q5 b6 {
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   % T- q. ]) Q* {$ N7 r7 u. R
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   , e3 f1 H2 i% y. [. |% g( S
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    ; K9 `6 Z* N# {% S+ ~

复制代码

下面将这几个参数逐一做个说明。
+ s7 \( m8 R! @9 o
  DMA2D_TypeDef  *Instance
1 p" V6 y2 Y6 G: |: L这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

  DMA2D_InitTypeDef  Init;  
6 Z; k$ E! T$ K0 k这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。

' l# ]$ Y9 ?/ c  c2 v  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
# ^5 n, P. `$ X- ?  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。

  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
: g# b+ S+ [5 d8 s这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。
# w  A/ H- _5 r: F6 F+ H( g+ X
" Z7 b* C& F5 u8 Z  HAL_LockTypeDef   Lock
__IO uint32_t    State;
! y: e! g3 ^$ ~  p4 y
/ G6 l9 n: _- N) j' Z3 ~__IO uint32_t    ErrorCode

这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。

. E# n: a/ y2 J- ^55.3.5 DMA2D初始化流程总结
对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。
: Z$ n5 s" E* X4 q. p/ I3 i
55.4 源文件stm32h7xx_hal_dma2d.c
这里把我们把如下几个常用到的函数做个说明：
5 @" l( p1 Z8 ^# _1 v
  HAL_DMA2D_Init
  HAL_DMA2D_ConfigLayer
  HAL_DMA2D_Start_IT
8 l! Z, _. C% H, Y4 E4 w  HAL_DMA2D_BlendingStart_IT

55.4.1 函数HAL_DMA2D_Init
函数原型：

3 M4 t) a4 p1 ?) `8 M7 Z3 q

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   8 ~' j& b) Z5 |0 V! P7 g5 U1 }
2. {
   
3. 
     U( n: d+ G9 D4 {% Y5 O$ C
4. /*  检测参数是否有效 */
   ; N9 j( I5 m. ]0 X4 V5 E8 p, x) @1 w
5.   if(hdma2d == NULL)
   9 r5 w" m* z, J: E
6.   {
   # [% U( W) d% V, ~
7.      return HAL_ERROR;
   
8.   }
   
9. 
   
10.   /* 检测函数形参 */
    4 a0 i/ n" m3 a- W9 ?0 L# J! ?
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    $ z+ {! j2 H- q; |0 _
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    
15. 
    ) y" c: ?! `* V; `/ U
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    
17.   {
    
18.     hdma2d->Lock = HAL_UNLOCKED;
    3 W' {( h" |5 D& {$ q# x
19.     /* 初始化GPIO，NVIC等 */
      L8 l( q" x0 F& e( T
20.     HAL_DMA2D_MspInit(hdma2d);
    4 }6 |/ {" p+ K+ O" L! Y
21.   }
    : `7 V0 I5 V+ R  {
22. 
    
23.   /* 设置DAM2D外设状态 */
    
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    " d: Q. _, n( w& F
25. 
    0 k/ u: W. j4 M0 W
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    9 R. T2 ~: I+ e% R5 |
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    . M) Q4 I4 h2 Q' |- u6 @; r7 u
28. 
    # z- @9 M$ }/ u$ U& G' q0 ~6 N
29.   /* 设置输出颜色格式 ---------------------------------------*/
    
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
    / z# K: v$ {6 L0 A; P
31. 
    5 W! V' }% W. t; e- O' ^7 L
32.   /* 设置输出偏移 ------------------------------------------*/  
    
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
    
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    # u" M0 t/ z: A; @+ V9 j' m
37. 
    ; M, [4 z5 P4 W( }2 s/ \8 x4 a
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    % j# L4 W; K* P6 T# @
39. 
    $ Q( n! J+ v0 z1 v
40. 
    
41.   /* 无错误 */
    
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    
43. 
    
44.   /* DAM2D就绪 */
    
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    , t3 q( I, b& A+ i8 c
46. 
    * i( S- a) i, _7 g
47.   return HAL_OK;
    
48. }

复制代码

/ B: [+ v0 B# c7 r& O9 h函数描述：
5 ^  n! ?. [3 D3 Z: s
4 L, N0 R7 ~8 {7 q8 K( R此函数用于初始化DMA2D的工作模式和输出颜色格式。

函数参数：

8 `3 J0 N9 p1 G% t7 |1 z  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
注意事项：
5 l$ \9 d" `" m% e
函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
7 l6 W3 O7 ]0 `% \% p对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。
; M& p9 F. ~- B- {! l7 ~
解决办法有三

4 {' e: c) _+ R/ J5 @1 ]9 q方法1：用户自己初始DMA2D底层。
9 X% _! E6 a1 c: ^' _
, a/ ?8 _4 l9 B方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。

方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   
2. {
   
3.     Error_Handler();
   : e' X  M7 ~6 B# [! i' y/ }
4. }  
   
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   
6. {
   
7.     Error_Handler();
   
8. }

复制代码

使用举例：
$ ~  a$ S( X! y  j( p7 C0 z
; }9 q( R. c7 ~

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
4. Dma2dHandle.Instance = DMA2D;
   
5. 
   
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   1 _: K0 n7 O* `- d
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   $ K; w, w& e4 p
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   / b2 T& _) _' U, j: r, n
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
11. 
    / P* Y( A4 Y0 o2 k& O
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    ) b( K( a; p# p" A2 N0 e
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    
16. /*##-3- 前景层配置 ###########################################*/
    
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    * b& ?; }: I) J, T+ l
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    8 A4 h  B; F  S! a
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
23. 
    
24. 
    
25. /*##-4- DMA2D 初始化 ###############################################*/
    3 r, L  q2 d. y9 d3 V, h. s4 a
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    $ `7 d4 ^9 l3 Z$ w* Q4 g
27. {
    ) d! W& G' u. G0 K
28.     Error_Handler();
    
29. }

复制代码

- f* N2 ^  _. }8 D6 l: ~  q  p55.4.2 函数HAL_DMA2D_ConfigLayer
函数原型：
9 L( l# G0 U# a% v( \

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   ( n! m/ x9 z( Q5 h3 j3 h" e5 U4 u  H3 j
2. {
   
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   5 s6 C# n& c+ a! q9 c2 V; b* T
4. 
   
5.   uint32_t regMask = 0, regValue = 0;
   ; u  m& n+ N4 ^* O  V& e
6. 
   
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   " s1 `! [% B4 a* M/ _
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    
11.   {  
      N+ T% e: M% w
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    
14.     {
    - Q5 S6 S2 m3 m1 d1 ]+ r
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    
16.     }
    * D3 |/ y* D0 O" C# d+ M) h! ?
17.   }
    
18. 
    
19.   /* 上锁 */
    
20.   __HAL_LOCK(hdma2d);
    
21. 
    
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    & l3 {4 U! A! e5 }' E0 ^
24. 
    8 n3 ~+ Y) m' |+ ?" v' i
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
      q, @, j: a; m
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    9 z5 G0 }9 J3 N, t
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    1 }$ p+ [9 d4 P* o
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    
29. 
    : n6 \( C% Z7 l
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    # C, ^8 e+ [: }, K( e
31. 
    
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
33.   {
    & e! N) e/ L( H$ w# Z0 O
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    * u7 o! A4 J! }8 N# N) ]# B
35.   }
    6 d) G! r% B+ ?. [( H' T* {' E
36.   else
    : M5 U0 k" x- w( c' C+ ]3 h$ k
37.   {
    
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    / E. G) b6 f. V: e
39.   }
    3 @4 l9 s: ^) u% V
40. 
    
41.   /* 配置背景层 */
    
42.   if(LayerIdx == 0)
    0 Q7 `  O/ w3 h/ i; J
43.   {
    - v% p. y1 X1 v8 [4 @
44.     /* DMA2D BGPFCCR 寄存器 */
    6 B2 |3 p; q" }6 l" U! l
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    5 y4 K# D$ H) D6 p# A# Z
46. 
    " ~& d* _# t# L" g$ ]
47.     /* DMA2D BGOR 寄存器 */  
    ) U" t  y( {3 i- P0 f1 f& u6 ~! \
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    
49. 
    1 n% C; w/ s& F$ z; h0 @5 `# w# Q4 ~
50.     /* DMA2D BGCOLR 寄存器 */
    % s& T. R4 L; g8 h8 t4 L
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
52.     {   
    
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    
55.     }   
    / |( ~, p- d, l2 Y
56.   }
    / Z6 ?# c* n4 m3 |3 A
57.   /* 配置前景层 */
    
58.   else
    4 y+ R' C; h* L5 V
59.   {
    
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    . w4 a2 ~" H6 _
61.     {
    , a' K- K' C+ L: K% @
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    ) C3 A: [* \+ W
64.     }
    
65. 
    
66.      /* DMA2D FGPFCCR 寄存器 */
    7 n6 h! m* L$ l, {" \  J! L
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    
68. 
    7 t+ \. y" W6 H& d* C" n% l2 b
69.     /* DMA2D FGOR 寄存器 */
      J! G" U/ W6 G! l+ H# r4 u+ A
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    
71. 
    ! M, r1 ~2 v3 t' H9 T* Z
72.     /* DMA2D FGCOLR 寄存器 */   
    0 d4 K: K$ S9 Z9 F1 }3 h2 Q
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    6 p" [/ n4 O) d
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    + w1 u4 Y0 l+ W+ \% a- [
77.     }   
    
78.   }   
    
79.   /* DMA2D就绪 */
    
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    & |. N7 t. X! _5 Z- Y8 G' P
81. 
    
82.   /* 解锁 */
    
83.   __HAL_UNLOCK(hdma2d);  
    
84. 
    5 e. I0 ]! j1 w# j7 X
85.   return HAL_OK;
    ! W8 A5 |3 H, Y. V
86. }

复制代码

$ U+ e% L6 w4 S  k; Z/ S) k$ X, B函数描述：
9 f) H8 E  `; x5 e- |
此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。
3 s  h3 J4 W2 w9 g7 G6 K
函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
3 e8 R- G! o7 t  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
6 U2 W; @& l4 i0 V% b: g  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
" ?, c5 Q# ^3 V; x使用举例：

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   
3. 
   
4. 
   
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
     `/ p& o9 T7 r; \! U% I
6. Dma2dHandle.Instance = DMA2D;
   & H! Y( d; n& w4 u$ Z
7. 
     V$ X) q  ]; _" h" |
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   ; g5 n( R5 ~& F
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    9 U; w0 a/ d. W: l0 M0 `
11. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    # s& O" a# F, _1 z% n' A3 J( {& _1 F
12. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    3 V" ]! M2 y9 C( h2 K+ N
13. 
    
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
16. Dma2dHandle.XferErrorCallback = TransferError;
    
17. 
    ) U4 d8 k; g% O' `  J
18. /*##-3- 前景层配置 ###########################################*/
    + r% e" ?' ]( l" O$ o8 h
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    : Y7 f% d; U/ v: C. o/ E$ v0 ]9 y
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    ( M$ Q( N$ M) c) w" \
25. 
    , G! x& ^( D  D
26. /*##-4- DMA2D 初始化 ###############################################*/
    8 c$ y( L% V' n, M9 d% |
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    " l" n! M4 y/ c6 d9 H$ v6 c
28. {
    
29.     Error_Handler();
    
30. }
    
31. 
    
32. /* 配置前景层  */
    
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    6 q* T; u) B+ N& \3 U5 w
34. {
    
35.    Error_Handler();
    & i8 Y( j* _+ b
36. }

复制代码

( }2 C+ U: |3 w2 k4 u+ ^/ {
2 X. i7 `( t7 ?% B8 L. Z& T% {! W55.4.3 函数HAL_DMA2D_Start_IT
" V& R$ M6 \' b& U- [) p: b' M' c9 l函数原型：
- r* B% N5 I0 c& H( V. I, e
% _5 i0 v0 L, f2 j4 I0 n

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));
   * l( T  c, Q5 Q
5.   assert_param(IS_DMA2D_PIXEL(Width));
   9 r# V2 X/ J3 x7 g; ~
6. 
   ) N2 A+ g; z; N/ w* V2 D
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   ' T2 [& b+ J  S6 p* t+ k
10.   /* 设置DMA2D外设状态 */
    $ A/ u4 \7 v- w2 R- n( A
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    9 m* v6 d8 U# v; ?' Z* T) m
12. 
    
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    7 b, |2 g% o  x4 L
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
18. 
    
19.   /* 使能DMA2D */
    ! K6 K6 b( p. [# Z: C
20.   __HAL_DMA2D_ENABLE(hdma2d);
    , e: N! S6 M' A1 n' o3 I# M+ u
21. 
    * [% X, F5 \# Q
22.   return HAL_OK;
    
23. }

复制代码

% b- ]3 f' ~4 x! K8 ]( q: f函数描述：

此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。

9 S$ }! |9 _) N: N1 X函数参数：
* _; |% o9 l; ^* p
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
- A/ c  Q% O* e; T+ u7 m* b  第2个参数是源数据地址。
1 M! j7 c( n3 U+ Y$ q  第3个参数是目的数据地址。
+ x3 q+ z4 p6 _" d* U) z: N* ~  第4个参数是源数据的长度，即每行的像素个数。
  第5个参数是源数据的高度，即行数。
* n) R7 T1 c  ^  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

' W. v5 l* `  ^7 i5 K

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   ( Z" b4 Q1 \* R& K+ u7 G: S2 [
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   
7.                       SIZE_Y)                  /* 源数据行数 */
   1 n) f5 L& G5 n8 Y/ V
8.    != HAL_OK)
   
9. {
   
10.    Error_Handler();
    
11. }

复制代码

& n9 H: J0 Y9 u55.4.4 函数HAL_DMA2D_BlendingStart_IT
函数原型：
" c# m. x3 G. C! Z8 q
* Q6 }* D0 F  ~3 ]% `( s

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)
   8 n$ }# t# L0 `1 r
2. {
   
3.   /* 检测参数 */
   1 f" d) ?0 r, g0 d$ l1 w
4.   assert_param(IS_DMA2D_LINE(Height));
   0 ~+ ^5 r3 e) D+ |; O( Z8 u- q# H
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   0 f2 x' d" z: c; c; d
7.   /* 上锁 */
   ' @- E) K0 |. l# m9 E9 R
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    9 C+ T8 w% V+ {& ~
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    ; T' T  _3 B9 J0 G$ E) A
12. 
    
13.   /* 配置DMA2D源地址2 */
    , D$ d& N9 T/ g  Q4 D6 N! E5 _* u
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    
16.   /* 配置源地址1，目的地址和数据大小 */
    8 l; q6 P  G* b
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    
18. 
      a4 ?* [% o9 H7 a
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    # J( p7 K* c, M5 w3 u
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    1 e8 O/ y  S# P, {
21. 
    : s, N7 H) b1 J# s. ?
22.   /* 使能DMA2D */
    8 F+ y% M8 A5 ?7 [
23.   __HAL_DMA2D_ENABLE(hdma2d);
      ?. x  Y; e& |9 Z. {3 J
24. 
    - |+ c. Q8 b9 B% I, A* T' M
25.   return HAL_OK;
    ( T! v$ }5 T) j* X
26. }

复制代码

函数描述：

2 _- Z! h3 T- s1 {; }8 k+ V此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
$ g- H+ R1 z- E6 w9 M& ~
函数参数：
" X0 X6 P8 p+ f, \
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
5 h! [6 l' z- ?  第2个参数是源数据地址1。
  第3个参数是源数据地址2。
  第4个参数是目的数据地址。
2 Q8 }9 |* i' a; v: _% i4 p# u  第5个参数是源数据的长度，即每行的像素个数。
) {2 Z' m- i9 Z1 H2 M  第6个参数是源数据的高度，即行数。
1 Y+ s$ @* l& W+ w$ K  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
+ |' ]6 l* |6 S2 _/ t- L使用举例：

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   2 U  s; Z. @8 ?! d5 l# W
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   ( z# \5 R2 E' f1 q. X* D5 u
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   . b' p' }. E% Y/ q4 l4 ]
8.                               SIZE_Y)                 /* 源数据行数 */
   ' r8 t# u1 A8 _" t1 c
9.    != HAL_OK)
   
10. {
    
11.    Error_Handler();
    
12. }

复制代码

% N7 S; `- _( R  a( w
, ]1 S, s9 U# {5 e7 P) Z) l55.5 总结
本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。


& \8 @; F# l; ^* z1 `8 K" _
; d) d* f0 Q# m4 B: A# r