You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

284 lines
6.4 KiB

/********************************** (C) COPYRIGHT *******************************
* File Name : CH59x_adc.h
* Author : WCH
* Version : V1.2
* Date : 2021/11/17
* Description
*********************************************************************************
* Copyright (c) 2021 Nanjing Qinheng Microelectronics Co., Ltd.
* Attention: This software (modified or not) and binary are used for
* microcontroller manufactured by Nanjing Qinheng Microelectronics.
*******************************************************************************/
#ifndef __CH59x_ADC_H__
#define __CH59x_ADC_H__
#ifdef __cplusplus
extern "C" {
#endif
#define ROM_CFG_TMP_25C 0x7F014
/**
* @brief adc single channel define
*/
typedef enum
{
CH_EXTIN_0 = 0, // ADC �ⲿģ��ͨ�� 0
CH_EXTIN_1, // ADC �ⲿģ��ͨ�� 1
CH_EXTIN_2, // ADC �ⲿģ��ͨ�� 2
CH_EXTIN_3, // ADC �ⲿģ��ͨ�� 3
CH_EXTIN_4, // ADC �ⲿģ��ͨ�� 4
CH_EXTIN_5, // ADC �ⲿģ��ͨ�� 5
CH_EXTIN_6, // ADC �ⲿģ��ͨ�� 6
CH_EXTIN_7, // ADC �ⲿģ��ͨ�� 7
CH_EXTIN_8, // ADC �ⲿģ��ͨ�� 8
CH_EXTIN_9, // ADC �ⲿģ��ͨ�� 9
CH_EXTIN_10, // ADC �ⲿģ��ͨ�� 10
CH_EXTIN_11, // ADC �ⲿģ��ͨ�� 11
CH_EXTIN_12, // ADC �ⲿģ��ͨ�� 12
CH_EXTIN_13, // ADC �ⲿģ��ͨ�� 13
CH_INTE_VBAT = 14, // ADC �ڲ����ؼ���ͨ��
CH_INTE_VTEMP = 15, // ADC �ڲ��¶ȴ���������ͨ��
} ADC_SingleChannelTypeDef;
/**
* @brief adc differential channel define
*/
typedef enum
{
CH_DIFF_0_2 = 0, // ADC ����ͨ�� #0-#2
CH_DIFF_1_3, // ADC ����ͨ�� #1-#3
} ADC_DiffChannelTypeDef;
/**
* @brief adc sampling clock
*/
typedef enum
{
SampleFreq_3_2 = 0, // 3.2M ����Ƶ��
SampleFreq_8, // 8M ����Ƶ��
SampleFreq_5_33, // 5.33M ����Ƶ��
SampleFreq_4, // 4M ����Ƶ��
} ADC_SampClkTypeDef;
/**
* @brief adc signal PGA
*/
typedef enum
{
ADC_PGA_1_4 = 0, // -12dB, 1/4��
ADC_PGA_1_2, // -6dB, 1/2��
ADC_PGA_0, // 0dB, 1����������
ADC_PGA_2, // 6dB, 2��
ADC_PGA_2_ = 0x10, // 6dB, 2��
ADC_PGA_4, // 12dB, 4��
ADC_PGA_8, // 18dB, 8��
ADC_PGA_16, // 24dB, 16��
} ADC_SignalPGATypeDef;
/**
* @brief Configuration DMA mode
*/
typedef enum
{
ADC_Mode_Single = 0, // ����ģʽ
ADC_Mode_LOOP, // ѭ��ģʽ
} ADC_DMAModeTypeDef;
/**
* @brief ADC ͨ
*
* @param d - refer to ADC_SingleChannelTypeDef
*/
#define ADC_ChannelCfg(d) (R8_ADC_CHANNEL = d)
/**
* @brief ADC ʱ
*
* @param d - refer to ADC_SampClkTypeDef
*/
#define ADC_SampClkCfg(d) (R8_ADC_CFG = R8_ADC_CFG & (~RB_ADC_CLK_DIV) | (d << 6))
/**
* @brief ADC ź
*
* @param d - refer to ADC_SignalPGATypeDef
*/
#define ADC_PGACfg(d) (R8_ADC_CFG = R8_ADC_CFG & (~RB_ADC_PGA_GAIN) | (d << 4))
/**
* @brief ڲȴУ׼ֵ
*
* @param d - У׼ֵ
*/
#define ADC_TempCalibCfg(d) (R8_TEM_SENSOR = R8_TEM_SENSOR & (~RB_TEM_SEN_CALIB) | d)
/**
* @brief ⲿźŵͨʼ
*
* @param sp - refer to ADC_SampClkTypeDef
* @param ga - refer to ADC_SignalPGATypeDef
*/
void ADC_ExtSingleChSampInit(ADC_SampClkTypeDef sp, ADC_SignalPGATypeDef ga);
/**
* @brief ⲿźŲͨʼ
*
* @param sp - refer to ADC_SampClkTypeDef
* @param ga - refer to ADC_SignalPGATypeDef
*/
void ADC_ExtDiffChSampInit(ADC_SampClkTypeDef sp, ADC_SignalPGATypeDef ga);
/**
* @brief ͨʼ
*/
void TouchKey_ChSampInit(void);
/**
* @brief رTouchKeyԴ
*/
#define TouchKey_DisableTSPower() (R8_TKEY_CFG &= ~RB_TKEY_PWR_ON)
/**
* @brief ȴʼ
*/
void ADC_InterTSSampInit(void);
/**
* @brief رȴԴ
*/
#define ADC_DisableTSPower() (R8_TEM_SENSOR = 0)
/**
* @brief õصѹʼ
*/
void ADC_InterBATSampInit(void);
/**
* @brief ADCִеת
*
* @return ADCת
*/
uint16_t ADC_ExcutSingleConver(void);
/**
* @brief ݴֵ,ȡƫֵ,ADCô˺ȡУ׼ֵ
*
* @return ƫ
*/
signed short ADC_DataCalib_Rough(void);
/**
* @brief TouchKeyת
*
* @param charg - Touchkeyʱ,5bitsЧ, t=charg*Tadc
* @param disch - Touchkeyŵʱ,3bitsЧ, t=disch*Tadc
*
* @return ǰTouchKeyЧ
*/
uint16_t TouchKey_ExcutSingleConver(uint8_t charg, uint8_t disch);
/**
* @brief ADC
*
* @param cycle - λΪ 16ϵͳʱ
*/
void ADC_AutoConverCycle(uint8_t cycle);
/**
* @brief DMA
*
* @param s - ǷDMA
* @param startAddr - DMA ʼַ
* @param endAddr - DMA ַ
* @param m - DMAģʽ
*/
void ADC_DMACfg(uint8_t s, uint32_t startAddr, uint32_t endAddr, ADC_DMAModeTypeDef m);
/**
* @brief Convert ADC value to temperature(Celsius)
*
* @param adc_val - adc value
*
* @return temperature (Celsius)
*/
int adc_to_temperature_celsius(uint16_t adc_val);
/**
* @brief ȡADCתֵ
*
* @return ADCתֵ
*/
#define ADC_ReadConverValue() (R16_ADC_DATA)
/**
* @brief ADCִеת
*/
#define ADC_StartUp() (R8_ADC_CONVERT = RB_ADC_START)
/**
* @brief ȡADCж״̬
*/
#define ADC_GetITStatus() (R8_ADC_INT_FLAG & RB_ADC_IF_EOC)
/**
* @brief ADCжϱ־
*/
#define ADC_ClearITFlag() (R8_ADC_CONVERT = 0)
/**
* @brief ȡADC DMA״̬
*/
#define ADC_GetDMAStatus() (R8_ADC_DMA_IF & RB_ADC_IF_DMA_END)
/**
* @brief ADC DMAɱ־
*/
#define ADC_ClearDMAFlag() (R8_ADC_DMA_IF |= RB_ADC_IF_DMA_END)
/**
* @brief ʱԶ ADC
*/
#define ADC_StartAutoDMA() (R8_ADC_CTRL_DMA |= RB_ADC_AUTO_EN)
/**
* @brief ֹͣʱԶ ADC
*/
#define ADC_StopAutoDMA() (R8_ADC_CTRL_DMA &= ~RB_ADC_AUTO_EN)
/**
* @brief ת ADC
*/
#define ADC_StartContDMA() (R8_ADC_CTRL_DMA |= RB_ADC_CONT_EN)
/**
* @brief ֹͣת ADC
*/
#define ADC_StopContDMA() (R8_ADC_CTRL_DMA &= ~RB_ADC_CONT_EN)
/**
* @brief ȡTouchKeyж״̬
*/
#define TouchKey_GetITStatus() (R8_ADC_INT_FLAG & RB_ADC_IF_EOC)
/**
* @brief TouchKeyжϱ־
*/
#define TouchKey_ClearITFlag() (R8_TKEY_CTRL |= RB_TKEY_PWR_ON)
/**
* @brief رADCԴ
*/
#define ADC_DisablePower() (R8_ADC_CFG &= ~RB_ADC_POWER_ON)
#ifdef __cplusplus
}
#endif
#endif // __CH59x_ADC_H__