專注電子技術(shù)學(xué)習(xí)與研究
當(dāng)前位置:單片機教程網(wǎng) >> STM32 >> 瀏覽文章

STM32中assert_param的使用

作者:小鄧   來源:會員上傳   點擊數(shù):  更新時間:2014年05月19日   【字體:

 

 
 在STM32的固件庫和提供的例程中,到處都可以見到assert_param()的使用。如果打開任何一個例程中的stm32f10x_conf.h文件,就可以看到實際上assert_param是一個宏定義;
在固件庫中,它的作用就是檢測傳遞給函數(shù)的參數(shù)是否是有效的參數(shù)。
所謂有效的參數(shù)是指滿足規(guī)定范圍的參數(shù),比如某個參數(shù)的取值范圍只能是小于3的正整數(shù),如果給出的參數(shù)大于3,
則這個assert_param()可以在運行的程序調(diào)用到這個函數(shù)時報告錯誤,使程序員可以及時發(fā)現(xiàn)錯誤,而不必等到程序運行結(jié)果的錯誤而大費周折。
 
這是一種常見的軟件技術(shù),可以在調(diào)試階段幫助程序員快速地排除那些明顯的錯誤。
 
它確實在程序的運行上犧牲了效率(但只是在調(diào)試階段),但在項目的開發(fā)上卻幫助你提高了效率。
 
當(dāng)你的項目開發(fā)成功,使用release模式編譯之后,或在stm32f10x_conf.h文件中注釋掉對USE_FULL_ASSERT的宏定義,所有的assert_param()檢驗都消失了,不會影響最終程序的運行效率。
 
#define assert_param(expr) ((expr) ? (void)0 : assert_failed((u8 *)__FILE__, __LINE__))
。。。
 
assert_param(IS_ADC_ALL_PERIPH(ADCx));
。。。
 
在執(zhí)行assert_param()的檢驗時,如果發(fā)現(xiàn)參數(shù)出錯,它會調(diào)用函數(shù)assert_failed()向程序員報告錯誤,在任何一個例程中的main.c中都有這個函數(shù)的模板,如下:
 
void assert_failed(uint8_t* file, uint32_t line)
{
 
 
while (1)
{}
}
 
你可以按照自己使用的環(huán)境需求,添加適當(dāng)?shù)恼Z句輸出錯誤的信息提示,或修改這個函數(shù)做出適當(dāng)?shù)腻e誤處理。
 
關(guān)閉窗口

相關(guān)文章