主题
GPIO 点灯实战
点灯不是「入门仪式」,而是把 时钟 → 模式 → 输出 这条链路完整走一遍。做完这个实验,你就掌握了所有 GPIO 类外设的配置套路。
实验目标
- 推挽输出驱动 LED,能闪烁。
- 输入上拉读取按键,实现「按一下切换状态」。
- 用状态机做 30ms 消抖,不阻塞主循环。
- 用定时器 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 × 1000 | 1 MHz |
ARR | 1000 - 1 | 999 |
PSC | 72MHz / 1MHz - 1 | 71 |
| 占空比 | CCR / 1000 | 0–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(),换引脚时只改一处。