/******************************************************************************* * Copyright (C) 2018, 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 ACOOMPANYING 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 sysctrl.h ** ** Headerfile for SYSCTRL functions ** @link SYSCTRL Group Some description @endlink ** ** History: ** - 2018-04-15 Lux First Version ** ******************************************************************************/ #ifndef __SYSCTRL_H__ #define __SYSCTRL_H__ /******************************************************************************* * Include files ******************************************************************************/ #include "hc32l196_ddl.h" #ifdef __cplusplus extern "C" { #endif /** ****************************************************************************** ** \defgroup SysCtrlGroup (SYSCTRL) ** ******************************************************************************/ //@{ /** ******************************************************************************* ** function prototypes. ******************************************************************************/ /****************************************************************************** * Global type definitions ******************************************************************************/ /** ******************************************************************************* ** \brief 系统时钟输入源类型定义 ** \note ******************************************************************************/ typedef enum en_sysctrl_clk_source { SysctrlClkRCH = 0u, ///< 内部高速时钟 SysctrlClkXTH = 1u, ///< 外部高速时钟 SysctrlClkRCL = 2u, ///< 内部低速时钟 SysctrlClkXTL = 3u, ///< 外部低速时钟 SysctrlClkPLL = 4u, ///< PLL时钟 }en_sysctrl_clk_source_t; /** ******************************************************************************* ** \brief RCH频率值枚举类型定义 ******************************************************************************/ typedef enum en_sysctrl_rch_freq { SysctrlRchFreq4MHz = 4u, ///< 4MHz SysctrlRchFreq8MHz = 3u, ///< 8MHz SysctrlRchFreq16MHz = 2u, ///< 16MHz SysctrlRchFreq22_12MHz = 1u, ///< 22.12MHz SysctrlRchFreq24MHz = 0u, ///< 24MHz }en_sysctrl_rch_freq_t; /** ******************************************************************************* ** \brief XTAL驱动能力类型定义 ******************************************************************************/ typedef enum en_sysctrl_xtal_driver { SysctrlXtalDriver0 = 0u, ///< 最弱驱动能力 SysctrlXtalDriver1 = 1u, ///< 弱驱动能力 SysctrlXtalDriver2 = 2u, ///< 一般驱动能力 SysctrlXtalDriver3 = 3u, ///< 最强驱动能力 }en_sysctrl_xtal_driver_t; /** ******************************************************************************* ** \brief XTH频率值范围选择类型定义 ******************************************************************************/ typedef enum en_sysctrl_xth_freq { SysctrlXthFreq4_8MHz = 0u, ///< 4~8MHz SysctrlXthFreq8_16MHz = 1u, ///< 8~16MHz SysctrlXthFreq16_24MHz = 2u, ///< 16~24MHz SysctrlXthFreq24_32MHz = 3u, ///< 24~32MHz }en_sysctrl_xth_freq_t; /** ******************************************************************************* ** \brief XTH时钟稳定周期数类型定义 ******************************************************************************/ typedef enum en_sysctrl_xth_cycle { SysctrlXthStableCycle256 = 0u, ///< 256 个周期数 SysctrlXthStableCycle1024 = 1u, ///< 1024 个周期数 SysctrlXthStableCycle4096 = 2u, ///< 4096 个周期数 SysctrlXthStableCycle16384 = 3u, ///< 16384 个周期数 }en_sysctrl_xth_cycle_t; /** ******************************************************************************* ** \brief RCL频率值枚举类型定义 ******************************************************************************/ typedef enum en_sysctrl_rcl_freq { SysctrlRclFreq32768 = 0x11u, ///< 32.768KHz SysctrlRclFreq38400 = 0x10u, ///< 38.4KHz }en_sysctrl_rcl_freq_t; /** ******************************************************************************* ** \brief RCL时钟稳定周期数类型定义 ******************************************************************************/ typedef enum en_sysctrl_rcl_cycle { SysctrlRclStableCycle4 = 0u, ///< 4 个周期数 SysctrlRclStableCycle16 = 1u, ///< 16 个周期数 SysctrlRclStableCycle64 = 2u, ///< 64 个周期数 SysctrlRclStableCycle256 = 3u, ///< 256 个周期数 }en_sysctrl_rcl_cycle_t; /** ******************************************************************************* ** \brief XTL时钟稳定周期数类型定义 ******************************************************************************/ typedef enum en_sysctrl_xtl_cycle { SysctrlXtlStableCycle256 = 0u, ///< 256 个周期数 SysctrlXtlStableCycle1024 = 1u, ///< 1024 个周期数 SysctrlXtlStableCycle4096 = 2u, ///< 4096 个周期数 SysctrlXtlStableCycle16384 = 3u, ///< 16384 个周期数 }en_sysctrl_xtl_cycle_t; /** ******************************************************************************* ** \brief XTL晶体振幅枚举类型定义 ******************************************************************************/ typedef enum en_sysctrl_xtl_amp { SysctrlXtlAmp0 = 0u, ///< 最小振幅 SysctrlXtlAmp1 = 1u, ///< 小振幅 SysctrlXtlAmp2 = 2u, ///< 一般振幅 SysctrlXtlAmp3 = 3u, ///< 最大振幅 }en_sysctrl_xtl_amp_t; /** ******************************************************************************* ** \brief PLL时钟稳定周期数类型定义 ******************************************************************************/ typedef enum en_sysctrl_pll_cycle { SysctrlPllStableCycle128 = 0u, ///< 128个周期数 SysctrlPllStableCycle256 = 1u, ///< 256个周期数 SysctrlPllStableCycle512 = 2u, ///< 512个周期数 SysctrlPllStableCycle1024 = 3u, ///< 1024个周期数 SysctrlPllStableCycle2048 = 4u, ///< 2048个周期数 SysctrlPllStableCycle4096 = 5u, ///< 4096个周期数 SysctrlPllStableCycle8192 = 6u, ///< 8192个周期数 SysctrlPllStableCycle16384 = 7u, ///< 16384个周期数 }en_sysctrl_pll_cycle_t; /** ******************************************************************************* ** \brief PLL输入频率范围类型定义 ******************************************************************************/ typedef enum en_sysctrl_pll_infreq { SysctrlPllInFreq4_6MHz = 0u, ///< 4~16MHz SysctrlPllInFreq6_12MHz = 1u, ///< 6~12MHz SysctrlPllInFreq12_20MHz = 2u, ///< 12~20MHz SysctrlPllInFreq20_24MHz = 3u, ///< 20~24MHz }en_sysctrl_pll_infreq_t; /** ******************************************************************************* ** \brief PLL输出频率范围类型定义 ******************************************************************************/ typedef enum en_sysctrl_pll_outfreq { SysctrlPllOutFreq8_12MHz = 0u, ///< 8~12MHz SysctrlPllOutFreq12_18MHz = 1u, ///< 12~18MHz SysctrlPllOutFreq18_24MHz = 2u, ///< 18~24MHz SysctrlPllOutFreq24_36MHz = 3u, ///< 24~36MHz SysctrlPllOutFreq36_48MHz = 4u, ///< 36~48MHz }en_sysctrl_pll_outfreq_t; /** ******************************************************************************* ** \brief PLL输入时钟源类型定义 ******************************************************************************/ typedef enum en_sysctrl_pll_clksource { SysctrlPllXthXtal = 0u, ///< XTH晶振输入的时钟 SysctrlPllXthIn = 2u, ///< XTH从端口输入的时钟 SysctrlPllRch = 3u, ///< RCH时钟 }en_sysctrl_pll_clksource_t; /** ******************************************************************************* ** \brief PLL输入时钟源类型定义 ******************************************************************************/ typedef enum en_sysctrl_pll_mul { SysctrlPllMul2 = 2u, ///< 2倍频 SysctrlPllMul3 = 3u, ///< 3倍频 SysctrlPllMul4 = 4u, ///< 4倍频 SysctrlPllMul5 = 5u, ///< 5倍频 SysctrlPllMul6 = 6u, ///< 6倍频 SysctrlPllMul7 = 7u, ///< 7倍频 SysctrlPllMul8 = 8u, ///< 8倍频 SysctrlPllMul9 = 9u, ///< 9倍频 SysctrlPllMul10 = 10u, ///< 10倍频 SysctrlPllMul11 = 11u, ///< 11倍频 SysctrlPllMul12 = 12u, ///< 12倍频 }en_sysctrl_pll_mul_t; /** ******************************************************************************* ** \brief HCLK时钟分频系数类型定义 ******************************************************************************/ typedef enum en_sysctrl_hclk_div { SysctrlHclkDiv1 = 0u, ///< SystemClk SysctrlHclkDiv2 = 1u, ///< SystemClk/2 SysctrlHclkDiv4 = 2u, ///< SystemClk/4 SysctrlHclkDiv8 = 3u, ///< SystemClk/8 SysctrlHclkDiv16 = 4u, ///< SystemClk/16 SysctrlHclkDiv32 = 5u, ///< SystemClk/32 SysctrlHclkDiv64 = 6u, ///< SystemClk/64 SysctrlHclkDiv128 = 7u, ///< SystemClk/128 }en_sysctrl_hclk_div_t; /** ******************************************************************************* ** \brief PCLK分频系数 ******************************************************************************/ typedef enum en_sysctrl_pclk_div { SysctrlPclkDiv1 = 0u, ///< HCLK SysctrlPclkDiv2 = 1u, ///< HCLK/2 SysctrlPclkDiv4 = 2u, ///< HCLK/4 SysctrlPclkDiv8 = 3u, ///< HCLK/8 }en_sysctrl_pclk_div_t; /** ******************************************************************************* ** \brief RTC高速时钟补偿时钟频率数据类型定义 ******************************************************************************/ typedef enum en_sysctrl_rtc_adjust { SysctrlRTC4MHz = 0u, ///< 4MHz SysctrlRTC6MHz = 1u, ///< 6MHz SysctrlRTC8MHz = 2u, ///< 8MHz SysctrlRTC12MHz = 3u, ///< 12MHz SysctrlRTC16MHz = 4u, ///< 16MHz SysctrlRTC20MHz = 5u, ///< 20MHz SysctrlRTC24MHz = 6u, ///< 24MHz SysctrlRTC32MHz = 7u, ///< 32MHz }en_sysctrl_rtc_adjust_t; /** ******************************************************************************* ** \brief 系统控制模块其他功能数据类型定义 ******************************************************************************/ typedef enum en_sysctrl_func { SysctrlEXTHEn = 1u, ///< 使能外部高速时钟从输入引脚输入 SysctrlEXTLEn = 2u, ///< 使能外部低速速时钟从输入引脚输入 SysctrlXTLAlwaysOnEn = 3u, ///< 使能后XTL_EN只可置位 SysctrlClkFuncRTCLpmEn = 5u, ///< 使能RTC低功耗模式 SysctrlCMLockUpEn = 6u, ///< 使能后CPU执行无效指令会复位MCU SysctrlSWDUseIOEn = 8u, ///< SWD端口设为IO功能 }en_sysctrl_func_t; /** ******************************************************************************* ** \brief 外设时钟门控开关类型枚举 ******************************************************************************/ typedef enum en_sysctrl_peripheral_gate { SysctrlPeripheralUart0 = 0u, ///< 串口0 SysctrlPeripheralUart1 = 1u, ///< 串口1 SysctrlPeripheralLpUart0 = 2u, ///< 低功耗串口0 SysctrlPeripheralLpUart1 = 3u, ///< 低功耗串口1 SysctrlPeripheralI2c0 = 4u, ///< I2C0 SysctrlPeripheralI2c1 = 5u, ///< I2C1 SysctrlPeripheralSpi0 = 6u, ///< SPI0 SysctrlPeripheralSpi1 = 7u, ///< SPI1 SysctrlPeripheralBaseTim = 8u, ///< 基础定时器TIM0/1/2 SysctrlPeripheralLpTim0 = 9u, ///< 低功耗定时器0 SysctrlPeripheralAdvTim = 10u, ///< 高级定时器TIM4/5/6 SysctrlPeripheralTim3 = 11u, ///< 定时器3 SysctrlPeripheralOpa = 13u, ///< OPA SysctrlPeripheralPca = 14u, ///< 可编程计数阵列 SysctrlPeripheralWdt = 15u, ///< 看门狗 SysctrlPeripheralAdcBgr = 16u, ///< ADC&BGR SysctrlPeripheralVcLvd = 17u, ///< VC和LVD SysctrlPeripheralRng = 18u, ///< RNG SysctrlPeripheralPcnt = 19u, ///< PCNT SysctrlPeripheralRtc = 20u, ///< RTC SysctrlPeripheralTrim = 21u, ///< 时钟校准 SysctrlPeripheralLcd = 22u, ///< LCD SysctrlPeripheralTick = 24u, ///< 系统定时器 SysctrlPeripheralSwd = 25u, ///< SWD SysctrlPeripheralCrc = 26u, ///< CRC SysctrlPeripheralAes = 27u, ///< AES SysctrlPeripheralGpio = 28u, ///< GPIO SysctrlPeripheralDma = 29u, ///< DMA SysctrlPeripheralFlash = 31u, ///< Flash SysctrlPeripheralDac = 35u, ///< DAC SysctrlPeripheralLpTim1 = 36u, ///< 低功耗定时器1 SysctrlPeripheralUart2 = 40u, ///< UART2 SysctrlPeripheralUart3 = 41u, ///< UART3 }en_sysctrl_peripheral_gate_t; /** ******************************************************************************* ** \brief 时钟初始化配置结构体定义 ******************************************************************************/ typedef struct { en_sysctrl_clk_source_t enClkSrc; ///< 时钟源选择 en_sysctrl_hclk_div_t enHClkDiv; ///< HCLK分频系数 en_sysctrl_pclk_div_t enPClkDiv; ///< PCLK分频系数 }stc_sysctrl_clk_cfg_t; /** ******************************************************************************* ** \brief 时钟初始化配置结构体定义 ******************************************************************************/ typedef struct { en_sysctrl_pll_infreq_t enInFreq; ///< PLL输入时钟频率范围选择 en_sysctrl_pll_outfreq_t enOutFreq; ///< PLL输出时钟频率范围选择 en_sysctrl_pll_clksource_t enPllClkSrc; ///< PLL输入时钟源选择 en_sysctrl_pll_mul_t enPllMul; ///< PLL倍频系数选择 }stc_sysctrl_pll_cfg_t; /****************************************************************************** * Global variable declarations ('extern', definition in C source) ******************************************************************************/ /****************************************************************************** * Global function prototypes (definition in C source) ******************************************************************************/ ///< 系统时钟初始化API:用于上电后，系统工作之前对主频及外设时钟进行初始化； ///< 注意1：使用该初始化函数前需要根据系统，必须优先设置目标内部时钟源的TRIM值或外部时钟源的频率范围， ///< 注意2：XTH、XTL的频率范围设定，需要根据外部晶振决定， ///< 注意3：本驱动默认宏定义：SYSTEM_XTH=32MHz,SYSTEM_XTL=32768Hz,如使用其它外部晶振，必须修改这两个宏定义的值。 en_result_t Sysctrl_ClkInit(stc_sysctrl_clk_cfg_t *pstcCfg); ///< 系统时钟去初始化API:恢复为上电默认状态->PCLK=HCLK=SystemClk=RCH4MHz en_result_t Sysctrl_ClkDeInit(void); ///< 系统时钟模块的基本功能设置 ///< 注意：使能需要使用的时钟源之前，必须优先设置目标内部时钟源的TRIM值或外部时钟源的频率范围 en_result_t Sysctrl_ClkSourceEnable(en_sysctrl_clk_source_t enSource, boolean_t bFlag); ///<外部晶振驱动配置：系统初始化Sysctrl_ClkInit()之后，可根据需要配置外部晶振的驱动能力，时钟初始化Sysctrl_ClkInit()默认为最大值; en_result_t Sysctrl_XTHDriverCfg(en_sysctrl_xtal_driver_t enDriver); en_result_t Sysctrl_XTLDriverCfg(en_sysctrl_xtl_amp_t enAmp, en_sysctrl_xtal_driver_t enDriver); ///<时钟稳定周期设置:系统初始化Sysctrl_ClkInit()之后，可根据需要配置时钟开启后的稳定之间，默认为最大值; en_result_t Sysctrl_SetXTHStableTime(en_sysctrl_xth_cycle_t enCycle); en_result_t Sysctrl_SetRCLStableTime(en_sysctrl_rcl_cycle_t enCycle); en_result_t Sysctrl_SetXTLStableTime(en_sysctrl_xtl_cycle_t enCycle); en_result_t Sysctrl_SetPLLStableTime(en_sysctrl_pll_cycle_t enCycle); ///<系统时钟源切换并更新系统时钟：如果需要在系统时钟初始化Sysctrl_ClkInit()之后切换主频时钟源，则使用该函数； ///< 时钟切换前后，必须根据目标频率值设置Flash读等待周期，可配置插入周期为0、1、2， ///< 注意!!!：当HCLK大于24MHz时，FLASH等待周期插入必须至少为1,否则程序运行可能产生未知错误 en_result_t Sysctrl_SysClkSwitch(en_sysctrl_clk_source_t enSource); ///< 时钟源频率设定：根据系统情况，单独设置不同时钟源的频率值; ///< 时钟频率设置前，必须根据目标频率值设置Flash读等待周期，可配置插入周期为0、1、2， ///< 其中XTL的时钟由外部晶振决定，无需设置。 en_result_t Sysctrl_SetRCHTrim(en_sysctrl_rch_freq_t enRCHFreq); en_result_t Sysctrl_SetRCLTrim(en_sysctrl_rcl_freq_t enRCLFreq); en_result_t Sysctrl_SetXTHFreq(en_sysctrl_xth_freq_t enXTHFreq); en_result_t Sysctrl_SetPLLFreq(stc_sysctrl_pll_cfg_t *pstcPLLCfg); ///< 时钟分频设置:根据系统情况，单独设置HCLK、PCLK的分配值; en_result_t Sysctrl_SetHCLKDiv(en_sysctrl_hclk_div_t enHCLKDiv); en_result_t Sysctrl_SetPCLKDiv(en_sysctrl_pclk_div_t enPCLKDiv); ///< 时钟频率获取：根据系统需要，获取当前HCLK及PCLK的频率值 uint32_t Sysctrl_GetHClkFreq(void); uint32_t Sysctrl_GetPClkFreq(void); ///< 外设门控开关/状态获取：用于控制外设模块的使能，使用该模块的功能之前，必须使能该模块的门控时钟； en_result_t Sysctrl_SetPeripheralGate(en_sysctrl_peripheral_gate_t enPeripheral, boolean_t bFlag); boolean_t Sysctrl_GetPeripheralGate(en_sysctrl_peripheral_gate_t enPeripheral); ///< 系统功能配置：用于设置其他系统相关特殊功能； en_result_t Sysctrl_SetFunc(en_sysctrl_func_t enFunc, boolean_t bFlag); ///< RTC高速时钟补偿:用于设置RTC高速时钟下的频率补偿 en_result_t Sysctrl_SetRTCAdjustClkFreq(en_sysctrl_rtc_adjust_t enRtcAdj); //@} // Sysctrl Group #ifdef __cplusplus #endif #endif /* __SYSCTRL_H__ */ /******************************************************************************* * EOF (not truncated) ******************************************************************************/