HAL库源文件stm32h7xx_hal_conf.h学习笔记，专门用于HAL库配置（2018-07-26 V1.0）

eric2013

说明：

这个文件是HAL库专用的配置文件，如同FreeRTOS的FreeRTOSConfig.h文件。
当前使用这个文件最主要是外部晶振的配置，一定要保证这里HSE_VALUE的大小跟外部晶振的实际大小匹配。

其它的配置暂时还用不到，另外为了方便此文件的修改，将其也添加到工程里面：

1. /**
   
2.   ******************************************************************************
   
3.   * @file    stm32h7xx_hal_conf_template.h
   
4.   * @author  MCD Application Team
   
5.   * @version V1.2.0
   
6.   * @date    29-December-2017
   
7.   * @brief   HAL configuration template file.
   
8.   *          This file should be copied to the application folder and renamed
   
9.   *          to stm32h7xx_hal_conf.h.
   
10.   ******************************************************************************
    
11.   * @attention
    
12.   *
    
13.   * <h2><center>&#169; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
    
14.   *
    
15.   * Redistribution and use in source and binary forms, with or without modification,
    
16.   * are permitted provided that the following conditions are met:
    
17.   *   1. Redistributions of source code must retain the above copyright notice,
    
18.   *      this list of conditions and the following disclaimer.
    
19.   *   2. Redistributions in binary form must reproduce the above copyright notice,
    
20.   *      this list of conditions and the following disclaimer in the documentation
    
21.   *      and/or other materials provided with the distribution.
    
22.   *   3. Neither the name of STMicroelectronics nor the names of its contributors
    
23.   *      may be used to endorse or promote products derived from this software
    
24.   *      without specific prior written permission.
    
25.   *
    
26.   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    
27.   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    
28.   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    
29.   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
    
30.   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    
31.   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
    
32.   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
    
33.   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    
34.   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    
35.   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    
36.   *
    
37.   ******************************************************************************
    
38.   */
    
39. 
    
40. /* Define to prevent recursive inclusion -------------------------------------*/
    
41. #ifndef __STM32H7xx_HAL_CONF_H
    
42. #define __STM32H7xx_HAL_CONF_H
    
43. 
    
44. #ifdef __cplusplus
    
45. extern "C" {
    
46. #endif
    
47. 
    
48. /* Exported types ------------------------------------------------------------*/
    
49. /* Exported constants --------------------------------------------------------*/
    
50. 
    
51. /* ########################## Module Selection ############################## */
    
52. /**
    
53.   * @brief This is the list of modules to be used in the HAL driver
    
54.   */
    
55. #define HAL_MODULE_ENABLED
    
56. #define HAL_ADC_MODULE_ENABLED
    
57. #define HAL_CEC_MODULE_ENABLED
    
58. #define HAL_COMP_MODULE_ENABLED
    
59. #define HAL_CORTEX_MODULE_ENABLED
    
60. #define HAL_CRC_MODULE_ENABLED
    
61. #define HAL_CRYP_MODULE_ENABLED
    
62. #define HAL_DAC_MODULE_ENABLED
    
63. #define HAL_DCMI_MODULE_ENABLED
    
64. #define HAL_DFSDM_MODULE_ENABLED
    
65. #define HAL_DMA_MODULE_ENABLED
    
66. #define HAL_DMA2D_MODULE_ENABLED
    
67. #define HAL_ETH_MODULE_ENABLED
    
68. #define HAL_FDCAN_MODULE_ENABLED
    
69. #define HAL_FLASH_MODULE_ENABLED
    
70. #define HAL_GPIO_MODULE_ENABLED
    
71. #define HAL_HASH_MODULE_ENABLED
    
72. #define HAL_HCD_MODULE_ENABLED
    
73. #define HAL_HRTIM_MODULE_ENABLED
    
74. #define HAL_HSEM_MODULE_ENABLED
    
75. #define HAL_I2C_MODULE_ENABLED
    
76. #define HAL_I2S_MODULE_ENABLED
    
77. #define HAL_IRDA_MODULE_ENABLED
    
78. #define HAL_IWDG_MODULE_ENABLED
    
79. #define HAL_JPEG_MODULE_ENABLED
    
80. #define HAL_LPTIM_MODULE_ENABLED
    
81. #define HAL_LTDC_MODULE_ENABLED
    
82. #define HAL_MDIOS_MODULE_ENABLED
    
83. #define HAL_MDMA_MODULE_ENABLED
    
84. #define HAL_MMC_MODULE_ENABLED
    
85. #define HAL_NAND_MODULE_ENABLED
    
86. #define HAL_NOR_MODULE_ENABLED
    
87. #define HAL_OPAMP_MODULE_ENABLED   
    
88. #define HAL_PCD_MODULE_ENABLED
    
89. #define HAL_PWR_MODULE_ENABLED
    
90. #define HAL_QSPI_MODULE_ENABLED   
    
91. #define HAL_RCC_MODULE_ENABLED
    
92. #define HAL_RNG_MODULE_ENABLED
    
93. #define HAL_RTC_MODULE_ENABLED
    
94. #define HAL_SAI_MODULE_ENABLED
    
95. #define HAL_SD_MODULE_ENABLED
    
96. #define HAL_SDRAM_MODULE_ENABLED
    
97. #define HAL_SMARTCARD_MODULE_ENABLED
    
98. #define HAL_SMBUS_MODULE_ENABLED
    
99. #define HAL_SPDIFRX_MODULE_ENABLED
    
100. #define HAL_SPI_MODULE_ENABLED
     
101. #define HAL_SRAM_MODULE_ENABLED
     
102. #define HAL_SWPMI_MODULE_ENABLED
     
103. #define HAL_TIM_MODULE_ENABLED
     
104. #define HAL_UART_MODULE_ENABLED
     
105. #define HAL_USART_MODULE_ENABLED
     
106. #define HAL_WWDG_MODULE_ENABLED
     
107. 
     
108. /* ########################## Oscillator Values adaptation ####################*/
     
109. /**
     
110.   * @brief Adjust the value of External High Speed oscillator (HSE) used in your application.
     
111.   *        This value is used by the RCC HAL module to compute the system frequency
     
112.   *        (when HSE is used as system clock source, directly or through the PLL).  
     
113.   */
     
114. #if !defined  (HSE_VALUE)
     
115. #define HSE_VALUE    ((uint32_t)8000000) /*!< Value of the External oscillator in Hz */
     
116. #endif /* HSE_VALUE */
     
117. 
     
118. #if !defined  (HSE_STARTUP_TIMEOUT)
     
119.   #define HSE_STARTUP_TIMEOUT    ((uint32_t)5000)   /*!< Time out for HSE start up, in ms */
     
120. #endif /* HSE_STARTUP_TIMEOUT */
     
121. 
     
122. /**
     
123.   * @brief Internal  oscillator (CSI) default value.
     
124.   *        This value is the default CSI value after Reset.
     
125.   */
     
126. #if !defined  (CSI_VALUE)
     
127.   #define CSI_VALUE    ((uint32_t)4000000) /*!< Value of the Internal oscillator in Hz*/
     
128. #endif /* CSI_VALUE */
     
129.    
     
130. /**
     
131.   * @brief Internal High Speed oscillator (HSI) value.
     
132.   *        This value is used by the RCC HAL module to compute the system frequency
     
133.   *        (when HSI is used as system clock source, directly or through the PLL).
     
134.   */
     
135. #if !defined  (HSI_VALUE)
     
136.   #define HSI_VALUE    ((uint32_t)64000000) /*!< Value of the Internal oscillator in Hz*/
     
137. #endif /* HSI_VALUE */
     
138. 
     
139. /**
     
140.   * @brief External Low Speed oscillator (LSE) value.
     
141.   *        This value is used by the UART, RTC HAL module to compute the system frequency
     
142.   */
     
143. #if !defined  (LSE_VALUE)
     
144.   #define LSE_VALUE    ((uint32_t)32768) /*!< Value of the External oscillator in Hz*/
     
145. #endif /* LSE_VALUE */
     
146. 
     
147.    
     
148. #if !defined  (LSE_STARTUP_TIMEOUT)
     
149.   #define LSE_STARTUP_TIMEOUT    ((uint32_t)5000)   /*!< Time out for LSE start up, in ms */
     
150. #endif /* LSE_STARTUP_TIMEOUT */
     
151. 
     
152. /**
     
153.   * @brief External clock source for I2S peripheral
     
154.   *        This value is used by the I2S HAL module to compute the I2S clock source
     
155.   *        frequency, this source is inserted directly through I2S_CKIN pad.
     
156.   */
     
157. #if !defined  (EXTERNAL_CLOCK_VALUE)
     
158.   #define EXTERNAL_CLOCK_VALUE    12288000U /*!< Value of the External clock in Hz*/
     
159. #endif /* EXTERNAL_CLOCK_VALUE */
     
160. 
     
161. /* Tip: To avoid modifying this file each time you need to use different HSE,
     
162.    ===  you can define the HSE value in your toolchain compiler preprocessor. */
     
163. 
     
164. /* ########################### System Configuration ######################### */
     
165. /**
     
166.   * @brief This is the HAL system configuration section
     
167.   */     
     
168. #define  VDD_VALUE                    ((uint32_t)3300) /*!< Value of VDD in mv */
     
169. #define  TICK_INT_PRIORITY            ((uint32_t)0x0F) /*!< tick interrupt priority */
     
170. #define  USE_RTOS                     0
     
171. /* #define  USE_SD_TRANSCEIVER           1U   */            /*!< use uSD Transceiver */
     
172. 
     
173. /* ########################### Ethernet Configuration ######################### */
     
174. #define ETH_TX_DESC_CNT         4  /* number of Ethernet Tx DMA descriptors */
     
175. #define ETH_RX_DESC_CNT         4  /* number of Ethernet Rx DMA descriptors */
     
176. 
     
177. #define ETH_MAC_ADDR0    ((uint8_t)0x02)
     
178. #define ETH_MAC_ADDR1    ((uint8_t)0x00)
     
179. #define ETH_MAC_ADDR2    ((uint8_t)0x00)
     
180. #define ETH_MAC_ADDR3    ((uint8_t)0x00)
     
181. #define ETH_MAC_ADDR4    ((uint8_t)0x00)
     
182. #define ETH_MAC_ADDR5    ((uint8_t)0x00)
     
183. 
     
184. /* ########################## Assert Selection ############################## */
     
185. /**
     
186.   * @brief Uncomment the line below to expanse the "assert_param" macro in the
     
187.   *        HAL drivers code
     
188.   */
     
189. /* #define USE_FULL_ASSERT    1 */
     
190. 
     
191. 
     
192. /* ################## SPI peripheral configuration ########################## */
     
193. /**
     
194.   * @brief Used to activate CRC feature inside HAL SPI Driver
     
195.   *        Activated   (1U): CRC code is compiled within HAL SPI driver
     
196.   *        Deactivated (0U): CRC code excluded from HAL SPI driver
     
197.   */
     
198. 
     
199. #define USE_SPI_CRC                   1U
     
200. 
     
201. 
     
202. /* Includes ------------------------------------------------------------------*/
     
203. /**
     
204.   * @brief Include module's header file
     
205.   */
     
206. 
     
207. #ifdef HAL_RCC_MODULE_ENABLED
     
208.   #include "stm32h7xx_hal_rcc.h"
     
209. #endif /* HAL_RCC_MODULE_ENABLED */
     
210. 
     
211. #ifdef HAL_GPIO_MODULE_ENABLED
     
212.   #include "stm32h7xx_hal_gpio.h"
     
213. #endif /* HAL_GPIO_MODULE_ENABLED */
     
214. 
     
215. #ifdef HAL_DMA_MODULE_ENABLED
     
216.   #include "stm32h7xx_hal_dma.h"
     
217. #endif /* HAL_DMA_MODULE_ENABLED */
     
218. 
     
219. #ifdef HAL_HASH_MODULE_ENABLED
     
220.   #include "stm32h7xx_hal_hash.h"
     
221. #endif /* HAL_HASH_MODULE_ENABLED */
     
222. 
     
223. #ifdef HAL_DCMI_MODULE_ENABLED
     
224.   #include "stm32h7xx_hal_dcmi.h"
     
225. #endif /* HAL_DCMI_MODULE_ENABLED */
     
226. 
     
227. #ifdef HAL_DMA2D_MODULE_ENABLED
     
228.   #include "stm32h7xx_hal_dma2d.h"
     
229. #endif /* HAL_DMA2D_MODULE_ENABLED */
     
230. 
     
231. #ifdef HAL_DFSDM_MODULE_ENABLED
     
232.   #include "stm32h7xx_hal_dfsdm.h"
     
233. #endif /* HAL_DFSDM_MODULE_ENABLED */
     
234. 
     
235. #ifdef HAL_ETH_MODULE_ENABLED
     
236.   #include "stm32h7xx_hal_eth.h"
     
237. #endif /* HAL_ETH_MODULE_ENABLED */
     
238. 
     
239. #ifdef HAL_CORTEX_MODULE_ENABLED
     
240.   #include "stm32h7xx_hal_cortex.h"
     
241. #endif /* HAL_CORTEX_MODULE_ENABLED */
     
242. 
     
243. #ifdef HAL_ADC_MODULE_ENABLED
     
244.   #include "stm32h7xx_hal_adc.h"
     
245. #endif /* HAL_ADC_MODULE_ENABLED */
     
246. 
     
247. #ifdef HAL_FDCAN_MODULE_ENABLED
     
248.   #include "stm32h7xx_hal_fdcan.h"
     
249. #endif /* HAL_FDCAN_MODULE_ENABLED */
     
250. 
     
251. #ifdef HAL_CEC_MODULE_ENABLED
     
252.   #include "stm32h7xx_hal_cec.h"
     
253. #endif /* HAL_CEC_MODULE_ENABLED */
     
254. 
     
255. #ifdef HAL_COMP_MODULE_ENABLED
     
256.   #include "stm32h7xx_hal_comp.h"
     
257. #endif /* HAL_COMP_MODULE_ENABLED */
     
258. 
     
259. #ifdef HAL_CRC_MODULE_ENABLED
     
260.   #include "stm32h7xx_hal_crc.h"
     
261. #endif /* HAL_CRC_MODULE_ENABLED */
     
262. 
     
263. #ifdef HAL_CRYP_MODULE_ENABLED
     
264.   #include "stm32h7xx_hal_cryp.h"
     
265. #endif /* HAL_CRYP_MODULE_ENABLED */
     
266. 
     
267. #ifdef HAL_DAC_MODULE_ENABLED
     
268.   #include "stm32h7xx_hal_dac.h"
     
269. #endif /* HAL_DAC_MODULE_ENABLED */
     
270. 
     
271. #ifdef HAL_FLASH_MODULE_ENABLED
     
272.   #include "stm32h7xx_hal_flash.h"
     
273. #endif /* HAL_FLASH_MODULE_ENABLED */
     
274. 
     
275. #ifdef HAL_HRTIM_MODULE_ENABLED
     
276.   #include "stm32h7xx_hal_hrtim.h"
     
277. #endif /* HAL_HRTIM_MODULE_ENABLED */
     
278. 
     
279. #ifdef HAL_HSEM_MODULE_ENABLED
     
280.   #include "stm32h7xx_hal_hsem.h"
     
281. #endif /* HAL_HSEM_MODULE_ENABLED */
     
282. 
     
283. #ifdef HAL_SRAM_MODULE_ENABLED
     
284.   #include "stm32h7xx_hal_sram.h"
     
285. #endif /* HAL_SRAM_MODULE_ENABLED */
     
286. 
     
287. #ifdef HAL_NOR_MODULE_ENABLED
     
288.   #include "stm32h7xx_hal_nor.h"
     
289. #endif /* HAL_NOR_MODULE_ENABLED */
     
290. 
     
291. #ifdef HAL_NAND_MODULE_ENABLED
     
292.   #include "stm32h7xx_hal_nand.h"
     
293. #endif /* HAL_NAND_MODULE_ENABLED */
     
294.       
     
295. #ifdef HAL_I2C_MODULE_ENABLED
     
296. #include "stm32h7xx_hal_i2c.h"
     
297. #endif /* HAL_I2C_MODULE_ENABLED */
     
298. 
     
299. #ifdef HAL_I2S_MODULE_ENABLED
     
300. #include "stm32h7xx_hal_i2s.h"
     
301. #endif /* HAL_I2S_MODULE_ENABLED */
     
302. 
     
303. #ifdef HAL_IWDG_MODULE_ENABLED
     
304. #include "stm32h7xx_hal_iwdg.h"
     
305. #endif /* HAL_IWDG_MODULE_ENABLED */
     
306. 
     
307. #ifdef HAL_JPEG_MODULE_ENABLED
     
308. #include "stm32h7xx_hal_jpeg.h"
     
309. #endif /* HAL_JPEG_MODULE_ENABLED */
     
310. 
     
311. #ifdef HAL_MDIOS_MODULE_ENABLED
     
312. #include "stm32h7xx_hal_mdios.h"
     
313. #endif /* HAL_MDIOS_MODULE_ENABLED */
     
314. 
     
315. #ifdef HAL_MDMA_MODULE_ENABLED
     
316. #include "stm32h7xx_hal_mdma.h"
     
317. #endif /* HAL_MDMA_MODULE_ENABLED */
     
318. 
     
319. #ifdef HAL_MMC_MODULE_ENABLED
     
320. #include "stm32h7xx_hal_mmc.h"
     
321. #endif /* HAL_MMC_MODULE_ENABLED */
     
322.    
     
323. #ifdef HAL_LPTIM_MODULE_ENABLED
     
324. #include "stm32h7xx_hal_lptim.h"
     
325. #endif /* HAL_LPTIM_MODULE_ENABLED */
     
326. 
     
327. #ifdef HAL_LTDC_MODULE_ENABLED
     
328. #include "stm32h7xx_hal_ltdc.h"
     
329. #endif /* HAL_LTDC_MODULE_ENABLED */
     
330. 
     
331. #ifdef HAL_OPAMP_MODULE_ENABLED
     
332. #include "stm32h7xx_hal_opamp.h"
     
333. #endif /* HAL_OPAMP_MODULE_ENABLED */
     
334.    
     
335. #ifdef HAL_PWR_MODULE_ENABLED
     
336. #include "stm32h7xx_hal_pwr.h"
     
337. #endif /* HAL_PWR_MODULE_ENABLED */
     
338. 
     
339. #ifdef HAL_QSPI_MODULE_ENABLED
     
340. #include "stm32h7xx_hal_qspi.h"
     
341. #endif /* HAL_QSPI_MODULE_ENABLED */
     
342.    
     
343. #ifdef HAL_RNG_MODULE_ENABLED
     
344. #include "stm32h7xx_hal_rng.h"
     
345. #endif /* HAL_RNG_MODULE_ENABLED */
     
346. 
     
347. #ifdef HAL_RTC_MODULE_ENABLED
     
348. #include "stm32h7xx_hal_rtc.h"
     
349. #endif /* HAL_RTC_MODULE_ENABLED */
     
350. 
     
351. #ifdef HAL_SAI_MODULE_ENABLED
     
352. #include "stm32h7xx_hal_sai.h"
     
353. #endif /* HAL_SAI_MODULE_ENABLED */
     
354. 
     
355. #ifdef HAL_SD_MODULE_ENABLED
     
356. #include "stm32h7xx_hal_sd.h"
     
357. #endif /* HAL_SD_MODULE_ENABLED */
     
358. 
     
359. #ifdef HAL_SDRAM_MODULE_ENABLED
     
360. #include "stm32h7xx_hal_sdram.h"
     
361. #endif /* HAL_SDRAM_MODULE_ENABLED */
     
362.    
     
363. #ifdef HAL_SPI_MODULE_ENABLED
     
364. #include "stm32h7xx_hal_spi.h"
     
365. #endif /* HAL_SPI_MODULE_ENABLED */
     
366. 
     
367. #ifdef HAL_SPDIFRX_MODULE_ENABLED
     
368. #include "stm32h7xx_hal_spdifrx.h"
     
369. #endif /* HAL_SPDIFRX_MODULE_ENABLED */
     
370. 
     
371. #ifdef HAL_SWPMI_MODULE_ENABLED
     
372. #include "stm32h7xx_hal_swpmi.h"
     
373. #endif /* HAL_SWPMI_MODULE_ENABLED */
     
374. 
     
375. #ifdef HAL_TIM_MODULE_ENABLED
     
376. #include "stm32h7xx_hal_tim.h"
     
377. #endif /* HAL_TIM_MODULE_ENABLED */
     
378. 
     
379. #ifdef HAL_UART_MODULE_ENABLED
     
380. #include "stm32h7xx_hal_uart.h"
     
381. #endif /* HAL_UART_MODULE_ENABLED */
     
382. 
     
383. #ifdef HAL_USART_MODULE_ENABLED
     
384. #include "stm32h7xx_hal_usart.h"
     
385. #endif /* HAL_USART_MODULE_ENABLED */
     
386. 
     
387. #ifdef HAL_IRDA_MODULE_ENABLED
     
388. #include "stm32h7xx_hal_irda.h"
     
389. #endif /* HAL_IRDA_MODULE_ENABLED */
     
390. 
     
391. #ifdef HAL_SMARTCARD_MODULE_ENABLED
     
392. #include "stm32h7xx_hal_smartcard.h"
     
393. #endif /* HAL_SMARTCARD_MODULE_ENABLED */
     
394. 
     
395. #ifdef HAL_SMBUS_MODULE_ENABLED
     
396. #include "stm32h7xx_hal_smbus.h"
     
397. #endif /* HAL_SMBUS_MODULE_ENABLED */
     
398. 
     
399. #ifdef HAL_WWDG_MODULE_ENABLED
     
400. #include "stm32h7xx_hal_wwdg.h"
     
401. #endif /* HAL_WWDG_MODULE_ENABLED */
     
402.    
     
403. #ifdef HAL_PCD_MODULE_ENABLED
     
404. #include "stm32h7xx_hal_pcd.h"
     
405. #endif /* HAL_PCD_MODULE_ENABLED */
     
406. 
     
407. #ifdef HAL_HCD_MODULE_ENABLED
     
408. #include "stm32h7xx_hal_hcd.h"
     
409. #endif /* HAL_HCD_MODULE_ENABLED */
     
410.    
     
411. /* Exported macro ------------------------------------------------------------*/
     
412. #ifdef  USE_FULL_ASSERT
     
413. /**
     
414.   * @brief  The assert_param macro is used for function's parameters check.
     
415.   * @param  expr: If expr is false, it calls assert_failed function
     
416.   *         which reports the name of the source file and the source
     
417.   *         line number of the call that failed.
     
418.   *         If expr is true, it returns no value.
     
419.   * @retval None
     
420.   */
     
421.   #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))
     
422. /* Exported functions ------------------------------------------------------- */
     
423.   void assert_failed(uint8_t* file, uint32_t line);
     
424. #else
     
425.   #define assert_param(expr) ((void)0)
     
426. #endif /* USE_FULL_ASSERT */
     
427. 
     
428. #ifdef __cplusplus
     
429. }
     
430. #endif
     
431. 
     
432. #endif /* __STM32H7xx_HAL_CONF_H */
     
433. 
     
434. 
     
435. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
     

复制代码