STM32 固件庫詳解與 MDK 工程模板建立完整指南

前言

要熟練掌握 STM32 開發，首先需要深入理解其固件庫的架構與運作機制。本文將詳細介紹 STM32 標準外設庫的目錄結構、核心文件功能，並手把手教你在 Keil MDK 中從零建立一個標準的工程模板，為後續開發打下堅實基礎。

一、STM32 固件庫深度解析

1. 庫文件整體架構

從 ST 官網下載的固件庫解壓後，核心文件集中在 Libraries 目錄下。展開該目錄可見三大核心模組：

• CMSIS：Cortex-M 微控制器軟體介面標準，提供核心層支援，包含 core_cm3.c/h（核心存取函數）及 stm32f10x.h、system_stm32f10x.h（裝置周邊存取層）。
• STM32F10x_StdPeriph_Driver：標準外設驅動庫，inc 目錄存放頭文件，src 目錄存放各外設驅動源文件（GPIO、USART、SPI 等）。
• Startup：針對不同編譯器（ARM/MDK、GCC、IAR）及不同 Flash 容量晶片提供的啟動檔（如 startup_stm32f10x_hd.s）。

2. 核心文件功能詳解

stm32f10x.h - 裝置頭文件

定義了所有外設寄存器結構體、位元定義及記憶體映射。關鍵點：使用標準外設庫時，必須在編譯器 Preprocessor Symbols (Define) 中添加兩個宏定義：

STM32F10X_HD      // 根據晶片型號選擇：LD/MD/HD/XL/CL/VL
USE_STDPERIPH_DRIVER // 啟用標準外設驅動庫

否則編譯器會報錯 #error "Please select first the target STM32F10x device..."。

system_stm32f10x.c - 系統時鐘配置

遵循 CMSIS 標準，負責系統初始化，包含 PLL 鎖相環配置、總線時鐘（AHB/APB1/APB2）分頻設定。該文件包含 stm32f10x.h 以操作寄存器。

啟動文件選擇指南

根據晶片 Flash 容量選擇對應啟動檔：

3. 庫體系結構關係圖

從 stm32f10x.h 入手，可清晰看到：用戶代碼 → stm32f10x_conf.h（外設開關） → 標準外設驅動庫 → CMSIS 核心層/裝置層 → 硬體。掌握這條鏈路是建立模板的關鍵。

二、MDK 工程模板手把手建立

步驟 1：建立目錄結構

在工作區新建 Template 資料夾，其下建立四個子目錄：

• OBJ：存放編譯中間文件
• Project：存放工程文件
• CORE：存放核心文件（main.c, stm32f10x_it.c, system_stm32f10x.c, 啟動檔）
• FWLIB：存放固件庫文件（CMSIS + StdPeriph_Driver）

步驟 2：複製庫文件

將固件庫對應文件複製至上述目錄：

• FWLIB：複製 Libraries\CMSIS 和 Libraries\STM32F10x_StdPeriph_Driver 整個目錄。
• CORE：複製 system_stm32f10x.c、啟動檔（根據晶片選擇）、自建 main.c、stm32f10x_it.c、stm32f10x_conf.h。

步驟 3：創建工程與分組

1. 打開 Keil MDK，新建工程保存至 Project 目錄。
2. 選擇晶片型號（如 STM32F103ZE）。
3. 右鍵 Target 1 → Manage Components，建立三個 Group：Project、CORE、FWLIB。
4. 分別添加文件：
   • Project：main.c
   • CORE：system_stm32f10x.c, stm32f10x_it.c, 啟動檔
   • FWLIB：stm32f10x_*.c（根據需要添加的外設驅動源文件）

步驟 4：配置 Target Options

1. Output 標籤：勾選 "Create Executable"，在 "Select Folder for Objects" 選擇 OBJ 目錄。
   
2. C/C++ 標籤：在 Define 輸入 STM32F10X_HD,USE_STDPERIPH_DRIVER。
   
3. Include Paths：添加三個核心路徑（必須精確到最後一級子目錄）：
   ./FWLIB/CMSIS/CM3/CoreSupport
./FWLIB/CMSIS/CM3/DeviceSupport/ST/STM32F10x
./FWLIB/STM32F10x_StdPeriph_Driver/inc
   

步驟 5：編譯驗證

點擊 Rebuild，若輸出 "0 Error(s), 0 Warning(s)" 且生成 .hex 文件，恭喜你，標準工程模板建立成功！

總結

理解固件庫架構是高效開發的前提，標準化工程模板能避免重複配置錯誤。建議將此模板備份，未來新專案直接複製修改即可，專注於業務邏輯實現。