關(guān)鍵字：回調(diào)函數(shù)，HAL庫

目錄預(yù)覽

1.回調(diào)函數(shù)

2.STM32固件庫里的回調(diào)函數(shù)

3.STM32庫函數(shù)里的回調(diào)機(jī)制及觸發(fā)事件

4.常見問題

01 回調(diào)函數(shù)

有人對STM32固件庫里的回調(diào)函數(shù)有些好奇甚至糾結(jié)，這里簡單地介紹下，以供參考。其實(shí)從用法及功能上講他們并沒有什么特別的，跟其他函數(shù)一樣，也是實(shí)現(xiàn)特定功能的代碼段。一般來講，所謂回調(diào)函數(shù)，泛指基于事件觸發(fā)而被調(diào)用執(zhí)行的函數(shù)，簡單點(diǎn)說，就是條件滿足了就調(diào)用的函數(shù)，往往會跟函數(shù)指針結(jié)合起來通過函數(shù)指針實(shí)現(xiàn)調(diào)用。

經(jīng)常會有人基于類似下面的代碼介紹回調(diào)函數(shù)：

在上面代碼中，那四個有關(guān)加減乘除的函數(shù)可以看成回調(diào)函數(shù)，具體何時被調(diào)用，根據(jù)函數(shù)Compute(float a,float b,float(*Action)(float a,float b))里的函數(shù)指針的賦值情況來定，被賦予哪個回調(diào)函數(shù)的地址就調(diào)用哪個回調(diào)函數(shù)。當(dāng)然，使用函數(shù)指針并不是回調(diào)函數(shù)的核心特征，因事件驅(qū)動而被調(diào)用才是其核心特征。

生活中我們有時會對某人說，回頭再談、回頭再聊。潛臺詞往往就是等時機(jī)成熟了、條件滿足了再來具體交涉。這里就充滿著濃濃的回調(diào)意味。

回調(diào)函數(shù)可以理解為事件響應(yīng)函數(shù)或者說事件驅(qū)動函數(shù)。即使相同的事件、基于不同的場景可能會有不同應(yīng)對處理，從軟件代碼角度講就對應(yīng)不同的回調(diào)函數(shù)代碼。

我們不妨看個生活中的例子。生活中有人中了六合彩了，針對這一事件，中獎人可能有下面諸多舉動之一【這里簡化下，多選一】。但這件事發(fā)生在不同人身上，右邊的選擇很可能不盡一樣。換言之，中獎了，到底會選擇右邊哪一項(xiàng)還得結(jié)合具體的人來定。

圖1 中六合彩的可能后續(xù)行為

我們再切換到STM32的嵌入式開發(fā)中來，以UART接收完成事件為例。針對這一事件，不同的應(yīng)用場景的應(yīng)對處理往往也是五花八門、五彩繽紛。

圖2 UART接收完成后可能后續(xù)動作

顯然，特定的應(yīng)用場景對應(yīng)著特定的回調(diào)函數(shù)，一般來講，沒法簡單地僅僅基于事件就擬定一段既能適用于各種場景而又富有針對性的代碼。

結(jié)合上面的描述，稍微小結(jié)下。回調(diào)函數(shù)除了具有基于事件的觸發(fā)而被調(diào)用執(zhí)行的特征外，還具有相同事件因應(yīng)不同應(yīng)用場景可能需要不同的回調(diào)函數(shù)之特征，即基于特定應(yīng)用場景的回調(diào)函數(shù)其內(nèi)容具有特定性。

02

STM32固件庫里的回調(diào)函數(shù)

說到這里，我們具體結(jié)合STM32外設(shè)固件庫里回調(diào)函數(shù)來聊聊。

首先，作為一個函數(shù)庫，除了個別初始化函數(shù)外，里面不存在現(xiàn)存的完整的回調(diào)函數(shù)。結(jié)合前面的介紹，我們知道回調(diào)函數(shù)需要結(jié)合具體場景而擬定，作為函數(shù)庫根本做不到這一點(diǎn)，它沒法事先知曉發(fā)生某個事件時不同的應(yīng)用會需要采取怎樣的操作。

其次，STM32庫函數(shù)的確采用了回調(diào)機(jī)制，并基于可能的各種事件為STM32開發(fā)者預(yù)留了只有函數(shù)定義而無具體內(nèi)容的空回調(diào)函數(shù)，或者是只定義了一些基于各類事件的函數(shù)指針，具體的回調(diào)函數(shù)需要用戶完成并將函數(shù)地址賦給相應(yīng)的函數(shù)指針而被調(diào)用。簡單點(diǎn)說，函數(shù)庫給我們事先預(yù)留了眾多的回調(diào)函數(shù)接口。

STM32固件庫里的回調(diào)函數(shù)采用了兩種調(diào)用方式：

第一種是legacy方式，傳統(tǒng)的回調(diào)方式，庫以weak方式定義了各種空的回調(diào)函數(shù)，像下面這些。STM32庫里都給我們準(zhǔn)備好了。【下面是有關(guān)UART部分事件的弱回調(diào)函數(shù)體，內(nèi)容為空】

圖3 UART傳輸事件相關(guān)弱回調(diào)函數(shù)定義

具體開發(fā)時，我們根據(jù)事件和應(yīng)用場景基于類似上面的weak函數(shù)進(jìn)行重寫，重寫時拿掉weak，庫里預(yù)留的弱定義函數(shù)盡量不用動它。比方像下面這些都是最終的用戶回調(diào)函數(shù)。

圖4 UART傳輸事件相關(guān)的用戶回調(diào)函數(shù)

另外一種就是指針方式，或稱注冊方式。即函數(shù)庫里事先基于各類事件定義好了各種回調(diào)函數(shù)指針，具體的回調(diào)函數(shù)由用戶基于不同事件和應(yīng)用需求撰寫，然后將函數(shù)地址賦給函數(shù)指針，這個動作我們稱之為回調(diào)函數(shù)進(jìn)行注冊，之后回調(diào)函數(shù)就可以通過函數(shù)指針而被適時調(diào)用。

比方下面是UART外設(shè)里定義的一些函數(shù)指針：【星號所指的是與UART傳輸完成事件有關(guān)的回調(diào)函數(shù)所用的指針】

圖5 UART傳輸事件相關(guān)的回調(diào)函數(shù)指針

當(dāng)我們將回調(diào)函數(shù)寫好后，將函數(shù)地址賦給函數(shù)指針即可在相應(yīng)事件發(fā)生時被調(diào)用。比方類似下面的操作代碼。紅星標(biāo)所指代碼就是在做回調(diào)函數(shù)的注冊。

圖6 UART傳輸完成事件用戶回調(diào)函數(shù)及注冊

給函數(shù)指針賦地址可以直接賦地址或通過調(diào)用庫函數(shù)xxx_RegisterCallback完成【見上圖星標(biāo)代碼】。

這種指針方式需要我們對C語言中的結(jié)構(gòu)體、函數(shù)指針有相應(yīng)的了解，庫只是給我們提供了相應(yīng)的函數(shù)指針，具體的用戶回調(diào)函數(shù)由用戶根據(jù)需要來編寫，將其地址賦給相應(yīng)的函數(shù)指針以供調(diào)用。

而前面介紹的傳統(tǒng)型回調(diào)函數(shù)，庫則幫我們把可能涉及到的回調(diào)函數(shù)全部以弱定義的方式都準(zhǔn)備好了，我們按需針對性選用，去掉weak填空重寫。使用起來相對更直觀些，無需我們對函數(shù)指針有太多了解。

目前STM32庫回調(diào)機(jī)制中，作為用戶到底使用上面的哪種回調(diào)方式呢？在每個系列的固件庫的配置頭文件中有針對各個外設(shè)事件回調(diào)函數(shù)使用方式的選擇，比方以STM32F4系列為例，這里有個stm32f4xx_hal_conf.h的頭文件，我們可以看到基于各個外設(shè)事件回調(diào)函數(shù)使用方式選擇的宏。

圖7 回調(diào)函數(shù)調(diào)用方式的選擇配置

若我們不對該頭文件的相應(yīng)外設(shè)事件的回調(diào)函數(shù)調(diào)用方式的宏定義做調(diào)整，則默認(rèn)傳統(tǒng)回調(diào)方式，即legacy方式，非指針方式。若將相應(yīng)的宏值改為1，則該外設(shè)事件相關(guān)回調(diào)函數(shù)采用指針注冊方式。

03 STM32庫函數(shù)里的回調(diào)機(jī)制及觸發(fā)事件

整體上講，STM32外設(shè)庫里的API函數(shù)大體由三部分組成，分別是：

初始化函數(shù)

啟動型執(zhí)行函數(shù)

回調(diào)函數(shù)【弱定義函數(shù)或回調(diào)函數(shù)指針，最終靠用戶具體完成編寫】

這樣的安排，讓整個工程代碼結(jié)構(gòu)比較清晰，可以讓人快速了解庫結(jié)構(gòu)，同時現(xiàn)存的API函數(shù)大大減少開發(fā)工作量，預(yù)留的回調(diào)函數(shù)接口一方面給開發(fā)者提供了便利，另一方面讓用戶基于不同應(yīng)用場景自由組織代碼而又不破壞整個軟件架構(gòu)。

對于回調(diào)函數(shù)，可以由哪些事件觸發(fā)呢？大致分三類，分別是外設(shè)初始化操作、外設(shè)處理完成【中斷】事件、外設(shè)出錯【中斷】事件。我們關(guān)注最多是外設(shè)處理完成中斷事件相關(guān)的回調(diào)函數(shù)。

圖8 回調(diào)函數(shù)觸發(fā)事件的分類

04 常見問題

4.1 STM32庫函數(shù)里的回調(diào)函數(shù)是什么，有何用？

回調(diào)函數(shù)終究乃用戶所編寫，是用戶基于特定事件和應(yīng)用需求而編寫的功能模塊，與其他函數(shù)并無本質(zhì)區(qū)別。形式上講，STM32庫預(yù)先為用戶做了回調(diào)函數(shù)的弱定義或基于事件的函數(shù)指針的定義。因基于特定條件發(fā)生后被調(diào)用執(zhí)行而被冠以回調(diào)稱號。

嚴(yán)格來講，庫函數(shù)里沒有完整的回調(diào)函數(shù)，只有基于各類事件的弱定義的不具備實(shí)際功能的空回調(diào)函數(shù)，或者是針對各類事件而定義的各種用于調(diào)用回調(diào)函數(shù)的函數(shù)指針。我們的程序監(jiān)測相應(yīng)條件或事件往往是有的放矢，當(dāng)相應(yīng)事件出現(xiàn)時我們需要做相應(yīng)的處理，這正是回調(diào)函數(shù)要實(shí)現(xiàn)的功能，也是其功用所在。

4.2 STM32工程里的回調(diào)函數(shù)與中斷函數(shù)有什么區(qū)別？

STM32外設(shè)庫里的回調(diào)函數(shù)的確多數(shù)時候跟中斷事件及中斷服務(wù)程序息息相關(guān)，往往在中斷服務(wù)程序中基于特定事件調(diào)用相應(yīng)的用戶回調(diào)函數(shù)。很多時候，我們完全可以將用戶回調(diào)函數(shù)看成中斷函數(shù)的一個調(diào)用模塊或延伸。

一個中斷服務(wù)程序里可以因不同事件而調(diào)用不同的回調(diào)函數(shù)，即一個中斷服務(wù)程序里可能包含多個不同的回調(diào)函數(shù)。比方，我們在定時器中斷服務(wù)程序里可以涉及多個事件及相應(yīng)的用戶回調(diào)函數(shù)，定時器中斷服務(wù)程序可能涉及更新事件、不同通道的比較事件或捕獲事件，相應(yīng)的用戶回調(diào)函數(shù)往往因應(yīng)用場景而異。

當(dāng)然，回調(diào)函數(shù)的調(diào)用還可以是中斷事件以外的其他事件觸發(fā)調(diào)用，比方可以基于初始化操作來調(diào)用相應(yīng)初始化回調(diào)函數(shù)。當(dāng)然，在庫里對某個外設(shè)的初始化可能有些默認(rèn)操作，但這個默認(rèn)操作很難是放之四海而皆準(zhǔn)的操作，這時我們就得根據(jù)實(shí)際應(yīng)用針對性編寫初始化代碼，即初始化型回調(diào)函數(shù)。

4.3 STM32庫函數(shù)里的回調(diào)函數(shù)是否可以不用？

STM32庫函數(shù)里的回調(diào)機(jī)制是庫設(shè)計者為了便于軟件框架清晰、減少開發(fā)者工作量等因素事先準(zhǔn)備的函數(shù)聲明及接口，用戶使用時只需根據(jù)具體應(yīng)用編寫相關(guān)函數(shù)體。當(dāng)然，你如果不想理睬這些回調(diào)函數(shù)聲明及定義也是可以的，你根據(jù)具體應(yīng)用自行組織代碼完全可行。

4.4 STM32庫函數(shù)里似乎存在著類似半成品的庫回調(diào)函數(shù)？

STM32庫函數(shù)里的確準(zhǔn)備了一些包含用戶回調(diào)函數(shù)的由庫定義的回調(diào)函數(shù)，是庫設(shè)計者基于各類特定事件而準(zhǔn)備的回調(diào)函數(shù)，它會針對特定事件做一些基本而必要的操作，比方狀態(tài)的檢查、標(biāo)志監(jiān)測及清除，但它沒有辦法徹底寫完整，因?yàn)樗鼰o法知道該事件發(fā)生后用戶的真實(shí)需求是什么，該如何操作，所以它終究還是需要調(diào)用真正的用戶回調(diào)函數(shù)。這樣做的目的還是為了給開發(fā)者減少開發(fā)工作量、以及減少出錯等。

我們不妨具體看個實(shí)例。下面的回調(diào)函數(shù)采樣的指針注冊方式，我們看看UART的DMA傳輸完成中斷里傳輸完成的回調(diào)函數(shù)的調(diào)用過程。

首先，在UART的DMA啟動函數(shù)HAL_UART_Transmit_ DMA()里有這樣一部分內(nèi)容：

圖9 外設(shè)啟動運(yùn)行代碼中庫回調(diào)函數(shù)的賦值

庫里就DMA傳輸事件準(zhǔn)備了幾個回調(diào)函數(shù)【傳輸完成、半完成、出錯】，即上圖中紅線標(biāo)示出來的。其實(shí)這幾個回調(diào)函數(shù)還不算完整的用戶回調(diào)函數(shù)，是庫定義的并會做一些在它看來用戶必定需要完成的一些操作，它事先幫助完成，之后才調(diào)用最終的用戶回調(diào)函數(shù)。我們以傳輸完成事件為例來看看，上圖星號所標(biāo)的函數(shù)。

圖10 庫回調(diào)函數(shù)進(jìn)一步調(diào)回用戶回調(diào)函數(shù)

在這個庫定義的UART_DMATransmitCplt()函數(shù)里，它對DMA的傳輸模式做了判斷，如果是Normal模式，就將UART的傳輸數(shù)據(jù)長度設(shè)置為0，禁止DMA后續(xù)傳輸功能，使能UART傳輸完成中斷的使能。然后才來調(diào)用用戶回調(diào)函數(shù)【上圖中箭頭所指】。如果DMA工作在循環(huán)模式，代碼進(jìn)到UART_DMATransmitCplt()函數(shù)后就直接調(diào)用最終的用戶回調(diào)函數(shù)。也就說這些庫定義的回調(diào)函數(shù)在用戶回調(diào)函數(shù)的基礎(chǔ)上做了些必要操作，用戶回調(diào)函數(shù)可以看成這類庫回調(diào)函數(shù)的子集。

4.5 基于STM32庫來組織用戶回調(diào)函數(shù)要注意什么？

前面提過了，用戶回調(diào)函數(shù)主要基于初始化事件或中斷事件而組織的代碼。那些中斷事件的回調(diào)函數(shù)的調(diào)用基本都是在中斷服務(wù)程序里發(fā)生的。所以，我們在編寫回調(diào)函數(shù)時要結(jié)合具體情況靈活地組織代碼。要考慮中斷優(yōu)先級、具體事件響應(yīng)的實(shí)時性等。具體點(diǎn)說，我們在組織回調(diào)函數(shù)時，要考慮是否一定要一股腦地全寫在中斷服務(wù)程序里，會不會影響別的中斷響應(yīng)。對于有些不緊急而又耗時的事件響應(yīng)代碼，可以考慮只在回調(diào)函數(shù)里設(shè)置相應(yīng)標(biāo)志，真正的處理代碼放到主循環(huán)去完成。

還提醒一點(diǎn)，STM32庫設(shè)計者主動給我們準(zhǔn)備了弱定義回調(diào)函數(shù)或基于各個事件的回調(diào)函數(shù)指針，盡管很豐富了，但未必能包羅萬象，必要時我們可能還得根據(jù)具體情況來額外組織些類似回調(diào)函數(shù)的事件/中斷響應(yīng)代碼。

關(guān)于STM32 HAL庫里的回調(diào)函數(shù)就簡單介紹到這里，希望能幫到一些STM32開發(fā)者。

完整內(nèi)容請點(diǎn)擊“閱讀原文”下載原文檔。

訂閱號

關(guān)注STM32

視頻號

B站賬號

▽點(diǎn)擊“閱讀原文”，可下載原文檔