使用STM32固件库函数操作控制LED灯(STM32_04)

    直接使用寄存器地址来进行STM32开发要对每一个寄存器的地址通过查找芯片手册，对每一个寄存器的各个位的含义也要查清楚，然后决定对那个地址的哪些位进行怎样的设置。这种编程效率低，程序的可移植性差，程序的可读性差。

    STM32提供了对外设寄存器操作的功能函数，对寄存器操作只需要调用相应的库函数就可以，一般函数名单词组合与功能密切相关，增强了程序的可读性。

1、以CMSIS固件库项目为基础，在项目文件夹下新增"Lib"文件夹，在"Lib"文件夹下新增"inc"和"src"文件夹，在"inc"文件夹中复制"stm32f10x_gpio.h"和"stm32f10x_rcc.h"两个头文件，在"src"文件夹中复制"stm32f10x_gpio.c"和"stm32f10x_rcc.c"两个库函数程序文件，分别包含RCC和GPIO操作相关的库函数。

2、在“项目条目管理”对话框中添加"Lib"组，并向组中添加两个库函数程序文件。

3、修改"Include Paths"，添加".Libinc"路径

4、重写main.c中的main函数

① 包含需要的头文件："stm32f10x_gpio.h"和"stm32f10x_rcc.h"

② 使能GPIOC时钟

    在RCC库函数中定义了RCC_APB2PeriphClockCmd函数，函数原型为：

void RCC_APB2PeriphClockCmd ( uint32_t  RCC_APB2Periph, FunctionalState  NewState )

其中参数RCC_APB2Periph取值为在"stm32f10x_rcc.h"中预定义的值，这里对GPIOC的操作为RCC_APB2Periph_GPIOC，定义如下：

这个值与前面程序中的表达式"0x1<<4"得到的值是一致的。

    函数的第二个参数NewState取值为FunctionState类型，FunctionState类型是在"stm32f10x_rcc.c"文件中定义的一个枚举类型，有DISABLE和ENABLE两个取值，定义如下：

    现在要使能GPIOC，则调用函数如下：

RCC_APB2PeriphClockCmd( RCC_APB2Periph_GPIOC, ENABLE );

③ 配置GPIOC_0为推挽式输出，50MHz速度。

    对GPIO引脚的配置调用"stm32f10x_gpio.c"中的库函数GPIO_Init实现，函数原型为：

void GPIO_Init ( GPIO_TypeDef *  GPIOx, GPIO_InitTypeDef * GPIO_InitStruct  )

其中第一个参数GPIOx的取值在"stm32f10x.h"中定义，这里用GPIOC；第二个参数GPIO_InitStruct为GPIO_InitTypeDef指针类型，GPIO_InitTypeDef类型在"stm32f10x_gpio.h"文件中定义：

这个结构体中的GPIO_Pin为IO口的引脚编号，这里为第一个LED灯，则取0；

GPIO_Speed为GPIOSpeed_TypeDef类型，GPIOSpeed_TypeDef类型在"stm32f10x_gpio.h"文件中定义：

为枚举类型，有三个枚举值。这里取GPIO_Speed_50MHz；

GPIO_Mode为GPIOMode_TypeDef类型，GPIOMode_TypeDef类型在"stm32f10x_gpio.h"文件中定义：

    这些枚举值分别为：

（1）GPIO_Mode_AIN 模拟输入

（2）GPIO_Mode_IN_FLOATING 浮空输入

（3）GPIO_Mode_IPD 下拉输入

（4）GPIO_Mode_IPU 上拉输入

（5）GPIO_Mode_Out_OD 开漏输出

（6）GPIO_Mode_Out_PP 推挽输出

（7）GPIO_Mode_AF_OD 复用开漏输出

（8）GPIO_Mode_AF_PP 复用推挽输出

    这里选择GPIO_Mode_Out_PP。

要配置GPIOC_0的工作模式，首先用GPIO_InitTypeDef类型定义一个变量，然后给这个结构体变量的成员赋值，最后调用GPIO_Init函数完成配置：

GPIO_InitTypeDef GPIOC_0_mode;

GPIOC_0_mode.GPIO_Pin = GPIO_Pin_0;

GPIOC_0_mode.GPIO_Speed = GPIO_Speed_50MHz;

GPIOC_0_mode.GPIO_Mode = GPIO_Mode_Out_PP;

GPIO_Init(GPIOC, &GPIOC_0_mode);

④ 通过GPIO_ResetBits和GPIO_SetBits函数来控制LED1的复位和置位，函数原型如下：

void GPIO_ResetBits ( GPIO_TypeDef *GPIOx,  uint16_t  GPIO_Pin )       //复位函数

void GPIO_SetBits  ( GPIO_TypeDef * GPIOx,  uint16_t GPIO_Pin ) //置位函数

函数的参数分别为哪个GPIO口和哪个引脚。

如果对GPIOC_0复位，则：GPIO_ResetBits( GPIOC, GPIO_Pin_0) ;

如果对GPIOC_0置位，则：GPIO_SetBits( GPIOC, GPIO_Pin_0) ;

最后的main.c程序如下：

#include "stm32f10x.h"

#include "stm32f10x_rcc.h"

#include "stm32f10x_gpio.h"

void delay(int t)

{

     int i;

     for( ;t>0; t--)

         for(i=0;i<1000;i++);

}

int main()

{

     GPIO_InitTypeDef GPIOC_0_mode;

     RCC_APB2PeriphClockCmd( RCC_APB2Periph_GPIOC, ENABLE ); //使能GPIOC时钟

     GPIOC_0_mode.GPIO_Pin = GPIO_Pin_0;

     GPIOC_0_mode.GPIO_Speed = GPIO_Speed_50MHz;

     GPIOC_0_mode.GPIO_Mode = GPIO_Mode_Out_PP;

     GPIO_Init(GPIOC, &GPIOC_0_mode);   //配置GPIOC_0引脚为推挽输出，50MHz速度

     while(1)

     {

         GPIO_ResetBits( GPIOC, GPIO_Pin_0);  //将GPIOC_0复位

         delay(1000);

         GPIO_SetBits( GPIOC, GPIO_Pin_0);    //将GPIOC_0置位

         delay(1000);

     }

}

5、连接错误及其解决方法。

在上述项目中，最后完成项目配置和编程后，编译连接时出现如下错误：

出现这个错误是由于STM32外设库函数的开发中用到了断言机制。正常使用库函数时，需要包含"stm32f10x_conf.h"头文件，在该文件中有如下定义

/* Exported macro ------------------------------------------------------------*/

#ifdef  USE_FULL_ASSERT

/**

  * @brief  The assert_param macro is used for function's parameters check.

  * @param  expr: If expr is false, it calls assert_failed function which reports

  *         the name of the source file and the source line number of the call

  *         that failed. If expr is true, it returns no value.

  * @retval None

  */

  #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))

/* Exported functions ------------------------------------------------------- */

  void assert_failed(uint8_t* file, uint32_t line);

#else

  #define assert_param(expr) ((void)0)

#endif /* USE_FULL_ASSERT */

在该头文件中定义了assert_param宏，根据项目配置，如果设置了"USE_FULL_ASSERT"参数，则对函数参数进行检查，检查不成功转到"assert_failed"函数处理；如果没有设置使用断言，则相当于不对参数进行检测。

解决方法：将这一段宏定义直接复制到"stm32f10x.h"文件中，因为所有的外设库函数文件都直接或间接地包含了该头文件。

6、编译连接项目，下载程序，开发板的LED1闪烁。