单片机与物联网 / 系统课时

控制 LED

控制 LED

本课完成一个最小 GPIO 输出实验:把 LED 引脚配置为推挽输出,使用 HAL 函数设置高低电平并周期性翻转。完成后,你不仅能让 LED 闪烁,还能根据实际电路判断“高电平点亮”还是“低电平点亮”。

学习目标

  • 能把 LED 所在引脚配置为 GPIO 推挽输出
  • 能使用 HAL_GPIO_WritePin 设置或清除引脚电平
  • 能使用 HAL_GPIO_TogglePin 实现周期闪烁

先确认 LED 的有效电平

GPIO 输出的是高电平或低电平,但 LED 是否点亮由接法决定。若引脚经限流电阻连接 LED 后再接地,输出高电平时电流流过 LED,属于高电平点亮;若 LED 接在电源与引脚之间,则引脚输出低电平时点亮。

GPIO 控制 LED 的两种电平状态

下文以 PB0 高电平点亮为例。实际开发时应先查看开发板原理图,并把端口、引脚和有效电平替换成真实值。

配置 GPIO 输出

在 STM32CubeMX 中把 LED 引脚设置为 GPIO_Output,输出类型选择推挽,速度选择低速即可。LED 闪烁频率很低,不需要高速输出;过高的边沿速度反而可能增加不必要的电磁干扰。

如果手动初始化,可使用下面的片段。该示例依赖 CubeMX 生成的 HAL 工程,并假设 GPIOB 时钟尚未开启。

c
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 函数中。

c
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);
}

预期结果

text
LED 先亮 500 ms、再灭 500 ms,之后每隔 500 ms 切换一次亮灭状态。
实际亮灭逻辑可能因开发板采用低电平点亮而相反。

用宏隔离有效电平差异

为了避免业务代码到处判断高低电平,建议把 LED 的有效电平封装成宏。更换开发板时只修改宏定义,不必改动调用逻辑。

c
#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 的参数单位是否为毫秒。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制 LED

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通