2018年10月17日 | STM32时钟RCC详解（三）

RCC相关库函数解析

1、库中所涉及到的结构体

typedef struct

{

  uint32_t SYSCLK_Frequency;  

  uint32_t HCLK_Frequency;    

  uint32_t PCLK1_Frequency;   

  uint32_t PCLK2_Frequency;   

  uint32_t ADCCLK_Frequency;

}RCC_ClocksTypeDef;

2、库函数解析

void RCC_DeInit(void);  //将外设RCC寄存器设为缺省值；（除RCC_BDCR和RCC_CSR）

void RCC_HSEConfig(uint32_t RCC_HSE);  //设置外部高速晶振（HSE）；

//输入：RCC_HSE_OFF，RCC_HSE_ON，RCC_HSE_Bypass(HSE旁路)

ErrorStatus RCC_WaitForHSEStartUp(void);   //等待HSE起振；

//返回值：SUCCESS,HSE晶振稳定且就绪；ERROR，HSE晶振未就绪

void RCC_AdjustHSICalibrationValue(uint8_t HSICalibrationValue);  //调整内部高速晶振（HSI）校准值

//输入：校准补偿值（该参数取值必须在0到0x1F之间）

void RCC_HSICmd(FunctionalState NewState);  //使能或者失能内部高速晶振（HSI）

//输入：ENABLE或者DISABLE（如果HSI被用于系统时钟，或者FLASH编写操作进行中，那么它不能被停                      振）

void RCC_PLLConfig(uint32_t RCC_PLLSource, uint32_t RCC_PLLMul);  //设置PLL时钟源及倍频系数

//输入：RCC_PLLSource_HSI_Div2，RCC_PLLSource_HSE_Div1，RCC_PLLSource_HSE_Div2

//输入：RCC_PLLMul_2到RCC_PLLMul_16

void RCC_PLLCmd(FunctionalState NewState);  // 使能或者失能PLL

//输入：ENABLE或者DISABLE

#if defined (STM32F10X_LD_VL) || defined (STM32F10X_MD_VL) || defined (STM32F10X_HD_VL) || defined (STM32F10X_CL)

 void RCC_PREDIV1Config(uint32_t RCC_PREDIV1_Source, uint32_t RCC_PREDIV1_Div);//

#endif

#ifdef  STM32F10X_CL

 void RCC_PREDIV2Config(uint32_t RCC_PREDIV2_Div);  //

 void RCC_PLL2Config(uint32_t RCC_PLL2Mul);  //

 void RCC_PLL2Cmd(FunctionalState NewState);  //

 void RCC_PLL3Config(uint32_t RCC_PLL3Mul);  //

 void RCC_PLL3Cmd(FunctionalState NewState);  //

#endif

void RCC_SYSCLKConfig(uint32_t RCC_SYSCLKSource);  //设置系统时钟(SYSCLK)源

// RCC_SYSCLKSource_HSI，RCC_SYSCLKSource_HSE，RCC_SYSCLKSource_PLLCLK

uint8_t RCC_GetSYSCLKSource(void);  // 返回用作系统时钟的时钟源

//返回值：0x00 HSI作为系统时钟，0x04 HSE作为系统时钟，0x08 PLL作为系统时钟

void RCC_HCLKConfig(uint32_t RCC_SYSCLK);  //设置AHB时钟（HCLK）

//输入:RCC_SYSCLK_Div1、RCC_SYSCLK_Div2、RCC_SYSCLK_Div4、RCC_SYSCLK_Div8、RCC_SYSCLK_Div16、RCC_SYSCLK_Div32、RCC_SYSCLK_Div64、RCC_SYSCLK_Div128、RCC_SYSCLK_Div256、RCC_SYSCLK_Div512

void RCC_PCLK1Config(uint32_t RCC_HCLK);  // 设置低速AHB时钟（PCLK1）

//输入:RCC_HCLK_Div1、RCC_HCLK_Div2、RCC_HCLK_Div4、RCC_HCLK_Div8、RCC_HCLK_Div16

void RCC_PCLK2Config(uint32_t RCC_HCLK);  // 设置高速AHB时钟（PCLK2）

//输入:RCC_HCLK_Div1、RCC_HCLK_Div2、RCC_HCLK_Div4、RCC_HCLK_Div8、RCC_HCLK_Div16

void RCC_ITConfig(uint8_t RCC_IT, FunctionalState NewState);  // 使能或者失能指定的RCC中断

//输入：RCC_IT_LSIRDY  LSI就绪中断->ENABLE或者DISABLE

//RCC_IT_LSERDY  LSE就绪中断，RCC_IT_HSIRDY  HSI就绪中断

//RCC_IT_HSERDY  HSE就绪中断，RCC_IT_PLLRDY  PLL就绪中断

#ifndef STM32F10X_CL

 void RCC_USBCLKConfig(uint32_t RCC_USBCLKSource);  // 设置USB时钟（USBCLK）

//输入：RCC_USBCLKSource_PLLCLK_1Div5，USB时钟 = PLL时钟除以1.5

RCC_USBCLKSource_PLLCLK_Div1，USB时钟 = PLL时钟

#else

void RCC_OTGFSCLKConfig(uint32_t RCC_OTGFSCLKSource);  //

#endif   

void RCC_ADCCLKConfig(uint32_t RCC_PCLK2);  // 设置ADC时钟（ADCCLK）

//RCC_PCLK2_Div2,ADC时钟 = PCLK / 2;RCC_PCLK2_Div4,ADC时钟 = PCLK / 4;

//RCC_PCLK2_Div6,ADC时钟 = PCLK / 6;RCC_PCLK2_Div8,ADC时钟 = PCLK / 8

#ifdef STM32F10X_CL

void RCC_I2S2CLKConfig(uint32_t RCC_I2S2CLKSource);   //                                

void RCC_I2S3CLKConfig(uint32_t RCC_I2S3CLKSource);  //

#endif

void RCC_LSEConfig(uint8_t RCC_LSE);  // 设置外部低速晶振（LSE）

//输入：RCC_LSE_OFF,LSE晶振OFF;RCC_LSE_ON,LSE晶振ON;

//RCC_LSE_Bypass,LSE晶振被外部时钟旁路

void RCC_LSICmd(FunctionalState NewState);  // 使能或者失能内部低速晶振（LSI）

//输入：ENABLE或者DISABLE   (IWDG运行的话，LSI不能被失能)

void RCC_RTCCLKConfig(uint32_t RCC_RTCCLKSource);  //设置RTC时钟(RTCCLK)源(RTC时钟一经选定即不能更改，除非复位后备域)

//输入：RCC_RTCCLKSource_LSE,选择LSE作为RTC时钟;RCC_RTCCLKSource_LSI,选择LSI作为RTC时钟;RCC_RTCCLKSource_HSE_Div128,选择HSE时钟频率除以128作为RTC时钟

void RCC_RTCCLKCmd(FunctionalState NewState);  // 使能或者失能RTC时钟

//输入：ENABLE或者DISABLE

void RCC_GetClocksFreq(RCC_ClocksTypeDef* RCC_Clocks);  // 返回时钟的频率

//输入：指向结构RCC_ClocksTypeDef的指针，包含了各个时钟的频率（单位为Hz）

void RCC_AHBPeriphClockCmd(uint32_t RCC_AHBPeriph, FunctionalState NewState);// 使能或者失能AHB外设时钟

//输入：RCC_AHBPeriph_DMA，DMA时钟->ENABLE或者DISABLE；

//RCC_AHBPeriph_SRAM，SRAM时钟；RCC_AHBPeriph_FLITF，FLITF时钟

//RCC_AHBPeriph_DMA1，DMA1时钟；RCC_AHBPeriph_DMA2，DMA2时钟

//RCC_AHBPeriph_CRC，CRC时钟；RCC_AHBPeriph_FSMC，FSMC时钟

//RCC_AHBPeriph_SDIO，SDIO时钟

void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);// 使能或者失能APB2外设时钟

//输入：RCC_APB2Periph_AFIO，功能复用IO时钟->ENABLE或者DISABLE；

//RCC_APB2Periph_GPIOA，GPIOA时钟；RCC_APB2Periph_GPIOB,GPIOB时钟;

//RCC_APB2Periph_GPIOC,GPIOC时钟;RCC_APB2Periph_GPIOD,GPIOD时钟;

//RCC_APB2Periph_GPIOE,GPIOE时钟;RCC_APB2Periph_ADC1,ADC1时钟;

//RCC_APB2Periph_ADC2,ADC2时钟;RCC_APB2Periph_TIM1,TIM1时钟;

//RCC_APB2Periph_SPI1,SPI1时钟;RCC_APB2Periph_USART1,USART1时钟;

//RCC_APB2Periph_ALL,全部APB2外设时钟

void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);// 使能或者失能APB1外设时钟

//输入：RCC_APB1Periph_TIM2，TIM2时钟->ENABLE或者DISABLE;

//RCC_APB1Periph_TIM3,TIM3时钟;RCC_APB1Periph_TIM4,TIM4时钟

//RCC_APB1Periph_WWDG,WWDG时钟;RCC_APB1Periph_SPI2,SPI2时钟

//RCC_APB1Periph_USART2,USART2时钟;RCC_APB1Periph_USART3,USART3时钟

//RCC_APB1Periph_I2C1,I2C1时钟;RCC_APB1Periph_I2C2,I2C2时钟

//RCC_APB1Periph_USB,USB时钟;RCC_APB1Periph_CAN,CAN时钟

//RCC_APB1Periph_BKP,BKP时钟;RCC_APB1Periph_PWR,PWR时钟

//RCC_APB1Periph_ALL,全部APB1外设时钟

#ifdef STM32F10X_CL

void RCC_AHBPeriphResetCmd(uint32_t RCC_AHBPeriph, FunctionalState NewState);  //

#endif

void RCC_APB2PeriphResetCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);  // 强制或者释放高速APB（APB2）外设复位

//输入：同void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);函数的值

void RCC_APB1PeriphResetCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);  // 强制或者释放低速APB（APB1）外设复位

//输入：同void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);函数的值

//例：

//RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI1, ENABLE);

//RCC_APB2PeriphResetCmd(RCC_APB2Periph_SPI1, DISABLE);

void RCC_BackupResetCmd(FunctionalState NewState);  // 强制或者释放后备域复位

void RCC_ClockSecuritySystemCmd(FunctionalState NewState);  //使能或者失能时钟安全系统

//输入：ENABLE或者DISABLE

void RCC_MCOConfig(uint8_t RCC_MCO);  // 选择在MCO管脚上输出的时钟源

//输入：RCC_MCO_NoClock 无时钟被选中 ；RCC_MCO_SYSCLK 选中系统时钟；

//RCC_MCO_HSI 选中HSI ；RCC_MCO_HSE 选中HSE ；

//RCC_MCO_PLLCLK_Div2 选中PLL时钟除以2

//警告：当选中系统时钟作为MCO管脚的输出时，注意它的时钟频率不超过50MHz(最大I/O速率)。

FlagStatus RCC_GetFlagStatus(uint8_t RCC_FLAG);  // 检查指定的RCC标志位设置与否

//输入：待检查的RCC标志位

//RCC_FLAG_HSIRDY ，HSI晶振就绪；RCC_FLAG_HSERDY ，HSE晶振就绪；

//RCC_FLAG_PLLRDY ，PLL就绪；RCC_FLAG_LSERDY ，LSI晶振就绪；

//RCC_FLAG_LSIRDY ，LSE晶振就绪；RCC_FLAG_PINRST ，管脚复位 ；

//RCC_FLAG_PORRST ，POR/PDR复位；RCC_FLAG_SFTRST ，软件复位 ；

//RCC_FLAG_IWDGRST ，IWDG复位；RCC_FLAG_WWDGRST ，WWDG复位；

//RCC_FLAG_LPWRRST ，低功耗复位

//返回值：RCC_FLAG的新状态（SET或者RESET）

//例：

//FlagStatus Status;

//Status = RCC_GetFlagStatus(RCC_FLAG_PLLRDY);

//if(Status == RESET)

//{

//...

//}

//else

void RCC_ClearFlag(void);  // 清除RCC的复位标志位

//(可以清除的复位标志位有：RCC_FLAG_PINRST, RCC_FLAG_PORRST, //RCC_FLAG_SFTRST, RCC_FLAG_IWDGRST, RCC_FLAG_WWDGRST, RCC_FLAG_LPWRRST)

ITStatus RCC_GetITStatus(uint8_t RCC_IT);  // 检查指定的RCC中断发生与否

//输入：RCC_IT_LSIRDY，LSI晶振就绪中断；RCC_IT_LSERDY，LSE晶振就绪中断

//RCC_IT_HSIRDY，HSI晶振就绪中断；RCC_IT_HSERDY，HSE晶振就绪中断

//RCC_IT_PLLRDY，PLL就绪中断；RCC_IT_CSS，时钟安全系统中断

//返回值：RCC_IT的新状态

//例：

//ITStatus Status;

//Status = RCC_GetITStatus(RCC_IT_PLLRDY);

//if(Status == RESET)

//{

//...

//}

//else

//{

//...

//}

void RCC_ClearITPendingBit(uint8_t RCC_IT);  // 清除RCC的中断待处理位

//RCC_IT_LSIRDY,LSI晶振就绪中断;RCC_IT_LSERDY,LSE晶振就绪中断

//RCC_IT_HSIRDY,HSI晶振就绪中断;RCC_IT_HSERDY,HSE晶振就绪中断

//RCC_IT_PLLRDY,PLL就绪中断;RCC_IT_CSS,时钟安全系统中断