Skip to content

GPIO 点灯实战 ​

点灯不是「入门仪式」,而是把 时钟 → 模式 → 输出 这条链路完整走一遍。做完这个实验,你就掌握了所有 GPIO 类外设的配置套路。

实验目标 ​

  1. 推挽输出驱动 LED,能闪烁。
  2. 输入上拉读取按键,实现「按一下切换状态」。
  3. 用状态机做 30ms 消抖,不阻塞主循环。
  4. 用定时器 PWM 做呼吸灯,理解占空比与频率的关系。

硬件连接 ​

信号接法说明
LED引脚 → 限流电阻(1kΩ)→ LED → GND高电平点亮(灌电流接法相反)
按键引脚 → 按键 → GND,引脚内部上拉按下读到 0,松开读到 1

限流电阻怎么算

R = (VCC - VF) / IF。3.3V、红色 LED(VF≈1.9V)、目标 2mA → (3.3-1.9)/0.002 = 700Ω,取 1kΩ 更安全。MCU 单脚驱动能力通常 ≤20mA,不要直接驱动大电流负载。

第一步:推挽输出 ​

c
#include "board.h"

#define LED_PIN   5
#define LED_PORT  GPIOA

static void led_init(void)
{
    /* 1. 开时钟:没开时钟,后面写寄存器全部无效 */
    RCC->APB2ENR |= RCC_APB2ENR_IOPAEN;

    /* 2. 配置为推挽输出,速度 2MHz(以 STM32F1 的 CRL 为例) */
    LED_PORT->CRL &= ~(0xFUL << (LED_PIN * 4));
    LED_PORT->CRL |=  (0x2UL << (LED_PIN * 4));   /* 0010: 输出 2MHz 推挽 */
}

static inline void led_write(int on)
{
    if (on) {
        LED_PORT->BSRR = (1UL << LED_PIN);          /* 置位,原子操作 */
    } else {
        LED_PORT->BRR  = (1UL << LED_PIN);          /* 复位 */
    }
}

用 BSRR / BRR 而不是 ODR |= / &=,好处是单条指令完成,不与中断里的其它位操作打架。

第二步:按键输入 + 消抖 ​

c
#define KEY_PIN  0
#define KEY_PORT GPIOA

static void key_init(void)
{
    RCC->APB2ENR |= RCC_APB2ENR_IOPAEN;
    /* 上拉输入:CNF=10, MODE=00 -> 0x8 */
    KEY_PORT->CRL &= ~(0xFUL << (KEY_PIN * 4));
    KEY_PORT->CRL |=  (0x8UL << (KEY_PIN * 4));
}

/* 非阻塞消抖:每 10ms 调一次,连续 3 次一致才认账 */
typedef struct {
    unsigned char raw;
    unsigned char stable;
    unsigned char cnt;
} key_state_t;

static key_state_t s_key = { 1, 1, 0 };

/* 返回 1 表示检测到一次「按下」边沿 */
int key_poll_10ms(void)
{
    unsigned char level = (KEY_PORT->IDR & (1UL << KEY_PIN)) ? 1 : 0;

    if (level == s_key.raw) {
        if (s_key.cnt < 255) s_key.cnt++;
    } else {
        s_key.raw = level;
        s_key.cnt = 0;
    }

    if (s_key.cnt >= 3 && s_key.stable != s_key.raw) {
        s_key.stable = s_key.raw;
        return (s_key.stable == 0);      /* 0 表示按下 */
    }
    return 0;
}

主循环里配合 SysTick 的 10ms 标志:

c
int main(void)
{
    board_clock_init();
    led_init();
    key_init();

    int led_on = 0;

    for (;;) {
        if (board_take_flag_10ms()) {          /* 取走并清除标志 */
            if (key_poll_10ms()) {
                led_on = !led_on;
                led_write(led_on);
            }
        }
    }
}

为什么不用 delay 消抖

delay_ms(20) 期间主循环完全停摆,串口数据会丢、按键会漏、PWM 更新会延迟。只要有多个任务,延时就不可接受。

第三步:PWM 呼吸灯 ​

定时器产生 PWM,CPU 只负责改占空比。以 1kHz、1000 级分辨率为例:

参数计算结果
计数频率1kHz × 10001 MHz
ARR1000 - 1999
PSC72MHz / 1MHz - 171
占空比CCR / 10000–100%
c
static void pwm_init(void)
{
    RCC->APB1ENR |= RCC_APB1ENR_TIM3EN;
    RCC->APB2ENR |= RCC_APB2ENR_IOPAEN | RCC_APB2ENR_AFIOEN;

    /* PA6 -> TIM3_CH1 复用推挽 */
    GPIOA->CRL &= ~(0xFUL << 24);
    GPIOA->CRL |=  (0xBUL << 24);        /* 1011: 复用推挽 50MHz */

    TIM3->PSC  = 71;
    TIM3->ARR  = 999;
    TIM3->CCR1 = 0;
    TIM3->CCMR1 = (0x6UL << 4);          /* PWM 模式 1 */
    TIM3->CCER  = TIM_CCER_CC1E;         /* 使能通道 1 */
    TIM3->CR1   = TIM_CR1_ARPE | TIM_CR1_CEN;
}

static void pwm_set_duty(unsigned int permille)   /* 0..1000 */
{
    if (permille > 1000) permille = 1000;
    TIM3->CCR1 = permille;
}

呼吸效果用「线性增减 + 稍作停留」比纯三角波自然:

c
/* 每 5ms 调一次,约 5s 一个呼吸周期 */
void breath_task(void)
{
    static int duty = 0, dir = 1;
    duty += dir * 4;
    if (duty >= 1000) { duty = 1000; dir = -1; }
    if (duty <= 0)    { duty = 0;    dir =  1; }
    pwm_set_duty((unsigned int)duty);
}

开漏输出的用途 ​

把 LED 接法改成「引脚 → LED → VCC」,则需要开漏 + 外部上拉或推挽反相驱动。开漏的真正价值在于:

  • 电平转换:3.3V MCU 控制 5V 器件,开漏 + 5V 上拉即可(前提是引脚耐 5V)。
  • 线与总线:I2C 必须开漏,多设备共享时才不会冲突。
  • 驱动共阳数码管/继电器模块:多数模块低电平有效,开漏灌电流更合适。

检查表 ​

现象原因
LED 完全不亮时钟未使能、引脚模式写错、LED 极性接反
亮度极弱限流电阻过大,或配成了输入模式(漏电流点亮)
按键无反应未配上拉、按键另一端未接 GND
按一次触发多次没做消抖,或消抖次数太少
PWM 无输出定时器通道未使能、引脚未配成复用
呼吸灯有闪烁感PWM 频率过低(<200Hz),提高到 1kHz 以上

小结 ​

GPIO 的配置永远是三步:开时钟 → 设模式 → 读写数据。把这三步写成 board_led_init() 这类板级函数,业务代码里就只剩 board_led_on(),换引脚时只改一处。

以资料沉淀经验,用产品验证想法 · 嵌入式资料与产品文档