STM32F407VGT6从零建立一个标准库工程模板+VSCode或Keil5

一、前言

下载平台:STM32F407ZGT6
代码使用平台:VSCode
编译器:arm-none-aebi-gcc ---- 默认你已经安装
程序下载工具:STlink ---- 默认你拥有
批处理工具:make ---- 默认你已经安装
使用此方法可以不借助其它插件，例如:STM32EIDE。这个方法已经经过验证可以在STM32F103C8T6、STM32F103C6T6与STM32F407ZET6使用，因此个人认为此方法可以跨系列通用。
这里简要说明一下使用VSCode且不借助第三方插件的实现思路:
1.使用arm-none-aebi-gcc来编译工程
2.使用openocd通过STLink或者JLink来讲固件上传到STM32的Flash中
本文也会介绍Keil5创建标准库工程的方法。如果并不想了解VSCode创建工程，可以直接跳到Keil5创建工程部分。

二、开始新建工程

1、下载库文件

我们需要去ARM官网下载库文件,这个里面藏得有点深。不过我这里把流程也说一下吧！
我们最好把HAL库与标准库都下载下来吧，未来可以两个库一起学习！

1.1来到官网下载标准库文件

一步到位下载STM32F4的标准库:STSW-STM32065 | Product - STMicroelectronics
ST官网:https://www.st.com/
![[Pasted image 20250819195318.png]]

1.2来到官网下载HAL库文件

一步到位下载STM32F4的HAL库文件:www.st.com
ST官网:https://www.st.com/

完成之后

2、开始配置VSCOde工程

我们这里配置的能在VSCode中，不借助Keil5工具的方法。当然我后面也会提供配置Keil5配置的方法。
我们先创建5个文件吧,精简工程

结构如下:

这里讲述一下各个文件的作用,然后我们开始迁移文件吧！

文件夹	作用
CMSIS	放置核心的文件与汇编文件
Library	放置外设的头文件与源文件
Start	放置启动的文件
User	放置用户编写文件
ThirdPart	放置第三方库,比如:FreeRtos、LVGL

2.1、配置CMSIS文件夹核心文件与汇编文件

2.1.1来到标准库

路径：
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Include
全部复制到，我们的CMSIS文件夹中

2.1.2、来到HAL库

路径:
.\STM32Cube_FW_F4_V1.28.0\Drivers\CMSIS\Device\ST\STM32F4xx\Source\Templates\gcc
我们的芯片是STM32F407VGT6所以我们需要复制startup_stm32f407xx.s到CMSIS

3.CMSIS文件夹完成图

2.2、配置Library文件夹标准外设库文件

2.2.1、来到标准库

路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\STM32F4xx_StdPeriph_Driver
我们直接将inc与src直接复制到我们的Library文件夹中

不过我们需要在inc与src中把stm32f4xx_fmc.h和stm32f4xx_fmc.c文件移除，因为此文件与工程中的另外一个文件有重复定义部分，我们暂时移除。

2.2.2、Library文件夹完成图

2.3、配置Start文件夹启动文件

2.3.1、来到标准库

在标准库中的路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Device\ST\STM32F4xx\Include
我们把此文件夹下的文件复制到Start文件夹中

在标准库中的路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Device\ST\STM32F4xx\Source\Templates
我们把此文件夹下的文件system_stm32f4xx.c复制到Start文件夹中

在标准库中的路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Project\STM32F4xx_StdPeriph_Templates
我们把此文件夹下的文件stm32f4xx_conf.h复制到Start文件夹中

2.3.2、Start启动文件夹完成图

2.4、配置User文件夹用户文件

2.4.1、来到标准库

在标准库中的路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Project\STM32F4xx_StdPeriph_Templates
我们把此文件夹下的文件mian.h、stmf4xx_it.h复制到User/inc文件夹中
我们把此文件夹下的文件mian.c、stmf4xx_it.c复制到User/src文件夹中

2.4.2、User用户文件夹的配置完成图

2.5、配置部分文件

此部分的前提是你安装过arm-none-aebi-gcc与openocd并且配置好了环境。如果不会或者其它，我会专门出一份教程来讲述arm-none-aebi-gcc与openocd。这里你只要知道，我会在这本部分的openocd的放置路径说明就行。

提前创建好Makefile文件与STM32F407VGTx_FLASH.ld文件

2.5.1、配置Makefile文件

1、懒得看那么多字，直接一步到位

不过还是建议，看一遍后文哦！

################################################################################################
# Generic Makefile for STM32F407VGT6 (GCC)
################################################################################################
TARGET = template
DEBUG = 1
OPT   = -Og
BUILD_DIR = build
######################################
# source
######################################
C_SOURCES = \
$(wildcard ./CMSIS/*.c) \
$(wildcard ./Library/src/*.c) \
$(wildcard ./Start/*.c) \
$(wildcard ./User/src/*.c)ASM_SOURCES = \
./CMSIS/startup_stm32f407xx.s
######################################
# binaries
######################################
PREFIX  = arm-none-eabi-
CC      = $(PREFIX)gcc
CXX     = $(PREFIX)g++  # 添加 C++ 支持
AS      = $(PREFIX)gcc -x assembler-with-cpp
CP      = $(PREFIX)objcopy
SZ      = $(PREFIX)size
HEX     = $(CP) -O ihex
BIN     = $(CP) -O binary -S
######################################
# CFLAGS
######################################
CPU        = -mcpu=cortex-m4
FPU        = -mfpu=fpv4-sp-d16 -mfloat-abi=hard
MCU        = $(CPU) -mthumb $(FPU)C_DEFS = \
-DSTM32F40_41xxx \
-DUSE_STDPERIPH_DRIVER \
-DHSE_VALUE=8000000  # 添加时钟定义C_INCLUDES = \
-ICMSIS \
-ILibrary/inc \
-IStart \
-IUser/inc# 添加 C++ 支持标志
CXXFLAGS = $(CFLAGS) -fno-exceptions -fno-rtti -fno-threadsafe-statics -fno-use-cxa-atexitASFLAGS  = $(MCU) $(OPT) -Wall -fdata-sections -ffunction-sections
CFLAGS   = $(MCU) $(C_DEFS) $(C_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections
ifeq ($(DEBUG), 1)
CFLAGS  += -g -gdwarf-2
endif
CFLAGS  += -MMD -MP -MF"$(@:%.o=%.d)"
# 添加链接时优化
#LTO_FLAGS = -flto -ffat-lto-objects
# 1. 关闭 LTO
LTO_FLAGS =
######################################
# LDFLAGS
######################################
LDSCRIPT = STM32F407VGTx_FLASH.ld
LIBS     = -lc -lm -lnosys -lstdc++  # 添加 C++ 库支持
LDFLAGS  = $(MCU) -specs=nano.specs -specs=nosys.specs -T$(LDSCRIPT) $(LIBS) \-Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref -Wl,--gc-sections \-Wl,--print-memory-usage  # 添加内存使用报告
# 2. 关闭 --gc-sections
#LDFLAGS  = $(MCU) -specs=nano.specs -specs=nosys.specs -T$(LDSCRIPT) $(LIBS) \-Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref \-Wl,--print-memory-usage
######################################
# build rules
######################################
all: $(BUILD_DIR)/$(TARGET).elf $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).bin
OBJECTS = $(addprefix $(BUILD_DIR)/,$(notdir $(C_SOURCES:.c=.o)))
vpath %.c $(sort $(dir $(C_SOURCES)))
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(ASM_SOURCES:.s=.o)))
vpath %.s $(sort $(dir $(ASM_SOURCES)))
$(BUILD_DIR)/%.o: %.c Makefile | $(BUILD_DIR)$(CC) -c $(CFLAGS) $(LTO_FLAGS) -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(notdir $(<:.c=.lst)) $< -o $@
$(BUILD_DIR)/%.o: %.s Makefile | $(BUILD_DIR)$(AS) -c $(CFLAGS) $< -o $@
$(BUILD_DIR)/$(TARGET).elf: $(OBJECTS) Makefile$(CC) $(OBJECTS) $(LDFLAGS) $(LTO_FLAGS) -o $@$(SZ) $@@echo "Memory usage:"@arm-none-eabi-size $@
$(BUILD_DIR)/%.hex: $(BUILD_DIR)/%.elf | $(BUILD_DIR)$(HEX) $< $@
$(BUILD_DIR)/%.bin: $(BUILD_DIR)/%.elf | $(BUILD_DIR)$(BIN) $< $@
$(BUILD_DIR):mkdir $@
######################################
# clean
######################################
ifeq ($(OS),Windows_NT)RM = rmdir /S /Q
elseRM = rm -rf
endif
clean:-$(RM) $(BUILD_DIR)
######################################
# download (openocd)
######################################
download:openocd -f "D:/SoftWare/Environment/openocd/scripts/interface/stlink-v2.cfg" -f "D:/SoftWare/Environment/openocd/scripts/target/stm32f4x.cfg" \-c init -c halt \-c "program $(BUILD_DIR)/$(TARGET).elf verify reset exit"
######################################
# J-Link flash (auto generate script)
######################################
jlink:@echo starting...@echo r > temp_script.jlink@echo h >> temp_script.jlink@echo loadfile $(BUILD_DIR)/$(TARGET).hex >> temp_script.jlink@echo r >> temp_script.jlink@echo q >> temp_script.jlink@echo using J-Link..."C:/Progra~1/SEGGER/JLink_V856a/JLink.exe" -device STM32F407ZE -if SWD -speed 4000 -CommanderScript temp_script.jlink@del temp_script.jlink@echo === success ===
# 添加调试目标
debug:@echo r > temp_debug.jlink@echo h >> temp_debug.jlink@echo loadfile $(BUILD_DIR)/$(TARGET).elf >> temp_debug.jlink@echo r >> temp_debug.jlink@echo g >> temp_debug.jlink"C:/Progra~1/SEGGER/JLink_V856a/JLink.exe" -device STM32F407ZE -if SWD -speed 4000 -CommanderScript temp_debug.jlink@del temp_debug.jlink
-include $(wildcard $(BUILD_DIR)/*.d)

2、开始编写Makefile文件

我们在编写Makefile文件之前，一定要明确5件事
1.谁编译 ---- arm-none-aebi-xxx
2.源文件在哪
3.头文件在哪
4.汇编文件在哪
5.链接文件在哪
当然，这是看懂一个Makefile文件的前提，可以不会写，但是一定要能看懂大概在干什么。
下文会大致介绍，但是实际实现的Makefile不会那么简单，但是核心逻辑就是如此。
即便换成其它系列的芯片，核心改的地方大致也就是这几个地方！

2.1、谁编译

这里不仅添加了arm-none-eabi支持C还加入了C++支持，并且为了编译汇编文件支持。

######################################
# binaries
######################################
PREFIX  = arm-none-eabi-
CC      = $(PREFIX)gcc
CXX     = $(PREFIX)g++  # 添加 C++ 支持
AS      = $(PREFIX)gcc -x assembler-with-cpp
CP      = $(PREFIX)objcopy
SZ      = $(PREFIX)size
HEX     = $(CP) -O ihex
BIN     = $(CP) -O binary -S

2.2、源文件在哪

######################################
# source
######################################
C_SOURCES = \
$(wildcard ./CMSIS/*.c) \
$(wildcard ./Library/src/*.c) \
$(wildcard ./Start/*.c) \
$(wildcard ./User/src/*.c)

2.3、头文件在哪

C_INCLUDES = \
-ICMSIS \
-ILibrary/inc \
-IStart \
-IUser/inc

2.4、汇编文件在哪

ASM_SOURCES = \
./CMSIS/startup_stm32f407xx.s

2.5、链接文件在哪

######################################
# LDFLAGS
######################################
LDSCRIPT = STM32F407VGTx_FLASH.ld

2.6、这里提供一份现成的Makefile

################################################################################################
# Generic Makefile for STM32F407VGT6 (GCC)
################################################################################################
TARGET = template
DEBUG = 1
OPT   = -Og
BUILD_DIR = build
######################################
# source
######################################
C_SOURCES = \
$(wildcard ./CMSIS/*.c) \
$(wildcard ./Library/src/*.c) \
$(wildcard ./Start/*.c) \
$(wildcard ./User/src/*.c)ASM_SOURCES = \
./CMSIS/startup_stm32f407xx.s
######################################
# binaries
######################################
PREFIX  = arm-none-eabi-
CC      = $(PREFIX)gcc
CXX     = $(PREFIX)g++  # 添加 C++ 支持
AS      = $(PREFIX)gcc -x assembler-with-cpp
CP      = $(PREFIX)objcopy
SZ      = $(PREFIX)size
HEX     = $(CP) -O ihex
BIN     = $(CP) -O binary -S
######################################
# CFLAGS
######################################
CPU        = -mcpu=cortex-m4
FPU        = -mfpu=fpv4-sp-d16 -mfloat-abi=hard
MCU        = $(CPU) -mthumb $(FPU)C_DEFS = \
-DSTM32F40_41xxx \
-DUSE_STDPERIPH_DRIVER \
-DHSE_VALUE=8000000  # 添加时钟定义C_INCLUDES = \
-ICMSIS \
-ILibrary/inc \
-IStart \
-IUser/inc# 添加 C++ 支持标志
CXXFLAGS = $(CFLAGS) -fno-exceptions -fno-rtti -fno-threadsafe-statics -fno-use-cxa-atexitASFLAGS  = $(MCU) $(OPT) -Wall -fdata-sections -ffunction-sections
CFLAGS   = $(MCU) $(C_DEFS) $(C_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections
ifeq ($(DEBUG), 1)
CFLAGS  += -g -gdwarf-2
endif
CFLAGS  += -MMD -MP -MF"$(@:%.o=%.d)"
# 添加链接时优化
#LTO_FLAGS = -flto -ffat-lto-objects
# 1. 关闭 LTO
LTO_FLAGS =
######################################
# LDFLAGS
######################################
LDSCRIPT = STM32F407VGTx_FLASH.ld
LIBS     = -lc -lm -lnosys -lstdc++  # 添加 C++ 库支持
LDFLAGS  = $(MCU) -specs=nano.specs -specs=nosys.specs -T$(LDSCRIPT) $(LIBS) \-Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref -Wl,--gc-sections \-Wl,--print-memory-usage  # 添加内存使用报告
# 2. 关闭 --gc-sections
#LDFLAGS  = $(MCU) -specs=nano.specs -specs=nosys.specs -T$(LDSCRIPT) $(LIBS) \-Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref \-Wl,--print-memory-usage
######################################
# build rules
######################################
all: $(BUILD_DIR)/$(TARGET).elf $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).bin
OBJECTS = $(addprefix $(BUILD_DIR)/,$(notdir $(C_SOURCES:.c=.o)))
vpath %.c $(sort $(dir $(C_SOURCES)))
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(ASM_SOURCES:.s=.o)))
vpath %.s $(sort $(dir $(ASM_SOURCES)))
$(BUILD_DIR)/%.o: %.c Makefile | $(BUILD_DIR)$(CC) -c $(CFLAGS) $(LTO_FLAGS) -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(notdir $(<:.c=.lst)) $< -o $@
$(BUILD_DIR)/%.o: %.s Makefile | $(BUILD_DIR)$(AS) -c $(CFLAGS) $< -o $@
$(BUILD_DIR)/$(TARGET).elf: $(OBJECTS) Makefile$(CC) $(OBJECTS) $(LDFLAGS) $(LTO_FLAGS) -o $@$(SZ) $@@echo "Memory usage:"@arm-none-eabi-size $@
$(BUILD_DIR)/%.hex: $(BUILD_DIR)/%.elf | $(BUILD_DIR)$(HEX) $< $@
$(BUILD_DIR)/%.bin: $(BUILD_DIR)/%.elf | $(BUILD_DIR)$(BIN) $< $@
$(BUILD_DIR):mkdir $@
######################################
# clean
######################################
ifeq ($(OS),Windows_NT)RM = rmdir /S /Q
elseRM = rm -rf
endif
clean:-$(RM) $(BUILD_DIR)
######################################
# download (openocd)
######################################
download:openocd -f "D:/SoftWare/Environment/openocd/scripts/interface/stlink-v2.cfg" -f "D:/SoftWare/Environment/openocd/scripts/target/stm32f4x.cfg" \-c init -c halt \-c "program $(BUILD_DIR)/$(TARGET).elf verify reset exit"
######################################
# J-Link flash (auto generate script)
######################################
jlink:@echo starting...@echo r > temp_script.jlink@echo h >> temp_script.jlink@echo loadfile $(BUILD_DIR)/$(TARGET).hex >> temp_script.jlink@echo r >> temp_script.jlink@echo q >> temp_script.jlink@echo using J-Link..."C:/Progra~1/SEGGER/JLink_V856a/JLink.exe" -device STM32F407ZE -if SWD -speed 4000 -CommanderScript temp_script.jlink@del temp_script.jlink@echo === success ===
# 添加调试目标
debug:@echo r > temp_debug.jlink@echo h >> temp_debug.jlink@echo loadfile $(BUILD_DIR)/$(TARGET).elf >> temp_debug.jlink@echo r >> temp_debug.jlink@echo g >> temp_debug.jlink"C:/Progra~1/SEGGER/JLink_V856a/JLink.exe" -device STM32F407ZE -if SWD -speed 4000 -CommanderScript temp_debug.jlink@del temp_debug.jlink
-include $(wildcard $(BUILD_DIR)/*.d)

那么肯定有人问我，这个Makefile是你写的吗？我的回答是，不完全是，这是STM32CubeMX自动生成并且我经过修改，获得而成的。这里有一些HAL库与标准库的一些兼容性问题，我把其修改成符合标准库的Makefile，这里主要的内容是LTO与链接文件的编写。有兴趣的同学可以去研究研究这里面的区别哦。
这里也提供一份AI帮忙优化的Makefile，验证过使用没问题:

################################################################################################
# Generic Makefile for STM32F407VGT6 (GCC)
################################################################################################
# 目标名称
TARGET = template
# 构建选项
DEBUG = 1
OPT   = -Og
# 构建目录
BUILD_DIR = build
# 工具链前缀
PREFIX  = arm-none-eabi-
# 工具定义
CC      = $(PREFIX)gcc
CXX     = $(PREFIX)g++
AS      = $(PREFIX)gcc -x assembler-with-cpp
CP      = $(PREFIX)objcopy
SZ      = $(PREFIX)size
HEX     = $(CP) -O ihex
BIN     = $(CP) -O binary -S
GDB     = $(PREFIX)gdb
######################################
# 源文件
######################################
# 使用更精确的文件查找方式，避免包含不需要的文件
C_SOURCES = \
$(wildcard ./CMSIS/*.c) \
$(wildcard ./Library/src/*.c) \
$(wildcard ./Start/*.c) \
$(wildcard ./User/src/*.c)# 汇编源文件
ASM_SOURCES = ./CMSIS/startup_stm32f407xx.s######################################
# 编译选项
######################################
# MCU 选项
CPU        = -mcpu=cortex-m4
FPU        = -mfpu=fpv4-sp-d16 -mfloat-abi=hard
MCU        = $(CPU) -mthumb $(FPU)# C 定义
C_DEFS = \
-DSTM32F40_41xxx \
-DUSE_STDPERIPH_DRIVER \
-DHSE_VALUE=8000000 \
-D__weak="__attribute__((weak))" \
-D__packed="__attribute__((__packed__))"# 包含路径
C_INCLUDES = \
-ICMSIS \
-ILibrary/inc \
-IStart \
-IUser/inc# 汇编标志
ASFLAGS  = $(MCU) $(OPT) -Wall -fdata-sections -ffunction-sections# C 标志
CFLAGS   = $(MCU) $(C_DEFS) $(C_INCLUDES) $(OPT) -Wall -fdata-sections -ffunction-sections# 调试选项
ifeq ($(DEBUG), 1)
CFLAGS  += -g -gdwarf-2
endif# 依赖生成
CFLAGS  += -MMD -MP -MF"$(@:%.o=%.d)"# C++ 标志
CXXFLAGS = $(CFLAGS) -fno-exceptions -fno-rtti -fno-threadsafe-statics -fno-use-cxa-atexit# 链接时优化 (可选)
# LTO_FLAGS = -flto
######################################
# 链接选项
######################################
LDSCRIPT = STM32F407VGTx_FLASH.ld
LIBS     = -lc -lm -lnosys -lstdc++
LDFLAGS  = $(MCU) -specs=nano.specs -specs=nosys.specs -T$(LDSCRIPT) $(LIBS) \-Wl,-Map=$(BUILD_DIR)/$(TARGET).map,--cref -Wl,--gc-sections \-Wl,--print-memory-usage# 可选: 移除未使用段以减小代码大小
# LDFLAGS += -Wl,--gc-sections
######################################
# 构建目标
######################################
all: $(BUILD_DIR)/$(TARGET).elf $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).bin# 对象文件列表
OBJECTS = $(addprefix $(BUILD_DIR)/,$(notdir $(C_SOURCES:.c=.o)))
vpath %.c $(sort $(dir $(C_SOURCES)))
OBJECTS += $(addprefix $(BUILD_DIR)/,$(notdir $(ASM_SOURCES:.s=.o)))
vpath %.s $(sort $(dir $(ASM_SOURCES)))# C 编译规则
$(BUILD_DIR)/%.o: %.c Makefile | $(BUILD_DIR)@echo "Compiling $<"@$(CC) -c $(CFLAGS) -Wa,-a,-ad,-alms=$(BUILD_DIR)/$(notdir $(<:.c=.lst)) $< -o $@# 汇编编译规则
$(BUILD_DIR)/%.o: %.s Makefile | $(BUILD_DIR)@echo "Assembling $<"@$(AS) -c $(CFLAGS) $< -o $@# 链接规则
$(BUILD_DIR)/$(TARGET).elf: $(OBJECTS) Makefile@echo "Linking $@"@$(CC) $(OBJECTS) $(LDFLAGS) -o $@@echo "=== Build completed ==="@$(SZ) $@@echo "Memory usage:"@arm-none-eabi-size --format=sysv $@# 生成 HEX 文件
$(BUILD_DIR)/%.hex: $(BUILD_DIR)/%.elf | $(BUILD_DIR)@$(HEX) $< $@# 生成 BIN 文件
$(BUILD_DIR)/%.bin: $(BUILD_DIR)/%.elf | $(BUILD_DIR)@$(BIN) $< $@# 创建构建目录
$(BUILD_DIR):@mkdir -p $@######################################
# 清理规则
######################################
ifeq ($(OS),Windows_NT)RM = rmdir /S /Q
elseRM = rm -rf
endifclean:-$(RM) $(BUILD_DIR)######################################
# 烧录和调试
######################################
# OpenOCD 烧录
OPENOCD = openocd
OPENOCD_SCRIPT_DIR = D:/SoftWare/Environment/openocd/scripts
OPENOCD_INTERFACE = stlink-v2.cfg
OPENOCD_TARGET = stm32f4x.cfgdownload:$(OPENOCD) -f $(OPENOCD_SCRIPT_DIR)/interface/$(OPENOCD_INTERFACE) \-f $(OPENOCD_SCRIPT_DIR)/target/$(OPENOCD_TARGET) \-c init -c halt \-c "program $(BUILD_DIR)/$(TARGET).elf verify reset exit"# J-Link 烧录
JLINK = "C:/Program Files/SEGGER/JLink_V856a/JLink.exe"
JLINK_DEVICE = STM32F407VG
JLINK_IF = SWD
JLINK_SPEED = 4000jlink:@echo "Generating J-Link script..."@echo "r" > temp_script.jlink@echo "h" >> temp_script.jlink@echo "loadfile $(BUILD_DIR)/$(TARGET).hex" >> temp_script.jlink@echo "r" >> temp_script.jlink@echo "q" >> temp_script.jlink@echo "Flashing with J-Link..."@$(JLINK) -device $(JLINK_DEVICE) -if $(JLINK_IF) -speed $(JLINK_SPEED) -CommanderScript temp_script.jlink@rm -f temp_script.jlink@echo "=== Flash completed ==="# 调试
debug:@echo "r" > temp_debug.jlink@echo "h" >> temp_debug.jlink@echo "loadfile $(BUILD_DIR)/$(TARGET).elf" >> temp_debug.jlink@echo "r" >> temp_debug.jlink@echo "g" >> temp_debug.jlink@$(JLINK) -device $(JLINK_DEVICE) -if $(JLINK_IF) -speed $(JLINK_SPEED) -CommanderScript temp_debug.jlink@rm -f temp_debug.jlink# GDB 调试 (可选)
gdb:$(GDB) $(BUILD_DIR)/$(TARGET).elf -ex "target extended-remote :3333"
# 依赖包含
-include $(wildcard $(BUILD_DIR)/*.d)# 显示帮助信息
help:@echo "=== Makefile 帮助 ==="@echo "make all       - 构建所有目标 (默认)"@echo "make clean     - 清理构建文件"@echo "make download  - 使用 OpenOCD 烧录"@echo "make jlink     - 使用 J-Link 烧录"@echo "make debug     - 使用 J-Link 调试"@echo "make gdb       - 启动 GDB 调试"@echo "make help      - 显示此帮助信息".PHONY: all clean download jlink debug gdb help

2.5.2.配置STM32F407VGTx_FLASH.ld(此文件自己编写或者AI生成)

这里我提供一份写好的链接文件:

/** STM32F407VGT6 链接脚本* 硬件配置: 1024KB FLASH, 128KB SRAM, 64KB CCMRAM* 支持标准库、CCMRAM使用、调试信息*/
/* 入口点定义 */
ENTRY(Reset_Handler)
/* 栈顶地址定义 */
_estack = ORIGIN(RAM) + LENGTH(RAM);
/* 堆和栈大小配置 */
_Min_Heap_Size  = 0x800;   /* 2KB堆 */
_Min_Stack_Size = 0x1000;  /* 4KB栈 */
/* 内存布局定义 */
MEMORY
{FLASH  (rx)  : ORIGIN = 0x08000000, LENGTH = 1024K  /* 主FLASH - STM32F407VGT6有1024KB */RAM    (xrw) : ORIGIN = 0x20000000, LENGTH = 128K   /* 主SRAM - STM32F407VGT6有128KB */CCMRAM (xrw) : ORIGIN = 0x10000000, LENGTH = 64K    /* CCMRAM - STM32F407VGT6有64KB */
}
/* 段配置 */
SECTIONS
{/* 1. 中断向量表 - 必须放在FLASH起始位置 */.isr_vector :{. = ALIGN(4);KEEP(*(.isr_vector))                 /* 中断向量表必须保留 */. = ALIGN(4);} > FLASH/* 2. 代码段和只读数据 */.text :{. = ALIGN(4);*(.text)                             /* 程序代码 */*(.text*)                            /* 所有.text子段 */*(.rodata)                           /* 只读数据 */*(.rodata*)                          /* 所有.rodata子段 */*(.glue_7)                           /* ARM与Thumb指令交互 */*(.glue_7t)                          /* ARM与Thumb指令交互 */*(.gnu.linkonce.t*)/* 函数构造与析构 */KEEP(*(.init))KEEP(*(.fini)). = ALIGN(4);_etext = .;                          /* 代码段结束标记 */} > FLASH/* 3. ARM异常处理段 */.ARM.extab :{*(.ARM.extab* .gnu.linkonce.armextab.*)} > FLASH.ARM :{__exidx_start = .;*(.ARM.exidx*)__exidx_end = .;} > FLASH/* 4. 初始化数组 */.preinit_array :{PROVIDE_HIDDEN(__preinit_array_start = .);KEEP(*(.preinit_array*))PROVIDE_HIDDEN(__preinit_array_end = .);} > FLASH.init_array :{PROVIDE_HIDDEN(__init_array_start = .);KEEP(*(SORT(.init_array.*)))KEEP(*(.init_array*))PROVIDE_HIDDEN(__init_array_end = .);} > FLASH/* 5. 反初始化数组 */.fini_array :{PROVIDE_HIDDEN(__fini_array_start = .);KEEP(*(SORT(.fini_array.*)))KEEP(*(.fini_array*))PROVIDE_HIDDEN(__fini_array_end = .);} > FLASH/* 6. 已初始化数据段 (RAM中，从FLASH加载) *//* 使用与启动文件匹配的符号名称 */_sidata = LOADADDR(.data);.data :{. = ALIGN(4);_sdata = .;                          /* 数据段起始地址 - 与启动文件匹配 */*(.data)                             /* 数据段 */*(.data*)                            /* 所有.data子段 */*(.gnu.linkonce.d*). = ALIGN(4);_edata = .;                          /* 数据段结束地址 - 与启动文件匹配 */} > RAM AT > FLASH/* 7. CCMRAM已初始化数据 (高速RAM) */_siccmram = LOADADDR(.ccmdata);.ccmdata :{. = ALIGN(4);_sccmdata = .;                       /* CCM数据起始 */*(.ccmdata)*(.ccmdata*). = ALIGN(4);_eccmdata = .;                       /* CCM数据结束 */} > CCMRAM AT > FLASH/* 8. 未初始化数据段 (BSS) - 使用与启动文件匹配的符号名称 */.bss :{. = ALIGN(4);__bss_start__ = .;                   /* BSS起始 */_sbss = .;                           /* 与启动文件匹配 */*(.bss)*(.bss*)*(COMMON)                            /* 公共未初始化数据 */. = ALIGN(4);_ebss = .;                           /* 与启动文件匹配 */__bss_end__ = .;                     /* BSS结束 */} > RAM/* 9. CCMRAM未初始化数据 */.ccmbss (NOLOAD) :{. = ALIGN(4);_sccmbss = .;                        /* CCM BSS起始 */*(.ccmbss)*(.ccmbss*). = ALIGN(4);_eccmbss = .;                        /* CCM BSS结束 */} > CCMRAM/* 10. 堆和栈 */._user_heap_stack (NOLOAD) :{. = ALIGN(8);PROVIDE(end = .);PROVIDE(_end = .);. = . + _Min_Heap_Size;              /* 堆区域 */. = . + _Min_Stack_Size;             /* 栈区域 */. = ALIGN(8);} > RAM/* 11. 特殊段定义 */.ARM.attributes 0 : { *(.ARM.attributes) }  /* 架构属性 */.debug_info     0 : { *(.debug_info) }      /* 调试信息 */.debug_line     0 : { *(.debug_line) }      /* 调试行号 */.debug_frame    0 : { *(.debug_frame) }     /* 调试帧信息 *//* 12. 丢弃不需要的段 *//DISCARD/ :{libc.a ( * )libm.a ( * )libgcc.a ( * )}
}
/* 提供给启动文件的堆/栈符号 */
PROVIDE(__heap_size = _Min_Heap_Size);
PROVIDE(__stack_size = _Min_Stack_Size);
PROVIDE(__heap_base = _ebss);
PROVIDE(__heap_limit = _ebss + _Min_Heap_Size);

2.5.3.删除部分可有可无的内容(集中在main.c与main.h文件)

1、删除main.h与main.c的部分代码

感觉有点麻烦，可以直接全部删除，区别只是想不想保留TimingDelay_Decrement函数
这里提供一下保留的mian.c代码,可以直接使用

#include "main.h"
#include <stm32f4xx_rcc.h>
#include <stm32f4xx_gpio.h>static __IO uint32_t uwTimingDelay;
RCC_ClocksTypeDef RCC_Clocks;
static void Delay(__IO uint32_t nTime);
int main(void)
{GPIO_InitTypeDef GPIO_InitStructure;RCC_GetClocksFreq(&RCC_Clocks);SysTick_Config(RCC_Clocks.HCLK_Frequency / 100);Delay(5);RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;  GPIO_Init(GPIOA, &GPIO_InitStructure);/* Infinite loop */while (1){GPIO_ToggleBits(GPIOA,GPIO_Pin_0);//此处延时1秒Delay(100);}
}void Delay(__IO uint32_t nTime)
{uwTimingDelay = nTime;while(uwTimingDelay != 0);
}void TimingDelay_Decrement(void)
{if (uwTimingDelay != 0x00){uwTimingDelay--;}
}

值得一提的是,如果全部删除main.c与main.h的内容，需要在stm32f4xx_it.c
注释函数TimingDelay_Decrement();
否则会报错哦！

2、官方文件system_stm32f4xx.c的一个很奇怪的while，我们只需要删除掉一个分号

3、在stm32f4xx.h中注释掉如下宏

如果不注释会出现解决40多个警告！

2.5.4、配置系统正确时钟

正确的把时钟配置，需要修改两个地方，并且要明确知道你的板子的外部高速晶振的频率，这里我的板子晶振频率是8MHz。

1、在文件stm32f4xx.h中修改HSE_VALUE的值

2、在文件system_stm32f4xx.c中修改PLL_M的值

3、简述为何需要如此设置

STM32 通常被认为是 有 4 个独立时钟源：

• HSI（高速内部时钟）：内部 RC 振荡器，8 MHz，精度较低，无需外部元件。
• HSE（高速外部时钟）：可接外部晶振或时钟源，频率范围 4 MHz~16 MHz。
• LSI（低速内部时钟）：内部 RC 振荡器，约 40 kHz，用于独立看门狗或 RTC。
• LSE（低速外部时钟）：外部 32.768 kHz 晶振，主要用于 RTC

---

众所周知，STM32F407VGT6能支持的最大时钟是168MHz，但是这4个独立时钟源却没有一个频率能达到168MHz，那么这个168MHz的频率是哪里来的呢？
这部分的知识涉及到stm32里面的时钟的一个最为特殊的时钟源----倍频锁相环时钟(PLLCLK)。它常常被系统选择为时钟源，它可以做到将低频输入时钟通过锁相环(PLL)倍频，输出高频稳定时钟，供系统、外设或CPU使用。
这里的知识可以去stm32f4xx参考手册中的时钟树学习，这里文章篇幅问题就不深入探索，如果感兴趣，我会专门出文章讲解。你只要知道，经过上面的配置之后，你的MCU就达到168MHz的频率运行。这里贴出时钟树的图片：

3、开始配置Keil5工程

配置Keil5工程总共分为两个大类，创建工程目录与Keil5软件里面的配置，我们在进行的时候，务必要先去KEIL官方下载，对应的芯片包，否则在创建工程时无法选择芯片型号。

去官网，下载安装运行即可Arm Keil | Keil STM32F4xx_DFP

3.1、工程目录配置

我们先创建5个文件吧,精简工程

结构如下:

这里讲述一下各个文件的作用,然后我们开始迁移文件吧！

文件夹	作用
CMSIS	放置核心的文件与汇编文件
Library	放置外设的头文件与源文件
Start	放置启动的文件
User	放置用户编写文件
ThirdPart	放置第三方库,比如:FreeRtos、LVGL(这个可以先空着)

3.1.1、配置CMSIS文件夹核心文件与汇编文件

1、来到标准库

路径：
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Include
全部复制到，我们的CMSIS文件夹中

在标准库中的路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Device\ST\STM32F4xx\Source\Templates\arm
我们把此文件夹下的startup_stm32f40_41xxx.s文件复制到CMSIS文件夹中

2、配置CMSIS文件夹核心文件与汇编文件完成图

3.1.2、配置Library文件夹标准外设库文件

1、来到标准库

在标准库路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\STM32F4xx_StdPeriph_Driver
我们把此路径下的inc与src文件夹直接复制到我们的Library文件夹中

2、配置Library文件夹标准外设库文件完成图

3.1.3、配置Start文件夹启动文件

1、来到标准库

在标准库路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Device\ST\STM32F4xx\Include
我们复制此路径下的stm32f4xx.h与system_stm32f4xx.h文件到Start文件夹下

在标准库路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Libraries\CMSIS\Device\ST\STM32F4xx\Source\Templates
我们复制此路径下的system_stm32f4xx.c文件到Start文件夹下

2、配置Start文件夹启动文件完成图

3.1.4、配置User文件夹用户文件

1、来到标准库

在标准库路径:
.\STM32F4xx_DSP_StdPeriph_Lib_V1.9.0\Project\STM32F4xx_StdPeriph_Templates
复制main.c、main.h、stm32f4xx_it.c、stm32f4xx_it.h、stm32f4xx_conf.h到我们的User文件夹下，把头文件放置到inc中，源文件放置到src中

2、配置User文件夹用户文件完成图

以上工程文件配置完成！

3.2、Keil5工程配置

我们在来到Keil5之前，给我们的工程创建一个文件夹Link保存中间文件，防止工程变成混乱！等下直接Keil5的工程文件放置到Link文件夹中。

3.2.1、开始创建工程

创建工程

选择创建到Link文件夹中

选择好自己的芯片

3.2.2、开始配置工程源文件路径

创建与工程目录匹配的工程结构

开始加入源文件与汇编文件

配置完成

3.2.3、开始配置工程头文件路径与宏配置

配置魔术棒

来到C/C++加入宏

STM32F40_41xxx,USE_STDPERIPH_DRIVER

增加头文件路径

对了记得正确配置好STlink下载哦！

以上魔法棒全部配置完成！

3.2.4、解决报警告问题

1、在stm32f4xx.h中注释掉如下宏

2、官方文件system_stm32f4xx.c的一个很奇怪的while，我们只需要删除掉一个分号

报警告已解决！

3.2.5、删除部分可有可无的内容(集中在main.c与main.h文件)

1、删除main.h与main.c的部分代码

感觉有点麻烦，可以直接全部删除，区别只是想不想保留TimingDelay_Decrement函数
这里提供一下保留的mian.c代码,可以直接使用

#include "main.h"
#include <stm32f4xx_rcc.h>
#include <stm32f4xx_gpio.h>static __IO uint32_t uwTimingDelay;
RCC_ClocksTypeDef RCC_Clocks;
static void Delay(__IO uint32_t nTime);
int main(void)
{GPIO_InitTypeDef GPIO_InitStructure;RCC_GetClocksFreq(&RCC_Clocks);SysTick_Config(RCC_Clocks.HCLK_Frequency / 100);Delay(5);RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;  GPIO_Init(GPIOA, &GPIO_InitStructure);/* Infinite loop */while (1){GPIO_ToggleBits(GPIOA,GPIO_Pin_0);//此处延时1秒Delay(100);}
}void Delay(__IO uint32_t nTime)
{uwTimingDelay = nTime;while(uwTimingDelay != 0);
}void TimingDelay_Decrement(void)
{if (uwTimingDelay != 0x00){uwTimingDelay--;}
}

值得一提的是,如果全部删除main.c与main.h的内容，需要在stm32f4xx_it.c
注释函数TimingDelay_Decrement();
否则会报错哦！

3.2.6、配置系统正确时钟

正确的把时钟配置，需要修改两个地方，并且要明确知道你的板子的外部高速晶振的频率，这里我的板子晶振频率是8MHz。

1、在文件stm32f4xx.h中修改HSE_VALUE的值

2、在文件system_stm32f4xx.c中修改PLL_M的值

3、简述为何需要如此设置

STM32 通常被认为是 有 4 个独立时钟源：

• HSI（高速内部时钟）：内部 RC 振荡器，8 MHz，精度较低，无需外部元件。
• HSE（高速外部时钟）：可接外部晶振或时钟源，频率范围 4 MHz~16 MHz。
• LSI（低速内部时钟）：内部 RC 振荡器，约 40 kHz，用于独立看门狗或 RTC。
• LSE（低速外部时钟）：外部 32.768 kHz 晶振，主要用于 RTC

---

众所周知，STM32F407VGT6能支持的最大时钟是168MHz，但是这4个独立时钟源却没有一个频率能达到168MHz，那么这个168MHz的频率是哪里来的呢？
这部分的知识涉及到stm32里面的时钟的一个最为特殊的时钟源----倍频锁相环时钟(PLLCLK)。它常常被系统选择为时钟源，它可以做到将低频输入时钟通过锁相环(PLL)倍频，输出高频稳定时钟，供系统、外设或CPU使用。
这里的知识可以去stm32f4xx参考手册中的时钟树学习，这里文章篇幅问题就不深入探索，如果感兴趣，我会专门出文章讲解。你只要知道，经过上面的配置之后，你的MCU就达到168MHz的频率运行。这里贴出时钟树的图片：

以上全部完成！

三、后记

如果完全按照本文完成工程配置，你可以获得一个完全脱离Keil与VSCode第三方插件的STM32VGT6工程，与一个常规的Keil5工程模板。
本文初衷也是希望能够让更多人了解STM32工程的配置过程与提供其它思路。当然本文也有很多的纰漏，比如没有说明arm-none-aebi-gcc、make、openocd等何处下载与配置，这些都是基于篇幅做的取舍，可以看我往期的文章，里面其实有介绍。
https://blog.csdn.net/weixin_65437579/article/details/145797256
https://blog.csdn.net/weixin_65437579/article/details/146296055
那么这个工程有用吗？我的回答是有用！
这是main.c文件
PA0为LED
PA1为按键

#include "main.h"
#include <stm32f4xx_rcc.h>
#include <stm32f4xx_gpio.h>
#include "stm32f4xx_exti.h"
#include "misc.h"
#include <stm32f4xx_syscfg.h>
void EXTI1_IRQHandler(void)
{if (EXTI_GetITStatus(EXTI_Line1) != RESET){GPIO_ToggleBits(GPIOA, GPIO_Pin_0);EXTI_ClearITPendingBit(EXTI_Line1); // 清中断标志}
}
static void GPIO_EXTI_Config(void)
{GPIO_InitTypeDef gpio;EXTI_InitTypeDef exti;NVIC_InitTypeDef nvic;/* 1. 使能时钟 */RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE);/* 2. 配置 PA1 为上拉输入 */gpio.GPIO_Pin = GPIO_Pin_1;gpio.GPIO_Mode = GPIO_Mode_IN;gpio.GPIO_PuPd = GPIO_PuPd_UP;GPIO_Init(GPIOA, &gpio);/* 3. 将 PA1 映射到 EXTI1 */SYSCFG_EXTILineConfig(EXTI_PortSourceGPIOA, EXTI_PinSource1);/* 4. EXTI1 下降沿触发 */exti.EXTI_Line = EXTI_Line1;exti.EXTI_Mode = EXTI_Mode_Interrupt;exti.EXTI_Trigger = EXTI_Trigger_Falling;exti.EXTI_LineCmd = ENABLE;EXTI_Init(&exti);/* 5. NVIC 配置 */nvic.NVIC_IRQChannel = EXTI1_IRQn;nvic.NVIC_IRQChannelPreemptionPriority = 0x0F;nvic.NVIC_IRQChannelSubPriority = 0x0F;nvic.NVIC_IRQChannelCmd = ENABLE;NVIC_Init(&nvic);
}
static __IO uint32_t uwTimingDelay;
RCC_ClocksTypeDef RCC_Clocks;
static void Delay(__IO uint32_t nTime);int main(void)
{GPIO_InitTypeDef GPIO_InitStructure;RCC_GetClocksFreq(&RCC_Clocks);SysTick_Config(RCC_Clocks.HCLK_Frequency / 100);Delay(5);RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE);GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;  GPIO_Init(GPIOA, &GPIO_InitStructure);GPIO_EXTI_Config();while (1){Delay(100);}
}void Delay(__IO uint32_t nTime)
{uwTimingDelay = nTime;while(uwTimingDelay != 0);
}void TimingDelay_Decrement(void)
{if (uwTimingDelay != 0x00){uwTimingDelay--;}
}

实物图:
随便找的板子，无广！

达到程序预期效果！