库里面的时钟配置程序。
startup 里面有个调用SystemInit()函数的过程:
- Reset handler
- Reset_Handler PROC
- EXPORT Reset_Handler [WEAK]
- IMPORT __main
- IMPORT SystemInit
- LDR R0, =SystemInit
- BLX R0
- LDR R0, =__main
- BX R0
- ENDP
复制代码
这个SystemInit在哪里定义呢?在system_stm32f10x.c中定义。
SystemInit()快结束时调用了SetSysClock()函数,时钟配置就由该函数具体实施。
------------------------------------------------------
SetSysClock()也在system_stm32f10x.c中定义。
其实该函数很短,它根据不同的宏定义来调用不同的SetSysClockToxx()函数,比如SetSysClockTo71()就是当有宏定义SYSCLK_FREQ_72MHz时就调用该函数来具体配置时钟的。这些不同的SetSysClockToxx()调用是有优先级的,频率低的大于频率高的,而直接采用HSE具有最高优先级。
来看看这些宏定义和调用函数之间的关系:
首先是定义宏:
- #if defined (STM32F10X_LD_VL) || (defined STM32F10X_MD_VL) || (defined STM32F10X_HD_VL)
- /* #define SYSCLK_FREQ_HSE HSE_VALUE */
- #define SYSCLK_FREQ_24MHz 24000000
- #else
- /* #define SYSCLK_FREQ_HSE HSE_VALUE */
- /* #define SYSCLK_FREQ_24MHz 24000000 */
- /* #define SYSCLK_FREQ_36MHz 36000000 */
- /* #define SYSCLK_FREQ_48MHz 48000000 */
- /* #define SYSCLK_FREQ_56MHz 56000000 */
- #define SYSCLK_FREQ_72MHz 72000000
- #endif
复制代码
看来需要根据项目需求来,不能同时使用多个宏,不用的宏需要注释掉。
然后根据定义的宏来声明所需的函数:
- [mw_shl_code=c,true]#ifdef SYSCLK_FREQ_HSE
- static void SetSysClockToHSE(void);
- #elif defined SYSCLK_FREQ_24MHz
- static void SetSysClockTo24(void);
- #elif defined SYSCLK_FREQ_36MHz
- static void SetSysClockTo36(void);
- #elif defined SYSCLK_FREQ_48MHz
- static void SetSysClockTo48(void);
- #elif defined SYSCLK_FREQ_56MHz
- static void SetSysClockTo56(void);
- #elif defined SYSCLK_FREQ_72MHz
- static void SetSysClockTo72(void);
- #endif
- [/mw_shl_code]
复制代码
如果定义了多个宏会屏蔽掉低优先级的函数。在SetSysClock()里面再根据宏来调用用时钟配置函数:
- [mw_shl_code=c,true]static void SetSysClock(void)
- {
- #ifdef SYSCLK_FREQ_HSE
- SetSysClockToHSE();
- #elif defined SYSCLK_FREQ_24MHz
- SetSysClockTo24();
- #elif defined SYSCLK_FREQ_36MHz
- SetSysClockTo36();
- #elif defined SYSCLK_FREQ_48MHz
- SetSysClockTo48();
- #elif defined SYSCLK_FREQ_56MHz
- SetSysClockTo56();
- #elif defined SYSCLK_FREQ_72MHz
- SetSysClockTo72();
- #endif
- /* If none of the define above is enabled, the HSI is used as System clock
- source (default after reset) */
- }
- [/mw_shl_code]
复制代码
如果没有宏定义,或者说让SystemInit()函数为空函数,则系统不会配置时钟而直接采用内部高速时钟HSI作为系统时钟使用。
system_stm32f10x.c里面其他的代码就是关于这些SetSysClockToxx()的实现。也就是如何使用寄存器来设置倍频、分频数等等,需要了解了寄存器后才能明白。查看这些函数,有个直观的感受是里面的代码是直接使用寄存器来设置数据的,不是使用库函数。通观整个过程,如果只是学习的话,根据硬件只需要把待设置成的频率宏去掉注释而把不需要的宏注释掉就可以了,编译时会自动加入需要的时钟设置函数的。
配置好时钟后就开始执行用户程序了,在用户程序里面要使用外设首先必须让外设挂载的总线上的该设备进行时钟使能,让时钟驱动外设工作。
这是通过寄存器设置来实现的。
RCC一共有10个寄存器,互联型更多。启动时配置时钟当然要是通过这些寄存器来设置的,不过进入main后使能外设时钟就只用到了三个寄存器:RCC_AHBENR、RCC_APB2ENR、RCC_APB1ENR。寄存器同样是封装在结构体里面的:RCC_TypeDef,里面的寄存器名称去掉了RCC_前缀。既然是使用库函数,我们也就不必太关心这些寄存器封装是如何使用的了,只需关心库提供了哪些函数去操作这些寄存器实现所需的功能了。
RCC库函数在stm32f10x_rcc.h和.c中实现。
RCC地址宏定义,在stm32f10x.h中定义:
- [mw_shl_code=c,true]#define PERIPH_BASE ((uint32_t)0x40000000) /*!< Peripheral base address in the alias region */
- #define AHBPERIPH_BASE (PERIPH_BASE + 0x20000)
- #define RCC_BASE (AHBPERIPH_BASE + 0x1000)#define RCC ((RCC_TypeDef *) RCC_BASE)
- #define RCC ((RCC_TypeDef *) RCC_BASE)
- [/mw_shl_code]
复制代码
RCC寄存器原来是在AHB总线地址空间上的,这个AHB总线有些不平常。AHB、APB1、APB2总线上外设使能的函数分别是:
- [mw_shl_code=c,true]void RCC_AHBPeriphClockCmd(uint32_t RCC_AHBPeriph, FunctionalState NewState);
- void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);
- void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);[/mw_shl_code]
复制代码
要使某个外设时钟使能,其实就是使RCC_AHBENR、RCC_APB2ENR、RCC_APB1ENR三个寄存器中对应位置1,那么这是如何在函数中实现的呢?首先是定义了这三个寄存器各个位代表的外设的宏,也就是当置1时寄存器的值。以APB2ENR寄存器各个位代表的外设为例说明:
- [mw_shl_code=c,true]#define RCC_APB2Periph_AFIO ((uint32_t)0x00000001)
- #define RCC_APB2Periph_GPIOA ((uint32_t)0x00000004)
- #define RCC_APB2Periph_GPIOB ((uint32_t)0x00000008)
- #define RCC_APB2Periph_GPIOC ((uint32_t)0x00000010)
- #define RCC_APB2Periph_GPIOD ((uint32_t)0x00000020)
- #define RCC_APB2Periph_GPIOE ((uint32_t)0x00000040)
- #define RCC_APB2Periph_GPIOF ((uint32_t)0x00000080)
- #define RCC_APB2Periph_GPIOG ((uint32_t)0x00000100)
- #define RCC_APB2Periph_ADC1 ((uint32_t)0x00000200)
- #define RCC_APB2Periph_ADC2 ((uint32_t)0x00000400)
- #define RCC_APB2Periph_TIM1 ((uint32_t)0x00000800)
- #define RCC_APB2Periph_SPI1 ((uint32_t)0x00001000)
- #define RCC_APB2Periph_TIM8 ((uint32_t)0x00002000)
- #define RCC_APB2Periph_USART1 ((uint32_t)0x00004000)
- #define RCC_APB2Periph_ADC3 ((uint32_t)0x00008000)
- #define RCC_APB2Periph_TIM15 ((uint32_t)0x00010000)
- #define RCC_APB2Periph_TIM16 ((uint32_t)0x00020000)
- #define RCC_APB2Periph_TIM17 ((uint32_t)0x00040000)
- #define RCC_APB2Periph_TIM9 ((uint32_t)0x00080000)
- #define RCC_APB2Periph_TIM10 ((uint32_t)0x00100000)
- #define RCC_APB2Periph_TIM11 ((uint32_t)0x00200000)
- [/mw_shl_code]
复制代码
均是当外设位为1而其他位为0时寄存器的值。stm32中文参考手册V10.0中关于APB2ENR寄存器只有低16位有定义,高16位保留,可是,库函数里面却有高16位的几个定义,这是为什么?
而如果需要使能就使APB2ENR寄存器“或”上该值,关闭则是“与”上该值的取反值。
- [mw_shl_code=c,true]void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState)
- {
- /* Check the parameters */
- assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph));
- assert_param(IS_FUNCTIONAL_STATE(NewState));
- if (NewState != DISABLE)
- {
- RCC->APB2ENR |= RCC_APB2Periph;
- }
- else
- {
- RCC->APB2ENR &= ~RCC_APB2Periph;
- }
- }
- [/mw_shl_code]
复制代码
------------------------------------------------
断言assert_param():
看似是一个函数,其实是宏,在stm32f10x_conf.h中定义:
- [mw_shl_code=c,true]#ifdef USE_FULL_ASSERT
- #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))
- void assert_failed(uint8_t* file, uint32_t line);
- #else
- #define assert_param(expr) ((void)0)
- #endif /* USE_FULL_ASSERT */
- [/mw_shl_code]
复制代码
断言用于参数检查,如果说传入的参数符合要求那么宏值为(void)0,否则执行assert_failed()函数,这个函数没有实现。如果需要可以实现assert_failed()函数,指出哪个文件的哪行出了错误。
断言一般用在开发阶段,必须定义USE_FULL_ASSERT宏,否则只是得到(void)0,对于C来说就相当于空语句。开发调试结束取消USE_FULL_ASSERT宏。这里需要注意:宏定义不仅仅用于预编译阶段,它甚至可以用于运行阶段。比如在运行阶段才能决定断言里面的值倒地是true还是false,从而决定断言值是(void)0还是执行assert_failed()函数。断言和错误捕捉显然不同。
---------------------------------
来看看都做了什么检查:
- assert_param(IS_FUNCTIONAL_STATE(NewState));
- [mw_shl_code=c,true]#define IS_FUNCTIONAL_STATE(STATE) (((STATE) == DISABLE) || ((STATE) == ENABLE))
- [/mw_shl_code]很清楚了,如果说参数STATE为DISABLE或ENABLE则宏值为true,否则为false。
- 那么 assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph))呢?[mw_shl_code=c,true]#define IS_RCC_APB2_PERIPH(PERIPH) ((((PERIPH) & 0xFFC00002) == 0x00) && ((PERIPH) != 0x00))
- [/mw_shl_code]
复制代码
这个比较诡异!!
---------------------------------------
总结,void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);中的RCC_APB2Periph参数必须是预定义的宏才能保证是有效值。
比如:RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB,ENABLE);
如果需要同时使能多个同总线上的外设就采用“或”.
如何记忆这个函数:RCC_APB2PeriphClockCmd就是“关于RCC时钟的”挂载在APB2总线上的外设时钟使能函数,参数开头也必须是RCC_APB2Periph_开头。
————————————————
版权声明:被大佬糊弄的只会点灯的小菜鸡
如有侵权请联系删除
|