mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

cmsis/BUILD/mbed/TARGET_DISCO_L496AG/TOOLCHAIN_ARM_STD/stm32l4xx_ll_crc.h@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

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