2 ******************************************************************************
3 * @file stm32f4xx_hal_crc.c
4 * @author MCD Application Team
7 * @brief CRC HAL module driver.
8 * This file provides firmware functions to manage the following
9 * functionalities of the Cyclic Redundancy Check (CRC) peripheral:
10 * + Initialization and de-initialization functions
11 * + Peripheral Control functions
12 * + Peripheral State functions
15 ==============================================================================
16 ##### How to use this driver #####
17 ==============================================================================
19 The CRC HAL driver can be used as follows:
21 (#) Enable CRC AHB clock using __CRC_CLK_ENABLE();
23 (#) Use HAL_CRC_Accumulate() function to compute the CRC value of
24 a 32-bit data buffer using combination of the previous CRC value
27 (#) Use HAL_CRC_Calculate() function to compute the CRC Value of
28 a new 32-bit data buffer. This function resets the CRC computation
29 unit before starting the computation to avoid getting wrong CRC values.
32 ******************************************************************************
35 * <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
37 * Redistribution and use in source and binary forms, with or without modification,
38 * are permitted provided that the following conditions are met:
39 * 1. Redistributions of source code must retain the above copyright notice,
40 * this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright notice,
42 * this list of conditions and the following disclaimer in the documentation
43 * and/or other materials provided with the distribution.
44 * 3. Neither the name of STMicroelectronics nor the names of its contributors
45 * may be used to endorse or promote products derived from this software
46 * without specific prior written permission.
48 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
49 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
50 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
51 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
52 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
53 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
54 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
55 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
56 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
57 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
59 ******************************************************************************
62 /* Includes ------------------------------------------------------------------*/
63 #include "stm32f4xx_hal.h"
65 /** @addtogroup STM32F4xx_HAL_Driver
70 * @brief CRC HAL module driver.
74 #ifdef HAL_CRC_MODULE_ENABLED
76 /* Private typedef -----------------------------------------------------------*/
77 /* Private define ------------------------------------------------------------*/
78 /* Private macro -------------------------------------------------------------*/
79 /* Private variables ---------------------------------------------------------*/
80 /* Private function prototypes -----------------------------------------------*/
81 /* Private functions ---------------------------------------------------------*/
83 /** @defgroup CRC_Private_Functions
87 /** @defgroup CRC_Group1 Initialization and de-initialization functions
88 * @brief Initialization and Configuration functions.
91 ==============================================================================
92 ##### Initialization and de-initialization functions #####
93 ==============================================================================
94 [..] This section provides functions allowing to:
95 (+) Initialize the CRC according to the specified parameters
96 in the CRC_InitTypeDef and create the associated handle
97 (+) DeInitialize the CRC peripheral
98 (+) Initialize the CRC MSP
99 (+) DeInitialize CRC MSP
106 * @brief Initializes the CRC according to the specified
107 * parameters in the CRC_InitTypeDef and creates the associated handle.
108 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
109 * the configuration information for CRC
112 HAL_StatusTypeDef HAL_CRC_Init(CRC_HandleTypeDef *hcrc)
114 /* Check the CRC handle allocation */
120 /* Check the parameters */
121 assert_param(IS_CRC_ALL_INSTANCE(hcrc->Instance));
123 if(hcrc->State == HAL_CRC_STATE_RESET)
125 /* Init the low level hardware */
126 HAL_CRC_MspInit(hcrc);
129 /* Change CRC peripheral state */
130 hcrc->State = HAL_CRC_STATE_BUSY;
132 /* Change CRC peripheral state */
133 hcrc->State = HAL_CRC_STATE_READY;
135 /* Return function status */
140 * @brief DeInitializes the CRC peripheral.
141 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
142 * the configuration information for CRC
145 HAL_StatusTypeDef HAL_CRC_DeInit(CRC_HandleTypeDef *hcrc)
147 /* Check the CRC handle allocation */
153 /* Check the parameters */
154 assert_param(IS_CRC_ALL_INSTANCE(hcrc->Instance));
156 /* Change CRC peripheral state */
157 hcrc->State = HAL_CRC_STATE_BUSY;
159 /* DeInit the low level hardware */
160 HAL_CRC_MspDeInit(hcrc);
162 /* Change CRC peripheral state */
163 hcrc->State = HAL_CRC_STATE_RESET;
168 /* Return function status */
173 * @brief Initializes the CRC MSP.
174 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
175 * the configuration information for CRC
178 __weak void HAL_CRC_MspInit(CRC_HandleTypeDef *hcrc)
180 /* NOTE : This function Should not be modified, when the callback is needed,
181 the HAL_CRC_MspInit could be implemented in the user file
186 * @brief DeInitializes the CRC MSP.
187 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
188 * the configuration information for CRC
191 __weak void HAL_CRC_MspDeInit(CRC_HandleTypeDef *hcrc)
193 /* NOTE : This function Should not be modified, when the callback is needed,
194 the HAL_CRC_MspDeInit could be implemented in the user file
202 /** @defgroup CRC_Group2 Peripheral Control functions
203 * @brief management functions.
206 ==============================================================================
207 ##### Peripheral Control functions #####
208 ==============================================================================
209 [..] This section provides functions allowing to:
210 (+) Compute the 32-bit CRC value of 32-bit data buffer,
211 using combination of the previous CRC value and the new one.
212 (+) Compute the 32-bit CRC value of 32-bit data buffer,
213 independently of the previous CRC value.
220 * @brief Computes the 32-bit CRC of 32-bit data buffer using combination
221 * of the previous CRC value and the new one.
222 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
223 * the configuration information for CRC
224 * @param pBuffer: pointer to the buffer containing the data to be computed
225 * @param BufferLength: length of the buffer to be computed
228 uint32_t HAL_CRC_Accumulate(CRC_HandleTypeDef *hcrc, uint32_t pBuffer[], uint32_t BufferLength)
235 /* Change CRC peripheral state */
236 hcrc->State = HAL_CRC_STATE_BUSY;
238 /* Enter Data to the CRC calculator */
239 for(index = 0; index < BufferLength; index++)
241 hcrc->Instance->DR = pBuffer[index];
244 /* Change CRC peripheral state */
245 hcrc->State = HAL_CRC_STATE_READY;
247 /* Process Unlocked */
250 /* Return the CRC computed value */
251 return hcrc->Instance->DR;
255 * @brief Computes the 32-bit CRC of 32-bit data buffer independently
256 * of the previous CRC value.
257 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
258 * the configuration information for CRC
259 * @param pBuffer: Pointer to the buffer containing the data to be computed
260 * @param BufferLength: Length of the buffer to be computed
263 uint32_t HAL_CRC_Calculate(CRC_HandleTypeDef *hcrc, uint32_t pBuffer[], uint32_t BufferLength)
270 /* Change CRC peripheral state */
271 hcrc->State = HAL_CRC_STATE_BUSY;
273 /* Reset CRC Calculation Unit */
274 __HAL_CRC_DR_RESET(hcrc);
276 /* Enter Data to the CRC calculator */
277 for(index = 0; index < BufferLength; index++)
279 hcrc->Instance->DR = pBuffer[index];
282 /* Change CRC peripheral state */
283 hcrc->State = HAL_CRC_STATE_READY;
285 /* Process Unlocked */
288 /* Return the CRC computed value */
289 return hcrc->Instance->DR;
296 /** @defgroup CRC_Group3 Peripheral State functions
297 * @brief Peripheral State functions.
300 ==============================================================================
301 ##### Peripheral State functions #####
302 ==============================================================================
304 This subsection permits to get in run-time the status of the peripheral
312 * @brief Returns the CRC state.
313 * @param hcrc: pointer to a CRC_HandleTypeDef structure that contains
314 * the configuration information for CRC
317 HAL_CRC_StateTypeDef HAL_CRC_GetState(CRC_HandleTypeDef *hcrc)
330 #endif /* HAL_CRC_MODULE_ENABLED */
339 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/