1. 從復(fù)位到main()之間芯片到底干了什么很多人第一次接觸STM32的時候注意力全放在GPIO、串口、定時器這些外設(shè)上覺得把外設(shè)玩轉(zhuǎn)了就算入門了。但真正做過幾個項目之后你會發(fā)現(xiàn)系統(tǒng)跑不起來、串口亂碼、定時器不準、功耗降不下來這些問題追到根上十有八九跟時鐘配置有關(guān)系。而時鐘配置這件事在你寫的main()函數(shù)第一行代碼執(zhí)行之前就已經(jīng)被一個叫SystemInit的函數(shù)悄悄做完了。這篇文章要聊的就是這個容易被忽略但又極其關(guān)鍵的環(huán)節(jié)。我會從啟動流程講起把SystemInit里每一段代碼的意圖拆開揉碎結(jié)合寄存器操作和實際調(diào)試經(jīng)驗讓你徹底搞清楚芯片從上電復(fù)位到進入main()之間時鐘系統(tǒng)經(jīng)歷了怎樣的變化為什么這么設(shè)計以及你在實際項目中應(yīng)該怎么改、怎么查、怎么避坑。適合的讀者是已經(jīng)能點亮LED、能跑通串口但對底層啟動流程還比較模糊的朋友。如果你還停留在“能用就行”的階段看完這篇之后至少再遇到時鐘相關(guān)的問題你知道該往哪個方向去查。先拋一個結(jié)論SystemInit不是萬能的它只是把時鐘恢復(fù)到一個“安全可用”的狀態(tài)真正適合你項目的時鐘樹需要你自己在main()里重新配。這個認知很關(guān)鍵后面會反復(fù)提到。2. 上電那一刻時鐘源到底是誰在供血2.1 復(fù)位后的默認時鐘狀態(tài)STM32復(fù)位之后時鐘系統(tǒng)并不是立刻就跑在最高頻率上的。以常見的F1系列為例復(fù)位后的默認狀態(tài)是這樣的系統(tǒng)時鐘SYSCLK默認選擇HSI內(nèi)部高速時鐘頻率為8MHzHSI的精度比較差溫漂大一般只用來做啟動階段的臨時時鐘HSE外部晶振處于關(guān)閉狀態(tài)需要軟件使能并等待穩(wěn)定PLL處于關(guān)閉狀態(tài)AHB、APB1、APB2預(yù)分頻器都是1分頻也就是不分頻這意味著什么意味著你剛上電的那一瞬間整個芯片跑在8MHz的內(nèi)部RC振蕩器上。這個頻率不高精度也一般但勝在“不需要外部器件就能起振”保證了芯片在最惡劣的硬件條件下也能先跑起來。我見過有朋友板子上的晶振虛焊了程序照樣能跑只是串口波特率怎么調(diào)都是亂碼。原因就在這里——HSI頂上來了系統(tǒng)沒死但時鐘精度不夠異步通信自然對不上。2.2 為什么要有這么一個“默認安全態(tài)”這里涉及一個設(shè)計哲學問題。芯片廠商在設(shè)計啟動流程時必須考慮一種最壞情況用戶的PCB上外部晶振沒焊、焊錯了、或者起振電容配得不對導致HSE根本起不來。如果復(fù)位后直接強制切到HSE那芯片就徹底變磚了連調(diào)試口都連不上。所以默認走HSI是一個保底策略。它保證了無論外部硬件如何芯片至少能以8MHz跑起來讓你有機會通過調(diào)試器連上去看看究竟發(fā)生了什么。提示如果你在調(diào)試時發(fā)現(xiàn)程序跑得很慢或者延時函數(shù)的時間完全不對先別懷疑代碼用示波器或者調(diào)試器的寄存器查看功能確認一下當前SYSCLK到底是多少。2.3 啟動文件里的調(diào)用鏈SystemInit的調(diào)用發(fā)生在啟動文件通常是startup_xxx.s里。在復(fù)位向量指向的Reset_Handler中大致順序是這樣的初始化棧指針調(diào)用SystemInit如果定義了的話調(diào)用__main最終進入用戶的main()這個順序很重要。也就是說SystemInit執(zhí)行的時候C運行時環(huán)境還沒有完全建立棧已經(jīng)有了但堆、全局變量初始化這些還沒做。所以SystemInit里不能依賴任何需要初始化才能使用的全局變量它必須是自包含的。這也是為什么SystemInit里的代碼風格看起來那么“裸”——直接操作寄存器不依賴任何庫的抽象層。不是不想用是那個時間點用不了。3. SystemInit內(nèi)部逐段拆解每一行都在解決什么問題3.1 函數(shù)入口與條件編譯打開標準外設(shè)庫或者HAL庫里的system_stm32fxxx.c文件你會看到SystemInit的定義。它通常被一堆條件編譯宏包裹著比如void SystemInit(void) { /* 復(fù)位RCC時鐘配置為默認復(fù)位狀態(tài) */ RCC-CR | (uint32_t)0x00000001; RCC-CFGR (uint32_t)0xF8FF0000; ... }第一行RCC-CR | 0x00000001是把HSION位置1確保內(nèi)部高速時鐘開啟。雖然復(fù)位后它默認就是開的但這里再顯式開一次屬于防御性編程——萬一在SystemInit之前有人把它關(guān)了這里能兜住。緊接著操作RCC-CFGR把MCO、PLL、SW、HPRE、PPRE1、PPRE2這些位段全部清零。這一步的目的是把時鐘配置恢復(fù)到一個已知的干凈狀態(tài)避免從bootloader跳轉(zhuǎn)過來時殘留的配置干擾。3.2 關(guān)閉HSE、CSS、PLL并清除中斷接下來的幾行RCC-CR (uint32_t)0xFEF6FFFF; RCC-CR (uint32_t)0xFFFBFFFF; RCC-CFGR (uint32_t)0xFF80FFFF;第一行關(guān)掉HSEON和CSSON第二行關(guān)掉PLLON第三行清除MCO相關(guān)的位。為什么要關(guān)掉再重新開因為如果是從bootloader跳轉(zhuǎn)過來的場景HSE可能已經(jīng)處于開啟狀態(tài)直接改配置可能會產(chǎn)生不可預(yù)期的毛刺。先關(guān)干凈再按需開啟是更穩(wěn)妥的做法。同時這幾行還清了各種就緒標志位比如HSERDY、PLLRDY等。這些標志位在后續(xù)等待穩(wěn)定的時候要用到提前清掉避免誤判。3.3 關(guān)閉所有中斷并清掛起位RCC-CIR 0x00000000;這行把RCC相關(guān)的中斷全部關(guān)掉。在時鐘還沒配置好的時候任何時鐘相關(guān)的中斷比如CSS中斷都可能帶來麻煩。先關(guān)了等系統(tǒng)穩(wěn)定了再按需開。3.4 配置向量表偏移#ifdef VECT_TAB_SRAM SCB-VTOR SRAM_BASE | VECT_TAB_OFFSET; #else SCB-VTOR FLASH_BASE | VECT_TAB_OFFSET; #endif這段代碼設(shè)置中斷向量表的基地址。默認情況下向量表在Flash起始處但如果你做了IAP升級或者把代碼搬到SRAM里跑就需要改這個偏移。VECT_TAB_OFFSET通常定義為0除非你有特殊需求。這里有個實際經(jīng)驗做bootloaderapp架構(gòu)的時候app的向量表偏移必須和它的實際存放地址一致否則中斷會跳到bootloader的向量表里去表現(xiàn)為“中斷響應(yīng)了但執(zhí)行的是錯誤的函數(shù)”。這個坑我踩過現(xiàn)象是串口接收中斷偶爾進錯函數(shù)查了很久才定位到VTOR沒設(shè)對。3.5 調(diào)用SetSysClock設(shè)置系統(tǒng)時鐘這是SystemInit里最核心的一步。在F1的庫里它會調(diào)用一個叫SetSysClock的函數(shù)而這個函數(shù)內(nèi)部又根據(jù)不同的宏定義走不同的分支static void SetSysClock(void) { #ifdef SYSCLK_FREQ_HSE SetSysClockToHSE(); #elif defined SYSCLK_FREQ_24MHz SetSysClockTo24(); #elif defined SYSCLK_FREQ_36MHz SetSysClockTo36(); #elif defined SYSCLK_FREQ_48MHz SetSysClockTo48(); #elif defined SYSCLK_FREQ_56MHz SetSysClockTo56(); #elif defined SYSCLK_FREQ_72MHz SetSysClockTo72(); #endif }默認情況下如果你沒有定義任何SYSCLK_FREQ_xxx宏這個函數(shù)什么都不做系統(tǒng)繼續(xù)跑在HSI的8MHz上。這一點很多人不知道以為SystemInit執(zhí)行完就是72MHz了其實不是。如果你在工程里定義了SYSCLK_FREQ_72MHz那么SetSysClockTo72()會被調(diào)用里面才是真正的“使能HSE、等待穩(wěn)定、配置PLL、切換SYSCLK”這一整套流程。3.6 SetSysClockTo72的完整流程以72MHz為例這個函數(shù)的執(zhí)行步驟大致如下使能HSERCC-CR | RCC_CR_HSEON等待HSERDY置位同時做超時計數(shù)超時則返回使能Flash預(yù)取緩沖FLASH-ACR | FLASH_ACR_PRFTBE設(shè)置Flash等待周期72MHz下需要2個等待周期FLASH-ACR | FLASH_ACR_LATENCY_2配置AHB、APB1、APB2預(yù)分頻AHB不分頻APB1二分頻36MHzAPB2不分頻72MHz配置PLLPLL源選HSEHSE不分頻倍頻系數(shù)9得到8MHz×972MHz使能PLLRCC-CR | RCC_CR_PLLON等待PLLRDY置位切換SYSCLK到PLLRCC-CFGR | RCC_CFGR_SW_PLL等待SWS確認切換完成每一步都有其必要性。比如Flash等待周期如果你在72MHz下不設(shè)等待周期Flash取指速度跟不上CPU會直接硬件錯誤。這個坑在超頻的時候特別常見。注意APB1的最大頻率是36MHz所以必須二分頻。如果你把APB1也設(shè)成72MHz掛在APB1上的外設(shè)比如USART2、TIM2等會工作異常甚至可能損壞。這個限制在數(shù)據(jù)手冊里有明確說明但新手很容易忽略。4. 時鐘樹不是配完就完事那些容易翻車的細節(jié)4.1 HSE起振失敗的判斷與處理SetSysClockTo72里等待HSERDY的那段代碼通常會帶一個超時計數(shù)HSEStatus 0; StartUpCounter 0; do { HSEStatus RCC-CR RCC_CR_HSERDY; StartUpCounter; } while((HSEStatus 0) (StartUpCounter ! HSE_STARTUP_TIMEOUT)); if ((RCC-CR RCC_CR_HSERDY) ! RESET) { HSEStatus (uint32_t)0x01; } else { HSEStatus (uint32_t)0x00; }如果超時了HSEStatus為0后面的PLL配置和切換就不會執(zhí)行系統(tǒng)繼續(xù)跑HSI。這個設(shè)計是合理的但問題在于它不會告訴你HSE起振失敗了。程序照樣往下跑只是頻率不對。我在實際項目中遇到過晶振負載電容選錯導致起振時間過長的情況。大部分時候能起來但偶爾超時表現(xiàn)為“有時候串口正常有時候亂碼”。后來把超時值調(diào)大并加了失敗后的LED指示才把這個問題可視化出來。所以我的建議是在SystemInit之后、main()開頭加一段檢查代碼確認當前SYSCLK源和頻率是否符合預(yù)期。如果不符合點亮一個錯誤指示燈或者打印一條日志。4.2 時鐘切換的順序不能亂切換SYSCLK源的時候必須等目標時鐘源穩(wěn)定。比如從HSI切到PLL必須先等PLLRDY置位。這個順序在代碼里是固定的但如果你自己寫時鐘配置代碼很容易漏掉等待步驟。我見過有人直接寫RCC-CFGR | RCC_CFGR_SW_PLL;然后就去配外設(shè)了結(jié)果外設(shè)時鐘還沒穩(wěn)定配置寫不進去。正確的做法是切換之后輪詢SWS位確認切換真正完成。4.3 外設(shè)時鐘使能的時機SystemInit只負責系統(tǒng)時鐘不負責外設(shè)時鐘。也就是說USART1、GPIOA、TIM1這些外設(shè)的時鐘默認都是關(guān)閉的。你需要在main()里通過RCC-APB2ENR、RCC-APB1ENR、RCC-AHBENR這些寄存器手動使能。這里有個經(jīng)驗先配時鐘再配外設(shè)。比如你要用USART1先使能USART1時鐘和對應(yīng)GPIO的時鐘然后再去配置波特率、引腳復(fù)用。順序反了的話配置可能丟失。另外APB1和APB2上掛的外設(shè)最大頻率不同配置波特率、定時器周期的時候要注意實際時鐘頻率。比如APB1是36MHz你在算USART2的波特率時就要用36MHz去算不能用72MHz。4.4 低功耗場景下的時鐘考量如果你的項目有低功耗需求SystemInit里默認開啟的那些時鐘可能都是浪費。比如你不需要USB但PLL配置里可能默認開了USB預(yù)分頻你不需要外部晶振但HSE一直在耗電。低功耗場景下通常的做法是在main()里重新配置時鐘樹關(guān)掉不用的時鐘源降低SYSCLK頻率甚至在空閑時切換到HSI并關(guān)閉PLL。這些操作SystemInit不會幫你做需要你自己根據(jù)項目需求來定制。5. 自己動手改時鐘從72MHz到其他頻率的實操5.1 修改系統(tǒng)頻率的兩種方式第一種方式是改宏定義。在工程選項里定義SYSCLK_FREQ_48MHz重新編譯SystemInit就會走48MHz的配置分支。這種方式簡單但不夠靈活而且?guī)炖锏姆种枪潭ǖ膸讉€頻率不能任意指定。第二種方式是自己寫時鐘配置函數(shù)在main()開頭調(diào)用。這種方式靈活可以配任意頻率但需要你對時鐘樹有清晰的理解。我一般推薦第二種因為實際項目里經(jīng)常需要非標準頻率比如為了降低功耗跑24MHz或者為了特定外設(shè)跑56MHz。庫里的固定分支不夠用。5.2 手寫時鐘配置的模板下面是一個基于F1系列、目標頻率為48MHz的配置示例假設(shè)外部晶振是8MHzvoid Clock_Init_48MHz(void) { // 1. 使能HSE RCC-CR | RCC_CR_HSEON; while(!(RCC-CR RCC_CR_HSERDY)); // 2. 配置Flash等待周期48MHz需要1個等待周期 FLASH-ACR ~FLASH_ACR_LATENCY; FLASH-ACR | FLASH_ACR_LATENCY_1; FLASH-ACR | FLASH_ACR_PRFTBE; // 3. 配置預(yù)分頻 RCC-CFGR ~(RCC_CFGR_HPRE | RCC_CFGR_PPRE1 | RCC_CFGR_PPRE2); RCC-CFGR | RCC_CFGR_HPRE_DIV1; // AHB 48MHz RCC-CFGR | RCC_CFGR_PPRE1_DIV2; // APB1 24MHz RCC-CFGR | RCC_CFGR_PPRE2_DIV1; // APB2 48MHz // 4. 配置PLLHSE不分頻倍頻6得到48MHz RCC-CFGR ~(RCC_CFGR_PLLSRC | RCC_CFGR_PLLXTPRE | RCC_CFGR_PLLMULL); RCC-CFGR | RCC_CFGR_PLLSRC; // PLL源選HSE RCC-CFGR | RCC_CFGR_PLLMULL6; // 8MHz * 6 48MHz // 5. 使能PLL并等待穩(wěn)定 RCC-CR | RCC_CR_PLLON; while(!(RCC-CR RCC_CR_PLLRDY)); // 6. 切換SYSCLK到PLL RCC-CFGR ~RCC_CFGR_SW; RCC-CFGR | RCC_CFGR_SW_PLL; while((RCC-CFGR RCC_CFGR_SWS) ! RCC_CFGR_SWS_PLL); }這段代碼可以直接抄改一下倍頻系數(shù)和預(yù)分頻就能得到不同頻率。但有幾個點要注意Flash等待周期必須和頻率匹配具體對應(yīng)關(guān)系查數(shù)據(jù)手冊APB1不能超過36MHzAPB2不能超過72MHzF1系列PLL倍頻系數(shù)有范圍限制一般是2到16切換完成后要確認SWS位不能只看SW位5.3 驗證時鐘配置是否正確配置完之后怎么確認三種方法第一種用調(diào)試器查看RCC-CFGR寄存器的SWS位確認當前SYSCLK源。再結(jié)合PLL配置反推頻率。第二種用MCO引腳輸出時鐘接示波器或者頻率計測量。MCO可以輸出SYSCLK、HSI、HSE、PLL二分頻等具體看RCC-CFGR的MCO位配置。第三種用定時器做一個精確的1秒延時翻轉(zhuǎn)一個GPIO用示波器看周期。這個方法最直觀也最能反映實際運行頻率。我通常用第三種因為不需要額外配置MCO引腳而且能同時驗證定時器時鐘是否正確。6. 調(diào)試時鐘問題時我是怎么一步步定位的6.1 串口亂碼先查時鐘再查波特率串口亂碼是最常見的時鐘問題表現(xiàn)。排查順序應(yīng)該是確認SYSCLK實際頻率用上面說的方法確認USART掛在哪條總線上對應(yīng)時鐘頻率是多少用實際頻率重新計算波特率寄存器值檢查GPIO復(fù)用配置是否正確很多人一上來就改波特率改來改去都不對就是因為沒搞清楚實際時鐘頻率。如果SYSCLK是HSI的8MHz而不是預(yù)期的72MHz那你按72MHz算出來的波特率值肯定不對。6.2 定時器周期不對注意APB預(yù)分頻的倍頻效應(yīng)這里有個容易混淆的點當APB預(yù)分頻不為1時定時器時鐘會是APB時鐘的2倍。比如APB1是36MHz那么掛在APB1上的定時器實際時鐘是72MHz。這個倍頻效應(yīng)在參考手冊里有說明但很容易被忽略。所以你在算定時器周期的時候要先確認定時器時鐘到底是APB頻率還是APB頻率的2倍。搞錯了的話定時時間會差一倍。6.3 程序跑飛檢查Flash等待周期如果你提高了SYSCLK頻率但沒有相應(yīng)調(diào)整Flash等待周期程序會在某個時刻突然跑飛表現(xiàn)為HardFault或者直接死機。這種問題在低頻率下不會出現(xiàn)一旦超頻就必現(xiàn)。排查方法是確認FLASH-ACR的Latency位和當前頻率匹配。F1系列在48MHz以下需要1個等待周期48到72MHz需要2個。具體查數(shù)據(jù)手冊的“Flash memory access time”章節(jié)。6.4 外設(shè)不工作確認時鐘使能位有時候代碼邏輯沒問題但外設(shè)就是不工作。這時候先查RCC-APB1ENR、RCC-APB2ENR、RCC-AHBENR里對應(yīng)的使能位有沒有置1。我遇到過好幾次是因為復(fù)制代碼時漏了使能時鐘查了半天邏輯最后發(fā)現(xiàn)是時鐘沒開。提示可以在main()開頭加一段代碼把所有可能用到的外設(shè)時鐘都使能一遍雖然浪費一點功耗但能避免很多“莫名其妙不工作”的問題。等調(diào)試穩(wěn)定了再按需精簡。7. 關(guān)于SystemInit我踩過的幾個印象深刻的坑第一個坑是向量表偏移。做IAP升級的時候app的SystemInit里VECT_TAB_OFFSET沒改導致中斷向量表指向了bootloader的區(qū)域?，F(xiàn)象是app能跑但所有中斷都進不去或者進錯函數(shù)。后來在app的工程選項里把偏移改成app的起始地址問題解決。第二個坑是HSE起振時間。有一批板子用的晶振負載電容偏大起振時間比正常情況長很多。SystemInit里的超時計數(shù)不夠?qū)е屡紶柷胁坏紿SE系統(tǒng)跑在HSI上。表現(xiàn)是“十次上電有兩次串口亂碼”。后來把超時值調(diào)大并在起振失敗時點亮錯誤燈才徹底解決。第三個坑是APB1超頻。有一次為了追求性能把APB1也設(shè)成了72MHz結(jié)果掛在上面的I2C工作異常讀出來的數(shù)據(jù)全是0xFF。查了手冊才發(fā)現(xiàn)APB1最大36MHz。改回二分頻后正常。第四個坑是Flash等待周期。在72MHz下忘了設(shè)Latency程序跑幾秒鐘就HardFault。加上之后穩(wěn)定運行。這個問題的隱蔽性在于它不是立刻出錯而是運行一段時間后才崩很容易誤以為是內(nèi)存溢出或者堆棧問題。這些坑的共同點是它們都不會在編譯時報錯甚至不會在啟動時立刻出錯而是在特定條件下才暴露出來。所以對時鐘系統(tǒng)的理解不能停留在“能跑就行”要知道每一行配置背后的約束條件。8. 給不同階段讀者的實操建議如果你剛開始學STM32我的建議是先不要動SystemInit用庫里的默認配置把外設(shè)都玩一遍。等你對GPIO、串口、定時器、中斷都有了直觀感受之后再回過頭來看時鐘系統(tǒng)這時候你會有“原來如此”的感覺。如果你已經(jīng)有一定基礎(chǔ)正在做實際項目建議你養(yǎng)成一個習慣在main()開頭加一段時鐘自檢代碼確認SYSCLK頻率、各總線頻率、外設(shè)時鐘使能狀態(tài)都符合預(yù)期。這段代碼在調(diào)試階段能幫你省下大量時間。如果你在做低功耗項目那SystemInit里的默認配置基本都要推翻重來。你需要根據(jù)項目的最低功耗需求重新設(shè)計時鐘樹關(guān)掉所有不必要的時鐘源在運行和休眠之間做精細的切換。最后說一個我個人的習慣每次新建工程我都會在main()里先寫一個Clock_Verify()函數(shù)把當前時鐘配置打印出來或者用LED指示。這個習慣幫我避免了很多“以為配好了其實沒配好”的問題。時鐘是系統(tǒng)的脈搏脈搏不對后面全是白費功夫。