：源碼包拆解與時鐘、外設配置實戰(zhàn))
簡介藍橋杯嵌入式競賽的STM32G431RBT6程序源碼與項目說明包主要面向準備藍橋杯賽項的選手及電子信息、計算機相關專業(yè)學生可作為課程設計或畢設參考。資源整體可直接運行但要求讀者能看懂代碼、自行調試壓縮包共兩千個文件以一千零一十五個頭文件和六百九十三個C語言源文件為主體涵蓋硬件抽象層庫驅動、應用邏輯與工程配置。另含工程配置文件、十六進制燒寫文件、調試映像文件、鏈接映像文件及說明文檔等便于在集成開發(fā)環(huán)境中編譯、燒錄與排錯包體約一百一十六點八一兆字節(jié)目錄按模塊劃分便于查找。已有八百五十四人學習下載具備一定參考熱度。作者提供完整源碼和項目說明可對照理解微控制器外設配置、藍橋杯賽題實現(xiàn)思路及從工程搭建到功能調試的完整流程適合借鑒并在此之上擴展調試。1. G431RBT6 這顆主控為什么撐得起藍橋杯嵌入式源碼包藍橋杯嵌入式賽道換用 STM32G431RBT6 之后“程序源碼項目說明.zip”基本成了每次備賽繞不開的資源。這份壓縮包乍看像一份現(xiàn)成答案實際是一套“硬件、工程、文檔”配套好的模板主控芯片選型、CubeMX 初始化、按鍵掃描、ADC 采集、PWM 輸出、串口上報、LCD 顯示全都被串在一條主循環(huán)里。G431RBT6 是 Cortex-M4F 內核、最高 170MHz帶硬浮點 FPU片上兩個 12 位 ADC 支持硬件過采樣定時器、串口、SPI、FDCAN 都齊全。所以它的工程比 F103 時代更有“嵌入式正規(guī)軍”的味道。真正拉開差距的不是抄不抄得到代碼而是你能不能對著項目說明里的原理圖把每個外設引腳和軟件里的句柄對起來。對熟悉這塊板子的人來說這份源碼不過是嵌入式學習路線上一個高效率的中間站。2. 復現(xiàn) G431RBT6 源碼前先建一個 170MHz 的最小工程2.1 上電默認只有 4MHz時鐘樹是第一道門檻STM32G431RBT6 上電后默認走 MSI 內部時鐘典型頻率只有 4MHz 左右。也就是說新板子拿回來直接下載一個點燈程序燈能亮但一旦涉及串口波特率、定時器 PWM、ADC 采樣率全部會差出一個數(shù)量級。問題幾乎不在代碼邏輯而在 CubeMX 的項目里根本沒把時鐘樹配到 170MHz。我一般拿到任何 G431RBT6 工程第一件事是打開.ioc文件查 RCC 配置。常見做法是把 PLL Source 選為 HSI16然后參數(shù)值作用PLLM2把 16MHz 分頻到 8MHzPLLN858MHz 倍頻到 170MHzPLLR2作為 SYSCLK 的最終分頻SYSCLK170MHzCPU 內核時鐘如果板子上有外部晶振也可以把 PLL Source 換成 HSE再重算 PLLM/N/R。要確認是否真正生效最直接的辦法是看 CubeMX 時鐘樹頁面里 SYSCLK 是不是 170.0MHz。很多源碼包跑起來怪怪的都是因為這里被改回了 16MHz 或者 64MHz。2.2 解壓時先校驗文件再看目錄結構拿到“程序源碼項目說明.zip”這類壓縮包我建議先算一遍 SHA256再解壓。Windows 自帶命令就能做certutil -hashfile 藍橋杯嵌入式STM32G431RBT6程序源碼項目說明.zip SHA256在 Linux 或 WSL 下則用 sha256sum。校驗的目的不是防篡改而是確認壓縮包完整避免解壓到一半出現(xiàn)工程文件損壞Keil 打開后瘋狂報缺文件。解壓到純英文路徑例如D:\G431_Project。中文路徑或帶空格的路徑會導致 Keil MDK 的 UVProj 工程文件偶爾找不到頭文件還可能讓 J-Link 下載時工作目錄異常。解壓后先看根目錄一般會有四種文件文件類型作用.ioc工程配置引腳、時鐘、外設參數(shù)全在這里MDK-ARM 目錄Keil 工程文件直接雙擊打開App或User目錄主邏輯、狀態(tài)機、業(yè)務代碼項目說明文檔引腳映射、外設要求、評分要點2.3 最小 main 函數(shù)先把板子點亮不要急著讀完整源碼先確認工具鏈和板卡是通的。我習慣在 CubeMX 里配好一個最小工程然后只做一件事翻轉 LED。以下是 main 循環(huán)里的關鍵部分int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); } }HAL_GPIO_TogglePin直接翻轉引腳輸出電平不需要先讀再寫HAL_Delay基于 SysTick前提是HAL_Init()已經(jīng)跑過且時鐘樹配置正確。如果這里燈閃得很快或極慢不用懷疑代碼回 2.1 檢查 SYSCLK。這個最小工程就是后續(xù)所有外設調試的底。2.3.1 Keil 工程里千萬別漏開 FPUG431RBT6 是 M4F有單精度浮點單元。CubeMX 默認會把 FPU 在啟動文件里打開但 Keil MDK 的 C/C 選項里還必須在 Floating Point Hardware 一欄選擇 Single Precision。漏掉這一步代碼里只要出現(xiàn)float運算跑起來就是 HardFault。藍橋杯真題里處理電壓值、溫度值經(jīng)常會用到浮點顯示這個開關直接影響程序能不能過測試點。3. 把程序源碼拆成 bsp 層和中斷層G431RBT6 的工程骨架3.1 項目說明文檔里先看這三樣東西拿到項目說明后不要急著看代碼。常見做法是先找三樣內容引腳分配表、模塊接線圖、已知問題清單。引腳分配表解決“這個 GPIO 對應板子上哪個按鍵”模塊接線圖解決“ADC 通道到底接在哪顆電位器上”已知問題則避免你踩前人已經(jīng)寫進文檔里的坑。很多嵌入式開源項目也是這種組織方式一個外設一個驅動文件應用邏輯單獨放。這樣工程的主線永遠是 main 里的初始化序列加一個主循環(huán)調度器。下面是一份典型目錄結構G431_Project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ └── stm32g4xx_it.c ├── bsp/ │ ├── bsp_led.c │ ├── bsp_key.c │ ├── bsp_adc.c │ └── bsp_uart.c ├── Doc/ │ └── 項目說明.md └── MDK-ARM/Core/Src里是 CubeMX 生成的基礎代碼和中斷服務函數(shù)bsp目錄是手寫的板級驅動每個文件對應一個外設Doc放項目說明?？吹竭@個結構就知道作者是想把 HAL 庫產(chǎn)生的初始化邏輯和具體業(yè)務解耦。3.2 用嵌入式 C 語言的事件標志位組織按鍵掃描按鍵掃描是這套源碼里最值得細讀的部分。很多初學者把按鍵檢測放在中斷里然后在中斷里延時消抖這在大賽板上一旦加上 LCD 刷新就會出現(xiàn)按鍵失靈。常見做法是主循環(huán) 5ms 到 20ms 周期性掃描一次按鍵用兩級電平加時間戳做消抖再通過事件標志位通知業(yè)務邏輯。#define KEY_PIN GPIO_PIN_0 #define KEY_GPIO_PORT GPIOA #define DEBOUNCE_TICKS 5 static uint8_t raw_level; // 當前讀取到的電平 static uint8_t stable_level; // 消抖后的穩(wěn)定電平 static uint32_t last_tick; // 上次電平跳變的時刻 volatile uint8_t key_event; // 0無事件1短按 void BSP_Key_Scan(void) { uint8_t level (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_PIN) GPIO_PIN_RESET) ? 1 : 0; uint32_t now HAL_GetTick(); if (level ! raw_level) { raw_level level; last_tick now; return; } if ((level ! stable_level) (now - last_tick DEBOUNCE_TICKS)) { stable_level level; if (stable_level 1) { key_event 1; // 低電平有效按下瞬間產(chǎn)生事件 } } }raw_level保存最新讀取的物理電平只要電平變化就重置時間戳不做任何判斷只有電平連續(xù)穩(wěn)定超過DEBOUNCE_TICKS毫秒才更新stable_level。主循環(huán)里只需判斷key_event是否為 1處理后立刻清零。這里要注意key_event會被中斷函數(shù)或主循環(huán)之外的代碼讀寫必須用volatile修飾否則編譯器可能把這個變量優(yōu)化進寄存器導致事件丟失。3.3 中斷里只做一件事置標志G431RBT6 的 HAL 庫工程中中斷服務函數(shù)集中在stm32g4xx_it.c。新手最常犯的錯誤是在中斷回調里直接調用HAL_UART_Transmit發(fā)串口或者在回調里HAL_Delay。中斷里跑長時間的阻塞函數(shù)輕則丟中斷重則卡死主循環(huán)。正確姿勢是中斷里只置位標志把實際處理放回主循環(huán)。extern volatile uint8_t uart_rx_done; extern volatile uint8_t uart_rx_data; void USART1_IRQHandler(void) { if (USART1-ISR USART_ISR_RXNE) { uart_rx_data USART1-RDR 0xFF; uart_rx_done 1; } }這段示例里直接操作寄存器讀RDR比調用HAL_UART_Receive_IT更直白也省去了回調函數(shù)里的句柄判斷。參數(shù)說明USART1-ISR是狀態(tài)寄存器RXNE位表示接收數(shù)據(jù)寄存器已滿讀RDR會自動清除該位不需要手動寫清除。中斷優(yōu)先級分組常用 NVIC 默認配置搶占優(yōu)先級 0 到 3其中 SysTick 和耗時外設盡量分配不同組。外設中斷搶占優(yōu)先級說明SysTick0最優(yōu)先保證 HAL_Delay 準確USART11接收數(shù)據(jù)只置標志TIM22定時采集或 PWM 相關這個優(yōu)先級表不是絕對的但原則是越不能被阻塞的中斷優(yōu)先級越高。把 SysTick 放最高才能保證HAL_GetTick()在按鍵消抖里穩(wěn)定工作。4. G431RBT6 真題外設組合ADC、PWM、串口與 LCD 的參數(shù)表4.1 ADC 采集電位器電壓先校準再采樣最近幾屆藍橋杯嵌入式真題基本都繞不開“采集、顯示、上報”這個組合。ADC 采集電位器電壓換算成實際電壓值顯示在 LCD 上同時通過串口發(fā)送到上位機。G431RBT6 的 ADC 是 12 位最大采樣率 2.5Msps支持硬件過采樣配置起來比 F103 要復雜一點。在 CubeMX 里開 ADC1選擇一個通道比如電位器接在 PA0 對應的通道。注意具體通道號必須以后面的項目說明書和板卡絲印為準同一片 G431RBT6 在不同競賽板上的引腳映射可能不同。初始化完成后啟動 ADC 前要先做校準HAL_ADCEx_Calibration_Start(hadc1, ADC_SINGLE_ENDED); HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); uint16_t adc_val HAL_ADC_GetValue(hadc1); float voltage adc_val * 3.3f / 4095.0f;HAL_ADCEx_Calibration_Start是 G4 系列獨有的校準接口必須在單次采樣之前調用第二個參數(shù)ADC_SINGLE_ENDED表示單端輸入。換算公式里分母 4095 對應 12 位 ADC 的最大值3.3f是參考電壓。G431RBT6 有 FPU直接用浮點不會對性能造成壓力但要注意voltage后面的運算如果多次使用盡量一次算完避免重復轉換。采樣時間參數(shù)同樣關鍵。CubeMX 里 ADC Sampling Time 選 2.5 到 92.5 cycles 不等。信號源阻抗高、走線長時采樣時間要放到 47.5 cycles 以上否則電壓讀數(shù)會偏低。遇到過不少人讀出的 ADC 值整體偏差 30mV 以上基本都是這里偷懶用了最小的 1.5 cycles。4.2 PWM 輸出頻率先算好再填 PSC 和 ARRPWM 輸出是真題里控制電機、蜂鳴器、調光的標配。G431RBT6 的定時器資源豐富TIM1、TIM8 是高級定時器TIM2、TIM3、TIM4 是通用定時器。選哪個定時器要看 CubeMX 的時鐘樹里該 TIM 掛在 APB1 還是 APB2。不同分頻系數(shù)會讓定時器時鐘不是簡單的 170MHz。通用公式是PWM頻率 timer_clk / ((PSC 1) * (ARR 1))例如想在 TIM3 上產(chǎn)生 10kHz PWM如果 timer_clk 是 170MHz可以取 PSC169這樣計數(shù)時鐘是 1MHz再取 ARR99輸出就是 10kHz。如果是 85MHz 的定時器時鐘同樣的參數(shù)輸出 5kHz所以填參數(shù)前先確認timer_clk。TIM3-PSC 169; TIM3-ARR 99; TIM3-CCR1 30; // 占空比約 30% TIM3-CCMR1 (TIM3-CCMR1 ~TIM_CCMR1_OC1M_Msk) | TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_2; TIM3-CCER | TIM_CCER_CC1E; TIM3-CR1 | TIM_CR1_CEN;這段寄存器操作把 TIM3 配置成 PWM 模式 1OC1M位段設置為 110即 PWM 模式 1計數(shù)到 CCR1 輸出有效電平。CC1E使能通道輸出CEN啟動計數(shù)器。實際工程中直接在 CubeMX 里配置好再用__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 30)改占空比更穩(wěn)妥寄存器版本適合調試時快速確認底層行為。PSC 和 ARR 都是 16 位寄存器最大值 65535。如果需要極低頻率比如 1Hz 慢閃就要把 PSC 拉高或者改用 TIM2 這類帶更大預分頻能力的定時器方案。這是嵌入式八股文里常考的溢出計算題放到真實項目里就是“LED 不閃”和“電機轉速對不上”的排查方向。4.3 串口配置printf 重定向的兩種路線串口上報數(shù)值最快速的調試方式是直接把 printf 映射到 USART。G431RBT6 的 USART1 默認掛在 PA9/PA10CubeMX 里配成 Asynchronous波特率 115200、8-N-1。然后需要自己實現(xiàn)字符發(fā)送接口。GCC 工具鏈STM32CubeIDE 等下的實現(xiàn)#include stdio.h int __io_putchar(int ch) { uint8_t c (uint8_t)ch; HAL_UART_Transmit(huart1, c, 1, 10); return ch; } int _write(int fd, char *ptr, int len) { for (int i 0; i len; i) { if (__io_putchar((uint8_t)ptr[i]) EOF) { return i; } } return len; }_write是 syscall 的底層接口printf 最終會調用它把緩沖區(qū)逐字節(jié)發(fā)出去第四個參數(shù) 10 是超時毫秒數(shù)串口空閑時 1 字節(jié)只占不到 0.1ms10ms 足夠。Keil MDK 用戶則通常勾選 Use MicroLIB再用 fputc 實現(xiàn)同樣的邏輯這時因為全部走庫函數(shù)代碼更短。注意如果串口發(fā)送在中斷回調里調用printf超時參數(shù)很容易被拖滿進而影響實時性。串口打印適合放在主循環(huán)的狀態(tài)機里不適合壓到中斷里高頻輸出。4.4 LCD 顯示數(shù)值緩沖區(qū)大小和格式串LCD 顯示 float 類型最省事的寫法是char buf[16]; sprintf(buf, %.2fV, voltage); LCD_DisplayStringLine(Line4, buf);有兩個點都容易踩。一是緩沖區(qū)大小sprintf不檢查長度浮點加單位很容易超 12 字節(jié)要留余量二是.2f會做四舍五入如果題目要求的是“截斷到小數(shù)點后兩位”就要先用(int)(voltage * 100)拆出整數(shù)和小數(shù)再拼字符串。LCD 驅動如果是 SPI 接口刷新一次整屏要幾十毫秒全局刷新的頻率別超過 20Hz否則主循環(huán)會被拖死。5. G431RBT6 源碼燒進去之后用這 4 個檢查點驗證5.1 檢查點一時鐘樹是否真的跑在 170MHz燒錄后第一步接調試器或者用 J-Link RTT看SystemCoreClock變量。這個變量在 system_stm32g4xx.c 里維護標準值是 170000000。如果讀到的是 16000000說明.ioc里時鐘配置被改過或者SystemClock_Config()里手動設置的 PLL 參數(shù)不對直接回到第 2 章的表格重算。5.2 檢查點二串口回環(huán)測試把 USART 的 TX 和 RX 用杜邦線短接然后執(zhí)行一段回環(huán)代碼HAL_UART_Transmit(huart1, (uint8_t*)OK\r\n, 5, 100); HAL_UART_Receive(huart1, rx_byte, 1, 100);如果串口助手能收到 OK 而收不到回環(huán)數(shù)據(jù)多半是 RX 引腳映射或者中斷里沒讀RDR導致數(shù)據(jù)滯留。用邏輯分析儀抓 PA9/PA10能直接確認波形有沒有發(fā)出來比盯著串口助手猜快得多。5.3 檢查點三HAL_Delay 卡死和變量被優(yōu)化程序運行一段時間后卡死最常見兩個原因一是在中斷里調用HAL_DelaySysTick 被同級或更高優(yōu)先級中斷搶占永遠回不來二是共享變量沒加volatile主循環(huán)讀了舊值。解決方案很簡單中斷里只置標志位標志位統(tǒng)一加volatile修飾串口、ADC 這類句柄則保持 HAL 庫生成的原始類型即可。5.4 檢查點四改動最小化對比 .ioc 差異從壓縮包源碼改成自己的真題實現(xiàn)時每次改動都只動一個bsp_xxx.c文件不要順手改stm32g4xx_it.c的結構。想回顧自己改了什么直接對比.iocgit diff --no-index backup/工程.ioc 當前/工程.ioc.ioc文件是純文本Git 能直接做差異對比?？打寗优渲玫母膭颖瓤创a改動更直觀。最后一個小技巧調試 PWM 和 ADC 時保證采集端的杜邦線別超過 10cm否則引線電感會讓 ADC 讀數(shù)跳動、PWM 波形邊緣出現(xiàn)明顯振鈴。把線剪短很多“硬件問題”會直接消失。本文還有配套的精品資源點擊獲取 STM32G431RBT6嵌入式開發(fā)：源碼包拆解與時鐘、外設配置實戰(zhàn)
簡介藍橋杯嵌入式競賽的STM32G431RBT6程序源碼與項目說明包主要面向準備藍橋杯賽項的選手及電子信息、計算機相關專業(yè)學生可作為課程設計或畢設參考。資源整體可直接運行但要求讀者能看懂代碼、自行調試壓縮包共兩千個文件以一千零一十五個頭文件和六百九十三個C語言源文件為主體涵蓋硬件抽象層庫驅動、應用邏輯與工程配置。另含工程配置文件、十六進制燒寫文件、調試映像文件、鏈接映像文件及說明文檔等便于在集成開發(fā)環(huán)境中編譯、燒錄與排錯包體約一百一十六點八一兆字節(jié)目錄按模塊劃分便于查找。已有八百五十四人學習下載具備一定參考熱度。作者提供完整源碼和項目說明可對照理解微控制器外設配置、藍橋杯賽題實現(xiàn)思路及從工程搭建到功能調試的完整流程適合借鑒并在此之上擴展調試。1. G431RBT6 這顆主控為什么撐得起藍橋杯嵌入式源碼包藍橋杯嵌入式賽道換用 STM32G431RBT6 之后“程序源碼項目說明.zip”基本成了每次備賽繞不開的資源。這份壓縮包乍看像一份現(xiàn)成答案實際是一套“硬件、工程、文檔”配套好的模板主控芯片選型、CubeMX 初始化、按鍵掃描、ADC 采集、PWM 輸出、串口上報、LCD 顯示全都被串在一條主循環(huán)里。G431RBT6 是 Cortex-M4F 內核、最高 170MHz帶硬浮點 FPU片上兩個 12 位 ADC 支持硬件過采樣定時器、串口、SPI、FDCAN 都齊全。所以它的工程比 F103 時代更有“嵌入式正規(guī)軍”的味道。真正拉開差距的不是抄不抄得到代碼而是你能不能對著項目說明里的原理圖把每個外設引腳和軟件里的句柄對起來。對熟悉這塊板子的人來說這份源碼不過是嵌入式學習路線上一個高效率的中間站。2. 復現(xiàn) G431RBT6 源碼前先建一個 170MHz 的最小工程2.1 上電默認只有 4MHz時鐘樹是第一道門檻STM32G431RBT6 上電后默認走 MSI 內部時鐘典型頻率只有 4MHz 左右。也就是說新板子拿回來直接下載一個點燈程序燈能亮但一旦涉及串口波特率、定時器 PWM、ADC 采樣率全部會差出一個數(shù)量級。問題幾乎不在代碼邏輯而在 CubeMX 的項目里根本沒把時鐘樹配到 170MHz。我一般拿到任何 G431RBT6 工程第一件事是打開.ioc文件查 RCC 配置。常見做法是把 PLL Source 選為 HSI16然后參數(shù)值作用PLLM2把 16MHz 分頻到 8MHzPLLN858MHz 倍頻到 170MHzPLLR2作為 SYSCLK 的最終分頻SYSCLK170MHzCPU 內核時鐘如果板子上有外部晶振也可以把 PLL Source 換成 HSE再重算 PLLM/N/R。要確認是否真正生效最直接的辦法是看 CubeMX 時鐘樹頁面里 SYSCLK 是不是 170.0MHz。很多源碼包跑起來怪怪的都是因為這里被改回了 16MHz 或者 64MHz。2.2 解壓時先校驗文件再看目錄結構拿到“程序源碼項目說明.zip”這類壓縮包我建議先算一遍 SHA256再解壓。Windows 自帶命令就能做certutil -hashfile 藍橋杯嵌入式STM32G431RBT6程序源碼項目說明.zip SHA256在 Linux 或 WSL 下則用 sha256sum。校驗的目的不是防篡改而是確認壓縮包完整避免解壓到一半出現(xiàn)工程文件損壞Keil 打開后瘋狂報缺文件。解壓到純英文路徑例如D:\G431_Project。中文路徑或帶空格的路徑會導致 Keil MDK 的 UVProj 工程文件偶爾找不到頭文件還可能讓 J-Link 下載時工作目錄異常。解壓后先看根目錄一般會有四種文件文件類型作用.ioc工程配置引腳、時鐘、外設參數(shù)全在這里MDK-ARM 目錄Keil 工程文件直接雙擊打開App或User目錄主邏輯、狀態(tài)機、業(yè)務代碼項目說明文檔引腳映射、外設要求、評分要點2.3 最小 main 函數(shù)先把板子點亮不要急著讀完整源碼先確認工具鏈和板卡是通的。我習慣在 CubeMX 里配好一個最小工程然后只做一件事翻轉 LED。以下是 main 循環(huán)里的關鍵部分int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); } }HAL_GPIO_TogglePin直接翻轉引腳輸出電平不需要先讀再寫HAL_Delay基于 SysTick前提是HAL_Init()已經(jīng)跑過且時鐘樹配置正確。如果這里燈閃得很快或極慢不用懷疑代碼回 2.1 檢查 SYSCLK。這個最小工程就是后續(xù)所有外設調試的底。2.3.1 Keil 工程里千萬別漏開 FPUG431RBT6 是 M4F有單精度浮點單元。CubeMX 默認會把 FPU 在啟動文件里打開但 Keil MDK 的 C/C 選項里還必須在 Floating Point Hardware 一欄選擇 Single Precision。漏掉這一步代碼里只要出現(xiàn)float運算跑起來就是 HardFault。藍橋杯真題里處理電壓值、溫度值經(jīng)常會用到浮點顯示這個開關直接影響程序能不能過測試點。3. 把程序源碼拆成 bsp 層和中斷層G431RBT6 的工程骨架3.1 項目說明文檔里先看這三樣東西拿到項目說明后不要急著看代碼。常見做法是先找三樣內容引腳分配表、模塊接線圖、已知問題清單。引腳分配表解決“這個 GPIO 對應板子上哪個按鍵”模塊接線圖解決“ADC 通道到底接在哪顆電位器上”已知問題則避免你踩前人已經(jīng)寫進文檔里的坑。很多嵌入式開源項目也是這種組織方式一個外設一個驅動文件應用邏輯單獨放。這樣工程的主線永遠是 main 里的初始化序列加一個主循環(huán)調度器。下面是一份典型目錄結構G431_Project/ ├── Core/ │ ├── Inc/ │ └── Src/ │ ├── main.c │ └── stm32g4xx_it.c ├── bsp/ │ ├── bsp_led.c │ ├── bsp_key.c │ ├── bsp_adc.c │ └── bsp_uart.c ├── Doc/ │ └── 項目說明.md └── MDK-ARM/Core/Src里是 CubeMX 生成的基礎代碼和中斷服務函數(shù)bsp目錄是手寫的板級驅動每個文件對應一個外設Doc放項目說明?？吹竭@個結構就知道作者是想把 HAL 庫產(chǎn)生的初始化邏輯和具體業(yè)務解耦。3.2 用嵌入式 C 語言的事件標志位組織按鍵掃描按鍵掃描是這套源碼里最值得細讀的部分。很多初學者把按鍵檢測放在中斷里然后在中斷里延時消抖這在大賽板上一旦加上 LCD 刷新就會出現(xiàn)按鍵失靈。常見做法是主循環(huán) 5ms 到 20ms 周期性掃描一次按鍵用兩級電平加時間戳做消抖再通過事件標志位通知業(yè)務邏輯。#define KEY_PIN GPIO_PIN_0 #define KEY_GPIO_PORT GPIOA #define DEBOUNCE_TICKS 5 static uint8_t raw_level; // 當前讀取到的電平 static uint8_t stable_level; // 消抖后的穩(wěn)定電平 static uint32_t last_tick; // 上次電平跳變的時刻 volatile uint8_t key_event; // 0無事件1短按 void BSP_Key_Scan(void) { uint8_t level (HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_PIN) GPIO_PIN_RESET) ? 1 : 0; uint32_t now HAL_GetTick(); if (level ! raw_level) { raw_level level; last_tick now; return; } if ((level ! stable_level) (now - last_tick DEBOUNCE_TICKS)) { stable_level level; if (stable_level 1) { key_event 1; // 低電平有效按下瞬間產(chǎn)生事件 } } }raw_level保存最新讀取的物理電平只要電平變化就重置時間戳不做任何判斷只有電平連續(xù)穩(wěn)定超過DEBOUNCE_TICKS毫秒才更新stable_level。主循環(huán)里只需判斷key_event是否為 1處理后立刻清零。這里要注意key_event會被中斷函數(shù)或主循環(huán)之外的代碼讀寫必須用volatile修飾否則編譯器可能把這個變量優(yōu)化進寄存器導致事件丟失。3.3 中斷里只做一件事置標志G431RBT6 的 HAL 庫工程中中斷服務函數(shù)集中在stm32g4xx_it.c。新手最常犯的錯誤是在中斷回調里直接調用HAL_UART_Transmit發(fā)串口或者在回調里HAL_Delay。中斷里跑長時間的阻塞函數(shù)輕則丟中斷重則卡死主循環(huán)。正確姿勢是中斷里只置位標志把實際處理放回主循環(huán)。extern volatile uint8_t uart_rx_done; extern volatile uint8_t uart_rx_data; void USART1_IRQHandler(void) { if (USART1-ISR USART_ISR_RXNE) { uart_rx_data USART1-RDR 0xFF; uart_rx_done 1; } }這段示例里直接操作寄存器讀RDR比調用HAL_UART_Receive_IT更直白也省去了回調函數(shù)里的句柄判斷。參數(shù)說明USART1-ISR是狀態(tài)寄存器RXNE位表示接收數(shù)據(jù)寄存器已滿讀RDR會自動清除該位不需要手動寫清除。中斷優(yōu)先級分組常用 NVIC 默認配置搶占優(yōu)先級 0 到 3其中 SysTick 和耗時外設盡量分配不同組。外設中斷搶占優(yōu)先級說明SysTick0最優(yōu)先保證 HAL_Delay 準確USART11接收數(shù)據(jù)只置標志TIM22定時采集或 PWM 相關這個優(yōu)先級表不是絕對的但原則是越不能被阻塞的中斷優(yōu)先級越高。把 SysTick 放最高才能保證HAL_GetTick()在按鍵消抖里穩(wěn)定工作。4. G431RBT6 真題外設組合ADC、PWM、串口與 LCD 的參數(shù)表4.1 ADC 采集電位器電壓先校準再采樣最近幾屆藍橋杯嵌入式真題基本都繞不開“采集、顯示、上報”這個組合。ADC 采集電位器電壓換算成實際電壓值顯示在 LCD 上同時通過串口發(fā)送到上位機。G431RBT6 的 ADC 是 12 位最大采樣率 2.5Msps支持硬件過采樣配置起來比 F103 要復雜一點。在 CubeMX 里開 ADC1選擇一個通道比如電位器接在 PA0 對應的通道。注意具體通道號必須以后面的項目說明書和板卡絲印為準同一片 G431RBT6 在不同競賽板上的引腳映射可能不同。初始化完成后啟動 ADC 前要先做校準HAL_ADCEx_Calibration_Start(hadc1, ADC_SINGLE_ENDED); HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); uint16_t adc_val HAL_ADC_GetValue(hadc1); float voltage adc_val * 3.3f / 4095.0f;HAL_ADCEx_Calibration_Start是 G4 系列獨有的校準接口必須在單次采樣之前調用第二個參數(shù)ADC_SINGLE_ENDED表示單端輸入。換算公式里分母 4095 對應 12 位 ADC 的最大值3.3f是參考電壓。G431RBT6 有 FPU直接用浮點不會對性能造成壓力但要注意voltage后面的運算如果多次使用盡量一次算完避免重復轉換。采樣時間參數(shù)同樣關鍵。CubeMX 里 ADC Sampling Time 選 2.5 到 92.5 cycles 不等。信號源阻抗高、走線長時采樣時間要放到 47.5 cycles 以上否則電壓讀數(shù)會偏低。遇到過不少人讀出的 ADC 值整體偏差 30mV 以上基本都是這里偷懶用了最小的 1.5 cycles。4.2 PWM 輸出頻率先算好再填 PSC 和 ARRPWM 輸出是真題里控制電機、蜂鳴器、調光的標配。G431RBT6 的定時器資源豐富TIM1、TIM8 是高級定時器TIM2、TIM3、TIM4 是通用定時器。選哪個定時器要看 CubeMX 的時鐘樹里該 TIM 掛在 APB1 還是 APB2。不同分頻系數(shù)會讓定時器時鐘不是簡單的 170MHz。通用公式是PWM頻率 timer_clk / ((PSC 1) * (ARR 1))例如想在 TIM3 上產(chǎn)生 10kHz PWM如果 timer_clk 是 170MHz可以取 PSC169這樣計數(shù)時鐘是 1MHz再取 ARR99輸出就是 10kHz。如果是 85MHz 的定時器時鐘同樣的參數(shù)輸出 5kHz所以填參數(shù)前先確認timer_clk。TIM3-PSC 169; TIM3-ARR 99; TIM3-CCR1 30; // 占空比約 30% TIM3-CCMR1 (TIM3-CCMR1 ~TIM_CCMR1_OC1M_Msk) | TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_2; TIM3-CCER | TIM_CCER_CC1E; TIM3-CR1 | TIM_CR1_CEN;這段寄存器操作把 TIM3 配置成 PWM 模式 1OC1M位段設置為 110即 PWM 模式 1計數(shù)到 CCR1 輸出有效電平。CC1E使能通道輸出CEN啟動計數(shù)器。實際工程中直接在 CubeMX 里配置好再用__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 30)改占空比更穩(wěn)妥寄存器版本適合調試時快速確認底層行為。PSC 和 ARR 都是 16 位寄存器最大值 65535。如果需要極低頻率比如 1Hz 慢閃就要把 PSC 拉高或者改用 TIM2 這類帶更大預分頻能力的定時器方案。這是嵌入式八股文里常考的溢出計算題放到真實項目里就是“LED 不閃”和“電機轉速對不上”的排查方向。4.3 串口配置printf 重定向的兩種路線串口上報數(shù)值最快速的調試方式是直接把 printf 映射到 USART。G431RBT6 的 USART1 默認掛在 PA9/PA10CubeMX 里配成 Asynchronous波特率 115200、8-N-1。然后需要自己實現(xiàn)字符發(fā)送接口。GCC 工具鏈STM32CubeIDE 等下的實現(xiàn)#include stdio.h int __io_putchar(int ch) { uint8_t c (uint8_t)ch; HAL_UART_Transmit(huart1, c, 1, 10); return ch; } int _write(int fd, char *ptr, int len) { for (int i 0; i len; i) { if (__io_putchar((uint8_t)ptr[i]) EOF) { return i; } } return len; }_write是 syscall 的底層接口printf 最終會調用它把緩沖區(qū)逐字節(jié)發(fā)出去第四個參數(shù) 10 是超時毫秒數(shù)串口空閑時 1 字節(jié)只占不到 0.1ms10ms 足夠。Keil MDK 用戶則通常勾選 Use MicroLIB再用 fputc 實現(xiàn)同樣的邏輯這時因為全部走庫函數(shù)代碼更短。注意如果串口發(fā)送在中斷回調里調用printf超時參數(shù)很容易被拖滿進而影響實時性。串口打印適合放在主循環(huán)的狀態(tài)機里不適合壓到中斷里高頻輸出。4.4 LCD 顯示數(shù)值緩沖區(qū)大小和格式串LCD 顯示 float 類型最省事的寫法是char buf[16]; sprintf(buf, %.2fV, voltage); LCD_DisplayStringLine(Line4, buf);有兩個點都容易踩。一是緩沖區(qū)大小sprintf不檢查長度浮點加單位很容易超 12 字節(jié)要留余量二是.2f會做四舍五入如果題目要求的是“截斷到小數(shù)點后兩位”就要先用(int)(voltage * 100)拆出整數(shù)和小數(shù)再拼字符串。LCD 驅動如果是 SPI 接口刷新一次整屏要幾十毫秒全局刷新的頻率別超過 20Hz否則主循環(huán)會被拖死。5. G431RBT6 源碼燒進去之后用這 4 個檢查點驗證5.1 檢查點一時鐘樹是否真的跑在 170MHz燒錄后第一步接調試器或者用 J-Link RTT看SystemCoreClock變量。這個變量在 system_stm32g4xx.c 里維護標準值是 170000000。如果讀到的是 16000000說明.ioc里時鐘配置被改過或者SystemClock_Config()里手動設置的 PLL 參數(shù)不對直接回到第 2 章的表格重算。5.2 檢查點二串口回環(huán)測試把 USART 的 TX 和 RX 用杜邦線短接然后執(zhí)行一段回環(huán)代碼HAL_UART_Transmit(huart1, (uint8_t*)OK\r\n, 5, 100); HAL_UART_Receive(huart1, rx_byte, 1, 100);如果串口助手能收到 OK 而收不到回環(huán)數(shù)據(jù)多半是 RX 引腳映射或者中斷里沒讀RDR導致數(shù)據(jù)滯留。用邏輯分析儀抓 PA9/PA10能直接確認波形有沒有發(fā)出來比盯著串口助手猜快得多。5.3 檢查點三HAL_Delay 卡死和變量被優(yōu)化程序運行一段時間后卡死最常見兩個原因一是在中斷里調用HAL_DelaySysTick 被同級或更高優(yōu)先級中斷搶占永遠回不來二是共享變量沒加volatile主循環(huán)讀了舊值。解決方案很簡單中斷里只置標志位標志位統(tǒng)一加volatile修飾串口、ADC 這類句柄則保持 HAL 庫生成的原始類型即可。5.4 檢查點四改動最小化對比 .ioc 差異從壓縮包源碼改成自己的真題實現(xiàn)時每次改動都只動一個bsp_xxx.c文件不要順手改stm32g4xx_it.c的結構。想回顧自己改了什么直接對比.iocgit diff --no-index backup/工程.ioc 當前/工程.ioc.ioc文件是純文本Git 能直接做差異對比?？打寗优渲玫母膭颖瓤创a改動更直觀。最后一個小技巧調試 PWM 和 ADC 時保證采集端的杜邦線別超過 10cm否則引線電感會讓 ADC 讀數(shù)跳動、PWM 波形邊緣出現(xiàn)明顯振鈴。把線剪短很多“硬件問題”會直接消失。本文還有配套的精品資源點擊獲取