stm32库函数解释1.doc

部分库函数简介一、通用输入/输出（GPIO）-3二、外部中断/事件控制器（EXTI）-7三、通用定时器（TIM）-9四：ADC寄存器-25五：备份寄存器（BKP）-33六、DMA控制器（DMA）-37七、复位和时钟设置（RCC）-41八、嵌套向量中断控制器（NVIC）-49命名规则在函数名中，只允许存在一个下划线，用以分隔外设缩写和函数名的其它部分。名为PPP_Init的函数，其功能是根据PPP_InitTypeDef中指定的参数，初始化外设PPP，例如TIM_Init.名为PPP_DeInit的函数，其功能为复位外设PPP的所有寄存器至缺省值，例如TIM_DeInit. 名为PPP_StructInit的函数，其功能为通过设置PPP_InitTypeDef 结构中的各种参数来定义外设的功能，例如：USART_StructInit 名为PPP_Cmd的函数，其功能为使能或者失能外设PPP，例如： SPI_Cmd. 名为PPP_ITConfig的函数，其功能为使能或者失能来自外设PPP某中断源，例如： RCC_ITConfig. 名为PPP_DMAConfig的函数，其功能为使能或者失能外设PPP的DMA接口，例如：TIM1_DMAConfig. 用以配置外设功能的函数，总是以字符串“Config”结尾，例如GPIO_PinRemapConfig. 名为PPP_GetFlagStatus的函数，其功能为检查外设PPP某标志位被设置与否，例如：I2C_GetFlagStatus. 名为PPP_ClearFlag的函数，其功能为清除外设PPP标志位，例如：I2C_ClearFlag. 名为PPP_GetITStatus的函数，其功能为判断来自外设PPP的中断发生与否，例如：I2C_GetITStatus. 名为PPP_ClearITPendingBit的函数，其功能为清除外设PPP中断待处理标志位，例如： I2C_ClearITPendingBit.typedef signed long s32; typedef signed short s16; typedef signed char s8; typedef signed long const sc32; /* Read Only */typedef signed short const sc16; /* Read Only */ typedef signed char const sc8; /* Read Only */ typedef volatile signed long vs32; typedef volatile signed short vs16; typedef volatile signed char vs8; typedef volatile signed long const vsc32; /* Read Only */ typedef volatile signed short const vsc16; /* Read Only */ typedef volatile signed char const vsc8; /* Read Only */ typedef unsigned long u32; typedef unsigned short u16; typedef unsigned char u8; typedef unsigned long const uc32; /* Read Only */ typedef unsigned short const uc16; /* Read Only */ typedef unsigned char const uc8; /* Read Only */ typedef volatile unsigned long vu32; typedef volatile unsigned short vu16; typedef volatile unsigned char vu8; typedef volatile unsigned long const vuc32; /* Read Only */ typedef volatile unsigned short const vuc16; /* Read Only */ typedef volatile unsigned char const vuc8; /* Read Only */一、通用输入/输出（GPIO）GPIO寄存器结构GPIO_TypeDef和AFIO_TypeDef，在文件“stm32f10x_map.h”中定义如下： typedef struct vu32 CRL; vu32 CRH; vu32 IDR; vu32 ODR; vu32 BSRR; vu32 BRR; vu32 LCKR; GPIO_TypeDef; typedef struct vu32 EVCR; vu32 MAPR; vu32 EXTICR4; AFIO_TypeDef;GPIO库函数1 函数GPIO_DeInit功能描述：将外设GPIOx寄存器重设为缺省值例：GPIO_DeInit(GPIOA);2 函数GPIO_AFIODeInit功能描述：将复用功能（重映射事件控制和EXTI设置）重设为缺省值例：GPIO_AFIODeInit();3 函数GPIO_Init功能描述：根据GPIO_InitStruct中指定的参数初始化外设GPIOx寄存器例：GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_All; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_10MHz; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure);GPIO_InitTypeDef structure GPIO_InitTypeDef定义于文件“stm32f10x_gpio.h”： typedef struct u16 GPIO_Pin; GPIOSpeed_TypeDef GPIO_Speed; GPIOMode_TypeDef GPIO_Mode; GPIO_InitTypeDef; GPIO_Pin 该参数选择待设置的GPIO管脚，使用操作符“|”可以一次选中多个管脚。可以使用下表中的任意组合。GPIO_Pin_None：无管脚被选中 GPIO_Pin_x：选中管脚x（0-15）GPIO_Pin_All：选中全部管脚GPIO_Speed GPIO_Speed：用以设置选中管脚的速率。GPIO_Speed_10MHz：最高输出速率10MHz GPIO_Speed_2MHz：最高输出速率2MHz GPIO_Speed_50MHz：最高输出速率50MHz GPIO_Mode GPIO_Mode：用以设置选中管脚的工作状态。GPIO_Mode_AIN：模拟输入 GPIO_Mode_IN_FLOATING：浮空输入 GPIO_Mode_IPD：下拉输入 GPIO_Mode_IPU：上拉输入 GPIO_Mode_Out_OD：开漏输出 GPIO_Mode_Out_PP：推挽输出 GPIO_Mode_AF_OD：复用开漏输出 GPIO_Mode_AF_PP：复用推挽输出4 函数GPIO_StructInit功能描述：把GPIO_InitStruct中的每一个参数按缺省值填入例：GPIO_InitTypeDef GPIO_InitStructure; GPIO_StructInit(&GPIO_InitStructure);GPIO_InitStruct：GPIO_Pin：GPIO_Pin_All GPIO_Speed：GPIO_Speed_2MHz GPIO_Mode：GPIO_Mode_IN_FLOATING5 函数GPIO_ReadInputDataBit功能描述：读取指定端口管脚的输入例：u8 ReadValue; ReadValue = GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_7);6 函数GPIO_ReadInputData功能描述：读取指定的GPIO端口输入例：u16 ReadValue; ReadValue = GPIO_ReadInputData(GPIOC);7 函数GPIO_ReadOutputDataBit功能描述：读取指定端口管脚的输出例：u8 ReadValue; ReadValue = GPIO_ReadOutputDataBit(GPIOB, GPIO_Pin_7);8 函数GPIO_ReadOutputData功能描述：读取指定的GPIO端口输出例：u16 ReadValue; ReadValue = GPIO_ReadOutputData(GPIOC);9 函数GPIO_SetBits功能描述：置位指定的数据端口位例： GPIO_SetBits(GPIOA, GPIO_Pin_10 | GPIO_Pin_15);10 函数GPIO_ResetBits功能描述：清除指定的数据端口位例：GPIO_ResetBits(GPIOA, GPIO_Pin_10 | GPIO_Pin_15);11 函数GPIO_WriteBit功能描述：设置或者清除指定的数据端口位例： GPIO_WriteBit(GPIOA, GPIO_Pin_15, Bit_SET);12 函数GPIO_Write功能描述：向指定GPIO数据端口写入数据例： GPIO_Write(GPIOA, 0x1101);13 函数GPIO_PinLockConfig功能描述：锁定GPIO管脚设置寄存器例： GPIO_PinLockConfig(GPIOA, GPIO_Pin_0 | GPIO_Pin_1);14 函数GPIO_EventOutputConfig功能描述：选择GPIO管脚用作事件输出例： GPIO_EventOutputConfig(GPIO_PortSourceGPIOE, GPIO_PinSource5);GPIO_PortSource GPIO_PortSource用以选择用作事件输出的GPIO端口。GPIO_PinSource GPIO_PinSource用以选择用作事件输出的GPIO管脚。15 函数GPIO_EventOutputCmd功能描述：使能或者失能事件输出例： GPIO_EventOutputConfig(GPIO_PortSourceGPIOC, GPIO_PinSource6); GPIO_EventOutputCmd(ENABLE);16 函数GPIO_PinRemapConfig功能描述：改变指定管脚的映射例： GPIO_PinRemapConfig(GPIO_Remap_I2C1, ENABLE);GPIO_Remap GPIO_Remap用以选择用作事件输出的GPIO端口。GPIO_Remap_SPI1：SPI1复用功能映射GPIO_Remap_I2C1：I2C1复用功能映射GPIO_Remap_USART1：USART1复用功能映射GPIO_PartialRemap_USART3：USART2复用功能映射GPIO_FullRemap_USART3：USART3复用功能完全映射GPIO_PartialRemap_TIM1：USART3复用功能部分映射GPIO_FullRemap_TIM1：TIM1复用功能完全映射GPIO_PartialRemap1_TIM2：TIM2复用功能部分映射1 GPIO_PartialRemap2_TIM2：TIM2复用功能部分映射2 GPIO_FullRemap_TIM2：TIM2复用功能完全映射GPIO_PartialRemap_TIM3：TIM3复用功能部分映射GPIO_FullRemap_TIM3：TIM3复用功能完全映射GPIO_Remap_TIM4：TIM4复用功能映射GPIO_Remap1_CAN：CAN复用功能映射1 GPIO_Remap2_CAN：CAN复用功能映射2 GPIO_Remap_PD01：PD01复用功能映射GPIO_Remap_SWJ_NoJTRST：除JTRST外SWJ完全使能（JTAG+SW-DP） GPIO_Remap_SWJ_JTAGDisable：JTAG-DP失能 + SW-DP使能GPIO_Remap_SWJ_Disable：SWJ完全失能（JTAG+SW-DP）17 函数GPIO_EXTILineConfig功能描述：选择GPIO管脚用作外部中断线路例： GPIO_EXTILineConfig(GPIO_PortSource_GPIOB, GPIO_PinSource8);二、外部中断/事件控制器（EXTI）EXTI寄存器结构EXTI_TypeDef，在文件“stm32f10x_map.h”中定义如下：typedef struct vu32 IMR; vu32 EMR; vu32 RTSR; vu32 FTSR; vu32 SWIER; vu32 PR; EXTI_TypeDef;EXTI库函数1 函数EXTI_DeInit功能描述：将外设EXTI寄存器重设为缺省值例：EXTI_DeInit();2 函数EXTI_Init功能描述：根据EXTI_InitStruct中指定的参数初始化外设EXTI寄存器例：EXTI_InitTypeDef EXTI_InitStructure; EXTI_InitStructure.EXTI_Line = EXTI_Line12 | EXTI_Line14; EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling; EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure);EXTI_InitTypeDef structure EXTI_InitTypeDef定义于文件“stm32f10x_exti.h”： typedef struct u32 EXTI_Line; EXTIMode_TypeDef EXTI_Mode; EXTIrigger_TypeDef EXTI_Trigger; FunctionalState EXTI_LineCmd; EXTI_InitTypeDef;EXTI_Line EXTI_Line选择了待使能或者失能的外部线路。EXTI_Linex：外部中断线x（0-18）EXTI_Mode EXTI_Mode：设置了被使能线路的模式。EXTI_Mode_Event：设置EXTI线路为事件请求EXTI_Mode_Interrupt：设置EXTI线路为中断请求EXTI_Trigger EXTI_Trigger：设置了被使能线路的触发边沿。EXTI_Trigger_Falling：设置输入线路下降沿为中断请求 EXTI_Trigger_Rising：设置输入线路上升沿为中断请求 EXTI_Trigger_Rising_Falling：设置输入线路上升沿和下降沿为中断请求EXTI_LineCmd EXTI_LineCmd用来定义选中线路的新状态。它可以被设为ENABLE或者DISABLE。3 函数EXTI_StructInit功能描述：把EXTI_InitStruct中的每一个参数按缺省值填入例： EXTI_InitTypeDef EXTI_InitStructure; EXTI_StructInit(&EXTI_InitStructure);EXTI_InitStruct缺省值EXTI_Line： EXTI_LineNone EXTI_Mode： EXTI_Mode_Interrupt EXTI_Trigger： EXTI_Trigger_Falling EXTI_LineCmd： DISABLE4 函数EXTI_GenerateSWInterrupt功能描述：产生一个软件中断例：EXTI_GenerateSWInterrupt(EXTI_Line6);5 函数EXTI_GetFlagStatus功能描述：检查指定的EXTI线路标志位设置与否例： FlagStatus EXTIStatus; EXTIStatus = EXTI_GetFlagStatus(EXTI_Line8);6 函数EXTI_ClearFlag功能描述：清除EXTI线路挂起标志位例：EXTI_ClearFlag(EXTI_Line2);7 函数EXTI_GetITStatus功能描述：检查指定的EXTI线路触发请求发生与否例： ITStatus EXTIStatus; EXTIStatus = EXTI_GetITStatus(EXTI_Line8);8 函数EXTI_ClearITPendingBit功能描述：清除EXTI线路挂起位例： EXTI_ClearITpendingBit(EXTI_Line2);三、通用定时器（TIM）TIM寄存器结构TIM_TypeDeff，在文件“stm32f10x_map.h”中定义如下： typedef struct vu16 CR1; u16 RESERVED0; vu16 CR2; u16 RESERVED1; vu16 SMCR; u16 RESERVED2; vu16 DIER; u16 RESERVED3; vu16 SR; u16 RESERVED4; vu16 EGR; u16 RESERVED5; vu16 CCMR1; u16 RESERVED6; vu16 CCMR2; u16 RESERVED7; vu16 CCER; u16 RESERVED8; vu16 CNT; u16 RESERVED9; vu16 PSC; u16 RESERVED10; vu16 ARR; u16 RESERVED113; vu16 CCR1; u16 RESERVED12; vu16 CCR2; u16 RESERVED13; vu16 CCR3; u16 RESERVED14; vu16 CCR4; u16 RESERVED153; vu16 DCR; u16 RESERVED16; vu16 DMAR; u16 RESERVED17; TIM_TypeDef;TIM库函数1 函数TIM_DeInit功能描述：将外设TIMx寄存器重设为缺省值例： TIM_DeInit(TIM2);2 函数TIM_TimeBaseInit功能描述：根据TIM_TimeBaseInitStruct中指定的参数初始化TIMx的时间基数单位例： TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_TimeBaseStructure.TIM_Period = 0xFFFF; TIM_TimeBaseStructure.TIM_Prescaler = 0xF; TIM_TimeBaseStructure.TIM_ClockDivision = 0x0; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, & TIM_TimeBaseStructure);TIM_TimeBaseInitTypeDef structure TIM_TimeBaseInitTypeDef定义于文件“stm32f10x_tim.h”： typedef struct u16 TIM_Period; u16 TIM_Prescaler; u8 TIM_ClockDivision; u16 TIM_CounterMode; TIM_TimeBaseInitTypeDef; TIM_Period TIM_Period设置了在下一个更新事件装入活动的自动重装载寄存器周期的值。它的取值必须在0x0000和0xFFFF之间。TIM_Prescaler TIM_Prescaler设置了用来作为TIMx时钟频率除数的预分频值。它的取值必须在0x0000和0xFFFF之间。TIM_ClockDivision TIM_ClockDivision设置了时钟分割。TIM_CKD_DIV1：TDTS = Tck_tim TIM_CKD_DIV2：TDTS = 2Tck_tim TIM_CKD_DIV4：TDTS = 4Tck_timTIM_CounterMode TIM_CounterMode选择了计数器模式。TIM_CounterMode_Up：TIM向上计数模式TIM_CounterMode_Down：TIM向下计数模式TIM_CounterMode_CenterAligned1：TIM中央对齐模式1计数模式TIM_CounterMode_CenterAligned2：TIM中央对齐模式2计数模式TIM_CounterMode_CenterAligned3：TIM中央对齐模式3计数模式3 函数TIM_OCInit功能描述：根据TIM_OCInitStruct中指定的参数初始化外设TIMx例： TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_Channel = TIM_Channel_1; TIM_OCInitStructure.TIM_Pulse = 0x3FFF; TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OCInit(TIM2, & TIM_OCInitStructure);TIM_OCInitStruct：指向结构TIM_OCInitTypeDef的指针，包含了TIMx时间基数单位的配置信息TIM_OCInitTypeDef structure TIM_OCInitTypeDef定义于文件“stm32f10x_tim.h”： typedef struct u16 TIM_OCMode; u16 TIM_Channel; u16 TIM_Pulse; u16 TIM_OCPolarity; TIM_OCInitTypeDef; TIM_OCMode TIM_OCMode选择定时器模式。TIM_OCMode_Timing：TIM输出比较时间模式TIM_OCMode_Active：TIM输出比较主动模式TIM_OCMode_Inactive：TIM输出比较非主动模式TIM_OCMode_Toggle：TIM输出比较触发模式TIM_OCMode_PWM1：TIM脉冲宽度调制模式1 TIM_OCMode_PWM2：TIM脉冲宽度调制模式2TIM_Channel TIM_Channel选择通道。TIM_Channel_1：使用TIM通道1 TIM_Channel_2：使用TIM通道2 TIM_Channel_3：使用TIM通道3 TIM_Channel_4：使用TIM通道4TIM_Pulse TIM_Pulse设置了待装入捕获比较寄存器的脉冲值。它的取值必须在0x0000和0xFFFF之间。TIM_OCPolarity TIM_OCPolarity输出极性。TIM_OCPolarity_High：TIM输出比较极性高TIM_OCPolarity_Low：TIM输出比较极性低4 函数TIM_ICInit功能描述：根据TIM_ICInitStruct中指定的参数初始化外设TIMx例： TIM_DeInit(TIM2); TIM_ICStructInit(&TIM_ICInitStructure); TIM_ICInitStructure.TIM_ICMode = TIM_ICMode_PWMI; TIM_ICInitStructure.TIM_Channel = TIM_Channel_1; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI; TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; TIM_ICInitStructure.TIM_ICFilter = 0x0; TIM_ICInit(TIM2, &TIM_ICInitStructure);TIM_ICInitStruct：指向结构TIM_ICInitTypeDef的指针，包含了TIMx的配置信息TIM_ICInitTypeDef structure TIM_ICInitTypeDef定义于文件“stm32f10x_tim.h”： typedef struct u16 TIM_ICMode; u16 TIM_Channel; u16 TIM_ICPolarity; u16 TIM_ICSelection; u16 TIM_ICPrescaler; u16 TIM_ICFilter; TIM_ICInitTypeDef; TIM_ICMode TIM_ICMode选择了TIM输入捕获模式。TIM_ICMode_ICAP：TIM使用输入捕获模式TIM_ICMode_PWMI：TIM使用输入PWM模式TIM_Channel TIM_Channel选择通道。TIM_Channel_1 使用TIM通道1 TIM_Channel_2 使用TIM通道2 TIM_Channel_3 使用TIM通道3 TIM_Channel_4 使用TIM通道4TIM_ICPolarity TIM_ICPolarity输入活动沿。TIM_ICPolarity_Rising：TIM输入捕获上升沿TIM_ICPolarity_Falling：TIM输入捕获下降沿TIM_ICSelection TIM_ICSelection选择输入。TIM_ICSelection_DirectTI：TIM输入2，3或4选择对应地与IC1或IC2或IC3或IC4相连TIM_ICSelection_IndirectTI：TIM输入2，3或4选择对应地与IC2或IC1或IC4或IC3相连TIM_ICSelection_TRC：TIM输入2，3或4选择与TRC相连TIM_ICPrescaler TIM_ICPrescaler设置输入捕获预分频器。TIM_ICPSC_DIV1：TIM捕获在捕获输入上每探测到一个边沿执行一次TIM_ICPSC_DIV2：TIM捕获每2个事件执行一次TIM_ICPSC_DIV3：TIM捕获每3个事件执行一次TIM_ICPSC_DIV4：TIM捕获每4个事件执行一次TIM_ICFilter TIM_ICFilter选择输入比较滤波器。该参数取值在0x0和0xF之间。5 函数TIM_TimeBaseStructInit功能描述：把TIM_TimeBaseInitStruct中的每一个参数按缺省值填入TIM_TimeBaseInitStruct：指向结构TIM_TimeBaseInitTypeDef的指针，待初始化TIM_TimeBaseInitStruct缺省值TIM_Period：TIM_Period_Reset_Mask TIM_Prescaler：TIM_Prescaler_Reset_Mask TIM_CKD：TIM_CKD_DIV1 TIM_CounterMode：TIM_CounterMode_Up例： TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure; TIM_TimeBaseStructInit(& TIM_TimeBaseInitStructure);6 函数TIM_OCStructInit功能描述：把TIM_OCInitStruct中的每一个参数按缺省值填入TIM_OCInitStruct：指向结构TIM_OCInitTypeDef的指针，待初始化例： TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCStructInit(& TIM_OCInitStructure);TIM_OCInitStruct缺省值TIM_OCMode：TIM_OCMode_Timing TIM_Channel：TIM_Channel_1 TIM_Pulse：TIM_Pulse_Reset_Mask TIM_OCPolarity：TIM_OCPolarity_High7 函数TIM_ICStructInit功能描述：把TIM_ICInitStruct中的每一个参数按缺省值填入TIM_ICInitStruct：指向结构TIM_ICInitTypeDef的指针，待初始化例： TIM_ICInitTypeDef TIM_ICInitStructure; TIM_ICStructInit(& TIM_ICInitStructure);TIM_ICInitStruct缺省值TIM_ICMode：TIM_ICMode_ICAP TIM_Channel：TIM_Channel_1 TIM_ICPolarity：TIM_ICPolarity_Rising TIM_ICSelection：TIM_ICSelection_DirectTI TIM_ICPrescaler：TIM_ICPSC_DIV1 TIM_ICFilter：TIM_ICFilter_Mask8 函数TIM_Cmd功能描述：使能或者失能TIMx外设例： TIM_Cmd(TIM2, ENABLE);9 函数TIM _ITConfig功能描述：使能或者失能指定的TIM中断例： TIM_ITConfig(TIM2, TIM_IT_CC1, ENABLE );TIM_IT 输入参数TIM_IT使能或者失能TIM的中断TIM_IT_Update TIM中断源TIM_IT_CC1：TIM捕获/比较1中断源TIM_IT_CC2：TIM捕获/比较2中断源TIM_IT_CC3：TIM捕获/比较3中断源TIM_IT_CC4：TIM捕获/比较4中断源TIM_IT_Trigge