KEIL5开发STM32F103：环境配置与工程实践-代码聚汇网

KEIL5开发STM32F103：环境配置与工程实践

小圆圆伍·2026-08-08·阅读 24 GEO检测（免费）

KEIL5STM32F103嵌入式开发

|难度：普通|阅读约 17 分钟

1. 为什么选择KEIL5开发STM32F103

在嵌入式开发领域，KEIL MDK（Microcontroller Development Kit）一直是ARM架构单片机开发的主流工具链之一。对于STM32F103这款经典的Cortex-M3内核微控制器来说，KEIL5提供了完整的开发环境支持。我最初选择KEIL5主要基于以下几个实际考量：

首先，KEIL5对STM32全系列芯片的支持非常完善。通过安装对应的Device Family Pack（DFP），可以自动获取芯片的所有外设寄存器定义、启动文件和底层驱动代码。这对于刚接触STM32的开发者来说，省去了大量手动配置寄存器的时间成本。

其次，KEIL5的工程管理界面直观友好。相比其他嵌入式IDE，它的项目管理器（Project）窗口清晰地展示了源文件、头文件和库文件的组织结构。特别是在处理STM32的标准外设库（Standard Peripheral Library）或HAL库时，这种可视化结构能有效避免头文件包含错误。

提示：虽然STM32CubeIDE等基于Eclipse的免费工具也越来越流行，但KEIL5在编译速度、代码补全和调试体验上仍有明显优势，特别适合中小型项目开发。

从实际项目经验来看，KEIL5的编译器优化效果显著。在STM32F103这类资源有限的设备上（通常只有64KB或128KB Flash），经过KEIL的AC5或AC6编译器优化后，代码体积平均能缩减15%-20%。这对于需要实现复杂功能的项目至关重要。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 开发环境准备与配置

2.1 KEIL5安装要点

安装KEIL MDK时，有几个关键步骤需要注意。首先从官网下载最新安装包（当前版本为v5.38），安装过程中务必勾选"ARM Compiler"和"Device Family Pack"组件。安装完成后，需要额外安装STM32F1系列的DFP包：

打开Pack Installer（菜单栏Packs → Pack Installer）
搜索"STM32F1"并安装Keil::STM32F1xx_DFP最新版本
同时建议安装ARM::CMSIS（Cortex Microcontroller Software Interface Standard）核心组件

注意：如果遇到Windows 7系统下Pack Installer无法联网的问题，可以手动下载.pack文件后通过"Import"按钮本地安装。

2.2 硬件连接准备

对于STM32F103开发板，通常有以下几种调试下载方式：

ST-Link V2（推荐）：成本低且支持SWD接口
J-Link：性能更强但价格较高
USB转TTL：仅适用于串口下载（需配置Boot引脚）

我建议优先使用ST-Link，因为它不仅支持程序下载，还能提供完整的调试功能。连接时需要注意：

SWD接口只需连接SWDIO（PA13）、SWCLK（PA14）、GND和3.3V四根线
开发板的BOOT0引脚需接地（正常启动模式）
检查开发板供电是否稳定（可通过板载LED判断）

3. 新建STM32F103工程步骤详解

3.1 创建基础工程框架

打开KEIL5后，按照以下步骤创建新工程：

Project → New μVision Project
选择保存路径并命名工程（如"STM32F103_Test"）
在Device选择窗口搜索"STM32F103"，根据具体型号选择（常用STM32F103C8T6）
弹出运行时环境管理窗口（Manage Run-Time Environment）

在RTE配置界面，关键配置包括：

CMSIS → CORE（必选）
Device → Startup（选择带时钟配置的版本）
Device → STM32Cube Framework → Classic（如果使用标准外设库）

3.2 添加必要源文件

工程创建后，需要手动添加以下关键文件：

启动文件：startup_stm32f103xb.s（位于ARM\Startup目录）
链接脚本：STM32F103XB_FLASH.ld（定义内存布局）
系统初始化文件：system_stm32f1xx.c
标准外设库文件（如使用）：
- stm32f1xx.h
- stm32f1xx_gpio.c
- stm32f1xx_rcc.c

建议的工程目录结构：

code复制Project/
├── CMSIS/
├── Drivers/
│   ├── STM32F1xx_HAL_Driver/
│   └── CMSIS/
├── Inc/
├── Src/
└── MDK-ARM/ (自动生成)

3.3 关键工程配置

右击工程名选择"Options for Target"，有几个关键配置项：

Target选项卡：
- 晶振频率设为8.0MHz（大部分STM32F103开发板默认值）
- 勾选"Use MicroLIB"（精简版C库，节省空间）
Output选项卡：
- 勾选"Create HEX File"（用于生产烧录）
- 设置输出文件夹路径
C/C++选项卡：
- Define中添加USE_STDPERIPH_DRIVER,STM32F10X_MD
- Include Paths添加所有头文件路径
- Optimization等级建议先设为-O0（调试阶段）
Debug选项卡：
- 选择对应调试器（如ST-Link Debugger）
- 勾选"Reset and Run"（下载后自动运行）

4. 编写第一个测试程序

4.1 主程序框架

在main.c中构建基本框架：

c复制#include "stm32f1xx.h"

void SystemClock_Config(void);
void GPIO_Init(void);

int main(void) {
    HAL_Init();
    SystemClock_Config();
    GPIO_Init();
    
    while(1) {
        // 主循环
    }
}

void SystemClock_Config(void) {
    RCC_OscInitTypeDef osc = {0};
    RCC_ClkInitTypeDef clk = {0};
    
    osc.OscillatorType = RCC_OSCILLATORTYPE_HSE;
    osc.HSEState = RCC_HSE_ON;
    osc.PLL.PLLState = RCC_PLL_ON;
    osc.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    osc.PLL.PLLMUL = RCC_PLL_MUL9;
    HAL_RCC_OscConfig(&osc);
    
    clk.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
                  |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
    clk.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
    clk.AHBCLKDivider = RCC_SYSCLK_DIV1;
    clk.APB1CLKDivider = RCC_HCLK_DIV2;
    clk.APB2CLKDivider = RCC_HCLK_DIV1;
    HAL_RCC_ClockConfig(&clk);
}

void GPIO_Init(void) {
    __HAL_RCC_GPIOA_CLK_ENABLE();
    GPIO_InitTypeDef gpio = {0};
    gpio.Pin = GPIO_PIN_5; // 通常板载LED连接PA5
    gpio.Mode = GPIO_MODE_OUTPUT_PP;
    gpio.Pull = GPIO_NOPULL;
    gpio.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOA, &gpio);
}

4.2 实现LED闪烁

在while(1)循环中添加以下代码实现LED闪烁：

c复制while(1) {
    HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
    HAL_Delay(500); // 500ms延时
}

4.3 编译与下载

点击工具栏"Build"按钮（或F7）编译工程。首次编译可能会遇到以下常见问题：

找不到头文件：检查Include Paths是否包含所有必要路径
未定义符号：确认是否正确定义了USE_STDPERIPH_DRIVER
链接错误：检查启动文件和链接脚本是否匹配芯片型号

编译通过后，点击"Load"按钮（或F8）下载程序到开发板。如果下载失败：

检查调试器连接是否正常
确认芯片供电稳定
尝试复位开发板后重新下载

5. 工程优化与高级配置

5.1 使用硬件抽象层（HAL）

虽然标准外设库（SPL）仍被广泛使用，但ST官方推荐使用更新的HAL库。在RTE配置中勾选：

Device → STM32Cube Framework → HAL
根据需要选择具体外设驱动（如GPIO、USART等）

HAL库的主要优势：

统一的外设操作接口
更好的跨系列兼容性
内置超时处理和错误检测机制

5.2 添加第三方组件

对于复杂项目，常需要集成以下组件：

FreeRTOS：在RTE中勾选RTOS组件
LVGL图形库：手动添加源文件并配置显示驱动
FatFS文件系统：通过RTE添加并实现底层磁盘接口

以添加FreeRTOS为例：

在RTE中勾选"RTOS → FreeRTOS → Core"
配置FreeRTOSConfig.h文件（堆大小、任务优先级等）
创建任务示例：

c复制void vTask1(void *pvParams) {
    while(1) {
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
        vTaskDelay(pdMS_TO_TICKS(200));
    }
}

int main(void) {
    HAL_Init();
    SystemClock_Config();
    GPIO_Init();
    
    xTaskCreate(vTask1, "LED_Task", 128, NULL, 1, NULL);
    vTaskStartScheduler();
    
    while(1);
}

5.3 调试技巧

KEIL5提供强大的调试功能：

逻辑分析仪（Logic Analyzer）：可视化GPIO状态变化
内存查看器：监控变量和寄存器值
实时表达式（Watch窗口）：跟踪关键变量

实用调试技巧：

使用__breakpoint()函数设置软件断点
在Watch窗口添加(int)&Variable查看变量地址
使用Event Recorder实现低开销的日志输出

6. 常见问题解决方案

6.1 程序无法启动

现象：下载成功但板子无反应
可能原因：

启动模式配置错误（BOOT0需接地）
时钟配置错误（检查晶振是否起振）
堆栈大小不足（修改启动文件中的Stack_Size）

6.2 外设初始化失败

排查步骤：

检查外设时钟是否使能（__HAL_RCC_XXX_CLK_ENABLE()）
确认GPIO复用功能配置正确
查看参考手册确认寄存器配置

6.3 优化等级导致异常

当开启高等级优化（-O2/-O3）时可能出现：

变量被优化掉：使用volatile关键字
时序错误：关键代码段用__attribute__((optimize("O0")))局部禁用优化
函数被内联：使用__attribute__((noinline))

7. 工程迁移与版本控制

7.1 工程目录瘦身

KEIL5工程默认会生成大量中间文件，建议：

在Output和Listing选项卡中指定固定输出目录
创建.gitignore文件排除以下内容：

code复制*.uvoptx
*.uvprojx.user
*.axf
*.build_log.htm
/MDK-ARM/
/Objects/
/Listings/

7.2 跨平台协作

对于团队开发，建议：

使用相对路径而非绝对路径
统一库文件版本
共享RTE配置文件（.uvprojx文件中的<RTE>标签）

7.3 备份关键配置

以下配置建议文档化：

芯片型号和Flash/RAM大小
特殊编译选项
调试器连接参数
第三方库版本信息

我在实际项目中发现，保持工程结构清晰可以大幅减少后期维护成本。一个良好的实践是为每个外设模块创建单独的.c/.h文件对，并通过良好的头文件包含管理避免循环依赖。