en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

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

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