stm32g4xx_hal_dac_ex.c

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_dac_ex.c
  * @author  MCD Application Team
  * @brief   扩展的 DAC HAL 模块驱动。
  *          此文件提供用于管理 DAC 外设扩展功能的固件函数。
  *          functionalities of the DAC peripheral.
  *
  *
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * All rights reserved.
  *
  * 本软件受可在本软件组件根目录中找到的 LICENSE 文件条款的约束。
  * in the root directory of this software component.
  * 如果此软件未附带 LICENSE 文件，则按原样提供。
  *
  ******************************************************************************
  @verbatim
  ==============================================================================
                      ##### 如何使用此驱动程序 #####
  ==============================================================================
    [..]
     *** 双模式 IO 操作 ***
     ==============================
     [..]
      (+) 使用 HAL_DACEx_DualStart() 使能两个通道并启动双模式操作的转换。
          如果选择了软件触发，使用 HAL_DACEx_DualStart() 将启动
          之前通过 HAL_DACEx_DualSetValue() 设置的值的转换。
      (+) 使用 HAL_DACEx_DualStop() 禁用两个通道并停止双模式操作的转换。
      (+) 使用 HAL_DACEx_DualStart_DMA() 使能两个通道并启动双模式操作的转换，
          使用 DMA 为 DAC 转换器提供数据。
          首次发出的触发将启动之前通过 HAL_DACEx_DualSetValue() 设置的值的转换。
      (+) 使用 HAL_DACEx_DualStop_DMA() 禁用两个通道并停止双模式操作的转换，
          使用 DMA 为 DAC 转换器提供数据。
      (+) 当启用双模式时（即同时使用 DAC 通道 1 和通道 2）：
          使用 HAL_DACEx_DualGetValue() 获取要转换的数字数据，并使用
          HAL_DACEx_DualSetValue() 设置要在通道 1 和通道 2 中同时转换的数字值。
     *** 信号生成操作 ***
     ===================================
     [..]
      (+) 使用 HAL_DACEx_TriangleWaveGenerate() 生成三角波信号。
      (+) 使用 HAL_DACEx_NoiseWaveGenerate() 生成噪声信号。

      (+) 使用 HAL_DACEx_SawtoothWaveGenerate() 生成锯齿波信号。
      (+) 使用 HAL_DACEx_SawtoothWaveDataReset() 重置锯齿波。
      (+) 使用 HAL_DACEx_SawtoothWaveDataStep() 步进锯齿波。

      (+) HAL_DACEx_SelfCalibrate 校准一个 DAC 通道。
      (+) HAL_DACEx_SetUserTrimming 设置用户微调值。
      (+) HAL_DACEx_GetTrimOffset 获取微调值（复位后的出厂设置，
          如果在复位后至少使用过一次 HAL_DACEx_SetUserTrimming，则为用户设置）。

 @endverbatim
  ******************************************************************************
  */


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

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

#ifdef HAL_DAC_MODULE_ENABLED

#if defined(DAC1) || defined(DAC2) || defined(DAC3) ||defined (DAC4)

/** @defgroup DACEx DACEx
  * @brief DAC 扩展 HAL 模块驱动
  * @{
  */

/* Private typedef -----------------------------------------------------------*/
/* Private define ------------------------------------------------------------*/

/* DAC 最小微调时间的延迟。                                       */
/* 注意：两个校准步骤之间所需的最小时间                    */
/*       下面的延迟是在以下条件下指定的：                       */
/*        - DAC 通道输出缓冲器已启用                                 */
/* 字面量设置为最大值（请参阅器件数据手册，                   */
/* 电气特性，参数 "tTRIM"）。                            */
/* 单位：us                                                                   */
#define DAC_DELAY_TRIM_US          (50UL)     /*!< DAC 最小微调时间的延迟 */

/* Private macro -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private function prototypes -----------------------------------------------*/
/* Exported functions --------------------------------------------------------*/

/** @defgroup DACEx_Exported_Functions DACEx 导出函数
  * @{
  */

/** @defgroup DACEx_Exported_Functions_Group2 IO 操作函数
  *  @brief    扩展的 IO 操作函数
  *
@verbatim
  ==============================================================================
                 ##### 扩展功能函数 #####
  ==============================================================================
    [..]  本节提供允许以下操作的函数：
      (+) 启动转换。
      (+) 停止转换。
      (+) 启动转换并启用 DMA 传输。
      (+) 停止转换并禁用 DMA 传输。
      (+) 获取转换结果。
      (+) 获取双模式转换结果。

@endverbatim
  * @{
  */


/**
  * @brief  使能 DAC 并启动两个通道的转换。
  * @param  hdac 指向包含指定 DAC 配置信息的 DAC_HandleTypeDef 结构体的指针。
  * @retval HAL 状态
  */
HAL_StatusTypeDef HAL_DACEx_DualStart(DAC_HandleTypeDef *hdac)
{
  uint32_t tmp_swtrig = 0UL;
  __IO uint32_t wait_loop_index;

  /* 检查 DAC 外设句柄 */
  if (hdac == NULL)
  {
    return HAL_ERROR;
  }

  /* 检查参数 */
  assert_param(IS_DAC_CHANNEL(hdac->Instance, DAC_CHANNEL_2));

  /* 进程锁定 */
  __HAL_LOCK(hdac);

  /* 更改 DAC 状态 */
  hdac->State = HAL_DAC_STATE_BUSY;

  /* 使能外设 */
  __HAL_DAC_ENABLE(hdac, DAC_CHANNEL_1);
  __HAL_DAC_ENABLE(hdac, DAC_CHANNEL_2);
  /* 确保在外设使能后使用前有最小等待时间 */
  /* 等待循环初始化和执行 */
  /* 注意：变量除以 2 以部分补偿              */
  /*       CPU 处理周期，以 us 为单位进行缩放以避免          */
  /*       超过 32 位寄存器容量并处理低频。 */
  wait_loop_index = ((DAC_DELAY_STARTUP_US / 10UL) * ((SystemCoreClock / (100000UL * 2UL)) + 1UL));
  while (wait_loop_index != 0UL)
  {
    wait_loop_index--;
  }

  /* 检查是否启用了软件触发 */
  if ((hdac->Instance->CR & (DAC_CR_TEN1 | DAC_CR_TSEL1)) == DAC_TRIGGER_SOFTWARE)
  {
    tmp_swtrig |= DAC_SWTRIGR_SWTRIG1;
  }
  if ((hdac->Instance->CR & (DAC_CR_TEN2 | DAC_CR_TSEL2)) == (DAC_TRIGGER_SOFTWARE << (DAC_CHANNEL_2 & 0x10UL)))
  {
    tmp_swtrig |= DAC_SWTRIGR_SWTRIG2;
  }
  /* 使能所选的 DAC 软件转换*/
  SET_BIT(hdac->Instance->SWTRIGR, tmp_swtrig);

  /* 更改 DAC 状态 */
  hdac->State =