stm32g4xx_hal_dma.c

转到该文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_dma.c
  * @author  MCD Application Team
  * @brief   DMA HAL模块驱动程序。
  *         本文件提供固件功能以管理直接内存访问（DMA）外设的以下功能：
  *           + 初始化和反初始化函数
  *           + IO操作函数
  *           + 外设状态和错误函数
  *
  ******************************************************************************
  * @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.
  *
  ******************************************************************************
  @verbatim
  ==============================================================================
                        ##### 如何使用此驱动程序 #####
  ==============================================================================
  [..]
   (#) 启用并配置要连接到DMA通道的外设
       （内部SRAM/FLASH存储器除外：无需初始化）。
       请参阅参考手册中外设与DMA请求之间的连接。

   (#) 对于给定通道，通过以下参数编程所需配置：
       通道请求、传输方向、源和目标数据格式、
       循环或正常模式、通道优先级、源和目标递增模式
       使用HAL_DMA_Init()函数。

       在HAL_DMA_Init之前，应为DMA和DMAMUX启用外设时钟：
      (##) DMA1或DMA2: __HAL_RCC_DMA1_CLK_ENABLE()或 __HAL_RCC_DMA2_CLK_ENABLE();
      (##) DMAMUX1:      __HAL_RCC_DMAMUX1_CLK_ENABLE();

   (#) 使用HAL_DMA_GetState()函数返回DMA状态，并在发生错误时使用HAL_DMA_GetError()进行错误检测。

   (#) 使用HAL_DMA_Abort()函数中止当前传输

     -@-   在内存到内存传输模式下，不允许使用循环模式。

     *** 轮询模式IO操作 ***
     =================================
    [..]
          (+) 使用HAL_DMA_Start()在配置源地址、目标地址和要传输的数据长度后启动DMA传输
          (+) 使用HAL_DMA_PollForTransfer()轮询当前传输的结束，在这种情况下
              用户可以根据其应用配置固定的超时时间。

     *** 中断模式IO操作 ***
     ===================================
    [..]
          (+) 使用HAL_NVIC_SetPriority()配置DMA中断优先级
          (+) 使用HAL_NVIC_EnableIRQ()启用DMA IRQ处理程序
          (+) 使用HAL_DMA_Start_IT()在配置源地址、目标地址和要传输的数据长度后启动DMA传输。
              在这种情况下，DMA中断已被配置
          (+) 在DMA_IRQHandler()中断子程序中调用HAL_DMA_IRQHandler()
          (+) 在数据传输结束时执行HAL_DMA_IRQHandler()函数，用户可以通过HAL_DMA_RegisterCallback()注册自己的回调函数。

     *** DMA HAL驱动程序宏列表 ***
     =============================================
      [..]
       以下是DMA HAL驱动程序中的宏列表。

       (+) __HAL_DMA_ENABLE：启用指定的DMA通道。
       (+) __HAL_DMA_DISABLE：禁用指定的DMA通道。
       (+) __HAL_DMA_GET_FLAG：获取DMA通道待处理标志。
       (+) __HAL_DMA_CLEAR_FLAG：清除DMA通道待处理标志。
       (+) __HAL_DMA_ENABLE_IT：启用指定的DMA通道中断。
       (+) __HAL_DMA_DISABLE_IT：禁用指定的DMA通道中断。
       (+) __HAL_DMA_GET_IT_SOURCE：检查指定的DMA通道中断是否已发生。

     [..]
      (@) 您可以参阅DMA HAL驱动程序头文件以获取更多有用的宏

  @endverbatim
  */

/* Includes ------------------------------------------------------------------*/
#include "stm32g4xx_hal.h"

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

/** @defgroup DMA DMA
  * @brief DMA HAL模块驱动程序
  * @{
  */

#ifdef HAL_DMA_MODULE_ENABLED

/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/
/* Private macro -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private function prototypes -----------------------------------------------*/
/** @defgroup DMA_Private_Functions DMA私有函数
  * @{
  */
static void DMA_SetConfig(DMA_HandleTypeDef *hdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t DataLength);
static void DMA_CalcDMAMUXChannelBaseAndMask(DMA_HandleTypeDef *hdma);
static void DMA_CalcDMAMUXRequestGenBaseAndMask(DMA_HandleTypeDef *hdma);

/**
  * @}
  */

/* Exported functions ---------------------------------------------------------*/

/** @defgroup DMA_Exported_Functions DMA导出函数
  * @{
  */

/** @defgroup DMA_Exported_Functions_Group1 初始化和反初始化函数
  *  @brief   初始化和反初始化函数
  *
@verbatim
 ===============================================================================
             ##### 初始化和反初始化函数  #####
 ===============================================================================
    [..]
    本节提供允许初始化DMA通道源和目标地址、递增和数据大小、传输方向、
    循环/正常模式选择、内存到内存模式选择以及通道优先级值的函数。
    [..]
    HAL_DMA_Init()函数遵循参考手册中描述的DMA配置过程。

@endverbatim
  * @{
  */

/**
  * @brief  根据DMA_InitTypeDef中的指定参数初始化DMA，并初始化相关的句柄。
  * @param  hdma 指向DMA_HandleTypeDef结构的指针，该结构包含
  *               指定DMA通道的配置信息。
  * @retval HAL状态
  */
HAL_StatusTypeDef HAL_DMA_Init(DMA_HandleTypeDef *hdma)
{
  uint32_t tmp;

/* 检查DMA句柄分配 */
  if (hdma == NULL)
  {
    return HAL_ERROR;
  }

  /* 检查参数 */
  assert_param(IS_DMA_ALL_INSTANCE(hdma->Instance));
  assert_param(IS_DMA_DIRECTION(hdma->Init.Direction));
  assert_param(IS_DMA_PERIPHERAL_INC_STATE(hdma->Init.PeriphInc));
  assert_param(IS_DMA_MEMORY_INC_STATE(hdma->Init.MemInc));
  assert_param(IS_DMA_PERIPHERAL_DATA_SIZE(hdma->Init.PeriphDataAlignment));
  assert_param(IS_DMA_MEMORY_DATA_SIZE(hdma->Init.MemDataAlignment));
  assert_param(IS_DMA_MODE(hdma->Init.Mode));
  assert_param(IS_DMA_PRIORITY(hdma->Init.Priority));

  assert_param(IS_DMA_ALL_REQUEST(hdma->Init.Request));

/* 计算通道索引 */
  if ((uint32_t)(hdma->Instance) < (uint32_t)(DMA2_Channel1))
  {
    /* DMA1 */
    hdma->ChannelIndex = (((uint32_t)hdma->Instance - (uint32_t)DMA1_Channel1) / ((uint32_t)DMA1_Channel2 - (uint32_t)DMA1_Channel1)) << 2;
    hdma->DmaBaseAddress = DMA1;
  }
  else
  {
    /* DMA2 */
    hdma->ChannelIndex = (((uint32_t)hdma->Instance - (uint32_t)DMA2_Channel1) / ((uint32_t)DMA2_Channel2 - (uint32_t)DMA2_Channel1)) << 2;
    hdma->DmaBaseAddress = DMA2;
  }