jarvis/current_v
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
master
current_v/Drivers/FM33LG0xx_FL_Driver/Src/fm33lg0xx_fl_adc.c

433 lines
22 KiB
C
Raw Permalink Normal View History

初次提交
2025-12-31 08:21:43 +08:00
/**
****************************************************************************************************
* @file fm33lg0xx_fl_adc.c
* @author FMSH Application Team
* @brief Src file of ADC FL Module
****************************************************************************************************
* @attention
*
* Copyright (c) [2021] [Fudan Microelectronics]
* THIS SOFTWARE is licensed under Mulan PSL v2.
* You can use this software according to the terms and conditions of the Mulan PSL v2.
* You may obtain a copy of Mulan PSL v2 at:
* http://license.coscl.org.cn/MulanPSL2
* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
* EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
* MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
* See the Mulan PSL v2 for more details.
*
****************************************************************************************************
*/
/* Includes ------------------------------------------------------------------*/
#include "fm33lg0xx_fl.h"
/** @addtogroup FM33LG0xx_FL_Driver
* @{
*/
/** @addtogroup ADC
* @{
*/
#ifdef FL_ADC_DRIVER_ENABLED
/* Private macros ------------------------------------------------------------*/
/** @addtogroup ADC_FL_Private_Macros
* @{
*/
#define IS_FL_ADC_INSTANCE(INSTANCE) ((INSTANCE) == ADC)
#define IS_FL_ADC_CLK_SOURCE(__VALUE__) (((__VALUE__) == FL_CMU_ADC_CLK_SOURCE_RCLF)||\
((__VALUE__) == FL_CMU_ADC_CLK_SOURCE_RCHF)||\
((__VALUE__) == FL_CMU_ADC_CLK_SOURCE_XTHF)||\
((__VALUE__) == FL_CMU_ADC_CLK_SOURCE_PLL)||\
((__VALUE__) == FL_ADC_CLK_SOURCE_APBCLK))
#define IS_FL_ADC_CMUCLK_PRESCALER(__VALUE__) (((__VALUE__) == FL_ADC_CLK_PSC_DIV1)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV2)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV4)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV8)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV16)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV32))
#define IS_FL_ADC_APBCLK_PRESCALER(__VALUE__) (((__VALUE__) == FL_ADC_CLK_PSC_DIV1)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV2)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV4)||\
((__VALUE__) == FL_ADC_CLK_PSC_DIV8))
#define IS_FL_ADC_REFERENCE_SOURCE(__VALUE__) (((__VALUE__) == FL_ADC_REF_SOURCE_VDDA)||\
((__VALUE__) == FL_ADC_REF_SOURCE_VREFP))
#define IS_FL_ADC_BITWIDTH(__VALUE__) (((__VALUE__) == FL_ADC_BIT_WIDTH_12B)||\
((__VALUE__) == FL_ADC_BIT_WIDTH_10B)||\
((__VALUE__) == FL_ADC_BIT_WIDTH_8B)||\
((__VALUE__) == FL_ADC_BIT_WIDTH_6B))
#define IS_FL_ADC_CONTINUOUSCONVMODE(__VALUE__) (((__VALUE__) == FL_ADC_CONV_MODE_SINGLE)||\
((__VALUE__) == FL_ADC_CONV_MODE_CONTINUOUS))
#define IS_FL_ADC_AUTO_MODE(__VALUE__) (((__VALUE__) == FL_ADC_SINGLE_CONV_MODE_AUTO)||\
((__VALUE__) == FL_ADC_SINGLE_CONV_MODE_SEMIAUTO))
#define IS_FL_ADC_SCANDIRECTION(__VALUE__) (((__VALUE__) == FL_ADC_SEQ_SCAN_DIR_FORWARD)||\
((__VALUE__) == FL_ADC_SEQ_SCAN_DIR_BACKWARD))
#define IS_FL_ADC_EXTERNALTRIGCONV(__VALUE__) (((__VALUE__) == FL_ADC_TRIGGER_EDGE_NONE)||\
((__VALUE__) == FL_ADC_TRIGGER_EDGE_RISING)||\
((__VALUE__) == FL_ADC_TRIGGER_EDGE_FALLING)||\
((__VALUE__) == FL_ADC_TRIGGER_EDGE_BOTH))
#define IS_FL_ADC_EXTERNALTRIGSOURCE(__VALUE__) (((__VALUE__) == FL_ADC_TRGI_LUT0)||\
((__VALUE__) == FL_ADC_TRGI_LUT1)||\
((__VALUE__) == FL_ADC_TRGI_LUT2)||\
((__VALUE__) == FL_ADC_TRGI_ATIM)||\
((__VALUE__) == FL_ADC_TRGI_GPTIM1)||\
((__VALUE__) == FL_ADC_TRGI_GPTIM2)||\
((__VALUE__) == FL_ADC_TRGI_BSTIM16)||\
((__VALUE__) == FL_ADC_TRGI_LPTIM12)||\
((__VALUE__) == FL_ADC_TRGI_COMP1)||\
((__VALUE__) == FL_ADC_TRGI_COMP2)||\
((__VALUE__) == FL_ADC_TRGI_RTCA)||\
((__VALUE__) == FL_ADC_TRGI_LUT3)||\
((__VALUE__) == FL_ADC_TRGI_GPTIM0)||\
((__VALUE__) == FL_ADC_TRGI_COMP3))
#define IS_FL_ADC_CHANNEL_FAST_TIME(__VALUE__) (((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_2_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_4_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_8_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_16_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_32_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_64_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_80_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_96_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_128_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_160_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_192_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_256_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_320_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_384_ADCCLK)||\
((__VALUE__) == FL_ADC_FAST_CH_SAMPLING_TIME_512_ADCCLK))
#define IS_FL_ADC_CHANNEL_SLOW_TIME(__VALUE__) (((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_2_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_4_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_8_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_16_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_32_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_64_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_80_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_96_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_128_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_160_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_192_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_256_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_320_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_384_ADCCLK)||\
((__VALUE__) == FL_ADC_SLOW_CH_SAMPLING_TIME_512_ADCCLK))
#define IS_FL_ADC_OVERSAMPCOFIG(__VALUE__) (((__VALUE__) == FL_DISABLE)||\
((__VALUE__) == FL_ENABLE))
#define IS_FL_ADC_OVERSAMPINGRATIO(__VALUE__) (((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_2X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_4X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_8X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_16X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_32X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_64X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_128X)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_MUL_256X))
#define IS_FL_ADC_OVERSAMPINGSHIFT(__VALUE__) (((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_0B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_1B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_2B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_3B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_4B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_5B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_6B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_7B)||\
((__VALUE__) == FL_ADC_OVERSAMPLING_SHIFT_8B))
#define ADC_CALIBRATIN_TIME_OUT (500000)
/**
* @}
*/
/* Exported functions --------------------------------------------------------*/
/** @addtogroup ADC_FL_EF_Init
* @{
*/
/**
* @brief ADC外设寄存器值为复位值
* @param 外设入口地址
* @retval 返回错误状态，可能值：
* -FL_PASS 外设寄存器值恢复复位值
* -FL_FAIL 未成功执行
*/
FL_ErrorStatus FL_ADC_CommonDeInit(void)
{
/* 关闭总线时钟 */
FL_CMU_DisableGroup2BusClock(FL_CMU_GROUP2_BUSCLK_ADC);
/* 关闭操作时钟 */
FL_CMU_DisableGroup3OperationClock(FL_CMU_GROUP3_OPCLK_ADC);
return FL_PASS;
}
/**
* @brief ADC共用寄存器设置以配置外设工作时钟
*
* @note 其中FL_LPTIM_OPERATION_MODE_EXTERNAL_ASYN_PAUSE_CNT 模式需要外部脉冲提供给LPTIM模块作为工作时钟，此时
* LPTIM完全工作在异步模式下。
* @param LPTIM 外设入口地址
* @param LPTIM_InitStruct指向FL_LPTIM_TimeInitTypeDef类的结构体，它包含指定LPTIM外设的配置信息
*
* @retval ErrorStatus枚举值
* -FL_FAIL 配置过程发生错误
* -FL_PASS ADC配置成功
*/
FL_ErrorStatus FL_ADC_CommonInit(FL_ADC_CommonInitTypeDef *ADC_CommonInitStruct)
{
FL_ErrorStatus status = FL_PASS;
/* 入口参数检查 */
assert_param(IS_FL_ADC_CLK_SOURCE(ADC_CommonInitStruct->clockSource));
assert_param(IS_FL_ADC_REFERENCE_SOURCE(ADC_CommonInitStruct->referenceSource));
assert_param(IS_FL_ADC_BITWIDTH(ADC_CommonInitStruct->bitWidth));
if(ADC_CommonInitStruct->clockSource == FL_ADC_CLK_SOURCE_APBCLK)
{
assert_param(IS_FL_ADC_APBCLK_PRESCALER(ADC_CommonInitStruct->clockPrescaler));
}
else
{
assert_param(IS_FL_ADC_CMUCLK_PRESCALER(ADC_CommonInitStruct->clockPrescaler));
}
/* 开启总线时钟 */
FL_CMU_EnableGroup2BusClock(FL_CMU_GROUP2_BUSCLK_ADC);
/* 配置ADC时钟 */
if(ADC_CommonInitStruct->clockSource == FL_ADC_CLK_SOURCE_APBCLK)
{
/* 设置ADC时钟来源于APBCLK */
FL_ADC_SetClockSource(ADC, FL_ADC_CLK_SOURCE_APBCLK);
/* 配置APBCLOCK时钟预分频 */
FL_ADC_SetAPBPrescaler(ADC, ADC_CommonInitStruct->clockPrescaler << ADC_CFGR1_APBCLK_PSC_Pos);
}
else
{
/* 设置ADC时钟来源于ADCCLK */
FL_ADC_SetClockSource(ADC, FL_ADC_CLK_SOURCE_ADCCLK);
/* 设置ADCCLK时钟源 */
FL_CMU_SetADCClockSource(ADC_CommonInitStruct->clockSource);
/* 配置ADCCLK时钟预分频 */
FL_CMU_SetADCPrescaler(ADC_CommonInitStruct->clockPrescaler << CMU_OPCCR2_ADCPRSC_Pos);
/* 开启操作时钟 */
FL_CMU_EnableGroup3OperationClock(FL_CMU_GROUP3_OPCLK_ADC);
}
/* 配置ADC基准电压*/
FL_ADC_SetReferenceSource(ADC, ADC_CommonInitStruct->referenceSource);
/* 配置ADC输出位数*/
FL_ADC_SetBitWidth(ADC, ADC_CommonInitStruct->bitWidth);
return status;
}
/**
* @brief 设置 ADC_CommonInitStruct 为默认配置
* @param ADC_CommonInitStruct 指向需要将值设置为默认配置的结构体 @ref FL_ADC_CommonInitTypeDef 结构体
*
* @retval None
*/
void FL_ADC_CommonStructInit(FL_ADC_CommonInitTypeDef *ADC_CommonInitStruct)
{
/* 默认使用RCHF作为ADC时钟模块时钟源，预分频系数16 */
ADC_CommonInitStruct->clockSource = FL_CMU_ADC_CLK_SOURCE_RCHF;
ADC_CommonInitStruct->clockPrescaler = FL_CMU_ADC_PSC_DIV16;
ADC_CommonInitStruct->referenceSource = FL_ADC_REF_SOURCE_VDDA;
ADC_CommonInitStruct->bitWidth = FL_ADC_BIT_WIDTH_12B;
}
/**
* @brief 恢复对应的ADC入口地址寄存器为默认值
*
* @param ADCx 外设入口地址
*
* @retval ErrorStatus枚举值
* -FL_FAIL 配置过程发生错误
* -FL_PASS ADC配置成功
*/
FL_ErrorStatus FL_ADC_DeInit(ADC_Type *ADCx)
{
FL_ErrorStatus status = FL_PASS;
/* 入口合法性检查 */
assert_param(IS_FL_ADC_INSTANCE(ADCx));
/* 外设复位使能 */
FL_RMU_EnablePeripheralReset(RMU);
FL_RMU_EnableResetAPBPeripheral(RMU, FL_RMU_RSTAPB_ADC);
FL_RMU_DisableResetAPBPeripheral(RMU, FL_RMU_RSTAPB_ADC);
FL_RMU_EnableResetAPBPeripheral(RMU, FL_RMU_RSTAPB_ADCCR);
FL_RMU_DisableResetAPBPeripheral(RMU, FL_RMU_RSTAPB_ADCCR);
FL_RMU_DisablePeripheralReset(RMU);
return status;
}
/**
* @brief 初始化ADCx指定的入口地址的外设寄存器
*
* @note 用户必须检查此函数的返回值，以确保自校准完成，否则转换结果精度无法保证，除此之外ADC使能过采样实际不会增加ADC的
* 转换精度只会提高转换结果的稳定性（同时配置移位寄存器的情况下），同时过采样会降低转换速度。
* @param ADCx 外设入口地址
* @param ADC_InitStruct 指向一 @ref FL_ADC_InitTypeDef 结构体，它包含指定ADC外设的配置信息
*
* @retval ErrorStatus枚举值
* -FL_FAIL 配置过程发生错误
* -FL_PASS ADC配置成功
*/
FL_ErrorStatus FL_ADC_Init(ADC_Type *ADCx, FL_ADC_InitTypeDef *ADC_InitStruct)
{
FL_ErrorStatus status = FL_PASS;
uint32_t i = 0, Calibration_Flag;
/* 入口合法性检查 */
assert_param(IS_FL_ADC_INSTANCE(ADCx));
assert_param(IS_FL_ADC_CONTINUOUSCONVMODE(ADC_InitStruct->conversionMode));
assert_param(IS_FL_ADC_AUTO_MODE(ADC_InitStruct->autoMode));
assert_param(IS_FL_ADC_SCANDIRECTION(ADC_InitStruct->scanDirection));
assert_param(IS_FL_ADC_EXTERNALTRIGCONV(ADC_InitStruct->externalTrigConv));
assert_param(IS_FL_ADC_OVERSAMPCOFIG(ADC_InitStruct->oversamplingMode));
assert_param(IS_FL_ADC_OVERSAMPINGRATIO(ADC_InitStruct->overSampingMultiplier));
assert_param(IS_FL_ADC_OVERSAMPINGSHIFT(ADC_InitStruct->oversamplingShift));
FL_CMU_EnableGroup1BusClock(FL_CMU_GROUP1_BUSCLK_VREF1P2);
if(!FL_VREF_IsEnabled(VREF))
{
FL_VREF_ClearFlag_Ready(VREF);
FL_VREF_Enable(VREF);//置位VREF_EN寄存器，使能VREF1p2模块
}
FL_VREF_EnableTemperatureSensor(VREF);//置位PTAT_EN寄存器
while(FL_VREF_IsActiveFlag_Ready(VREF) == 0) /* 等待VREF建立 */
{
if(i >= 128000)
{
break;
}
i++;
}
FL_ADC_Disable(ADCx);
FL_ADC_DisableOverSampling(ADCx);
FL_ADC_Enable(ADCx);
FL_ADC_EnableCalibration(ADC);
i = 0;
do
{
Calibration_Flag = FL_ADC_IsActiveFlag_EndOfCalibration(ADC);
i++;
} while((i != 0xFFFFFFFFU) && (Calibration_Flag == 0U)); //等待转换完成
if(Calibration_Flag == 0x01)
{
FL_ADC_ClearFlag_EndOfCalibration(ADC);
/* 关闭ADC，关闭后ADC自校准值依然保持 */
FL_ADC_Disable(ADCx);
if(FL_ADC_IsEnabled(ADCx) == 0U)
{
/* 连续转换模式 */
FL_ADC_SetConversionMode(ADCx, ADC_InitStruct->conversionMode);
/* 自动转换模式 */
FL_ADC_SetSingleConversionAutoMode(ADCx, ADC_InitStruct->autoMode);
/* 通道等待使能 */
if(ADC_InitStruct->waitMode)
{
FL_ADC_EnableWaitMode(ADCx);
}
else
{
FL_ADC_DisableWaitMode(ADCx);
}
/*数据冲突模式设置*/
if(ADC_InitStruct->overrunMode)
{
FL_ADC_EnableOverrunMode(ADCx);
}
else
{
FL_ADC_DisableOverrunMode(ADCx);
}
/* 多通道扫描方向 */
FL_ADC_SetSequenceScanDirection(ADCx, ADC_InitStruct->scanDirection);
/* 外部引脚触发 */
FL_ADC_DisableExternalConversion(ADCx);
/* 触发模式 */
FL_ADC_SetTriggerEdge(ADCx, ADC_InitStruct->externalTrigConv);
/* 触发源 */
FL_ADC_SetTriggerSource(ADCx, ADC_InitStruct->triggerSource);
/*通道采样时间设置*/
FL_ADC_SetFastChannelSamplingTime(ADCx, ADC_InitStruct->fastChannelTime);
FL_ADC_SetSlowChannelSamplingTime(ADCx, ADC_InitStruct->lowChannelTime);
if(ADC_InitStruct->oversamplingMode)
{
/*使能过采样倍数后，需要配置移位寄存器进行移位，这一过程是硬件自动完成的最终最大
可输出16位的结果值（即256被采样得到的结果是20bit的，右移4bit结果就是16bit的）*/
FL_ADC_SetOverSamplingMultiplier(ADCx, ADC_InitStruct->overSampingMultiplier);
FL_ADC_SetOverSamplingShift(ADCx, ADC_InitStruct->oversamplingShift);
/* 过采样使能 */
FL_ADC_EnableOverSampling(ADCx);
}
else
{
/* 关闭过采样 */
FL_ADC_DisableOverSampling(ADCx);
}
}
else
{
status = FL_FAIL;
}
}
else
{
status = FL_FAIL;
}
return status;
}
/**
* @brief 设置 ADC_InitStruct 为默认配置
* @param ADC_InitStruct 指向需要将值设置为默认配置的结构体 @ref FL_ADC_InitTypeDef 结构体
*
* @retval None
*/
void FL_ADC_StructInit(FL_ADC_InitTypeDef *ADC_InitStruct)
{
ADC_InitStruct->conversionMode = FL_ADC_CONV_MODE_SINGLE;
ADC_InitStruct->autoMode = FL_ADC_SINGLE_CONV_MODE_AUTO;
ADC_InitStruct->scanDirection = FL_ADC_SEQ_SCAN_DIR_FORWARD;
ADC_InitStruct->externalTrigConv = FL_ADC_TRIGGER_EDGE_NONE;
ADC_InitStruct->overrunMode = FL_ENABLE;
ADC_InitStruct->waitMode = FL_ENABLE;
ADC_InitStruct->fastChannelTime = FL_ADC_FAST_CH_SAMPLING_TIME_2_ADCCLK;
ADC_InitStruct->lowChannelTime = FL_ADC_SLOW_CH_SAMPLING_TIME_512_ADCCLK;
ADC_InitStruct->oversamplingMode = FL_ENABLE;
ADC_InitStruct->overSampingMultiplier = FL_ADC_OVERSAMPLING_MUL_16X;
ADC_InitStruct->oversamplingShift = FL_ADC_OVERSAMPLING_SHIFT_4B;
}
/**
* @}
*/
#endif /* FL_ADC_DRIVER_ENABLED */
/**
* @}
*/
/**
* @}
*/
/********************** (C) COPYRIGHT Fudan Microelectronics **** END OF FILE ***********************/
Reference in New Issue Copy Permalink