55.1 初学者重要提示
  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张
6 K0 M  w; `0 }  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
: [" t$ ]) N8 H  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
55.2 DMA2D基础知识
  @3 M, P6 q# _5 Y* uDMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。
: T; R+ Z) `% o* l  M
. K7 ]9 G: i9 ~7 `& X" N  [  DMA数据传输
% h* u+ G5 T+ h8 w主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。
5 d8 d$ I" _* P! E2 b4 S
* C( I! X; G+ h# G  2D图形加速功能
: C6 y5 l1 t6 w. f支持硬件的颜色格式转换和Alpha混合效果。

55.2.1 DMA2D硬件框图
7 ]! I) K  p5 Y* T+ {9 c$ X  S* n% t: B认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

8 I7 G& M, v" v* D5 \8 d. a

通过这个框图，我们可以得到如下信息：

  dma2d_aclk
AXI 总线时钟输入。
) ?) a# `' x1 h" `9 m2 K
  dma2d_gbl_it
6 h2 c- [! u4 _DMA2D全局中断输出。
% {7 l; w! {6 f* Q. [$ A
  dma2d_clut_trg
CLUT传输完成信号输出，可以触发MDMA。

5 i' p0 ~4 |( y6 r1 _! W  dma2d_tc_trg
3 [0 m% u! A7 F. V  [7 c, b传输完成信号输出，可以触发MDMA。

& |: q3 w- Y3 F$ Q  dma2d_tw_trg
2 O% x3 j1 x6 D6 U: R- Y传输watermark信号输出，可以触发MDMA。
7 i1 Z' V6 O4 E9 p3 P
; n3 M6 l" y0 q: L0 i) v5 ]将这个硬件框图简化一下，就是下面这样：

" {' c0 r% Z: m. ]

% l: p' `) y6 `: ^3 |0 ^' y下面按照简化的硬件框图，对每个部分做个说明。

55.2.2 DMA2D工作模式
DMA2D支持的工作模式如下：
" R0 L+ d: R- w; Z5 f
  模式1：寄存器到存储器模式
; y3 h, V* [5 \- [: E, t+ e5 G这个模式主要用于清屏，也即是将显示屏清为单色效果。
  g2 a) k$ O: {" M& c3 S
  模式2：存储器到存储器模式
这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。
) ^7 A  y. q( g, D
  模式3：存储器到存储器模式，带颜色格式转换
! |; J- b& x! D这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。
% w4 E) Y$ e; d4 c$ O8 }( t. f
" L$ ^% P* l3 S# l2 ?- U, X  模式4：存储器到存储器模式，带颜色格式转换和混合
这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。

$ h, U4 ~4 M  K3 s# {  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
同模式4，只是前景色的颜色值是固定的。

55.2.3 前景层和背景层的输入以及颜色格式转换
前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。
: p% `7 W7 _1 z9 l, C
, B* A3 L$ w) n" M  vDMA2D支持的输入颜色格式如下，前景层和背景层一样：

( S) l2 G  S0 S. [8 H4 z
前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：
* p4 @- X  z; i) [: E4 E0 t
/ t/ D3 g1 m0 T# w! T  L4 (4-bit luminance or CLUT)
4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。

  A4和A8
A4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。

  YCbCr
% e  U) o5 S$ u( A9 r1 z这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。

9 G6 w) C9 P5 w- I& {- w1 Q这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
. _* y! W4 D4 q
# _0 D( A2 n+ {+ Y$ c& ?- D55.2.4 前景层和背景层混合
$ e0 E3 q, D8 A0 g% h2 ZDMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：
( q( T1 L1 n# x+ `( x5 [9 v
5 [) P* o4 m) r  G

& j6 `" o6 a/ z9 \- G
55.2.5 DMA2D输出颜色格式
DMA2D支持的输出颜色格式如下：

% X, H8 D( F. e6 v7 V

/ X+ K! e7 Q( N
4 M( o- r4 [/ C( n这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

55.3 DMA2D的HAL库用法
& |6 J. j2 O% VDMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。
3 X. ]# ]- @3 d
55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
DMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：

7 N$ ~6 P! G$ f/ ?

1. typedef struct
   6 @: R2 B+ b3 v! `' o# l0 I
2. {
   
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   ! C6 u  W, @4 T
4.   __IO uint32_t ISR;           /*!< DMA2D Interrupt Status Register,                Address offset: 0x04 */
   ) g# Y8 C3 T2 [6 H8 u% N- g
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 */
   4 B' e; j: }7 e$ S0 P  V* G; r# o/ B
8.   __IO uint32_t BGMAR;         /*!< DMA2D Background Memory Address Register,       Address offset: 0x14 */
   * Y( t% i. w: }* A# e% [) K1 M2 f
9.   __IO uint32_t BGOR;          /*!< DMA2D Background Offset Register,               Address offset: 0x18 */
   , V/ T0 l' t; @% {2 j
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
      ^) J+ K% @% G- S
11.   __IO uint32_t FGCOLR;        /*!< DMA2D Foreground Color Register,                Address offset: 0x20 */
    : S% b/ o4 k1 _: M% Q9 C8 O
12.   __IO uint32_t BGPFCCR;       /*!< DMA2D Background PFC Control Register,          Address offset: 0x24 */
    7 G7 e* T+ k9 g8 `+ ^8 Y- B- s
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 */
    / j2 |; M; N0 g  e# X) i
16.   __IO uint32_t OPFCCR;        /*!< DMA2D Output PFC Control Register,              Address offset: 0x34 */
    
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 */
    / Q- G( r% T$ F& v4 h
19.   __IO uint32_t OOR;           /*!< DMA2D Output Offset Register,                   Address offset: 0x40 */
    $ H% Q$ B' C2 @/ T
20.   __IO uint32_t NLR;           /*!< DMA2D Number of Line Register,                  Address offset: 0x44 */
    * K; G* |+ N8 m; a( C; S
21.   __IO uint32_t LWR;           /*!< DMA2D Line Watermark Register,                  Address offset: 0x48 */
    / R; U* O$ I+ q! R$ l9 x/ {& G1 C6 W
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    & a' q+ W- k; u) C! H9 A( N
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 */
    # E, {0 G! a( H7 E7 v) }9 j9 A
26. } DMA2D_TypeDef;

复制代码

; i4 L( w8 T- `. L
__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：
8 C8 p# _8 V/ N' K
  r' \" ]- _) v# a! `1 ^

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)
   3 k9 ~, n3 R& D$ Z% B+ V
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   * D# c' e+ A# k/ z3 F3 G
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。
& I, M% n/ t+ |+ z5 }
55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
# d8 D0 h# H  Y" D此结构体用于配置DMA2D的基本参数，具体定义如下：

6 c7 E( [7 F6 c' z, D% a9 f: D6 @0 ^

1. typedef struct
   & t1 b3 M5 h) D2 y/ [% l4 n9 F
2. {
   / u5 Q8 X. A& U; Q6 b
3.   uint32_t             Mode;              
   
4.   uint32_t             ColorMode;        
   / G0 X6 R$ R+ [8 O
5.   uint32_t             OutputOffset;      
   
6.   uint32_t             AlphaInverted;   
   0 K' U( G8 a2 K
7.   uint32_t             RedBlueSwap;      
   
8. } DMA2D_InitTypeDef;

复制代码

7 {$ w5 g" A- B% D! [7 `. |下面将这几个参数逐一为大家做个说明：
1 R+ o3 l( c6 r! J- ^+ n
  uint32_t   Mode
此参数用于设置DMA2D的传输模式，具体支持的参数如下：
3 u$ c# U2 H) H& s8 }, T6 R. `

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   $ N) _2 t7 l! @
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   

复制代码

  uint32_t   ColorMode
8 H3 v& E0 ~9 v6 T+ k此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：
/ `$ m7 a- X$ j; C: ?

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

复制代码

& y, M( b7 p! [5 ~  uint32_t   OutputOffset
/ x! I4 ~2 x* j% @; r此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。
" s! m1 `( J* g( d/ ]5 l* @
  uint32_t   AlphaInverted
此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   ( |9 Q. B# `" h( {4 u; t0 n
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

* ~+ o4 ?/ _& M& R) }. n  uint32_t   RedBlueSwap
+ Q1 q" D/ o/ l- ~1 X: I8 P此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   ! u' e9 f$ P" S. ^
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

/ J8 t# S1 |$ u2 _0 J55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
此结构体用于配置前景色和背景色。
9 D' o8 e' P( e0 F0 o
/ ~% ]; G7 ?+ T4 r

1. typedef struct
   
2. {
     R, |1 E$ F' \
3.   uint32_t             InputOffset;      
   $ u9 m) H% S( f
4.   uint32_t             InputColorMode;   
   
5.   uint32_t             AlphaMode;        
   
6.   uint32_t             InputAlpha;        
   # C  U2 `9 w! d
7.   uint32_t             AlphaInverted;   
   
8.   uint32_t             RedBlueSwap;      
   / W8 r* L- X! U% _
9.   uint32_t             ChromaSubSampling;
   
10. } DMA2D_LayerCfgTypeDef;

复制代码

- d: H0 m6 p7 T: D5 R下面将这几个参数逐一为大家做个说明。
# b0 Q2 R+ V9 ?$ h
  uint32_t  InputOffset
设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。

% V8 j- C- J# a5 K( ^2 j  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   5 A: a4 H' _( k
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   . F8 y* s  m3 `* R& p0 d, T4 V
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     */
   & p* ^* u$ X# u0 i( E" |
8. #define DMA2D_INPUT_AL88            ((uint32_t)0x00000007U)  /* AL88     */
     C! `. p" R1 d
9. #define DMA2D_INPUT_L4              ((uint32_t)0x00000008U)  /* L4       */
   
10. #define DMA2D_INPUT_A8              ((uint32_t)0x00000009U)  /* A8       */
    ) G6 t# k* h) m$ h* Y" x
11. #define DMA2D_INPUT_A4              ((uint32_t)0x0000000AU)  /* A4       */
    : m4 S' X" u5 q$ H8 Y
12. #define DMA2D_INPUT_YCBCR           ((uint32_t)0x0000000BU)  /* YCbCr    */

复制代码

  uint32_t AlphaMode
设置前景色或者背景色的Alpha模式，具体支持的参数如下：

4 F4 `4 j1 G' N+ u" b5 h5 q- r

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   2 H+ s4 v- d$ ^4 p- F. B
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   7 n( ^6 b* j0 X2 I  f: ?+ U# o
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

  uint32_t  InputAlpha
设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。
, U$ q1 W2 x% v9 a) G
  uint32_t AlphaInverted
设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
. C9 b- S' H' A" U: _# ]7 ~

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

复制代码

  uint32_t   RedBlueSwap
设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：
; o' n2 S( J, A$ H# |
/ h# P' W) g7 x( v- Q  d* [

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   ! b; a$ @. V3 h
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

  uint32_t   ChromaSubSampling
% o- M8 s0 }( _6 }/ a/ z设置前景色或者背景色中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
   
2. {
   " X2 |! g9 ?0 O
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   ' S2 \* B, @; m3 Y
4.   DMA2D_InitTypeDef           Init;                                                        
   2 g6 H4 q, f( b/ E, y& `& i
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   5 s# W, {5 y6 M' q
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   : F7 O2 s5 N8 {0 O
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   8 C: j) {% A6 H- ~! l& d/ R
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   * p+ [* b9 K0 B: R: t1 e
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    $ k8 u1 @# U: A* Q4 x7 r

复制代码

; A2 z, [. n: [2 @下面将这几个参数逐一做个说明。
% Q( ]9 w. B' x% i4 [/ ?: M  q
  DMA2D_TypeDef  *Instance
这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

  DMA2D_InitTypeDef  Init;  
这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。
1 q) \+ c- x( b* j% }! c2 Y
, Q3 ~( o/ \# y% D  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。
. f( ]; J5 ?6 o! z0 ~
  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。

  HAL_LockTypeDef   Lock
4 s# N) p& @2 Y: V9 L- Q__IO uint32_t    State;

__IO uint32_t    ErrorCode

7 j& W& {- _! A0 p7 x这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。
  p' v7 \/ E' J- m, e4 v
* _0 \+ \3 [! }5 ^+ _55.3.5 DMA2D初始化流程总结
对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

55.4 源文件stm32h7xx_hal_dma2d.c
7 N0 l7 D- D2 D8 q这里把我们把如下几个常用到的函数做个说明：

  HAL_DMA2D_Init
  HAL_DMA2D_ConfigLayer
  HAL_DMA2D_Start_IT
( m$ [. ~6 K7 U1 F" C; x  HAL_DMA2D_BlendingStart_IT
  K* b: X5 P4 @% M5 P
; w0 p" J. f- W1 w, z+ _55.4.1 函数HAL_DMA2D_Init
- w9 b3 F" A8 e: K! x4 x, O函数原型：

2 a% N0 f6 j$ J/ ~; X9 x5 j

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   4 V0 K; y* n5 S$ s
2. {
   0 p- p- {2 ]4 p0 m7 j! {
3. 
   
4. /*  检测参数是否有效 */
   " f$ G* U8 k, |: L" V2 }# w
5.   if(hdma2d == NULL)
   - K; K. ~8 ?- I# O( u& C4 g
6.   {
   
7.      return HAL_ERROR;
   # @2 U, e, u- |2 k
8.   }
   # p7 d5 i0 Y6 R3 p* v
9. 
   
10.   /* 检测函数形参 */
    
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
      ]2 @" S0 n8 }" _
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    1 [# R/ h/ N5 N/ ]+ m7 ~% ?& ?( g
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    
15. 
    ) G- [; Q2 G- ]; s. H9 A
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    0 H3 W  R2 y+ U  u
17.   {
    
18.     hdma2d->Lock = HAL_UNLOCKED;
    
19.     /* 初始化GPIO，NVIC等 */
    & u6 Z; ]9 @; ]9 p
20.     HAL_DMA2D_MspInit(hdma2d);
    - y! t1 [7 g/ y5 R( L5 P
21.   }
    
22. 
    
23.   /* 设置DAM2D外设状态 */
    # ]. X4 I- b$ V" _
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
25. 
      t5 a, h7 g% n
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    
28. 
    
29.   /* 设置输出颜色格式 ---------------------------------------*/
    : N! t- q* R0 M2 {9 T( _' j
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
    
31. 
    
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));
    
37. 
    
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    
39. 
    
40. 
    6 |( s: h/ k: q+ ]8 r9 F- K
41.   /* 无错误 */
    
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    
43. 
    
44.   /* DAM2D就绪 */
    
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    
46. 
    
47.   return HAL_OK;
    
48. }

复制代码

函数描述：

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

函数参数：

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

" X% P: _4 C; W6 x方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。

方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   3 Z& w' `6 |; X7 M* b0 h# ]9 Y: ]
2. {
   $ {" b( k$ ~& g0 `- P
3.     Error_Handler();
   
4. }  
   
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   # ?6 m1 n$ f5 d! H! h
6. {
   ! B( Y4 _: w5 J, U. I6 s* z
7.     Error_Handler();
   ( B" {6 L7 n8 ]0 O3 @4 f1 D
8. }

复制代码

使用举例：

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   7 y( |& h* w% O
4. Dma2dHandle.Instance = DMA2D;
   
5. 
   # Q4 N  V( u  K2 `2 P
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    * e4 }& s! M  t* l- C
11. 
    
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    
16. /*##-3- 前景层配置 ###########################################*/
    
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    - e) S& a! d% ?6 [6 U$ _2 V# K
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    . _( j  ~" \, e
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    * Y( T6 c9 w7 _' x- ?# U; I
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    # F; `1 h* o$ R2 l* q
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
23. 
    3 R2 u2 M' }1 a) |& e/ g
24. 
    ; D; n* ~6 V9 J0 x. e
25. /*##-4- DMA2D 初始化 ###############################################*/
    " G% s  Q. ~8 f) h, p- n
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    
28.     Error_Handler();
    
29. }

复制代码

1 t& O) p, S; U8 y# D* u+ F55.4.2 函数HAL_DMA2D_ConfigLayer
. q/ D1 `) A3 b* `5 ~函数原型：
, Q  l) ?6 }) c) h, y, d

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   
2. {
   3 |- z$ j& W* q$ t2 d/ U; P) e' t5 k
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   + _5 I8 s5 @( @  B3 E3 ]
4. 
   : s- C9 ~7 X5 X
5.   uint32_t regMask = 0, regValue = 0;
   
6. 
   
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
     ~3 J6 w7 I% H+ j
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   5 p; j. q4 ]+ [; t. j& P6 W
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    ( `; T# D* V$ Z: f! q) l* Q
11.   {  
    
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    
14.     {
    ) H: ^* ?. i+ O/ w" e
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    ) q+ o4 M0 X+ D! I! ?, P
16.     }
    
17.   }
    
18. 
    
19.   /* 上锁 */
    ( u4 g' ^& V6 l9 z) u6 W
20.   __HAL_LOCK(hdma2d);
    
21. 
    
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    
24. 
    
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    + @) `  H4 i, D' ]" E% Y
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    
29. 
    6 {( ~; R- `* M
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    : Y1 e. z, w' Z& B9 [- E
31. 
    
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    / h& N/ S2 V5 G$ {
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    
35.   }
    3 X/ B2 y/ T' O8 o
36.   else
    
37.   {
    8 K: _6 y! U. O- p& z
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    + Q! _5 p1 V% u3 A% n- m
39.   }
    ) ?  _; Z1 P, {3 a& m) A
40. 
      s& v! E8 E% {' Z
41.   /* 配置背景层 */
    8 @; f1 o4 g6 i7 b
42.   if(LayerIdx == 0)
    9 t( l7 k) f8 I
43.   {
    
44.     /* DMA2D BGPFCCR 寄存器 */
    
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    1 h; h! c; ^. j/ U
46. 
    0 e* {7 }* R" P
47.     /* DMA2D BGOR 寄存器 */  
    
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    9 f( C" e! L8 t2 T2 ?
49. 
    
50.     /* DMA2D BGCOLR 寄存器 */
    
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.     }   
    ; Z. P+ `' Q" C# u& e) A
56.   }
    
57.   /* 配置前景层 */
    ' m6 ]9 ]7 m2 o8 P; k, a* f
58.   else
    
59.   {
    
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    ' U" e1 B% z5 [
61.     {
    ' O1 }' L) A( R$ P8 g
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    / a) _# q) R- D1 q
65. 
    " y% d6 J; q8 @, A4 K$ M" B& z
66.      /* DMA2D FGPFCCR 寄存器 */
    
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    
68. 
    * ^6 e( A7 r6 P" U
69.     /* DMA2D FGOR 寄存器 */
      u) p9 S( ?3 m  d4 q, a
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
      o9 V8 t2 g0 Q0 l- S& K, r2 N
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    ! o% [' A7 |6 p7 m
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    
77.     }   
    
78.   }   
    
79.   /* DMA2D就绪 */
    / Y" Q0 n9 \( ?  g4 w7 p) k# H( g  N
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    & V% M* h5 F) ^4 d* I7 e
81. 
    # C9 M- `: [& `9 q5 b5 y
82.   /* 解锁 */
    5 ]5 H! T! y0 I" m% T  s" ?
83.   __HAL_UNLOCK(hdma2d);  
    8 g' u6 h  M% K+ m/ C( i
84. 
    
85.   return HAL_OK;
    
86. }

复制代码

函数描述：

此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。
5 J& Y4 }1 H1 x! o, \- ~. E
函数参数：
5 T5 ]5 ~/ w; w3 [
2 u7 `0 R) D; A& V7 h$ e4 V4 ^  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
3 d7 Y4 i( G# P$ s/ e  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
+ D1 n3 O, E" c1 X- {7 U  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
* M9 w! n$ {2 h" \. R+ O. i

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   1 D7 B+ U4 }  c4 F' Z' z0 L
3. 
   - r1 z7 C! e: [5 b
4. 
   0 m- n9 F1 s: r7 Z) }4 W3 v" v( u/ |* P
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   
6. Dma2dHandle.Instance = DMA2D;
   
7. 
   
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
     E3 z  @4 ~: A  \  x
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    ) j6 a- a& x; `+ t
11. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
    
12. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
13. 
    
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
16. Dma2dHandle.XferErrorCallback = TransferError;
    ! q. d. P" r/ Y+ p5 C# [$ I$ {
17. 
    
18. /*##-3- 前景层配置 ###########################################*/
    
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    ! g! e9 k! z+ v$ a2 m- ~' Z
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    ! S7 Z, w( O/ Z; p
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    8 L0 q0 d) Q+ h8 _
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
25. 
    " r/ W3 n/ B3 X1 f; n% a
26. /*##-4- DMA2D 初始化 ###############################################*/
    ; l: Q9 F4 f! B4 I/ }
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    & N+ Z" Q( Y0 l2 Q( m
28. {
    
29.     Error_Handler();
    
30. }
    2 j; F; j' F7 m% X" M
31. 
    ) e5 `! m1 n* h* ?2 s
32. /* 配置前景层  */
    
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    
34. {
    
35.    Error_Handler();
    
36. }

复制代码

7 s( ~6 |  ]- R0 P4 P1 x9 @, ?
55.4.3 函数HAL_DMA2D_Start_IT
: J8 x* T; ?7 F. d函数原型：

$ z$ Z& @' }9 F

1. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   ) I% v/ S) ?( M; \) Q; N; J
2. {
   # ^( ?; W" n2 H
3.   /* 检测函数形参 */
   * O  g. l; L% m: X4 \2 D
4.   assert_param(IS_DMA2D_LINE(Height));
   + h3 Q/ n1 N  |3 T9 X& H
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   0 W5 b) V: t4 r
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    3 c9 T" _3 o- Z5 B0 g0 r  o
12. 
    
13.   /* 设置源地址，目的地址和数据大小 */
    6 K. F$ J" a2 Q8 S- [- m  s  V2 V' `
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    # t8 P5 X5 I+ ~5 W
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    : Z" |! R9 V0 H/ F9 A
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    # `! E  D7 s' t/ N) @0 G6 s
18. 
    
19.   /* 使能DMA2D */
      Y0 Q* t  F2 |, h# P
20.   __HAL_DMA2D_ENABLE(hdma2d);
    ) A# A5 y( \  S+ c! v5 i& C1 I
21. 
    * J6 F7 h6 }$ a0 `6 I$ R7 L) M
22.   return HAL_OK;
    
23. }

复制代码

8 [0 I) U. Q6 q) n, P5 B# r函数描述：
* x" P  K; S- N7 N3 M9 _" X0 k/ U
此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。

! E2 S: m$ p4 ^% E/ t函数参数：

+ U+ N+ A2 T. ], y  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址。
  第3个参数是目的数据地址。
  第4个参数是源数据的长度，即每行的像素个数。
9 h5 h" B( M0 J  N2 R& s/ I- d( s$ x  第5个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
     v% q3 `- T# T1 X4 \  ]
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   & g7 w1 g7 ]" N5 T
7.                       SIZE_Y)                  /* 源数据行数 */
   
8.    != HAL_OK)
   
9. {
   
10.    Error_Handler();
    3 a" I( f) P5 H( O3 P% w9 F+ T
11. }

复制代码

55.4.4 函数HAL_DMA2D_BlendingStart_IT
函数原型：

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.   /* 检测参数 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   # H7 ?3 Z1 E3 G( _& r
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    0 Y9 {5 l- }  w8 J; }% W
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    3 o# B/ `7 R0 G9 B! D# ]
12. 
    
13.   /* 配置DMA2D源地址2 */
    
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    ' J  D2 p( L6 ^+ j; @7 q, d
15. 
    
16.   /* 配置源地址1，目的地址和数据大小 */
    
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    
18. 
    
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    4 d7 K+ K6 c# U# z$ V* ^7 M; ^: J
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    8 t, Z2 r" d+ R# U( h& {
21. 
    
22.   /* 使能DMA2D */
    
23.   __HAL_DMA2D_ENABLE(hdma2d);
    0 u6 }. p. m) ^8 i$ m. \
24. 
    
25.   return HAL_OK;
    ' f( I% A+ ?* |! q& R
26. }

复制代码

) p% d9 Z$ P3 j% x, Z8 K% b9 I函数描述：

此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
1 L" E' w* _& A8 E
- s; F8 L8 C6 G* R( f  q函数参数：
4 K: b1 b9 s- c  [- \% ]
$ B% Y  ]- k$ u% T  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
% N3 `& v" I/ [1 |  第2个参数是源数据地址1。
  第3个参数是源数据地址2。
  第4个参数是目的数据地址。
. P( [; g6 h6 ?7 `% U6 ^  第5个参数是源数据的长度，即每行的像素个数。
# ^/ e0 Z: ]5 ?% E9 T) t7 x5 T( l  第6个参数是源数据的高度，即行数。
7 T1 S8 A* J$ `) O/ t  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
# p, `! f# n2 z
  F8 ?. I$ P+ W% r

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   5 o' B0 X3 i( L7 U# x  j
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   
8.                               SIZE_Y)                 /* 源数据行数 */
   
9.    != HAL_OK)
   & G) y( b5 ]4 o' H
10. {
    
11.    Error_Handler();
    - \1 B4 `5 W! A0 F6 ~2 C
12. }

复制代码

; S+ q& }( l0 a7 l
/ C' S% |; a6 X; X. z55.5 总结
- Z" \" g5 b: o. e3 i本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。

. ?4 N# @0 C9 L7 @7 E