STM8庫編程筆記之時鐘管理

時間：2018-11-01 08:20:01

關鍵字： stm8 時鐘管理庫編程

手機看文章

掃描二維碼
隨時隨地手機看文章

[導讀]STM8庫函數(shù)學習筆記之時鐘管理相關函數(shù):void CLK_DeInit(void); void CLK_HSECmd(FunctionalState NewState); void CLK_HSICmd(FunctionalState NewState); void CLK_LSICmd(FunctionalState NewState); void CL

STM8庫函數(shù)學習筆記之時鐘管理

相關函數(shù):

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);

恢復相關的時鐘寄存器到默認值

參數(shù)：無
返回值：無

注意：
當要復位CCOR寄存器時，如果CCOEN位被置位，則需要先復位CCOEN位，然后再復位CCOSEL位，復位CCOEN位和復位CCOSEL位的操作必須連續(xù)。

這個理解不知對不對，是根據(jù)庫函數(shù)的幫助來理解的，但測試結果，無論CCOEN是否置位，調用后都能恢復CCOR寄存器。

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

void CLK_HSECmd(FunctionalState NewState);

啟用或禁用外部高速振蕩器(HSE)

參數(shù)：
NewState: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

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

void CLK_HSICmd(FunctionalState NewState);

啟用或禁用內部高速振蕩器(HSI 16MHz)

參數(shù)：
NewState: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

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

void CLK_LSICmd(FunctionalState NewState);

啟用或禁用內部低速振蕩器(LSI 128KHz)

參數(shù)：
NewState: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

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

void CLK_CCOCmd(FunctionalState NewState);

啟用或禁用可配置的時鐘輸出功能

參數(shù)：
NewState: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

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

void CLK_ClockSwitchCmd(FunctionalState NewState);

手動啟動或關閉時鐘切換

參數(shù)：
NewState: 新的狀態(tài)值
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);

啟用或禁止活躍停機模式下的電壓調節(jié)器

但是這個函數(shù)并沒有字面上的喚醒功能。但是跟自動喚醒（AWU）功能有關。

一旦MCU進入活躍停機模式時，主電壓調節(jié)器將默認關閉(DISABLE)，從而喚醒時間將比較長，所以這個函數(shù)就為了在快速喚醒與低功耗之間選
擇。

參數(shù)：
NewState: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

如果為了能快速從活躍停機模式中喚醒，進入活躍停機前則調用CLK_SlowActiveHaltWakeUpCmd(ENABLE);但功耗較大。

如果進入活躍停機模式前沒有調用CLK_SlowActiveHaltWakeUpCmd(ENABLE);或調用了CLK_SlowActiveHaltWakeUpCmd(DISABLE);即默認的情況下

，喚醒時間比較長，但功耗較低。

關于AWU（自動喚醒功能的詳細說明請查看手冊）

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

void CLK_PeripheralClockConfig(CLK_Peripheral_TypeDef CLK_Peripheral, FunctionalState NewState);

啟用或禁用指定的外設時鐘，默認所有的外設時鐘都是啟用的。

參數(shù):
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: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

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

ErrorStatus CLK_ClockSwitchConfig(CLK_SwitchMode_TypeDef CLK_SwitchMode, CLK_Source_TypeDef CLK_NewClock, FunctionalState

ITState, CLK_CurrentClockState_TypeDef CLK_CurrentClockState);

系統(tǒng)時鐘切換配置

參數(shù)：

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，當前使用的時鐘源在切換到新的時鐘源后關閉或繼續(xù)開啟。
可選值：
CLK_CURRENTCLOCKSTATE_DISABLE 關閉
CLK_CURRENTCLOCKSTATE_ENABLE 開啟

返回值：
如果切換成功返回SUCCESS，否則返回ERROR

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

void CLK_HSIPrescalerConfig(CLK_Prescaler_TypeDef HSIPrescaler);

配置內部高速振蕩器(HSI)的分頻器

參數(shù):
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)的時鐘

參數(shù):
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);

啟用或禁用指定的時鐘中斷

參數(shù)：
CLK_IT,中斷源,中斷配置和標志由軟件清零
可選值:
CLK_IT_CSSD 時鐘安全系統(tǒng)檢測標志
CLK_IT_SWIF 時鐘切換中斷標志

NewState: 新的狀態(tài)值
DISABLE 禁用
ENABLE 啟用

返回值：無

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

void CLK_SYSCLKConfig(CLK_Prescaler_TypeDef CLK_Prescaler);

配置內部高速振蕩器(HSI)和CPU時鐘分頻器

參數(shù)：
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時鐘分頻器

參數(shù):
CLK_SWIMDivider，SWIM時鐘分頻值
可選值:
CLK_SWIMDIVIDER_2 SWIM時鐘 2 分頻
CLK_SWIMDIVIDER_OTHER SWIM時鐘不分頻

返回值：無

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

void CLK_CANConfig(CLK_CANDivider_TypeDef CLK_CANDivider);

配置CAN時鐘分頻器

參數(shù):

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);

啟用時鐘安全系統(tǒng)。一旦啟用就不能禁用，直到下一次復位。

參數(shù)：無

返回值：無

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

void CLK_SYSCLKEmergencyClear(void);

重置時鐘切換忙(SWBSY)標志，以復位時鐘切換過程。
如果由于某種原因時鐘切換沒有成功，軟件可通過清除標志位SWBSY以復位當前的切換操作，
使寄存器CLK_SWR恢復原值(原時鐘源)。
如果在同一時間軟件嘗試置位SWEN和復位SWBSY，復位SWBSY的動作優(yōu)先。

參數(shù)：無

返回值：無

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

void CLK_AdjustHSICalibrationValue(CLK_HSITrimValue_TypeDef CLK_HSICalibrationValue);

修正內部高速振蕩器頻率

參數(shù)：

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

返回值：無

注意：在大容量產(chǎn)品上，只有位2:0是可用的。
在中等容量或小容量產(chǎn)品上，位3:0或2:0是可用的，取決于選項字節(jié)的配置(參見數(shù)據(jù)手冊)。

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

u32 CLK_GetClockFreq(void);

獲得系統(tǒng)主時鐘頻率

參數(shù)：無

返回值: 32位的主時鐘頻率

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

CLK_Source_TypeDef CLK_GetSYSCLKSource(void);

獲得系統(tǒng)時鐘源

參數(shù)：無

返回值：
CLK_SOURCE_HSI 時鐘源為內部高速振蕩器
CLK_SOURCE_LSI 時鐘源為內部低速振蕩器
CLK_SOURCE_HSE 時鐘源為外部高速振蕩器

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

FlagStatus CLK_GetFlagStatus(CLK_Flag_TypeDef CLK_FLAG);

獲得指定的時鐘標志的置位情況

參數(shù)：

CLK_FLAG,要獲得的標志
可選值：
CLK_FLAG_LSIRDY 內部低速振蕩器就緒標志
CLK_FLAG_HSIRDY 內部高速振蕩器就緒標志
CLK_FLAG_HSERDY 外部高速振蕩器就緒標志
CLK_FLAG_SWIF 時鐘切換中斷標志
CLK_FLAG_SWBSY 時鐘切換忙標志
CLK_FLAG_CSSD 系統(tǒng)時鐘安全檢測標志
CLK_FLAG_AUX 輔助振蕩器的開關狀態(tài)，(如果輔助振蕩器(HSI/8)開，并做為當前的主時鐘源)
CLK_FLAG_CCOBSY 可配置的時鐘輸出忙,用于指示所選的CCO時鐘源正處于切換狀態(tài)
CLK_FLAG_CCORDY 可配置的時鐘輸出就緒,用于指示所選的CCO時鐘源正處穩(wěn)定狀態(tài)

返回值：
RESET 復位狀態(tài)。
SET 置位狀態(tài)。

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

ITStatus CLK_GetITStatus(CLK_IT_TypeDef CLK_IT);

獲得指定的時鐘中斷啟用狀態(tài)

參數(shù)：
CLK_IT,時鐘中斷類型
可選值:
CLK_IT_CSSD 系統(tǒng)時鐘安全檢測標志
CLK_IT_SWIF 時鐘切換中斷標志

返回值：
RESET 復位狀態(tài)。
SET 置位狀態(tài)。

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

void CLK_ClearITPendingBit(CLK_IT_TypeDef CLK_IT);

清除時鐘中斷標志位

參數(shù):
CLK_IT，時鐘中斷標志
可選值：
CLK_IT_CSSD 系統(tǒng)時鐘安全檢測標志
CLK_IT_SWIF 時鐘切換中斷標志

返回值：無

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