[综合信息] 华大HC32F460之ADC

/**

 *******************************************************************************

 ** \brief  ADC clock configuration.

 **

 ** \note

/*******************************************************************************

 * Copyright (C) 2016, Huada Semiconductor Co., Ltd. All rights reserved.

 *

 * This software is owned and published by:

 * Huada Semiconductor Co., Ltd. ("HDSC").

 *

 * BY DOWNLOADING, INSTALLING OR USING THIS SOFTWARE, YOU AGREE TO BE BOUND

 * BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT.

 *

 * This software contains source code for use with HDSC

 * components. This software is licensed by HDSC to be adapted only

 * for use in systems utilizing HDSC components. HDSC shall not be

 * responsible for misuse or illegal use of this software for devices not

 * supported herein. HDSC is providing this software "AS IS" and will

 * not be responsible for issues arising from incorrect user implementation

 * of the software.

 *

 * Disclaimer:

 * HDSC MAKES NO WARRANTY, EXPRESS OR IMPLIED, ARISING BY LAW OR OTHERWISE,

 * REGARDING THE SOFTWARE (INCLUDING ANY ACCOMPANYING WRITTEN MATERIALS),

 * ITS PERFORMANCE OR SUITABILITY FOR YOUR INTENDED USE, INCLUDING,

 * WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, THE IMPLIED

 * WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE, AND THE IMPLIED

 * WARRANTY OF NONINFRINGEMENT.

 * HDSC SHALL HAVE NO LIABILITY (WHETHER IN CONTRACT, WARRANTY, TORT,

 * NEGLIGENCE OR OTHERWISE) FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT

 * LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,

 * LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING FROM USE OR

 * INABILITY TO USE THE SOFTWARE, INCLUDING, WITHOUT LIMITATION, ANY DIRECT,

 * INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOSS OF DATA,

 * SAVINGS OR PROFITS,

 * EVEN IF Disclaimer HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

 * YOU ASSUME ALL RESPONSIBILITIES FOR SELECTION OF THE SOFTWARE TO ACHIEVE YOUR

 * INTENDED RESULTS, AND FOR THE INSTALLATION OF, USE OF, AND RESULTS OBTAINED

 * FROM, THE SOFTWARE.

 *

 * This software may be replicated in part or whole for the licensed use,

 * with the restriction that this Disclaimer and Copyright notice must be

 * included with each copy of this software, whether used in part or whole,

 * at all times.

 */

/******************************************************************************/

/** \file main.c

 **

 ** \brief ADC sample

 **

 **   - 2018-11-30  1.0  Wuze First version for Device Driver Library of

 **     ADC

 **

 ******************************************************************************/



/*******************************************************************************

 * Include files

 ******************************************************************************/

#include "hc32_ddl.h"



/*******************************************************************************

 * Local type definitions ('typedef')

 ******************************************************************************/



/*******************************************************************************

 * Local pre-processor symbols/macros ('#define')

 ******************************************************************************/

/*

 * If you remap the mapping between the channel and the pin with the function

 * ADC_ChannleRemap, define ADC_CH_REMAP as non-zero, otherwise define as 0.

 */

#define ADC_CH_REMAP                (0u)



/* ADC clock selection definition. */

#define ADC_CLK_PCLK                (1u)

#define ADC_CLK_MPLLQ               (2u)

#define ADC_CLK_UPLLR               (3u)



/* Select PCLK as ADC clock. */

#define ADC_CLK                     (ADC_CLK_UPLLR)



/* ADC1 channel definition for this example. */

#define ADC1_SA_NORMAL_CHANNEL      (ADC1_CH0 | ADC1_CH10)

#define ADC1_SA_AVG_CHANNEL         (ADC1_CH12 | ADC1_CH13)

#define ADC1_SA_CHANNEL             (ADC1_SA_NORMAL_CHANNEL | ADC1_SA_AVG_CHANNEL)

#define ADC1_SA_CHANNEL_COUNT       (4u)



#define ADC1_AVG_CHANNEL            (ADC1_SA_AVG_CHANNEL)

#define ADC1_CHANNEL                (ADC1_SA_CHANNEL)



/* ADC1 channel sampling time.     ADC1_CH0  ADC1_CH10  ADC1_CH12   ADC1_CH13 */

#define ADC1_SA_CHANNEL_SAMPLE_TIME { 0x30,     0x80,      0x50,      0x60 }



/* ADC2 channel definition for this example. */

#define ADC2_SA_NORMAL_CHANNEL      (ADC2_CH0 | ADC2_CH2)

#define ADC2_SA_AVG_CHANNEL         (ADC2_CH5)

#define ADC2_SA_CHANNEL             (ADC2_SA_NORMAL_CHANNEL | ADC2_SA_AVG_CHANNEL)

#define ADC2_SA_CHANNEL_COUNT       (3u)



#define ADC2_AVG_CHANNEL            (ADC2_SA_AVG_CHANNEL)

#define ADC2_CHANNEL                (ADC2_SA_CHANNEL)



/* ADC2 channel sampling time.      ADC2_CH0  ADC2_CH2  ADC2_CH5  */

#define ADC2_SA_CHANNEL_SAMPLE_TIME { 0x60,     0x50,     0x40 }



/* ADC resolution definitions. */

#define ADC_RESOLUTION_8BIT         (8u)

#define ADC_RESOLUTION_10BIT        (10u)

#define ADC_RESOLUTION_12BIT        (12u)



#define ADC1_RESOLUTION             (ADC_RESOLUTION_12BIT)

#define ADC2_RESOLUTION             (ADC_RESOLUTION_10BIT)



/* Scan mode definitions. */

#define ADC1_SCAN_MODE              (AdcMode_SAOnce)

#define ADC2_SCAN_MODE              (AdcMode_SAContinuous)



/* ADC reference voltage. The voltage of pin VREFH. */

#define ADC_VREF                    (3.288f)



/* ADC accuracy. */

#define ADC1_ACCURACY               (1ul << ADC1_RESOLUTION)



/* ADC2 continuous conversion times. */

#define ADC2_CONTINUOUS_TIMES       (3u)



/* Timeout value definitions. */

#define TIMEOUT_MS                  (10u)



/*******************************************************************************

 * Global variable definitions (declared in header file with 'extern')

 ******************************************************************************/



/*******************************************************************************

 * Local function prototypes ('static')

 ******************************************************************************/

static void SystemClockConfig(void);



static void AdcConfig(void);

static void AdcClockConfig(void);

static void AdcInitConfig(void);

static void AdcChannelConfig(void);



static void AdcSetChannelPinMode(const M4_ADC_TypeDef *ADCx,

                                 uint32_t u32Channel,

                                 en_pin_mode_t enMode);

static void AdcSetPinMode(uint8_t u8AdcPin, en_pin_mode_t enMode);



/*******************************************************************************

 * Local variable definitions ('static')

 ******************************************************************************/

static uint16_t m_au16Adc1Value[ADC1_CH_COUNT];

static uint16_t m_au16Adc2Value[ADC2_CH_COUNT];



static stc_clk_sysclk_cfg_t m_stcSysclkCfg =

{

    /* Default system clock division. */

    .enHclkDiv  = ClkSysclkDiv1,  // 168MHz

    .enExclkDiv = ClkSysclkDiv2,  // 84MHz

    .enPclk0Div = ClkSysclkDiv1,  // 168MHz

    .enPclk1Div = ClkSysclkDiv2,  // 84MHz

    .enPclk2Div = ClkSysclkDiv4,  // 42MHz

    .enPclk3Div = ClkSysclkDiv4,  // 42MHz

    .enPclk4Div = ClkSysclkDiv2,  // 84MHz

};



/*******************************************************************************

 * Function implementation - global ('extern') and local ('static')

 ******************************************************************************/

/**

 *******************************************************************************

 ** \brief  Main function.

 **

 ** \param  None.

 **

 ** \retval int32_t return value, if needed.

 **

 ******************************************************************************/

int32_t main(void)

{

    uint8_t u8Count;



    /* Configuring a new system clock if you need. */

    SystemClockConfig();



    /* Config ADC. */

    AdcConfig();



    /* Config UART for printing. Baud rate 115200. */

    Ddl_UartInit();



    /***************** Configuration end, application start **************/



    /* ADC1 sequence A single scan. */

    /* Start ADC1, wait ADC1 scan converting done, read ADC1 data. */

    ADC_PollingSa(M4_ADC1, m_au16Adc1Value, ADC1_CH_COUNT, TIMEOUT_MS);



    /* ADC2 sequence A continuous scan. */

    u8Count = 0u;

    ADC_StartConvert(M4_ADC2);

    while (u8Count < ADC2_CONTINUOUS_TIMES)

    {

        if (Set == ADC_GetEocFlag(M4_ADC2, ADC_SEQ_A))

        {

            ADC_GetChData(M4_ADC2, ADC2_SA_CHANNEL, m_au16Adc2Value, ADC2_SA_CHANNEL_COUNT);

            ADC_ClrEocFlag(M4_ADC2, ADC_SEQ_A);

            u8Count++;

            // TODO: USE THE m_au16Adc2Value.

        }

    }



    /*

     *  DO NOT forget to stop ADC when your mode is

     *  AdcMode_SAContinuous or AdcMode_SAContinuousSBOnce

     *  unless you need.

     */

    ADC_StopConvert(M4_ADC2);



    while (1u)

    {

        ADC_PollingSa(M4_ADC1, m_au16Adc1Value, ADC1_CH_COUNT, TIMEOUT_MS);

        /* ADC1 channel 10 maps pin ADC12_IN10 by default. */

        printf("\nADC12_IN10 value %d.", m_au16Adc1Value[10u]);

        printf("\nADC12_IN10 voltage is %.4fV.",

            ((float)m_au16Adc1Value[10u] * ADC_VREF) / (float)ADC1_ACCURACY);



        /* Main loop cycle is 500ms. */

        Ddl_Delay1ms(500u);

    }

}



/*******************************************************************************

 * Local function prototypes ('static')

 ******************************************************************************/

/**

 *******************************************************************************

 ** \brief  Configuring a new system clock.

 **         System clock frequency: 168MHz.

 **         System clock source:    MPLL.

 **         MPLL clock source:      XTAL(8MHz).

 **

 ******************************************************************************/

static void SystemClockConfig(void)

{

    stc_clk_xtal_cfg_t stcXtalCfg;

    stc_clk_mpll_cfg_t stcMpllCfg;

    stc_sram_config_t  stcSramConfig;



    MEM_ZERO_STRUCT(stcXtalCfg);

    MEM_ZERO_STRUCT(stcMpllCfg);



    /* Set bus clock division first. */

    CLK_SysClkConfig(&m_stcSysclkCfg);



    /* Switch system clock source to MPLL. */

    /* Use XTAL as MPLL source. */

    stcXtalCfg.enFastStartup = Enable;

    stcXtalCfg.enMode = ClkXtalModeOsc;

    stcXtalCfg.enDrv  = ClkXtalLowDrv;

    CLK_XtalConfig(&stcXtalCfg);

    CLK_XtalCmd(Enable);



    /* Set MPLL out 168MHz. */

    stcMpllCfg.pllmDiv = 1u;

    /* sysclk = 8M / pllmDiv * plln / PllpDiv */

    stcMpllCfg.plln    = 42u;

    stcMpllCfg.PllpDiv = 2u;

    stcMpllCfg.PllqDiv = 16u;

    stcMpllCfg.PllrDiv = 16u;

    CLK_SetPllSource(ClkPllSrcXTAL);

    CLK_MpllConfig(&stcMpllCfg);



    /* Flash read wait cycle setting. */

    EFM_Unlock();

    EFM_SetLatency(EFM_LATENCY_4);

    EFM_Lock();



    /* If the system clock frequency is higher than 100MHz and SRAM1, SRAM2, SRAM3 or Ret_SRAM is used,

       the wait cycle must be set. */

    stcSramConfig.u8SramIdx     = Sram12Idx | Sram3Idx | SramRetIdx;

    stcSramConfig.enSramRC      = SramCycle2;

    stcSramConfig.enSramWC      = SramCycle2;

    stcSramConfig.enSramEccMode = EccMode0;

    stcSramConfig.enSramEccOp   = SramNmi;

    stcSramConfig.enSramPyOp    = SramNmi;

    SRAM_Init(&stcSramConfig);



    CLK_MpllCmd(Enable);



    /* Wait MPLL ready. */

    while(Set != CLK_GetFlagStatus(ClkFlagMPLLRdy))

    {

        ;

    }



    /* Set system clock source. */

    CLK_SetSysClkSource(CLKSysSrcMPLL);

}



/**

 *******************************************************************************

 ** \brief  ADC configuration, including clock configuration, initial configuration

 **         and channel configuration.

 **

 ** \param  None.

 **

 ** \retval None.

 **

 ******************************************************************************/

static void AdcConfig(void)

{

    AdcClockConfig();

    AdcInitConfig();

    AdcChannelConfig();

}



/**

 *******************************************************************************

 ** \brief  ADC clock configuration.

 **

 ** \note   1) ADCLK max frequency is 60MHz.

 **         2) If PCLK2 and PCLK4 are selected as the ADC clock,

 **            the following conditions must be met:

 **            a. ADCLK(PCLK2) max 60MHz;

 **            b. PCLK4 : ADCLK = 1:1, 2:1, 4:1, 8:1, 1:2, 1:4

 **

 ******************************************************************************/

static void AdcClockConfig(void)

{

#if (ADC_CLK == ADC_CLK_PCLK)

    /* Set bus clock division, depends on the system clock frequency. */

    m_stcSysclkCfg.enPclk2Div = ClkSysclkDiv64;

    m_stcSysclkCfg.enPclk4Div = ClkSysclkDiv16;



    CLK_SysClkConfig(&m_stcSysclkCfg);

    CLK_SetPeriClkSource(ClkPeriSrcPclk);



#elif (ADC_CLK == ADC_CLK_MPLLQ)

    stc_clk_xtal_cfg_t stcXtalCfg;

    stc_clk_mpll_cfg_t stcMpllCfg;



    if (CLKSysSrcMPLL == CLK_GetSysClkSource())

    {

        /*

         * Configure MPLLQ(same as MPLLP and MPLLR) when you

         * configure MPLL as the system clock.

         */

    }

    else

    {

        /* Use XTAL as MPLL source. */

        stcXtalCfg.enFastStartup = Enable;

        stcXtalCfg.enMode = ClkXtalModeOsc;

        stcXtalCfg.enDrv  = ClkXtalLowDrv;

        CLK_XtalConfig(&stcXtalCfg);

        CLK_XtalCmd(Enable);



        /* Set MPLL out 240MHz. */

        stcMpllCfg.pllmDiv = 1u;

        /* mpll = 8M / pllmDiv * plln */

        stcMpllCfg.plln    = 30u;

        stcMpllCfg.PllpDiv = 16u;

        stcMpllCfg.PllqDiv = 16u;

        stcMpllCfg.PllrDiv = 16u;

        CLK_SetPllSource(ClkPllSrcXTAL);

        CLK_MpllConfig(&stcMpllCfg);

        CLK_MpllCmd(Enable);

    }

    CLK_SetPeriClkSource(ClkPeriSrcMpllp);



#elif (ADC_CLK == ADC_CLK_UPLLR)

    stc_clk_xtal_cfg_t stcXtalCfg;

    stc_clk_upll_cfg_t stcUpllCfg;



    MEM_ZERO_STRUCT(stcXtalCfg);

    MEM_ZERO_STRUCT(stcUpllCfg);



    /* Use XTAL as UPLL source. */

    stcXtalCfg.enFastStartup = Enable;

    stcXtalCfg.enMode = ClkXtalModeOsc;

    stcXtalCfg.enDrv = ClkXtalLowDrv;

    CLK_XtalConfig(&stcXtalCfg);

    CLK_XtalCmd(Enable);



    /* Set UPLL out 240MHz. */

    stcUpllCfg.pllmDiv = 2u;

    /* upll = 8M(XTAL) / pllmDiv * plln */

    stcUpllCfg.plln    = 60u;

    stcUpllCfg.PllpDiv = 16u;

    stcUpllCfg.PllqDiv = 16u;

    stcUpllCfg.PllrDiv = 16u;

    CLK_SetPllSource(ClkPllSrcXTAL);

    CLK_UpllConfig(&stcUpllCfg);

    CLK_UpllCmd(Enable);

    CLK_SetPeriClkSource(ClkPeriSrcUpllr);

#endif

}



/**

 *******************************************************************************

 ** \brief  ADC initial configuration.

 **

 ******************************************************************************/

static void AdcInitConfig(void)

{

    stc_adc_init_t stcAdcInit;



    MEM_ZERO_STRUCT(stcAdcInit);



#if (ADC1_RESOLUTION == ADC_RESOLUTION_8BIT)

    stcAdcInit.enResolution = AdcResolution_8Bit;

#elif (ADC1_RESOLUTION == ADC_RESOLUTION_10BIT)

    stcAdcInit.enResolution = AdcResolution_10Bit;

#else

    stcAdcInit.enResolution = AdcResolution_12Bit;

#endif

    stcAdcInit.enDataAlign  = AdcDataAlign_Right;

    stcAdcInit.enAutoClear  = AdcClren_Disable;

    stcAdcInit.enScanMode   = ADC1_SCAN_MODE;

    /* 1. Enable ADC1. */

    PWC_Fcg3PeriphClockCmd(PWC_FCG3_PERIPH_ADC1, Enable);

    /* 2. Initialize ADC1. */

    ADC_Init(M4_ADC1, &stcAdcInit);



#if (ADC2_RESOLUTION == ADC_RESOLUTION_8BIT)

    stcAdcInit.enResolution = AdcResolution_8Bit;

#elif (ADC2_RESOLUTION == ADC_RESOLUTION_10BIT)

    stcAdcInit.enResolution = AdcResolution_10Bit;

#else

    stcAdcInit.enResolution = AdcResolution_12Bit;

#endif

    stcAdcInit.enScanMode   = ADC2_SCAN_MODE;

    /* 1. Enable ADC2. */

    PWC_Fcg3PeriphClockCmd(PWC_FCG3_PERIPH_ADC2, Enable);

    /* 2. Initialize ADC2. */

    ADC_Init(M4_ADC2, &stcAdcInit);

}



/**

 *******************************************************************************

 ** \brief  ADC channel configuration.

 **

 ******************************************************************************/

static void AdcChannelConfig(void)

{

    stc_adc_ch_cfg_t stcChCfg;

    uint8_t au8Adc1SaSampTime[ADC1_SA_CHANNEL_COUNT] = ADC1_SA_CHANNEL_SAMPLE_TIME;

    uint8_t au8Adc2SaSampTime[ADC2_SA_CHANNEL_COUNT] = ADC2_SA_CHANNEL_SAMPLE_TIME;



    MEM_ZERO_STRUCT(stcChCfg);



    stcChCfg.u32Channel  = ADC1_SA_CHANNEL;

    stcChCfg.u8Sequence  = ADC_SEQ_A;

    stcChCfg.pu8SampTime = au8Adc1SaSampTime;

    /* 1. Set the ADC pin to analog mode. */

    AdcSetChannelPinMode(M4_ADC1, ADC1_CHANNEL, Pin_Mode_Ana);

    /* 2. Add ADC channel. */

    ADC_AddAdcChannel(M4_ADC1, &stcChCfg);



    /* 3. Configure the average channel if you need. */

    ADC_ConfigAvg(M4_ADC1, AdcAvcnt_32);

    /* 4. Add average channel if you need. */

    ADC_AddAvgChannel(M4_ADC1, ADC1_AVG_CHANNEL);



    stcChCfg.u32Channel  = ADC2_SA_CHANNEL;

    stcChCfg.pu8SampTime = au8Adc2SaSampTime;

    /* 1. Set the ADC pin to analog mode. */

    AdcSetChannelPinMode(M4_ADC2, ADC2_CHANNEL, Pin_Mode_Ana);

    /* 2. Add ADC channel. */

    ADC_AddAdcChannel(M4_ADC2, &stcChCfg);



    /* 3. Configure the average channel if you need. */

    ADC_ConfigAvg(M4_ADC2, AdcAvcnt_64);

    /* 4. Add average channel if you need. */

    ADC_AddAvgChannel(M4_ADC2, ADC2_AVG_CHANNEL);

}



/**

 *******************************************************************************

 ** \brief  Config the pin which is mapping the channel to analog or digit mode.

 **

 ******************************************************************************/

static void AdcSetChannelPinMode(const M4_ADC_TypeDef *ADCx,

                                 uint32_t u32Channel,

                                 en_pin_mode_t enMode)

{

    uint8_t u8ChIndex;

#if (ADC_CH_REMAP)

    uint8_t u8AdcPin;

#else

    uint8_t u8ChOffset = 0u;

#endif



    if (M4_ADC1 == ADCx)

    {

        u32Channel &= ADC1_PIN_MASK_ALL;

    }

    else

    {

        u32Channel &= ADC2_PIN_MASK_ALL;

#if (!ADC_CH_REMAP)

        u8ChOffset = 4u;

#endif

    }



    u8ChIndex = 0u;

    while (0u != u32Channel)

    {

        if (u32Channel & 0x1ul)

        {

#if (ADC_CH_REMAP)

            u8AdcPin = ADC_GetChannelPinNum(ADCx, u8ChIndex);

            AdcSetPinMode(u8AdcPin, enMode);

#else

            AdcSetPinMode((u8ChIndex+u8ChOffset), enMode);

#endif

        }



        u32Channel >>= 1u;

        u8ChIndex++;

    }

}



/**

 *******************************************************************************

 ** \brief  Set an ADC pin as analog input mode or digit mode.

 **

 ******************************************************************************/

static void AdcSetPinMode(uint8_t u8AdcPin, en_pin_mode_t enMode)

{

    en_port_t enPort = PortA;

    en_pin_t enPin   = Pin00;

    bool bFlag       = true;

    stc_port_init_t stcPortInit;



    MEM_ZERO_STRUCT(stcPortInit);

    stcPortInit.enPinMode = enMode;

    stcPortInit.enPullUp  = Disable;



    switch (u8AdcPin)

    {

    case ADC1_IN0:

        enPort = PortA;

        enPin  = Pin00;

        break;



    case ADC1_IN1:

        enPort = PortA;

        enPin  = Pin01;

        break;



    case ADC1_IN2:

        enPort = PortA;

        enPin  = Pin02;

        break;



    case ADC1_IN3:

        enPort = PortA;

        enPin  = Pin03;

        break;



    case ADC12_IN4:

        enPort = PortA;

        enPin  = Pin04;

        break;



    case ADC12_IN5:

        enPort = PortA;

        enPin  = Pin05;

        break;



    case ADC12_IN6:

        enPort = PortA;

        enPin  = Pin06;

        break;



    case ADC12_IN7:

        enPort = PortA;

        enPin  = Pin07;

        break;



    case ADC12_IN8:

        enPort = PortB;

        enPin  = Pin00;

        break;



    case ADC12_IN9:

        enPort = PortB;

        enPin  = Pin01;

        break;



    case ADC12_IN10:

        enPort = PortC;

        enPin  = Pin00;

        break;



    case ADC12_IN11:

        enPort = PortC;

        enPin  = Pin01;

        break;



    case ADC1_IN12:

        enPort = PortC;

        enPin  = Pin02;

        break;



    case ADC1_IN13:

        enPort = PortC;

        enPin  = Pin03;

        break;



    case ADC1_IN14:

        enPort = PortC;

        enPin  = Pin04;

        break;



    case ADC1_IN15:

        enPort = PortC;

        enPin  = Pin05;

        break;



    default:

        bFlag = false;

        break;

    }



    if (true == bFlag)

    {

        PORT_Init(enPort, enPin, &stcPortInit);

    }

}



/*******************************************************************************

 * EOF (not truncated)

 ******************************************************************************/