STM32CubeMX教程2 GPIO输出 - 点亮LED灯
读者可访问 GitHub - lc-guo/STM32CubeMX-Series-Tutorial 获取原始工程代码
1、准备材料
开发板（STM32F407G-DISC1）
STM32CubeMX软件（Version 6.10.0）
keil µVision5 IDE（MDK-Arm）
2、实验目标
使用STM32CubeMX软件配置STM32F407开发板点亮LED灯
3、实验流程
3.0、前提知识
笔者使用的STM32F407G-DISC1开发板主控制器为STM32F407VGT6，该MCU封装为LQFP 100，一共100个引脚，除去16个POWER引脚、1个NRST引脚和一个BOOT0引脚外，还剩余82个引脚，剩下的这些引脚均可以作为GPIO输入输出引脚使用，这些引脚分为6组，分别为GPIOA、GPIOB、GPIOC、GPIOD、GPIOE和GPIOH，除GPIOH只有2个引脚外，其余5组均为16个引脚，如下图所示
在编程语言学习的过程中，一般学习者初始程序大多选择输出“Hello World!”，而在嵌入式单片机的学习中，一般学习者初始程序大多为“点亮LED灯”，笔者使用的开发板上拥有四个不同颜色的LED灯，其硬件原理图如下图所示，从电路连接上可以看出，从上到下绿橙红蓝四个LED灯分别由单片机的PD12、PD13、PD14和PD15四个引脚控制，当这四个引脚输出高电平时，相应的LED则会被点亮
3.1、CubeMX相关配置
3.1.0、工程基本配置
打开STM32CubeMX软件，单击ACCESS TO MCU SELECTOR选择开发板MCU（选择你使用开发板的主控MCU型号），选中MCU型号后单击页面右上角Start Project开始工程，具体如下图所示
开始工程之后在配置主页面System Core/RCC中配置HSE/LSE晶振，在System Core/SYS中配置Debug模式，具体如下图所示
详细工程建立内容读者可以阅读“STM32CubeMX教程1 工程建立”
3.1.1、时钟树配置
系统时钟使用8MHz外部高速时钟HSE，HCLK、PCLK1和PCLK2均设置为STM32F407能达到的最高时钟频率，具体如下图所示
3.1.2、外设参数配置
在Pinout ＆ Configuration页面右边单片机引脚预览Pinout view中，寻找需要设置的具体GPIO，这里我们选择PD12、PD13、PD14和PD15四个引脚，左键单击引脚可以对引脚功能进行设置，统一选择为GPIO_Output
在页面左边单片机功能分类栏目中选择GPIO，然后在页面中间栏目GPIO Mode and Configuration中可以看到所有使用到的具体GPIO及其相关配置，单击某个GPIO可以对其配置进行修改
当引脚选择GPIO Output时，GPIO mode有推挽输出和开漏输出两种，GPIO Pull-up/Pull-down可以选择无上/下拉、上拉和下拉其中的几种，需要注意的是开漏输出无法真正输出高电平，即高电平时没有驱动能力，需要借助外部上拉电阻完成对外驱动 （注释1）
当GPIO mode设置为推挽输出时，此时上/下拉只有在没有输出时才有作用，也就是说，推挽输出状态下，如果控制输出高电平那IO状态就为高电平，若控制输出低电平那IO状态就为低电平，此时与上/下拉无关，而当没有控制输出时，此时IO的状态由上/下拉决定 （注释2）
当GPIO mode设置为开漏输出时，如果控制输出低电平那IO状态就为低电平；若控制输出高电平，此时输出指令就不会起到作用，IO状态由上/下拉决定
因此PD12、PD13、PD14和PD15四个引脚模式选择推挽输出，无上下拉，具体配置如下图所示
3.2、生成代码
3.2.0、配置Project Manager页面
单击进入Project Manager页面，在左边Project分栏中修改工程名称、工程目录和工具链，然后在Code Generator中勾选“Gnerate peripheral initialization as a pair of 'c/h' files per peripheral”，最后单击页面右上角GENERATE CODE生成工程，具体如下图所示
详细Project Manager配置内容读者可以阅读“STM32CubeMX教程1 工程建立”实验3.4.3小节
3.2.1、外设初始化调用流程
打开工程，在main.c主函数中可以看到初始化部分多了MX_GPIO_Init()函数，此函数即初始化4个LED引脚为输出的函数
右键单击函数，单击Go To Definition Of 'MX_GPlO_Init' 定位（注释3）到函数定义所在的文件gpio.c（注释4）中，可以看到初始化函数中所做的设置正是我们在STM32CubeMX中所做的设置
此时如果不增加任何代码，编译整个工程应该是可以正常编译通过，0错误和0警告
3.2.2、添加其他必要代码
然后我们就可以添加我们自己的功能代码，在主函数初始化LED的引脚之后，将引脚输出为高电平即可点亮LED，还可以在主循环中每隔一定时间翻转LED引脚的输出电平，形成LED闪烁的状态，添加代码如下图所示
源代码如下
/*点亮四个LED灯*/
HAL_GPIO_WritePin(GREEN_LED_GPIO_Port,GREEN_LED_Pin,GPIO_PIN_SET);
HAL_GPIO_WritePin(ORANGE_LED_GPIO_Port,ORANGE_LED_Pin,GPIO_PIN_SET);
HAL_GPIO_WritePin(RED_LED_GPIO_Port,RED_LED_Pin,GPIO_PIN_SET);
HAL_GPIO_WritePin(BLUE_LED_GPIO_Port,BLUE_LED_Pin,GPIO_PIN_SET);
/*每隔100ms翻转绿色LED灯状态*/
HAL_GPIO_TogglePin(GREEN_LED_GPIO_Port, GREEN_LED_Pin) ;
HAL_Delay(100);
4、常用函数
/**
* @brief 设置某个GPIO固定输出高电平或低电平
* @param GPIOx：引脚组别（GPIOA - GPIOI）
* @param GPIO_Pin：引脚（GPIO_PIN_0 - GPIO_PIN_15）
* @param PinState：低电平（GPIO_PIN_RESET）、高电平（GPIO_PIN_SET）
* @retval None
*/
void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);
/*设置PA0引脚输出高电平*/
HAL_GPIO_WritePin(GPIOA,GPIO_PIN_0,GPIO_PIN_SET);
/**
* @brief 设置某个GPIO的输出电平翻转
* @param GPIOx：引脚组别（GPIOA - GPIOI）
* @param GPIO_Pin：引脚（GPIO_PIN_0 - GPIO_PIN_15）
* @retval None
*/
void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
/*翻转PA0引脚输出电平*/
HAL_GPIO_TogglePin(GPIOA,GPIO_PIN_0);
5、烧录验证
5.1、具体步骤
“初始化LED引脚为输出 -> 使用HAL库函数设置LED引脚输出高电平 -> 引脚对应的LED点亮”
5.2、实验现象
烧录程序，然后观察开发板上LED灯的闪烁状态，发现开发板上电后4个LED均被点亮，其中GREEN_LED每隔一段时间闪烁一次
6、注释解析
注释1：参看文章“GPIO推挽输出和开漏输出模式区别详解”
注释2：参看文章“STM32F4 GPIO八种模式及工作原理详解”
注释3：需要在keil软件魔术手Options for Target‘GPIO'/Output中勾选Browse Infomation，然后编译整个工程才可以跳转
注释4：如果在STM32CubeMX的Project Manager/Code Generator/Generated files中没有勾选Generate peripheral initialization as a pair of 'c/.h' files per peripheral，则所有生成的代码都会在main.c中实现，而不是每个外设分成.c/.h的形式
