472 lines
15 KiB
C
Executable File
472 lines
15 KiB
C
Executable File
/******************************************************************************
|
||
* 版权所有：苏州领慧立芯科技有限公司
|
||
* Copyright (c) 2020-2025 Suzhou Legendsemi Technology Co., Ltd.
|
||
******************************************************************************
|
||
* All rights reserved. Distributed under MIT license.
|
||
* The file is encoded in UTF-8 without signature.
|
||
* @file lh32m0g30x_adc.h
|
||
* @version 2025-09-22
|
||
******************************************************************************/
|
||
|
||
/* Define to prevent recursive inclusion -------------------------------------*/
|
||
#ifndef __LH32M0G3x_ADC_H
|
||
#define __LH32M0G3x_ADC_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* Includes ------------------------------------------------------------------*/
|
||
#include "lh32m0xx_lhl.h"
|
||
|
||
/* Public Definition ---------------------------------------------------------*/
|
||
|
||
/**
|
||
* @brief ADC_IT Group
|
||
*/
|
||
#define ADC_IT_ERR ((uint32_t)0x2) /* 错误中断的使能 */
|
||
#define ADC_IT_RDY ((uint32_t)0x1) /* 数据ready中断的使能 */
|
||
#define ADC_IT_ALL ((uint32_t)(ADC_IT_ERR | ADC_IT_RDY))
|
||
|
||
/**
|
||
* @brief ADC_FLAG Group
|
||
*/
|
||
#define ADC_FLAG_RDY ((uint32_t)0x1000) /* ADC的数据ready指示 */
|
||
#define ADC_FLAG_ERR ((uint32_t)0x0800) /* ADC的错误指示 */
|
||
#define ADC_FLAG_POR ((uint32_t)0x0400) /* 上电复位指示 */
|
||
|
||
/**
|
||
* @brief ADC_ERROR Group
|
||
*/
|
||
#define ADC1_ERROR_COMP_UV ((uint32_t)0x4000) /* ADC 1 数字比较器低于下阈值 */
|
||
#define ADC1_ERROR_COMP_OV ((uint32_t)0x2000) /* ADC 1 数字比较器超上阈值 */
|
||
#define ADC1_ERROR_AINP_OV ((uint32_t)0x1000) /* ADC 1 AIN正端输入overflow； */
|
||
#define ADC1_ERROR_AINP_UV ((uint32_t)0x0800) /* ADC 1 AIN正端输入underflow */
|
||
#define ADC1_ERROR_AINM_OV ((uint32_t)0x0400) /* ADC 1 AIN负端输入overflow */
|
||
#define ADC1_ERROR_AINM_UV ((uint32_t)0x0200) /* ADC 1 AIN负端输入underflow */
|
||
#define ADC1_ERROR_PGA_OV ((uint32_t)0x0100) /* ADC 1 PGA输入溢出 */
|
||
#define ADC0_ERROR_COMP_UV ((uint32_t)0x0080) /* ADC 0 数字比较器低于下阈值 */
|
||
#define ADC0_ERROR_COMP_OV ((uint32_t)0x0040) /* ADC 0 数字比较器超上阈值 */
|
||
#define ADC0_ERROR_AINP_OV ((uint32_t)0x0020) /* ADC 0 AIN正端输入overflow */
|
||
#define ADC0_ERROR_AINP_UV ((uint32_t)0x0010) /* ADC 0 AIN正端输入underflow */
|
||
#define ADC0_ERROR_AINM_OV ((uint32_t)0x0008) /* ADC 0 AIN负端输入overflow */
|
||
#define ADC0_ERROR_AINM_UV ((uint32_t)0x0004) /* ADC 0 AIN负端输入underflow */
|
||
#define ADC0_ERROR_PGA_OV ((uint32_t)0x0002) /* ADC 0 PGA输入溢出 */
|
||
#define ADC_ERROR_MEM_CRC ((uint32_t)0x0001) /* ADC寄存器校验 */
|
||
#define ADC_ERROR_ALL ((uint32_t)0x7FFF) /* ADC所有错误诊断全开 */
|
||
|
||
typedef enum{
|
||
ADC_0 = 1u,
|
||
ADC_1 = 2u,
|
||
} ADC_ID_t;
|
||
|
||
typedef enum{
|
||
REF_INTERNAL_2P5V = 0u,
|
||
REF_INTERNAL_2P048V,
|
||
REF_INTERNAL_1P25V,
|
||
REF_INTERNAL_4P096V,
|
||
REF_INTERNAL_OFF,
|
||
} REF_VOLTAGE_t;
|
||
|
||
// typedef enum{
|
||
// REF_VOLTAGE_2P5V = 0u,
|
||
// REF_VOLTAGE_2P048V,
|
||
// REF_VOLTAGE_1P25V,
|
||
// REF_VOLTAGE_4P096V,
|
||
// REF_DISABLE,
|
||
//} REF_VOLTAGE_t;
|
||
|
||
//typedef struct
|
||
//{
|
||
// REF_MODE_t REF0_Mode; /*!< REF0基准电压:4.096/2.5/2.048/1.25 */
|
||
//
|
||
// FunctionalState REF0_Boost; /*!< REFBUF0_BOOST_EN */
|
||
|
||
// FunctionalState REF0; /*!< Ref0 buffer enable。控制ADC的VREF+作为参考时的驱动使能。 */
|
||
//
|
||
// REF_MODE_t REF1_Mode; /*!< REF1基准电压:4.096/2.5/2.048/1.25 */
|
||
//
|
||
// FunctionalState REF1_Boost; /*!< REFBUF1_BOOST_EN */
|
||
|
||
// FunctionalState REF1; /*!< Ref1 buffer enable。控制VDRIVE引脚的驱动使能。 */
|
||
//
|
||
//} REF_InitTypeDef;
|
||
|
||
typedef struct
|
||
{
|
||
REF_VOLTAGE_t VREF; /*!< REF0基准电压:4.096/2.5/2.048/1.25/禁用 */
|
||
|
||
FunctionalState VREF_Boost; /*!< REFBUF0_BOOST_EN */
|
||
|
||
REF_VOLTAGE_t VDRIVE; /*!< REF1基准电压:4.096/2.5/2.048/1.25/禁用 */
|
||
|
||
FunctionalState VDRIVE_Boost; /*!< REFBUF1_BOOST_EN */
|
||
|
||
} REF_InitTypeDef;
|
||
|
||
typedef enum {
|
||
ADC_MODE_IDLE = 0u,
|
||
ADC_MODE_CONTINUOUS_CONVERSION,
|
||
ADC_MODE_SINGLE_CONVERSION,
|
||
} ADC_MODE_t;
|
||
|
||
typedef enum {
|
||
ADC_TRIGGER_SOFTWARE = 0u,
|
||
ADC_TRIGGER_HARDWARE,
|
||
} ADC_TRIGGER_t;
|
||
|
||
typedef enum {
|
||
ADC_CODE_UNIPOLAR = 0u,
|
||
ADC_CODE_BIPOLAR,
|
||
} ADC_CODE_t;
|
||
|
||
typedef enum{
|
||
ADC_REF_REFP_to_REFN = 0u,
|
||
ADC_REF_EXTREFP_to_EXTREFN,
|
||
ADC_REF_REFP_to_AVSS,
|
||
ADC_REF_VDRIVE_to_AVSS,
|
||
} ADC_REF_SELECT_t;
|
||
|
||
typedef enum {
|
||
ADC_PGA_GAIN_1 = 0u,
|
||
ADC_PGA_GAIN_2,
|
||
ADC_PGA_GAIN_4,
|
||
ADC_PGA_GAIN_8,
|
||
ADC_PGA_GAIN_16,
|
||
ADC_PGA_GAIN_32,
|
||
ADC_PGA_GAIN_64,
|
||
ADC_PGA_GAIN_128,
|
||
ADC_PGA_BYPASS,
|
||
} ADC_PGA_t;
|
||
|
||
typedef enum {
|
||
ADC0_AINP_AIN0 = 0x00u,
|
||
ADC0_AINP_AIN1,
|
||
ADC0_AINP_AIN2,
|
||
ADC0_AINP_AIN3,
|
||
ADC0_AINP_AIN4,
|
||
ADC0_AINP_AIN5,
|
||
ADC0_AINP_AIN6,
|
||
ADC0_AINP_AIN7,
|
||
ADC0_AINP_AIN8,
|
||
ADC0_AINP_AIN9,
|
||
ADC0_AINP_AIN10,
|
||
ADC0_AINP_AIN11,
|
||
ADC0_AINP_AVSS = 0x10u,
|
||
ADC0_AINP_REFP,
|
||
ADC0_AINP_CALIBP,
|
||
} ADC0_AINP_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
ADC0_AINM_AIN0 = 0x00u,
|
||
ADC0_AINM_AIN1,
|
||
ADC0_AINM_AIN2,
|
||
ADC0_AINM_AIN3,
|
||
ADC0_AINM_AIN4,
|
||
ADC0_AINM_AIN5,
|
||
ADC0_AINM_AIN6,
|
||
ADC0_AINM_AIN7,
|
||
ADC0_AINM_AIN8,
|
||
ADC0_AINM_AIN9,
|
||
ADC0_AINM_AIN10,
|
||
ADC0_AINM_AIN11,
|
||
ADC0_AINM_AVSS = 0x10u,
|
||
ADC0_AINM_REFP,
|
||
ADC0_AINM_CALIBN,
|
||
} ADC0_AINM_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
ADC1_AINP_AIN0 = 0x00u,
|
||
ADC1_AINP_AIN1,
|
||
ADC1_AINP_AIN2,
|
||
ADC1_AINP_AIN3,
|
||
ADC1_AINP_AIN4,
|
||
ADC1_AINP_AIN5,
|
||
ADC1_AINP_AIN6,
|
||
ADC1_AINP_AIN7,
|
||
ADC1_AINP_AIN8,
|
||
ADC1_AINP_AIN9,
|
||
ADC1_AINP_AIN10,
|
||
ADC1_AINP_AIN11,
|
||
ADC1_AINP_TEMPP = 0x10u,
|
||
ADC1_AINP_AVSS,
|
||
ADC1_AINP_REFP,
|
||
ADC1_AINP_DACP,
|
||
ADC1_AINP_LOOPP,
|
||
ADC1_AINP_AVDDP,
|
||
ADC1_AINP_IOVDDP,
|
||
ADC1_AINP_CALIBP,
|
||
} ADC1_AINP_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
ADC1_AINM_AIN0 = 0x00u,
|
||
ADC1_AINM_AIN1,
|
||
ADC1_AINM_AIN2,
|
||
ADC1_AINM_AIN3,
|
||
ADC1_AINM_AIN4,
|
||
ADC1_AINM_AIN5,
|
||
ADC1_AINM_AIN6,
|
||
ADC1_AINM_AIN7,
|
||
ADC1_AINM_AIN8,
|
||
ADC1_AINM_AIN9,
|
||
ADC1_AINM_AIN10,
|
||
ADC1_AINM_AIN11,
|
||
ADC1_AINM_TEMPN = 0x10u,
|
||
ADC1_AINM_AVSS,
|
||
ADC1_AINM_REFP,
|
||
ADC1_AINM_DACN,
|
||
ADC1_AINM_LOOPN,
|
||
ADC1_AINM_AVDDN,
|
||
ADC1_AINM_IOVDDN,
|
||
ADC1_AINM_CALIBN,
|
||
} ADC1_AINM_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
ADC_SPS_7813 = 0u,
|
||
ADC_SPS_3906,
|
||
ADC_SPS_1953,
|
||
ADC_SPS_977,
|
||
ADC_SPS_488,
|
||
ADC_SPS_244,
|
||
ADC_SPS_122,
|
||
ADC_SPS_61,
|
||
ADC_SPS_60,
|
||
ADC_SPS_30,
|
||
ADC_SPS_15,
|
||
ADC_SPS_50 = 16u,
|
||
ADC_SPS_25,
|
||
ADC_SPS_12P5,
|
||
ADC_SPS_10 = 24u,
|
||
ADC_SPS_5,
|
||
ADC_SPS_2P5,
|
||
} ADC_DATA_RATE_t;
|
||
|
||
typedef struct{
|
||
|
||
ADC_MODE_t Mode; /*!< ADC转换模式控制. Continuous or Single mode. */
|
||
|
||
ADC_TRIGGER_t Trigger; /*!< 选择ADC启动的触发源 */
|
||
|
||
uint8_t AINP; /*!< AINP端输入选择，对于ADC0：ADC0_AINP_CHANNEL_t；对于ADC1：ADC1_AINP_CHANNEL_t */
|
||
|
||
uint8_t AINM; /*!< AINM端输入选择，对于ADC0：ADC0_AINM_CHANNEL_t；对于ADC1：ADC1_AINM_CHANNEL_t */
|
||
|
||
ADC_PGA_t PGA; /*!< PGA增益倍数 或 BYPASS */
|
||
|
||
ADC_DATA_RATE_t FS; /*!< 数据输出速率*/
|
||
|
||
ADC_CODE_t Code; /*!< ADC数据输出单极性/双极性控制 */
|
||
|
||
ADC_REF_SELECT_t ReferenceSelect; /*!< ADC基准源选择 */
|
||
|
||
FunctionalState REF_BUFP; /*!< 基准源正输入缓冲器 */
|
||
|
||
FunctionalState REF_BUFM; /*!< 基准源负输入缓冲器 */
|
||
|
||
FunctionalState REF_Precharge; /*!< 基准源采样电容预充电，增加少许功耗 */
|
||
|
||
uint8_t Reserved; /*!< 保留位 */
|
||
|
||
float Reference; /*!< 可选基准值，单位：伏（基准为电压类型）或欧姆（基准为比例电阻） */
|
||
|
||
} ADC_InitTypeDef;
|
||
|
||
/*----------------- ADC 通道序列器配置 -----------------------------------------*/
|
||
#ifndef ADC_MAX_SEQUENCER_CHANNELS
|
||
#define ADC_MAX_SEQUENCER_CHANNELS 8
|
||
#endif
|
||
|
||
/* 单ADC 带状态位的转换数据结构体 */
|
||
typedef struct {
|
||
uint32_t ADC_Status;
|
||
uint32_t ADC_Data;
|
||
} ADC_Data_t;
|
||
|
||
/* 双ADC 带状态位的转换数据结构体 */
|
||
typedef struct {
|
||
uint32_t Dummy0;
|
||
uint32_t Dummy1;
|
||
uint32_t ADC0_Status;
|
||
uint32_t ADC0_Data;
|
||
uint32_t Dummy2;
|
||
uint32_t ADC1_Status;
|
||
uint32_t ADC1_Data;
|
||
uint32_t Dummy3;
|
||
} ADC_DualData_t;
|
||
|
||
/* 单ADC 通道序列器配置文件 */
|
||
typedef struct {
|
||
uint32_t ADC_CONTROL;
|
||
uint32_t CHANNEL_CFG;
|
||
} ADC_Config_t;
|
||
|
||
/* 双ADC 通道序列器配置文件 */
|
||
typedef struct {
|
||
uint32_t INTERRUPT_CONTROL_0;
|
||
uint32_t ADC_CONTROL_0;
|
||
uint32_t CHANNEL_CFG_0;
|
||
uint32_t CONFIGURATION_0;
|
||
uint32_t ADC_CONTROL_1;
|
||
uint32_t CHANNEL_CFG_1;
|
||
uint32_t CONFIGURATION_1;
|
||
uint32_t FILTER_1;
|
||
} ADC_DualConfig_t;
|
||
|
||
/* 单ADC 通道序列器参数结构体 */
|
||
typedef struct {
|
||
ADC_Config_t* ADC_CFG;
|
||
|
||
ADC_ID_t ADC_ID; /*!< 使用序列器的ADC_0或ADC_1 */
|
||
|
||
uint8_t Active_Channels; /*!< 序列器使能的通道数量：2 to ADC_MAX_SEQUENCER_CHANNELS */
|
||
|
||
FunctionalState Cycle_Mode; /*!< 循环模式：软件触发一次所有通道无限循环；硬件触发一次所有通道采集完毕等待下次触发 */
|
||
|
||
ADC_TRIGGER_t Sequencer_Trigger; /*!< 触发源：软件或硬件 */
|
||
|
||
uint8_t AINP_Channel[ADC_MAX_SEQUENCER_CHANNELS]; /*!< AINP端输入选择。ADC0：ADC0_AINP_CHANNEL_t；ADC1：ADC1_AINP_CHANNEL_t */
|
||
|
||
uint8_t AINM_Channel[ADC_MAX_SEQUENCER_CHANNELS]; /*!< AINM端输入选择。ADC0：ADC0_AINM_CHANNEL_t；ADC1：ADC1_AINM_CHANNEL_t */
|
||
|
||
} ADC_SingleCSInitTypeDef;
|
||
|
||
/* 双ADC 通道序列器参数结构体 */
|
||
typedef struct {
|
||
|
||
ADC_DualConfig_t* ADC_CFGs;
|
||
|
||
ADC_ID_t ADC_ID; /*!< Reserved。双序列器默认使用双ADC */
|
||
|
||
uint8_t Active_Channels; /*!< 序列器使能的通道数量：2 to ADC_MAX_SEQUENCER_CHANNELS */
|
||
|
||
FunctionalState Cycle_Mode; /*!< 循环模式：软件触发一次所有通道无限循环；硬件触发一次所有通道采集完毕等待下次触发 */
|
||
|
||
ADC_TRIGGER_t Sequencer_Trigger; /*!< 触发源：软件或硬件 */
|
||
|
||
ADC0_AINP_CHANNEL_t AINP0_Channel[ADC_MAX_SEQUENCER_CHANNELS]; /*!< ADC0 AINP端输入选择 */
|
||
|
||
ADC0_AINM_CHANNEL_t AINM0_Channel[ADC_MAX_SEQUENCER_CHANNELS]; /*!< ADC0 AINM端输入选择 */
|
||
|
||
ADC1_AINP_CHANNEL_t AINP1_Channel[ADC_MAX_SEQUENCER_CHANNELS]; /*!< ADC1 AINP端输入选择 */
|
||
|
||
ADC1_AINM_CHANNEL_t AINM1_Channel[ADC_MAX_SEQUENCER_CHANNELS]; /*!< ADC1 AINM端输入选择 */
|
||
|
||
} ADC_DualCSInitTypeDef;
|
||
|
||
typedef enum {
|
||
EXC_CURRENT_0uA = 0u,
|
||
EXC_CURRENT_50uA,
|
||
EXC_CURRENT_100uA,
|
||
EXC_CURRENT_150uA,
|
||
EXC_CURRENT_200uA,
|
||
EXC_CURRENT_250uA,
|
||
EXC_CURRENT_300uA,
|
||
EXC_CURRENT_350uA,
|
||
EXC_CURRENT_400uA,
|
||
EXC_CURRENT_450uA,
|
||
EXC_CURRENT_500uA,
|
||
EXC_CURRENT_600uA,
|
||
EXC_CURRENT_700uA,
|
||
EXC_CURRENT_800uA,
|
||
EXC_CURRENT_900uA,
|
||
EXC_CURRENT_1000uA,
|
||
} IEXC_RANGE_t;
|
||
|
||
typedef enum {
|
||
EXC_CURRENT_SRC0 = 1u,
|
||
EXC_CURRENT_SRC1 = 2u,
|
||
EXC_CURRENT_DUAL = 3u,
|
||
} IEXC_SOURCE_t;
|
||
|
||
typedef enum {
|
||
EXC_CURRENT_AIN2 = 2u,
|
||
EXC_CURRENT_AIN3 = 3u,
|
||
EXC_CURRENT_AIN4 = 4u,
|
||
EXC_CURRENT_AIN5 = 5u,
|
||
EXC_CURRENT_AIN7 = 7u,
|
||
EXC_CURRENT_AIN8 = 8u,
|
||
EXC_CURRENT_AIN10 = 10u,
|
||
EXC_CURRENT_AIN11 = 11u,
|
||
} IEXC_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
BIAS_VOLTAGE_AIN0 = 0x0001u,
|
||
BIAS_VOLTAGE_AIN1 = 0x0002u,
|
||
BIAS_VOLTAGE_AIN2 = 0x0004u,
|
||
BIAS_VOLTAGE_AIN3 = 0x0008u,
|
||
BIAS_VOLTAGE_AIN4 = 0x0010u,
|
||
BIAS_VOLTAGE_AIN5 = 0x0020u,
|
||
BIAS_VOLTAGE_AIN6 = 0x0040u,
|
||
BIAS_VOLTAGE_AIN7 = 0x0080u,
|
||
BIAS_VOLTAGE_AIN8 = 0x0100u,
|
||
BIAS_VOLTAGE_AIN9 = 0x0200u,
|
||
BIAS_VOLTAGE_AIN10 = 0x0400u,
|
||
BIAS_VOLTAGE_AIN11 = 0x0800u,
|
||
} VBIAS_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
BURNOUT_CURRENT_0uA = 0u,
|
||
BURNOUT_CURRENT_0_5uA,
|
||
BURNOUT_CURRENT_2uA,
|
||
BURNOUT_CURRENT_4uA,
|
||
} BURNOUT_CURRENT_t;
|
||
|
||
|
||
/* Function Prototype --------------------------------------------------------*/
|
||
|
||
LHL_StatusTypeDef LHL_REF_Init(REF_InitTypeDef* REF_Init);
|
||
|
||
LHL_StatusTypeDef LHL_ADC_Init(ADC_ID_t ADCx, ADC_InitTypeDef* ADC_Init);
|
||
|
||
void LHL_ADC_DeInit(ADC_ID_t ADCx);
|
||
|
||
void LHL_ADC_ITConfig(ADC_ID_t ADCx, uint32_t ADC_ITs, FunctionalState NewState);
|
||
|
||
void LHL_ADC_SetVREF(REF_VOLTAGE_t voltage, FunctionalState NewState);
|
||
|
||
void LHL_ADC_SetVDRIVE(REF_VOLTAGE_t voltage, FunctionalState NewState);
|
||
|
||
void LHL_ADC_ErrorConfig(uint32_t ADC_ERRs, FunctionalState NewState);
|
||
|
||
FlagStatus LHL_ADC_GetError(uint32_t ADC_ERR);
|
||
|
||
void LHL_ADC_Start(ADC_ID_t ADCx);
|
||
|
||
void LHL_ADC_Stop(ADC_ID_t ADCx);
|
||
|
||
LHL_StatusTypeDef LHL_ADC_PollForConversion (ADC_ID_t ADCx, uint32_t Timeout);
|
||
|
||
uint32_t LHL_ADC_GetData(ADC_ID_t ADCx);
|
||
|
||
float LHL_ADC_GetVoltage(const uint32_t raw_data, ADC_InitTypeDef* ADC_Init);
|
||
|
||
ITStatus LHL_ADC_GetPending(ADC_ID_t ADCx, uint32_t ADC_IT_FLAG);
|
||
|
||
void LHL_ADC_SetSync(FunctionalState NewState);
|
||
|
||
void LHL_ADC_StartExcitationCurrent(IEXC_SOURCE_t source, IEXC_RANGE_t range, IEXC_CHANNEL_t channel);
|
||
|
||
void LHL_ADC_StopExcitationCurrent(IEXC_SOURCE_t source);
|
||
|
||
void LHL_ADC_StartBiasVoltage(VBIAS_CHANNEL_t channel);
|
||
|
||
void LHL_ADC_StopBiasVoltage(void);
|
||
|
||
void LHL_ADC_StartBurnoutCurrent(ADC_ID_t ADCx, BURNOUT_CURRENT_t current);
|
||
|
||
void LHL_ADC_StopBurnoutCurrent(ADC_ID_t ADCx);
|
||
|
||
void LHL_ADC_DMACmd(ADC_ID_t ADCx, FunctionalState NewState);
|
||
|
||
LHL_StatusTypeDef LHL_ADC_SingleChannelSequencerInit(ADC_InitTypeDef* ADC_Init, ADC_SingleCSInitTypeDef* ADC_CSInit);
|
||
|
||
LHL_StatusTypeDef LHL_ADC_DualChannelSequencerInit(ADC_InitTypeDef* ADC_Init, ADC_DualCSInitTypeDef* ADC_DualCSInit);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif
|
||
|
||
/*********************************End of File**********************************/
|