嵌入式C++教程实战之Linux下的单片机编程（8）：推挽、开漏与PC13 —— LED点亮的硬件秘密2万字详解

1. 前言：为什么点亮一颗 LED 需要讲 2 万字

很多嵌入式工程师的第一课都是“点亮一颗 LED”。这个实验看起来简单：写几行代码配置一个 GPIO 引脚，置高置低，LED 亮灭。但实际上，当你在 Linux 环境下用 C++ 编写单片机程序时，仅仅“点亮 LED”这一件事，就牵涉到推挽输出、开漏输出、上下拉电阻、灌电流与拉电流、时钟、寄存器、位操作、编译工具链、下载调试等一整套硬件与软件知识。

本篇是《嵌入式 C++ 教程实战之 Linux 下的单片机编程》系列的第 8 篇。之前我们已经搭建了 Linux 下的交叉编译环境，学习了 GPIO 的基本结构，也写过了简单的寄存器操作。这一篇，我们把目光聚焦到 GPIO 输出模式的底层原理，尤其是推挽输出和开漏输出的区别，并结合 STM32 系列单片机上的 PC13 引脚，详细拆解“LED 点亮的硬件秘密”。

之所以选择 PC13，是因为它非常特殊：在 STM32F1/F4 等常见型号中，PC13 是 RTC 域的引脚，供电域、复位行为、最大驱动能力和默认状态都与普通 GPIO 不同。很多初学者的开发板上，LED 恰恰接在 PC13 上，例如著名的 Blue Pill、Black Pill 以及各类最小系统板。如果只是照着例程写代码，却不懂推挽、开漏和 PC13 的硬件限制，后面碰到 LED 亮度异常、复位后电平跳变、无法驱动继电器等问题时，就会手足无措。

本文会从最简单的电路原理开始，一步步推导到寄存器级操作，并给出可在 Linux 下直接编译运行的 C++ 示例代码。全文约两万字，建议配合一块 STM32 开发板边读边做。即使你使用的是其他系列单片机，例如 GD32、ESP32、RP2040 等，文中的原理也完全适用，只是寄存器地址和库函数名称略有不同。

2. LED 点亮的硬件基础

2.1 发光二极管的基本特性

LED 是一种电流驱动型器件。与白炽灯“给电压就亮”不同，LED 需要流过足够的正向电流才会发光，且正向电压基本稳定在某个区间。常见的红色、黄色 LED 正向压降约为 1.8V 至 2.2V，绿色、蓝色、白色 LED 约为 2.8V 至 3.3V。当 LED 两端电压超过正向压降后，电流会急剧上升，因此必须在回路中串联限流电阻，否则 LED 会因过流而烧毁。

判断 LED 是否点亮，不能看引脚电压是 3.3V 还是 0V，而要看 LED 回路中是否有电流。这就引出了两种最基本的驱动拓扑：拉电流驱动和灌电流驱动。

2.2 拉电流与灌电流

所谓拉电流，是指单片机引脚输出高电平时，电流从引脚流出，经过 LED 和限流电阻流入 GND。此时 GPIO 引脚是电流源。灌电流则相反，LED 阳极接电源正极，阴极经限流电阻接到 GPIO 引脚；当引脚输出低电平时，电流从电源经 LED、限流电阻流入引脚，最终从芯片内部流到 GND。此时 GPIO 引脚是电流阱。

两者都能点亮 LED，但对 GPIO 输出结构的要求不同。拉电流驱动通常使用推挽输出的高电平能力，而灌电流驱动则依赖推挽或开漏输出的低电平能力。在大多数单片机中，低电平灌电流能力往往比高电平拉电流能力强，因此灌电流驱动方式更为常用，也更稳定。

2.3 限流电阻的计算

限流电阻 R 的计算公式为：

R = (Vcc - Vf - Vpin) / I

其中 Vcc 为电源电压，Vf 为 LED 正向压降，Vpin 为 GPIO 引脚在导通方向上的压降（通常较小，可忽略），I 为目标工作电流。普通小功率 LED 的典型工作电流为 5mA 至 20mA，电流越大越亮，但超过额定值会缩短寿命甚至损坏。对于 3.3V 系统、红色 LED 压降 2.0V、目标电流 10mA 的灌电流驱动，限流电阻约为：

R = (3.3V - 2.0V) / 0.01A = 130Ω

实际工程中常取 220Ω 或 330Ω，以降低电流、延长 LED 寿命，同时适配不同颜色 LED 的压降差异。如果使用推挽输出的拉电流驱动，则公式中的 Vpin 要考虑到高电平输出时引脚内部上管产生的压降，结果会略有不同。

3. GPIO 输出模式概览

在深入推挽和开漏之前，我们先建立 GPIO 输出级的整体模型。STM32 的 GPIO 引脚内部结构可以简化理解为以下三部分：输入驱动器、输出驱动器和上下拉电阻。输出驱动器又分为推挽和开漏两种模式，每种模式都可以选择不同的输出速度。此外，GPIO 还支持复用功能推挽和复用功能开漏，用于外设直接控制引脚。

模式选择通过 GPIO 配置寄存器完成。以 STM32F1 系列为例，每个 GPIO 端口有 CRL 和 CRH 两个配置寄存器，每 4 位控制一个引脚，其中高 2 位决定模式，低 2 位决定配置。常见的 4 位编码如下：

注意，MODE 位域为 00 时表示输入模式，非 00 时表示输出模式，具体输出速度由 01、10、11 表示 2MHz、10MHz、50MHz。在 STM32F4 及后续系列中，配置寄存器改为 MODER、OTYPER、OSPEEDR、PUPDR，将模式、输出类型、速度和上下拉分开管理，使用起来更清晰，但硬件本质没有变化。

下面我们重点分析通用推挽输出和通用开漏输出，因为这是驱动 LED 最常用的两种模式。

4. 推挽输出深入解析

4.1 推挽的电路结构

推挽输出的核心是一对互补的 MOS 管：上管为 P-MOS，连接在 VDD 与输出引脚之间；下管为 N-MOS，连接在输出引脚与 GND 之间。当输出逻辑高电平时，上管导通、下管截止，引脚被上拉到 VDD；当输出逻辑低电平时，上管截止、下管导通，引脚被下拉到 GND。两个管子像推拉一样交替工作，因此称为推挽。

正是因为推挽结构在任何时刻都有一个 MOS 管导通，所以它能够提供较强的输出驱动能力，无论是拉电流还是灌电流都能达到较大的数值。同时，输出引脚不会处于高阻状态，抗干扰能力较强。

4.2 推挽输出的特点与使用场景

推挽输出的主要特点包括：输出高低电平明确、驱动能力强、速度快、无需外部上拉电阻。它适合驱动 LED、数码管、蜂鸣器等需要明确电平的负载，也适合作为高速通信接口的普通 IO 使用。

但推挽输出也有局限：如果两个推挽输出引脚直接短接，一个输出高、一个输出低，会在两个 MOS 管之间形成近乎短路的大电流，可能烧毁芯片。因此推挽输出不能直接用于需要“线与”或共享总线的场景。

4.3 推挽驱动 LED 的两种接法

使用推挽输出驱动 LED，既可以采用拉电流接法，也可以采用灌电流接法。拉电流接法为 GPIO 引脚串联限流电阻到 LED 阳极，LED 阴极接地。灌电流接法为电源 VDD 串联限流电阻到 LED 阳极，LED 阴极接 GPIO 引脚。前者引脚输出高电平点亮，后者引脚输出低电平点亮。

由于 STM32 的灌电流能力通常强于拉电流能力，所以推荐使用灌电流接法，尤其是当 LED 数量较多或需要保证亮度一致时。例如 PC13 引脚的驱动能力非常有限，更建议采用灌电流方式，让 LED 阳极接 3.3V，阴极接 PC13，通过 PC13 输出低电平来点亮 LED。

下面是一段典型的推挽输出低电平点亮 LED 的 C++ 代码片段，基于寄存器操作，适用于 STM32F103 的 PC13：

// 使能 GPIOC 时钟 RCC->APB2ENR |= (1U << 4); // 配置 PC13 为通用推挽输出，最大速度 2MHz // CRH 控制高 8 位引脚，PC13 对应 CRH 的 bit23~bit20 GPIOC->CRH &= ~(0xFU << 20); GPIOC->CRH |= (0x2U << 20); // MODE=10(2MHz), CNF=00(推挽输出) // 点亮 LED：PC13 输出低电平 GPIOC->BSRR = (1U << (16 + 13)); // 复位 PC13 // 熄灭 LED：PC13 输出高电平 GPIOC->BSRR = (1U << 13); // 置位 PC13

代码中 BSRR 寄存器的低 16 位写 1 可置位对应引脚，高 16 位写 1 可复位对应引脚。使用 BSRR 可以在一个寄存器写入操作中完成单个引脚的原子操作，避免使用 ODR 寄存器时的读改写竞争问题。

5. 开漏输出深入解析

5.1 开漏的电路结构

开漏输出的电路结构中，上管被移除或始终关闭，只有下管 N-MOS 工作。当输出逻辑低电平时，下管导通，引脚被拉低到 GND；当输出逻辑高电平时，下管也截止，引脚内部既不接 VDD 也不接 GND，呈现高阻状态，相当于“悬空”。因此开漏输出不能自己输出高电平，必须借助外部上拉电阻才能得到高电平。

这种结构可以理解为“只能拉低，不能拉高”。正是这一限制，赋予了开漏输出一些独特的能力，例如电平转换、线与逻辑、驱动高压负载等。

5.2 开漏输出的上拉电阻选择

开漏输出高电平时，电流由上拉电阻提供。上拉电阻阻值越大，静态功耗越小，但上升沿越慢；阻值越小，上升沿越快，但低电平时流过下管的电流越大，功耗增加。通常根据速度和功耗折中选择 1kΩ 至 10kΩ，高速通信时可降至几百欧姆，低速按键输入可增大到几十千欧。

对于驱动 LED 的场景，一般不需要开漏输出，因为 LED 需要确定的电流通路，而开漏高电平需要外部上拉电阻提供电流，驱动能力较弱且会引入额外的电阻功耗。不过，有些特殊电路会故意使用开漏输出驱动 LED，例如希望 LED 的阳极接到高于 MCU 电压的电源时。

5.3 开漏输出的典型应用

开漏输出常用于 I2C、SMBus、1-Wire 等需要多设备共享总线的协议。所有设备都使用开漏或开集电极输出连接在同一条线上，配合上拉电阻，任何一个设备都可以拉低总线，而不会出现推挽短路的问题。这种“线与”能力是开漏输出最重要的价值。

此外，开漏输出还可以实现电平转换。例如 MCU 工作于 3.3V，但需要驱动 5V 的负载，可以把开漏引脚经上拉电阻接到 5V，当引脚输出低电平时拉低 5V 侧，输出高电平时由 5V 上拉电阻提供高电平，从而实现 3.3V 到 5V 的电平匹配。

6. PC13 引脚的硬件特殊性

6.1 PC13 的供电域与复位行为

在 STM32F1/F2/F4 等系列中，PC13、PC14、PC15 属于 RTC 域，由 VBAT 或 VDD 经内部开关供电，主要用于 RTC 时钟、备份寄存器和侵入检测等功能。它们与普通 GPIO 相比，有几个关键差异：

• 默认状态：芯片上电复位后，PC13 默认作为 RTC 功能引脚，不是普通 GPIO，除非正确配置后备域，否则不能直接作为输出使用。
• 复位行为：普通 GPIO 受系统复位影响，而 RTC 域引脚的配置在某些复位条件下可能保持不变，导致复位后引脚状态异常。
• 驱动能力：PC13 的最大输出电流通常远小于普通引脚。查阅数据手册可知，PC13 的典型灌电流和拉电流限制在 ±3mA 左右，而普通引脚可达 25mA 或更高。
• 内部结构：PC13 内部可能有较弱的上下拉能力，且不能承受 5V 电压，使用时要特别注意外设电压匹配。

6.2 最大驱动能力与 LED 亮度

很多开发板把 LED 直接连接到 PC13，但为了安全，限流电阻必须取较大值。例如 3.3V 供电、红色 LED 压降 2V，如果希望 PC13 灌电流不超过 3mA，则限流电阻至少应为：

R = (3.3V - 2.0V) / 0.003A ≈ 433Ω

实际取 470Ω 或 510Ω 比较合适。如果使用 1kΩ，电流约为 1.3mA，亮度稍暗但更安全。千万不要因为追求亮度而减小限流电阻，否则可能损坏 PC13 或缩短芯片寿命。

6.3 使用 PC13 前配置后备域

在 STM32F1 上，要让 PC13 作为普通 GPIO 输出，必须先使能 AFIO 时钟，并关闭侵入检测和 RTC 输出等复用功能，然后正确配置 GPIO。一个常见错误是只配置 GPIOC 的 CRH 寄存器，却忘记使能 AFIO 时钟或清除相关复用配置，导致 PC13 仍然是 RTC 功能，无法正常输出。

下面的代码展示了在 STM32F1 上正确初始化 PC13 的步骤：

// 使能 GPIOC 和 AFIO 时钟 RCC->APB2ENR |= (1U << 4) | (1U << 0); // 关闭 PC13 的 RTC 复用功能 // 此步骤在部分型号中不是必需，但为确保兼容建议执行 AFIO->MAPR &= ~(1U << 15); // 清除 RTC 输出重映射 // 配置 PC13 为通用推挽输出，最大速度 2MHz GPIOC->CRH &= ~(0xFU << 20); GPIOC->CRH |= (0x2U << 20);

在 STM32F4 上，PC13 属于备份域，需要先使能 PWR 时钟，再通过 PWR 控制寄存器解锁备份域，之后才能配置 PC13。相关代码略有不同，但核心思想一致：PC13 不是“开箱即用”的普通 GPIO，必须处理后备域的相关配置。

7. LED 驱动电路设计实战

7.1 单 LED 电路

最简单的 LED 电路只需要一个 LED、一个限流电阻和一个 GPIO 引脚。采用灌电流接法时，LED 阳极接 3.3V，阴极经限流电阻接 PC13。当 PC13 输出低电平时，LED 点亮；输出高电平时熄灭。注意，如果采用拉电流接法，由于 PC13 拉电流能力很弱，LED 可能非常暗，甚至无法点亮。

下面是一个常用电路参数表：

7.2 多 LED 扫描电路

如果要点亮多个 LED，一种方式是每个 LED 单独占用一个 GPIO，另一种是使用矩阵扫描或查理复用。对于 PC13 这类驱动能力弱的引脚，不建议直接驱动多个 LED。若必须使用，应外接三极管或 MOS 管进行电流放大。

使用 NPN 三极管驱动 LED 时，GPIO 引脚只需提供很小的基极电流，就可以控制 LED 的较大电流。这种方案既保护了 MCU 引脚，又能保证 LED 亮度，是工程中非常实用的设计。

8. Linux 下的 C++ 嵌入式开发环境准备

8.1 交叉编译工具链

在 Linux 下进行 STM32 开发，最常用的是 arm-none-eabi-gcc 工具链。安装命令因发行版而异，例如在 Ubuntu/Debian 上可以执行：

sudo apt update sudo apt install gcc-arm-none-eabi gdb-multiarch openocd

工具链安装完成后，可以使用 arm-none-eabi-g++ 编译 C++ 代码。与桌面 C++ 不同，嵌入式 C++ 通常不依赖标准库，因此编译时需要链接精简的启动文件和链接脚本，并指定合适的 CPU 架构与 FPU 选项。

8.2 工程结构与 Makefile

一个最小化的 STM32 C++ 工程可以包含以下文件：

project/ ├── Makefile ├── linker.ld ├── startup_stm32f103.s ├── main.cpp ├── gpio.hpp ├── gpio.cpp └── system.cpp

Makefile 负责编译、链接和生成固件。下面是一个简化的 Makefile 示例：

CXX = arm-none-eabi-g++ CC = arm-none-eabi-gcc LD = arm-none-eabi-g++ CXXFLAGS = -mcpu=cortex-m3 -mthumb -Os -fno-exceptions -fno-rtti -ffreestanding LDFLAGS = -mcpu=cortex-m3 -mthumb -T linker.ld -Wl,--gc-sections -nostartfiles OBJS = main.o gpio.o system.o startup_stm32f103.o all: firmware.elf firmware.elf: $(OBJS) $(LD) $(LDFLAGS) -o $@ $^ %.o: %.cpp $(CXX) $(CXXFLAGS) -c -o $@ $< %.o: %.s $(CC) -mcpu=cortex-m3 -mthumb -c -o $@ $< clean: rm -f *.o *.elf *.bin *.hex

注意 C++ 嵌入式开发通常需要禁用异常和 RTTI 以减小代码体积，使用 -ffreestanding 表示不依赖宿主系统库。对于 STM32F1，CPU 为 Cortex-M3；如果使用 F4，则改为 Cortex-M4，并增加 -mfpu=fpv4-sp-d16 -mfloat-abi=hard 等选项。

8.3 OpenOCD 下载与调试

编译生成的 firmware.elf 可以通过 ST-Link、J-Link 或 DAP-Link 等调试器下载到开发板。以 ST-Link 为例，OpenOCD 命令行如下：

openocd -f interface/stlink.cfg -f target/stm32f1x.cfg -c "program firmware.elf verify reset exit"

使用 gdb-multiarch 可以进行在线调试，设置断点、单步执行并查看寄存器。Linux 下的调试体验不输 Windows 下的 IDE，只是需要熟悉命令行工具。

9. 基于 C++ 的 GPIO 封装设计

9.1 为什么用 C++ 封装 GPIO

C 语言操作 GPIO 通常直接读写寄存器，代码简洁但可读性差、复用性低。C++ 可以通过类、模板和内联函数，在不增加运行时开销的前提下，把寄存器操作封装成语义清晰的接口。由于 C++ 在编译期可以完成大量类型检查和优化，生成的机器码与 C 语言几乎一致。

下面封装一个 GpioPin 类，实现配置、置位、复位和翻转功能。该类基于模板将 Port 和 Pin 作为编译期常量，从而避免运行时查表开销。

9.2 GPIO 封装代码示例

// gpio.hpp #pragma once #include <cstdint> struct Gpio { volatile uint32_t CRL, CRH, IDR, ODR, BSRR, BRR, LCKR; }; class GpioPin { public: GpioPin(Gpio* port, uint32_t pin) : port_(port), pin_(pin) {} void setOutputPushPull(uint32_t speed = 0x2) { if (pin_ < 8) { uint32_t shift = pin_ * 4; port_->CRL &= ~(0xFU << shift); port_->CRL |= (speed << shift); } else { uint32_t shift = (pin_ - 8) * 4; port_->CRH &= ~(0xFU << shift); port_->CRH |= (speed << shift); } } void setHigh() { port_->BSRR = (1U << pin_); } void setLow() { port_->BSRR = (1U << (pin_ + 16)); } void toggle() { port_->ODR ^= (1U << pin_); } private: Gpio* port_; uint32_t pin_; };

实际使用中可以进一步用模板消除运行时指针，例如：

template<Gpio* Port, uint32_t Pin> class GpioPinT { public: static void setOutputPushPull(uint32_t speed = 0x2) { if constexpr (Pin < 8) { constexpr uint32_t shift = Pin * 4; Port->CRL &= ~(0xFU << shift); Port->CRL |= (speed << shift); } else { constexpr uint32_t shift = (Pin - 8) * 4; Port->CRH &= ~(0xFU << shift); Port->CRH |= (speed << shift); } } static void setHigh() { Port->BSRR = (1U << Pin); } static void setLow() { Port->BSRR = (1U << (Pin + 16)); } };

使用模板后，代码几乎不产生额外开销，而且由于 Port 和 Pin 都是编译期常量，编译器可以生成更优化的指令。

9.3 主程序实现

// main.cpp #include "gpio.hpp" extern "C" void SystemInit() {} int main() { // 使能 GPIOC 和 AFIO 时钟 // RCC 基址 0x40021000，APB2ENR 偏移 0x18 volatile uint32_t* RCC_APB2ENR = reinterpret_cast<volatile uint32_t*>(0x40021018); *RCC_APB2ENR |= (1U << 4); Gpio* gpioc = reinterpret_cast<Gpio*>(0x40011000); GpioPin led(gpioc, 13); led.setOutputPushPull(0x2); // 2MHz 推挽输出 while (true) { led.setLow(); // 点亮 for (volatile int i = 0; i < 500000; ++i); led.setHigh(); // 熄灭 for (volatile int i = 0; i < 500000; ++i); } }

上述代码使用内存映射寄存器地址，不依赖任何厂商库，在 Linux 下用 arm-none-eabi-g++ 编译即可。实际工程中建议将寄存器地址定义在头文件中，并封装 RCC 时钟管理。

10. 寄存器级操作与位运算细节

10.1 配置寄存器的位域操作

GPIO 配置的关键是操作 CRL、CRH、BSRR 等寄存器。在修改某个位域时，必须使用“先清零后赋值”的方法，避免影响其他位。例如要修改 PC13 的配置，先执行：

CRH &= ~(0xFU << 20);

这条语句将 CRH 的 bit23~20 清零，其他位保持不变。然后执行：

CRH |= (0x2U << 20);

将 0010 写入该位域。0x2 的二进制为 0010，代表 MODE=10（2MHz），CNF=00（通用推挽输出）。

10.2 BSRR 与 BRR 的原子操作优势

ODR 寄存器直接反映引脚输出状态，但使用 ODR 修改单个引脚时，通常需要读-改-写三个步骤，期间如果发生中断或并发访问，可能丢失更新。BSRR 和 BRR 寄存器则不同：向 BSRR 的低 16 位写 1 可置位对应引脚，向高 16 位写 1 可复位对应引脚，且不需要读回当前状态，是真正的原子操作。

例如点亮 PC13（低电平）时，向 BSRR 的 bit29 写 1，即 1U << (13 + 16)；熄灭时向 bit13 写 1。这样每次操作只影响一个引脚，不会干扰其他 IO。

10.3 输出速度与 EMI

GPIO 输出速度并非越大越好。高速输出会带来更大的电磁干扰和振铃，尤其是在接有较长导线或感性负载时。对于点亮 LED 这种低频应用，选择 2MHz 或 10MHz 足以。如果使用 50MHz 输出，LED 开关瞬间可能产生明显的高频噪声，影响附近的模拟电路或无线收发。

11. 用逻辑分析仪验证推挽与开漏

理论分析之外，动手测量是理解硬件最好的方式。准备一个逻辑分析仪或示波器，分别测量推挽输出和开漏输出的波形。对于推挽输出，在高电平状态下输出电压接近 VDD，低电平接近 0V，上升沿和下降沿都非常陡峭。对于开漏输出，如果不加上拉电阻，高电平期间引脚悬空，电压不确定，可能在中间电平浮动；加上适当上拉电阻后，高电平被拉到 VDD，但上升沿的斜率与上拉电阻和线路电容有关，通常比推挽慢。

使用逻辑分析仪还可以观察 LED 点亮时的实际电平变化。在低电平点亮模式下，LED 点亮时引脚电压接近 0V，熄灭时接近 3.3V。通过对比不同限流电阻下的波形，可以直观理解电流对 LED 亮度的影响。

12. 常见问题排查

12.1 LED 不亮

如果 LED 不亮，首先检查电源和极性。LED 有正负极，接反了不会亮。其次检查限流电阻是否虚焊或阻值过大，导致电流过小。再次检查 GPIO 配置：是否使能了端口时钟？模式配置是否正确？引脚复用是否关闭？对于 PC13，还要检查后备域配置和 AFIO 时钟。

可以使用万用表测量 GPIO 引脚电压。如果配置为输出低电平，引脚却为高电平，说明配置未生效；如果引脚为低电平但 LED 仍不亮，问题可能在电路侧。

12.2 LED 亮度异常

LED 亮度不足可能因为电流太小或占空比过低。如果使用 PWM 调光，需要检查频率和占空比设置。LED 亮度不均匀还可能与 GPIO 驱动能力差异有关，例如不同引脚的灌电流能力不同，导致同样限流电阻下亮度不一致。

12.3 复位后 LED 状态变化

有些开发板复位后 LED 会闪一下或短暂亮起。这可能是由于复位瞬间 GPIO 处于默认输入浮空状态，引脚电平不确定，LED 回路可能有瞬时电流。通过外部上下拉电阻或调整电路设计可以缓解，但通常不影响功能。

13. 进阶：使用 HAL 和 LL 库操作 PC13

虽然寄存器操作能深入理解硬件，但实际项目中更常用 STM32 官方提供的 HAL 或 LL 库。HAL 库抽象程度高，代码可移植性好；LL 库更接近寄存器，效率高。下面给出使用 HAL 库点亮 PC13 LED 的示例：

#include "stm32f1xx_hal.h" int main(void) { HAL_Init(); __HAL_RCC_GPIOC_CLK_ENABLE(); __HAL_RCC_AFIO_CLK_ENABLE(); GPIO_InitTypeDef gpio = {}; gpio.Pin = GPIO_PIN_13; gpio.Mode = GPIO_MODE_OUTPUT_PP; gpio.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOC, &gpio); while (1) { HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); // 点亮 HAL_Delay(500); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); // 熄灭 HAL_Delay(500); } }

LL 库版本则更简洁：

#include "stm32f1xx_ll_gpio.h" #include "stm32f1xx_ll_rcc.h" int main(void) { LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_GPIOC); LL_GPIO_SetPinMode(GPIOC, LL_GPIO_PIN_13, LL_GPIO_MODE_OUTPUT); LL_GPIO_SetPinOutputType(GPIOC, LL_GPIO_PIN_13, LL_GPIO_OUTPUT_PUSHPULL); LL_GPIO_SetPinSpeed(GPIOC, LL_GPIO_PIN_13, LL_GPIO_SPEED_FREQ_LOW); while (1) { LL_GPIO_ResetOutputPin(GPIOC, LL_GPIO_PIN_13); for (volatile int i = 0; i < 500000; i++); LL_GPIO_SetOutputPin(GPIOC, LL_GPIO_PIN_13); for (volatile int i = 0; i < 500000; i++); } }

使用库函数时，依然要理解底层硬件，否则遇到问题时无法深入排查。例如很多初学者使用 HAL 库点亮 PC13 失败，原因就是没有使能 AFIO 时钟或没有关闭 RTC 复用，而这些细节在寄存器操作时同样存在。

14. 与 Linux 主机通信：串口输出调试

在没有屏幕的开发板上，串口是最重要的调试手段。在 Linux 主机上可以使用 minicom、picocom 或 screen 打开串口终端。STM32 的 USART 外设可以非常方便地与 PC 通信。下面演示如何配置 USART1 并打印日志，帮助调试 LED 控制逻辑。

#include "stm32f1xx_hal.h" #include <cstdio> UART_HandleTypeDef huart1; void init_uart() { __HAL_RCC_USART1_CLK_ENABLE(); __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitTypeDef gpio = {}; gpio.Pin = GPIO_PIN_9 | GPIO_PIN_10; gpio.Mode = GPIO_MODE_AF_PP; gpio.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, &gpio); huart1.Instance = USART1; huart1.Init.BaudRate = 115200; huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE; HAL_UART_Init(&huart1); } int _write(int fd, char* ptr, int len) { HAL_UART_Transmit(&huart1, (uint8_t*)ptr, len, 100); return len; } int main() { HAL_Init(); init_uart(); printf("UART ready\r\n"); // 初始化 LED 后打印状态 // ... }

在 Linux 主机上执行以下命令打开串口：

sudo minicom -D /dev/ttyUSB0 -b 115200

通过串口打印，可以实时观察程序运行状态，结合 LED 现象快速定位问题。

15. 总结与学习建议

点亮一颗 LED 看似简单，但背后涉及 GPIO 输出结构、推挽与开漏原理、灌电流与拉电流选择、限流电阻计算、PC13 后备域配置、寄存器操作、C++ 封装以及 Linux 工具链使用。掌握这些知识，才算真正入门了嵌入式硬件编程。

建议读者按照以下步骤进行实践：

1. 先使用面包板搭建 LED 电路，分别尝试拉电流和灌电流接法，感受亮度差异。
2. 在 Linux 下编写最小寄存器程序点亮 PC13，并用万用表测量引脚电平。
3. 对比推挽输出与开漏输出的波形，理解内部结构。
4. 将代码封装成 C++ 类，体验模板和编译期常量的优势。
5. 尝试使用 HAL 库和 LL 库实现相同功能，比较代码风格与可调试性。
6. 修改限流电阻，观察 LED 亮度与电流关系。
7. 使用逻辑分析仪分析输出波形，验证对推挽和开漏的理解。

完成上述实践后，相信你已经真正掌握了 LED 点亮的硬件秘密。下一篇我们将继续深入 GPIO 输入模式、中断与消抖，为按键输入和复杂交互打下基础。