stm32g4xx_ll_dma.h

转至此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_ll_dma.h
  * @author  MCD Application Team
  * @brief   DMA LL模块的头文件。
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */

/* 定义以防止递归包含 -------------------------------------*/
#ifndef __STM32G4xx_LL_DMA_H
#define __STM32G4xx_LL_DMA_H

#ifdef __cplusplus
extern "C" {
#endif

/* 包含的头文件 ------------------------------------------------------------------*/
#include "stm32g4xx.h"
#include "stm32g4xx_ll_dmamux.h"

/** @addtogroup STM32G4xx_LL_Driver
  * @{
  */

#if defined (DMA1) || defined (DMA2)

/** @defgroup DMA_LL DMA
  * @{
  */

/* 私有类型定义 -------------------------------------------------------------*/
/* 私有变量 ---------------------------------------------------------*/
/** @defgroup DMA_LL_Private_Variables DMA私有变量
  * @{
  */
/* 用于获取DMA通道寄存器偏移量的数组，相对于通道索引LL_DMA_CHANNEL_x */
static const uint8_t CHANNEL_OFFSET_TAB[] =
{
  (uint8_t)(DMA1_Channel1_BASE - DMA1_BASE),
  (uint8_t)(DMA1_Channel2_BASE - DMA1_BASE),
  (uint8_t)(DMA1_Channel3_BASE - DMA1_BASE),
  (uint8_t)(DMA1_Channel4_BASE - DMA1_BASE),
  (uint8_t)(DMA1_Channel5_BASE - DMA1_BASE),
  (uint8_t)(DMA1_Channel6_BASE - DMA1_BASE)
#if defined (DMA1_Channel7)
  ,
  (uint8_t)(DMA1_Channel7_BASE - DMA1_BASE)
#endif /* DMA1_Channel7 */
#if defined (DMA1_Channel8)
  ,
  (uint8_t)(DMA1_Channel8_BASE - DMA1_BASE)
#endif /* DMA1_Channel8 */
};
/**
  * @}
  */

/* 私有常量定义 ---------------------------------------------------------*/
/** @defgroup DMA_LL_Private_Constants DMA私有常量
  * @{
  */
/* 用于获取CSELR寄存器偏移量的定义 */
#define DMA_CSELR_OFFSET                  (uint32_t)(DMA1_CSELR_BASE - DMA1_BASE)

/* 用于寄存器中位位置和执行偏移的定义 */
#define DMA_POSITION_CSELR_CXS            POSITION_VAL(DMA_CSELR_C1S << ((Channel-1U)*4U))
/**
  * @}
  */

/* 私有宏定义 ------------------------------------------------------------*/
#if defined(USE_FULL_LL_DRIVER)
/** @defgroup DMA_LL_Private_Macros DMA私有宏
  * @{
  */
/**
  * @}
  */
#endif /*USE_FULL_LL_DRIVER*/

/* 导出的类型定义 ------------------------------------------------------------*/
#if defined(USE_FULL_LL_DRIVER)
/** @defgroup DMA_LL_ES_INIT DMA导出的初始化结构
  * @{
  */
typedef struct
{
  uint32_t PeriphOrM2MSrcAddress;  /*!< 指定DMA传输的外设基地址
                                        或作为内存到内存传输方向下的源基地址。

                                        此参数的值必须在Min_Data = 0和Max_Data = 0xFFFFFFFF之间。 */

  uint32_t MemoryOrM2MDstAddress;  /*!< 指定DMA传输的内存基地址
                                        或作为内存到内存传输方向下的目标基地址。

                                        此参数的值必须在Min_Data = 0和Max_Data = 0xFFFFFFFF之间。 */

  uint32_t Direction;              /*!< 指定数据是从内存传输到外设，
                                        从内存到内存还是从外设到内存。
                                        此参数可以是@ref DMA_LL_EC_DIRECTION的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetDataTransferDirection()进行修改。 */

  uint32_t Mode;                   /*!< 指定正常或循环操作模式。
                                        此参数可以是@ref DMA_LL_EC_MODE的值
                                        @note: 如果在所选通道上配置了内存到内存
                                               数据传输方向，则不能使用循环缓冲区模式

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetMode()进行修改。 */

  uint32_t PeriphOrM2MSrcIncMode;  /*!< 指定外设地址或内存到内存传输方向下的源地址
                                        是否递增。
                                        此参数可以是@ref DMA_LL_EC_PERIPH的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetPeriphIncMode()进行修改。 */

  uint32_t MemoryOrM2MDstIncMode;  /*!< 指定内存地址或内存到内存传输方向下的目标地址
                                        是否递增。
                                        此参数可以是@ref DMA_LL_EC_MEMORY的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetMemoryIncMode()进行修改。 */

  uint32_t PeriphOrM2MSrcDataSize; /*!< 指定外设数据对齐方式或源数据对齐方式（字节、半字、字）
                                        在内存到内存传输方向的情况下。
                                        此参数可以是@ref DMA_LL_EC_PDATAALIGN的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetPeriphSize()进行修改。 */

  uint32_t MemoryOrM2MDstDataSize; /*!< 指定内存数据对齐方式或目标数据对齐方式（字节、半字、字）
                                        在内存到内存传输方向的情况下。
                                        此参数可以是@ref DMA_LL_EC_MDATAALIGN的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetMemorySize()进行修改。 */

  uint32_t NbData;                 /*!< 指定要传输的数据数量，以数据单位计。
                                        数据单位等于源缓冲区配置中在PeripheralSize
                                        或MemorySize参数中根据传输方向设置的值。
                                        此参数的值必须在Min_Data = 0和Max_Data = 0x0000FFFF之间

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetDataLength()进行修改。 */

  uint32_t PeriphRequest;          /*!< 指定外设请求。
                                        此参数可以是@ref DMAMUX_LL_EC_REQUEST的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetPeriphRequest()进行修改。 */

  uint32_t Priority;               /*!< 指定通道优先级级别。
                                        此参数可以是@ref DMA_LL_EC_PRIORITY的值

                                        此功能稍后可以使用单元函数@ref LL_DMA_SetChannelPriorityLevel()进行修改。 */

} LL_DMA_InitTypeDef;
/**
  * @}
  */
#endif /*USE_FULL_LL_DRIVER*/

/* 导出的常量定义 --------------------------------------------------------*/
/** @defgroup DMA_LL_Exported_Constants DMA导出的常量
  * @{
  */
/** @defgroup DMA_LL_EC_CLEAR_FLAG 清除标志定义
  * @brief    可与LL_DMA_WriteReg函数一起使用的标志定义
  * @{
  */
#define LL_DMA_IFCR_CGIF1                 DMA_IFCR_CGIF1        /*!< 通道1全局标志            */
#define LL_DMA_IFCR_CTCIF1                DMA_IFCR_CTCIF1       /*!< 通道1传输完成标志 */
#define LL_DMA_IFCR_CHTIF1                DMA_IFCR_CHTIF1       /*!< 通道1半传输标志     */
#define LL_DMA_IFCR_CTEIF1                DMA_IFCR_CTEIF1       /*!< 通道1传输错误标志    */
#define LL_DMA_IFCR_CGIF2                 DMA_IFCR_CGIF2        /*!< 通道2全局标志            */
#define LL_DMA_IFCR_CTCIF2                DMA_IFCR_CTCIF2       /*!< 通道2传输完成标志 */
#define LL_DMA_IFCR_CHTIF2                DMA_IFCR_CHTIF2       /*!< 通道2半传输标志     */
#define LL_DMA_IFCR_CTEIF2                DMA_IFCR_CTEIF2       /*!< 通道2传输错误标志    */
#define LL_DMA_IFCR_CGIF3                 DMA_IFCR_CGIF3        /*!< 通道3全局标志            */
#define LL_DMA_IFCR_CTCIF3                DMA_IFCR_CTCIF3       /*!< 通道3传输完成标志 */
#define LL_DMA_IFCR_CHTIF3                DMA_IFCR_CHTIF3       /*!< 通道3半传输标志     */
#define LL_DMA_IFCR_CTEIF3                DMA_IFCR_CTEIF3       /*!< 通道3传输错误标志    */
#define LL_DMA_IFCR_CGIF4                 DMA_IFCR_CGIF4        /*!< 通道4全局标志            */
#define LL_DMA_IFCR_CTCIF4                DMA_IFCR_CTCIF4       /*!< 通道4传输完成标志 */
#define LL_DMA_IFCR_CHTIF4                DMA_IFCR_CHTIF4       /*!<