新聞中心

STM32中assert_param的使用

作者: 時(shí)間:2016-11-28 來源:網(wǎng)絡(luò) 收藏
STM32的固件庫和提供的例程中,到處都可以見到assert_param()的使用。如果打開任何一個例程中的stm32f10x_conf.h文件,就可以看到實(shí)際上assert_param是一個宏定義;
在固件庫中,它的作用就是檢測傳遞給函數(shù)的參數(shù)是否是有效的參數(shù)。所謂有效的參數(shù)是指滿足規(guī)定范圍的參數(shù),比如某個參數(shù)的取值范圍只能是小于3的正整數(shù),如果給出的參數(shù)大于3,則這個assert_param()可以在運(yùn)行的程序調(diào)用到這個函數(shù)時(shí)報(bào)告錯誤,使程序員可以及時(shí)發(fā)現(xiàn)錯誤,而不必等到程序運(yùn)行結(jié)果的錯誤而大費(fèi)周折。

這是一種常見的軟件技術(shù),可以在調(diào)試階段幫助程序員快速地排除那些明顯的錯誤。它確實(shí)在程序的運(yùn)行上犧牲了效率(但只是在調(diào)試階段),但在項(xiàng)目的開發(fā)上卻幫助你提高了效率。

本文引用地址:http://butianyuan.cn/article/201611/322866.htm

當(dāng)你的項(xiàng)目開發(fā)成功,使用release模式編譯之后,或在stm32f10x_conf.h文件中注釋掉對USE_FULL_ASSERT的宏定義,所有的assert_param()檢驗(yàn)都消失了,不會影響最終程序的運(yùn)行效率。

#ifdefUSE_FULL_ASSERT


#define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))

void assert_failed(uint8_t* file, uint32_t line);
#else
#define assert_param(expr) ((void)0)
#endif

...

在執(zhí)行assert_param()的檢驗(yàn)時(shí),如果發(fā)現(xiàn)參數(shù)出錯,它會調(diào)用函數(shù)assert_failed()向程序員報(bào)告錯誤,在任何一個例程中的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誤處理。

1、STM32F10xD.LIB是DEBUG模式的庫庫文件。
2、STM32F10xR.LIB是Release模式的庫庫文件。
3、要選擇DEBUG和RELEASE模式,需要修改stm32f10x_conf.h的內(nèi)容。
#define DEBUG 表示DEBUG模式,把該語句注釋掉,則為RELEASE模式。
4、要選擇DEBUG和RELEASE模式,也可以在Options,C/C++,Define里填入DEBUG的預(yù)定義。
這樣,就不需要修改stm32f10x_conf.h的內(nèi)容。
5、如果把庫加入項(xiàng)目,則不需要將ST的庫源文件加入項(xiàng)目,比較方便。
但是,庫的選擇要和DEBUG預(yù)定義對應(yīng)。



關(guān)鍵詞: STM32assert_para

評論


技術(shù)專區(qū)

關(guān)閉