55.1 初学者重要提示
  DMA2D是专门用于LCD加速的，特别是刷单色屏，刷图片，刷Alpah（透明）混合效果全靠它，而且可以大大降低CPU利用率。
  测评STM32H7的LTDC+DMA2D性能，100Hz以上无压力，刷800*480图片和色块仅需2.6ms一张
' j; Q" z# z. ^; z  H7的DMA2D与F429的DMA2D最大区别是支持了ARGB和ABGR互转，而且支持H7的硬解JEPG输出格式YCbCr转RGB，方便LCD显示。
  特别注意，大家只需对HAL库提供的DMA2D操作API有个了解即可，实际工程中，并不使用这些API，我们需要使用更加高效的寄存器直接操作，在下一章节会为大家说明。
1 [% D, e+ T3 H5 D55.2 DMA2D基础知识
+ c' }4 ~! C" YDMA2D主要实现了两个功能，一个是DMA数据传输功能，另一个是2D图形加速功能。
  w$ u6 e8 j$ w; S. y
  DMA数据传输
主要是两种方式，一个是寄存器到存储器，另一个是存储器到存储器。通过DMA可以大大降低CPU的利用率。
2 ]& K; k6 B0 i; m8 N
  2D图形加速功能
支持硬件的颜色格式转换和Alpha混合效果。
1 E) Z7 M! |) F  a8 d: Y4 r/ }; C
55.2.1 DMA2D硬件框图
/ m; d7 e+ k1 t* O9 }认识一个外设，最好的方式就是看它的框图，方便我们快速地了解DMA2D的基本功能，然后再看手册了解细节。框图如下所示：

通过这个框图，我们可以得到如下信息：
4 m% @, t% A5 e- r; o3 B: M* m2 t
' I/ B' X8 D) z8 a: _  dma2d_aclk
- s; s8 L" [% q- X" v) f# yAXI 总线时钟输入。
/ Z5 S  B* [0 i
' V" p; S5 C! q. N' `$ K/ u5 L  dma2d_gbl_it
DMA2D全局中断输出。
$ G& G' |. K1 |! [+ M- z
% a% \, ?4 A' k  dma2d_clut_trg
CLUT传输完成信号输出，可以触发MDMA。

7 f+ Y; ~1 N! u, |1 V2 _" V8 ^' k  dma2d_tc_trg
传输完成信号输出，可以触发MDMA。

' l3 {8 g* v2 Z  g8 G9 }  dma2d_tw_trg
传输watermark信号输出，可以触发MDMA。
7 H& R2 G& x# M: ]; u: T$ X0 F
$ \' f- e: B* E3 r将这个硬件框图简化一下，就是下面这样：

* X6 H8 I/ _$ }( y  |# M( m  Z- ~7 x

3 u- f+ u) J+ L- K( E3 z
下面按照简化的硬件框图，对每个部分做个说明。
  U" [. T7 u3 w5 U# N
3 o* k" n+ ~2 l# J) t6 ]$ C55.2.2 DMA2D工作模式
DMA2D支持的工作模式如下：

  模式1：寄存器到存储器模式
3 i5 L( s: o; c( \9 K5 u这个模式主要用于清屏，也即是将显示屏清为单色效果。
% U: x/ v5 a& f' a3 }
  模式2：存储器到存储器模式
这个模式用于从一个存储器复制一块数据到另一个存储器，比如将摄像头OV7670的输出图像复制到LCD显存就可以采用这种方式。

  模式3：存储器到存储器模式，带颜色格式转换
7 }/ j* K/ |. o# {) |: z( b, l这个模式比模式2多了一个颜色格式转换，比如我们要显示一幅RGB888颜色格式的位图到RGB565颜色格式的显示屏，就需要用到这个模式，只需输入端配置为RGB888，输出端配置RGB565即可。位图颜色格式转换后会显示到显示屏上。
: @; P6 S4 x0 C  q" _
: u; Q- M& ]- w- r. w  模式4：存储器到存储器模式，带颜色格式转换和混合
! ?9 T. I( i' z+ }! ?0 ?$ x这个模式比模式3多了一个混合操作，通过混合，可以将两种效果进行混合显示。

  模式5：存储器到存储器模式，带颜色格式转换和混合，前景色是固定的
/ k6 f5 X: w% ?+ m- W. v同模式4，只是前景色的颜色值是固定的。
5 T$ J7 |; ]- X( ]
55.2.3 前景层和背景层的输入以及颜色格式转换
前景层和背景层是指的用户绘制图形时的前景色和背景色，比如我们显示汉字，字体会有一个颜色，也就是前景色，还有一个背景色。又比如我们绘制两幅图片，想将两幅图片混合，那就可以将一幅图片作为前景层，另一个幅图片作为背景层。

DMA2D支持的输入颜色格式如下，前景层和背景层一样：
+ G" ?. T; w. m' Z

前8种颜色格式在第50章的第2小节开头有介绍，这里把后四种做个说明：

  L4 (4-bit luminance or CLUT)
. i# b/ O/ t3 o  A4位颜色格式，实际上仅仅是4位索引值，范围0–15,而每个索引值的具体颜色值在查色表CLUT里面存储。
. @" q  H8 G+ k7 t" v  ~
  A4和A8
A4和A8用于特定的Alpha模式，既不存储颜色信息，也没有索引值。

  YCbCr
这个是H7的硬件JPEG输出的颜色格式，后面JPEG章节为大家专门做讲解。
  \+ d! z6 U5 Q" Y3 r& r
这里特别注意一点，输入颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。
1 q) B: O  n- ?' {
1 v1 i$ R7 O4 \55.2.4 前景层和背景层混合
DMA2D混合器用于混合前景色和背景色，这个功能不需要任何配置，仅需要通过DMA2D_CR寄存器使能即可。混合公式如下：

" q  F  n$ }1 z

. `/ b( D, i; H# b7 N+ S+ R
55.2.5 DMA2D输出颜色格式
DMA2D支持的输出颜色格式如下：
$ p" x. D- N; Y; p* M1 p8 m( |

这里特别注意一点，输出颜色格式的Alpha值是可以设置的，而且颜色格式里面的R通道和B通道可以交换位置。

( H$ w4 a( w* X$ ~7 R55.3 DMA2D的HAL库用法
/ M7 C+ H! a; fDMA2D的HAL库用法其实就是几个结构体变量成员的配置和使用，然后配置时钟，并根据需要配置NVIC、中断。下面我们逐一展开为大家做个说明。
- v. A- S& _. ~- }: S) b0 u
55.3.1 DMA2D寄存器结构体DMA2D_TypeDef
DMA2D相关的寄存器是通过HAL库中的结构体DMA2D_TypeDef定义的，在stm32h743xx.h中可以找到它们的具体定义：

8 }1 t4 S  |8 g6 \

1. typedef struct
   
2. {
   $ f( s7 A3 U" r* z0 g: {
3.   __IO uint32_t CR;            /*!< DMA2D Control Register,                         Address offset: 0x00 */
   
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 */
   
6.   __IO uint32_t FGMAR;         /*!< DMA2D Foreground Memory Address Register,       Address offset: 0x0C */
   1 G, }$ t0 R/ w: o" [1 x- P
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 */
   
10.   __IO uint32_t FGPFCCR;       /*!< DMA2D Foreground PFC Control Register,          Address offset: 0x1C */
    ; n6 V' |# W2 Q& t, c7 L' y- ~
11.   __IO uint32_t FGCOLR;        /*!< DMA2D Foreground Color Register,                Address offset: 0x20 */
    3 X. y7 ?0 F; E  n$ Z" _+ g" A
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 */
      i; v: f  s0 w% ]! n: h! s
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 */
    2 z; k: N3 y$ O* K
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 */
    ( n9 i& l7 R$ k- V. E3 l% O/ v
21.   __IO uint32_t LWR;           /*!< DMA2D Line Watermark Register,                  Address offset: 0x48 */
    + z7 P; A' u3 u* u
22.   __IO uint32_t AMTCR;         /*!< DMA2D AHB Master Timer Configuration Register,  Address offset: 0x4C */
    * x" \: V2 e6 O
23.   uint32_t      RESERVED[236]; /*!< Reserved, 0x50-0x3FF */
    ! S. x' y/ {! o/ U
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 */
    2 q6 ]2 L8 i2 w# t( v& \  z7 S2 V
26. } DMA2D_TypeDef;

复制代码

7 b: H, ^, a" E* c
__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)
   9 B8 C' l- [. C3 [0 r
2. #define D1_AHB1PERIPH_BASE       (PERIPH_BASE + 0x12000000)
   
3. #define DMA2D_BASE               (D1_AHB1PERIPH_BASE + 0x1000)
   ! E  e# X& L! z
4. #define DMA2D                    ((DMA2D_TypeDef *) DMA2D_BASE) <----- 展开这个宏，(DMA2D_TypeDef *) 0x52001000

复制代码

2 X( m& a  @: V" }  t/ {0 H我们访问DMA2D的ISR寄存器可以采用这种形式：DMA2D->ISR = 0。

55.3.2 DMA2D参数初始化结构体DMA2D_InitTypeDef
/ p/ g& R* o' w' W; x( I此结构体用于配置DMA2D的基本参数，具体定义如下：
" R/ Y+ X* S% D+ l& z. \! {

1. typedef struct
   8 i2 @* I4 W1 H2 A" _
2. {
   1 E1 M+ x  L+ L' s8 t- R; j
3.   uint32_t             Mode;              
   , y0 j# _  j5 ?5 G
4.   uint32_t             ColorMode;        
   9 B7 s+ d# d( l. I" Y( I
5.   uint32_t             OutputOffset;      
   $ g- x8 d1 v$ A0 ]4 f6 A( ^3 W, r( D
6.   uint32_t             AlphaInverted;   
   
7.   uint32_t             RedBlueSwap;      
   3 M1 s, K* J: \1 X  _: X+ V
8. } DMA2D_InitTypeDef;

复制代码

" N' D, E# b/ Z! r" S5 L# l# D* U下面将这几个参数逐一为大家做个说明：
* ?) {1 N. B) n; r* D# H
  uint32_t   Mode
此参数用于设置DMA2D的传输模式，具体支持的参数如下：
; H4 B4 W0 O/ e$ U
$ {! v. v; L. X" h

1. #define DMA2D_M2M        ((uint32_t)0x00000000U)  /*存储器到存储传输模式 */
   2 j; t) L% ]" c2 E& V' C  m% u
2. #define DMA2D_M2M_PFC     DMA2D_CR_MODE_0         /*存储器到存储器传输模式，并执行FPC像素格式转 */
   
3. #define DMA2D_M2M_BLEND   DMA2D_CR_MODE_1         /* 存储器到存储器模式，并执行像素格式转换和混合 */
   
4. #define DMA2D_R2M         DMA2D_CR_MODE           /* 寄存器到存储器传输模式 */
   / f# D1 d7 L& |" q$ J, ^" L' c

复制代码

( P4 K' Y1 ?0 U
+ c6 L* T1 m+ j) v- ^5 w  uint32_t   ColorMode
. v" [9 ~8 s; k2 Y. J此参数用于设置DMA2D的输出颜色格式，具体支持的参数如下：
2 R) k1 Y8 P5 h0 B* `6 G
, _1 j% n( a8 a

1. #define DMA2D_OUTPUT_ARGB8888       ((uint32_t)0x00000000U)               /* ARGB8888 */
   
2. #define DMA2D_OUTPUT_RGB888         DMA2D_OPFCCR_CM_0                     /* RGB888 */
   ) H1 p" o# M" A- i1 Q
3. #define DMA2D_OUTPUT_RGB565         DMA2D_OPFCCR_CM_1                     /* RGB565 */
   2 l: C* x% {! n, X  ~! f
4. #define DMA2D_OUTPUT_ARGB1555       (DMA2D_OPFCCR_CM_0|DMA2D_OPFCCR_CM_1) /* ARGB1555 */
   
5. #define DMA2D_OUTPUT_ARGB4444       DMA2D_OPFCCR_CM_2                     /* ARGB4444 */
   , t$ s0 ~7 r4 ]/ a

复制代码

) u4 ?3 C3 p7 Y' j
  uint32_t   OutputOffset
此参数用于设置输出位置的偏移值，参数范围0x0000到0x3FFF。
0 M8 A, t6 n  P
; K% X- p% ?9 n  uint32_t   AlphaInverted
此参数用于设置DMA2D的输出颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     
& p$ ?5 S  ^7 w7 H6 ]( {" D5 z7 G
& O/ P" a% }8 f2 J- Y6 g/ `

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   6 D5 ]- ]9 I: T: l( ~8 r
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */

复制代码

  uint32_t   RedBlueSwap
, r; l: i) K- E9 w+ e! d$ `7 T/ Y+ i此参数用于设置DMA2D的输出颜色格式中R通道和B通道的交换，具体支持的参数如下：

1. #define DMA2D_RB_REGULAR   ((uint32_t)0x00000000U)  /* 不交换(RGB or ARGB) */
   9 i3 H7 ~7 t7 \3 P  X
2. #define DMA2D_RB_SWAP      ((uint32_t)0x00000001U)  /* 交换(BGR or ABGR) */

复制代码

55.3.3 DMA2D的图层结构体DMA2D_LayerCfgTypeDef
5 f; v4 \0 h5 m# r此结构体用于配置前景色和背景色。
" W* w) e. M! w4 t5 \. g

1. typedef struct
   
2. {
   2 v: M7 B0 Z# @4 z
3.   uint32_t             InputOffset;      
   ( h. }$ P0 q1 [$ J; N  b( W
4.   uint32_t             InputColorMode;   
   : X  j7 v; i0 z
5.   uint32_t             AlphaMode;        
   ; L- k  t! {" N! @8 Z. P" [$ m
6.   uint32_t             InputAlpha;        
   
7.   uint32_t             AlphaInverted;   
   
8.   uint32_t             RedBlueSwap;      
   
9.   uint32_t             ChromaSubSampling;
   5 J: f5 N, E1 x( e
10. } DMA2D_LayerCfgTypeDef;

复制代码

. D2 i3 j0 R1 H' e  c下面将这几个参数逐一为大家做个说明。

  uint32_t  InputOffset
) v5 S& x" o0 i: M设置前景色或者背景色的输入偏移，范围0x000到0x3FFF。
( u  V  y* t9 F1 L
  uint32_t  InputColorMode
设置前景色或者背景色的输入颜色格式，具体支持的参数如下：
* ?/ Y  @$ E3 O* \& V5 i) |) e

1. #define DMA2D_INPUT_ARGB8888        ((uint32_t)0x00000000U)  /* ARGB8888 */
   + v8 Y+ y" V/ h3 p5 X% G
2. #define DMA2D_INPUT_RGB888          ((uint32_t)0x00000001U)  /* RGB888   */
   
3. #define DMA2D_INPUT_RGB565          ((uint32_t)0x00000002U)  /* RGB565   */
   # C: h8 g3 N  ?- `' v- U2 N* c- [
4. #define DMA2D_INPUT_ARGB1555        ((uint32_t)0x00000003U)  /* ARGB1555 */
   9 k2 `4 C, Z% a! b
5. #define DMA2D_INPUT_ARGB4444        ((uint32_t)0x00000004U)  /* ARGB4444 */
   2 G7 s8 W3 f! k7 p5 X
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     */
   5 _; x9 l4 W. M9 I( g1 G) Z/ q% V# \' L
9. #define DMA2D_INPUT_L4              ((uint32_t)0x00000008U)  /* L4       */
   
10. #define DMA2D_INPUT_A8              ((uint32_t)0x00000009U)  /* A8       */
    + D: S& W+ T- Y: h/ E
11. #define DMA2D_INPUT_A4              ((uint32_t)0x0000000AU)  /* A4       */
    
12. #define DMA2D_INPUT_YCBCR           ((uint32_t)0x0000000BU)  /* YCbCr    */

复制代码

8 C8 M  z4 d5 i/ g  uint32_t AlphaMode
设置前景色或者背景色的Alpha模式，具体支持的参数如下：

1. #define DMA2D_NO_MODIF_ALPHA   ((uint32_t)0x00000000U)  /* 不修改Alpha通道值 */
   # U4 }# W2 w# W1 q0 d8 n
2. #define DMA2D_REPLACE_ALPHA    ((uint32_t)0x00000001U)  /* 用新设置的Alpha值替换原始Alpha值 */
   / m2 l9 M" m2 N+ I
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
8 @- a. W6 ~& V* ~7 x) T设置前景色或者背景色的输入颜色格式Alpha值反转（即255-原来数值），具体支持的参数如下：     

1. #define DMA2D_REGULAR_ALPHA      ((uint32_t)0x00000000U)  /* 正常输出 */
   . g1 a5 _8 H( M! x. Y* n! X2 D
2. #define DMA2D_INVERTED_ALPHA     ((uint32_t)0x00000001U)  /* 反转输出 */     

复制代码

' B  ^6 ], F) W6 l3 v2 X  uint32_t   RedBlueSwap
设置前景色或者背景色颜色格式中R通道和B通道的交换，具体支持的参数如下：

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

复制代码

' w  F7 J' e% D, Q. f( K  uint32_t   ChromaSubSampling
设置前景色或者背景色中YCbCr 颜色模式的采样格式，具体支持的参数如下：

1. #define DMA2D_NO_CSS               ((uint32_t)0x00000000)  /* 4:4:4 */
   , s  Y; G8 ^% {! X9 C' m
2. #define DMA2D_CSS_422              ((uint32_t)0x00000001)  /* 4:2:2 */
   4 J4 A+ ~1 J9 o) q" [, C$ V( h# H% l! D" ?
3. #define DMA2D_CSS_420              ((uint32_t)0x00000002)  /* 4:2:0 */  

复制代码

% q0 y! w4 q, M  Y9 Z$ Z; j0 J5 \55.3.4 DMA2D句柄结构体DMA2D_HandleTypeDef
7 _9 V# c$ R7 q) d  rHAL库在DMA2D_TypeDef， DMA2D_InitTypeDef和DMA2D_LayerCfgTypeDef的基础上封装了一个结构体DMA2D_HandleTypeDef，定义如下：

1. typedef struct __DMA2D_HandleTypeDef
   4 \; H; F# U+ O( s. x8 \
2. {
   
3.   DMA2D_TypeDef               *Instance;                                                                                                                                                                                          
   
4.   DMA2D_InitTypeDef           Init;                                                        
   
5.   void                        (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                                                                             
   
6.   void                        (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);                                                                                      
   . U* I& \+ Y2 f: p
7.   DMA2D_LayerCfgTypeDef       LayerCfg[MAX_DMA2D_LAYER];                                    
   - K8 Z6 ]' O' _. H
8.   HAL_LockTypeDef             Lock;                                                                                                                                                                                                   
   / o7 M( s/ j3 ~# e3 p" @
9.   __IO HAL_DMA2D_StateTypeDef State;                                                                                                                                                                                                   
   
10.   __IO uint32_t               ErrorCode;                                                   } DMA2D_HandleTypeDef;
    0 d/ n& X% G, M- v1 o

复制代码

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

, K1 ~+ g$ n: }# Q8 _$ T7 |* k  DMA2D_TypeDef  *Instance
这个参数是寄存器的例化，方便操作寄存器，详见本章3.1小节。

) y  A( y/ T( q5 k9 m+ Z  DMA2D_InitTypeDef  Init;  
这个参数是用户接触较多的，用于配置DMA2D的基本参数，详见本章3.2小节。

  void     (* XferCpltCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
  S8 M  P) V2 X) Z/ m  void     (* XferErrorCallback)(struct __DMA2D_HandleTypeDef * hdma2d);
- @, a& e4 o& u; Y* l0 l; z! ~; @DMA2D中断服务程序里面执行的回调函数，一个是传输完成回调，另一个是传输错误回调。
' ^' E$ d' s0 x# x2 T3 [
  ?2 }8 U+ T  i  DMA2D_LayerCfgTypeDef   LayerCfg[MAX_DMA2D_LAYER]
这个参数用于前景色和背景色的设置，MAX_DMA2D_LAYER=2，详见本章3.3小节。

; d* B) b' D8 ~& O  HAL_LockTypeDef   Lock
/ Y. ]  u" l- Y4 v4 b__IO uint32_t    State;

8 ~8 _% r8 O) w. N- b__IO uint32_t    ErrorCode
( i% D0 A) `* C; f& E; k2 |
- ~& q# L( r% `5 U9 h8 c这三个变量主要供函数内部使用。Lock用于设置锁状态，State用于设置DMA2D通信状态，而ErrorCode用于配置代码错误。

55.3.5 DMA2D初始化流程总结
4 c- R4 X1 W  X, E6 B6 Q对于DMA2D来说，其实不需要初始化流程，每个功能都可以直接封装出一个函数来，下个章节会为大家专门讲解，也是实际项目比较推荐的方式。
* c$ F$ w% |- Y' {6 k7 i. A
' b9 v/ s, E) U0 f. J7 s55.4 源文件stm32h7xx_hal_dma2d.c
& N, _) P) W5 _5 v这里把我们把如下几个常用到的函数做个说明：
+ f- o; r( l* m9 V: p5 \+ m$ v& G
* x% a. N, E/ X* ?  HAL_DMA2D_Init
; c, L% W0 a" J8 ]1 k% g$ R# L  HAL_DMA2D_ConfigLayer
; a6 e. C7 `' d  HAL_DMA2D_Start_IT
  HAL_DMA2D_BlendingStart_IT
# |7 N6 k9 A" m, P
7 n3 \/ H  F& F0 z, ]  \55.4.1 函数HAL_DMA2D_Init
函数原型：

1. HAL_StatusTypeDef HAL_DMA2D_Init(DMA2D_HandleTypeDef *hdma2d)
   ! o$ t4 O9 ?8 e2 N. S: k
2. {
   2 @: G" S) o- G, L
3. 
   
4. /*  检测参数是否有效 */
   
5.   if(hdma2d == NULL)
   * F* B. q+ F1 |+ R0 M
6.   {
   9 w8 e# m) j0 ]. r
7.      return HAL_ERROR;
   # D& ^6 M0 N0 w' x
8.   }
   
9. 
   
10.   /* 检测函数形参 */
    
11.   assert_param(IS_DMA2D_ALL_INSTANCE(hdma2d->Instance));
    ' ]3 E6 D) P" u, y0 D# |! P
12.   assert_param(IS_DMA2D_MODE(hdma2d->Init.Mode));
    6 s7 {! X% P1 @7 R" H
13.   assert_param(IS_DMA2D_CMODE(hdma2d->Init.ColorMode));
    
14.   assert_param(IS_DMA2D_OFFSET(hdma2d->Init.OutputOffset));
    
15. 
    ( k5 L+ |" Q1 k" L
16.   if(hdma2d->State == HAL_DMA2D_STATE_RESET)
    ! t. u6 a- Z0 f7 u+ Z, F# x: A: _
17.   {
    8 c0 z7 {+ F/ D, {  j# |
18.     hdma2d->Lock = HAL_UNLOCKED;
    1 u* J! \) Y& f% Y# ]7 `/ M% [
19.     /* 初始化GPIO，NVIC等 */
    8 X$ w! r& _0 H$ n3 D0 }; J7 r
20.     HAL_DMA2D_MspInit(hdma2d);
    ' L0 C$ Y7 [* B$ F8 a! W
21.   }
    
22. 
    
23.   /* 设置DAM2D外设状态 */
    6 G/ X6 f6 _4 [6 E5 p
24.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    1 z$ d1 k0 n2 u- O! o  g0 {5 H: J
25. 
    3 \- ^7 D% z' z/ ^. m9 w! \# h
26.   /* 设置DAM2D工作模式 -------------------------------------------*/
    
27.   MODIFY_REG(hdma2d->Instance->CR, DMA2D_CR_MODE, hdma2d->Init.Mode);
    1 ^) U8 C* h7 S# F/ z
28. 
    . |3 I& l: g3 O0 h2 g  B. A
29.   /* 设置输出颜色格式 ---------------------------------------*/
    
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);  
    ' b4 ~  a; j3 T3 z/ ]' D7 n
34. 
    ; u* k0 r" U  f. ~4 t
35.   /* 设置输出颜色格式中的Alpah值反转 */
    - ~  i/ i3 M2 |( z) |2 v; m5 O
36.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_AI, (hdma2d->Init.AlphaInverted << DMA2D_POSITION_OPFCCR_AI));
    ) r, Q) v% Y7 j) i/ ^3 Z
37. 
    
38.   MODIFY_REG(hdma2d->Instance->OPFCCR, DMA2D_OPFCCR_RBS,(hdma2d->Init.RedBlueSwap << DMA2D_POSITION_OPFCCR_RBS));
    ! N& h+ e4 d3 D
39. 
    
40. 
    7 r/ n' ~% |& |* [1 _8 O; d2 d
41.   /* 无错误 */
    
42.   hdma2d->ErrorCode = HAL_DMA2D_ERROR_NONE;
    
43. 
    
44.   /* DAM2D就绪 */
    . c- _$ y: |9 ?- ]
45.   hdma2d->State  = HAL_DMA2D_STATE_READY;
    / J( n& c9 j, ?; D$ G: z
46. 
    ; Q- c+ I# u, @; B( l: h
47.   return HAL_OK;
    
48. }

复制代码

$ D8 \2 E% K/ S4 P' e3 L2 I函数描述：

. M( ?. ~/ v) Q7 R$ ^! t) u! J6 O此函数用于初始化DMA2D的工作模式和输出颜色格式。
8 f5 p8 z# p4 m/ F5 ]3 F
函数参数：
2 Z$ Y; M4 C" _" q* k4 k" z
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置要初始化的参数，结构体变量成员的详细介绍看本章3.4小节。
. F* c3 r& i" \  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
5 D. S1 E5 V# p6 X: G8 [+ [注意事项：

函数HAL_DMA2D_MspInit用于初始化DMA2D的底层时钟、NVIC等功能。需要用户自己在此函数里面实现具体的功能。由于这个函数是弱定义的，允许用户在工程其它源文件里面重新实现此函数。当然，不限制一定要在此函数里面实现，也可以像早期的标准库那样，用户自己初始化即可，更灵活些。
! N8 A/ V5 q, _9 u$ \如果形参hdma2d的结构体成员State没有做初始状态，这个地方就是个坑。特别是用户搞了一个局部变量DMA2D_HandleTypeDef Dma2dHandle。
对于局部变量来说，这个参数就是一个随机值，如果是全局变量还好，一般MDK和IAR都会将全部变量初始化为0，而恰好这个 HAL_DMA2D_STATE_RESET  = 0x00U。
1 l! {2 Q! N. P
" w* w0 r, f' q解决办法有三
" l8 v$ B  T9 L, D# [2 ?
方法1：用户自己初始DMA2D底层。
' y* W, M2 g$ T2 t; f* i
! S! v- V1 L* W6 C' v# p1 E方法2：定义DMA2D_HandleTypeDef LtdcHandle为全局变量。
& ^/ A  e" S2 p0 e
方法3：下面的方法

1. if(HAL_DMA2D_DeInit(&Dma2dHandle) != HAL_OK)
   
2. {
   
3.     Error_Handler();
   + B/ x/ F6 ]3 k3 q. `) ?
4. }  
   
5. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
   
6. {
   * Q+ b) v% `# G! J
7.     Error_Handler();
   
8. }

复制代码

& |* j! V2 n+ T1 A, O
使用举例：

9 {6 o1 i- @" M, p

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   # n0 {  t9 o+ ^' i3 o, t% h
3. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   2 c% D  x1 d9 _$ p: `
4. Dma2dHandle.Instance = DMA2D;
   
5. 
   
6. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   
7. Dma2dHandle.Init.ColorMode     = DMA2D_OUTPUT_ARGB4444; /* 输出颜色格式 */
   
8. Dma2dHandle.Init.OutputOffset  = 0x0;                   /* 无输出偏移 */
   ' j- i7 D- ^. Z! y7 e
9. Dma2dHandle.Init.RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输出颜色的R/B通过不切换 */
   
10. Dma2dHandle.Init.AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输出颜色的Alpha通道数值不翻转 */
    6 I9 F- H# f, @) i( ^, W
11. 
    
12. /*##-2- DMA2D 回调函数配置 ######################################*/
    9 C( @' c8 |+ N/ u- g2 ?- ]
13. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
14. Dma2dHandle.XferErrorCallback = TransferError;
    * e& k  \# K! S! e* H+ P+ p
15. 
    
16. /*##-3- 前景层配置 ###########################################*/
    
17. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
      e) }2 q' z8 x& F( p) _
18. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    
19. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    
20. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    
21. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    # i% E; J& N, u9 G$ Z: d- i
22. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
23. 
    
24. 
    
25. /*##-4- DMA2D 初始化 ###############################################*/
    
26. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
27. {
      p3 m; E7 \" f7 e, C! w5 u" ^& Y1 r
28.     Error_Handler();
    7 P2 n" l$ r6 t% f, ?* U  f
29. }

复制代码

/ d- x( V$ D% R; r55.4.2 函数HAL_DMA2D_ConfigLayer
, y1 |" s3 u- ]: }函数原型：
7 a" o9 [* C4 t" }3 d/ c, C; f

1. HAL_StatusTypeDef HAL_DMA2D_ConfigLayer(DMA2D_HandleTypeDef *hdma2d, uint32_t LayerIdx)
   $ ^4 d) G- y* j- q
2. {
     O& y0 ]. p8 |( s, d
3.   DMA2D_LayerCfgTypeDef *pLayerCfg = &hdma2d->LayerCfg[LayerIdx];
   8 G6 b: \, c# H! N
4. 
   ' Q  r+ g( @8 {; I! _4 R1 }
5.   uint32_t regMask = 0, regValue = 0;
   6 `0 ~% Q6 u. R6 b
6. 
   
7.   /* 检查参数 */
   , {1 w7 A& J# d9 H2 \9 ]0 x- B9 m
8.   assert_param(IS_DMA2D_LAYER(LayerIdx));  
   4 _5 ?' e$ B8 N) ?+ F1 O: _
9.   assert_param(IS_DMA2D_OFFSET(pLayerCfg->InputOffset));  
   
10.   if(hdma2d->Init.Mode != DMA2D_R2M)
    0 P2 n% r! G0 T- ?
11.   {  
    ' o1 ]6 Y4 J  e: e3 I7 p
12.     assert_param(IS_DMA2D_INPUT_COLOR_MODE(pLayerCfg->InputColorMode));
    
13.     if(hdma2d->Init.Mode != DMA2D_M2M)
    
14.     {
    ( ^+ Q# ?9 b5 P6 P" n
15.       assert_param(IS_DMA2D_ALPHA_MODE(pLayerCfg->AlphaMode));
    $ l4 D9 m" J; e6 T' t. v
16.     }
    9 \' ?0 H! V( ~2 _* W8 Y
17.   }
    ) q2 Z5 A9 Q8 d' q
18. 
    
19.   /* 上锁 */
    - P6 w8 E# g' q- O5 o5 N+ _
20.   __HAL_LOCK(hdma2d);
    + y. S, o. V2 t) a& U! ?
21. 
    
22.   /* 设置DMA2D外设状态 */
    
23.   hdma2d->State = HAL_DMA2D_STATE_BUSY;  
    8 n6 F, A1 U2 u- u2 m! a( l. y
24. 
    1 J* j4 g: G2 Z0 N( p5 U
25.   /* 准备好背景层或者前景层FPC寄存器配置参数*/
    4 K6 c; q2 [9 }1 \/ w: o9 [
26.   regValue = pLayerCfg->InputColorMode | (pLayerCfg->AlphaMode << DMA2D_POSITION_BGPFCCR_AM) | \
    9 b  r! q1 ?  d( v5 z/ ]
27.             (pLayerCfg->AlphaInverted << DMA2D_POSITION_BGPFCCR_AI) | \
    ' _/ _% N6 f- U# b
28.             (pLayerCfg->RedBlueSwap << DMA2D_POSITION_BGPFCCR_RBS);
    , Q/ D5 k! e" B" Y7 l0 @
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))
    
33.   {
    
34.     regValue |= (pLayerCfg->InputAlpha & DMA2D_BGPFCCR_ALPHA);
    & Y' _5 [7 d' Q1 ~/ H; @/ ^
35.   }
    
36.   else
    
37.   {
    7 @; @& {9 z, Q
38.     regValue |=  (pLayerCfg->InputAlpha << DMA2D_POSITION_BGPFCCR_ALPHA);
    
39.   }
    
40. 
    1 ]& k' V/ h$ e$ V) I
41.   /* 配置背景层 */
    
42.   if(LayerIdx == 0)
    
43.   {
    
44.     /* DMA2D BGPFCCR 寄存器 */
    & f& M' D. B3 m
45.     MODIFY_REG(hdma2d->Instance->BGPFCCR, regMask, regValue);
    & r7 Z! q5 }! {. `6 L0 ]; }- I
46. 
    " g/ Y+ M2 h) R3 w5 g. W
47.     /* DMA2D BGOR 寄存器 */  
    
48.     WRITE_REG(hdma2d->Instance->BGOR, pLayerCfg->InputOffset);
    ! S1 S! ^3 c$ _
49. 
    " s- H% m& h" T$ \+ p
50.     /* DMA2D BGCOLR 寄存器 */
    ; V1 o. H1 i" S0 q" U9 C2 |* E
51.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    
52.     {   
      _# ?, U- a" {2 c$ p5 T3 o
53.       WRITE_REG(hdma2d->Instance->BGCOLR, pLayerCfg->InputAlpha &
    2 P# L8 P# T) `5 `; r
54. (DMA2D_BGCOLR_BLUE|DMA2D_BGCOLR_GREEN|DMA2D_BGCOLR_RED));
    . p; _: r- j9 `$ }9 I5 R, p: B  o1 e
55.     }   
    : N; ^( z) m  h8 O  t# k3 Y) Z
56.   }
    
57.   /* 配置前景层 */
    ( }- W8 W2 E5 s/ W/ O# Q8 Q
58.   else
    3 w1 A  x! E/ w" c2 s0 O
59.   {
    $ H5 e" e. ^2 T$ U! d6 e
60.     if(pLayerCfg->InputColorMode == DMA2D_INPUT_YCBCR)
    
61.     {
    7 @. z& R9 q1 M3 g$ C
62.       regValue |= (pLayerCfg->ChromaSubSampling << DMA2D_POSITION_FGPFCCR_CSS);
    
63.       regMask  |= DMA2D_FGPFCCR_CSS;
    
64.     }
    7 q# @7 h4 J3 ]5 {' E6 p& Y
65. 
    
66.      /* DMA2D FGPFCCR 寄存器 */
    , f! Z( G8 G, z' ^' N
67.     MODIFY_REG(hdma2d->Instance->FGPFCCR, regMask, regValue);
    
68. 
    
69.     /* DMA2D FGOR 寄存器 */
    ) D9 H& q- P* m8 Y/ Q
70.     WRITE_REG(hdma2d->Instance->FGOR, pLayerCfg->InputOffset);      
    0 [3 l; g* ~  [* f
71. 
    
72.     /* DMA2D FGCOLR 寄存器 */   
    
73.     if ((pLayerCfg->InputColorMode == DMA2D_INPUT_A4) || (pLayerCfg->InputColorMode == DMA2D_INPUT_A8))
    1 R+ j0 r, y' F- [, q! w
74.     {
    
75.       WRITE_REG(hdma2d->Instance->FGCOLR, pLayerCfg->InputAlpha &
    
76. (DMA2D_FGCOLR_BLUE|DMA2D_FGCOLR_GREEN|DMA2D_FGCOLR_RED));      
    + _, y" r+ z% G5 d  @. n
77.     }   
    
78.   }   
    7 _3 R7 r: C; f3 y2 w( u7 c1 j
79.   /* DMA2D就绪 */
    2 s- [; B+ n5 a. ^, R+ [
80.   hdma2d->State = HAL_DMA2D_STATE_READY;
    9 S& U: ^+ d' h3 U+ r
81. 
    9 r1 D' |% v7 p, F
82.   /* 解锁 */
    
83.   __HAL_UNLOCK(hdma2d);  
      c$ F1 ]3 D9 M2 q
84. 
    4 O  ^) F+ f) g. E% X! t
85.   return HAL_OK;
    % k6 _9 ~, K2 E5 f0 K# x1 i
86. }

复制代码

函数描述：

1 t8 N/ {1 S( j2 c7 n! C& `此函数主要用于配置DMA2D要转换的前景层和背景层，即输入颜色配置。而前面的函数HAL_DMA2D_Init配置的输出颜色。

3 j  Q& E0 D2 X4 Z函数参数：

  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数用于配置前景层和背景层，0表示背景层，1表示前景层。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

1. 
   
2. DMA2D_HandleTypeDef Dma2dHandle;
   
3. 
   
4. 
   
5. /*##-1- 配置DMA工作模式，输出颜色格式和输出偏移 #############*/
   ' e3 e% u  Q2 Q, V
6. Dma2dHandle.Instance = DMA2D;
   6 D: }! V  V, [/ K
7. 
   $ q% G. \( G: \2 n, Q  k. H
8. Dma2dHandle.Init.Mode          = DMA2D_M2M;             /* 存储器到存储器模式 */
   & f, w7 L. U; y' {6 e
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通道数值不翻转 */
    " [" ^$ ]+ x5 Y# }; {+ S
13. 
    
14. /*##-2- DMA2D 回调函数配置 ######################################*/
    
15. Dma2dHandle.XferCpltCallback  = TransferComplete;
    
16. Dma2dHandle.XferErrorCallback = TransferError;
    
17. 
    
18. /*##-3- 前景层配置 ###########################################*/
    
19. Dma2dHandle.LayerCfg[1].AlphaMode = DMA2D_NO_MODIF_ALPHA;      /* 保持输入颜色格式中的Alpha值 */
    " z% }0 G0 G" }! _4 @! d6 T. v  L, @/ [
20. Dma2dHandle.LayerCfg[1].InputAlpha = 0xFF;                     /* 完全不透明 */
    " ?* _* ^( N$ e, d0 ~
21. Dma2dHandle.LayerCfg[1].InputColorMode = DMA2D_INPUT_ARGB4444; /* 输入颜色格式 */
    + S+ h5 o. ]( B( U( ]# W
22. Dma2dHandle.LayerCfg[1].InputOffset = 0x0;                     /* 输入无偏移 */
    % {4 J. L1 I: p7 R
23. Dma2dHandle.LayerCfg[1].RedBlueSwap   = DMA2D_RB_REGULAR;      /* 输入颜色的R/B通过不切换*/
    
24. Dma2dHandle.LayerCfg[1].AlphaInverted = DMA2D_REGULAR_ALPHA;   /* 输入颜色的Alpha通道数值不翻转*/
    
25. 
    . L8 ]/ j/ @2 [# v3 P% u  N
26. /*##-4- DMA2D 初始化 ###############################################*/
    ! z) I( w0 }  a1 Q- k
27. if(HAL_DMA2D_Init(&Dma2dHandle) != HAL_OK)
    
28. {
    
29.     Error_Handler();
    1 Q+ A/ N+ p8 ?# _
30. }
    ' x# ]+ v* n0 r! [
31. 
    
32. /* 配置前景层  */
    8 L$ Z2 }+ W5 z5 _& n) ~+ }  m
33. if(HAL_DMA2D_ConfigLayer(&Dma2dHandle, 1) != HAL_OK)
    + _& q9 b2 r# v9 h
34. {
    
35.    Error_Handler();
    3 t2 J& N. c; S3 h5 V" m# w6 Q/ I
36. }

复制代码

  k7 i$ k! H) H
8 q! L3 h( i  C# b4 Q- ]& o55.4.3 函数HAL_DMA2D_Start_IT
函数原型：
! c: }+ O  Y! H+ t* K; ]
2 @! ]" p2 V+ p- u' W5 a

1. HAL_StatusTypeDef HAL_DMA2D_Start_IT(DMA2D_HandleTypeDef *hdma2d, uint32_t pdata, uint32_t DstAddress, uint32_t Width,  uint32_t Height)
   # `8 P# s. T. M
2. {
   5 B: X+ @( Q0 [/ Y
3.   /* 检测函数形参 */
   ( ]! W  {9 H5 O% b9 r& {6 v" k; f
4.   assert_param(IS_DMA2D_LINE(Height));
   ) A+ P+ F9 q. Q, k; {  z7 x$ r
5.   assert_param(IS_DMA2D_PIXEL(Width));
   
6. 
   7 s7 ]! Z9 x1 _! U& {/ {6 J, X
7.   /* 上锁 */
   $ q4 W) w5 d, l' v: R5 w  F
8.   __HAL_LOCK(hdma2d);
   
9. 
   9 c) C. |9 Q6 U6 z" n9 e
10.   /* 设置DMA2D外设状态 */
    3 X$ }/ D, F0 x- g2 O- f" E  u4 K
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    
12. 
    
13.   /* 设置源地址，目的地址和数据大小 */
    
14.   DMA2D_SetConfig(hdma2d, pdata, DstAddress, Width, Height);
    
15. 
    - q) F! [6 E- R' _
16.   /* 使能DMA2D的传输完成中断，传输错误中断和配置错误中断 */
    
17.   __HAL_DMA2D_ENABLE_IT(hdma2d, DMA2D_IT_TC|DMA2D_IT_TE|DMA2D_IT_CE);
    $ l$ l# z9 F. U
18. 
    " m% C; e% R' \) O$ G& E
19.   /* 使能DMA2D */
    
20.   __HAL_DMA2D_ENABLE(hdma2d);
    
21. 
    
22.   return HAL_OK;
    
23. }

复制代码

, N7 j7 B- |/ Q1 z7 h* `& l+ }9 ?函数描述：
2 Z7 |% Z, A+ Y* Y$ n
此函数用于启动DMA2D数据传输。由于采用的中断方式，此函数使能了多个DMA2D中断，不要忘记DMA2D中断服务程序的处理。
" }' R- n, B; c, ]! U9 r: ]2 Q
函数参数：
4 X" w* N1 z# O# |, K
" @: G# Q- f8 u8 U8 Y: v& W  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
7 j- B6 `2 W5 B8 k9 O5 r+ D  第2个参数是源数据地址。
  第3个参数是目的数据地址。
  第4个参数是源数据的长度，即每行的像素个数。
  第5个参数是源数据的高度，即行数。
  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：
8 a6 d, B' _( |' b  u  Q
% A; [8 ~4 v/ [  A% x

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. if(HAL_DMA2D_Start_IT(&Dma2dHandle,            /* DMA2D句柄 */
   
4.                       (uint32_t)&BufferInput,  /* 源地址 */
   
5.                       (uint32_t)&BufferResult, /* 目的地址 */
   * c8 i/ m; m' C6 u" @1 S- ~" h; P
6.                       SIZE_X,                  /* 源数据长度，单位像素个数*/
   $ Y3 t; l7 G: q5 N, T- }
7.                       SIZE_Y)                  /* 源数据行数 */
   0 t+ X5 K! G) j. u: h
8.    != HAL_OK)
   ) E" `  ~5 T) s- n5 ]7 r! m
9. {
   3 }4 j2 X: j8 \* h/ S
10.    Error_Handler();
    
11. }

复制代码

4 n: P9 G" w1 M' H2 P3 f5 g55.4.4 函数HAL_DMA2D_BlendingStart_IT
4 e# _: x) i8 N函数原型：

7 C2 A/ E8 I- i9 D# 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)
   / N$ ?7 t+ V) `/ F9 J! K
2. {
   
3.   /* 检测参数 */
   
4.   assert_param(IS_DMA2D_LINE(Height));
   5 i+ J. y2 ?4 Z- Z! H
5.   assert_param(IS_DMA2D_PIXEL(Width));
   / e  Y' @9 ?6 E  `9 }- V( B
6. 
   2 g, y+ M3 V1 l' t
7.   /* 上锁 */
   
8.   __HAL_LOCK(hdma2d);
   9 c& p+ o+ [* }* @& l! z
9. 
   
10.   /* 设置DMA2D外设状态 */
    
11.   hdma2d->State = HAL_DMA2D_STATE_BUSY;
    # Z5 ?1 }; V! Q" C" }3 R& R
12. 
    
13.   /* 配置DMA2D源地址2 */
    1 U6 L6 B. ?, g5 o
14.   WRITE_REG(hdma2d->Instance->BGMAR, SrcAddress2);
      }( z( j! A' u, p- H
15. 
    ; p  t8 f4 n  z9 n, |
16.   /* 配置源地址1，目的地址和数据大小 */
    
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);
    ) @, Q# d# K5 [, T
21. 
    
22.   /* 使能DMA2D */
    % P  u# ^, ~! f: a  Z) c! y
23.   __HAL_DMA2D_ENABLE(hdma2d);
    " U, S$ Z/ E6 e$ F, x4 x! n6 a9 s7 O
24. 
    . t/ n" {6 ^) v. ]# u
25.   return HAL_OK;
    7 D9 z$ N+ E+ r+ Z" X$ p. p
26. }

复制代码

0 T2 c1 \% H4 U2 |2 R函数描述：

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

0 u, D3 c" r' w' d- w3 b. R! Z函数参数：
; [% U( Y2 Q# z% e# g
  第1个参数是DMA2D_HandleTypeDef类型结构体指针变量，用于配置DMA2D的基本参数，结构体变量成员的详细介绍看本章3.4小节。
  第2个参数是源数据地址1。
  第3个参数是源数据地址2。
  第4个参数是目的数据地址。
; C$ C2 T: F2 q) o6 d) m  V  第5个参数是源数据的长度，即每行的像素个数。
, D) n& Y4 x/ a) J1 T/ L  第6个参数是源数据的高度，即行数。
) r8 ^, b" X, D: O4 u* Q! j9 a" {  返回值，返回HAL_ERROR表示配置失败，HAL_OK表示配置成功，HAL_BUSY表示忙（操作中），HAL_TIMEOUT表示时间溢出。
使用举例：

% Q$ o- ]/ S8 A8 x" b- u, }

1. DMA2D_HandleTypeDef Dma2dHandle;
   
2. 
   
3. if(HAL_DMA2D_BlendingStart_IT(&Dma2dHandle,           /* DMA2D句柄 */
   % m4 F* e  j+ q" l& b! t! U
4.                              (uint32_t)&BufferInput1, /* 源地址1，前景色 */
   
5.                              (uint32_t)&BufferInput2, /* 源地址2，背景色 */
   
6.                              (uint32_t)&BufferResult, /* 目的地址 */
   # j# M- A; x( L1 r
7.                               SIZE_X,                 /* 源数据长度，单位像素个数*/
   
8.                               SIZE_Y)                 /* 源数据行数 */
   
9.    != HAL_OK)
   
10. {
    5 R2 e' D, ?6 A! \$ ?8 Q- ?
11.    Error_Handler();
    : R6 l# H! }: X: K% N8 a3 {. `: B
12. }

复制代码

; w7 D$ w) B+ K& K55.5 总结
* v6 `5 z# u1 x6 B2 G7 W1 Y5 R2 }) t本章节就为大家讲解这么多，DMA2D功能比较重要，一定要做到熟练使用。


7 j6 }& }5 a  b2 c1 L  k8 }