第031例：CRC-循环冗余校验

【HAL库每天一例】系列例程从今天开始持续更新。
我们将坚持每天至少发布一个基于YS-F1Pro开发板的HAL库例程，
该系列例程将带领大家从零开始使用HAL库，后面会持续添加模块应用例程。
同样的，我们还程序发布基于HAL库的指导文档和视频教程，欢迎持续关注，并提出改进意见。
例程下载：
资料包括程序、相关说明资料以及软件使用截图
链接：http://pan.baidu.com/s/1i574oPv
密码：r3s3
（硬石YS-F1Pro开发板HAL库例程持续更新\1. 软件设计之基本裸机例程(HAL库版本)\YSF1-031. CRC-循环冗余校验）
/**
  ******************************************************************************
  *                           硬石YS-F1Pro开发板例程功能说明
  *
  *  例程名称: YSF1-031. CRC-循环冗余校验
  *   
  ******************************************************************************
  * 说明：
  * 本例程配套硬石stm32开发板YS-F1Pro使用。
  *
  * 淘宝：
  * 论坛：http://www.ing10bbs.com
  * 版权归硬石嵌入式开发团队所有，请勿商用。
  ******************************************************************************
  */
【1】例程简介
1.CRC的全称： Cyclic Redundancy Check(循环冗余校验)
    是基于数据计算一组效验码，用于核对数据传输过程中是否被更改或传输错误。
2.分类：
  a.标准---国际标准化组织规定的标准生成多项式。
  b.非标准---用户自定义CRC的生成多项式；主要用于需要CRC且成本低的应用，或为了减
    轻计算处理负担而又能保证数据可靠的折中的办法，部分加密算法也会使用。
3.优点：
    编码和解码方法简单，检错和纠错能力强；
4.应用：
    在通信领域广泛地用于实现差错控制。
所有的STM32芯片都内置了一个硬件的CRC计算模块，可以很方便地应用到需要进行通信的程序中，
这个CRC计算模块使用常见的、在以太网中使用的计算多项式：
  X32 + X26 + X23 + X22 + X16 + X12 + X11 + X10 +X8 + X7 + X5 + X4 + X2 + X + 1
写成16进制就是：0x04C11DB7
  
【2】跳线帽情况
******* 为保证例程正常运行，必须插入以下跳线帽 **********
丝印编号     IO端口      目标功能引脚        出厂默认设置
  JP1        PA10        TXD(CH340G)          已接入
  JP2        PA9         RXD(CH340G)          已接入
  
【3】操作及现象
使用开发板配套的MINI USB线连接到开发板标示“调试串口”字样的MIMI USB接口（需要安装
驱动），在电脑端打开串口调试助手工具，设置参数为115200 8-N-1。下载完程序之后，在串口调
试助手窗口可接收到信息。
/******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/

bsp_crc.c文件内容：

1. /**
   
2.   ******************************************************************************
   
3.   * 文件名程: bsp_crc.c
   
4.   * 作    者: 硬石嵌入式开发团队
   
5.   * 版    本: V1.0
   
6.   * 编写日期: 2015-10-04
   
7.   * 功    能: CRC循环冗余校验驱动
   
8.   ******************************************************************************
   
9.   * 说明：
   
10.   * 本例程配套硬石stm32开发板YS-F1Pro使用。
    
11.   *
    
12.   * 淘宝：
    
13.   * 论坛：http://www.ing10bbs.com
    
14.   * 版权归硬石嵌入式开发团队所有，请勿商用。
    
15.   ******************************************************************************
    
16.   */
    
17. 
    
18. /* 包含头文件 ----------------------------------------------------------------*/
    
19. #include "crc/bsp_crc.h"
    
20. 
    
21. /* 私有类型定义 --------------------------------------------------------------*/
    
22. /* 私有宏定义 ----------------------------------------------------------------*/
    
23. /* 私有变量 ------------------------------------------------------------------*/
    
24. CRC_HandleTypeDef hcrc;
    
25. 
    
26. /* 扩展变量 ------------------------------------------------------------------*/
    
27. /* 私有函数原形 --------------------------------------------------------------*/
    
28. /* 函数体 --------------------------------------------------------------------*/
    
29. /**
    
30.   * 函数功能: CRC循环冗余校验初始化
    
31.   * 输入参数: 无
    
32.   * 返 回 值: 无
    
33.   * 说    明: 无
    
34.   */
    
35. void MX_CRC_Init(void)
    
36. {
    
37.   hcrc.Instance = CRC;
    
38.   HAL_CRC_Init(&hcrc);
    
39. }
    
40. 
    
41. /**
    
42.   * 函数功能: CRC循环冗余校验初始化配置
    
43.   * 输入参数: hcrc：CRC外设句柄指针
    
44.   * 返 回 值: 无
    
45.   * 说    明: Hal库内部调用
    
46.   */
    
47. void HAL_CRC_MspInit(CRC_HandleTypeDef* hcrc)
    
48. {
    
49. 
    
50.   if(hcrc->Instance==CRC)
    
51.   {
    
52.     /* 外设时钟使能 */
    
53.     __HAL_RCC_CRC_CLK_ENABLE();
    
54.   }
    
55. }
    
56. 
    
57. /**
    
58.   * 函数功能: CRC循环冗余校验反初始化配置
    
59.   * 输入参数: hcrc：CRC外设句柄指针
    
60.   * 返 回 值: 无
    
61.   * 说    明: Hal库内部调用
    
62.   */
    
63. void HAL_CRC_MspDeInit(CRC_HandleTypeDef* hcrc)
    
64. {
    
65. 
    
66.   if(hcrc->Instance==CRC)
    
67.   {
    
68.     /* 禁用CRC外设时钟 */
    
69.     __HAL_RCC_CRC_CLK_DISABLE();
    
70.   }
    
71. }
    
72. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
    

复制代码

main.c文件内容：

1. /**
   
2.   ******************************************************************************
   
3.   * 文件名程: main.c
   
4.   * 作    者: 硬石嵌入式开发团队
   
5.   * 版    本: V1.0
   
6.   * 编写日期: 2015-10-04
   
7.   * 功    能: 使用格式化输出函数定制串口打印数据
   
8.   ******************************************************************************
   
9.   * 说明：
   
10.   * 本例程配套硬石stm32开发板YS-F1Pro使用。
    
11.   *
    
12.   * 淘宝：
    
13.   * 论坛：http://www.ing10bbs.com
    
14.   * 版权归硬石嵌入式开发团队所有，请勿商用。
    
15.   ******************************************************************************
    
16.   */
    
17. /* 包含头文件 ----------------------------------------------------------------*/
    
18. #include "stm32f1xx_hal.h"
    
19. #include "usart/bsp_debug_usart.h"
    
20. #include "crc/bsp_crc.h"
    
21. 
    
22. /* 私有类型定义 --------------------------------------------------------------*/
    
23. /* 私有宏定义 ----------------------------------------------------------------*/
    
24. #define BUFFER_SIZE    114
    
25. 
    
26. /* 私有变量 ------------------------------------------------------------------*/
    
27. static const uint32_t aDataBuffer[BUFFER_SIZE] =
    
28.   {
    
29.     0x00001021, 0x20423063, 0x408450a5, 0x60c670e7, 0x9129a14a, 0xb16bc18c,
    
30.     0xd1ade1ce, 0xf1ef1231, 0x32732252, 0x52b54294, 0x72f762d6, 0x93398318,
    
31.     0xa35ad3bd, 0xc39cf3ff, 0xe3de2462, 0x34430420, 0x64e674c7, 0x44a45485,
    
32.     0xa56ab54b, 0x85289509, 0xf5cfc5ac, 0xd58d3653, 0x26721611, 0x063076d7,
    
33.     0x569546b4, 0xb75ba77a, 0x97198738, 0xf7dfe7fe, 0xc7bc48c4, 0x58e56886,
    
34.     0x78a70840, 0x18612802, 0xc9ccd9ed, 0xe98ef9af, 0x89489969, 0xa90ab92b,
    
35.     0x4ad47ab7, 0x6a961a71, 0x0a503a33, 0x2a12dbfd, 0xfbbfeb9e, 0x9b798b58,
    
36.     0xbb3bab1a, 0x6ca67c87, 0x5cc52c22, 0x3c030c60, 0x1c41edae, 0xfd8fcdec,
    
37.     0xad2abd0b, 0x8d689d49, 0x7e976eb6, 0x5ed54ef4, 0x2e321e51, 0x0e70ff9f,
    
38.     0xefbedfdd, 0xcffcbf1b, 0x9f598f78, 0x918881a9, 0xb1caa1eb, 0xd10cc12d,
    
39.     0xe16f1080, 0x00a130c2, 0x20e35004, 0x40257046, 0x83b99398, 0xa3fbb3da,
    
40.     0xc33dd31c, 0xe37ff35e, 0x129022f3, 0x32d24235, 0x52146277, 0x7256b5ea,
    
41.     0x95a88589, 0xf56ee54f, 0xd52cc50d, 0x34e224c3, 0x04817466, 0x64475424,
    
42.     0x4405a7db, 0xb7fa8799, 0xe75ff77e, 0xc71dd73c, 0x26d336f2, 0x069116b0,
    
43.     0x76764615, 0x5634d94c, 0xc96df90e, 0xe92f99c8, 0xb98aa9ab, 0x58444865,
    
44.     0x78066827, 0x18c008e1, 0x28a3cb7d, 0xdb5ceb3f, 0xfb1e8bf9, 0x9bd8abbb,
    
45.     0x4a755a54, 0x6a377a16, 0x0af11ad0, 0x2ab33a92, 0xed0fdd6c, 0xcd4dbdaa,
    
46.     0xad8b9de8, 0x8dc97c26, 0x5c644c45, 0x3ca22c83, 0x1ce00cc1, 0xef1fff3e,
    
47.     0xdf7caf9b, 0xbfba8fd9, 0x9ff86e17, 0x7e364e55, 0x2e933eb2, 0x0ed11ef0
    
48.   };
    
49. 
    
50. __IO uint32_t uwCRCValue = 0;
    
51. 
    
52. /* Expected CRC Value */
    
53. uint32_t uwExpectedCRCValue = 0x379E9F06;
    
54.   
    
55. /* 扩展变量 ------------------------------------------------------------------*/
    
56. /* 私有函数原形 --------------------------------------------------------------*/
    
57. /* 函数体 --------------------------------------------------------------------*/
    
58. /**
    
59.   * 函数功能: 系统时钟配置
    
60.   * 输入参数: 无
    
61.   * 返 回 值: 无
    
62.   * 说    明: 无
    
63.   */
    
64. void SystemClock_Config(void)
    
65. {
    
66.   RCC_OscInitTypeDef RCC_OscInitStruct;
    
67.   RCC_ClkInitTypeDef RCC_ClkInitStruct;
    
68. 
    
69.   RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;  // 外部晶振，8MHz
    
70.   RCC_OscInitStruct.HSEState = RCC_HSE_ON;
    
71.   RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREdiv_div1;
    
72.   RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
    
73.   RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    
74.   RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;  // 9倍频，得到72MHz主时钟
    
75.   HAL_RCC_OscConfig(&RCC_OscInitStruct);
    
76. 
    
77.   RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
    
78.                               |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
    
79.   RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;       // 系统时钟：72MHz
    
80.   RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_div1;              // AHB时钟：72MHz
    
81.   RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_div2;               // APB1时钟：36MHz
    
82.   RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_div1;               // APB2时钟：72MHz
    
83.   HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2);
    
84. 
    
85.          // HAL_RCC_GetHCLKFreq()/1000    1ms中断一次
    
86.         // HAL_RCC_GetHCLKFreq()/100000         10us中断一次
    
87.         // HAL_RCC_GetHCLKFreq()/1000000 1us中断一次
    
88.   HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);  // 配置并启动系统滴答定时器
    
89.   /* 系统滴答定时器时钟源 */
    
90.   HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);
    
91.   /* 系统滴答定时器中断优先级配置 */
    
92.   HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0);
    
93. }
    
94. 
    
95. /**
    
96.   * 函数功能: 主函数.
    
97.   * 输入参数: 无
    
98.   * 返 回 值: 无
    
99.   * 说    明: 无
    
100.   */
     
101. int main(void)
     
102. {
     
103.   /* 复位所有外设，初始化Flash接口和系统滴答定时器 */
     
104.   HAL_Init();
     
105.   /* 配置系统时钟 */
     
106.   SystemClock_Config();
     
107. 
     
108.   /* 初始化串口并配置串口中断优先级 */
     
109.   MX_DEBUG_USART_Init();
     
110.   
     
111.   /* CRC循环冗余校验初始化 */
     
112.   MX_CRC_Init();
     
113.   
     
114.   /* 进行冗余循环校验，获取校验码*/
     
115.   uwCRCValue = HAL_CRC_Accumulate(&hcrc, (uint32_t *)aDataBuffer, BUFFER_SIZE);
     
116.   /* 校验码与正确的校验结果对比 */
     
117.   if (uwCRCValue ！= uwExpectedCRCValue)
     
118.   {
     
119.     /* Wrong CRC value */
     
120.     printf("CRC循环冗余校验结果出错！\n");
     
121.   }
     
122.   else
     
123.   {
     
124.     /* Right CRC value */
     
125.     printf("CRC循环冗余校验结果正确！\n");
     
126.     printf("32-bit CRC 校验码为：%d\n",uwCRCValue);
     
127.   }
     
128.   /* 无限循环 */
     
129.   while (1)
     
130.   {
     
131.    
     
132.   }
     
133. }
     
134. 
     
135. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
     

复制代码