mbed official / mbed

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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_L4R5ZI_P/TOOLCHAIN_ARM_STD/stm32l4xx_ll_crc.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 172:65be27845400 1 /**
AnnaBridge 172:65be27845400 2 ******************************************************************************
AnnaBridge 172:65be27845400 3 * @file stm32l4xx_ll_crc.h
AnnaBridge 172:65be27845400 4 * @author MCD Application Team
AnnaBridge 172:65be27845400 5 * @brief Header file of CRC LL module.
AnnaBridge 172:65be27845400 6 ******************************************************************************
AnnaBridge 172:65be27845400 7 * @attention
AnnaBridge 172:65be27845400 8 *
AnnaBridge 172:65be27845400 9 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
AnnaBridge 172:65be27845400 10 *
AnnaBridge 172:65be27845400 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 172:65be27845400 12 * are permitted provided that the following conditions are met:
AnnaBridge 172:65be27845400 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 172:65be27845400 14 * this list of conditions and the following disclaimer.
AnnaBridge 172:65be27845400 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 172:65be27845400 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 172:65be27845400 17 * and/or other materials provided with the distribution.
AnnaBridge 172:65be27845400 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 172:65be27845400 19 * may be used to endorse or promote products derived from this software
AnnaBridge 172:65be27845400 20 * without specific prior written permission.
AnnaBridge 172:65be27845400 21 *
AnnaBridge 172:65be27845400 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 172:65be27845400 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 172:65be27845400 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 172:65be27845400 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 172:65be27845400 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 172:65be27845400 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 172:65be27845400 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 172:65be27845400 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 172:65be27845400 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 172:65be27845400 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 172:65be27845400 32 *
AnnaBridge 172:65be27845400 33 ******************************************************************************
AnnaBridge 172:65be27845400 34 */
AnnaBridge 172:65be27845400 35
AnnaBridge 172:65be27845400 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 172:65be27845400 37 #ifndef __STM32L4xx_LL_CRC_H
AnnaBridge 172:65be27845400 38 #define __STM32L4xx_LL_CRC_H
AnnaBridge 172:65be27845400 39
AnnaBridge 172:65be27845400 40 #ifdef __cplusplus
AnnaBridge 172:65be27845400 41 extern "C" {
AnnaBridge 172:65be27845400 42 #endif
AnnaBridge 172:65be27845400 43
AnnaBridge 172:65be27845400 44 /* Includes ------------------------------------------------------------------*/
AnnaBridge 172:65be27845400 45 #include "stm32l4xx.h"
AnnaBridge 172:65be27845400 46
AnnaBridge 172:65be27845400 47 /** @addtogroup STM32L4xx_LL_Driver
AnnaBridge 172:65be27845400 48 * @{
AnnaBridge 172:65be27845400 49 */
AnnaBridge 172:65be27845400 50
AnnaBridge 172:65be27845400 51 #if defined(CRC)
AnnaBridge 172:65be27845400 52
AnnaBridge 172:65be27845400 53 /** @defgroup CRC_LL CRC
AnnaBridge 172:65be27845400 54 * @{
AnnaBridge 172:65be27845400 55 */
AnnaBridge 172:65be27845400 56
AnnaBridge 172:65be27845400 57 /* Private types -------------------------------------------------------------*/
AnnaBridge 172:65be27845400 58 /* Private variables ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 59 /* Private constants ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 60 /* Private macros ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 61
AnnaBridge 172:65be27845400 62 /* Exported types ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 63 /* Exported constants --------------------------------------------------------*/
AnnaBridge 172:65be27845400 64 /** @defgroup CRC_LL_Exported_Constants CRC Exported Constants
AnnaBridge 172:65be27845400 65 * @{
AnnaBridge 172:65be27845400 66 */
AnnaBridge 172:65be27845400 67
AnnaBridge 172:65be27845400 68 /** @defgroup CRC_LL_EC_POLYLENGTH Polynomial length
AnnaBridge 172:65be27845400 69 * @{
AnnaBridge 172:65be27845400 70 */
AnnaBridge 172:65be27845400 71 #define LL_CRC_POLYLENGTH_32B 0x00000000U /*!< 32 bits Polynomial size */
AnnaBridge 172:65be27845400 72 #define LL_CRC_POLYLENGTH_16B CRC_CR_POLYSIZE_0 /*!< 16 bits Polynomial size */
AnnaBridge 172:65be27845400 73 #define LL_CRC_POLYLENGTH_8B CRC_CR_POLYSIZE_1 /*!< 8 bits Polynomial size */
AnnaBridge 172:65be27845400 74 #define LL_CRC_POLYLENGTH_7B (CRC_CR_POLYSIZE_1 | CRC_CR_POLYSIZE_0) /*!< 7 bits Polynomial size */
AnnaBridge 172:65be27845400 75 /**
AnnaBridge 172:65be27845400 76 * @}
AnnaBridge 172:65be27845400 77 */
AnnaBridge 172:65be27845400 78
AnnaBridge 172:65be27845400 79 /** @defgroup CRC_LL_EC_INDATA_REVERSE Input Data Reverse
AnnaBridge 172:65be27845400 80 * @{
AnnaBridge 172:65be27845400 81 */
AnnaBridge 172:65be27845400 82 #define LL_CRC_INDATA_REVERSE_NONE 0x00000000U /*!< Input Data bit order not affected */
AnnaBridge 172:65be27845400 83 #define LL_CRC_INDATA_REVERSE_BYTE CRC_CR_REV_IN_0 /*!< Input Data bit reversal done by byte */
AnnaBridge 172:65be27845400 84 #define LL_CRC_INDATA_REVERSE_HALFWORD CRC_CR_REV_IN_1 /*!< Input Data bit reversal done by half-word */
AnnaBridge 172:65be27845400 85 #define LL_CRC_INDATA_REVERSE_WORD (CRC_CR_REV_IN_1 | CRC_CR_REV_IN_0) /*!< Input Data bit reversal done by word */
AnnaBridge 172:65be27845400 86 /**
AnnaBridge 172:65be27845400 87 * @}
AnnaBridge 172:65be27845400 88 */
AnnaBridge 172:65be27845400 89
AnnaBridge 172:65be27845400 90 /** @defgroup CRC_LL_EC_OUTDATA_REVERSE Output Data Reverse
AnnaBridge 172:65be27845400 91 * @{
AnnaBridge 172:65be27845400 92 */
AnnaBridge 172:65be27845400 93 #define LL_CRC_OUTDATA_REVERSE_NONE 0x00000000U /*!< Output Data bit order not affected */
AnnaBridge 172:65be27845400 94 #define LL_CRC_OUTDATA_REVERSE_BIT CRC_CR_REV_OUT /*!< Output Data bit reversal done by bit */
AnnaBridge 172:65be27845400 95 /**
AnnaBridge 172:65be27845400 96 * @}
AnnaBridge 172:65be27845400 97 */
AnnaBridge 172:65be27845400 98
AnnaBridge 172:65be27845400 99 /** @defgroup CRC_LL_EC_Default_Polynomial_Value Default CRC generating polynomial value
AnnaBridge 172:65be27845400 100 * @brief Normal representation of this polynomial value is
AnnaBridge 172:65be27845400 101 * X^32 + X^26 + X^23 + X^22 + X^16 + X^12 + X^11 + X^10 +X^8 + X^7 + X^5 + X^4 + X^2 + X + 1 .
AnnaBridge 172:65be27845400 102 * @{
AnnaBridge 172:65be27845400 103 */
AnnaBridge 172:65be27845400 104 #define LL_CRC_DEFAULT_CRC32_POLY 0x04C11DB7U /*!< Default CRC generating polynomial value */
AnnaBridge 172:65be27845400 105 /**
AnnaBridge 172:65be27845400 106 * @}
AnnaBridge 172:65be27845400 107 */
AnnaBridge 172:65be27845400 108
AnnaBridge 172:65be27845400 109 /** @defgroup CRC_LL_EC_Default_InitValue Default CRC computation initialization value
AnnaBridge 172:65be27845400 110 * @{
AnnaBridge 172:65be27845400 111 */
AnnaBridge 172:65be27845400 112 #define LL_CRC_DEFAULT_CRC_INITVALUE 0xFFFFFFFFU /*!< Default CRC computation initialization value */
AnnaBridge 172:65be27845400 113 /**
AnnaBridge 172:65be27845400 114 * @}
AnnaBridge 172:65be27845400 115 */
AnnaBridge 172:65be27845400 116
AnnaBridge 172:65be27845400 117 /**
AnnaBridge 172:65be27845400 118 * @}
AnnaBridge 172:65be27845400 119 */
AnnaBridge 172:65be27845400 120
AnnaBridge 172:65be27845400 121 /* Exported macro ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 122 /** @defgroup CRC_LL_Exported_Macros CRC Exported Macros
AnnaBridge 172:65be27845400 123 * @{
AnnaBridge 172:65be27845400 124 */
AnnaBridge 172:65be27845400 125
AnnaBridge 172:65be27845400 126 /** @defgroup CRC_LL_EM_WRITE_READ Common Write and read registers Macros
AnnaBridge 172:65be27845400 127 * @{
AnnaBridge 172:65be27845400 128 */
AnnaBridge 172:65be27845400 129
AnnaBridge 172:65be27845400 130 /**
AnnaBridge 172:65be27845400 131 * @brief Write a value in CRC register
AnnaBridge 172:65be27845400 132 * @param __INSTANCE__ CRC Instance
AnnaBridge 172:65be27845400 133 * @param __REG__ Register to be written
AnnaBridge 172:65be27845400 134 * @param __VALUE__ Value to be written in the register
AnnaBridge 172:65be27845400 135 * @retval None
AnnaBridge 172:65be27845400 136 */
AnnaBridge 172:65be27845400 137 #define LL_CRC_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, __VALUE__)
AnnaBridge 172:65be27845400 138
AnnaBridge 172:65be27845400 139 /**
AnnaBridge 172:65be27845400 140 * @brief Read a value in CRC register
AnnaBridge 172:65be27845400 141 * @param __INSTANCE__ CRC Instance
AnnaBridge 172:65be27845400 142 * @param __REG__ Register to be read
AnnaBridge 172:65be27845400 143 * @retval Register value
AnnaBridge 172:65be27845400 144 */
AnnaBridge 172:65be27845400 145 #define LL_CRC_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
AnnaBridge 172:65be27845400 146 /**
AnnaBridge 172:65be27845400 147 * @}
AnnaBridge 172:65be27845400 148 */
AnnaBridge 172:65be27845400 149
AnnaBridge 172:65be27845400 150 /**
AnnaBridge 172:65be27845400 151 * @}
AnnaBridge 172:65be27845400 152 */
AnnaBridge 172:65be27845400 153
AnnaBridge 172:65be27845400 154
AnnaBridge 172:65be27845400 155 /* Exported functions --------------------------------------------------------*/
AnnaBridge 172:65be27845400 156 /** @defgroup CRC_LL_Exported_Functions CRC Exported Functions
AnnaBridge 172:65be27845400 157 * @{
AnnaBridge 172:65be27845400 158 */
AnnaBridge 172:65be27845400 159
AnnaBridge 172:65be27845400 160 /** @defgroup CRC_LL_EF_Configuration CRC Configuration functions
AnnaBridge 172:65be27845400 161 * @{
AnnaBridge 172:65be27845400 162 */
AnnaBridge 172:65be27845400 163
AnnaBridge 172:65be27845400 164 /**
AnnaBridge 172:65be27845400 165 * @brief Reset the CRC calculation unit.
AnnaBridge 172:65be27845400 166 * @note If Programmable Initial CRC value feature
AnnaBridge 172:65be27845400 167 * is available, also set the Data Register to the value stored in the
AnnaBridge 172:65be27845400 168 * CRC_INIT register, otherwise, reset Data Register to its default value.
AnnaBridge 172:65be27845400 169 * @rmtoll CR RESET LL_CRC_ResetCRCCalculationUnit
AnnaBridge 172:65be27845400 170 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 171 * @retval None
AnnaBridge 172:65be27845400 172 */
AnnaBridge 172:65be27845400 173 __STATIC_INLINE void LL_CRC_ResetCRCCalculationUnit(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 174 {
AnnaBridge 172:65be27845400 175 SET_BIT(CRCx->CR, CRC_CR_RESET);
AnnaBridge 172:65be27845400 176 }
AnnaBridge 172:65be27845400 177
AnnaBridge 172:65be27845400 178 /**
AnnaBridge 172:65be27845400 179 * @brief Configure size of the polynomial.
AnnaBridge 172:65be27845400 180 * @rmtoll CR POLYSIZE LL_CRC_SetPolynomialSize
AnnaBridge 172:65be27845400 181 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 182 * @param PolySize This parameter can be one of the following values:
AnnaBridge 172:65be27845400 183 * @arg @ref LL_CRC_POLYLENGTH_32B
AnnaBridge 172:65be27845400 184 * @arg @ref LL_CRC_POLYLENGTH_16B
AnnaBridge 172:65be27845400 185 * @arg @ref LL_CRC_POLYLENGTH_8B
AnnaBridge 172:65be27845400 186 * @arg @ref LL_CRC_POLYLENGTH_7B
AnnaBridge 172:65be27845400 187 * @retval None
AnnaBridge 172:65be27845400 188 */
AnnaBridge 172:65be27845400 189 __STATIC_INLINE void LL_CRC_SetPolynomialSize(CRC_TypeDef *CRCx, uint32_t PolySize)
AnnaBridge 172:65be27845400 190 {
AnnaBridge 172:65be27845400 191 MODIFY_REG(CRCx->CR, CRC_CR_POLYSIZE, PolySize);
AnnaBridge 172:65be27845400 192 }
AnnaBridge 172:65be27845400 193
AnnaBridge 172:65be27845400 194 /**
AnnaBridge 172:65be27845400 195 * @brief Return size of the polynomial.
AnnaBridge 172:65be27845400 196 * @rmtoll CR POLYSIZE LL_CRC_GetPolynomialSize
AnnaBridge 172:65be27845400 197 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 198 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 199 * @arg @ref LL_CRC_POLYLENGTH_32B
AnnaBridge 172:65be27845400 200 * @arg @ref LL_CRC_POLYLENGTH_16B
AnnaBridge 172:65be27845400 201 * @arg @ref LL_CRC_POLYLENGTH_8B
AnnaBridge 172:65be27845400 202 * @arg @ref LL_CRC_POLYLENGTH_7B
AnnaBridge 172:65be27845400 203 */
AnnaBridge 172:65be27845400 204 __STATIC_INLINE uint32_t LL_CRC_GetPolynomialSize(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 205 {
AnnaBridge 172:65be27845400 206 return (uint32_t)(READ_BIT(CRCx->CR, CRC_CR_POLYSIZE));
AnnaBridge 172:65be27845400 207 }
AnnaBridge 172:65be27845400 208
AnnaBridge 172:65be27845400 209 /**
AnnaBridge 172:65be27845400 210 * @brief Configure the reversal of the bit order of the input data
AnnaBridge 172:65be27845400 211 * @rmtoll CR REV_IN LL_CRC_SetInputDataReverseMode
AnnaBridge 172:65be27845400 212 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 213 * @param ReverseMode This parameter can be one of the following values:
AnnaBridge 172:65be27845400 214 * @arg @ref LL_CRC_INDATA_REVERSE_NONE
AnnaBridge 172:65be27845400 215 * @arg @ref LL_CRC_INDATA_REVERSE_BYTE
AnnaBridge 172:65be27845400 216 * @arg @ref LL_CRC_INDATA_REVERSE_HALFWORD
AnnaBridge 172:65be27845400 217 * @arg @ref LL_CRC_INDATA_REVERSE_WORD
AnnaBridge 172:65be27845400 218 * @retval None
AnnaBridge 172:65be27845400 219 */
AnnaBridge 172:65be27845400 220 __STATIC_INLINE void LL_CRC_SetInputDataReverseMode(CRC_TypeDef *CRCx, uint32_t ReverseMode)
AnnaBridge 172:65be27845400 221 {
AnnaBridge 172:65be27845400 222 MODIFY_REG(CRCx->CR, CRC_CR_REV_IN, ReverseMode);
AnnaBridge 172:65be27845400 223 }
AnnaBridge 172:65be27845400 224
AnnaBridge 172:65be27845400 225 /**
AnnaBridge 172:65be27845400 226 * @brief Return type of reversal for input data bit order
AnnaBridge 172:65be27845400 227 * @rmtoll CR REV_IN LL_CRC_GetInputDataReverseMode
AnnaBridge 172:65be27845400 228 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 229 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 230 * @arg @ref LL_CRC_INDATA_REVERSE_NONE
AnnaBridge 172:65be27845400 231 * @arg @ref LL_CRC_INDATA_REVERSE_BYTE
AnnaBridge 172:65be27845400 232 * @arg @ref LL_CRC_INDATA_REVERSE_HALFWORD
AnnaBridge 172:65be27845400 233 * @arg @ref LL_CRC_INDATA_REVERSE_WORD
AnnaBridge 172:65be27845400 234 */
AnnaBridge 172:65be27845400 235 __STATIC_INLINE uint32_t LL_CRC_GetInputDataReverseMode(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 236 {
AnnaBridge 172:65be27845400 237 return (uint32_t)(READ_BIT(CRCx->CR, CRC_CR_REV_IN));
AnnaBridge 172:65be27845400 238 }
AnnaBridge 172:65be27845400 239
AnnaBridge 172:65be27845400 240 /**
AnnaBridge 172:65be27845400 241 * @brief Configure the reversal of the bit order of the Output data
AnnaBridge 172:65be27845400 242 * @rmtoll CR REV_OUT LL_CRC_SetOutputDataReverseMode
AnnaBridge 172:65be27845400 243 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 244 * @param ReverseMode This parameter can be one of the following values:
AnnaBridge 172:65be27845400 245 * @arg @ref LL_CRC_OUTDATA_REVERSE_NONE
AnnaBridge 172:65be27845400 246 * @arg @ref LL_CRC_OUTDATA_REVERSE_BIT
AnnaBridge 172:65be27845400 247 * @retval None
AnnaBridge 172:65be27845400 248 */
AnnaBridge 172:65be27845400 249 __STATIC_INLINE void LL_CRC_SetOutputDataReverseMode(CRC_TypeDef *CRCx, uint32_t ReverseMode)
AnnaBridge 172:65be27845400 250 {
AnnaBridge 172:65be27845400 251 MODIFY_REG(CRCx->CR, CRC_CR_REV_OUT, ReverseMode);
AnnaBridge 172:65be27845400 252 }
AnnaBridge 172:65be27845400 253
AnnaBridge 172:65be27845400 254 /**
AnnaBridge 172:65be27845400 255 * @brief Configure the reversal of the bit order of the Output data
AnnaBridge 172:65be27845400 256 * @rmtoll CR REV_OUT LL_CRC_GetOutputDataReverseMode
AnnaBridge 172:65be27845400 257 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 258 * @retval Returned value can be one of the following values:
AnnaBridge 172:65be27845400 259 * @arg @ref LL_CRC_OUTDATA_REVERSE_NONE
AnnaBridge 172:65be27845400 260 * @arg @ref LL_CRC_OUTDATA_REVERSE_BIT
AnnaBridge 172:65be27845400 261 */
AnnaBridge 172:65be27845400 262 __STATIC_INLINE uint32_t LL_CRC_GetOutputDataReverseMode(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 263 {
AnnaBridge 172:65be27845400 264 return (uint32_t)(READ_BIT(CRCx->CR, CRC_CR_REV_OUT));
AnnaBridge 172:65be27845400 265 }
AnnaBridge 172:65be27845400 266
AnnaBridge 172:65be27845400 267 /**
AnnaBridge 172:65be27845400 268 * @brief Initialize the Programmable initial CRC value.
AnnaBridge 172:65be27845400 269 * @note If the CRC size is less than 32 bits, the least significant bits
AnnaBridge 172:65be27845400 270 * are used to write the correct value
AnnaBridge 172:65be27845400 271 * @note LL_CRC_DEFAULT_CRC_INITVALUE could be used as value for InitCrc parameter.
AnnaBridge 172:65be27845400 272 * @rmtoll INIT INIT LL_CRC_SetInitialData
AnnaBridge 172:65be27845400 273 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 274 * @param InitCrc Value to be programmed in Programmable initial CRC value register
AnnaBridge 172:65be27845400 275 * @retval None
AnnaBridge 172:65be27845400 276 */
AnnaBridge 172:65be27845400 277 __STATIC_INLINE void LL_CRC_SetInitialData(CRC_TypeDef *CRCx, uint32_t InitCrc)
AnnaBridge 172:65be27845400 278 {
AnnaBridge 172:65be27845400 279 WRITE_REG(CRCx->INIT, InitCrc);
AnnaBridge 172:65be27845400 280 }
AnnaBridge 172:65be27845400 281
AnnaBridge 172:65be27845400 282 /**
AnnaBridge 172:65be27845400 283 * @brief Return current Initial CRC value.
AnnaBridge 172:65be27845400 284 * @note If the CRC size is less than 32 bits, the least significant bits
AnnaBridge 172:65be27845400 285 * are used to read the correct value
AnnaBridge 172:65be27845400 286 * @rmtoll INIT INIT LL_CRC_GetInitialData
AnnaBridge 172:65be27845400 287 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 288 * @retval Value programmed in Programmable initial CRC value register
AnnaBridge 172:65be27845400 289 */
AnnaBridge 172:65be27845400 290 __STATIC_INLINE uint32_t LL_CRC_GetInitialData(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 291 {
AnnaBridge 172:65be27845400 292 return (uint32_t)(READ_REG(CRCx->INIT));
AnnaBridge 172:65be27845400 293 }
AnnaBridge 172:65be27845400 294
AnnaBridge 172:65be27845400 295 /**
AnnaBridge 172:65be27845400 296 * @brief Initialize the Programmable polynomial value
AnnaBridge 172:65be27845400 297 * (coefficients of the polynomial to be used for CRC calculation).
AnnaBridge 172:65be27845400 298 * @note LL_CRC_DEFAULT_CRC32_POLY could be used as value for PolynomCoef parameter.
AnnaBridge 172:65be27845400 299 * @note Please check Reference Manual and existing Errata Sheets,
AnnaBridge 172:65be27845400 300 * regarding possible limitations for Polynomial values usage.
AnnaBridge 172:65be27845400 301 * For example, for a polynomial of degree 7, X^7 + X^6 + X^5 + X^2 + 1 is written 0x65
AnnaBridge 172:65be27845400 302 * @rmtoll POL POL LL_CRC_SetPolynomialCoef
AnnaBridge 172:65be27845400 303 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 304 * @param PolynomCoef Value to be programmed in Programmable Polynomial value register
AnnaBridge 172:65be27845400 305 * @retval None
AnnaBridge 172:65be27845400 306 */
AnnaBridge 172:65be27845400 307 __STATIC_INLINE void LL_CRC_SetPolynomialCoef(CRC_TypeDef *CRCx, uint32_t PolynomCoef)
AnnaBridge 172:65be27845400 308 {
AnnaBridge 172:65be27845400 309 WRITE_REG(CRCx->POL, PolynomCoef);
AnnaBridge 172:65be27845400 310 }
AnnaBridge 172:65be27845400 311
AnnaBridge 172:65be27845400 312 /**
AnnaBridge 172:65be27845400 313 * @brief Return current Programmable polynomial value
AnnaBridge 172:65be27845400 314 * @note Please check Reference Manual and existing Errata Sheets,
AnnaBridge 172:65be27845400 315 * regarding possible limitations for Polynomial values usage.
AnnaBridge 172:65be27845400 316 * For example, for a polynomial of degree 7, X^7 + X^6 + X^5 + X^2 + 1 is written 0x65
AnnaBridge 172:65be27845400 317 * @rmtoll POL POL LL_CRC_GetPolynomialCoef
AnnaBridge 172:65be27845400 318 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 319 * @retval Value programmed in Programmable Polynomial value register
AnnaBridge 172:65be27845400 320 */
AnnaBridge 172:65be27845400 321 __STATIC_INLINE uint32_t LL_CRC_GetPolynomialCoef(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 322 {
AnnaBridge 172:65be27845400 323 return (uint32_t)(READ_REG(CRCx->POL));
AnnaBridge 172:65be27845400 324 }
AnnaBridge 172:65be27845400 325
AnnaBridge 172:65be27845400 326 /**
AnnaBridge 172:65be27845400 327 * @}
AnnaBridge 172:65be27845400 328 */
AnnaBridge 172:65be27845400 329
AnnaBridge 172:65be27845400 330 /** @defgroup CRC_LL_EF_Data_Management Data_Management
AnnaBridge 172:65be27845400 331 * @{
AnnaBridge 172:65be27845400 332 */
AnnaBridge 172:65be27845400 333
AnnaBridge 172:65be27845400 334 /**
AnnaBridge 172:65be27845400 335 * @brief Write given 32-bit data to the CRC calculator
AnnaBridge 172:65be27845400 336 * @rmtoll DR DR LL_CRC_FeedData32
AnnaBridge 172:65be27845400 337 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 338 * @param InData value to be provided to CRC calculator between between Min_Data=0 and Max_Data=0xFFFFFFFF
AnnaBridge 172:65be27845400 339 * @retval None
AnnaBridge 172:65be27845400 340 */
AnnaBridge 172:65be27845400 341 __STATIC_INLINE void LL_CRC_FeedData32(CRC_TypeDef *CRCx, uint32_t InData)
AnnaBridge 172:65be27845400 342 {
AnnaBridge 172:65be27845400 343 WRITE_REG(CRCx->DR, InData);
AnnaBridge 172:65be27845400 344 }
AnnaBridge 172:65be27845400 345
AnnaBridge 172:65be27845400 346 /**
AnnaBridge 172:65be27845400 347 * @brief Write given 16-bit data to the CRC calculator
AnnaBridge 172:65be27845400 348 * @rmtoll DR DR LL_CRC_FeedData16
AnnaBridge 172:65be27845400 349 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 350 * @param InData 16 bit value to be provided to CRC calculator between between Min_Data=0 and Max_Data=0xFFFF
AnnaBridge 172:65be27845400 351 * @retval None
AnnaBridge 172:65be27845400 352 */
AnnaBridge 172:65be27845400 353 __STATIC_INLINE void LL_CRC_FeedData16(CRC_TypeDef *CRCx, uint16_t InData)
AnnaBridge 172:65be27845400 354 {
AnnaBridge 172:65be27845400 355 __IO uint16_t *pReg;
AnnaBridge 172:65be27845400 356
AnnaBridge 172:65be27845400 357 pReg = (__IO uint16_t *)(__IO void *)(&CRCx->DR);
AnnaBridge 172:65be27845400 358 *pReg = InData;
AnnaBridge 172:65be27845400 359 }
AnnaBridge 172:65be27845400 360
AnnaBridge 172:65be27845400 361 /**
AnnaBridge 172:65be27845400 362 * @brief Write given 8-bit data to the CRC calculator
AnnaBridge 172:65be27845400 363 * @rmtoll DR DR LL_CRC_FeedData8
AnnaBridge 172:65be27845400 364 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 365 * @param InData 8 bit value to be provided to CRC calculator between between Min_Data=0 and Max_Data=0xFF
AnnaBridge 172:65be27845400 366 * @retval None
AnnaBridge 172:65be27845400 367 */
AnnaBridge 172:65be27845400 368 __STATIC_INLINE void LL_CRC_FeedData8(CRC_TypeDef *CRCx, uint8_t InData)
AnnaBridge 172:65be27845400 369 {
AnnaBridge 172:65be27845400 370 *(uint8_t __IO *)(&CRCx->DR) = (uint8_t) InData;
AnnaBridge 172:65be27845400 371 }
AnnaBridge 172:65be27845400 372
AnnaBridge 172:65be27845400 373 /**
AnnaBridge 172:65be27845400 374 * @brief Return current CRC calculation result. 32 bits value is returned.
AnnaBridge 172:65be27845400 375 * @rmtoll DR DR LL_CRC_ReadData32
AnnaBridge 172:65be27845400 376 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 377 * @retval Current CRC calculation result as stored in CRC_DR register (32 bits).
AnnaBridge 172:65be27845400 378 */
AnnaBridge 172:65be27845400 379 __STATIC_INLINE uint32_t LL_CRC_ReadData32(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 380 {
AnnaBridge 172:65be27845400 381 return (uint32_t)(READ_REG(CRCx->DR));
AnnaBridge 172:65be27845400 382 }
AnnaBridge 172:65be27845400 383
AnnaBridge 172:65be27845400 384 /**
AnnaBridge 172:65be27845400 385 * @brief Return current CRC calculation result. 16 bits value is returned.
AnnaBridge 172:65be27845400 386 * @note This function is expected to be used in a 16 bits CRC polynomial size context.
AnnaBridge 172:65be27845400 387 * @rmtoll DR DR LL_CRC_ReadData16
AnnaBridge 172:65be27845400 388 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 389 * @retval Current CRC calculation result as stored in CRC_DR register (16 bits).
AnnaBridge 172:65be27845400 390 */
AnnaBridge 172:65be27845400 391 __STATIC_INLINE uint16_t LL_CRC_ReadData16(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 392 {
AnnaBridge 172:65be27845400 393 return (uint16_t)READ_REG(CRCx->DR);
AnnaBridge 172:65be27845400 394 }
AnnaBridge 172:65be27845400 395
AnnaBridge 172:65be27845400 396 /**
AnnaBridge 172:65be27845400 397 * @brief Return current CRC calculation result. 8 bits value is returned.
AnnaBridge 172:65be27845400 398 * @note This function is expected to be used in a 8 bits CRC polynomial size context.
AnnaBridge 172:65be27845400 399 * @rmtoll DR DR LL_CRC_ReadData8
AnnaBridge 172:65be27845400 400 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 401 * @retval Current CRC calculation result as stored in CRC_DR register (8 bits).
AnnaBridge 172:65be27845400 402 */
AnnaBridge 172:65be27845400 403 __STATIC_INLINE uint8_t LL_CRC_ReadData8(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 404 {
AnnaBridge 172:65be27845400 405 return (uint8_t)READ_REG(CRCx->DR);
AnnaBridge 172:65be27845400 406 }
AnnaBridge 172:65be27845400 407
AnnaBridge 172:65be27845400 408 /**
AnnaBridge 172:65be27845400 409 * @brief Return current CRC calculation result. 7 bits value is returned.
AnnaBridge 172:65be27845400 410 * @note This function is expected to be used in a 7 bits CRC polynomial size context.
AnnaBridge 172:65be27845400 411 * @rmtoll DR DR LL_CRC_ReadData7
AnnaBridge 172:65be27845400 412 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 413 * @retval Current CRC calculation result as stored in CRC_DR register (7 bits).
AnnaBridge 172:65be27845400 414 */
AnnaBridge 172:65be27845400 415 __STATIC_INLINE uint8_t LL_CRC_ReadData7(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 416 {
AnnaBridge 172:65be27845400 417 return (uint8_t)(READ_REG(CRCx->DR) & 0x7FU);
AnnaBridge 172:65be27845400 418 }
AnnaBridge 172:65be27845400 419
AnnaBridge 172:65be27845400 420 /**
AnnaBridge 172:65be27845400 421 * @brief Return data stored in the Independent Data(IDR) register.
AnnaBridge 172:65be27845400 422 * @note This register can be used as a temporary storage location.
AnnaBridge 172:65be27845400 423 * @note Refer to the Reference Manual to get the authorized data length in bits.
AnnaBridge 172:65be27845400 424 * @rmtoll IDR IDR LL_CRC_Read_IDR
AnnaBridge 172:65be27845400 425 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 426 * @retval Value stored in CRC_IDR register
AnnaBridge 172:65be27845400 427 */
AnnaBridge 172:65be27845400 428 __STATIC_INLINE uint32_t LL_CRC_Read_IDR(CRC_TypeDef *CRCx)
AnnaBridge 172:65be27845400 429 {
AnnaBridge 172:65be27845400 430 return (uint32_t)(READ_REG(CRCx->IDR));
AnnaBridge 172:65be27845400 431 }
AnnaBridge 172:65be27845400 432
AnnaBridge 172:65be27845400 433 /**
AnnaBridge 172:65be27845400 434 * @brief Store data in the Independent Data(IDR) register.
AnnaBridge 172:65be27845400 435 * @note This register can be used as a temporary storage location.
AnnaBridge 172:65be27845400 436 * @note Refer to the Reference Manual to get the authorized data length in bits.
AnnaBridge 172:65be27845400 437 * @rmtoll IDR IDR LL_CRC_Write_IDR
AnnaBridge 172:65be27845400 438 * @param CRCx CRC Instance
AnnaBridge 172:65be27845400 439 * @param InData value to be stored in CRC_IDR register
AnnaBridge 172:65be27845400 440 * @retval None
AnnaBridge 172:65be27845400 441 */
AnnaBridge 172:65be27845400 442 __STATIC_INLINE void LL_CRC_Write_IDR(CRC_TypeDef *CRCx, uint32_t InData)
AnnaBridge 172:65be27845400 443 {
AnnaBridge 172:65be27845400 444 #if (CRC_IDR_IDR == 0x0FFU)
AnnaBridge 172:65be27845400 445 *((uint8_t __IO *)(&CRCx->IDR)) = (uint8_t) InData;
AnnaBridge 172:65be27845400 446 #else
AnnaBridge 172:65be27845400 447 WRITE_REG(CRCx->IDR, InData);
AnnaBridge 172:65be27845400 448 #endif
AnnaBridge 172:65be27845400 449 }
AnnaBridge 172:65be27845400 450 /**
AnnaBridge 172:65be27845400 451 * @}
AnnaBridge 172:65be27845400 452 */
AnnaBridge 172:65be27845400 453
AnnaBridge 172:65be27845400 454 #if defined(USE_FULL_LL_DRIVER)
AnnaBridge 172:65be27845400 455 /** @defgroup CRC_LL_EF_Init Initialization and de-initialization functions
AnnaBridge 172:65be27845400 456 * @{
AnnaBridge 172:65be27845400 457 */
AnnaBridge 172:65be27845400 458
AnnaBridge 172:65be27845400 459 ErrorStatus LL_CRC_DeInit(CRC_TypeDef *CRCx);
AnnaBridge 172:65be27845400 460
AnnaBridge 172:65be27845400 461 /**
AnnaBridge 172:65be27845400 462 * @}
AnnaBridge 172:65be27845400 463 */
AnnaBridge 172:65be27845400 464 #endif /* USE_FULL_LL_DRIVER */
AnnaBridge 172:65be27845400 465
AnnaBridge 172:65be27845400 466 /**
AnnaBridge 172:65be27845400 467 * @}
AnnaBridge 172:65be27845400 468 */
AnnaBridge 172:65be27845400 469
AnnaBridge 172:65be27845400 470 /**
AnnaBridge 172:65be27845400 471 * @}
AnnaBridge 172:65be27845400 472 */
AnnaBridge 172:65be27845400 473
AnnaBridge 172:65be27845400 474 #endif /* defined(CRC) */
AnnaBridge 172:65be27845400 475
AnnaBridge 172:65be27845400 476 /**
AnnaBridge 172:65be27845400 477 * @}
AnnaBridge 172:65be27845400 478 */
AnnaBridge 172:65be27845400 479
AnnaBridge 172:65be27845400 480 #ifdef __cplusplus
AnnaBridge 172:65be27845400 481 }
AnnaBridge 172:65be27845400 482 #endif
AnnaBridge 172:65be27845400 483
AnnaBridge 172:65be27845400 484 #endif /* __STM32L4xx_LL_CRC_H */
AnnaBridge 172:65be27845400 485
AnnaBridge 172:65be27845400 486 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/