stm32l4xx_hal_conf.h
Go to the documentation of this file.
1 /**
2 ******************************************************************************
3 * @file stm32l4xx_hal_conf.h
4 * @author MCD Application Team
5 * @brief HAL configuration template file.
6 * This file should be copied to the application folder and renamed
7 * to stm32l4xx_hal_conf.h.
8 ******************************************************************************
9 * @attention
10 *
11 * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
12 * All rights reserved.</center></h2>
13 *
14 * This software component is licensed by ST under BSD 3-Clause license,
15 * the "License"; You may not use this file except in compliance with the
16 * License. You may obtain a copy of the License at:
17 * opensource.org/licenses/BSD-3-Clause
18 *
19 ******************************************************************************
20 */
21
22 /* Define to prevent recursive inclusion -------------------------------------*/
23 #ifndef STM32L4xx_HAL_CONF_H
24 #define STM32L4xx_HAL_CONF_H
25
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29
30 /* Exported types ------------------------------------------------------------*/
31 /* Exported constants --------------------------------------------------------*/
32
33 /* ########################## Module Selection ############################## */
34 /**
35 * @brief This is the list of modules to be used in the HAL driver
36 */
37 #define HAL_MODULE_ENABLED
38 /*#define HAL_ADC_MODULE_ENABLED */
39 /*#define HAL_CRYP_MODULE_ENABLED */
40 /*#define HAL_CAN_MODULE_ENABLED */
41 /*#define HAL_COMP_MODULE_ENABLED */
42 /*#define HAL_CRC_MODULE_ENABLED */
43 /*#define HAL_CRYP_MODULE_ENABLED */
44 /*#define HAL_DAC_MODULE_ENABLED */
45 /*#define HAL_DCMI_MODULE_ENABLED */
46 /*#define HAL_DMA2D_MODULE_ENABLED */
47 /*#define HAL_DFSDM_MODULE_ENABLED */
48 /*#define HAL_DSI_MODULE_ENABLED */
49 /*#define HAL_FIREWALL_MODULE_ENABLED */
50 /*#define HAL_GFXMMU_MODULE_ENABLED */
51 /*#define HAL_HCD_MODULE_ENABLED */
52 /*#define HAL_HASH_MODULE_ENABLED */
53 /*#define HAL_I2S_MODULE_ENABLED */
54 /*#define HAL_IRDA_MODULE_ENABLED */
55 /*#define HAL_IWDG_MODULE_ENABLED */
56 /*#define HAL_LTDC_MODULE_ENABLED */
57 /*#define HAL_LCD_MODULE_ENABLED */
58 /*#define HAL_LPTIM_MODULE_ENABLED */
59 /*#define HAL_MMC_MODULE_ENABLED */
60 /*#define HAL_NAND_MODULE_ENABLED */
61 /*#define HAL_NOR_MODULE_ENABLED */
62 /*#define HAL_OPAMP_MODULE_ENABLED */
63 /*#define HAL_OSPI_MODULE_ENABLED */
64 /*#define HAL_OSPI_MODULE_ENABLED */
65 /*#define HAL_PCD_MODULE_ENABLED */
66 /*#define HAL_PKA_MODULE_ENABLED */
67 /*#define HAL_QSPI_MODULE_ENABLED */
68 /*#define HAL_QSPI_MODULE_ENABLED */
69 /*#define HAL_RNG_MODULE_ENABLED */
70 #define HAL_RTC_MODULE_ENABLED
71 /*#define HAL_SAI_MODULE_ENABLED */
72 /*#define HAL_SD_MODULE_ENABLED */
73 /*#define HAL_SMBUS_MODULE_ENABLED */
74 /*#define HAL_SMARTCARD_MODULE_ENABLED */
75 #define HAL_SPI_MODULE_ENABLED
76 /*#define HAL_SRAM_MODULE_ENABLED */
77 /*#define HAL_SWPMI_MODULE_ENABLED */
78 /*#define HAL_TIM_MODULE_ENABLED */
79 /*#define HAL_TSC_MODULE_ENABLED */
80 #define HAL_UART_MODULE_ENABLED
81 /*#define HAL_USART_MODULE_ENABLED */
82 /*#define HAL_WWDG_MODULE_ENABLED */
83 /*#define HAL_EXTI_MODULE_ENABLED */
84 /*#define HAL_PSSI_MODULE_ENABLED */
85 #define HAL_GPIO_MODULE_ENABLED
86 #define HAL_EXTI_MODULE_ENABLED
87 #define HAL_I2C_MODULE_ENABLED
88 #define HAL_DMA_MODULE_ENABLED
89 #define HAL_RCC_MODULE_ENABLED
90 #define HAL_FLASH_MODULE_ENABLED
91 #define HAL_PWR_MODULE_ENABLED
92 #define HAL_CORTEX_MODULE_ENABLED
93
94 /* ########################## Oscillator Values adaptation ####################*/
95 /**
96 * @brief Adjust the value of External High Speed oscillator (HSE) used in your application.
97 * This value is used by the RCC HAL module to compute the system frequency
98 * (when HSE is used as system clock source, directly or through the PLL).
99 */
100 #if !defined (HSE_VALUE)
101 #define HSE_VALUE ((uint32_t)8000000U) /*!< Value of the External oscillator in Hz */
102 #endif /* HSE_VALUE */
103
104 #if !defined (HSE_STARTUP_TIMEOUT)
105 #define HSE_STARTUP_TIMEOUT ((uint32_t)100U) /*!< Time out for HSE start up, in ms */
106 #endif /* HSE_STARTUP_TIMEOUT */
107
108 /**
109 * @brief Internal Multiple Speed oscillator (MSI) default value.
110 * This value is the default MSI range value after Reset.
111 */
112 #if !defined (MSI_VALUE)
113 #define MSI_VALUE ((uint32_t)4000000U) /*!< Value of the Internal oscillator in Hz*/
114 #endif /* MSI_VALUE */
115 /**
116 * @brief Internal High Speed oscillator (HSI) value.
117 * This value is used by the RCC HAL module to compute the system frequency
118 * (when HSI is used as system clock source, directly or through the PLL).
119 */
120 #if !defined (HSI_VALUE)
121 #define HSI_VALUE ((uint32_t)16000000U) /*!< Value of the Internal oscillator in Hz*/
122 #endif /* HSI_VALUE */
123
124 /**
125 * @brief Internal High Speed oscillator (HSI48) value for USB FS, SDMMC and RNG.
126 * This internal oscillator is mainly dedicated to provide a high precision clock to
127 * the USB peripheral by means of a special Clock Recovery System (CRS) circuitry.
128 * When the CRS is not used, the HSI48 RC oscillator runs on it default frequency
129 * which is subject to manufacturing process variations.
130 */
131 #if !defined (HSI48_VALUE)
132 #define HSI48_VALUE ((uint32_t)48000000U) /*!< Value of the Internal High Speed oscillator for USB FS/SDMMC/RNG in Hz.
133 The real value my vary depending on manufacturing process variations.*/
134 #endif /* HSI48_VALUE */
135
136 /**
137 * @brief Internal Low Speed oscillator (LSI) value.
138 */
139 #if !defined (LSI_VALUE)
140 #define LSI_VALUE 32000U /*!< LSI Typical Value in Hz*/
141 #endif /* LSI_VALUE */ /*!< Value of the Internal Low Speed oscillator in Hz
142 The real value may vary depending on the variations
143 in voltage and temperature.*/
144
145 /**
146 * @brief External Low Speed oscillator (LSE) value.
147 * This value is used by the UART, RTC HAL module to compute the system frequency
148 */
149 #if !defined (LSE_VALUE)
150 #define LSE_VALUE 32768U /*!< Value of the External oscillator in Hz*/
151 #endif /* LSE_VALUE */
152
153 #if !defined (LSE_STARTUP_TIMEOUT)
154 #define LSE_STARTUP_TIMEOUT 5000U /*!< Time out for LSE start up, in ms */
155 #endif /* HSE_STARTUP_TIMEOUT */
156
157 /**
158 * @brief External clock source for SAI1 peripheral
159 * This value is used by the RCC HAL module to compute the SAI1 & SAI2 clock source
160 * frequency.
161 */
162 #if !defined (EXTERNAL_SAI1_CLOCK_VALUE)
163 #define EXTERNAL_SAI1_CLOCK_VALUE 2097000U /*!< Value of the SAI1 External clock source in Hz*/
164 #endif /* EXTERNAL_SAI1_CLOCK_VALUE */
165
166 /**
167 * @brief External clock source for SAI2 peripheral
168 * This value is used by the RCC HAL module to compute the SAI1 & SAI2 clock source
169 * frequency.
170 */
171 #if !defined (EXTERNAL_SAI2_CLOCK_VALUE)
172 #define EXTERNAL_SAI2_CLOCK_VALUE 48000U /*!< Value of the SAI2 External clock source in Hz*/
173 #endif /* EXTERNAL_SAI2_CLOCK_VALUE */
174
175 /* Tip: To avoid modifying this file each time you need to use different HSE,
176 === you can define the HSE value in your toolchain compiler preprocessor. */
177
178 /* ########################### System Configuration ######################### */
179 /**
180 * @brief This is the HAL system configuration section
181 */
182
183 #define VDD_VALUE 3300U /*!< Value of VDD in mv */
184 #define TICK_INT_PRIORITY 15U /*!< tick interrupt priority */
185 #define USE_RTOS 0U
186 #define PREFETCH_ENABLE 0U
187 #define INSTRUCTION_CACHE_ENABLE 1U
188 #define DATA_CACHE_ENABLE 1U
189
190 /* ########################## Assert Selection ############################## */
191 /**
192 * @brief Uncomment the line below to expanse the "assert_param" macro in the
193 * HAL drivers code
194 */
195 /* #define USE_FULL_ASSERT 1U */
196
197 /* ################## Register callback feature configuration ############### */
198 /**
199 * @brief Set below the peripheral configuration to "1U" to add the support
200 * of HAL callback registration/deregistration feature for the HAL
201 * driver(s). This allows user application to provide specific callback
202 * functions thanks to HAL_PPP_RegisterCallback() rather than overwriting
203 * the default weak callback functions (see each stm32l4xx_hal_ppp.h file
204 * for possible callback identifiers defined in HAL_PPP_CallbackIDTypeDef
205 * for each PPP peripheral).
206 */
207 #define USE_HAL_ADC_REGISTER_CALLBACKS 0U
208 #define USE_HAL_CAN_REGISTER_CALLBACKS 0U
209 #define USE_HAL_COMP_REGISTER_CALLBACKS 0U
210 #define USE_HAL_CRYP_REGISTER_CALLBACKS 0U
211 #define USE_HAL_DAC_REGISTER_CALLBACKS 0U
212 #define USE_HAL_DCMI_REGISTER_CALLBACKS 0U
213 #define USE_HAL_DFSDM_REGISTER_CALLBACKS 0U
214 #define USE_HAL_DMA2D_REGISTER_CALLBACKS 0U
215 #define USE_HAL_DSI_REGISTER_CALLBACKS 0U
216 #define USE_HAL_GFXMMU_REGISTER_CALLBACKS 0U
217 #define USE_HAL_HASH_REGISTER_CALLBACKS 0U
218 #define USE_HAL_HCD_REGISTER_CALLBACKS 0U
219 #define USE_HAL_I2C_REGISTER_CALLBACKS 0U
220 #define USE_HAL_IRDA_REGISTER_CALLBACKS 0U
221 #define USE_HAL_LPTIM_REGISTER_CALLBACKS 0U
222 #define USE_HAL_LTDC_REGISTER_CALLBACKS 0U
223 #define USE_HAL_MMC_REGISTER_CALLBACKS 0U
224 #define USE_HAL_OPAMP_REGISTER_CALLBACKS 0U
225 #define USE_HAL_OSPI_REGISTER_CALLBACKS 0U
226 #define USE_HAL_PCD_REGISTER_CALLBACKS 0U
227 #define USE_HAL_QSPI_REGISTER_CALLBACKS 0U
228 #define USE_HAL_RNG_REGISTER_CALLBACKS 0U
229 #define USE_HAL_RTC_REGISTER_CALLBACKS 0U
230 #define USE_HAL_SAI_REGISTER_CALLBACKS 0U
231 #define USE_HAL_SD_REGISTER_CALLBACKS 0U
232 #define USE_HAL_SMARTCARD_REGISTER_CALLBACKS 0U
233 #define USE_HAL_SMBUS_REGISTER_CALLBACKS 0U
234 #define USE_HAL_SPI_REGISTER_CALLBACKS 0U
235 #define USE_HAL_SWPMI_REGISTER_CALLBACKS 0U
236 #define USE_HAL_TIM_REGISTER_CALLBACKS 0U
237 #define USE_HAL_TSC_REGISTER_CALLBACKS 0U
238 #define USE_HAL_UART_REGISTER_CALLBACKS 0U
239 #define USE_HAL_USART_REGISTER_CALLBACKS 0U
240 #define USE_HAL_WWDG_REGISTER_CALLBACKS 0U
241
242 /* ################## SPI peripheral configuration ########################## */
243
244 /* CRC FEATURE: Use to activate CRC feature inside HAL SPI Driver
245 * Activated: CRC code is present inside driver
246 * Deactivated: CRC code cleaned from driver
247 */
248
249 #define USE_SPI_CRC 0U
250
251 /* Includes ------------------------------------------------------------------*/
252 /**
253 * @brief Include module's header file
254 */
255
256 #ifdef HAL_RCC_MODULE_ENABLED
257 #include "stm32l4xx_hal_rcc.h"
258 #endif /* HAL_RCC_MODULE_ENABLED */
259
260 #ifdef HAL_GPIO_MODULE_ENABLED
261 #include "stm32l4xx_hal_gpio.h"
262 #endif /* HAL_GPIO_MODULE_ENABLED */
263
264 #ifdef HAL_DMA_MODULE_ENABLED
265 #include "stm32l4xx_hal_dma.h"
266 #endif /* HAL_DMA_MODULE_ENABLED */
267
268 #ifdef HAL_DFSDM_MODULE_ENABLED
269 #include "stm32l4xx_hal_dfsdm.h"
270 #endif /* HAL_DFSDM_MODULE_ENABLED */
271
272 #ifdef HAL_CORTEX_MODULE_ENABLED
273 #include "stm32l4xx_hal_cortex.h"
274 #endif /* HAL_CORTEX_MODULE_ENABLED */
275
276 #ifdef HAL_ADC_MODULE_ENABLED
277 #include "stm32l4xx_hal_adc.h"
278 #endif /* HAL_ADC_MODULE_ENABLED */
279
280 #ifdef HAL_CAN_MODULE_ENABLED
281 #include "stm32l4xx_hal_can.h"
282 #endif /* HAL_CAN_MODULE_ENABLED */
283
284 #ifdef HAL_CAN_LEGACY_MODULE_ENABLED
285 #include "Legacy/stm32l4xx_hal_can_legacy.h"
286 #endif /* HAL_CAN_LEGACY_MODULE_ENABLED */
287
288 #ifdef HAL_COMP_MODULE_ENABLED
289 #include "stm32l4xx_hal_comp.h"
290 #endif /* HAL_COMP_MODULE_ENABLED */
291
292 #ifdef HAL_CRC_MODULE_ENABLED
293 #include "stm32l4xx_hal_crc.h"
294 #endif /* HAL_CRC_MODULE_ENABLED */
295
296 #ifdef HAL_CRYP_MODULE_ENABLED
297 #include "stm32l4xx_hal_cryp.h"
298 #endif /* HAL_CRYP_MODULE_ENABLED */
299
300 #ifdef HAL_DAC_MODULE_ENABLED
301 #include "stm32l4xx_hal_dac.h"
302 #endif /* HAL_DAC_MODULE_ENABLED */
303
304 #ifdef HAL_DCMI_MODULE_ENABLED
305 #include "stm32l4xx_hal_dcmi.h"
306 #endif /* HAL_DCMI_MODULE_ENABLED */
307
308 #ifdef HAL_DMA2D_MODULE_ENABLED
309 #include "stm32l4xx_hal_dma2d.h"
310 #endif /* HAL_DMA2D_MODULE_ENABLED */
311
312 #ifdef HAL_DSI_MODULE_ENABLED
313 #include "stm32l4xx_hal_dsi.h"
314 #endif /* HAL_DSI_MODULE_ENABLED */
315
316 #ifdef HAL_EXTI_MODULE_ENABLED
317 #include "stm32l4xx_hal_exti.h"
318 #endif /* HAL_EXTI_MODULE_ENABLED */
319
320 #ifdef HAL_GFXMMU_MODULE_ENABLED
321 #include "stm32l4xx_hal_gfxmmu.h"
322 #endif /* HAL_GFXMMU_MODULE_ENABLED */
323
324 #ifdef HAL_FIREWALL_MODULE_ENABLED
325 #include "stm32l4xx_hal_firewall.h"
326 #endif /* HAL_FIREWALL_MODULE_ENABLED */
327
328 #ifdef HAL_FLASH_MODULE_ENABLED
329 #include "stm32l4xx_hal_flash.h"
330 #endif /* HAL_FLASH_MODULE_ENABLED */
331
332 #ifdef HAL_HASH_MODULE_ENABLED
333 #include "stm32l4xx_hal_hash.h"
334 #endif /* HAL_HASH_MODULE_ENABLED */
335
336 #ifdef HAL_HCD_MODULE_ENABLED
337 #include "stm32l4xx_hal_hcd.h"
338 #endif /* HAL_HCD_MODULE_ENABLED */
339
340 #ifdef HAL_I2C_MODULE_ENABLED
341 #include "stm32l4xx_hal_i2c.h"
342 #endif /* HAL_I2C_MODULE_ENABLED */
343
344 #ifdef HAL_IRDA_MODULE_ENABLED
345 #include "stm32l4xx_hal_irda.h"
346 #endif /* HAL_IRDA_MODULE_ENABLED */
347
348 #ifdef HAL_IWDG_MODULE_ENABLED
349 #include "stm32l4xx_hal_iwdg.h"
350 #endif /* HAL_IWDG_MODULE_ENABLED */
351
352 #ifdef HAL_LCD_MODULE_ENABLED
353 #include "stm32l4xx_hal_lcd.h"
354 #endif /* HAL_LCD_MODULE_ENABLED */
355
356 #ifdef HAL_LPTIM_MODULE_ENABLED
357 #include "stm32l4xx_hal_lptim.h"
358 #endif /* HAL_LPTIM_MODULE_ENABLED */
359
360 #ifdef HAL_LTDC_MODULE_ENABLED
361 #include "stm32l4xx_hal_ltdc.h"
362 #endif /* HAL_LTDC_MODULE_ENABLED */
363
364 #ifdef HAL_MMC_MODULE_ENABLED
365 #include "stm32l4xx_hal_mmc.h"
366 #endif /* HAL_MMC_MODULE_ENABLED */
367
368 #ifdef HAL_NAND_MODULE_ENABLED
369 #include "stm32l4xx_hal_nand.h"
370 #endif /* HAL_NAND_MODULE_ENABLED */
371
372 #ifdef HAL_NOR_MODULE_ENABLED
373 #include "stm32l4xx_hal_nor.h"
374 #endif /* HAL_NOR_MODULE_ENABLED */
375
376 #ifdef HAL_OPAMP_MODULE_ENABLED
377 #include "stm32l4xx_hal_opamp.h"
378 #endif /* HAL_OPAMP_MODULE_ENABLED */
379
380 #ifdef HAL_OSPI_MODULE_ENABLED
381 #include "stm32l4xx_hal_ospi.h"
382 #endif /* HAL_OSPI_MODULE_ENABLED */
383
384 #ifdef HAL_PCD_MODULE_ENABLED
385 #include "stm32l4xx_hal_pcd.h"
386 #endif /* HAL_PCD_MODULE_ENABLED */
387
388 #ifdef HAL_PKA_MODULE_ENABLED
389 #include "stm32l4xx_hal_pka.h"
390 #endif /* HAL_PKA_MODULE_ENABLED */
391
392 #ifdef HAL_PSSI_MODULE_ENABLED
393 #include "stm32l4xx_hal_pssi.h"
394 #endif /* HAL_PSSI_MODULE_ENABLED */
395
396 #ifdef HAL_PWR_MODULE_ENABLED
397 #include "stm32l4xx_hal_pwr.h"
398 #endif /* HAL_PWR_MODULE_ENABLED */
399
400 #ifdef HAL_QSPI_MODULE_ENABLED
401 #include "stm32l4xx_hal_qspi.h"
402 #endif /* HAL_QSPI_MODULE_ENABLED */
403
404 #ifdef HAL_RNG_MODULE_ENABLED
405 #include "stm32l4xx_hal_rng.h"
406 #endif /* HAL_RNG_MODULE_ENABLED */
407
408 #ifdef HAL_RTC_MODULE_ENABLED
409 #include "stm32l4xx_hal_rtc.h"
410 #endif /* HAL_RTC_MODULE_ENABLED */
411
412 #ifdef HAL_SAI_MODULE_ENABLED
413 #include "stm32l4xx_hal_sai.h"
414 #endif /* HAL_SAI_MODULE_ENABLED */
415
416 #ifdef HAL_SD_MODULE_ENABLED
417 #include "stm32l4xx_hal_sd.h"
418 #endif /* HAL_SD_MODULE_ENABLED */
419
420 #ifdef HAL_SMARTCARD_MODULE_ENABLED
421 #include "stm32l4xx_hal_smartcard.h"
422 #endif /* HAL_SMARTCARD_MODULE_ENABLED */
423
424 #ifdef HAL_SMBUS_MODULE_ENABLED
425 #include "stm32l4xx_hal_smbus.h"
426 #endif /* HAL_SMBUS_MODULE_ENABLED */
427
428 #ifdef HAL_SPI_MODULE_ENABLED
429 #include "stm32l4xx_hal_spi.h"
430 #endif /* HAL_SPI_MODULE_ENABLED */
431
432 #ifdef HAL_SRAM_MODULE_ENABLED
433 #include "stm32l4xx_hal_sram.h"
434 #endif /* HAL_SRAM_MODULE_ENABLED */
435
436 #ifdef HAL_SWPMI_MODULE_ENABLED
437 #include "stm32l4xx_hal_swpmi.h"
438 #endif /* HAL_SWPMI_MODULE_ENABLED */
439
440 #ifdef HAL_TIM_MODULE_ENABLED
441 #include "stm32l4xx_hal_tim.h"
442 #endif /* HAL_TIM_MODULE_ENABLED */
443
444 #ifdef HAL_TSC_MODULE_ENABLED
445 #include "stm32l4xx_hal_tsc.h"
446 #endif /* HAL_TSC_MODULE_ENABLED */
447
448 #ifdef HAL_UART_MODULE_ENABLED
449 #include "stm32l4xx_hal_uart.h"
450 #endif /* HAL_UART_MODULE_ENABLED */
451
452 #ifdef HAL_USART_MODULE_ENABLED
453 #include "stm32l4xx_hal_usart.h"
454 #endif /* HAL_USART_MODULE_ENABLED */
455
456 #ifdef HAL_WWDG_MODULE_ENABLED
457 #include "stm32l4xx_hal_wwdg.h"
458 #endif /* HAL_WWDG_MODULE_ENABLED */
459
460 /* Exported macro ------------------------------------------------------------*/
461 #ifdef USE_FULL_ASSERT
462 /**
463 * @brief The assert_param macro is used for function's parameters check.
464 * @param expr If expr is false, it calls assert_failed function
465 * which reports the name of the source file and the source
466 * line number of the call that failed.
467 * If expr is true, it returns no value.
468 * @retval None
469 */
470 #define assert_param(expr) ((expr) ? (void)0U : assert_failed((uint8_t *)__FILE__, __LINE__))
471 /* Exported functions ------------------------------------------------------- */
472 void assert_failed(uint8_t *file, uint32_t line);
473 #else
474 #define assert_param(expr) ((void)0U)
475 #endif /* USE_FULL_ASSERT */
476
477 #ifdef __cplusplus
478 }
479 #endif
480
481 #endif /* STM32L4xx_HAL_CONF_H */
482
483 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/