六、STM32F4库函数实战：从时钟使能到GPIO配置，点亮天空星开发板LED灯

六、STM32F4库函数实战从时钟使能到GPIO配置点亮天空星开发板LED灯很多刚开始玩STM32的朋友拿到开发板后第一个想做的实验就是点灯。这就像嵌入式世界的“Hello World”虽然简单但能把整个开发流程串起来。今天我就以手头的这块“立创·梁山派·天空星STM32F407VET6”开发板为例带大家走一遍用STM32标准外设库SPL点亮LED的完整流程。咱们的目标是控制开发板上的用户LED它连接在STM32的PB2引脚上。整个过程就像给一个房间通电并打开电灯先打开总闸使能时钟然后安装开关和电线配置GPIO最后按下开关输出高低电平。下面咱们就一步步来操作。1. 点灯前的准备工作理解GPIO配置流程在动手写代码之前咱们得先搞清楚用库函数操作一个GPIO引脚的标准“三步走”流程。这个流程是通用的以后操作其他外设比如串口、定时器思路也差不多。开启GPIO端口的时钟STM32为了省电所有外设的时钟默认都是关闭的。你想用哪个外设就得先给它“上电”也就是开启对应的时钟。这就像你想用房间里的灯得先确保这个房间的电路总闸是打开的。配置GPIO的输出参数告诉单片机这个引脚打算怎么用。是当输出用控制LED还是输入用读取按键输出时是推挽输出还是开漏输出输出速度要多快这些都需要在一个结构体里设置好。控制GPIO输出电平配置完成后就可以通过写函数让这个引脚输出高电平比如3.3V或低电平0V从而控制LED的亮灭了。咱们的用户LED是接在PB2上的所以整个操作都是围绕GPIOB的第2个引脚进行的。2. 第一步打开时钟总闸——使能GPIOB时钟所有外设都挂在不同的总线上GPIOB挂在AHB1总线上。所以我们要开启的是AHB1总线上的GPIOB时钟。怎么开呢STM32的库函数已经帮我们封装好了。我们需要用到RCC_AHB1PeriphClockCmd这个函数。这个函数声明在stm32f4xx_rcc.h头文件里。提示STM32的标准外设库Standard Peripheral Library把各种操作都封装成了函数我们编程时直接调用就行不用去直接操作复杂的寄存器大大降低了入门门槛。函数原型长这样void RCC_AHB1PeriphClockCmd(uint32_t RCC_AHB1Periph, FunctionalState NewState);第一个参数RCC_AHB1Periph指定要使能哪个外设的时钟。对于我们就是RCC_AHB1Periph_GPIOB。第二个参数NewState是开启还是关闭。ENABLE表示开启DISABLE表示关闭。所以开启GPIOB时钟的代码非常简单RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE);这一行代码执行后GPIOB模块就“上电”准备好了我们可以开始配置它了。3. 第二步安装开关和电线——初始化GPIO结构体时钟打开了接下来要告诉单片机PB2这个引脚具体怎么用。这里会用到另一个核心函数GPIO_Init它需要一个结构体GPIO_InitTypeDef来传递所有配置信息。这个函数和结构体定义在stm32f4xx_gpio.h头文件中。咱们先定义一个结构体变量然后像填表格一样把各项参数填进去。GPIO_InitTypeDef GPIO_InitStructure; // 定义一个GPIO初始化结构体现在我们来逐一设置结构体的成员GPIO_Pin(引脚)指定要配置哪个或哪些引脚。我们只配置PB2所以是GPIO_Pin_2。如果你想同时配置多个引脚可以用|符号连接比如GPIO_Pin_2 | GPIO_Pin_3。GPIO_Mode(模式)设置引脚的工作模式。我们要控制LED输出电平所以选择输出模式GPIO_Mode_OUT。其他常见模式还有输入模式(GPIO_Mode_IN)、复用功能模式(GPIO_Mode_AF)等。GPIO_OType(输出类型)输出模式下的具体类型。推挽输出 (GPIO_OType_PP)引脚能主动输出高电平接近VDD如3.3V和低电平0V驱动能力强适合直接驱动LED、继电器等。我们控制LED就用这个。开漏输出 (GPIO_OType_OD)引脚只能主动拉低到0V高电平状态需要靠外部上拉电阻拉到VDD。常用于I2C等通信总线。GPIO_Speed(速度)设置引脚电平翻转的最大速度。速度越高功耗和噪声可能也越大。对于点LED这种慢速操作用低速(GPIO_Speed_2MHz)或中速(GPIO_Speed_25MHz)就够了。但根据原始资料我们这里按示例设置为GPIO_Speed_100MHz。GPIO_PuPd(上拉/下拉)设置引脚内部是否连接上拉或下拉电阻。上拉电阻默认把引脚电平拉高下拉电阻默认拉低。我们的LED电路外部已有设计这里不需要内部上拉或下拉所以选择GPIO_PuPd_NOPULL无上拉下拉。把上面的配置组合起来完整的初始化代码如下GPIO_InitTypeDef GPIO_InitStructure; // 1. 开启GPIOB时钟 (这一步千万别忘了) RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE); // 2. 填充初始化结构体 GPIO_InitStructure.GPIO_Pin GPIO_Pin_2; // 操作PB2引脚 GPIO_InitStructure.GPIO_Mode GPIO_Mode_OUT; // 设置为输出模式 GPIO_InitStructure.GPIO_OType GPIO_OType_PP; // 推挽输出驱动LED GPIO_InitStructure.GPIO_Speed GPIO_Speed_100MHz; // 输出速度 GPIO_InitStructure.GPIO_PuPd GPIO_PuPd_NOPULL; // 无内部上拉下拉 // 3. 调用初始化函数将配置生效到GPIOB端口 GPIO_Init(GPIOB, GPIO_InitStructure);执行完GPIO_Init函数后PB2引脚就按照我们的要求配置好了随时可以接受我们的控制命令。4. 第三步按下开关——控制引脚输出电平配置完成后点灯就变得非常简单了就是让PB2输出高电平还是低电平的问题。STM32库提供了好几个函数来做这件事咱们一个个看。4.1 使用GPIO_SetBits和GPIO_ResetBits这是最常用、最直观的一对函数。GPIO_SetBits将指定的一个或多个引脚设置为高电平“置位”。GPIO_ResetBits将指定的一个或多个引脚设置为低电平“复位”。函数原型void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin); void GPIO_ResetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);点亮LED假设LED阴极接PB2阳极接VCC则PB2输出低电平时LED亮GPIO_ResetBits(GPIOB, GPIO_Pin_2); // PB2输出低电平LED亮熄灭LEDGPIO_SetBits(GPIOB, GPIO_Pin_2); // PB2输出高电平LED灭4.2 使用GPIO_WriteBit这个函数更灵活可以直接指定要写入的状态值。 函数原型void GPIO_WriteBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, BitAction BitVal);第三个参数BitVal可以是Bit_SET(高电平) 或Bit_RESET(低电平)。GPIO_WriteBit(GPIOB, GPIO_Pin_2, Bit_RESET); // 输出低电平LED亮 GPIO_WriteBit(GPIOB, GPIO_Pin_2, Bit_SET); // 输出高电平LED灭 // 或者直接用1和0 GPIO_WriteBit(GPIOB, GPIO_Pin_2, 0); // 输出低电平 GPIO_WriteBit(GPIOB, GPIO_Pin_2, 1); // 输出高电平4.3 关于GPIO_Write这个函数用于一次性写入整个GPIO端口16个引脚的值通过一个16位的数来设置。例如GPIO_Write(GPIOB, 0x0004)会让PB2输出高电平其他引脚输出低电平因为0x0004二进制是 0000 0000 0000 0100。注意正如原始资料里提醒的GPIO_Write函数会同时改变端口上所有引脚的状态如果你只想操作其中一个引脚很容易影响到其他正在使用的引脚导致难以排查的bug。对于初学者强烈建议使用GPIO_SetBits/ResetBits或GPIO_WriteBit它们只操作你指定的引脚更安全。5. 动手实验编写你的第一个点灯程序现在我们把上面的所有步骤整合到一个简单的main函数里。为了让现象明显我们让LED闪烁起来即亮一秒灭一秒如此循环。#include stm32f4xx.h // 包含STM32F4系列的所有头文件 #include stm32f4xx_gpio.h #include stm32f4xx_rcc.h // 简单的延时函数通过循环空跑来消耗时间 // 注意实际项目中要用定时器实现精确延时这里仅为演示 void Delay(__IO uint32_t nCount) { for(; nCount ! 0; nCount--); } int main(void) { // 1. 初始化GPIO GPIO_InitTypeDef GPIO_InitStructure; // 开启GPIOB端口时钟 RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE); // 配置PB2为推挽输出高速无上拉下拉 GPIO_InitStructure.GPIO_Pin GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode GPIO_Mode_OUT; GPIO_InitStructure.GPIO_OType GPIO_OType_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_100MHz; GPIO_InitStructure.GPIO_PuPd GPIO_PuPd_NOPULL; GPIO_Init(GPIOB, GPIO_InitStructure); // 2. 主循环实现LED闪烁 while (1) { GPIO_SetBits(GPIOB, GPIO_Pin_2); // PB2高电平LED灭 Delay(0xFFFFFF); // 延时一段时间 GPIO_ResetBits(GPIOB, GPIO_Pin_2); // PB2低电平LED亮 Delay(0xFFFFFF); // 延时一段时间 } }代码烧录与现象 将这段代码编译后通过ST-Link、J-Link等调试器烧录到你的“天空星”开发板中。上电后你应该能看到板载的用户LED连接在PB2上开始有规律地闪烁亮一秒左右然后灭一秒左右。提示完整的工程例程可以在开发板资料包中找到路径通常是立创·梁山派·天空星STM32F407VET6开发板资料/第03章软件资料/代码例程/002 库函数点灯。你可以参考这个工程来建立自己的项目。6. 总结与常见问题恭喜你完成了STM32库函数编程的第一次实战。这个过程虽然简单但涵盖了STM32开发最核心的步骤找函数、配参数、调函数。几个容易踩的坑忘记开启时钟这是新手最常犯的错误。配置任何外设前一定要先开启它的时钟。否则代码看起来都对但硬件就是没反应。头文件缺失如果你在编译时遇到GPIO_InitTypeDef或RCC_AHB1PeriphClockCmd未定义的错误检查一下是否包含了stm32f4xx_gpio.h和stm32f4xx_rcc.h头文件。LED不亮检查电路先确认你的开发板LED电路。有些板子是LED阳极接GPIO阴极接地高电平点亮有些是阴极接GPIO阳极接VCC低电平点亮。我们的“天空星”开发板属于后者低电平点亮所以代码里用GPIO_ResetBits来点亮。如果你的板子设计不同需要反过来操作。掌握了点灯你就打开了STM32开发的大门。接下来你可以尝试用同样的思路去操作按键配置为输入模式、用PWM让LED呼吸、或者驱动串口和电脑通信。万变不离其宗都是从配置时钟和初始化外设开始的。