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