TUKS MCU Introductory course
/
TUKS-COURSE-2-LED
Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Embed:
(wiki syntax)
Show/hide line numbers
stm32l4xx_hal_crc_ex.c
Go to the documentation of this file.
00001 /** 00002 ****************************************************************************** 00003 * @file stm32l4xx_hal_crc_ex.c 00004 * @author MCD Application Team 00005 * @version V1.5.1 00006 * @date 31-May-2016 00007 * @brief Extended CRC HAL module driver. 00008 * This file provides firmware functions to manage the extended 00009 * functionalities of the CRC peripheral. 00010 * 00011 @verbatim 00012 ================================================================================ 00013 ##### How to use this driver ##### 00014 ================================================================================ 00015 [..] 00016 (+) Set user-defined generating polynomial thru HAL_CRCEx_Polynomial_Set() 00017 (+) Configure Input or Output data inversion 00018 00019 @endverbatim 00020 ****************************************************************************** 00021 * @attention 00022 * 00023 * <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2> 00024 * 00025 * Redistribution and use in source and binary forms, with or without modification, 00026 * are permitted provided that the following conditions are met: 00027 * 1. Redistributions of source code must retain the above copyright notice, 00028 * this list of conditions and the following disclaimer. 00029 * 2. Redistributions in binary form must reproduce the above copyright notice, 00030 * this list of conditions and the following disclaimer in the documentation 00031 * and/or other materials provided with the distribution. 00032 * 3. Neither the name of STMicroelectronics nor the names of its contributors 00033 * may be used to endorse or promote products derived from this software 00034 * without specific prior written permission. 00035 * 00036 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00037 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00038 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00039 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 00040 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 00041 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 00042 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 00043 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00044 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00045 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00046 * 00047 ****************************************************************************** 00048 */ 00049 00050 /* Includes ------------------------------------------------------------------*/ 00051 #include "stm32l4xx_hal.h" 00052 00053 /** @addtogroup STM32L4xx_HAL_Driver 00054 * @{ 00055 */ 00056 00057 /** @defgroup CRCEx CRCEx 00058 * @brief CRC Extended HAL module driver 00059 * @{ 00060 */ 00061 00062 #ifdef HAL_CRC_MODULE_ENABLED 00063 00064 /* Private typedef -----------------------------------------------------------*/ 00065 /* Private define ------------------------------------------------------------*/ 00066 /* Private macro -------------------------------------------------------------*/ 00067 /* Private variables ---------------------------------------------------------*/ 00068 /* Private function prototypes -----------------------------------------------*/ 00069 /* Exported functions --------------------------------------------------------*/ 00070 00071 /** @defgroup CRCEx_Exported_Functions CRC Extended Exported Functions 00072 * @{ 00073 */ 00074 00075 /** @defgroup CRCEx_Exported_Functions_Group1 Extended Initialization/de-initialization functions 00076 * @brief Extended Initialization and Configuration functions. 00077 * 00078 @verbatim 00079 =============================================================================== 00080 ##### Extended configuration functions ##### 00081 =============================================================================== 00082 [..] This section provides functions allowing to: 00083 (+) Configure the generating polynomial 00084 (+) Configure the input data inversion 00085 (+) Configure the output data inversion 00086 00087 @endverbatim 00088 * @{ 00089 */ 00090 00091 00092 /** 00093 * @brief Initialize the CRC polynomial if different from default one. 00094 * @param hcrc: CRC handle 00095 * @param Pol: CRC generating polynomial (7, 8, 16 or 32-bit long). 00096 * This parameter is written in normal representation, e.g. 00097 * @arg for a polynomial of degree 7, X^7 + X^6 + X^5 + X^2 + 1 is written 0x65 00098 * @arg for a polynomial of degree 16, X^16 + X^12 + X^5 + 1 is written 0x1021 00099 * @param PolyLength: CRC polynomial length. 00100 * This parameter can be one of the following values: 00101 * @arg @ref CRC_POLYLENGTH_7B 7-bit long CRC (generating polynomial of degree 7) 00102 * @arg @ref CRC_POLYLENGTH_8B 8-bit long CRC (generating polynomial of degree 8) 00103 * @arg @ref CRC_POLYLENGTH_16B 16-bit long CRC (generating polynomial of degree 16) 00104 * @arg @ref CRC_POLYLENGTH_32B 32-bit long CRC (generating polynomial of degree 32) 00105 * @retval HAL status 00106 */ 00107 HAL_StatusTypeDef HAL_CRCEx_Polynomial_Set(CRC_HandleTypeDef *hcrc, uint32_t Pol, uint32_t PolyLength) 00108 { 00109 uint32_t msb = 31; /* polynomial degree is 32 at most, so msb is initialized to max value */ 00110 00111 /* Check the parameters */ 00112 assert_param(IS_CRC_POL_LENGTH(PolyLength)); 00113 00114 /* check polynomial definition vs polynomial size: 00115 * polynomial length must be aligned with polynomial 00116 * definition. HAL_ERROR is reported if Pol degree is 00117 * larger than that indicated by PolyLength. 00118 * Look for MSB position: msb will contain the degree of 00119 * the second to the largest polynomial member. E.g., for 00120 * X^7 + X^6 + X^5 + X^2 + 1, msb = 6. */ 00121 while (((Pol & (1U << msb)) == 0) && (msb-- > 0)) {} 00122 00123 switch (PolyLength) 00124 { 00125 case CRC_POLYLENGTH_7B: 00126 if (msb >= HAL_CRC_LENGTH_7B) 00127 { 00128 return HAL_ERROR; 00129 } 00130 break; 00131 case CRC_POLYLENGTH_8B: 00132 if (msb >= HAL_CRC_LENGTH_8B) 00133 { 00134 return HAL_ERROR; 00135 } 00136 break; 00137 case CRC_POLYLENGTH_16B: 00138 if (msb >= HAL_CRC_LENGTH_16B) 00139 { 00140 return HAL_ERROR; 00141 } 00142 break; 00143 case CRC_POLYLENGTH_32B: 00144 /* no polynomial definition vs. polynomial length issue possible */ 00145 break; 00146 default: 00147 break; 00148 } 00149 00150 /* set generating polynomial */ 00151 WRITE_REG(hcrc->Instance->POL, Pol); 00152 00153 /* set generating polynomial size */ 00154 MODIFY_REG(hcrc->Instance->CR, CRC_CR_POLYSIZE, PolyLength); 00155 00156 /* Return function status */ 00157 return HAL_OK; 00158 } 00159 00160 /** 00161 * @brief Set the Reverse Input data mode. 00162 * @param hcrc: CRC handle 00163 * @param InputReverseMode: Input Data inversion mode. 00164 * This parameter can be one of the following values: 00165 * @arg @ref CRC_INPUTDATA_INVERSION_NONE no change in bit order (default value) 00166 * @arg @ref CRC_INPUTDATA_INVERSION_BYTE Byte-wise bit reversal 00167 * @arg @ref CRC_INPUTDATA_INVERSION_HALFWORD HalfWord-wise bit reversal 00168 * @arg @ref CRC_INPUTDATA_INVERSION_WORD Word-wise bit reversal 00169 * @retval HAL status 00170 */ 00171 HAL_StatusTypeDef HAL_CRCEx_Input_Data_Reverse(CRC_HandleTypeDef *hcrc, uint32_t InputReverseMode) 00172 { 00173 /* Check the parameters */ 00174 assert_param(IS_CRC_INPUTDATA_INVERSION_MODE(InputReverseMode)); 00175 00176 /* Change CRC peripheral state */ 00177 hcrc->State = HAL_CRC_STATE_BUSY; 00178 00179 /* set input data inversion mode */ 00180 MODIFY_REG(hcrc->Instance->CR, CRC_CR_REV_IN, InputReverseMode); 00181 /* Change CRC peripheral state */ 00182 hcrc->State = HAL_CRC_STATE_READY; 00183 00184 /* Return function status */ 00185 return HAL_OK; 00186 } 00187 00188 /** 00189 * @brief Set the Reverse Output data mode. 00190 * @param hcrc: CRC handle 00191 * @param OutputReverseMode: Output Data inversion mode. 00192 * This parameter can be one of the following values: 00193 * @arg @ref CRC_OUTPUTDATA_INVERSION_DISABLE no CRC inversion (default value) 00194 * @arg @ref CRC_OUTPUTDATA_INVERSION_ENABLE bit-level inversion (e.g. for a 8-bit CRC: 0xB5 becomes 0xAD) 00195 * @retval HAL status 00196 */ 00197 HAL_StatusTypeDef HAL_CRCEx_Output_Data_Reverse(CRC_HandleTypeDef *hcrc, uint32_t OutputReverseMode) 00198 { 00199 /* Check the parameters */ 00200 assert_param(IS_CRC_OUTPUTDATA_INVERSION_MODE(OutputReverseMode)); 00201 00202 /* Change CRC peripheral state */ 00203 hcrc->State = HAL_CRC_STATE_BUSY; 00204 00205 /* set output data inversion mode */ 00206 MODIFY_REG(hcrc->Instance->CR, CRC_CR_REV_OUT, OutputReverseMode); 00207 00208 /* Change CRC peripheral state */ 00209 hcrc->State = HAL_CRC_STATE_READY; 00210 00211 /* Return function status */ 00212 return HAL_OK; 00213 } 00214 00215 00216 00217 00218 /** 00219 * @} 00220 */ 00221 00222 00223 /** 00224 * @} 00225 */ 00226 00227 00228 #endif /* HAL_CRC_MODULE_ENABLED */ 00229 /** 00230 * @} 00231 */ 00232 00233 /** 00234 * @} 00235 */ 00236 00237 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
Generated on Tue Jul 12 2022 10:59:57 by
1.7.2