siva surendar / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_crc.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
113:b3775bf36a83
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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