记STM32运用HAL库系统时钟配置API的一个坑

记STM32运用HAL库配置系统时钟的一个坑

踩坑背景

	最近在一个全新项目中，硬件同事让我弄一个测试验证模块的电路，使用的是f1系列单片机，过程中发现外部晶振电
	路有问题，所以转而使用内部8M的HSI作为PLL时钟源，一顿操作弄完后发现，UART通讯出了点问题，示波器抓取
	通讯波形正常，但是程序打印出来部分数据帧却是乱码，具体的现象是乱码的数据帧中每个byte的最高有效位应该为
	0，但大都被解析成了1，导致乱码。
	在分析原因时第一时间就在想是不是时钟的问题，但是在Keil下使用J-Link（盗版货，能提供5V供电^_^）调试时发现
	竟然数据帧竟然正常了，接着发现只要在VDD供电上提供一个5V的电源（错误做法哈，大家还是要接单片机适配电
	压），uart通讯竟然都保持正常了。然后放弃了对时钟的追究，花里胡哨研究一番，还是没有结果，以为是什么玄学
	问题，就放在一边了。待到硬件同事改好外部晶振电路后，uart通讯正常了。我就在想，可能HSI配置的应该是有问
	题，毕竟HAL库的苦头吃过几次了，赶紧review下配置过程。

分析过程

   进入用户main函数前，启动文件中调用System_Init 将HSI作为系统时钟，此时系统时钟频率只有8M。在main函数
   中，调用HAL库API重新配置时钟，此函数对HSI、LSI、HSE、HSI和PLL分别配置，下面截取了我们需要的HSI配置
   过程，这里面会调用一个叫__HAL_RCC_HSI_CALIBRATIONVALUE_ADJUST的函数去改变寄存器RCC->CR中的
   bit7:3，也就是对应HSI的校准值（RCC_OscInitStruct->HSICalibrationValue），画重点是这个默认值不是0，而是
   0x16。根据实际使用的温度和电压调整，一般不需要动它。
   恰巧的是，我并没有对形参RCC_OscInitStruct中的每个成员都考虑到（PS：一般用HSE，用不
   到.HSICalibrationValue这个成员），导致最终配置了一个错误的值。只要将这个成员赋值为0x16，问题就解决了。

感悟

   一定要吸取教训，大家在使用HAL库开发时，即使不看源码，最起码也要弄清楚InitType形参配置的每个成员。出了
   Bug也一定要首先看源码，HAL库的坑，个人感觉还是挺多的。希望大家可以在遇到类似的问题时，可以从我这篇笔记
   中找到灵感。
   我用CSDN很久了，但是之前都是当成百度在用，这是第一次在CSDN上认真地记录笔记，以后我会经常分享学习心得
  	或者日常开发工作中的问题笔记，希望能给各位伙伴们带来一些有用的记录。
   最后，仍然让我疑惑的点就是：为什么在时钟不准确的情况下，VDD加一个5V供电，UART数据帧就正常了呢？

HAL_StatusTypeDef HAL_RCC_OscConfig(RCC_OscInitTypeDef  *RCC_OscInitStruct)
{
	/*----------------------------- HSI Configuration --------------------------*/ 
  if(((RCC_OscInitStruct->OscillatorType) & RCC_OSCILLATORTYPE_HSI) == RCC_OSCILLATORTYPE_HSI)
  {
    /* Check the parameters */
    assert_param(IS_RCC_HSI(RCC_OscInitStruct->HSIState));
    assert_param(IS_RCC_CALIBRATION_VALUE(RCC_OscInitStruct->HSICalibrationValue));

    /* Check if HSI is used as system clock or as PLL source when PLL is selected as system clock */ 
    if((__HAL_RCC_GET_SYSCLK_SOURCE() == RCC_SYSCLKSOURCE_STATUS_HSI) 
       || ((__HAL_RCC_GET_SYSCLK_SOURCE() == RCC_SYSCLKSOURCE_STATUS_PLLCLK) && (__HAL_RCC_GET_PLL_OSCSOURCE() == RCC_PLLSOURCE_HSI_DIV2)))
    {
      /* When HSI is used as system clock it will not disabled */
      if((__HAL_RCC_GET_FLAG(RCC_FLAG_HSIRDY) != RESET) && (RCC_OscInitStruct->HSIState != RCC_HSI_ON))
      {
        return HAL_ERROR;
      }
      /* Otherwise, just the calibration is allowed */
      else
      {
        /* Adjusts the Internal High Speed oscillator (HSI) calibration value.*/
        __HAL_RCC_HSI_CALIBRATIONVALUE_ADJUST(RCC_OscInitStruct->HSICalibrationValue);
      }
    }
    else
    {
      /* Check the HSI State */
      if(RCC_OscInitStruct->HSIState != RCC_HSI_OFF)
      {
       /* Enable the Internal High Speed oscillator (HSI). */
        __HAL_RCC_HSI_ENABLE();

        /* Get Start Tick */
        tickstart = HAL_GetTick();

        /* Wait till HSI is ready */
        while(__HAL_RCC_GET_FLAG(RCC_FLAG_HSIRDY) == RESET)
        {
          if((HAL_GetTick() - tickstart ) > HSI_TIMEOUT_VALUE)
          {
            return HAL_TIMEOUT;
          }
        }

        /* Adjusts the Internal High Speed oscillator (HSI) calibration value.*/
        __HAL_RCC_HSI_CALIBRATIONVALUE_ADJUST(RCC_OscInitStruct->HSICalibrationValue);
      }
      else
      {
        /* Disable the Internal High Speed oscillator (HSI). */
        __HAL_RCC_HSI_DISABLE();

        /* Get Start Tick */
        tickstart = HAL_GetTick();

        /* Wait till HSI is disabled */
        while(__HAL_RCC_GET_FLAG(RCC_FLAG_HSIRDY) != RESET)
        {
          if((HAL_GetTick() - tickstart ) > HSI_TIMEOUT_VALUE)
          {
            return HAL_TIMEOUT;
          }
        }
      }
    }
  }
}