mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L4/stm32l4xx_hal_crc.c@610:813dcc80987e, 2015-08-14 (annotated)

Committer:
mbed_official
Date:
Fri Aug 14 13:15:17 2015 +0100
Revision:
610:813dcc80987e
Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599



Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/



DISCO_F746NG - Improvements

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 610:813dcc80987e 1 /**
mbed_official 610:813dcc80987e 2 ******************************************************************************
mbed_official 610:813dcc80987e 3 * @file stm32l4xx_hal_crc.c
mbed_official 610:813dcc80987e 4 * @author MCD Application Team
mbed_official 610:813dcc80987e 5 * @version V1.0.0
mbed_official 610:813dcc80987e 6 * @date 26-June-2015
mbed_official 610:813dcc80987e 7 * @brief CRC HAL module driver.
mbed_official 610:813dcc80987e 8 * This file provides firmware functions to manage the following
mbed_official 610:813dcc80987e 9 * functionalities of the CRC peripheral:
mbed_official 610:813dcc80987e 10 * + Initialization and de-initialization functions
mbed_official 610:813dcc80987e 11 * + Peripheral Control functions
mbed_official 610:813dcc80987e 12 * + Peripheral State functions
mbed_official 610:813dcc80987e 13 *
mbed_official 610:813dcc80987e 14 @verbatim
mbed_official 610:813dcc80987e 15 ===============================================================================
mbed_official 610:813dcc80987e 16 ##### How to use this driver #####
mbed_official 610:813dcc80987e 17 ===============================================================================
mbed_official 610:813dcc80987e 18 [..]
mbed_official 610:813dcc80987e 19 (+) Enable CRC AHB clock using __HAL_RCC_CRC_CLK_ENABLE();
mbed_official 610:813dcc80987e 20 (+) Initialize CRC calculator
mbed_official 610:813dcc80987e 21 (++) specify generating polynomial (IP default or non-default one)
mbed_official 610:813dcc80987e 22 (++) specify initialization value (IP default or non-default one)
mbed_official 610:813dcc80987e 23 (++) specify input data format
mbed_official 610:813dcc80987e 24 (++) specify input or output data inversion mode if any
mbed_official 610:813dcc80987e 25 (+) Use HAL_CRC_Accumulate() function to compute the CRC value of the
mbed_official 610:813dcc80987e 26 input data buffer starting with the previously computed CRC as
mbed_official 610:813dcc80987e 27 initialization value
mbed_official 610:813dcc80987e 28 (+) Use HAL_CRC_Calculate() function to compute the CRC value of the
mbed_official 610:813dcc80987e 29 input data buffer starting with the defined initialization value
mbed_official 610:813dcc80987e 30 (default or non-default) to initiate CRC calculation
mbed_official 610:813dcc80987e 31
mbed_official 610:813dcc80987e 32 @endverbatim
mbed_official 610:813dcc80987e 33 ******************************************************************************
mbed_official 610:813dcc80987e 34 * @attention
mbed_official 610:813dcc80987e 35 *
mbed_official 610:813dcc80987e 36 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 610:813dcc80987e 37 *
mbed_official 610:813dcc80987e 38 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 610:813dcc80987e 39 * are permitted provided that the following conditions are met:
mbed_official 610:813dcc80987e 40 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 610:813dcc80987e 41 * this list of conditions and the following disclaimer.
mbed_official 610:813dcc80987e 42 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 610:813dcc80987e 43 * this list of conditions and the following disclaimer in the documentation
mbed_official 610:813dcc80987e 44 * and/or other materials provided with the distribution.
mbed_official 610:813dcc80987e 45 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 610:813dcc80987e 46 * may be used to endorse or promote products derived from this software
mbed_official 610:813dcc80987e 47 * without specific prior written permission.
mbed_official 610:813dcc80987e 48 *
mbed_official 610:813dcc80987e 49 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 610:813dcc80987e 50 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 610:813dcc80987e 51 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 610:813dcc80987e 52 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 610:813dcc80987e 53 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 610:813dcc80987e 54 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 610:813dcc80987e 55 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 610:813dcc80987e 56 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 610:813dcc80987e 57 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 610:813dcc80987e 58 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 610:813dcc80987e 59 *
mbed_official 610:813dcc80987e 60 ******************************************************************************
mbed_official 610:813dcc80987e 61 */
mbed_official 610:813dcc80987e 62
mbed_official 610:813dcc80987e 63 /* Includes ------------------------------------------------------------------*/
mbed_official 610:813dcc80987e 64 #include "stm32l4xx_hal.h"
mbed_official 610:813dcc80987e 65
mbed_official 610:813dcc80987e 66 /** @addtogroup STM32L4xx_HAL_Driver
mbed_official 610:813dcc80987e 67 * @{
mbed_official 610:813dcc80987e 68 */
mbed_official 610:813dcc80987e 69
mbed_official 610:813dcc80987e 70 /** @defgroup CRC CRC
mbed_official 610:813dcc80987e 71 * @brief CRC HAL module driver.
mbed_official 610:813dcc80987e 72 * @{
mbed_official 610:813dcc80987e 73 */
mbed_official 610:813dcc80987e 74
mbed_official 610:813dcc80987e 75 #ifdef HAL_CRC_MODULE_ENABLED
mbed_official 610:813dcc80987e 76
mbed_official 610:813dcc80987e 77 /* Private typedef -----------------------------------------------------------*/
mbed_official 610:813dcc80987e 78 /* Private define ------------------------------------------------------------*/
mbed_official 610:813dcc80987e 79 /* Private macro -------------------------------------------------------------*/
mbed_official 610:813dcc80987e 80 /* Private variables ---------------------------------------------------------*/
mbed_official 610:813dcc80987e 81 /* Private function prototypes -----------------------------------------------*/
mbed_official 610:813dcc80987e 82 /** @defgroup CRC_Private_Functions CRC Private Functions
mbed_official 610:813dcc80987e 83 * @{
mbed_official 610:813dcc80987e 84 */
mbed_official 610:813dcc80987e 85 static uint32_t CRC_Handle_8(CRC_HandleTypeDef *hcrc, uint8_t pBuffer[], uint32_t BufferLength);
mbed_official 610:813dcc80987e 86 static uint32_t CRC_Handle_16(CRC_HandleTypeDef *hcrc, uint16_t pBuffer[], uint32_t BufferLength);
mbed_official 610:813dcc80987e 87 /**
mbed_official 610:813dcc80987e 88 * @}
mbed_official 610:813dcc80987e 89 */
mbed_official 610:813dcc80987e 90
mbed_official 610:813dcc80987e 91 /* Exported functions --------------------------------------------------------*/
mbed_official 610:813dcc80987e 92
mbed_official 610:813dcc80987e 93 /** @defgroup CRC_Exported_Functions CRC Exported Functions
mbed_official 610:813dcc80987e 94 * @{
mbed_official 610:813dcc80987e 95 */
mbed_official 610:813dcc80987e 96
mbed_official 610:813dcc80987e 97 /** @defgroup CRC_Exported_Functions_Group1 Initialization and de-initialization functions
mbed_official 610:813dcc80987e 98 * @brief Initialization and Configuration functions.
mbed_official 610:813dcc80987e 99 *
mbed_official 610:813dcc80987e 100 @verbatim
mbed_official 610:813dcc80987e 101 ===============================================================================
mbed_official 610:813dcc80987e 102 ##### Initialization and de-initialization functions #####
mbed_official 610:813dcc80987e 103 ===============================================================================
mbed_official 610:813dcc80987e 104 [..] This section provides functions allowing to:
mbed_official 610:813dcc80987e 105 (+) Initialize the CRC according to the specified parameters
mbed_official 610:813dcc80987e 106 in the CRC_InitTypeDef and create the associated handle
mbed_official 610:813dcc80987e 107 (+) DeInitialize the CRC peripheral
mbed_official 610:813dcc80987e 108 (+) Initialize the CRC MSP (MCU Specific Package)
mbed_official 610:813dcc80987e 109 (+) DeInitialize the CRC MSP
mbed_official 610:813dcc80987e 110
mbed_official 610:813dcc80987e 111 @endverbatim
mbed_official 610:813dcc80987e 112 * @{
mbed_official 610:813dcc80987e 113 */
mbed_official 610:813dcc80987e 114
mbed_official 610:813dcc80987e 115 /**
mbed_official 610:813dcc80987e 116 * @brief Initializes the CRC according to the specified
mbed_official 610:813dcc80987e 117 * parameters in the CRC_InitTypeDef and initialize the associated handle.
mbed_official 610:813dcc80987e 118 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 119 * @retval HAL status
mbed_official 610:813dcc80987e 120 */
mbed_official 610:813dcc80987e 121 HAL_StatusTypeDef HAL_CRC_Init(CRC_HandleTypeDef *hcrc)
mbed_official 610:813dcc80987e 122 {
mbed_official 610:813dcc80987e 123 /* Check the CRC handle allocation */
mbed_official 610:813dcc80987e 124 if(hcrc == NULL)
mbed_official 610:813dcc80987e 125 {
mbed_official 610:813dcc80987e 126 return HAL_ERROR;
mbed_official 610:813dcc80987e 127 }
mbed_official 610:813dcc80987e 128
mbed_official 610:813dcc80987e 129 /* Check the parameters */
mbed_official 610:813dcc80987e 130 assert_param(IS_CRC_ALL_INSTANCE(hcrc->Instance));
mbed_official 610:813dcc80987e 131
mbed_official 610:813dcc80987e 132 if(hcrc->State == HAL_CRC_STATE_RESET)
mbed_official 610:813dcc80987e 133 {
mbed_official 610:813dcc80987e 134 /* Allocate lock resource and initialize it */
mbed_official 610:813dcc80987e 135 hcrc->Lock = HAL_UNLOCKED;
mbed_official 610:813dcc80987e 136
mbed_official 610:813dcc80987e 137 /* Init the low level hardware */
mbed_official 610:813dcc80987e 138 HAL_CRC_MspInit(hcrc);
mbed_official 610:813dcc80987e 139 }
mbed_official 610:813dcc80987e 140
mbed_official 610:813dcc80987e 141 hcrc->State = HAL_CRC_STATE_BUSY;
mbed_official 610:813dcc80987e 142
mbed_official 610:813dcc80987e 143 /* check whether or not non-default generating polynomial has been
mbed_official 610:813dcc80987e 144 * picked up by user */
mbed_official 610:813dcc80987e 145 assert_param(IS_DEFAULT_POLYNOMIAL(hcrc->Init.DefaultPolynomialUse));
mbed_official 610:813dcc80987e 146 if (hcrc->Init.DefaultPolynomialUse == DEFAULT_POLYNOMIAL_ENABLE)
mbed_official 610:813dcc80987e 147 {
mbed_official 610:813dcc80987e 148 /* initialize IP with default generating polynomial */
mbed_official 610:813dcc80987e 149 WRITE_REG(hcrc->Instance->POL, DEFAULT_CRC32_POLY);
mbed_official 610:813dcc80987e 150 MODIFY_REG(hcrc->Instance->CR, CRC_CR_POLYSIZE, CRC_POLYLENGTH_32B);
mbed_official 610:813dcc80987e 151 }
mbed_official 610:813dcc80987e 152 else
mbed_official 610:813dcc80987e 153 {
mbed_official 610:813dcc80987e 154 /* initialize CRC IP with generating polynomial defined by user */
mbed_official 610:813dcc80987e 155 if (HAL_CRCEx_Polynomial_Set(hcrc, hcrc->Init.GeneratingPolynomial, hcrc->Init.CRCLength) != HAL_OK)
mbed_official 610:813dcc80987e 156 {
mbed_official 610:813dcc80987e 157 return HAL_ERROR;
mbed_official 610:813dcc80987e 158 }
mbed_official 610:813dcc80987e 159 }
mbed_official 610:813dcc80987e 160
mbed_official 610:813dcc80987e 161 /* check whether or not non-default CRC initial value has been
mbed_official 610:813dcc80987e 162 * picked up by user */
mbed_official 610:813dcc80987e 163 assert_param(IS_DEFAULT_INIT_VALUE(hcrc->Init.DefaultInitValueUse));
mbed_official 610:813dcc80987e 164 if (hcrc->Init.DefaultInitValueUse == DEFAULT_INIT_VALUE_ENABLE)
mbed_official 610:813dcc80987e 165 {
mbed_official 610:813dcc80987e 166 WRITE_REG(hcrc->Instance->INIT, DEFAULT_CRC_INITVALUE);
mbed_official 610:813dcc80987e 167 }
mbed_official 610:813dcc80987e 168 else
mbed_official 610:813dcc80987e 169 {
mbed_official 610:813dcc80987e 170 WRITE_REG(hcrc->Instance->INIT, hcrc->Init.InitValue);
mbed_official 610:813dcc80987e 171 }
mbed_official 610:813dcc80987e 172
mbed_official 610:813dcc80987e 173
mbed_official 610:813dcc80987e 174 /* set input data inversion mode */
mbed_official 610:813dcc80987e 175 assert_param(IS_CRC_INPUTDATA_INVERSION_MODE(hcrc->Init.InputDataInversionMode));
mbed_official 610:813dcc80987e 176 MODIFY_REG(hcrc->Instance->CR, CRC_CR_REV_IN, hcrc->Init.InputDataInversionMode);
mbed_official 610:813dcc80987e 177
mbed_official 610:813dcc80987e 178 /* set output data inversion mode */
mbed_official 610:813dcc80987e 179 assert_param(IS_CRC_OUTPUTDATA_INVERSION_MODE(hcrc->Init.OutputDataInversionMode));
mbed_official 610:813dcc80987e 180 MODIFY_REG(hcrc->Instance->CR, CRC_CR_REV_OUT, hcrc->Init.OutputDataInversionMode);
mbed_official 610:813dcc80987e 181
mbed_official 610:813dcc80987e 182 /* makes sure the input data format (bytes, halfwords or words stream)
mbed_official 610:813dcc80987e 183 * is properly specified by user */
mbed_official 610:813dcc80987e 184 assert_param(IS_CRC_INPUTDATA_FORMAT(hcrc->InputDataFormat));
mbed_official 610:813dcc80987e 185
mbed_official 610:813dcc80987e 186 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 187 hcrc->State = HAL_CRC_STATE_READY;
mbed_official 610:813dcc80987e 188
mbed_official 610:813dcc80987e 189 /* Return function status */
mbed_official 610:813dcc80987e 190 return HAL_OK;
mbed_official 610:813dcc80987e 191 }
mbed_official 610:813dcc80987e 192
mbed_official 610:813dcc80987e 193 /**
mbed_official 610:813dcc80987e 194 * @brief DeInitialize the CRC peripheral.
mbed_official 610:813dcc80987e 195 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 196 * @retval HAL status
mbed_official 610:813dcc80987e 197 */
mbed_official 610:813dcc80987e 198 HAL_StatusTypeDef HAL_CRC_DeInit(CRC_HandleTypeDef *hcrc)
mbed_official 610:813dcc80987e 199 {
mbed_official 610:813dcc80987e 200 /* Check the CRC handle allocation */
mbed_official 610:813dcc80987e 201 if(hcrc == NULL)
mbed_official 610:813dcc80987e 202 {
mbed_official 610:813dcc80987e 203 return HAL_ERROR;
mbed_official 610:813dcc80987e 204 }
mbed_official 610:813dcc80987e 205
mbed_official 610:813dcc80987e 206 /* Check the parameters */
mbed_official 610:813dcc80987e 207 assert_param(IS_CRC_ALL_INSTANCE(hcrc->Instance));
mbed_official 610:813dcc80987e 208
mbed_official 610:813dcc80987e 209 /* Check the CRC peripheral state */
mbed_official 610:813dcc80987e 210 if(hcrc->State == HAL_CRC_STATE_BUSY)
mbed_official 610:813dcc80987e 211 {
mbed_official 610:813dcc80987e 212 return HAL_BUSY;
mbed_official 610:813dcc80987e 213 }
mbed_official 610:813dcc80987e 214
mbed_official 610:813dcc80987e 215 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 216 hcrc->State = HAL_CRC_STATE_BUSY;
mbed_official 610:813dcc80987e 217
mbed_official 610:813dcc80987e 218 /* Reset CRC calculation unit */
mbed_official 610:813dcc80987e 219 __HAL_CRC_DR_RESET(hcrc);
mbed_official 610:813dcc80987e 220
mbed_official 610:813dcc80987e 221 /* DeInit the low level hardware */
mbed_official 610:813dcc80987e 222 HAL_CRC_MspDeInit(hcrc);
mbed_official 610:813dcc80987e 223
mbed_official 610:813dcc80987e 224 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 225 hcrc->State = HAL_CRC_STATE_RESET;
mbed_official 610:813dcc80987e 226
mbed_official 610:813dcc80987e 227 /* Process unlocked */
mbed_official 610:813dcc80987e 228 __HAL_UNLOCK(hcrc);
mbed_official 610:813dcc80987e 229
mbed_official 610:813dcc80987e 230 /* Return function status */
mbed_official 610:813dcc80987e 231 return HAL_OK;
mbed_official 610:813dcc80987e 232 }
mbed_official 610:813dcc80987e 233
mbed_official 610:813dcc80987e 234 /**
mbed_official 610:813dcc80987e 235 * @brief Initializes the CRC MSP.
mbed_official 610:813dcc80987e 236 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 237 * @retval None
mbed_official 610:813dcc80987e 238 */
mbed_official 610:813dcc80987e 239 __weak void HAL_CRC_MspInit(CRC_HandleTypeDef *hcrc)
mbed_official 610:813dcc80987e 240 {
mbed_official 610:813dcc80987e 241 /* NOTE : This function should not be modified, when the callback is needed,
mbed_official 610:813dcc80987e 242 the HAL_CRC_MspInit can be implemented in the user file
mbed_official 610:813dcc80987e 243 */
mbed_official 610:813dcc80987e 244 }
mbed_official 610:813dcc80987e 245
mbed_official 610:813dcc80987e 246 /**
mbed_official 610:813dcc80987e 247 * @brief DeInitialize the CRC MSP.
mbed_official 610:813dcc80987e 248 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 249 * @retval None
mbed_official 610:813dcc80987e 250 */
mbed_official 610:813dcc80987e 251 __weak void HAL_CRC_MspDeInit(CRC_HandleTypeDef *hcrc)
mbed_official 610:813dcc80987e 252 {
mbed_official 610:813dcc80987e 253 /* NOTE : This function should not be modified, when the callback is needed,
mbed_official 610:813dcc80987e 254 the HAL_CRC_MspDeInit can be implemented in the user file
mbed_official 610:813dcc80987e 255 */
mbed_official 610:813dcc80987e 256 }
mbed_official 610:813dcc80987e 257
mbed_official 610:813dcc80987e 258 /**
mbed_official 610:813dcc80987e 259 * @}
mbed_official 610:813dcc80987e 260 */
mbed_official 610:813dcc80987e 261
mbed_official 610:813dcc80987e 262 /** @defgroup CRC_Exported_Functions_Group2 Peripheral Control functions
mbed_official 610:813dcc80987e 263 * @brief management functions.
mbed_official 610:813dcc80987e 264 *
mbed_official 610:813dcc80987e 265 @verbatim
mbed_official 610:813dcc80987e 266 ===============================================================================
mbed_official 610:813dcc80987e 267 ##### Peripheral Control functions #####
mbed_official 610:813dcc80987e 268 ===============================================================================
mbed_official 610:813dcc80987e 269 [..] This section provides functions allowing to:
mbed_official 610:813dcc80987e 270 (+) compute the 7, 8, 16 or 32-bit CRC value of an 8, 16 or 32-bit data buffer
mbed_official 610:813dcc80987e 271 using the combination of the previous CRC value and the new one
mbed_official 610:813dcc80987e 272
mbed_official 610:813dcc80987e 273 [..] or
mbed_official 610:813dcc80987e 274
mbed_official 610:813dcc80987e 275 (+) compute the 7, 8, 16 or 32-bit CRC value of an 8, 16 or 32-bit data buffer
mbed_official 610:813dcc80987e 276 independently of the previous CRC value.
mbed_official 610:813dcc80987e 277
mbed_official 610:813dcc80987e 278 @endverbatim
mbed_official 610:813dcc80987e 279 * @{
mbed_official 610:813dcc80987e 280 */
mbed_official 610:813dcc80987e 281
mbed_official 610:813dcc80987e 282 /**
mbed_official 610:813dcc80987e 283 * @brief Compute the 7, 8, 16 or 32-bit CRC value of an 8, 16 or 32-bit data buffer
mbed_official 610:813dcc80987e 284 * starting with the previously computed CRC as initialization value.
mbed_official 610:813dcc80987e 285 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 286 * @param pBuffer: pointer to the input data buffer, exact input data format is
mbed_official 610:813dcc80987e 287 * provided by hcrc->InputDataFormat.
mbed_official 610:813dcc80987e 288 * @param BufferLength: input data buffer length
mbed_official 610:813dcc80987e 289 * @retval uint32_t CRC (returned value LSBs for CRC shorter than 32 bits)
mbed_official 610:813dcc80987e 290 */
mbed_official 610:813dcc80987e 291 uint32_t HAL_CRC_Accumulate(CRC_HandleTypeDef *hcrc, uint32_t pBuffer[], uint32_t BufferLength)
mbed_official 610:813dcc80987e 292 {
mbed_official 610:813dcc80987e 293 uint32_t index = 0; /* CRC input data buffer index */
mbed_official 610:813dcc80987e 294 uint32_t temp = 0; /* CRC output (read from hcrc->Instance->DR register) */
mbed_official 610:813dcc80987e 295
mbed_official 610:813dcc80987e 296 /* Process locked */
mbed_official 610:813dcc80987e 297 __HAL_LOCK(hcrc);
mbed_official 610:813dcc80987e 298
mbed_official 610:813dcc80987e 299 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 300 hcrc->State = HAL_CRC_STATE_BUSY;
mbed_official 610:813dcc80987e 301
mbed_official 610:813dcc80987e 302 switch (hcrc->InputDataFormat)
mbed_official 610:813dcc80987e 303 {
mbed_official 610:813dcc80987e 304 case CRC_INPUTDATA_FORMAT_WORDS:
mbed_official 610:813dcc80987e 305 /* Enter Data to the CRC calculator */
mbed_official 610:813dcc80987e 306 for(index = 0; index < BufferLength; index++)
mbed_official 610:813dcc80987e 307 {
mbed_official 610:813dcc80987e 308 hcrc->Instance->DR = pBuffer[index];
mbed_official 610:813dcc80987e 309 }
mbed_official 610:813dcc80987e 310 temp = hcrc->Instance->DR;
mbed_official 610:813dcc80987e 311 break;
mbed_official 610:813dcc80987e 312
mbed_official 610:813dcc80987e 313 case CRC_INPUTDATA_FORMAT_BYTES:
mbed_official 610:813dcc80987e 314 temp = CRC_Handle_8(hcrc, (uint8_t*)pBuffer, BufferLength);
mbed_official 610:813dcc80987e 315 break;
mbed_official 610:813dcc80987e 316
mbed_official 610:813dcc80987e 317 case CRC_INPUTDATA_FORMAT_HALFWORDS:
mbed_official 610:813dcc80987e 318 temp = CRC_Handle_16(hcrc, (uint16_t*)pBuffer, BufferLength);
mbed_official 610:813dcc80987e 319 break;
mbed_official 610:813dcc80987e 320
mbed_official 610:813dcc80987e 321 default:
mbed_official 610:813dcc80987e 322 break;
mbed_official 610:813dcc80987e 323 }
mbed_official 610:813dcc80987e 324
mbed_official 610:813dcc80987e 325 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 326 hcrc->State = HAL_CRC_STATE_READY;
mbed_official 610:813dcc80987e 327
mbed_official 610:813dcc80987e 328 /* Process unlocked */
mbed_official 610:813dcc80987e 329 __HAL_UNLOCK(hcrc);
mbed_official 610:813dcc80987e 330
mbed_official 610:813dcc80987e 331 /* Return the CRC computed value */
mbed_official 610:813dcc80987e 332 return temp;
mbed_official 610:813dcc80987e 333 }
mbed_official 610:813dcc80987e 334
mbed_official 610:813dcc80987e 335
mbed_official 610:813dcc80987e 336 /**
mbed_official 610:813dcc80987e 337 * @brief Compute the 7, 8, 16 or 32-bit CRC value of an 8, 16 or 32-bit data buffer
mbed_official 610:813dcc80987e 338 * starting with hcrc->Instance->INIT as initialization value.
mbed_official 610:813dcc80987e 339 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 340 * @param pBuffer: pointer to the input data buffer, exact input data format is
mbed_official 610:813dcc80987e 341 * provided by hcrc->InputDataFormat.
mbed_official 610:813dcc80987e 342 * @param BufferLength: input data buffer length
mbed_official 610:813dcc80987e 343 * @retval uint32_t CRC (returned value LSBs for CRC shorter than 32 bits)
mbed_official 610:813dcc80987e 344 */
mbed_official 610:813dcc80987e 345 uint32_t HAL_CRC_Calculate(CRC_HandleTypeDef *hcrc, uint32_t pBuffer[], uint32_t BufferLength)
mbed_official 610:813dcc80987e 346 {
mbed_official 610:813dcc80987e 347 uint32_t index = 0; /* CRC input data buffer index */
mbed_official 610:813dcc80987e 348 uint32_t temp = 0; /* CRC output (read from hcrc->Instance->DR register) */
mbed_official 610:813dcc80987e 349
mbed_official 610:813dcc80987e 350 /* Process locked */
mbed_official 610:813dcc80987e 351 __HAL_LOCK(hcrc);
mbed_official 610:813dcc80987e 352
mbed_official 610:813dcc80987e 353 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 354 hcrc->State = HAL_CRC_STATE_BUSY;
mbed_official 610:813dcc80987e 355
mbed_official 610:813dcc80987e 356 /* Reset CRC Calculation Unit (hcrc->Instance->INIT is
mbed_official 610:813dcc80987e 357 * written in hcrc->Instance->DR) */
mbed_official 610:813dcc80987e 358 __HAL_CRC_DR_RESET(hcrc);
mbed_official 610:813dcc80987e 359
mbed_official 610:813dcc80987e 360 switch (hcrc->InputDataFormat)
mbed_official 610:813dcc80987e 361 {
mbed_official 610:813dcc80987e 362 case CRC_INPUTDATA_FORMAT_WORDS:
mbed_official 610:813dcc80987e 363 /* Enter 32-bit input data to the CRC calculator */
mbed_official 610:813dcc80987e 364 for(index = 0; index < BufferLength; index++)
mbed_official 610:813dcc80987e 365 {
mbed_official 610:813dcc80987e 366 hcrc->Instance->DR = pBuffer[index];
mbed_official 610:813dcc80987e 367 }
mbed_official 610:813dcc80987e 368 temp = hcrc->Instance->DR;
mbed_official 610:813dcc80987e 369 break;
mbed_official 610:813dcc80987e 370
mbed_official 610:813dcc80987e 371 case CRC_INPUTDATA_FORMAT_BYTES:
mbed_official 610:813dcc80987e 372 /* Specific 8-bit input data handling */
mbed_official 610:813dcc80987e 373 temp = CRC_Handle_8(hcrc, (uint8_t*)pBuffer, BufferLength);
mbed_official 610:813dcc80987e 374 break;
mbed_official 610:813dcc80987e 375
mbed_official 610:813dcc80987e 376 case CRC_INPUTDATA_FORMAT_HALFWORDS:
mbed_official 610:813dcc80987e 377 /* Specific 16-bit input data handling */
mbed_official 610:813dcc80987e 378 temp = CRC_Handle_16(hcrc, (uint16_t*)pBuffer, BufferLength);
mbed_official 610:813dcc80987e 379 break;
mbed_official 610:813dcc80987e 380
mbed_official 610:813dcc80987e 381 default:
mbed_official 610:813dcc80987e 382 break;
mbed_official 610:813dcc80987e 383 }
mbed_official 610:813dcc80987e 384
mbed_official 610:813dcc80987e 385 /* Change CRC peripheral state */
mbed_official 610:813dcc80987e 386 hcrc->State = HAL_CRC_STATE_READY;
mbed_official 610:813dcc80987e 387
mbed_official 610:813dcc80987e 388 /* Process unlocked */
mbed_official 610:813dcc80987e 389 __HAL_UNLOCK(hcrc);
mbed_official 610:813dcc80987e 390
mbed_official 610:813dcc80987e 391 /* Return the CRC computed value */
mbed_official 610:813dcc80987e 392 return temp;
mbed_official 610:813dcc80987e 393 }
mbed_official 610:813dcc80987e 394
mbed_official 610:813dcc80987e 395 /**
mbed_official 610:813dcc80987e 396 * @}
mbed_official 610:813dcc80987e 397 */
mbed_official 610:813dcc80987e 398
mbed_official 610:813dcc80987e 399 /** @defgroup CRC_Exported_Functions_Group3 Peripheral State functions
mbed_official 610:813dcc80987e 400 * @brief Peripheral State functions.
mbed_official 610:813dcc80987e 401 *
mbed_official 610:813dcc80987e 402 @verbatim
mbed_official 610:813dcc80987e 403 ===============================================================================
mbed_official 610:813dcc80987e 404 ##### Peripheral State functions #####
mbed_official 610:813dcc80987e 405 ===============================================================================
mbed_official 610:813dcc80987e 406 [..]
mbed_official 610:813dcc80987e 407 This subsection permits to get in run-time the status of the peripheral.
mbed_official 610:813dcc80987e 408
mbed_official 610:813dcc80987e 409 @endverbatim
mbed_official 610:813dcc80987e 410 * @{
mbed_official 610:813dcc80987e 411 */
mbed_official 610:813dcc80987e 412
mbed_official 610:813dcc80987e 413 /**
mbed_official 610:813dcc80987e 414 * @brief Returns the CRC handle state.
mbed_official 610:813dcc80987e 415 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 416 * @retval HAL state
mbed_official 610:813dcc80987e 417 */
mbed_official 610:813dcc80987e 418 HAL_CRC_StateTypeDef HAL_CRC_GetState(CRC_HandleTypeDef *hcrc)
mbed_official 610:813dcc80987e 419 {
mbed_official 610:813dcc80987e 420 /* Return CRC handle state */
mbed_official 610:813dcc80987e 421 return hcrc->State;
mbed_official 610:813dcc80987e 422 }
mbed_official 610:813dcc80987e 423
mbed_official 610:813dcc80987e 424 /**
mbed_official 610:813dcc80987e 425 * @}
mbed_official 610:813dcc80987e 426 */
mbed_official 610:813dcc80987e 427
mbed_official 610:813dcc80987e 428 /**
mbed_official 610:813dcc80987e 429 * @}
mbed_official 610:813dcc80987e 430 */
mbed_official 610:813dcc80987e 431
mbed_official 610:813dcc80987e 432 /** @defgroup CRC_Private_Functions CRC Private Functions
mbed_official 610:813dcc80987e 433 * @{
mbed_official 610:813dcc80987e 434 */
mbed_official 610:813dcc80987e 435
mbed_official 610:813dcc80987e 436 /**
mbed_official 610:813dcc80987e 437 * @brief Enter 8-bit input data to the CRC calculator.
mbed_official 610:813dcc80987e 438 * Specific data handling to optimize processing time.
mbed_official 610:813dcc80987e 439 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 440 * @param pBuffer: pointer to the input data buffer
mbed_official 610:813dcc80987e 441 * @param BufferLength: input data buffer length
mbed_official 610:813dcc80987e 442 * @retval uint32_t CRC (returned value LSBs for CRC shorter than 32 bits)
mbed_official 610:813dcc80987e 443 */
mbed_official 610:813dcc80987e 444 static uint32_t CRC_Handle_8(CRC_HandleTypeDef *hcrc, uint8_t pBuffer[], uint32_t BufferLength)
mbed_official 610:813dcc80987e 445 {
mbed_official 610:813dcc80987e 446 uint32_t i = 0; /* input data buffer index */
mbed_official 610:813dcc80987e 447
mbed_official 610:813dcc80987e 448 /* Processing time optimization: 4 bytes are entered in a row with a single word write,
mbed_official 610:813dcc80987e 449 * last bytes must be carefully fed to the CRC calculator to ensure a correct type
mbed_official 610:813dcc80987e 450 * handling by the IP */
mbed_official 610:813dcc80987e 451 for(i = 0; i < (BufferLength/4); i++)
mbed_official 610:813dcc80987e 452 {
mbed_official 610:813dcc80987e 453 hcrc->Instance->DR = ((uint32_t)pBuffer[4*i]<<24) | ((uint32_t)pBuffer[4*i+1]<<16) | ((uint32_t)pBuffer[4*i+2]<<8) | (uint32_t)pBuffer[4*i+3];
mbed_official 610:813dcc80987e 454 }
mbed_official 610:813dcc80987e 455 /* last bytes specific handling */
mbed_official 610:813dcc80987e 456 if ((BufferLength%4) != 0)
mbed_official 610:813dcc80987e 457 {
mbed_official 610:813dcc80987e 458 if (BufferLength%4 == 1)
mbed_official 610:813dcc80987e 459 {
mbed_official 610:813dcc80987e 460 *(uint8_t volatile*) (&hcrc->Instance->DR) = pBuffer[4*i];
mbed_official 610:813dcc80987e 461 }
mbed_official 610:813dcc80987e 462 if (BufferLength%4 == 2)
mbed_official 610:813dcc80987e 463 {
mbed_official 610:813dcc80987e 464 *(uint16_t volatile*) (&hcrc->Instance->DR) = ((uint32_t)pBuffer[4*i]<<8) | (uint32_t)pBuffer[4*i+1];
mbed_official 610:813dcc80987e 465 }
mbed_official 610:813dcc80987e 466 if (BufferLength%4 == 3)
mbed_official 610:813dcc80987e 467 {
mbed_official 610:813dcc80987e 468 *(uint16_t volatile*) (&hcrc->Instance->DR) = ((uint32_t)pBuffer[4*i]<<8) | (uint32_t)pBuffer[4*i+1];
mbed_official 610:813dcc80987e 469 *(uint8_t volatile*) (&hcrc->Instance->DR) = pBuffer[4*i+2];
mbed_official 610:813dcc80987e 470 }
mbed_official 610:813dcc80987e 471 }
mbed_official 610:813dcc80987e 472
mbed_official 610:813dcc80987e 473 /* Return the CRC computed value */
mbed_official 610:813dcc80987e 474 return hcrc->Instance->DR;
mbed_official 610:813dcc80987e 475 }
mbed_official 610:813dcc80987e 476
mbed_official 610:813dcc80987e 477
mbed_official 610:813dcc80987e 478
mbed_official 610:813dcc80987e 479 /**
mbed_official 610:813dcc80987e 480 * @brief Enter 16-bit input data to the CRC calculator.
mbed_official 610:813dcc80987e 481 * Specific data handling to optimize processing time.
mbed_official 610:813dcc80987e 482 * @param hcrc: CRC handle
mbed_official 610:813dcc80987e 483 * @param pBuffer: pointer to the input data buffer
mbed_official 610:813dcc80987e 484 * @param BufferLength: input data buffer length
mbed_official 610:813dcc80987e 485 * @retval uint32_t CRC (returned value LSBs for CRC shorter than 32 bits)
mbed_official 610:813dcc80987e 486 */
mbed_official 610:813dcc80987e 487 static uint32_t CRC_Handle_16(CRC_HandleTypeDef *hcrc, uint16_t pBuffer[], uint32_t BufferLength)
mbed_official 610:813dcc80987e 488 {
mbed_official 610:813dcc80987e 489 uint32_t i = 0; /* input data buffer index */
mbed_official 610:813dcc80987e 490
mbed_official 610:813dcc80987e 491 /* Processing time optimization: 2 HalfWords are entered in a row with a single word write,
mbed_official 610:813dcc80987e 492 * in case of odd length, last HalfWord must be carefully fed to the CRC calculator to ensure
mbed_official 610:813dcc80987e 493 * a correct type handling by the IP */
mbed_official 610:813dcc80987e 494 for(i = 0; i < (BufferLength/2); i++)
mbed_official 610:813dcc80987e 495 {
mbed_official 610:813dcc80987e 496 hcrc->Instance->DR = ((uint32_t)pBuffer[2*i]<<16) | (uint32_t)pBuffer[2*i+1];
mbed_official 610:813dcc80987e 497 }
mbed_official 610:813dcc80987e 498 if ((BufferLength%2) != 0)
mbed_official 610:813dcc80987e 499 {
mbed_official 610:813dcc80987e 500 *(uint16_t volatile*) (&hcrc->Instance->DR) = pBuffer[2*i];
mbed_official 610:813dcc80987e 501 }
mbed_official 610:813dcc80987e 502
mbed_official 610:813dcc80987e 503 /* Return the CRC computed value */
mbed_official 610:813dcc80987e 504 return hcrc->Instance->DR;
mbed_official 610:813dcc80987e 505 }
mbed_official 610:813dcc80987e 506
mbed_official 610:813dcc80987e 507 /**
mbed_official 610:813dcc80987e 508 * @}
mbed_official 610:813dcc80987e 509 */
mbed_official 610:813dcc80987e 510
mbed_official 610:813dcc80987e 511 #endif /* HAL_CRC_MODULE_ENABLED */
mbed_official 610:813dcc80987e 512 /**
mbed_official 610:813dcc80987e 513 * @}
mbed_official 610:813dcc80987e 514 */
mbed_official 610:813dcc80987e 515
mbed_official 610:813dcc80987e 516 /**
mbed_official 610:813dcc80987e 517 * @}
mbed_official 610:813dcc80987e 518 */
mbed_official 610:813dcc80987e 519
mbed_official 610:813dcc80987e 520 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/