Arduino IDE + STM32 + ST-LINK V2 连接问题排查笔记
记录用 Arduino IDE 给 STM32 烧录时 ST-LINK V2 死活识别不到的几个排查方向，从驱动到 IDE 配置一步步走。
支持通配符SSL证书、多域名证书、IP证书。适配ACME接口, 支持Zerossl、Let's Encrypt和Google等渠道。登录已有账号
2026-08-21 22:15:46 STM32 GPIO HAL库
STM32 控制 LED 最常用的就是 GPIO 推挽输出，HAL 库里面配置起来不复杂，几个参数固定下来就行。推挽输出模式用 GPIO_MODE_OUTPUT_PP 这个参数，驱动能力够，高低电平都能出，而且不需要外部上下拉电阻，所以 Pull 参数直接给 GPIO_NOPULL。
Speed 的话，点灯用 GPIO_SPEED_FREQ_LOW 就够了，没必要上高速，高速反而可能引入一些干扰，功耗也会高一点。这里其实容易踩坑，很多人配置的时候顺手就把 Speed 设成了 HIGH，点个灯完全用不上。
主程序很简单，初始化完 HAL、时钟、GPIO 之后，在 while 循环里翻转 PA5 电平，延时 500ms。代码长这样：
#include "stm32f4xx_hal.h"
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
int main(void)
{
HAL_Init();
SystemClock_Config();
MX_GPIO_Init();
while (1)
{
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // 翻转PA5电平
HAL_Delay(500); // 延时500ms
}
}
GPIO 初始化函数里，先使能 GPIOA 时钟，然后把 Pin、Mode、Pull、Speed 填好，调用 HAL_GPIO_Init。
如果漏掉 __HAL_RCC_GPIOA_CLK_ENABLE 这一句，后面电平怎么变都不会生效，这个点不少人在调试的时候会绕进去。
static void MX_GPIO_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA时钟
GPIO_InitStruct.Pin = GPIO_PIN_5;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出模式
GPIO_InitStruct.Pull = GPIO_NOPULL; // 无上下拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; // 低速输出
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}
系统时钟配置这段基本是 CubeMX 生成的，用 HSE 作为时钟源，PLL 倍频到 168M，APB1 四分频，APB2 二分频，Flash latency 配成 5。自己改的时候主要确认 HSE 状态和 PLL 参数，别把分频系数搞错。
void SystemClock_Config(void)
{
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
__HAL_RCC_PWR_CLK_ENABLE();
__HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1);
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLM = 8;
RCC_OscInitStruct.PLL.PLLN = 336;
RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
RCC_OscInitStruct.PLL.PLLQ = 7;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler();
}
RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
|RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV4;
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV2;
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_5) != HAL_OK)
{
Error_Handler();
}
}
编译和烧录用 arm-none-eabi-gcc 和 openocd，Makefile 已经写好，直接 make 编译，make flash 烧录。链接脚本用的是 stm32f4xx_linker.ld，openocd 通过 stlink-v2 接口。
TARGET = gpio_output_example
CC = arm-none-eabi-gcc
CFLAGS = -mcpu=cortex-m4 -mthumb -Wall -g -O0
LDFLAGS = -T stm32f4xx_linker.ld -nostdlib
LIBS = -lc -lm -lnosys
SRCS = gpio_output_example.c
OBJS = $(SRCS:.c=.o)
all: $(TARGET).elf
$(TARGET).elf: $(OBJS)
$(CC) $(LDFLAGS) -o $@ $^ $(LIBS)
%.o: %.c
$(CC) $(CFLAGS) -c -o $@ $<
clean:
rm -f $(OBJS) $(TARGET).elf
flash: $(TARGET).elf
openocd -f interface/stlink-v2.cfg -f target/stm32f4x.cfg -c "program $(TARGET).elf verify reset exit"
最后提几个点。GPIOA 时钟使能不能漏，漏了以后电平不会变化，调半天找不到原因。输出模式选推挽输出，开漏输出驱动 LED 能力不够，还得外接上拉。控制电平用 HAL_GPIO_TogglePin 可以翻转，用 HAL_GPIO_WritePin 可以写固定电平，看需求选。
Speed 参数点灯用低速，快速切换的场景再考虑高速。
记录用 Arduino IDE 给 STM32 烧录时 ST-LINK V2 死活识别不到的几个排查方向，从驱动到 IDE 配置一步步走。