stm32f10x.h解析

只看该作者 · 2021-5-21 13:34

这里是STM32比较重要的头文件

******************************************************************************
ST版本库的 stm32f10x.h 文件，包含整个头文件代码。综合以上，可以看出 stm32f10x.h 用于定义了器件、中断线、数据类型、结构体封装的寄存器、寄存器地址映射、寄存器位操作以及防C++编译的条件编译。

复制

* [url=home.php?mod=space&uid=288409]@file[/url]    stm32f10x.h                      ST 标准头文件



  * [url=home.php?mod=space&uid=187600]@author[/url]  MCD Application Team     微控制器开发小组。

  * [url=home.php?mod=space&uid=895143]@version[/url] V3.5.0                               版本

  * [url=home.php?mod=space&uid=212281]@date[/url]    11-March-2011                    2011年3月11

  * [url=home.php?mod=space&uid=247401]@brief[/url]   CMSIS Cortex-M3 Device Peripheral Access Layer Header File.(CMSIS：Cortex Microcontroller Software Interface Standard) 是 Cortex-M 处理器系列的与供应商无关的硬件抽象层。  

  *          This file contains all the peripheral register's definitions, bits    

  *          definitions and memory mapping for STM32F10x Connectivity line, 

  *          High density, High density value line, Medium density, 

  *          Medium density Value line, Low density, Low density Value line 

  *          and XL-density devices.

只看该作者 · 2021-5-21 13:38

* 这个文件包含了芯片STM32F10X（接口增强型）内部的寄存器定义，位定义，内存地址变换定义，还有一些相应的高密度，低密度产品线的设备。

复制

 *          The file is the unique include file that the application programmer

  *          is using in the C source code, usually in main.c. This file contains:

  *           - Configuration section that allows to select:

  *              - The device used in the target application

  *              - To use or not the peripherals drivers in application code(i.e. 

  *                code will be based on direct access to peripherals registers 

  *                rather than drivers API), this option is controlled by 

  *                "#define USE_STDPERIPH_DRIVER"

  *              - To change few application-specific parameters such as the HSE 

  *                crystal frequency

  *           - Data structures and the address mapping for all peripherals

  *           - Peripheral's registers declarations and bits definition

  *           - Macros to access peripheral registers hardware

只看该作者 · 2021-5-21 13:39

*这个文件在应用程序中是至关重要的头文件，它是用C代码编写而成。通常包括在MAIN主程序中。它包括：1 设备中使用的目标应用程序。
2 决定是否使用外部设备的代码（例如使用基于寄存器的代码，而不是我们所熟悉的API应用程序接口代码）。这一设备可以通过设置 “#define USE_STDPERIPH_DRIVER” 来实现。
3 通过这一文件可以改变诸如外部设备的频率参数。
4 可以了解程序的数据结构以及外设的地址映射。
5 外设的寄存器声明和位定义可以在这个文件里面了解到。

复制

******************************************************************************

  * @attention

  *

  * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS

  * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE

  * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY

  * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING

  * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE

  * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.

  *注意：这一文件代码供应给用户，旨在帮助用户提升效率节约时间。ST将不会提供任何对于用户自己代码的解释和帮助。也不会解决其在代码中的任何BUG。

  * <h2><center>? COPYRIGHT 2011 STMicroelectronics</center></h2>

只看该作者 · 2021-5-21 13:41

*/

/** @addtogroup CMSIS

@{
*/这个不需要关心，只是说明这个文件的作者，公司产品等等，你贴出来的估计是小小的广而告之，这也是程序员的一点小小的特权嘛
/** @addtogroup stm32f10x

@{
*/
#ifndef __STM32F10x_H//如果没有定义__STM32F10x_H ，则定义__STM32F10x_H
#define __STM32F10x_H

#ifdef __cplusplus//
extern “C” {
#endif
这里是一种条件编译。extern "C"指令非常有用，因为C和C++的近亲关系。注意：extern "C"指令中的C，表示的一种编译和连接规约，而不是一种语言。C表示符合C语言的编译和连接规约的任何语言，如Fortran、assembler等。

还有要说明的是，extern "C"指令仅指定编译和连接规约，但不影响语义。例如在函数声明中，指定了extern “C”，仍然要遵守C++的类型检测、参数转换规则。
一开始我不解 extern “C” { 这个语句的意思，原来是用来说明后面的定义都是使用C语言写的。这个 __cplusplus 是指C++来的，4、5句的意思就是说如果用C++编译器的话，它里面是定义有__cplusplus 这个的，而通过 extern “C” { 告知编译器，这段代码是用C编写的，要按照C语言编译。这是因为C++里面有函数重载，编译的时候把参数也编译了，而C的话，编译只编译函数名。
/** @addtogroup Library_configuration_section

@{
*/
/* Uncomment the line below according to the target STM32 device used in your
application
*/

#if !defined (STM32F10X_LD) && !defined (STM32F10X_LD_VL) && !defined (STM32F10X_MD) && !defined (STM32F10X_MD_VL) && !defined (STM32F10X_HD) && !defined (STM32F10X_HD_VL) && !defined (STM32F10X_XL) && !defined (STM32F10X_CL)
/* #define STM32F10X_LD / /!< STM32F10X_LD: STM32 Low density devices /
/ #define STM32F10X_LD_VL / /!< STM32F10X_LD_VL: STM32 Low density Value Line devices /
/ #define STM32F10X_MD / /!< STM32F10X_MD: STM32 Medium density devices /
/ #define STM32F10X_MD_VL / /!< STM32F10X_MD_VL: STM32 Medium density Value Line devices /
/ #define STM32F10X_HD / /!< STM32F10X_HD: STM32 High density devices /
/ #define STM32F10X_HD_VL / /!< STM32F10X_HD_VL: STM32 High density value line devices /
/ #define STM32F10X_XL / /!< STM32F10X_XL: STM32 XL-density devices /
/ #define STM32F10X_CL / /!< STM32F10X_CL: STM32 Connectivity line devices */
#endif

只看该作者 · 2021-5-21 13:42

STM32启动文件选择：

startup_stm32f10x_ld_vl.s: for STM32 Low density Value line devices - startup_stm32f10x_ld.s: for STM32 Low density devices - startup_stm32f10x_md_vl.s: for STM32 Medium density Value line devices - startup_stm32f10x_md.s: for STM32 Medium density devices - startup_stm32f10x_hd.s: for STM32 High density devices - startup_stm32f10x_xl.s: for STM32 XL density devices - startup_stm32f10x_cl.s: for STM32 Connectivity line devices
cl：互联型产品，stm32f105/107系列
vl：超值型产品，stm32f100系列
xl：超高密度产品，stm32f101/103系列
ld：低密度产品，FLASH小于64K
md：中等密度产品，FLASH=64 or 128
hd：高密度产品，FLASH大于128
/* Tip: To avoid modifying this file each time you need to switch between these
devices, you can define the device in your toolchain compiler preprocessor.
提示：为了避免每次编译都要修改这些文件，意思是可以使用编译器的preprocessor选项来定义芯片型号等,免得反复更新这个文件。…
Low-density devices are STM32F101xx, STM32F102xx and STM32F103xx microcontrollers
where the Flash memory density ranges between 16 and 32 Kbytes.
Low-density value line devices are STM32F100xx microcontrollers where the Flash
memory density ranges between 16 and 32 Kbytes.
Medium-density devices are STM32F101xx, STM32F102xx and STM32F103xx microcontrollers这里定义的是各种产品线的FLASH的大小。
where the Flash memory density ranges between 64 and 128 Kbytes.
Medium-density value line devices are STM32F100xx microcontrollers where the
Flash memory density ranges between 64 and 128 Kbytes.
High-density devices are STM32F101xx and STM32F103xx microcontrollers where
the Flash memory density ranges between 256 and 512 Kbytes.
High-density value line devices are STM32F100xx microcontrollers where the
Flash memory density ranges between 256 and 512 Kbytes.
XL-density devices are STM32F101xx and STM32F103xx microcontrollers where
the Flash memory density ranges between 512 and 1024 Kbytes.
Connectivity line devices are STM32F105xx and STM32F107xx microcontrollers.
*/
#if !defined (STM32F10X_LD) && !defined (STM32F10X_LD_VL) && !defined (STM32F10X_MD) && !defined (STM32F10X_MD_VL) && !defined (STM32F10X_HD) && !defined (STM32F10X_HD_VL) && !defined (STM32F10X_XL) && !defined (STM32F10X_CL)
#error “Please select first the target STM32F10x device used in your application (in stm32f10x.h file)”
#endif 如果设备类型选择不正确，这里会报错的。

只看该作者 · 2021-5-21 13:43

#if !defined USE_STDPERIPH_DRIVER
/**

@brief Comment the line below if you will not use the peripherals drivers.
In this case, these drivers will not be included and the application code will
be based on direct access to peripherals registers
/
/#define USE_STDPERIPH_DRIVER*/
#endif
/**

@brief In the following line adjust the value of External High Speed oscillator (HSE)
used in your application

Tip: To avoid modifying this file each time you need to use different HSE, you
can define the HSE value in your toolchain compiler preprocessor.
这些提示：为了避免每次编译都要修改文件，意思是可以使用编译器的preprocessor选项来定义芯片型号等,免得反复更新这个文件。…
/
#if !defined HSE_VALUE
#ifdef STM32F10X_CL
#define HSE_VALUE ((uint32_t)25000000) /!< Value of the External oscillator in Hz /
#else
#define HSE_VALUE ((uint32_t)8000000) /!< Value of the External oscillator in Hz /
#endif / STM32F10X_CL /
#endif / HSE_VALUE */

/**

只看该作者 · 2021-5-21 13:45

@brief In the following line adjust the External High Speed oscillator (HSE) Startup
Timeout value
/①、HSI是高速内部时钟，RC振荡器，频率为8MHz。　　②、HSE是高速外部时钟，可接石英/陶瓷谐振器，或者接外部时钟源，频率范围为4MHz~16MHz。
　　③、LSI是低速内部时钟，RC振荡器，频率为40kHz。
　　④、LSE是低速外部时钟，接频率为32.768kHz的石英晶体。
　　⑤、PLL为锁相环倍频输出，其时钟输入源可选择为HSI/2、HSE或者HSE/2。倍频可选择为2~16倍，但是其输出频率最大不得超过72MHz。
#define HSE_STARTUP_TIMEOUT ((uint16_t)0x0500) /!< Time out for HSE start up /
高速外部时钟启动时间
#define HSI_VALUE ((uint32_t)8000000) /!< Value of the Internal oscillator in Hz*/
外部时钟设置的值
/**

只看该作者 · 2021-5-21 13:47

@brief STM32F10x Standard Peripheral Library version number标准外设库版本号的定义
/
#define __STM32F10X_STDPERIPH_VERSION_MAIN (0x03) /!< [31:24] main version /
#define __STM32F10X_STDPERIPH_VERSION_SUB1 (0x05) /!< [23:16] sub1 version /
#define __STM32F10X_STDPERIPH_VERSION_SUB2 (0x00) /!< [15:8] sub2 version /
#define __STM32F10X_STDPERIPH_VERSION_RC (0x00) /!< [7:0] release candidate */
#define __STM32F10X_STDPERIPH_VERSION ( (__STM32F10X_STDPERIPH_VERSION_MAIN << 24)
|(__STM32F10X_STDPERIPH_VERSION_SUB1 << 16)
|(__STM32F10X_STDPERIPH_VERSION_SUB2 << 8)
|(__STM32F10X_STDPERIPH_VERSION_RC))
/**

只看该作者 · 2021-5-21 13:48

@}
*/
/** @addtogroup Configuration_section_for_CMSIS

只看该作者 · 2021-5-21 13:49

@{
*/
/**

只看该作者 · 2021-5-21 13:50

@brief Configuration of the Cortex-M3 Processor and Core Peripherals 配置Cortex-M3处理器和核内外设
/
#ifdef STM32F10X_XL
#define __MPU_PRESENT 1 /!< STM32 XL-density devices provide an MPU /
#else
#define __MPU_PRESENT 0 /!< Other STM32 devices does not provide an MPU /
#endif / STM32F10X_XL /
#define __NVIC_PRIO_BITS 4 /!< STM32 uses 4 Bits for the Priority Levels /
#define __Vendor_SysTickConfig 0 /!< Set to 1 if different SysTick Config is used */
/**

只看该作者 · 2021-5-21 13:51

@brief STM32F10x Interrupt Number Definition, according to the selected device

只看该作者 · 2021-5-21 13:53

in @ref Library_configuration_section 　中断线定义，前部分对于所有STM32F10x都有相同定义，后部分根据不同器件容量采用条件编译定义不同中断线。

只看该作者 · 2021-5-21 13:58

*/

这里是STM32比较重要的头文件

typedef enum IRQn typedef enum表示定义了一个枚举型的数据结构，你可以用题目中的 IRQn 去定义变量
{系统异常ID：

标号
中断ID
描述
NonMaskableInt_IRQn
-14
不可屏蔽中断
MemoryManagement_IRQn
-12
Cortex-M3内存管理中断
BusFault_IRQn
-11
Cortex-M3 总线Fault中断
UsageFault_IRQn
-10
Cortex-M3 用法Fault 中断
SVCall_IRQn
-5
Cortex-M3 SV Call中断
DebugMonitor_IRQn
-4
Cortex-M3 调试监视中断
PendSV_IRQn
-2
Cortex-M3 Pend SV中断
SysTick_IRQn
-1
Cortex-M3 系统Tick中断

只看该作者 · 2021-5-21 13:59

外设中断ID：
标号中断ID 描述标号中断ID 描述
WDT_IRQn 0 看门狗 EINT3_IRQn 21 外中断3
TIMER0_IRQn 1 定时器0 ADC_IRQn 22 AD转换
TIMER1_IRQn 2 定时器1 BOD_IRQn 23 欠压检测
TIMER2_IRQn 3 定时器2 USB_IRQn 24 USB
TIMER3_IRQn 4 定时器3 CAN_IRQn 25 CAN
UART0_IRQn 5 UART0 DMA_IRQn 26 通用DMA
UART1_IRQn 6 UART1 I2S_IRQn 27 I2S
UART2_IRQn 7 UART2 ENET_IRQn 28 以太网
UART3_IRQn 8 UART3 MCI_IRQn 29 SD/MMC卡I/F
PWM1_IRQn 9 PWM1 MCPWM_IRQn 30 电机控制PWM
I2C0_IRQn 10 I2C0 QEI_IRQn 31 正交编码接口
I2C1_IRQn 11 I2C1 PLL1_IRQn 32 PLL1锁存
I2C2_IRQn 12 I2C2 USBActivity_IRQn 33 USB活动
Reserved0_IRQn 13 保留 CANActivity_IRQn 34 CAN活动
SSP0_IRQn 14 SSP0 UART4_IRQn 35 UART4
SSP1_IRQn 15 SSP1 SSP2_IRQn 36 SSP2
PLL0_IRQn 16 PLL0锁存 LCD_IRQn 37 LCD
RTC_IRQn 17 RTC GPIO_IRQn 38 GPIO
EINT0_IRQn 18 外中断0 PWM0_IRQn 39 PWM0
EINT1_IRQn 19 外中断1 EEPROM_IRQn 40 EEPROM
EINT2_IRQn 20 外中断2
/****** Cortex-M3 Processor Exceptions Numbers **************************************************/CMSIS中的中断定义
NonMaskableInt_IRQn = -14, /!< 2 Non Maskable Interrupt 非屏蔽中断 /
MemoryManagement_IRQn = -12, /!< 4 Cortex-M3 Memory Management Interrupt Cortex-M3内存管理中断 /
BusFault_IRQn = -11, /!< 5 Cortex-M3 Bus Fault Interrupt /
UsageFault_IRQn = -10, /!< 6 Cortex-M3 Usage Fault Interrupt /
SVCall_IRQn = -5, /!< 11 Cortex-M3 SV Call Interrupt /
DebugMonitor_IRQn = -4, /!< 12 Cortex-M3 Debug Monitor Interrupt /
PendSV_IRQn = -2, /!< 14 Cortex-M3 Pend SV Interrupt /
SysTick_IRQn = -1, /!< 15 Cortex-M3 System Tick Interrupt */

只看该作者 · 2021-5-21 14:01

/****** STM32 specific Interrupt Numbers ********************************************************/
WWDG_IRQn = 0, /!< Window WatchDog Interrupt /
PVD_IRQn = 1, /!< PVD through EXTI Line detection Interrupt /
TAMPER_IRQn = 2, /!< Tamper Interrupt /
RTC_IRQn = 3, /!< RTC global Interrupt /
FLASH_IRQn = 4, /!< FLASH global Interrupt /
RCC_IRQn = 5, /!< RCC global Interrupt /
EXTI0_IRQn = 6, /!< EXTI Line0 Interrupt /
EXTI1_IRQn = 7, /!< EXTI Line1 Interrupt /
EXTI2_IRQn = 8, /!< EXTI Line2 Interrupt /
EXTI3_IRQn = 9, /!< EXTI Line3 Interrupt /
EXTI4_IRQn = 10, /!< EXTI Line4 Interrupt /
DMA1_Channel1_IRQn = 11, /!< DMA1 Channel 1 global Interrupt /
DMA1_Channel2_IRQn = 12, /!< DMA1 Channel 2 global Interrupt /
DMA1_Channel3_IRQn = 13, /!< DMA1 Channel 3 global Interrupt /
DMA1_Channel4_IRQn = 14, /!< DMA1 Channel 4 global Interrupt /
DMA1_Channel5_IRQn = 15, /!< DMA1 Channel 5 global Interrupt /
DMA1_Channel6_IRQn = 16, /!< DMA1 Channel 6 global Interrupt /
DMA1_Channel7_IRQn = 17, /!< DMA1 Channel 7 global Interrupt */

只看该作者 · 2021-5-21 14:02

#ifdef STM32F10X_LD
ADC1_2_IRQn = 18, /*!< ADC1 and ADC2 global Interrupt /
USB_HP_CAN1_TX_IRQn = 19, /!< USB Device High Priority or CAN1 TX Interrupts /
USB_LP_CAN1_RX0_IRQn = 20, /!< USB Device Low Priority or CAN1 RX0 Interrupts /
CAN1_RX1_IRQn = 21, /!< CAN1 RX1 Interrupt /
CAN1_SCE_IRQn = 22, /!< CAN1 SCE Interrupt /
EXTI9_5_IRQn = 23, /!< External Line[9:5] Interrupts /
TIM1_BRK_IRQn = 24, /!< TIM1 Break Interrupt /
TIM1_UP_IRQn = 25, /!< TIM1 Update Interrupt /
TIM1_TRG_COM_IRQn = 26, /!< TIM1 Trigger and Commutation Interrupt /
TIM1_CC_IRQn = 27, /!< TIM1 Capture Compare Interrupt /
TIM2_IRQn = 28, /!< TIM2 global Interrupt /
TIM3_IRQn = 29, /!< TIM3 global Interrupt /
I2C1_EV_IRQn = 31, /!< I2C1 Event Interrupt /
I2C1_ER_IRQn = 32, /!< I2C1 Error Interrupt /
SPI1_IRQn = 35, /!< SPI1 global Interrupt /
USART1_IRQn = 37, /!< USART1 global Interrupt /
USART2_IRQn = 38, /!< USART2 global Interrupt /
EXTI15_10_IRQn = 40, /!< External Line[15:10] Interrupts /
RTCAlarm_IRQn = 41, /!< RTC Alarm through EXTI Line Interrupt /
USBWakeUp_IRQn = 42 /!< USB Device WakeUp from suspend through EXTI Line Interrupt /
#endif / STM32F10X_LD */

只看该作者 · 2021-5-21 14:03

#ifdef STM32F10X_LD_VL
ADC1_IRQn = 18, /*!< ADC1 global Interrupt /
EXTI9_5_IRQn = 23, /!< External Line[9:5] Interrupts /
TIM1_BRK_TIM15_IRQn = 24, /!< TIM1 Break and TIM15 Interrupts /
TIM1_UP_TIM16_IRQn = 25, /!< TIM1 Update and TIM16 Interrupts /
TIM1_TRG_COM_TIM17_IRQn = 26, /!< TIM1 Trigger and Commutation and TIM17 Interrupt /
TIM1_CC_IRQn = 27, /!< TIM1 Capture Compare Interrupt /
TIM2_IRQn = 28, /!< TIM2 global Interrupt /
TIM3_IRQn = 29, /!< TIM3 global Interrupt /
I2C1_EV_IRQn = 31, /!< I2C1 Event Interrupt /
I2C1_ER_IRQn = 32, /!< I2C1 Error Interrupt /
SPI1_IRQn = 35, /!< SPI1 global Interrupt /
USART1_IRQn = 37, /!< USART1 global Interrupt /
USART2_IRQn = 38, /!< USART2 global Interrupt /
EXTI15_10_IRQn = 40, /!< External Line[15:10] Interrupts /
RTCAlarm_IRQn = 41, /!< RTC Alarm through EXTI Line Interrupt /
CEC_IRQn = 42, /!< HDMI-CEC Interrupt /
TIM6_DAC_IRQn = 54, /!< TIM6 and DAC underrun Interrupt /
TIM7_IRQn = 55 /!< TIM7 Interrupt /
#endif / STM32F10X_LD_VL */
这里是STM32比较重要的头文件

只看该作者 · 2021-5-21 14:05

系统异常ID：

标号
中断ID
描述
NonMaskableInt_IRQn
-14
不可屏蔽中断
MemoryManagement_IRQn
-12
Cortex-M3内存管理中断
BusFault_IRQn
-11
Cortex-M3 总线Fault中断
UsageFault_IRQn
-10
Cortex-M3 用法Fault 中断
SVCall_IRQn
-5
Cortex-M3 SV Call中断
DebugMonitor_IRQn
-4
Cortex-M3 调试监视中断
PendSV_IRQn
-2
Cortex-M3 Pend SV中断
SysTick_IRQn
-1
Cortex-M3 系统Tick中断

只看该作者 · 2021-5-21 14:06

外设中断ID：
标号中断ID 描述标号中断ID 描述
WDT_IRQn 0 看门狗 EINT3_IRQn 21 外中断3
TIMER0_IRQn 1 定时器0 ADC_IRQn 22 AD转换
TIMER1_IRQn 2 定时器1 BOD_IRQn 23 欠压检测
TIMER2_IRQn 3 定时器2 USB_IRQn 24 USB
TIMER3_IRQn 4 定时器3 CAN_IRQn 25 CAN
UART0_IRQn 5 UART0 DMA_IRQn 26 通用DMA
UART1_IRQn 6 UART1 I2S_IRQn 27 I2S
UART2_IRQn 7 UART2 ENET_IRQn 28 以太网
UART3_IRQn 8 UART3 MCI_IRQn 29 SD/MMC卡I/F
PWM1_IRQn 9 PWM1 MCPWM_IRQn 30 电机控制PWM
I2C0_IRQn 10 I2C0 QEI_IRQn 31 正交编码接口
I2C1_IRQn 11 I2C1 PLL1_IRQn 32 PLL1锁存
I2C2_IRQn 12 I2C2 USBActivity_IRQn 33 USB活动
Reserved0_IRQn 13 保留 CANActivity_IRQn 34 CAN活动
SSP0_IRQn 14 SSP0 UART4_IRQn 35 UART4
SSP1_IRQn 15 SSP1 SSP2_IRQn 36 SSP2
PLL0_IRQn 16 PLL0锁存 LCD_IRQn 37 LCD
RTC_IRQn 17 RTC GPIO_IRQn 38 GPIO
EINT0_IRQn 18 外中断0 PWM0_IRQn 39 PWM0
EINT1_IRQn 19 外中断1 EEPROM_IRQn 40 EEPROM
EINT2_IRQn 20 外中断2
#ifdef STM32F10X_MD這是我們前面講過的不同的芯片型號，對應著不同的中斷級別。請大家自行研究！