簡(jiǎn)介STM32F4固件庫(kù)是意法半導(dǎo)體為STM32F4系列微控制器提供的官方軟件開(kāi)發(fā)包面向嵌入式軟件工程師旨在簡(jiǎn)化外設(shè)初始化、驅(qū)動(dòng)調(diào)用與項(xiàng)目開(kāi)發(fā)流程。資源壓縮包約47.1MB共兩千四百二十五個(gè)文件以C語(yǔ)言源文件、頭文件、超文本格式的接口說(shuō)明、純文本說(shuō)明及工程配置文件為主其中包含數(shù)百個(gè)驅(qū)動(dòng)源文件與頭文件可直接移植或二次開(kāi)發(fā)。離線幫助文檔、芯片參考手冊(cè)和示例工程一同提供可幫助開(kāi)發(fā)者快速掌握各類(lèi)外設(shè)的編程方式并適配多種常用集成開(kāi)發(fā)環(huán)境減少環(huán)境配置時(shí)間。該庫(kù)集成了標(biāo)準(zhǔn)外設(shè)庫(kù)、硬件抽象層和低層驅(qū)動(dòng)三套接口同時(shí)附帶數(shù)字信號(hào)處理數(shù)學(xué)庫(kù)以及文件系統(tǒng)組件、實(shí)時(shí)操作系統(tǒng)內(nèi)核、輕量級(jí)網(wǎng)絡(luò)協(xié)議棧等中間件適合數(shù)據(jù)采集、電機(jī)控制、浮點(diǎn)運(yùn)算和物聯(lián)網(wǎng)節(jié)點(diǎn)等開(kāi)發(fā)場(chǎng)景。目前已有兩千四百三十三人瀏覽學(xué)習(xí)該版本未支持特定型號(hào)F429選用前請(qǐng)核對(duì)具體芯片。1. STM32F4 固件庫(kù)是什么為什么老工程師不急著換 HAL接手過(guò)在役設(shè)備的人多半見(jiàn)過(guò)這種代碼滿(mǎn)屏GPIO_InitTypeDef、RCC_AHB1PeriphClockCmd和NVIC_InitStructure句式整齊得像教科書(shū)示例。這就是 STM32F4 固件庫(kù)圈內(nèi)通常叫它標(biāo)準(zhǔn)外設(shè)庫(kù)。它把寄存器操作封裝成一層很薄的庫(kù)函數(shù)比直接讀寫(xiě)寄存器好維護(hù)比 HAL 的句柄和回調(diào)機(jī)制更透明也更容易看出“這一行到底寫(xiě)了哪個(gè)寄存器”。它解決的是存量項(xiàng)目維護(hù)和學(xué)習(xí)寄存器映射兩件事。新設(shè)計(jì)簽 HAL 沒(méi)問(wèn)題但產(chǎn)線設(shè)備、儀器固件、培訓(xùn)課件里有大量固件庫(kù)寫(xiě)的老代碼裸機(jī)資源緊張時(shí)固件庫(kù)編譯產(chǎn)物比同等功能的 HAL 也小一截。這篇筆記面向的是要讀老代碼、維護(hù)老設(shè)備、或者想搞明白庫(kù)函數(shù)背后寄存器行為的工程師。我不勸你從 HAL 遷回固件庫(kù)也不勸你原地焊死不動(dòng)。只把固件庫(kù)從文件結(jié)構(gòu)、初始化套路、中斷 DMA 到典型翻車(chē)現(xiàn)場(chǎng)講透照著能復(fù)現(xiàn)。讀完你能自己判斷手里的項(xiàng)目該不該動(dòng)它以及真出了問(wèn)題該先懷疑哪里。2. 固件庫(kù)文件結(jié)構(gòu)與工程搭建從壓縮包到點(diǎn)亮一顆 LED2.1 先看懂壓縮包里四類(lèi)文件CMSIS、外設(shè)驅(qū)動(dòng)、啟動(dòng)文件、模板標(biāo)準(zhǔn)外設(shè)庫(kù)壓縮包解壓后的目錄雖然多真正用得上的就四類(lèi)。第一類(lèi)是 CMSIS 層的器件頭文件和系統(tǒng)時(shí)鐘文件負(fù)責(zé)把內(nèi)核和外設(shè)的寄存器地址、位定義、中斷號(hào)全部聲明出來(lái)第二類(lèi)是外設(shè)驅(qū)動(dòng)源文件每個(gè)外設(shè)一對(duì).c/.h比如stm32f4xx_gpio.c和stm32f4xx_usart.c第三類(lèi)是啟動(dòng)文件后綴為.s的匯編第四類(lèi)是官方模板工程里面帶著能直接用的stm32f4xx_conf.h和stm32f4xx_it.c。工程需要用到哪些外設(shè)頭文件由stm32f4xx_conf.h統(tǒng)一管理這個(gè)文件是整個(gè)固件庫(kù)的“總開(kāi)關(guān)”外設(shè)模塊的注釋和使能都在這里做。用一個(gè)常見(jiàn)的模板布局舉例如下表所示文件常見(jiàn)位置作用stm32f4xx.hLibraries/CMSIS/Device/.../Include外設(shè)寄存器地址、位定義、中斷號(hào)枚舉system_stm32f4xx.c同上的 Source 目錄SystemInit與時(shí)鐘樹(shù)配置startup_stm32f407xx.sCMSIS 的 Source/Templates/arm棧初始化、復(fù)位向量、全部中斷向量表stm32f4xx_gpio.c/.hLibraries/STM32F4xx_StdPeriph_DriverGPIO 外設(shè)驅(qū)動(dòng)函數(shù)與結(jié)構(gòu)體stm32f4xx_conf.hProject 模板或 User 目錄外設(shè)模塊開(kāi)關(guān)、assert_param斷言開(kāi)關(guān)misc.c/.h外設(shè)驅(qū)動(dòng)目錄NVIC 與 SysTick 的配置函數(shù)啟動(dòng)文件值得多說(shuō)兩句它定義了第一條指令執(zhí)行前的事包括棧大小、堆大小、復(fù)位向量以及一張完整的中斷向量表。你在固件庫(kù)里寫(xiě)的USART1_IRQHandler等函數(shù)之所以能進(jìn)中斷正是這張表在復(fù)位后被加載到向量表基地址。啟動(dòng)文件選錯(cuò)型號(hào)程序會(huì)莫名其妙跑飛連個(gè)報(bào)錯(cuò)都沒(méi)有這是新手最容易忽略的“黑匣子”。選型上要注意固件庫(kù)和 HAL 的分界不一樣HAL 按整個(gè) F4 系列給一份固件庫(kù)更依賴(lài)你手頭具體型號(hào)的啟動(dòng)文件和器件頭文件。F405、F407、F429 之間啟動(dòng)文件不同外設(shè)驅(qū)動(dòng)源文件卻基本通用。所以復(fù)制工程時(shí)第一件事是核對(duì)啟動(dòng)文件和stm32f4xx.h里的條件編譯是否匹配你的型號(hào)這一步錯(cuò)了后面全白搭。2.2 建一個(gè)最小工程文件清單與 IDE 里的六個(gè)必查項(xiàng)我一般建工程不自己手搓啟動(dòng)文件而是從官方模板或一個(gè)驗(yàn)證過(guò)的舊工程里復(fù)制再刪掉用不到的外設(shè)源文件。這樣比從零添加穩(wěn)能省掉大量“為什么鏈接報(bào)錯(cuò)”的時(shí)間。拿到一個(gè)最小模板后工程目錄通常長(zhǎng)這樣project_root/ ├── User/ │ ├── main.c │ ├── stm32f4xx_it.c │ └── stm32f4xx_conf.h ├── Libraries/ │ ├── CMSIS/ │ │ ├── Device/ST/STM32F4xx/ │ │ └── Include/ │ └── STM32F4xx_StdPeriph_Driver/ │ ├── inc/ # 外設(shè)頭文件 │ └── src/ # 外設(shè)驅(qū)動(dòng)源文件 └── MDK-ARM/ ├── startup_stm32f407xx.s └── project.uvprojx目錄結(jié)構(gòu)只是骨架IDE 里的配置才是大多數(shù)人翻車(chē)的地方。我每次建完工程都會(huì)按六個(gè)點(diǎn)檢查一遍C/C 宏定義里有沒(méi)有USE_STDPERIPH_DRIVER和器件型號(hào)宏Include 路徑是否覆蓋 CMSIS 的 Include、Device 的 Include、外設(shè)驅(qū)動(dòng)的 inc 和 User 目錄C99 開(kāi)關(guān)是否打開(kāi)調(diào)試器下載算法是否選了對(duì)應(yīng)型號(hào)的片內(nèi) Flash編譯優(yōu)化是否暫時(shí)設(shè)為 O0 便于調(diào)試以及外部晶振頻率宏HSE_VALUE與實(shí)際板子是否一致。一個(gè)都不能省特別是HSE_VALUE。固件庫(kù)的system_stm32f4xx.c默認(rèn)按某個(gè)固定晶振值計(jì)算 PLL很多開(kāi)發(fā)板用 8M 晶振模板默認(rèn)卻是 25M結(jié)果串口波特率全錯(cuò)、延時(shí)全部偏掉。第一次接觸固件庫(kù)的人90% 的“串口亂碼、延時(shí)不對(duì)”最后都查回這里。宏定義的寫(xiě)法在 MDK-ARM 里通常是USE_STDPERIPH_DRIVER,STM32F4XX如果你的庫(kù)版本把型號(hào)分得更細(xì)就換成對(duì)應(yīng)的STM32F40XX或STM32F41XX之類(lèi)具體看stm32f4xx.h開(kāi)頭的條件編譯清單里面寫(xiě)了每個(gè)宏對(duì)應(yīng)哪些型號(hào)。USE_STDPERIPH_DRIVER必須留著它決定stm32f4xx.h要不要帶出外設(shè)驅(qū)動(dòng)頭文件和函數(shù)聲明一旦漏掉你會(huì)看到一堆隱式聲明警告或者鏈接時(shí)找不到庫(kù)函數(shù)。提示從舊工程復(fù)制模板時(shí)優(yōu)先復(fù)制“能用”的整套工程再改名而不是手動(dòng)新建后逐個(gè)添加庫(kù)文件能省掉大量路徑和宏配置上的低級(jí)錯(cuò)誤。main.c的最小骨架通常長(zhǎng)這樣#include stm32f4xx.h #include stm32f4xx_conf.h int main(void) { /* 啟動(dòng)文件已經(jīng)調(diào)用過(guò) SystemInit()這里不需要重復(fù)調(diào) */ while (1) { } }新手常踩一個(gè)重復(fù)調(diào)用的問(wèn)題startup_stm32f407xx.s在復(fù)位后會(huì)先調(diào)用SystemInit再跳轉(zhuǎn)到main。如果在main開(kāi)頭又調(diào)一次SystemInit等于把已經(jīng)配置好的時(shí)鐘重新初始化一遍輕則浪費(fèi)時(shí)間重則把外設(shè)時(shí)鐘源改亂。固件庫(kù)模板里SystemInit的調(diào)用位置就在啟動(dòng)文件里main里別寫(xiě)第二遍。這也是判斷一個(gè)固件庫(kù)工程是否“正經(jīng)”的快速方法。3. 外設(shè)初始化標(biāo)準(zhǔn)套路GPIO 點(diǎn)燈與串口收發(fā)背后的寄存器邏輯3.1 GPIO 點(diǎn)燈結(jié)構(gòu)體五個(gè)成員各自改寫(xiě)了哪個(gè)寄存器固件庫(kù)里初始化外設(shè)的姿勢(shì)高度統(tǒng)一先定義一個(gè)外設(shè)對(duì)應(yīng)的InitTypeDef結(jié)構(gòu)體填好成員再把這個(gè)結(jié)構(gòu)體的指針交給外設(shè)的Init函數(shù)。GPIO 的例程是入門(mén)第一課代碼骨架如下/* 第 1 步打開(kāi) GPIOF 所在總線的時(shí)鐘 */ RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOF, ENABLE); /* 第 2 步定義初始化結(jié)構(gòu)體并逐個(gè)填成員 */ GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_9; /* 選引腳 */ GPIO_InitStructure.GPIO_Mode GPIO_Mode_OUT; /* 通用輸出 */ GPIO_InitStructure.GPIO_OType GPIO_OType_PP; /* 推挽輸出 */ GPIO_InitStructure.GPIO_PuPd GPIO_PuPd_NOPULL; /* 無(wú)上下拉 */ GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; /* 翻轉(zhuǎn)速度 */ GPIO_Init(GPIOF, GPIO_InitStructure); /* 第 3 步置位引腳點(diǎn)亮 LED */ GPIO_SetBits(GPIOF, GPIO_Pin_9);這段代碼的邏輯順序不能顛倒第 1 步先開(kāi)時(shí)鐘第 2 步配置模式第 3 步輸出電平。很多人只寫(xiě)后兩步結(jié)果編譯通過(guò)、下載成功、燈就是不亮原因就是 GPIO 的時(shí)鐘沒(méi)開(kāi)寄存器寫(xiě)入根本沒(méi)生效。這是固件庫(kù)第一個(gè)大坑后面避坑章會(huì)再展開(kāi)。參數(shù)說(shuō)明值得逐個(gè)過(guò)一遍。GPIO_Mode有四個(gè)可選值輸入、輸出、復(fù)用、模擬。F4 的引腳模式由 MODER 寄存器控制每個(gè)引腳占 2 位所以輸出是 01、復(fù)用是 10、模擬是 11GPIO_OType決定推挽還是開(kāi)漏推挽適合驅(qū)動(dòng) LED 和普通數(shù)字信號(hào)開(kāi)漏用于 I2C 這類(lèi)需要外部上拉的總線GPIO_PuPd配置上下拉電阻輸入模式時(shí)經(jīng)常用到懸空輸入是抖動(dòng)和誤觸發(fā)的溫床GPIO_Speed控制輸出驅(qū)動(dòng)器的翻轉(zhuǎn)速度不是越高越好高速帶來(lái)更陡的邊沿和更多 EMI點(diǎn)燈用 2MHz 都?jí)蛐枰獣r(shí)再用示波器看邊沿取舍。還有一個(gè)容易被忽略的細(xì)節(jié)GPIO_SetBits和GPIO_ResetBits在固件庫(kù)內(nèi)部寫(xiě)的是 BSRR 寄存器。BSRR 的高 16 位是復(fù)位、低 16 位是置位寫(xiě)入是原子操作不需要“讀-改-寫(xiě)”相比之下直接操作 ODR 是讀改寫(xiě)在中斷和多任務(wù)環(huán)境下可能被別的代碼打斷。這也是固件庫(kù)在這個(gè)接口設(shè)計(jì)上比直接寫(xiě)寄存器更穩(wěn)的原因。3.2 串口發(fā)送復(fù)用引腳、波特率與 printf 重定向的完整鏈路串口是調(diào)試的“第二個(gè)屏幕”比點(diǎn)燈復(fù)雜一個(gè)層級(jí)因?yàn)樯婕耙_復(fù)用和 APB 總線時(shí)鐘。先看配置代碼/* USART1 掛在 APB2 上TXPA9RXPA10都走復(fù)用功能 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); /* 把 PA9、PA10 的復(fù)用功能映射到 USART1 */ GPIO_PinAFConfig(GPIOA, GPIO_PinSource9, GPIO_AF_USART1); GPIO_PinAFConfig(GPIOA, GPIO_PinSource10, GPIO_AF_USART1); GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_9 | GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF; /* 復(fù)用模式 */ GPIO_InitStructure.GPIO_OType GPIO_OType_PP; GPIO_InitStructure.GPIO_PuPd GPIO_PuPd_NOPULL; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate 115200; USART_InitStructure.USART_WordLength USART_WordLength_8b; USART_InitStructure.USART_StopBits USART_StopBits_1; USART_InitStructure.USART_Parity USART_Parity_No; USART_InitStructure.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_InitStructure.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_Init(USART1, USART_InitStructure); USART_Cmd(USART1, ENABLE);這里有兩個(gè)經(jīng)常寫(xiě)錯(cuò)的地方。第一是引腳模式必須是GPIO_Mode_AF而不是GPIO_Mode_OUT復(fù)用映射是 F4 引入的概念由 AFRL/AFRH 寄存器決定引腳信號(hào)來(lái)自哪個(gè)外設(shè)第二是時(shí)鐘總線別搞混USART1 掛在 APB2USART2/3 掛在 APB1APB1 的時(shí)鐘上限和 APB2 不一樣從 USART2 的例程抄到 USART1 而不改 RCC 前綴波特率會(huì)差一截。波特率不是配進(jìn)去就完事它是外設(shè)時(shí)鐘除以一個(gè)分頻系數(shù)得到的固件庫(kù)內(nèi)部實(shí)際做了這個(gè)計(jì)算。從寄存器角度看USART_BRR 的值就是 APB 時(shí)鐘與波特率的比值取整。以 84MHz 的 APB2 配 115200 為例除出來(lái)接近整數(shù)誤差幾乎為零但如果你把外部晶振或 PLL 配錯(cuò)比如板子是 8M 晶振而代碼按 25M 配 PLL時(shí)鐘樹(shù)整體偏掉波特率就是“假”的必定收到亂碼。這類(lèi)問(wèn)題用示波器測(cè) TX 引腳一個(gè)字節(jié)的時(shí)長(zhǎng)和理論位寬對(duì)一下就知道了。下面把串口輸出接到 printf 上這是調(diào)試體驗(yàn)的分水嶺。常見(jiàn)做法是重定向fputc到 USART1#include stdio.h /* printf 聲明 */ int fputc(int ch, FILE *f) { /* 等發(fā)送數(shù)據(jù)寄存器為空再寫(xiě)一個(gè)字節(jié) */ while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }fputc每被 printf 調(diào)用一次就發(fā)送一個(gè)字符發(fā)送前輪詢(xún) TXE 標(biāo)志保證不丟字節(jié)。在 IDE 里做這個(gè)重定向一般要勾選 Microlib 之類(lèi)的精簡(jiǎn) C 庫(kù)否則標(biāo)準(zhǔn)庫(kù)的底層 I/O 會(huì)鏈接出一整套文件系統(tǒng)代碼既有體積問(wèn)題也可能不按你的fputc走。提示精簡(jiǎn)庫(kù)的 printf 對(duì)浮點(diǎn)支持通常需要額外配置打印浮點(diǎn)變量前先確認(rèn)你的工具鏈組合不然會(huì)出現(xiàn)%f打不出東西的玄學(xué)問(wèn)題。到這里串口配置已經(jīng)能用下一章講中斷和 DMA把 CPU 從這種輪詢(xún)等待里解放出來(lái)。4. 中斷與 DMA把 CPU 從輪詢(xún)里解放出來(lái)的固件庫(kù)標(biāo)準(zhǔn)姿勢(shì)4.1 NVIC 優(yōu)先級(jí)分組必須在第一個(gè)外設(shè)中斷使能前定下來(lái)串口輪詢(xún)發(fā)送在功能簡(jiǎn)單時(shí)夠用但一旦主循環(huán)里還有顯示刷新、按鍵掃描輪詢(xún)就會(huì)互相卡。中斷是第一步。F4 的中斷配置在固件庫(kù)里由misc.c提供多數(shù)人第一次看見(jiàn) NVIC 這個(gè)縮寫(xiě)時(shí)沒(méi)意識(shí)到它是內(nèi)核外設(shè)、屬于 CMSIS 層不歸某個(gè)具體外設(shè)管。配置代碼模板如下/* 優(yōu)先級(jí)分組2 位搶占優(yōu)先級(jí) 2 位子優(yōu)先級(jí)整個(gè)工程只調(diào)一次 */ NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel USART1_IRQn; /* 中斷通道 */ NVIC_InitStructure.NVIC_IRQPreemptionPriority 1; /* 搶占優(yōu)先級(jí) */ NVIC_InitStructure.NVIC_IRQSubPriority 1; /* 子優(yōu)先級(jí) */ NVIC_InitStructure.NVIC_IRQCmd ENABLE; NVIC_Init(NVIC_InitStructure);NVIC_PriorityGroupConfig是整個(gè)工程里必須且只能調(diào)用一次的函數(shù)它決定后續(xù)所有中斷優(yōu)先級(jí)字段怎么劃分。F4 的優(yōu)先級(jí)寄存器實(shí)際只用 4 位分組 2 表示高 2 位是搶占優(yōu)先級(jí)、低 2 位是子優(yōu)先級(jí)于是搶占優(yōu)先級(jí)可取 0~3子優(yōu)先級(jí)也可取 0~3。搶占優(yōu)先級(jí)決定一個(gè)中斷能否打斷另一個(gè)正在服務(wù)的中斷子優(yōu)先級(jí)只決定同時(shí)到達(dá)時(shí)誰(shuí)先排隊(duì)。很多人把這兩者的區(qū)別當(dāng)文檔背下來(lái)了但排查問(wèn)題時(shí)會(huì)發(fā)現(xiàn)真正麻煩的場(chǎng)景幾乎都出在“兩個(gè)中斷共享同一搶占優(yōu)先級(jí)且互相有數(shù)據(jù)依賴(lài)”這種組合上。中斷服務(wù)函數(shù)的命名必須和啟動(dòng)文件里的向量表完全一致。固件庫(kù)工程里USART1 中斷對(duì)應(yīng)的是USART1_IRQHandler這個(gè)名字在startup_stm32f407xx.s里已經(jīng)擺好了。寫(xiě)錯(cuò)名字不會(huì)報(bào)編譯錯(cuò)誤因?yàn)殒溄訒r(shí)它把找不到的符號(hào)當(dāng)普通弱引用處理結(jié)果就是中斷來(lái)了直接跑進(jìn)默認(rèn)死循環(huán)或 HardFault。我的習(xí)慣是打開(kāi)stm32f4xx_it.c照著里面的函數(shù)名改名字以工程里的啟動(dòng)文件為準(zhǔn)不要憑記憶寫(xiě)。中斷使能后還有一個(gè)順序問(wèn)題先在主程序里USART_ITConfig(USART1, USART_IT_RXNE, ENABLE)打開(kāi)接收中斷然后再NVIC_Init使能中斷通道最后才輪得到中斷里收數(shù)據(jù)。反過(guò)來(lái)先開(kāi) NVIC 再開(kāi)外設(shè)中斷中間那段時(shí)間如果有數(shù)據(jù)到達(dá)中斷可能因?yàn)橥庠O(shè)中斷位還沒(méi)開(kāi)而錯(cuò)過(guò)。4.2 DMA地址、方向與 FIFO搬運(yùn)前先核對(duì)這三件事中斷解決了 CPU 被阻塞等待的問(wèn)題但每收一個(gè)字節(jié)斷一次、現(xiàn)場(chǎng)保護(hù)一次高波特率下 CPU 還是被折騰得夠嗆。DMA 是真正的解藥它在外設(shè)和內(nèi)存之間按配置好的地址和長(zhǎng)度自動(dòng)搬運(yùn)。F4 的 DMA 比 F1 復(fù)雜在引入了 Stream 和 Channel 的概念外設(shè)信號(hào)先進(jìn) Channel再走 Stream配錯(cuò)映射數(shù)據(jù)根本不動(dòng)。以串口發(fā)送到 DMA 為例/* USART1_TX 固定在 DMA2 的 Stream7Channel 4別按直覺(jué)去配 */ RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA2, ENABLE); DMA_InitTypeDef DMA_InitStructure; DMA_InitStructure.DMA_Channel DMA_Channel_4; DMA_InitStructure.DMA_PeripheralBaseAddr (uint32_t)(USART1-DR); /* 外設(shè)地址 */ DMA_InitStructure.DMA_Memory0BaseAddr (uint32_t)txBuf; /* 內(nèi)存地址 */ DMA_InitStructure.DMA_DIR DMA_DIR_MemoryToPeripheral; DMA_InitStructure.DMA_BufferSize txLen; DMA_InitStructure.DMA_PeripheralInc DMA_PeripheralInc_Disable; /* 外設(shè)地址不變 */ DMA_InitStructure.DMA_MemoryInc DMA_MemoryInc_Enable; /* 內(nèi)存地址遞增 */ DMA_InitStructure.DMA_PeripheralDataSize DMA_PeripheralDataSize_Byte; DMA_InitStructure.DMA_MemoryDataSize DMA_MemoryDataSize_Byte; DMA_InitStructure.DMA_Mode DMA_Mode_Normal; /* 單次搬運(yùn) */ DMA_InitStructure.DMA_Priority DMA_Priority_High; DMA_InitStructure.DMA_FIFOMode DMA_FIFOMode_Disable; /* 直接模式 */ DMA_Init(DMA2_Stream7, DMA_InitStructure); DMA_Cmd(DMA2_Stream7, ENABLE);這段配置里有三個(gè)參數(shù)被問(wèn)得最多。DMA_PeripheralBaseAddr填的是USART1-DR的地址注意外設(shè)地址要用 volatile 方式訪問(wèn)固件庫(kù)里寫(xiě)(uint32_t)(USART1-DR)就是標(biāo)準(zhǔn)做法DMA_DIR方向決定了哪個(gè)地址是源、哪個(gè)是目標(biāo)方向?qū)懛船F(xiàn)象是 CPU 全速跑但串口沒(méi)輸出DMA_FIFOMode_Disable打開(kāi)的是直接模式數(shù)據(jù)不經(jīng)過(guò) FIFO 緩沖對(duì)串口這種字節(jié)流足夠用。如果你想開(kāi) FIFO 提升效率就要同時(shí)設(shè)置閾值閾值必須與外設(shè)數(shù)據(jù)寬度匹配不然搬運(yùn)結(jié)果會(huì)錯(cuò)位調(diào)試起來(lái)比直接模式難得多。串口配合 DMA 的經(jīng)典組合是 ADC 連續(xù)采樣ADC 轉(zhuǎn)換結(jié)果寄存器每完成一次轉(zhuǎn)換就產(chǎn)生一個(gè) DMA 請(qǐng)求由 DMA 把結(jié)果搬進(jìn)內(nèi)存數(shù)組全程不需要 CPU 干預(yù)。配置 ADC 時(shí)幾個(gè)開(kāi)關(guān)必須同時(shí)打開(kāi)否則結(jié)果永遠(yuǎn)只有第一個(gè)通道的值A(chǔ)DC_InitTypeDef ADC_InitStructure; ADC_InitStructure.ADC_Resolution ADC_Resolution_12b; ADC_InitStructure.ADC_ScanConvMode ENABLE; /* 掃描所有通道 */ ADC_InitStructure.ADC_ContinuousConvMode ENABLE; /* 連續(xù)轉(zhuǎn)換 */ ADC_InitStructure.ADC_ExternalTrigConvEdge ADC_ExternalTrigConvEdge_None; ADC_InitStructure.ADC_DataAlign ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfConversion 3; /* 采樣通道個(gè)數(shù) */ ADC_Init(ADC1, ADC_InitStructure);對(duì)應(yīng) DMA 側(cè)的配置是用 DMA2 的 Stream0 和 Channel0方向?yàn)橥庠O(shè)到內(nèi)存模式必須設(shè)成DMA_Mode_Circular循環(huán)否則搬完指定次數(shù)就停住后續(xù)轉(zhuǎn)換結(jié)果不再進(jìn)內(nèi)存。掃描、連續(xù)、循環(huán)這三個(gè)詞分別管硬件三件事掃描管通道輪換、連續(xù)管不需要外部觸發(fā)一直轉(zhuǎn)、循環(huán)管 DMA 搬完一輪從頭再來(lái)。少一個(gè)表現(xiàn)都是“數(shù)據(jù)不對(duì)”但原因不一樣排查時(shí)先逐個(gè)確認(rèn)這三個(gè) ENABLE。5. 固件庫(kù)實(shí)戰(zhàn)避坑五個(gè)高頻翻車(chē)現(xiàn)場(chǎng)與排查手段避坑章不按錯(cuò)誤類(lèi)型分類(lèi)按現(xiàn)場(chǎng)現(xiàn)象分類(lèi)更實(shí)用。你在開(kāi)發(fā)群里提問(wèn)也好、自己翻手冊(cè)也好最終都是拿著現(xiàn)象去反推原因。下面五條是我見(jiàn)過(guò)的高頻現(xiàn)場(chǎng)每條按“現(xiàn)象 → 原因 → 解決”的順序?qū)懩憧梢灾苯赢?dāng)排查清單用。5.1 現(xiàn)象編譯零錯(cuò)誤零警告上電燈就是不亮這是固件庫(kù)入門(mén)第一翻通常發(fā)生在從別的工程復(fù)制代碼改引腳時(shí)。最常見(jiàn)原因是 GPIO 時(shí)鐘沒(méi)開(kāi)或開(kāi)錯(cuò)總線F4 的 GPIOA~GPIOI 全掛在 AHB1 總線上很多人從 F1 的習(xí)慣里抄來(lái)RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE)編譯能過(guò)但那一行實(shí)際操作的寄存器里根本沒(méi)有 GPIOA 的時(shí)鐘位等于白寫(xiě)。解決方法是核對(duì)總線映射F4 的 GPIO 時(shí)鐘走RCC_AHB1PeriphClockCmd串口 1 走 APB2串口 2/3 和大部分通用定時(shí)器走 APB1。另一個(gè)隱蔽原因是 Boot0 引腳被跳線拉高芯片從 SRAM 啟動(dòng)代碼根本沒(méi)跑。判斷方法很簡(jiǎn)單復(fù)位后看 PC 指針落在0x08000000附近還是0x20000000后者去查啟動(dòng)腳。還有一個(gè)可能調(diào)試器下載算法選錯(cuò)程序壓根沒(méi)寫(xiě)進(jìn)片內(nèi) Flash校驗(yàn)時(shí)卻能對(duì)上仿真器里的鏡像這類(lèi)問(wèn)題換一個(gè)正確的 Flash 下載算法即可。5.2 現(xiàn)象串口收到亂碼或者復(fù)位后第一個(gè)字節(jié)丟失亂碼的大頭始終是時(shí)鐘樹(shù)。system_stm32f4xx.c里HSE_VALUE默認(rèn)值和實(shí)際晶振不一致PLL 配出來(lái)整個(gè)系統(tǒng)時(shí)鐘偏差波特率寄存器按錯(cuò)誤的 APB 時(shí)鐘計(jì)算自然全錯(cuò)。排查時(shí)先讓一個(gè) GPIO 翻轉(zhuǎn)輸出方波用示波器量周期驗(yàn)證主頻是不是預(yù)期的 168MHz如果主頻不對(duì)問(wèn)題一定在HSE_VALUE或 PLL 參數(shù)不在串口配置。時(shí)序上再補(bǔ)一刀示波器測(cè) TX 引腳一個(gè)字節(jié)的整體時(shí)長(zhǎng)和理論位寬對(duì)比誤差超過(guò) 2% 就要懷疑時(shí)鐘源。復(fù)位后丟第一個(gè)字節(jié)的原因不太一樣多半是代碼一上電還沒(méi)等兩側(cè)時(shí)鐘穩(wěn)定就開(kāi)始發(fā)數(shù)據(jù)或者發(fā)送端搶在對(duì)方復(fù)位窗口里發(fā)數(shù)據(jù)被吞掉。解決就是在初始化末尾加幾十毫秒延時(shí)等雙方電源和時(shí)鐘穩(wěn)定再握手。很多“偶爾丟第一個(gè)字節(jié)”的詭異現(xiàn)象就是這么治好的不用懷疑硬件。5.3 現(xiàn)象一進(jìn)中斷就 HardFault或者中斷反復(fù)觸發(fā)把主循環(huán)卡死中斷類(lèi)問(wèn)題有個(gè)規(guī)律HardFault 大多不是中斷里代碼邏輯錯(cuò)而是中斷服務(wù)函數(shù)根本不對(duì)。要么函數(shù)名拼錯(cuò)要么中斷服務(wù)函數(shù)寫(xiě)了卻和其他弱定義函數(shù)重名被鏈接器忽略。先用編譯生成的 map 文件查USART1_IRQHandler的地址如果落到一個(gè)默認(rèn)的while(1)死循環(huán)函數(shù)上就說(shuō)明名字錯(cuò)了對(duì)照啟動(dòng)文件里那張向量表改名字一個(gè)字都不能差。中斷反復(fù)觸發(fā)則是標(biāo)志位問(wèn)題進(jìn)中斷后沒(méi)清除中斷標(biāo)志或者清的是錯(cuò)誤的寄存器導(dǎo)致退出中斷后標(biāo)志還在立刻又進(jìn)一次。固件庫(kù)的規(guī)則是“進(jìn)入中斷先清標(biāo)志再讀數(shù)據(jù)”但有些外設(shè)比如串口讀 DR 本身就是清 RXNE 的行為先清了標(biāo)志再讀數(shù)據(jù)反而丟字節(jié)。所以遇到重復(fù)觸發(fā)先看外設(shè)參考手冊(cè)里標(biāo)志由誰(shuí)清零是讀寄存器清零還是寫(xiě)寄存器清零照著做。另一個(gè)容易踩的是優(yōu)先級(jí)分組被多個(gè)模塊各調(diào)了一次后調(diào)用的覆蓋了先調(diào)用的導(dǎo)致所有中斷優(yōu)先級(jí)語(yǔ)義變化。5.4 現(xiàn)象ADC 多通道采樣結(jié)果永遠(yuǎn)只有第一個(gè)值這個(gè)坑在上一章提過(guò)配置這里說(shuō)排查順序。先確認(rèn)ADC_ScanConvMode是 ENABLE否則 ADC 只轉(zhuǎn)第一個(gè)通道再確認(rèn)連續(xù)轉(zhuǎn)換和外部觸發(fā)是否如你所想在固件庫(kù)里如果配置了外部觸發(fā)邊沿但觸發(fā)源沒(méi)配上ADC 可能根本不啟動(dòng)最后查 DMA 側(cè)模式是不是DMA_Mode_Circular方向是不是外設(shè)到內(nèi)存DMA_BufferSize是否等于通道個(gè)數(shù)。還有一個(gè)經(jīng)常被忽略的硬件因素采樣周期太短。信號(hào)源輸出阻抗高時(shí)采樣電容還沒(méi)充到穩(wěn)定值就被切走了表現(xiàn)就是通道串?dāng)?shù)據(jù)、值偏低、或者讀到同一個(gè)值。把 ADC 采樣周期調(diào)大幾檔再試很多“玄學(xué)”問(wèn)題會(huì)直接消失。如果你在調(diào)試器里看到采樣值隨探頭接觸位置變化多半就是這個(gè)原因。5.5 現(xiàn)象仿真器下正常拔掉調(diào)試器就失靈這類(lèi)問(wèn)題最容易讓人懷疑人生因?yàn)檎{(diào)試器在場(chǎng)和不在場(chǎng)芯片的復(fù)位行為其實(shí)不一樣。第一種常見(jiàn)原因調(diào)試器在連接時(shí)會(huì)初始化內(nèi)核并暫停程序把一些你代碼里沒(méi)正確初始化的外設(shè)狀態(tài)“掩蓋”了拔掉后按真實(shí)復(fù)位流程走錯(cuò)誤就暴露了。解決方法是全速跑不設(shè)斷點(diǎn)或者把復(fù)位類(lèi)型切換成硬件復(fù)位再試。第二種原因是懸空引腳外部中斷線接的按鍵或排針?lè)抡嬲{(diào)試時(shí)手指靠近、導(dǎo)線分布電容都能改變電平拔掉調(diào)試器后環(huán)境一變化懸空輸入直接隨機(jī)觸發(fā)中斷。解決是把不用或暫定的中斷輸入引腳配上拉或下拉。第三種是看門(mén)狗類(lèi)仿真時(shí)經(jīng)常停在斷點(diǎn)上喂狗由程序周期執(zhí)行看不出來(lái)問(wèn)題脫機(jī)后主循環(huán)某條路徑卡住超過(guò)窗口期看門(mén)狗復(fù)位表現(xiàn)成隨機(jī)重啟。先關(guān)看門(mén)狗跑一遍確認(rèn)主程序穩(wěn)定再回來(lái)考慮喂狗策略。6. 進(jìn)階用固件庫(kù)源碼反查寄存器練出獨(dú)立調(diào)試的本事6.1 每個(gè)庫(kù)函數(shù)都能翻譯成一行寄存器操作固件庫(kù)的價(jià)值不在于“會(huì)用”而在于它是一本可以單步執(zhí)行的寄存器手冊(cè)。遇到不懂的配置與其去網(wǎng)上搜二手結(jié)論不如直接打開(kāi)stm32f4xx_gpio.c看函數(shù)實(shí)現(xiàn)。比如GPIO_SetBits/* stm32f4xx_gpio.c 里的實(shí)現(xiàn)核心就是寫(xiě) BSRR */ void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t Pin) { GPIOx-BSRRL Pin; /* 寫(xiě) BSRR 低 16 位 置位 */ }看多了你會(huì)發(fā)現(xiàn)規(guī)律Init函數(shù)改寫(xiě)模式類(lèi)寄存器Cmd函數(shù)改寫(xiě)使能類(lèi)寄存器GetFlagStatus讀狀態(tài)類(lèi)寄存器。函數(shù)名本身就是寄存器操作的白話翻譯。在此基礎(chǔ)上我習(xí)慣在調(diào)試器的 Watch 窗口直接加(uint32_t)GPIOF-ODR、(uint32_t)USART1-BRR這類(lèi)地址表達(dá)式配合單步執(zhí)行看配置生效的瞬間比看變量值直觀得多。6.2 斷言功能別盲目關(guān)掉它是固件庫(kù)自帶的參數(shù)檢查固件庫(kù)每個(gè)Init函數(shù)入口都有一個(gè)assert_param斷言檢查參數(shù)是否在合法范圍內(nèi)。默認(rèn)開(kāi)啟時(shí)參數(shù)越界會(huì)調(diào)用assert_failed函數(shù)進(jìn)入死循環(huán)很多人嫌它礙事發(fā)布前直接關(guān)掉結(jié)果恰恰掩蓋了配置錯(cuò)誤。某開(kāi)發(fā)者曾把斷言關(guān)了為一個(gè)“有時(shí)正常有時(shí)不正常的 GPIO 初始化”排查了三天最后翻源碼發(fā)現(xiàn)是GPIO_Pin填了一個(gè)跨端口的非法組合斷言打開(kāi)時(shí)半秒鐘就能定位。我的習(xí)慣是調(diào)試階段全程開(kāi)著斷言確認(rèn)穩(wěn)定后只在 Release 版關(guān)閉并且給自己留一個(gè)assert_failed里的打印出口讓問(wèn)題在產(chǎn)線上也能留痕。這個(gè)習(xí)慣幫我省過(guò)不少返工希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取