STM8库函数学习笔记之时钟管理

STM8库函数学习笔记之时钟管理

作者：BH7KQK
日期：2010.12.31

相关函数:

void CLK_DeInit(void);
void CLK_HSECmd(FunctionalState NewState);
void CLK_HSICmd(FunctionalState NewState);
void CLK_LSICmd(FunctionalState NewState);
void CLK_CCOCmd(FunctionalState NewState);
void CLK_ClockSwitchCmd(FunctionalState NewState);
void CLK_FastHaltWakeUpCmd(FunctionalState NewState);
void CLK_SlowActiveHaltWakeUpCmd(FunctionalState NewState);
void CLK_PeripheralClockConfig(CLK_Peripheral_TypeDef CLK_Peripheral, FunctionalState NewState);
ErrorStatus CLK_ClockSwitchConfig(CLK_SwitchMode_TypeDef CLK_SwitchMode, CLK_Source_TypeDef CLK_NewClock, FunctionalState

ITState, CLK_CurrentClockState_TypeDef CLK_CurrentClockState);
void CLK_HSIPrescalerConfig(CLK_Prescaler_TypeDef HSIPrescaler);
void CLK_CCOConfig(CLK_Output_TypeDef CLK_CCO);
void CLK_ITConfig(CLK_IT_TypeDef CLK_IT, FunctionalState NewState);
void CLK_SYSCLKConfig(CLK_Prescaler_TypeDef CLK_Prescaler);
void CLK_SWIMConfig(CLK_SWIMDivider_TypeDef CLK_SWIMDivider);
void CLK_CANConfig(CLK_CANDivider_TypeDef CLK_CANDivider);
void CLK_ClockSecuritySystemEnable(void);
void CLK_SYSCLKEmergencyClear(void);
void CLK_AdjustHSICalibrationValue(CLK_HSITrimValue_TypeDef CLK_HSICalibrationValue);
u32 CLK_GetClockFreq(void);
CLK_Source_TypeDef CLK_GetSYSCLKSource(void);
FlagStatus CLK_GetFlagStatus(CLK_Flag_TypeDef CLK_FLAG);
ITStatus CLK_GetITStatus(CLK_IT_TypeDef CLK_IT);
void CLK_ClearITPendingBit(CLK_IT_TypeDef CLK_IT);

//-----------------------------------------------------------------------------------------
void CLK_DeInit(void);

恢复相关的时钟寄存器到默认值

参数：无
返回值：无

注意：
当要复位CCOR寄存器时，如果CCOEN位被置位，则需要先复位CCOEN位，然后再复位CCOSEL位，复位CCOEN位和复位CCOSEL位的操作必须连续。

这个理解不知对不对，是根据库函数的帮助来理解的，但测试结果，无论CCOEN是否置位，调用后都能恢复CCOR寄存器。

//-----------------------------------------------------------------------------------------

void CLK_HSECmd(FunctionalState NewState);

启用或禁用外部高速振荡器(HSE)

参数：
NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_HSICmd(FunctionalState NewState);

启用或禁用内部高速振荡器(HSI 16MHz)

参数：
NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_LSICmd(FunctionalState NewState);

启用或禁用内部低速振荡器(LSI 128KHz)

参数：
NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_CCOCmd(FunctionalState NewState);

启用或禁用可配置的时钟输出功能

参数：
NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_ClockSwitchCmd(FunctionalState NewState);

手动启动或关闭时钟切换

参数：
NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_FastHaltWakeUpCmd(FunctionalState NewState);

使能或禁止从停机模式(Halt)或活跃停机模式(Active Halt)中快速唤醒。

停机模式(Halt)：CPU和片上设备完全停止工作，定时唤醒单元AWU也停止，仅由外部中断及复位唤醒。

活跃停机模式(Active Halt)：保留一个定时唤醒单元AWU工作，CPU和片上设备全停止工作，AWU和外部中断及复位均可唤醒

使能后内部高速振荡器(HSI)会自动打开，且作为主时钟源(fMASTER)(CKM=SWI=HSI)，然后从停机模式(Halt)或活跃停机模式(Active Halt)中

快速唤醒。

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_SlowActiveHaltWakeUpCmd(FunctionalState NewState);

启用或禁止活跃停机模式下的电压调节器

但是这个函数并没有字面上的唤醒功能。但是跟自动唤醒（AWU）功能有关。

一旦MCU进入活跃停机模式时，主电压调节器将默认关闭(DISABLE)，从而唤醒时间将比较长，所以这个函数就为了在快速唤醒与低功耗之间选
择。

参数：
NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

如果为了能快速从活跃停机模式中唤醒，进入活跃停机前则调用CLK_SlowActiveHaltWakeUpCmd(ENABLE);但功耗较大。

如果进入活跃停机模式前没有调用CLK_SlowActiveHaltWakeUpCmd(ENABLE);或调用了CLK_SlowActiveHaltWakeUpCmd(DISABLE);即默认的情况下

，唤醒时间比较长，但功耗较低。

关于AWU（自动唤醒功能的详细说明请查看手册）

//-----------------------------------------------------------------------------------------

void CLK_PeripheralClockConfig(CLK_Peripheral_TypeDef CLK_Peripheral, FunctionalState NewState);

启用或禁用指定的外设时钟，默认所有的外设时钟都是启用的。

参数:
CLK_Peripheral 外设类型
可选值:
CLK_PERIPHERAL_I2C
CLK_PERIPHERAL_SPI
CLK_PERIPHERAL_UART1
CLK_PERIPHERAL_UART2
CLK_PERIPHERAL_UART3
CLK_PERIPHERAL_TIMER6
CLK_PERIPHERAL_TIMER4
CLK_PERIPHERAL_TIMER5
CLK_PERIPHERAL_TIMER2
CLK_PERIPHERAL_TIMER3
CLK_PERIPHERAL_TIMER1
CLK_PERIPHERAL_AWU
CLK_PERIPHERAL_ADC
CLK_PERIPHERAL_CAN

NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

ErrorStatus CLK_ClockSwitchConfig(CLK_SwitchMode_TypeDef CLK_SwitchMode, CLK_Source_TypeDef CLK_NewClock, FunctionalState

ITState, CLK_CurrentClockState_TypeDef CLK_CurrentClockState);

系统时钟切换配置

参数：

CLK_SwitchMode, 切换模式
可选值:
CLK_SWITCHMODE_MANUAL  手动切换
CLK_SWITCHMODE_AUTO    自动切换

CLK_NewClock，新的时钟源
可选值：
CLK_SOURCE_HSI  内部16MHz高速振荡器
CLK_SOURCE_LSI  内部128KHz低速振荡器
CLK_SOURCE_HSE  外部时钟

ITState,启用或禁用时钟切换中断
可选值：
DISABLE   禁用
ENABLE    启用

CLK_CurrentClockState，当前使用的时钟源在切换到新的时钟源后关闭或继续开启。
可选值：
CLK_CURRENTCLOCKSTATE_DISABLE  关闭
CLK_CURRENTCLOCKSTATE_ENABLE   开启

返回值：
如果切换成功返回SUCCESS，否则返回ERROR 

//-----------------------------------------------------------------------------------------

void CLK_HSIPrescalerConfig(CLK_Prescaler_TypeDef HSIPrescaler);

配置内部高速振荡器(HSI)的分频器

参数:
HSIPrescaler，分频值
可选值:
CLK_PRESCALER_HSIDIV1 内部高速时钟 1 分频
CLK_PRESCALER_HSIDIV2 内部高速时钟 2 分频
CLK_PRESCALER_HSIDIV4 内部高速时钟 4 分频
CLK_PRESCALER_HSIDIV8  内部高速时钟 8 分频
CLK_PRESCALER_CPUDIV1  CPU时钟 1 分频
CLK_PRESCALER_CPUDIV2  CPU时钟 2 分频
CLK_PRESCALER_CPUDIV4  CPU时钟 4 分频
CLK_PRESCALER_CPUDIV8  CPU时钟 8 分频
CLK_PRESCALER_CPUDIV16 CPU时钟 16 分频
CLK_PRESCALER_CPUDIV32 CPU时钟 32 分频
CLK_PRESCALER_CPUDIV64 CPU时钟 64 分频
CLK_PRESCALER_CPUDIV128 CPU时钟 128 分频

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_CCOConfig(CLK_Output_TypeDef CLK_CCO);

配置指定时钟输出引脚(CCO)的时钟

参数:
CLK_CCO:
可选值:
CLK_OUTPUT_HSI  内部高速振荡器频率16MHz/分频值(HSIDIV)
CLK_OUTPUT_LSI  内部低速振荡器 128KHz
CLK_OUTPUT_HSE  外部振荡器
CLK_OUTPUT_CPU  CPU时钟
CLK_OUTPUT_CPUDIV2  CPU时钟 2 分频
CLK_OUTPUT_CPUDIV4  CPU时钟 4 分频
CLK_OUTPUT_CPUDIV8  CPU时钟 8 分频
CLK_OUTPUT_CPUDIV16  CPU时钟 16 分频
CLK_OUTPUT_CPUDIV32  CPU时钟 32 分频
CLK_OUTPUT_CPUDIV64  CPU时钟 64 分频
CLK_OUTPUT_HSIRC   fHSI
CLK_OUTPUT_MASTER  fMASTER
CLK_OUTPUT_OTHERS  fCPU

返回值：无

指定的时钟输出引脚必须通过配置寄存器Px_CR1对应的位为1来设置为上拉输入或推挽输出模式。

//-----------------------------------------------------------------------------------------

void CLK_ITConfig(CLK_IT_TypeDef CLK_IT, FunctionalState NewState);

启用或禁用指定的时钟中断

参数：
CLK_IT,中断源,中断配置和标志由软件清零
可选值:
CLK_IT_CSSD  时钟安全系统检测标志
CLK_IT_SWIF  时钟切换中断标志

NewState: 新的状态值
DISABLE 禁用
ENABLE 启用

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_SYSCLKConfig(CLK_Prescaler_TypeDef CLK_Prescaler);

配置内部高速振荡器(HSI)和CPU时钟分频器

参数：
CLK_Prescaler，指定HSI或CPU时钟预分频值
可选值：
CLK_PRESCALER_HSIDIV1  内部高速振荡器 1 分频
CLK_PRESCALER_HSIDIV2  内部高速振荡器 2 分频
CLK_PRESCALER_HSIDIV4  内部高速振荡器 4 分频
CLK_PRESCALER_HSIDIV8  内部高速振荡器 8 分频
CLK_PRESCALER_CPUDIV1  CPU时钟 1 分频
CLK_PRESCALER_CPUDIV2  CPU时钟 2 分频
CLK_PRESCALER_CPUDIV4  CPU时钟 4 分频
CLK_PRESCALER_CPUDIV8  CPU时钟 8 分频
CLK_PRESCALER_CPUDIV16  CPU时钟 16 分频
CLK_PRESCALER_CPUDIV32  CPU时钟 32 分频
CLK_PRESCALER_CPUDIV64  CPU时钟 64 分频
CLK_PRESCALER_CPUDIV128  CPU时钟 128 分频

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_SWIMConfig(CLK_SWIMDivider_TypeDef CLK_SWIMDivider);

配置SWIM时钟分频器

参数:
CLK_SWIMDivider，SWIM时钟分频值
可选值:
CLK_SWIMDIVIDER_2  SWIM时钟 2 分频
CLK_SWIMDIVIDER_OTHER  SWIM时钟不分频

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_CANConfig(CLK_CANDivider_TypeDef CLK_CANDivider);

配置CAN时钟分频器

参数:

CLK_CANDivider,CAN时钟分频值
可选值：
CLK_CANDIVIDER_1  CAN时钟频率 = HSE/1 
CLK_CANDIVIDER_2  CAN时钟频率 = HSE/2 
CLK_CANDIVIDER_3  CAN时钟频率 = HSE/3 
CLK_CANDIVIDER_4  CAN时钟频率 = HSE/4 
CLK_CANDIVIDER_5  CAN时钟频率 = HSE/5 
CLK_CANDIVIDER_6  CAN时钟频率 = HSE/6 
CLK_CANDIVIDER_7  CAN时钟频率 = HSE/7 
CLK_CANDIVIDER_8  CAN时钟频率 = HSE/8
返回值：无

//-----------------------------------------------------------------------------------------

void CLK_ClockSecuritySystemEnable(void);

启用时钟安全系统。一旦启用就不能禁用，直到下一次复位。

参数：无

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_SYSCLKEmergencyClear(void);

重置时钟切换忙(SWBSY)标志，以复位时钟切换过程。
如果由于某种原因时钟切换没有成功，软件可通过清除标志位SWBSY以复位当前的切换操作，
使寄存器CLK_SWR恢复原值(原时钟源)。
如果在同一时间软件尝试置位SWEN和复位SWBSY，复位SWBSY的动作优先。

参数：无

返回值：无

//-----------------------------------------------------------------------------------------

void CLK_AdjustHSICalibrationValue(CLK_HSITrimValue_TypeDef CLK_HSICalibrationValue);

修正内部高速振荡器频率

参数：

CLK_HSICalibrationValue，校准值。
可选值：
CLK_HSITRIMVALUE_0  校准值为 0 
CLK_HSITRIMVALUE_1  校准值为 1 
CLK_HSITRIMVALUE_2  校准值为 2 
CLK_HSITRIMVALUE_3  校准值为 3 
CLK_HSITRIMVALUE_4  校准值为 4 
CLK_HSITRIMVALUE_5  校准值为 5 
CLK_HSITRIMVALUE_6  校准值为 6 
CLK_HSITRIMVALUE_7  校准值为 7
返回值：无

注意：在大容量产品上，只有位2:0是可用的。
在中等容量或小容量产品上，位3:0或2:0是可用的，取决于选项字节的配置(参见数据手册)。

//-----------------------------------------------------------------------------------------

u32 CLK_GetClockFreq(void);

获得系统主时钟频率

参数：无

返回值: 32位的主时钟频率

//-----------------------------------------------------------------------------------------

CLK_Source_TypeDef CLK_GetSYSCLKSource(void);

获得系统时钟源

参数：无

返回值：
CLK_SOURCE_HSI  时钟源为内部高速振荡器 
CLK_SOURCE_LSI  时钟源为内部低速振荡器 
CLK_SOURCE_HSE  时钟源为外部高速振荡器 

//-----------------------------------------------------------------------------------------

FlagStatus CLK_GetFlagStatus(CLK_Flag_TypeDef CLK_FLAG);

获得指定的时钟标志的置位情况

参数：

CLK_FLAG,要获得的标志
可选值：
CLK_FLAG_LSIRDY  内部低速振荡器就绪标志
CLK_FLAG_HSIRDY  内部高速振荡器就绪标志
CLK_FLAG_HSERDY  外部高速振荡器就绪标志
CLK_FLAG_SWIF    时钟切换中断标志
CLK_FLAG_SWBSY   时钟切换忙标志
CLK_FLAG_CSSD    系统时钟安全检测标志
CLK_FLAG_AUX     辅助振荡器的开关状态，(如果辅助振荡器(HSI/8)开，并做为当前的主时钟源)
CLK_FLAG_CCOBSY  可配置的时钟输出忙,用于指示所选的CCO时钟源正处于切换状态
CLK_FLAG_CCORDY  可配置的时钟输出就绪,用于指示所选的CCO时钟源正处稳定状态

返回值：
RESET 复位状态。
SET   置位状态。

//-----------------------------------------------------------------------------------------

ITStatus CLK_GetITStatus(CLK_IT_TypeDef CLK_IT);

获得指定的时钟中断启用状态

参数：
CLK_IT,时钟中断类型
可选值:
CLK_IT_CSSD  系统时钟安全检测标志
CLK_IT_SWIF  时钟切换中断标志

返回值：
RESET 复位状态。
SET   置位状态。

//-----------------------------------------------------------------------------------------

void CLK_ClearITPendingBit(CLK_IT_TypeDef CLK_IT);

清除时钟中断标志位

参数:
CLK_IT，时钟中断标志
可选值：
CLK_IT_CSSD  系统时钟安全检测标志
CLK_IT_SWIF  时钟切换中断标志

返回值：无

//-----------------------------------------------------------------------------------------