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

( z9 k& X  z# k* {0 u6 o  DMA数据传输
$ u/ x/ H0 s+ a主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。
1 V7 c, @# h. T
- x5 V3 T  F3 z+ _- A  2D图形加速功能
# p% b- R7 @' Z+ j# F# r6 M3 W' k支持硬件的颜色格式转换和Alpha混合效果。

- c; X/ Y0 g  B+ F$ l" a55.2.1 DMA2D硬件框图
认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

+ K9 f4 B+ n4 {2 [  F, \

1 [. F$ \, U, o, Z( ^# V% q通过这个框图，我们可以得到如下信息：

  dma2d_aclk
AXI 总线时钟输入。

' _% e# W) f, H( V$ e! g! z! ~0 `$ k# c  dma2d_gbl_it
2 O# M$ q! v6 P; W8 @DMA2D全局中断输出。

3 I- J" ^2 O& d1 O# T: {' E  dma2d_clut_trg
CLUT传输完成信号输出，可以触发MDMA。

  dma2d_tc_trg
/ Z5 y. x' L- s4 D9 n4 j传输完成信号输出，可以触发MDMA。
( |" E2 G5 O+ x" ?- i
  dma2d_tw_trg
传输watermark信号输出，可以触发MDMA。
3 G6 @( ~/ ^1 Y) S! ]0 P  D5 e
' a9 u" e  r! b8 ?1 J$ `将这个硬件框图简化一下，就是下面这样：

/ h' h8 B/ }+ Q下面按照简化的硬件框图，对每个部分做个说明。
! j( [9 J7 Q' G! z0 H1 s
3 J$ w) l& h" F% w4 _55.2.2 DMA2D工作模式
2 E/ l7 t7 n- |$ v4 \. b$ hDMA2D支持的工作模式如下：
, i) c1 r- Q! Y/ P
3 O8 t$ \& r7 f0 z* N! E  模式1：寄存器到存储器模式
这个模式主要用于清屏，也即是将显示屏清为单色效果。

  模式2：存储器到存储器模式
这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。
4 N# _2 T( e' A0 [2 u: w
0 Z3 q2 q# B7 U4 O" H. C  模式3：存储器到存储器模式，带颜色格式转换
这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。

  模式4：存储器到存储器模式，带颜色格式转换和混合
8 h& A' h3 y* o; L# O$ R# O2 j这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。

  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
8 j% W  `; w% V# W  x) h# c; l同模式4，只是前景色的颜色值是固定的。

$ P7 T/ g6 a' X* m8 e55.2.3 前景层和背景层的输入以及颜色格式转换
前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。
* X( w. U1 G+ v/ c" M. s. e6 p
# f* q& V+ k' d8 p. ~' P2 r$ l- gDMA2D支持的输入颜色格式如下，前景层和背景层一样：
$ D9 v& a9 u1 S
1 r' t- n) }3 p2 ]( g9 {

+ a  @- c. b4 x- s
% o- \3 o: w( e  `前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：

" |+ h$ V# R( I5 [* z* k( z  L4 (4-bit luminance or CLUT)
/ k& p0 u* K; ]; @1 X# @4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。

  A4和A8
A4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。
$ o4 f) G% k  F% I  x; W! E
0 ~& f* V# ^' `2 g6 k2 e  YCbCr
) U1 k; _8 |- ?; C$ q- X这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。

- p; D' T6 I) g2 }+ I7 X7 s这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

" ]! c3 x  a: j, s55.2.4 前景层和背景层混合
' v/ f9 c1 t4 ]2 ~DMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：
1 b" R' B- _* h2 H9 r

55.2.5 DMA2D输出颜色格式
5 S  d' Y: X' C5 D# ]1 MDMA2D支持的输出颜色格式如下：
( [. M: A2 M3 D' ?( O" j& i7 L

$ x3 y0 w/ f1 c0 K9 g9 q% u$ x
这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

( f! c3 V/ O& M55.3 DMA2D的HAL库用法
% |1 v3 }1 a# ], }DMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。

55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
DMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：
$ h0 y, c2 |+ i# p8 b+ o, N

1. typedef struct
   
2. {
   - I, i3 v- {3 ?! [5 Y
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   + e6 X; K: m, a5 W* a
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 */
   2 y9 Q& d5 T+ i, j0 b7 q1 U  K
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 */
   3 T4 j1 k! J1 p0 V5 h
9.   __IO uint32_t BGOR;          /*!< DMA2D Background Offset Register,               Address offset: 0x18 */
   
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 */
    2 |- p& R( @0 [3 @( a/ \* K
12.   __IO uint32_t BGPFCCR;       /*!< DMA2D Background PFC Control Register,          Address offset: 0x24 */
    8 L$ h/ e, r$ M4 P2 b" v
13.   __IO uint32_t BGCOLR;        /*!< DMA2D Background Color Register,                Address offset: 0x28 */
    
14.   __IO uint32_t FGCMAR;        /*!< DMA2D Foreground CLUT Memory Address Register,  Address offset: 0x2C */
    
15.   __IO uint32_t BGCMAR;        /*!< DMA2D Background CLUT Memory Address Register,  Address offset: 0x30 */
    
16.   __IO uint32_t OPFCCR;        /*!< DMA2D Output PFC Control Register,              Address offset: 0x34 */
    6 S4 M% |# E/ E! p  D) V
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 */
    
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    8 J" m6 Z8 a0 N5 B$ g( [, Q7 {0 [3 K
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 */
    # T8 B/ I3 u9 M
26. } DMA2D_TypeDef;

复制代码

7 U& [& b, }6 z# E. a6 I
__IO表示volatile, 这是标准C语言中的一个修饰字，表示这个变量是非易失性的，编译器不要将其优化掉。core_m7.h 文件定义了这个宏：

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

复制代码

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

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

复制代码

我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。
  F; {" _. O8 [4 O% M
55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
此结构体用于配置DMA2D的基本参数，具体定义如下：
( E8 d6 M' \5 _2 C
! R6 f0 r" T2 A

1. typedef struct
   / B  s' B' m. l9 A, t5 h
2. {
   9 e* s+ H- i/ {" O1 V
3.   uint32_t             Mode;              
   5 C* Z) w0 f8 L, y6 O8 x# w# n
4.   uint32_t             ColorMode;        
   
5.   uint32_t             OutputOffset;      
   ) D4 t! j- E  f% K6 ?1 U% L5 p
6.   uint32_t             AlphaInverted;   
   
7.   uint32_t             RedBlueSwap;      
   
8. } DMA2D_InitTypeDef;

复制代码

( \5 K7 `* M7 s* s' H9 ^下面将这几个参数逐一为大家做个说明：
1 @7 y9 Z7 {, P* v* x/ z/ G
) P" }) [5 x2 H' I5 M3 c  uint32_t   Mode
此参数用于设置DMA2D的传输模式，具体支持的参数如下：
% {; w7 [7 W0 @8 B, C( S- l
" `) Q$ k* F; @4 ^% @4 J. _

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   $ d& w- q& G. c3 d; N
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   ) {# U) t, V3 j
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   

复制代码

  uint32_t   ColorMode
此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：
2 u9 |0 W6 T. ]5 f0 l
3 _3 ?4 D  P5 X! [+ a+ D

1. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   ; G% `4 p, z5 a* X2 Q9 f! B/ M
2. #define DMA2D_OUTPUT_RGB888         DMA2D_OPFCCR_CM_0                     /* RGB888 */
   % V' S; l, I8 Y8 p9 C  H/ P
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 */
   # n- B4 E* D* E8 V

复制代码

  uint32_t   OutputOffset
此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。

! k  k% k) |0 T2 g  uint32_t   AlphaInverted
" o1 |7 X. h$ L% }' V此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
. v8 Q! p; ]( ?2 K: ?, j4 O" ^2 k

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   + y0 p5 m1 ]/ Y, Y: d
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

7 v7 ^$ Y' v3 v  uint32_t   RedBlueSwap
3 R* l. v! a5 M9 _, p+ k7 W此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：

1 N2 h3 V1 y( Y  b; G( {" w

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

复制代码

55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
此结构体用于配置前景色和背景色。
$ b) ^# l( t+ W( m" W4 k
: z+ Z+ u* v8 v, o

1. typedef struct
   
2. {
   1 @0 Q! {, M# u& H2 A6 }
3.   uint32_t             InputOffset;      
     Q! g8 H3 ]% y- H4 n5 {
4.   uint32_t             InputColorMode;   
     ~6 k& z. ]2 v" _: W
5.   uint32_t             AlphaMode;        
   
6.   uint32_t             InputAlpha;        
   , r3 A+ j7 _1 e5 \# g
7.   uint32_t             AlphaInverted;   
   & q- M! T% o$ T7 m
8.   uint32_t             RedBlueSwap;      
   
9.   uint32_t             ChromaSubSampling;
   / C! o" w+ [: ?1 S/ I4 @! r
10. } DMA2D_LayerCfgTypeDef;

复制代码

下面将这几个参数逐一为大家做个说明。
- o2 d. I4 I+ X- D, W# ^
+ P* {1 ]# D( E5 ]6 ]) E6 Z  uint32_t  InputOffset
设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。

  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：
( z( m; W8 R- T' s* g

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   6 |7 A; d  @0 L
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   
4. #define DMA2D_INPUT_ARGB1555        ((uint32_t)0x00000003U)  /* ARGB1555 */
   0 h6 Q4 s# F" }
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     */
   7 ^2 r1 u% l$ p6 I( ~. 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    */

复制代码

0 s$ ^# j+ d* R  o  uint32_t AlphaMode
, M+ P# [; s9 }% o设置前景色或者背景色的Alpha模式，具体支持的参数如下：

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   * a; ^  A6 R" x! k5 C8 p# h
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   
3. #define DMA2D_COMBINE_ALPHA    ((uint32_t)0x00000002U)  /* 用新设置的Alpha值与原始Alpha值的乘积替换原始Alaha值*/

复制代码

  uint32_t  InputAlpha
设置前景色或者背景色的Alpha值，范围0x00到0xFF，如果颜色格式是A4或者A8，那么此参数的范围是0x00000000到0xFFFFFFFF，标准的ARGB8888格式。

  uint32_t AlphaInverted
设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
6 K, @/ ]* P2 X
3 R9 B; u# l$ [; j

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   6 d8 i2 a! o& B  x& G& M# z. Y" u
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */     

复制代码

  uint32_t   RedBlueSwap
设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：
' m5 k- D1 X$ P6 ?% x
: s( w$ d& J* M

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

复制代码

  uint32_t   ChromaSubSampling
设置前景色或者背景色中YCbCr 颜色模式的采样格式，具体支持的参数如下：

1. #define DMA2D_NO_CSS               ((uint32_t)0x00000000)  /* 4:4:4 */
   ! [' j9 N2 ]. l9 C8 C
2. #define DMA2D_CSS_422              ((uint32_t)0x00000001)  /* 4:2:2 */
   0 B  O) P/ ]4 Q/ f# }' p+ j
3. #define DMA2D_CSS_420              ((uint32_t)0x00000002)  /* 4:2:0 */  

复制代码

55.3.4 DMA2D句柄结构体DMA2D_HandleTypeDef
0 I/ C9 y. N; \9 A' }HAL库在DMA2D_TypeDef， DMA2D_InitTypeDef和DMA2D_LayerCfgTypeDef的基础上封装了一个结构体DMA2D_HandleTypeDef，定义如下：
$ ~3 Q5 h( k# d8 j0 B3 T+ ~

1. typedef struct __DMA2D_HandleTypeDef
   
2. {
   
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   6 \6 Q# R/ ^4 n
4.   DMA2D_InitTypeDef           Init;                                                        
   
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
     C1 B* ^4 n6 ~3 q+ v/ ^
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   ) X8 G% `, R: @8 ]* y2 H7 N
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   ( K, s. _! N4 C' T# I9 l
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   1 q: y4 U) J- `# f9 W
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    ( f+ B9 s* @& U

复制代码

# W  C7 k5 x; q下面将这几个参数逐一做个说明。
0 N* t' [$ p: G0 w9 u" w0 y4 u1 q1 @
7 X/ K( ?) g* ?( p' z- }  V5 E# v1 W  DMA2D_TypeDef  *Instance
" C, K- M% o  `) J这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

* J- p, T$ C3 e  DMA2D_InitTypeDef  Init;  
0 c0 s! }( g1 h6 G8 G2 z+ ]这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。
! K2 ]' H" \2 l. C9 }, Z
  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。
0 m0 M- i6 ?% D6 T! l( O) b
  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
$ _9 M3 ^9 g% M" [这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。
8 F" H! F, A4 U: n9 q: V, i
  K9 J. f& \! B. R7 v5 W; Q  HAL_LockTypeDef   Lock
9 r9 m# @6 t" l! V( b" ?5 \__IO uint32_t    State;

__IO uint32_t    ErrorCode

这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。
: [. [* e/ r* I- Z0 H
55.3.5 DMA2D初始化流程总结
' `  _: z- N$ S' {对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。

7 p: M. D0 p$ u$ X8 W7 A4 {  q55.4 源文件stm32h7xx_hal_dma2d.c
' k& ]& t. c5 v- y  i( R这里把我们把如下几个常用到的函数做个说明：

: e$ l: u, C* T, g' E( D  HAL_DMA2D_Init
  HAL_DMA2D_ConfigLayer
  HAL_DMA2D_Start_IT
# C/ b. t) v0 _. @7 [- K  HAL_DMA2D_BlendingStart_IT

6 E+ I" o6 H1 ?+ C4 G. O. d55.4.1 函数HAL_DMA2D_Init
, Z- t. C3 x$ ?# O函数原型：
' Y* j0 y8 m: M* T. m2 H% Y8 W8 s
( A% F+ b# G. u

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   
2. {
   
3. 
   
4. /*  检测参数是否有效 */
   9 V! K0 A; D# j1 Q( {
5.   if(hdma2d == NULL)
   
6.   {
   9 h0 w+ d8 U, U( }
7.      return HAL_ERROR;
   
8.   }
   ! V% \9 V, m0 |2 J2 M5 X
9. 
   
10.   /* 检测函数形参 */
    
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    % w7 u# D# N& a
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    ; v, e3 R$ ?/ P+ K( A4 Y
15. 
    
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    
17.   {
    
18.     hdma2d->Lock = HAL_UNLOCKED;
    % R! U' v3 f7 [0 j6 D
19.     /* 初始化GPIO，NVIC等 */
    ' ?8 `( X2 s2 u7 |9 }( Q
20.     HAL_DMA2D_MspInit(hdma2d);
    ; V4 {- p. T6 |) l" c  E6 ?' S
21.   }
    
22. 
    ! w8 b+ k. b- v2 y1 k( x  K4 d
23.   /* 设置DAM2D外设状态 */
    ! @' i* s/ i7 s1 t& h/ I+ |
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    ( [2 r- O: ]# v* x
25. 
    
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    % n4 K! Q' v. Z2 T+ E1 R* o  k
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
      d7 n4 B' L9 b8 `5 z
28. 
    
29.   /* 设置输出颜色格式 ---------------------------------------*/
    
30.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_CM, hdma2d->Init.ColorMode);
      x* h& X* S. f- G- r3 y
31. 
    
32.   /* 设置输出偏移 ------------------------------------------*/  
    8 ?; C2 j5 n9 H0 o" w$ s: J
33.   MODIFY_REG(hdma2d->Instance->OOR, DMA2D_OOR_LO, hdma2d->Init.OutputOffset);  
    5 @: V: V4 A9 j5 h
34. 
    
35.   /* 设置输出颜色格式中的Alpah值反转 */
      P, W) ^1 x  D
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    
37. 
    . y* w2 q8 o/ `8 T
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    
39. 
    7 ^  b) i- \" S; Z9 k6 ^8 K8 D
40. 
    - W" n7 o  R5 ]. i( |7 C
41.   /* 无错误 */
    4 b/ g& r0 B9 G& V& X3 ?! M$ X
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
      t3 s, `  G6 }3 r" Q  [4 _
43. 
    1 l. a- c: v$ j
44.   /* DAM2D就绪 */
    
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    - u$ ~: h% F. }; \
46. 
    
47.   return HAL_OK;
    
48. }

复制代码

' M$ j9 F% f- ~8 @3 ]函数描述：
& X# K; A% P) Z( W  u! B
& g, Y3 D. J$ `6 c3 F此函数用于初始化DMA2D的工作模式和输出颜色格式。

: }" Q& O6 s" J7 ^! Z/ ~7 y: |* \函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
注意事项：
% ], z+ c. I4 x  y6 x1 ?
函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
& X: k0 A7 `# b' Z/ z9 \/ r) [8 b! {对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。
. k7 C( [8 O$ {+ ]
解决办法有三
$ e4 H' |: Z0 I
2 Z4 T4 O2 h# }' s5 H% |方法1：用户自己初始DMA2D底层。

# ?7 d  v/ l; r( ]$ U方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。
4 w# g# ]: ^2 x9 q
4 D  o4 o  c& d1 H& ]方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   $ k2 K5 q3 e7 B6 q; R: I+ ?
2. {
   . z  d: u+ j) c
3.     Error_Handler();
   0 O& b% `4 s, t; E+ Q, g; b
4. }  
   : R$ o+ G  ~9 u% N! \2 V
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   2 c* W) S9 H% B. E
6. {
   9 |3 M' j5 z' x& f2 a
7.     Error_Handler();
   
8. }

复制代码

7 n- T3 i) w  E
使用举例：
- F& N% N+ B. m; o0 t0 c" _
0 T7 `& u( X4 a, R9 A3 o' \- M

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   & Q$ _7 e- O8 z  B6 z) H# N
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   8 A# f: @3 _7 L; M6 m  p2 g4 U8 Z
4. Dma2dHandle.Instance = DMA2D;
   : @; L+ a7 M7 K+ J
5. 
   
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   9 i  l. Y; I  T5 @
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   . u  S9 C: F! u+ [4 l9 g% g) b3 [
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    
11. 
    
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    5 x) h+ n* d7 x/ L* ~
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    2 k) [4 m4 Z2 d5 Q" @
14. Dma2dHandle.XferErrorCallback = TransferError;
    
15. 
    
16. /*##-3- 前景层配置 ###########################################*/
    
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    0 {. L$ f& d2 x! _& @0 E+ g  p
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    ' _9 a, Q, {$ V% o
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    , l" f* p7 D1 f
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    8 S3 h! P: \, s& q: Z
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    , [1 A+ L1 l& \0 [
23. 
    
24. 
    
25. /*##-4- DMA2D 初始化 ###############################################*/
    / T& O! S7 S: b% E
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
    7 A& o3 S6 d5 c# ?+ S
28.     Error_Handler();
    
29. }

复制代码

55.4.2 函数HAL_DMA2D_ConfigLayer
函数原型：

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   5 ^- V6 b# J( n2 \+ v
2. {
   
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   
4. 
   : n% @2 R" x8 d2 d7 j( j
5.   uint32_t regMask = 0, regValue = 0;
   6 t5 Z5 N2 h) l* N+ {# r/ }5 I7 B  V
6. 
   
7.   /* 检查参数 */
   
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   ' `/ j2 i4 j. Y; H, S! N" j
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    
11.   {  
    
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    / u* E- y  z7 Y6 `
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    3 Z0 @9 i* m' F
14.     {
    
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    
16.     }
    + R& a: w% s3 H5 u6 A
17.   }
    / v3 G* i' r+ a, m: P3 ?9 x
18. 
    # U+ T& I3 ?2 _0 A% w& a7 U. E
19.   /* 上锁 */
    ) t7 w# F, K& D& f, _# \% E
20.   __HAL_LOCK(hdma2d);
    
21. 
    
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
      ]4 D7 R* |7 v9 |
24. 
    0 b) i1 l4 G- p) I  c) R
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    ! J/ e3 P, f$ ~: A
29. 
    
30.   regMask  = DMA2D_BGPFCCR_CM | DMA2D_BGPFCCR_AM | DMA2D_BGPFCCR_ALPHA | DMA2D_BGPFCCR_AI | DMA2D_BGPFCCR_RBS;
    
31. 
    
32.   if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    + {- j  U6 D  [
33.   {
    ! s. }( S; p' p# T7 A
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
      s- U; [& b3 m4 A
35.   }
    
36.   else
    
37.   {
    
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    " ~7 A3 R) v# g& U* R5 r
39.   }
    
40. 
    
41.   /* 配置背景层 */
    % S% Y# I6 X' s! {
42.   if(LayerIdx == 0)
    
43.   {
    " m8 \- }5 ]2 C/ Q# L; H/ B2 R) p
44.     /* DMA2D BGPFCCR 寄存器 */
    
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    
46. 
    , }: }# T; M) \& \* m3 }
47.     /* DMA2D BGOR 寄存器 */  
    
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    8 A/ Q$ I" L% i0 x/ V; n
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));
      j1 J2 u- {4 \
55.     }   
    2 z6 x! o2 U/ \
56.   }
    
57.   /* 配置前景层 */
    # ?" C; A$ j; H+ f
58.   else
    
59.   {
    1 V7 B: a% h2 r: _1 R
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    4 a. B- c* `4 E8 Z9 W8 H
61.     {
    
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    ( c/ t" u. B" C0 M2 G( G3 f0 h
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    
65. 
    
66.      /* DMA2D FGPFCCR 寄存器 */
    
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    
68. 
    
69.     /* DMA2D FGOR 寄存器 */
    
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    2 [0 K" T: \9 d- w, {/ R  o7 b$ v
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    7 n" n8 R0 E% P
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    6 f( o5 [+ K. F# j& l
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    
77.     }   
    $ v8 |  L8 p2 s! d
78.   }   
    ; q8 T/ O( ]# [& l
79.   /* DMA2D就绪 */
    ; ~; p& t- M; ~* T
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    
81. 
    
82.   /* 解锁 */
    ! F$ P, i, K1 @6 P. w1 [( c9 U# N
83.   __HAL_UNLOCK(hdma2d);  
    
84. 
    
85.   return HAL_OK;
    
86. }

复制代码

函数描述：

, h# O/ a$ F1 y6 b. o此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。

函数参数：

0 o# i5 s7 Y2 E; a& N4 e8 ?  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
' W8 u0 y  \7 @' b  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
6 a% r' y) d; X4 {1 ?, R3 j  n/ \使用举例：
6 c2 w2 ]8 R6 K+ o! x

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   
3. 
   
4. 
   7 L' u. M! J% C, x% J5 K
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   3 r& T4 j% S  K5 l& l. ]3 o
6. Dma2dHandle.Instance = DMA2D;
   + v7 h- _: k: O6 f
7. 
   
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   
9. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
10. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
    
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;
    * ?0 w! n, T9 Q; s: |; `  |2 O
17. 
    
18. /*##-3- 前景层配置 ###########################################*/
    
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    7 z, i& \  j# ]* C, @; f- \
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    4 g3 `2 a2 v1 ?# P3 X/ a" l% ]+ z
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    ) W8 N: J! F: @/ `3 e/ X+ j
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    $ B$ W7 R  I* N
25. 
    
26. /*##-4- DMA2D 初始化 ###############################################*/
    , ~2 U3 E- E/ _9 k# |
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    2 p! z  x( D8 d; \. c3 t  ~
28. {
    
29.     Error_Handler();
    
30. }
    3 F/ U# i  ~1 Q( y% h
31. 
    
32. /* 配置前景层  */
    
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
      h! X' O: z, b( V9 E2 f, I
34. {
    ( f0 _  k- w; Y) J$ b" v. _6 \
35.    Error_Handler();
    $ e# H  Y# W6 ^4 N/ g1 C
36. }

复制代码

$ F" ^& F4 `  ^/ R: d% h55.4.3 函数HAL_DMA2D_Start_IT
函数原型：
0 J" m$ p4 V! }7 z! x" @
; G. l  ^" x' B+ {

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));
   - p2 }& r$ l$ ]7 R. G
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    ( w% J; e( A4 V5 ?! E+ U
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    ' J6 s9 W6 q' O
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    . K7 b: Z  f& k5 @0 D& M
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    
18. 
    
19.   /* 使能DMA2D */
    ) z: U+ m5 `/ O; U% s2 }
20.   __HAL_DMA2D_ENABLE(hdma2d);
    
21. 
    
22.   return HAL_OK;
    ) H+ P: A0 |5 m$ ~, u
23. }

复制代码

, h! ]% v2 M; g6 u  G0 q3 `1 p函数描述：
1 S# B6 y, n4 D( G0 V+ J) l
此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
( Q% x' v$ x4 k) A8 o
- R. P* |  e8 c, {3 r函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
# Y* W, M7 n8 E3 P" G1 k  第2个参数是源数据地址。
6 d3 S9 r0 X7 _, K6 P3 K; x3 V, X  第3个参数是目的数据地址。
, e7 r/ d5 }3 O  L& u  第4个参数是源数据的长度，即每行的像素个数。
  第5个参数是源数据的高度，即行数。
7 C' m# Q1 L9 t2 d6 d% f  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
+ ^; }% b' C$ P0 w+ O& C1 p
) S) w0 [; i3 q3 S( d/ ]' `& v

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   9 J* Z2 i* y; T! B$ b- r0 Y. L7 C
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   : \5 t8 `/ d. ]3 _
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   , z0 Q& R6 \9 J* d) ~
7.                       SIZE_Y)                  /* 源数据行数 */
   
8.    != HAL_OK)
   
9. {
   , w0 y$ d. h/ [, }$ j! _
10.    Error_Handler();
    
11. }

复制代码

  z, L, H# z0 m$ h' Q55.4.4 函数HAL_DMA2D_BlendingStart_IT
, x/ c4 Y) b6 o; E& e0 X$ e函数原型：
1 v! v- e; R3 A0 M" d4 M

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));
   & w. Q0 @1 l; M* ]2 r3 o+ O3 H8 s6 ?
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   
9. 
   
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    
13.   /* 配置DMA2D源地址2 */
    ! b  i3 V! \" G3 ^9 y
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
    
15. 
    
16.   /* 配置源地址1，目的地址和数据大小 */
    0 p6 ^, m: R7 N0 l( w" a
17.   DMA2D_SetConfig(hdma2d, SrcAddress1, DstAddress, Width, Height);
    
18. 
    
19.   /* 使能DMA2D传输完成中断，传输错误中断和配置错误中断 */
    
20.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
      V4 K& P/ p$ `+ u' Z
21. 
    
22.   /* 使能DMA2D */
    9 K3 x4 L8 w7 u, \7 Z
23.   __HAL_DMA2D_ENABLE(hdma2d);
    
24. 
    
25.   return HAL_OK;
    
26. }

复制代码

函数描述：

此函数用于启动DMA2D传输，除了数据传输以外，还支持颜色格式转换和颜色混合。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。

6 o5 _; a4 }: Y函数参数：
) u! T/ X" G" j3 V9 P4 z
5 f3 d9 j, b- `) P5 ~% S  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址1。
  第3个参数是源数据地址2。
, W" O( f4 ~9 c, Z, m  第4个参数是目的数据地址。
. `; Y, y& s( T: d7 N' Z  第5个参数是源数据的长度，即每行的像素个数。
2 h% c. q) f. f! K* X" S  第6个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
" T! _: b0 T1 Y( k* J使用举例：
2 p; d1 q  m6 r, H

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   / z, P. |/ G5 U: I  Z9 e
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   / I6 L& V! Z* u9 f0 m  {+ x; [
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   5 V& d8 Y) ?/ ~+ Z" N6 U
8.                               SIZE_Y)                 /* 源数据行数 */
   $ p% `1 [' V) x, r% s
9.    != HAL_OK)
   
10. {
    1 I6 ?- l! E1 O- A5 y
11.    Error_Handler();
    # T1 ?/ i, j% l. Q
12. }

复制代码

" p9 n0 d7 k# ^  o8 e% C
55.5 总结
本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。
; V: A4 z; f: r