my fork

Dependents:   Nucleo_blueNRG

Fork of mbed by mbed official

Committer:
bogdanm
Date:
Wed Jun 11 15:14:05 2014 +0100
Revision:
85:024bf7f99721
Child:
92:4fc01daae5a5
Release 85 of the mbed library

Main changes:

- K64F Ethernet fixes
- Updated tests
- Fixes for various mbed targets
- Code cleanup: fixed warnings, more consistent code style
- GCC support for K64F

There is a known issue with the I2C interface on some ST targets. If you
find the I2C interface problematic on your ST board, please log a bug
against this on mbed.org.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 85:024bf7f99721 1 /**
bogdanm 85:024bf7f99721 2 ******************************************************************************
bogdanm 85:024bf7f99721 3 * @file stm32f0xx_hal_crc.h
bogdanm 85:024bf7f99721 4 * @author MCD Application Team
bogdanm 85:024bf7f99721 5 * @version V1.0.0
bogdanm 85:024bf7f99721 6 * @date 28-May-2014
bogdanm 85:024bf7f99721 7 * @brief Header file of CRC HAL module.
bogdanm 85:024bf7f99721 8 ******************************************************************************
bogdanm 85:024bf7f99721 9 * @attention
bogdanm 85:024bf7f99721 10 *
bogdanm 85:024bf7f99721 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
bogdanm 85:024bf7f99721 12 *
bogdanm 85:024bf7f99721 13 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 85:024bf7f99721 14 * are permitted provided that the following conditions are met:
bogdanm 85:024bf7f99721 15 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 85:024bf7f99721 16 * this list of conditions and the following disclaimer.
bogdanm 85:024bf7f99721 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 85:024bf7f99721 18 * this list of conditions and the following disclaimer in the documentation
bogdanm 85:024bf7f99721 19 * and/or other materials provided with the distribution.
bogdanm 85:024bf7f99721 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 85:024bf7f99721 21 * may be used to endorse or promote products derived from this software
bogdanm 85:024bf7f99721 22 * without specific prior written permission.
bogdanm 85:024bf7f99721 23 *
bogdanm 85:024bf7f99721 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 85:024bf7f99721 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 85:024bf7f99721 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 85:024bf7f99721 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 85:024bf7f99721 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 85:024bf7f99721 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 85:024bf7f99721 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 85:024bf7f99721 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 85:024bf7f99721 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 85:024bf7f99721 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 85:024bf7f99721 34 *
bogdanm 85:024bf7f99721 35 ******************************************************************************
bogdanm 85:024bf7f99721 36 */
bogdanm 85:024bf7f99721 37
bogdanm 85:024bf7f99721 38 /* Define to prevent recursive inclusion -------------------------------------*/
bogdanm 85:024bf7f99721 39 #ifndef __STM32F0xx_HAL_CRC_H
bogdanm 85:024bf7f99721 40 #define __STM32F0xx_HAL_CRC_H
bogdanm 85:024bf7f99721 41
bogdanm 85:024bf7f99721 42 #ifdef __cplusplus
bogdanm 85:024bf7f99721 43 extern "C" {
bogdanm 85:024bf7f99721 44 #endif
bogdanm 85:024bf7f99721 45
bogdanm 85:024bf7f99721 46 /* Includes ------------------------------------------------------------------*/
bogdanm 85:024bf7f99721 47 #include "stm32f0xx_hal_def.h"
bogdanm 85:024bf7f99721 48
bogdanm 85:024bf7f99721 49 /** @addtogroup STM32F0xx_HAL_Driver
bogdanm 85:024bf7f99721 50 * @{
bogdanm 85:024bf7f99721 51 */
bogdanm 85:024bf7f99721 52
bogdanm 85:024bf7f99721 53 /** @addtogroup CRC
bogdanm 85:024bf7f99721 54 * @{
bogdanm 85:024bf7f99721 55 */
bogdanm 85:024bf7f99721 56
bogdanm 85:024bf7f99721 57 /* Exported types ------------------------------------------------------------*/
bogdanm 85:024bf7f99721 58
bogdanm 85:024bf7f99721 59 /**
bogdanm 85:024bf7f99721 60 * @brief CRC HAL State Structure definition
bogdanm 85:024bf7f99721 61 */
bogdanm 85:024bf7f99721 62 typedef enum
bogdanm 85:024bf7f99721 63 {
bogdanm 85:024bf7f99721 64 HAL_CRC_STATE_RESET = 0x00, /*!< CRC not yet initialized or disabled */
bogdanm 85:024bf7f99721 65 HAL_CRC_STATE_READY = 0x01, /*!< CRC initialized and ready for use */
bogdanm 85:024bf7f99721 66 HAL_CRC_STATE_BUSY = 0x02, /*!< CRC internal process is ongoing */
bogdanm 85:024bf7f99721 67 HAL_CRC_STATE_TIMEOUT = 0x03, /*!< CRC timeout state */
bogdanm 85:024bf7f99721 68 HAL_CRC_STATE_ERROR = 0x04 /*!< CRC error state */
bogdanm 85:024bf7f99721 69 }HAL_CRC_StateTypeDef;
bogdanm 85:024bf7f99721 70
bogdanm 85:024bf7f99721 71
bogdanm 85:024bf7f99721 72 /**
bogdanm 85:024bf7f99721 73 * @brief CRC Init Structure definition
bogdanm 85:024bf7f99721 74 */
bogdanm 85:024bf7f99721 75 typedef struct
bogdanm 85:024bf7f99721 76 {
bogdanm 85:024bf7f99721 77 uint8_t DefaultPolynomialUse; /*!< This parameter is a value of @ref CRC_Default_Polynomial and indicates if default polynomial is used.
bogdanm 85:024bf7f99721 78 If set to DEFAULT_POLYNOMIAL_ENABLE, resort to default
bogdanm 85:024bf7f99721 79 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.
bogdanm 85:024bf7f99721 80 In that case, there is no need to set GeneratingPolynomial field.
bogdanm 85:024bf7f99721 81 If otherwise set to DEFAULT_POLYNOMIAL_DISABLE, GeneratingPolynomial and CRCLength fields must be set */
bogdanm 85:024bf7f99721 82
bogdanm 85:024bf7f99721 83 uint8_t DefaultInitValueUse; /*!< This parameter is a value of @ref CRC_Default_InitValue_Use and indicates if default init value is used.
bogdanm 85:024bf7f99721 84 If set to DEFAULT_INIT_VALUE_ENABLE, resort to default
bogdanm 85:024bf7f99721 85 0xFFFFFFFF value. In that case, there is no need to set InitValue field.
bogdanm 85:024bf7f99721 86 If otherwise set to DEFAULT_INIT_VALUE_DISABLE, InitValue field must be set */
bogdanm 85:024bf7f99721 87
bogdanm 85:024bf7f99721 88 uint32_t GeneratingPolynomial; /*!< Set CRC generating polynomial. 7, 8, 16 or 32-bit long value for a polynomial degree
bogdanm 85:024bf7f99721 89 respectively equal to 7, 8, 16 or 32. This field is written in normal representation,
bogdanm 85:024bf7f99721 90 e.g., for a polynomial of degree 7, X^7 + X^6 + X^5 + X^2 + 1 is written 0x65.
bogdanm 85:024bf7f99721 91 No need to specify it if DefaultPolynomialUse is set to DEFAULT_POLYNOMIAL_ENABLE */
bogdanm 85:024bf7f99721 92
bogdanm 85:024bf7f99721 93 uint32_t CRCLength; /*!< This parameter is a value of @ref CRCEx_Polynomial_Size_Definitions and indicates CRC length.
bogdanm 85:024bf7f99721 94 Value can be either one of
bogdanm 85:024bf7f99721 95 CRC_POLYLENGTH_32B (32-bit CRC)
bogdanm 85:024bf7f99721 96 CRC_POLYLENGTH_16B (16-bit CRC)
bogdanm 85:024bf7f99721 97 CRC_POLYLENGTH_8B (8-bit CRC)
bogdanm 85:024bf7f99721 98 CRC_POLYLENGTH_7B (7-bit CRC) */
bogdanm 85:024bf7f99721 99
bogdanm 85:024bf7f99721 100 uint32_t InitValue; /*!< Init value to initiate CRC computation. No need to specify it if DefaultInitValueUse
bogdanm 85:024bf7f99721 101 is set to DEFAULT_INIT_VALUE_ENABLE */
bogdanm 85:024bf7f99721 102
bogdanm 85:024bf7f99721 103 uint32_t InputDataInversionMode; /*!< This parameter is a value of @ref CRCEx_Input_Data_Inversion and specifies input data inversion mode.
bogdanm 85:024bf7f99721 104 Can be either one of the following values
bogdanm 85:024bf7f99721 105 CRC_INPUTDATA_INVERSION_NONE no input data inversion
bogdanm 85:024bf7f99721 106 CRC_INPUTDATA_INVERSION_BYTE byte-wise inversion, 0x1A2B3C4D becomes 0x58D43CB2
bogdanm 85:024bf7f99721 107 CRC_INPUTDATA_INVERSION_HALFWORD halfword-wise inversion, 0x1A2B3C4D becomes 0xD458B23C
bogdanm 85:024bf7f99721 108 CRC_INPUTDATA_INVERSION_WORD word-wise inversion, 0x1A2B3C4D becomes 0xB23CD458 */
bogdanm 85:024bf7f99721 109
bogdanm 85:024bf7f99721 110 uint32_t OutputDataInversionMode; /*!< This parameter is a value of @ref CRCEx_Output_Data_Inversion and specifies output data (i.e. CRC) inversion mode.
bogdanm 85:024bf7f99721 111 Can be either
bogdanm 85:024bf7f99721 112 CRC_OUTPUTDATA_INVERSION_DISABLED no CRC inversion, or
bogdanm 85:024bf7f99721 113 CRC_OUTPUTDATA_INVERSION_ENABLED CRC 0x11223344 is converted into 0x22CC4488 */
bogdanm 85:024bf7f99721 114 }CRC_InitTypeDef;
bogdanm 85:024bf7f99721 115
bogdanm 85:024bf7f99721 116
bogdanm 85:024bf7f99721 117 /**
bogdanm 85:024bf7f99721 118 * @brief CRC Handle Structure definition
bogdanm 85:024bf7f99721 119 */
bogdanm 85:024bf7f99721 120 typedef struct
bogdanm 85:024bf7f99721 121 {
bogdanm 85:024bf7f99721 122 CRC_TypeDef *Instance; /*!< Register base address */
bogdanm 85:024bf7f99721 123
bogdanm 85:024bf7f99721 124 CRC_InitTypeDef Init; /*!< CRC configuration parameters */
bogdanm 85:024bf7f99721 125
bogdanm 85:024bf7f99721 126 HAL_LockTypeDef Lock; /*!< CRC Locking object */
bogdanm 85:024bf7f99721 127
bogdanm 85:024bf7f99721 128 __IO HAL_CRC_StateTypeDef State; /*!< CRC communication state */
bogdanm 85:024bf7f99721 129
bogdanm 85:024bf7f99721 130 uint32_t InputDataFormat; /*!< This parameter is a value of @ref CRC_Input_Buffer_Format and specifies input data format.
bogdanm 85:024bf7f99721 131 Can be either
bogdanm 85:024bf7f99721 132 CRC_INPUTDATA_FORMAT_BYTES input data is a stream of bytes (8-bit data)
bogdanm 85:024bf7f99721 133 CRC_INPUTDATA_FORMAT_HALFWORDS input data is a stream of half-words (16-bit data)
bogdanm 85:024bf7f99721 134 CRC_INPUTDATA_FORMAT_WORDS input data is a stream of words (32-bits data)
bogdanm 85:024bf7f99721 135 Note that constant CRC_INPUT_FORMAT_UNDEFINED is defined but an initialization error
bogdanm 85:024bf7f99721 136 must occur if InputBufferFormat is not one of the three values listed above */
bogdanm 85:024bf7f99721 137 }CRC_HandleTypeDef;
bogdanm 85:024bf7f99721 138
bogdanm 85:024bf7f99721 139 /* Exported constants --------------------------------------------------------*/
bogdanm 85:024bf7f99721 140
bogdanm 85:024bf7f99721 141 /** @defgroup CRC_Default_Polynomial_Value Default CRC generating polynomial
bogdanm 85:024bf7f99721 142 * @{
bogdanm 85:024bf7f99721 143 */
bogdanm 85:024bf7f99721 144 #define DEFAULT_CRC32_POLY 0x04C11DB7
bogdanm 85:024bf7f99721 145
bogdanm 85:024bf7f99721 146 /**
bogdanm 85:024bf7f99721 147 * @}
bogdanm 85:024bf7f99721 148 */
bogdanm 85:024bf7f99721 149
bogdanm 85:024bf7f99721 150 /** @defgroup CRC_Default_InitValue Default CRC computation initialization value
bogdanm 85:024bf7f99721 151 * @{
bogdanm 85:024bf7f99721 152 */
bogdanm 85:024bf7f99721 153 #define DEFAULT_CRC_INITVALUE 0xFFFFFFFF
bogdanm 85:024bf7f99721 154
bogdanm 85:024bf7f99721 155 /**
bogdanm 85:024bf7f99721 156 * @}
bogdanm 85:024bf7f99721 157 */
bogdanm 85:024bf7f99721 158
bogdanm 85:024bf7f99721 159 /** @defgroup CRC_Default_Polynomial Indicates whether or not default polynomial is used
bogdanm 85:024bf7f99721 160 * @{
bogdanm 85:024bf7f99721 161 */
bogdanm 85:024bf7f99721 162 #define DEFAULT_POLYNOMIAL_ENABLE ((uint8_t)0x00)
bogdanm 85:024bf7f99721 163 #define DEFAULT_POLYNOMIAL_DISABLE ((uint8_t)0x01)
bogdanm 85:024bf7f99721 164
bogdanm 85:024bf7f99721 165 #define IS_DEFAULT_POLYNOMIAL(DEFAULT) (((DEFAULT) == DEFAULT_POLYNOMIAL_ENABLE) || \
bogdanm 85:024bf7f99721 166 ((DEFAULT) == DEFAULT_POLYNOMIAL_DISABLE))
bogdanm 85:024bf7f99721 167
bogdanm 85:024bf7f99721 168 /**
bogdanm 85:024bf7f99721 169 * @}
bogdanm 85:024bf7f99721 170 */
bogdanm 85:024bf7f99721 171
bogdanm 85:024bf7f99721 172 /** @defgroup CRC_Default_InitValue_Use Indicates whether or not default init value is used
bogdanm 85:024bf7f99721 173 * @{
bogdanm 85:024bf7f99721 174 */
bogdanm 85:024bf7f99721 175 #define DEFAULT_INIT_VALUE_ENABLE ((uint8_t)0x00)
bogdanm 85:024bf7f99721 176 #define DEFAULT_INIT_VALUE_DISABLE ((uint8_t)0x01)
bogdanm 85:024bf7f99721 177
bogdanm 85:024bf7f99721 178 #define IS_DEFAULT_INIT_VALUE(VALUE) (((VALUE) == DEFAULT_INIT_VALUE_ENABLE) || \
bogdanm 85:024bf7f99721 179 ((VALUE) == DEFAULT_INIT_VALUE_DISABLE))
bogdanm 85:024bf7f99721 180 /**
bogdanm 85:024bf7f99721 181 * @}
bogdanm 85:024bf7f99721 182 */
bogdanm 85:024bf7f99721 183
bogdanm 85:024bf7f99721 184 /** @defgroup CRC_Input_Buffer_Format Input Buffer Format
bogdanm 85:024bf7f99721 185 * @{
bogdanm 85:024bf7f99721 186 */
bogdanm 85:024bf7f99721 187 /* WARNING: CRC_INPUT_FORMAT_UNDEFINED is created for reference purposes but
bogdanm 85:024bf7f99721 188 * an error is triggered in HAL_CRC_Init() if InputDataFormat field is set
bogdanm 85:024bf7f99721 189 * to CRC_INPUT_FORMAT_UNDEFINED: the format MUST be defined by the user for
bogdanm 85:024bf7f99721 190 * the CRC APIs to provide a correct result */
bogdanm 85:024bf7f99721 191 #define CRC_INPUTDATA_FORMAT_UNDEFINED ((uint32_t)0x00000000)
bogdanm 85:024bf7f99721 192 #define CRC_INPUTDATA_FORMAT_BYTES ((uint32_t)0x00000001)
bogdanm 85:024bf7f99721 193 #define CRC_INPUTDATA_FORMAT_HALFWORDS ((uint32_t)0x00000002)
bogdanm 85:024bf7f99721 194 #define CRC_INPUTDATA_FORMAT_WORDS ((uint32_t)0x00000003)
bogdanm 85:024bf7f99721 195
bogdanm 85:024bf7f99721 196 #define IS_CRC_INPUTDATA_FORMAT(FORMAT) (((FORMAT) == CRC_INPUTDATA_FORMAT_BYTES) || \
bogdanm 85:024bf7f99721 197 ((FORMAT) == CRC_INPUTDATA_FORMAT_HALFWORDS) || \
bogdanm 85:024bf7f99721 198 ((FORMAT) == CRC_INPUTDATA_FORMAT_WORDS))
bogdanm 85:024bf7f99721 199 /**
bogdanm 85:024bf7f99721 200 * @}
bogdanm 85:024bf7f99721 201 */
bogdanm 85:024bf7f99721 202
bogdanm 85:024bf7f99721 203 /* Exported macros -----------------------------------------------------------*/
bogdanm 85:024bf7f99721 204
bogdanm 85:024bf7f99721 205 /** @defgroup CRC_Exported_Macros
bogdanm 85:024bf7f99721 206 * @{
bogdanm 85:024bf7f99721 207 */
bogdanm 85:024bf7f99721 208
bogdanm 85:024bf7f99721 209 /** @brief Reset CRC handle state
bogdanm 85:024bf7f99721 210 * @param __HANDLE__: CRC handle.
bogdanm 85:024bf7f99721 211 * @retval None
bogdanm 85:024bf7f99721 212 */
bogdanm 85:024bf7f99721 213 #define __HAL_CRC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_CRC_STATE_RESET)
bogdanm 85:024bf7f99721 214
bogdanm 85:024bf7f99721 215 /**
bogdanm 85:024bf7f99721 216 * @brief Reset CRC Data Register.
bogdanm 85:024bf7f99721 217 * @param __HANDLE__: CRC handle
bogdanm 85:024bf7f99721 218 * @retval None.
bogdanm 85:024bf7f99721 219 */
bogdanm 85:024bf7f99721 220 #define __HAL_CRC_DR_RESET(__HANDLE__) ((__HANDLE__)->Instance->CR |= CRC_CR_RESET)
bogdanm 85:024bf7f99721 221
bogdanm 85:024bf7f99721 222 /**
bogdanm 85:024bf7f99721 223 * @brief Set CRC INIT non-default value
bogdanm 85:024bf7f99721 224 * @param __HANDLE__ : CRC handle
bogdanm 85:024bf7f99721 225 * @param __INIT__ : 32-bit initial value
bogdanm 85:024bf7f99721 226 * @retval None.
bogdanm 85:024bf7f99721 227 */
bogdanm 85:024bf7f99721 228 #define __HAL_CRC_INITIALCRCVALUE_CONFIG(__HANDLE__, __INIT__) ((__HANDLE__)->Instance->INIT = (__INIT__))
bogdanm 85:024bf7f99721 229
bogdanm 85:024bf7f99721 230 /**
bogdanm 85:024bf7f99721 231 * @}
bogdanm 85:024bf7f99721 232 */
bogdanm 85:024bf7f99721 233
bogdanm 85:024bf7f99721 234
bogdanm 85:024bf7f99721 235 /* Include CRC HAL Extension module */
bogdanm 85:024bf7f99721 236 #include "stm32f0xx_hal_crc_ex.h"
bogdanm 85:024bf7f99721 237
bogdanm 85:024bf7f99721 238 /* Exported functions --------------------------------------------------------*/
bogdanm 85:024bf7f99721 239
bogdanm 85:024bf7f99721 240 /* Initialization and de-initialization functions ****************************/
bogdanm 85:024bf7f99721 241 HAL_StatusTypeDef HAL_CRC_Init(CRC_HandleTypeDef *hcrc);
bogdanm 85:024bf7f99721 242 HAL_StatusTypeDef HAL_CRC_DeInit (CRC_HandleTypeDef *hcrc);
bogdanm 85:024bf7f99721 243 void HAL_CRC_MspInit(CRC_HandleTypeDef *hcrc);
bogdanm 85:024bf7f99721 244 void HAL_CRC_MspDeInit(CRC_HandleTypeDef *hcrc);
bogdanm 85:024bf7f99721 245 /* Aliases for inter STM32 series compatibility */
bogdanm 85:024bf7f99721 246 #define HAL_CRC_Input_Data_Reverse HAL_CRCEx_Input_Data_Reverse
bogdanm 85:024bf7f99721 247 #define HAL_CRC_Output_Data_Reverse HAL_CRCEx_Output_Data_Reverse
bogdanm 85:024bf7f99721 248
bogdanm 85:024bf7f99721 249 /* Peripheral Control functions ***********************************************/
bogdanm 85:024bf7f99721 250 uint32_t HAL_CRC_Accumulate(CRC_HandleTypeDef *hcrc, uint32_t pBuffer[], uint32_t BufferLength);
bogdanm 85:024bf7f99721 251 uint32_t HAL_CRC_Calculate(CRC_HandleTypeDef *hcrc, uint32_t pBuffer[], uint32_t BufferLength);
bogdanm 85:024bf7f99721 252
bogdanm 85:024bf7f99721 253 /* Peripheral State and Error functions ***************************************/
bogdanm 85:024bf7f99721 254 HAL_CRC_StateTypeDef HAL_CRC_GetState(CRC_HandleTypeDef *hcrc);
bogdanm 85:024bf7f99721 255
bogdanm 85:024bf7f99721 256 /**
bogdanm 85:024bf7f99721 257 * @}
bogdanm 85:024bf7f99721 258 */
bogdanm 85:024bf7f99721 259
bogdanm 85:024bf7f99721 260 /**
bogdanm 85:024bf7f99721 261 * @}
bogdanm 85:024bf7f99721 262 */
bogdanm 85:024bf7f99721 263
bogdanm 85:024bf7f99721 264 #ifdef __cplusplus
bogdanm 85:024bf7f99721 265 }
bogdanm 85:024bf7f99721 266 #endif
bogdanm 85:024bf7f99721 267
bogdanm 85:024bf7f99721 268 #endif /* __STM32F0xx_HAL_CRC_H */
bogdanm 85:024bf7f99721 269
bogdanm 85:024bf7f99721 270 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/