单片机与物联网 / 系统课时
控制 LED
控制 LED
本课完成一个最小 GPIO 输出实验:把 LED 引脚配置为推挽输出,使用 HAL 函数设置高低电平并周期性翻转。完成后,你不仅能让 LED 闪烁,还能根据实际电路判断“高电平点亮”还是“低电平点亮”。
学习目标
- 能把 LED 所在引脚配置为 GPIO 推挽输出
- 能使用
HAL_GPIO_WritePin设置或清除引脚电平 - 能使用
HAL_GPIO_TogglePin实现周期闪烁
先确认 LED 的有效电平
GPIO 输出的是高电平或低电平,但 LED 是否点亮由接法决定。若引脚经限流电阻连接 LED 后再接地,输出高电平时电流流过 LED,属于高电平点亮;若 LED 接在电源与引脚之间,则引脚输出低电平时点亮。

下文以 PB0 高电平点亮为例。实际开发时应先查看开发板原理图,并把端口、引脚和有效电平替换成真实值。
配置 GPIO 输出
在 STM32CubeMX 中把 LED 引脚设置为 GPIO_Output,输出类型选择推挽,速度选择低速即可。LED 闪烁频率很低,不需要高速输出;过高的边沿速度反而可能增加不必要的电磁干扰。
如果手动初始化,可使用下面的片段。该示例依赖 CubeMX 生成的 HAL 工程,并假设 GPIOB 时钟尚未开启。
static void LED_GPIO_Init(void)
{
GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOB_CLK_ENABLE();
gpio.Pin = GPIO_PIN_0;
gpio.Mode = GPIO_MODE_OUTPUT_PP;
gpio.Pull = GPIO_NOPULL;
gpio.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOB, &gpio);
// 上电后先熄灭,避免初始化阶段短暂闪烁
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET);
}生效行为:PB0 被配置为推挽输出,初始输出低电平。可用万用表测量 PB0 对地电压,预期接近 0 V。
设置、清除和翻转电平
HAL_GPIO_WritePin 的第三个参数只能使用 GPIO_PIN_SET 或 GPIO_PIN_RESET。对于高电平点亮的 LED,SET 表示点亮,RESET 表示熄灭;低电平点亮时逻辑正好相反。
下面的代码先明确演示一次设置和清除,随后进入循环,每 500 ms 翻转一次电平。它是片段示例,应放入已经完成 HAL 初始化和系统时钟配置的 main 函数中。
LED_GPIO_Init();
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);
HAL_Delay(500);
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET);
HAL_Delay(500);
while (1)
{
// 翻转当前电平:高变低,低变高
HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
HAL_Delay(500);
}预期结果
LED 先亮 500 ms、再灭 500 ms,之后每隔 500 ms 切换一次亮灭状态。
实际亮灭逻辑可能因开发板采用低电平点亮而相反。用宏隔离有效电平差异
为了避免业务代码到处判断高低电平,建议把 LED 的有效电平封装成宏。更换开发板时只修改宏定义,不必改动调用逻辑。
#define LED_PORT GPIOB
#define LED_PIN GPIO_PIN_0
#define LED_ON() HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_SET)
#define LED_OFF() HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_RESET)
#define LED_TOGGLE() HAL_GPIO_TogglePin(LED_PORT, LED_PIN)若开发板是低电平点亮,只需交换 LED_ON() 与 LED_OFF() 中的 SET、RESET。验证时应观察上电初始状态、持续亮灭状态和翻转周期是否符合预期。
验证与常见问题
LED 始终不亮时,先检查端口时钟、引脚编号和有效电平,再确认 LED 是否串有限流电阻。LED 始终常亮时,重点检查初始化默认电平和宏定义是否写反。闪烁周期异常时,应确认系统节拍正常,并检查 HAL_Delay 的参数单位是否为毫秒。