使用STM32庫(kù)函數(shù)的時(shí)候，你會(huì)發(fā)現(xiàn)帶參數(shù)的庫(kù)函數(shù)前面都有assert_param語(yǔ)句。

例如我們隨便看一個(gè)庫(kù)函數(shù)，如下所示：

這個(gè)函數(shù)是3.5版本庫(kù)函數(shù)stm32f10x_tim.c中的定時(shí)器復(fù)位函數(shù)。

assert_param語(yǔ)句的作用？

assert_param語(yǔ)句是用于程序開發(fā)的時(shí)候，調(diào)試用的檢測(cè)語(yǔ)句。默認(rèn)是不開啟的，你可以無(wú)視它的存在。但是，當(dāng)你在調(diào)試程序的時(shí)候，可以打開這個(gè)檢測(cè)機(jī)制，調(diào)試完了再關(guān)閉。

怎么使assert_param起作用？

查看assert_param的定義，位于stm32f10x_conf.h文件，你會(huì)發(fā)現(xiàn)它實(shí)際上是個(gè)宏，看它的條件編譯語(yǔ)句，你會(huì)發(fā)現(xiàn)，把USE_FULL_ASSERT定義后，即可打開assert_param這個(gè)參數(shù)檢測(cè)機(jī)制。USE_FULL_ASSERT這個(gè)宏定義已經(jīng)在文件中隱掉，我們把它的注釋符號(hào)去掉即可。

看上圖中第59行代碼，是個(gè)條件編譯語(yǔ)句，意思是：如果定義了USE_FULL_ASSERT，就把a(bǔ)ssert_param定義為一個(gè)三目運(yùn)算的結(jié)構(gòu)（第68行），否則（第71行），就把a(bǔ)ssert_param定義成（（void）0）（第72行）。也就是說，你只有定義了USE_FULL_ASSERT，assert_param才會(huì)起作用，這個(gè)作用就是通過一個(gè)三目運(yùn)算結(jié)構(gòu)（如下）來判斷的。關(guān)于三目運(yùn)算的基礎(chǔ)知識(shí)，請(qǐng)看http://www.rationmcu.com/clang/382.html

#defineassert_param（expr）（（expr）？（void）0:assert_failed（（uint8_t*）__FILE__，__LINE__））

assert_param語(yǔ)句的作用是檢測(cè)函數(shù)的參數(shù)是否符合該函數(shù)的要求，例如上面的函數(shù)中的參數(shù)就是TIMx，我們找到IS_TIM_ALL_PERIPH這個(gè)定義，可以看到TIMx中的x的范圍是1~17，也就是說，你要是把函數(shù)寫成TIM_DeInit（TIM1）;assert_param的結(jié)果就是（void）0，如果你把函數(shù)寫成TIM_DeInit（TIM18）;就會(huì)調(diào)用assert_failed函數(shù)。

#defineIS_TIM_ALL_PERIPH（PERIPH）（（（PERIPH）==TIM1）||\（（PERIPH）==TIM2）||\（（PERIPH）==TIM3）||\（（PERIPH）==TIM4）||\（（PERIPH）==TIM5）||\（（PERIPH）==TIM6）||\（（PERIPH）==TIM7）||\（（PERIPH）==TIM8）||\（（PERIPH）==TIM9）||\（（PERIPH）==TIM10）||\（（PERIPH）==TIM11）||\（（PERIPH）==TIM12）||\（（PERIPH）==TIM13）||\（（PERIPH）==TIM14）||\（（PERIPH）==TIM15）||\（（PERIPH）==TIM16）||\（（PERIPH）==TIM17））

assert_failed函數(shù)怎么寫？

如上，當(dāng)你定義了USE_FULL_ASSET之后，你立即編譯，編譯器會(huì)報(bào)錯(cuò)，提示assert_failed函數(shù)沒有定義。我們把a(bǔ)ssert_failed這個(gè)函數(shù)放到mian.c文件中，如下定義：

voidassert_failed（uint8_t*file，uint32_tline）{printf（“Wrongparametersvalue:file%sonline%d\r\n”，file，line）;while（1）;}

上面函數(shù)的意思就是，如果參數(shù)出錯(cuò)，輸出出錯(cuò)的文件名稱和行號(hào)。結(jié)果是輸出到串口，用串口調(diào)試助手可以看到輸出結(jié)果。注意，編譯器Build Output欄是不會(huì)報(bào)錯(cuò)的。

下面給出一個(gè)例程，故意寫錯(cuò)參數(shù)，通過STM32串口1把錯(cuò)誤參數(shù)的文件名稱和行數(shù)發(fā)到串口，你打開串口調(diào)試助手即可看到結(jié)果。