1. 從零開始為什么需要一個“標(biāo)準(zhǔn)”的工程模板如果你剛開始接觸STM32或者剛從Arduino、51單片機(jī)轉(zhuǎn)過來第一個攔路虎往往不是寫代碼而是“搭環(huán)境”。面對Keil MDK里空蕩蕩的界面新建一個工程后你會發(fā)現(xiàn)除了一個空白的main.c什么都沒有。編譯一堆“未定義”的錯誤。下載芯片根本不響應(yīng)。這種感覺就像給你一套毛坯房告訴你“可以住了”但水電、門窗、墻面一概沒有。這就是為什么我們需要一個“標(biāo)準(zhǔn)庫工程模板”。它不是一個簡單的“Hello World”示例而是一個預(yù)先配置好的、包含了所有必要“基礎(chǔ)設(shè)施”的完整項(xiàng)目骨架。對于STM32的標(biāo)準(zhǔn)外設(shè)庫Standard Peripheral Library SPL開發(fā)而言這個模板至少包含了芯片型號對應(yīng)的啟動文件、標(biāo)準(zhǔn)外設(shè)庫的所有源文件和頭文件、正確的文件目錄結(jié)構(gòu)、以及一個已經(jīng)設(shè)置好包含路徑、宏定義和編譯選項(xiàng)的Keil工程。有了它你才能專注于業(yè)務(wù)邏輯而不是在無數(shù)個“undefined symbol SystemInit”的報錯中掙扎。網(wǎng)絡(luò)上有很多現(xiàn)成的模板可以下載但我強(qiáng)烈建議你親手從頭搭建一次。這個過程本身就是理解STM32開發(fā)環(huán)境、編譯鏈接流程和工程管理的最佳實(shí)踐。你會明白每一個文件的作用知道每一條編譯選項(xiàng)的意義當(dāng)項(xiàng)目出現(xiàn)詭異問題時你才有能力去排查。今天我就帶你用Keil MDK以ARM-MDK 5為例為STM32F103C8T6這款經(jīng)典的“藍(lán)橋杯”芯片一步步搭建一個純凈、可移植、結(jié)構(gòu)清晰的標(biāo)準(zhǔn)庫工程。2. 戰(zhàn)前準(zhǔn)備理清你的“武器庫”與“彈藥”動手之前確保你的“軍火庫”已經(jīng)齊備。盲目開始只會導(dǎo)致中途卡殼打擊信心。2.1 核心軟件Keil MDK-ARM這是我們的主戰(zhàn)場。你需要安裝Keil MDK-ARMMicrocontroller Development Kit。請注意MDK是Keil公司針對ARM Cortex-M內(nèi)核的付費(fèi)商業(yè)軟件但針對STM32F1等系列有32KB代碼大小的免費(fèi)限制對于學(xué)習(xí)和大多數(shù)項(xiàng)目足夠。務(wù)必從Keil官網(wǎng)或可靠渠道下載安裝。安裝后還需要安裝對應(yīng)芯片的Device Family PackDFP也就是設(shè)備支持包。Keil安裝器通常會引導(dǎo)你在線安裝選擇STMicroelectronics-STM32F1 Series-STM32F103找到你的具體型號如STM32F103C8安裝即可。這個包包含了芯片的啟動文件、片上外設(shè)描述SVD文件等。2.2 核心彈藥STM32標(biāo)準(zhǔn)外設(shè)庫這是我們今天的主角。標(biāo)準(zhǔn)庫是ST官方提供的一套用于操作STM32所有外設(shè)GPIO、USART、ADC等的C語言函數(shù)集合。它封裝了底層寄存器操作讓開發(fā)者可以用更直觀的GPIO_SetBits(GPIOA, GPIO_Pin_0)這樣的函數(shù)來控制IO口而不是直接寫GPIOA-BSRR 0x0001。雖然ST現(xiàn)在主推HAL/LL庫但標(biāo)準(zhǔn)庫因其代碼精簡、執(zhí)行效率高、邏輯直觀在存量項(xiàng)目和許多學(xué)習(xí)者中依然有大量應(yīng)用。你需要去ST官網(wǎng)或通過搜索引擎找到“STM32F10x Standard Peripheral Library”。通常是一個名為stm32f10x_stdperiph_lib.zip的壓縮包版本號可能是V3.5.0或V3.6.1。下載后解壓你會看到一個結(jié)構(gòu)清晰的文件夾里面最重要的就是Libraries庫文件和Project示例工程目錄。2.3 輔助工具串口調(diào)試助手與下載器驅(qū)動工程最終要燒錄到芯片里運(yùn)行。你需要一個下載調(diào)試器最常見的就是ST-LinkV2或V3。確保你的電腦已經(jīng)安裝了ST-Link的USB驅(qū)動通常Keil安裝包會附帶或可從ST官網(wǎng)下載。同時準(zhǔn)備一個串口調(diào)試助手如XCOM、SSCOM、MobaXterm的串口功能等用于后續(xù)測試串口通信。2.4 建立你的工作區(qū)在電腦上找一個合適的位置創(chuàng)建一個總的工作文件夾例如STM32_Project。在里面為今天的工程單獨(dú)建一個文件夾命名為Template_STM32F103_SPL。我們所有的操作都將在這個文件夾內(nèi)進(jìn)行。清晰的目錄管理是專業(yè)開發(fā)的好習(xí)慣。3. 工程骨架搭建創(chuàng)建項(xiàng)目與引入核心文件打開Keil MDK我們正式開始。3.1 創(chuàng)建新工程與選擇設(shè)備點(diǎn)擊菜單欄Project-New uVision Project...。在彈出的對話框中導(dǎo)航到你剛才創(chuàng)建的Template_STM32F103_SPL文件夾。給工程起一個名字比如Template點(diǎn)擊保存。緊接著會彈出Select Device for Target對話框。在這里你需要選擇你使用的具體芯片型號。在左側(cè)廠商列表中選擇STMicroelectronics然后在右側(cè)芯片列表中找到STM32F103C8如果你用的是C8T6。這里的選擇至關(guān)重要它決定了Keil為你鏈接哪個型號的啟動文件以及內(nèi)存映射。選中后點(diǎn)擊OK。隨后會彈出一個詢問是否添加啟動文件到工程的對話框標(biāo)題是Manage Run-Time Environment。這里請直接點(diǎn)擊Cancel或右上角的X關(guān)閉它。這個RTE環(huán)境是Keil為了簡化HAL/CMSIS驅(qū)動管理而設(shè)計的對于標(biāo)準(zhǔn)庫工程我們不需要它手動管理文件更清晰。3.2 建立科學(xué)的目錄結(jié)構(gòu)一個混亂的工程是災(zāi)難的開始。我們在工程根目錄Template_STM32F103_SPL下手動創(chuàng)建以下幾個子文件夾User: 存放用戶編寫的應(yīng)用代碼如main.c,system_stm32f10x.c等。Libraries/CMSIS: 存放ARM Cortex-M內(nèi)核相關(guān)的文件主要是啟動文件和系統(tǒng)初始化文件。Libraries/STM32F10x_StdPeriph_Driver: 存放STM32標(biāo)準(zhǔn)外設(shè)庫的src源文件和inc頭文件。Project: 存放Keil的工程文件.uvprojx等和編譯輸出文件.axf,.hex等。我們可以把上一步創(chuàng)建的.uvprojx文件移動到這里但為了簡單起見我們先保持工程文件在根目錄輸出目錄可以后續(xù)設(shè)置。Doc: 存放相關(guān)文檔、數(shù)據(jù)手冊。Hardware: 存放你為具體硬件模塊如LED、按鍵、OLED編寫的驅(qū)動文件。創(chuàng)建完文件夾后回到Keil的工程界面。在左側(cè)的Project窗口中你會看到一個Target 1。右鍵點(diǎn)擊它選擇Manage Project Items...。在彈出的對話框中我們首先修改Project Targets的名字將Target 1改為更有意義的Template。然后在中間的Groups區(qū)域創(chuàng)建與我們文件夾對應(yīng)的組Group點(diǎn)擊New (Insert)按鈕創(chuàng)建User組。同樣方法創(chuàng)建CMSIS、FWLIB用于存放標(biāo)準(zhǔn)外設(shè)驅(qū)動、STARTUP單獨(dú)管理啟動文件等組。你可以根據(jù)習(xí)慣調(diào)整關(guān)鍵是邏輯清晰。3.3 填充“血肉”添加關(guān)鍵文件到工程現(xiàn)在我們把之前下載的標(biāo)準(zhǔn)外設(shè)庫包里的文件復(fù)制到對應(yīng)文件夾并添加到Keil工程中。啟動文件Startup File 在標(biāo)準(zhǔn)庫包的Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm目錄下有一系列以.s結(jié)尾的匯編啟動文件。根據(jù)你的芯片型號選擇startup_stm32f10x_ld.s: 用于小容量產(chǎn)品Flash ≤ 32KB如F103C8T6。startup_stm32f10x_md.s: 用于中容量產(chǎn)品64KB ≤ Flash ≤ 128KB。startup_stm32f10x_hd.s: 用于大容量產(chǎn)品256KB ≤ Flash ≤ 512KB。 將startup_stm32f10x_ld.s復(fù)制到你的工程Libraries/CMSIS文件夾。然后在Keil的Manage Project Items中選中STARTUP組點(diǎn)擊Add Files找到并添加這個.s文件。CMSIS核心文件 從標(biāo)準(zhǔn)庫包的Libraries\CMSIS\CM3\CoreSupport下復(fù)制core_cm3.c和core_cm3.h到你的Libraries/CMSIS。 從Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下復(fù)制system_stm32f10x.c和system_stm32f10x.h到Libraries/CMSIS。同時把這個目錄下的stm32f10x.h和system_stm32f10x.c也復(fù)制到User文件夾備用因?yàn)閟tm32f10x.h是總頭文件system_stm32f10x.c通常需要用戶根據(jù)時鐘配置修改。 在Keil中將system_stm32f10x.c添加到CMSIS組。標(biāo)準(zhǔn)外設(shè)庫文件 將標(biāo)準(zhǔn)庫包Libraries\STM32F10x_StdPeriph_Driver下的src和inc兩個文件夾整個復(fù)制到你的Libraries/STM32F10x_StdPeriph_Driver目錄下。 在Keil中為FWLIB組添加文件。這里有個技巧我們不需要一次性添加所有外設(shè)的.c文件那樣會拖慢編譯速度。通常只添加你計劃使用的外設(shè)。但為了模板的完整性我們可以先添加幾個最常用的如misc.cNVIC中斷相關(guān)、stm32f10x_gpio.c、stm32f10x_rcc.c時鐘控制必須、stm32f10x_usart.c。后續(xù)需要其他外設(shè)時再添加。在Manage Project Items中選中FWLIB組點(diǎn)擊Add Files導(dǎo)航到src目錄下按住Ctrl鍵多選上述文件加入。用戶文件 在User文件夾下新建一個main.c文件。暫時留空。在Keil中將其添加到User組。 將之前復(fù)制到User文件夾的system_stm32f10x.c也添加到User組。完成文件添加后你的工程Project窗口應(yīng)該呈現(xiàn)一個清晰的結(jié)構(gòu)。點(diǎn)擊OK關(guān)閉管理對話框。4. 工程“神經(jīng)”配置設(shè)置包含路徑與宏定義文件添加了但編譯器還不知道去哪里找頭文件。我們需要設(shè)置包含路徑Include Paths。點(diǎn)擊工具欄的魔術(shù)棒圖標(biāo)Options for Target打開工程配置對話框。4.1 C/C選項(xiàng)卡配置包含路徑Include Paths 點(diǎn)擊C/C選項(xiàng)卡找到Include Paths后面的...按鈕。點(diǎn)擊它添加以下路徑根據(jù)你的實(shí)際目錄調(diào)整../User../Libraries/CMSIS../Libraries/STM32F10x_StdPeriph_Driver/inc添加時可以使用..來代表上一級目錄。確保這三個路徑都被添加進(jìn)去。這告訴編譯器當(dāng)遇到#include “stm32f10x.h”時可以去這些目錄下尋找。預(yù)處理器宏定義Preprocessor Symbols 在Define輸入框中填入以下內(nèi)容用英文逗號分隔STM32F10X_MD, USE_STDPERIPH_DRIVERSTM32F10X_MD這個宏定義了芯片的容量類型。對于STM32F103C8T664KB Flash屬于中容量所以是MD。如果是小容量LD或大容量HD需要相應(yīng)修改。這個宏會影響stm32f10x.h頭文件對內(nèi)部寄存器映射和中斷向量表大小的定義。USE_STDPERIPH_DRIVER這個宏是關(guān)鍵。它告訴編譯器我們要使用標(biāo)準(zhǔn)外設(shè)庫。只有在定義了這個宏之后stm32f10x.h才會去包含stm32f10x_conf.h外設(shè)庫配置文件進(jìn)而包含各個具體的外設(shè)頭文件。4.2 調(diào)試器設(shè)置切換到Debug選項(xiàng)卡。如果你使用ST-Link在右側(cè)下拉菜單中選擇ST-Link Debugger然后點(diǎn)擊旁邊的Settings。在Debug子選項(xiàng)卡確認(rèn)Port是SWSerial Wire即SWD接口。在Flash Download子選項(xiàng)卡點(diǎn)擊Add為你的芯片添加Flash編程算法。對于STM32F103C8選擇STM32F1xx 64KB或128KB根據(jù)實(shí)際的算法。勾選Reset and Run這樣下載程序后會自動復(fù)位運(yùn)行。4.3 輸出文件設(shè)置切換到Output選項(xiàng)卡勾選Create HEX File以便生成可供燒錄的.hex文件。你可以點(diǎn)擊Select Folder for Objects...將輸出目錄指定到我們之前創(chuàng)建的Project/Output文件夾保持工程根目錄整潔。切換到Listing選項(xiàng)卡同樣可以將列表文件輸出目錄指定到Project/Listing。5. 編寫“心臟”代碼從空工程到點(diǎn)亮LED配置完畢我們來寫一個最簡單的測試程序點(diǎn)亮一個LED驗(yàn)證整個工程是否工作。5.1 配置系統(tǒng)時鐘首先我們需要配置系統(tǒng)時鐘。STM32上電后默認(rèn)使用內(nèi)部8MHz的HSI RC振蕩器作為系統(tǒng)時鐘。為了獲得更高的性能72MHz我們通常會切換到外部高速晶振HSE并通過PLL倍頻。打開User文件夾下的system_stm32f10x.c文件。找到SystemInit()函數(shù)。標(biāo)準(zhǔn)庫的這個函數(shù)默認(rèn)只是設(shè)置了向量表位置并開啟了FPU如果支持并沒有配置時鐘。我們需要在main()函數(shù)一開始自己配置。不過更常見的做法是直接修改system_stm32f10x.c文件中的SystemInit()或者在其中調(diào)用一個我們自定義的時鐘配置函數(shù)。為了保持模板的純凈和可移植性我建議在main.c里做時鐘配置。5.2 編寫main.c現(xiàn)在打開main.c輸入以下代碼#include stm32f10x.h // 總頭文件必須包含 #include stm32f10x_gpio.h #include stm32f10x_rcc.h // 簡單的延時函數(shù)通過循環(huán)實(shí)現(xiàn)不精確僅用于測試 void Delay(__IO uint32_t nCount) { for(; nCount ! 0; nCount--); } int main(void) { // 1. 初始化RCC時鐘 // 開啟HSE外部8MHz晶振 RCC_DeInit(); // 復(fù)位RCC寄存器到默認(rèn)值 RCC_HSEConfig(RCC_HSE_ON); // 開啟HSE // 等待HSE就緒 if (RCC_WaitForHSEStartUp() SUCCESS) { // 設(shè)置AHB、APB2、APB1預(yù)分頻因子HCLK SYSCLK, PCLK2 HCLK, PCLK1 HCLK/2 RCC_HCLKConfig(RCC_SYSCLK_Div1); RCC_PCLK2Config(RCC_HCLK_Div1); RCC_PCLK1Config(RCC_HCLK_Div2); // 設(shè)置PLL時鐘源為HSE倍頻系數(shù)為9 - 8MHz * 9 72MHz RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); RCC_PLLCmd(ENABLE); // 使能PLL while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) RESET); // 等待PLL就緒 // 選擇PLL輸出作為系統(tǒng)時鐘 RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); while(RCC_GetSYSCLKSource() ! 0x08); // 等待系統(tǒng)時鐘源切換為PLL } else { // 如果HSE啟動失敗則使用HSI內(nèi)部8MHz // 可以在此處添加錯誤處理如點(diǎn)亮一個錯誤指示燈 } // 2. 開啟GPIOA的時鐘因?yàn)長ED連接在PA1 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // 3. 配置GPIO引腳推挽輸出50MHz GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_1; // 假設(shè)LED在PA1 GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; // 推挽輸出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; // 速度50MHz GPIO_Init(GPIOA, GPIO_InitStructure); // 4. 主循環(huán) while (1) { GPIO_SetBits(GPIOA, GPIO_Pin_1); // PA1置高LED滅假設(shè)低電平點(diǎn)亮 Delay(0xFFFFF); // 延時 GPIO_ResetBits(GPIOA, GPIO_Pin_1); // PA1置低LED亮 Delay(0xFFFFF); } } // 下面是一個空的SystemInit函數(shù)避免鏈接時警告 // 實(shí)際上啟動文件會調(diào)用SystemInit但我們已經(jīng)在main里配置了時鐘 // 所以這里可以留空或者調(diào)用我們自己的時鐘配置函數(shù) void SystemInit(void) { // 用戶可在此處添加自己的系統(tǒng)初始化代碼 // 例如設(shè)置向量表偏移如果用了IAP或Bootloader }5.3 根據(jù)硬件修改代碼上述代碼假設(shè)LED連接在GPIOA的第1號引腳PA1并且是低電平點(diǎn)亮共陽接法或LED陽極接VCC陰極通過限流電阻接GPIO。你需要根據(jù)你的實(shí)際硬件電路進(jìn)行修改如果LED是共陰接法陰極接地陽極通過電阻接GPIO則GPIO_SetBits點(diǎn)亮GPIO_ResetBits熄滅。如果LED接在其他引腳如PC13這是很多最小板上的用戶LED則需要將RCC_APB2Periph_GPIOA改為RCC_APB2Periph_GPIOC所有GPIOA改為GPIOCGPIO_Pin_1改為GPIO_Pin_13。6. 編譯、下載與調(diào)試驗(yàn)證你的勞動成果代碼寫好了最后一步就是把它變成芯片里運(yùn)行的程序。6.1 編譯工程點(diǎn)擊Keil工具欄上的BuildF7按鈕。如果前面所有步驟都正確你會在下方的Build Output窗口看到Build started: Project: Template ... linking... Program Size: Codexxxx RO-dataxxx RW-dataxx ZI-dataxxxx Template\Template.axf - 0 Error(s), 0 Warning(s).0 Error(s)是關(guān)鍵。如果有錯誤請根據(jù)錯誤信息回溯檢查通常是頭文件路徑不對、宏定義缺失、或文件未添加。警告可以暫時忽略但最好理解其含義。6.2 連接硬件與下載用ST-Link連接你的開發(fā)板。確保連接正確SWDIO-PA13(或板子上標(biāo)有SWDIO/DIO的引腳)SWCLK-PA14(或SWCLK/CLK)GND-GND3.3V-3.3V如果板子不自帶供電給開發(fā)板上電。點(diǎn)擊Keil工具欄的LoadF8按鈕。如果一切正常你會看到Build Output窗口顯示Erase Done.、Programming Done.、Verify OK.等信息并且開發(fā)板上的LED開始閃爍。6.3 基礎(chǔ)調(diào)試如果LED沒有閃爍首先檢查硬件連接和供電。然后可以嘗試簡單的調(diào)試單步調(diào)試點(diǎn)擊Debug-Start/Stop Debug SessionCtrlF5進(jìn)入調(diào)試模式。程序會暫停在main函數(shù)開始處。你可以按F10Step Over或F11Step Into單步執(zhí)行觀察寄存器和變量的變化。查看外設(shè)寄存器在調(diào)試模式下點(diǎn)擊菜單View-System Viewer可以找到GPIOA等外設(shè)查看其寄存器的值確認(rèn)引腳配置和輸出電平是否正確。使用printf重定向這是更強(qiáng)大的調(diào)試手段。你需要重寫fputc函數(shù)將printf的輸出重定向到串口。這涉及到初始化USART、配置串口引腳、并實(shí)現(xiàn)fputc。這通常是工程模板的下一個進(jìn)階步驟。7. 模板的優(yōu)化與進(jìn)階思考一個能點(diǎn)燈的工程只是起點(diǎn)。一個好的模板應(yīng)該易于擴(kuò)展和維護(hù)。7.1 創(chuàng)建配置文件stm32f10x_conf.h在User文件夾下從標(biāo)準(zhǔn)庫包的Project\STM32F10x_StdPeriph_Template目錄下復(fù)制stm32f10x_conf.h文件過來。這個文件用于裁剪標(biāo)準(zhǔn)庫。你可以通過注釋或取消注釋里面的#define來決定編譯時包含哪些外設(shè)驅(qū)動。例如如果你只用到了GPIO和USART就可以把其他外設(shè)的#include注釋掉這樣可以顯著減少編譯時間。7.2 管理中斷服務(wù)函數(shù)標(biāo)準(zhǔn)庫為每個外設(shè)的中斷預(yù)留了弱weak定義的中斷服務(wù)函數(shù)IRQHandler在stm32f10x_it.c中。你應(yīng)該在User文件夾下創(chuàng)建自己的stm32f10x_it.c和stm32f10x_it.h文件并在其中實(shí)現(xiàn)你需要的中斷服務(wù)函數(shù)。編譯器會鏈接你寫的強(qiáng)符號函數(shù)而不是庫里的弱符號。7.3 模塊化與硬件抽象將不同硬件模塊的驅(qū)動代碼如led.c、key.c、usart.c放在Hardware文件夾下并創(chuàng)建對應(yīng)的頭文件。在頭文件中聲明初始化函數(shù)和操作函數(shù)在main.c中包含這些頭文件并調(diào)用。這樣main.c會變得非常清晰只負(fù)責(zé)業(yè)務(wù)邏輯的調(diào)度。7.4 關(guān)于HAL庫與標(biāo)準(zhǔn)庫的選擇從熱詞中可以看到“hal庫和標(biāo)準(zhǔn)庫的區(qū)別”是很多人的疑問。簡單來說標(biāo)準(zhǔn)庫SPL更接近寄存器代碼量小執(zhí)行效率高邏輯直觀。但只支持到STM32F1/F2/F4/L1系列ST已停止更新。適合對資源敏感、追求性能、或維護(hù)老項(xiàng)目的開發(fā)者。HAL庫ST主推硬件抽象層更高跨系列F0/F1/F3/F4/F7/H7等兼容性好配合CubeMX工具可以圖形化生成初始化代碼大大提升開發(fā)效率。但代碼體積龐大執(zhí)行效率相對較低有時顯得“臃腫”。對于新手我建議從標(biāo)準(zhǔn)庫入手因?yàn)樗茏屇愀宄乩斫馔庠O(shè)是如何被配置和操作的。理解了底層再使用HAL庫或LL庫你會更清楚它在背后做了什么。對于新項(xiàng)目尤其是需要快速原型開發(fā)或跨芯片移植時HAL庫CubeMX是更高效的選擇。親手搭建一次標(biāo)準(zhǔn)庫工程這個過程中遇到的每一個錯誤和解決的每一步都會加深你對嵌入式開發(fā)工具鏈的理解。這個模板是你所有STM32項(xiàng)目的起點(diǎn)花時間把它打磨好后續(xù)的開發(fā)將會事半功倍。當(dāng)你能熟練地在此基礎(chǔ)上添加串口、定時器、ADC等外設(shè)驅(qū)動時你就真正跨過了STM32開發(fā)的門檻。