在STM32的固件庫(kù)和提供的例程中，到處都可以見(jiàn)到assert_param()的使用。如果打開(kāi)任何一個(gè)例程中的stm32f10x_conf.h文件，就可以看到實(shí)際上assert_param是一個(gè)宏定義；在固件庫(kù)中，它的作用就是檢測(cè)傳遞給函數(shù)的參數(shù)是否是有效的參數(shù)。所謂有效的參數(shù)是指滿足規(guī)定范圍的參數(shù)，比如某個(gè)參數(shù)的取值范圍只能是小于3的正整數(shù)，如果給出的參數(shù)大于3，則這個(gè)assert_param()可以在運(yùn)行的程序調(diào)用到這個(gè)函數(shù)時(shí)報(bào)告錯(cuò)誤，使程序員可以及時(shí)發(fā)現(xiàn)錯(cuò)誤，而不必等到程序運(yùn)行結(jié)果的錯(cuò)誤而大費(fèi)周折。
這是一種常見(jiàn)的軟件技術(shù)，可以在調(diào)試階段幫助程序員快速地排除那些明顯的錯(cuò)誤。
它確實(shí)在程序的運(yùn)行上犧牲了效率(但只是在調(diào)試階段)，但在項(xiàng)目的開(kāi)發(fā)上卻幫助你提高了效率。
當(dāng)你的項(xiàng)目開(kāi)發(fā)成功，使用release模式編譯之后，或在stm32f10x_conf.h文件中注釋掉對(duì)USE_FULL_ASSERT的宏定義，所有的assert_param()檢驗(yàn)都消失了，不會(huì)影響最終程序的運(yùn)行效率。
#define assert_param(expr) ((expr) ? (void)0 : assert_failed((u8 *)__FILE__, __LINE__))
。。。
assert_param(IS_ADC_ALL_PERIPH(ADCx));
。。。
在執(zhí)行assert_param()的檢驗(yàn)時(shí)，如果發(fā)現(xiàn)參數(shù)出錯(cuò)，它會(huì)調(diào)用函數(shù)assert_failed()向程序員報(bào)告錯(cuò)誤，在任何一個(gè)例程中的main.c中都有這個(gè)函數(shù)的模板，如下：
void assert_failed(uint8_t* file, uint32_t line)
{
while (1)
{}
}
你可以按照自己使用的環(huán)境需求，添加適當(dāng)?shù)恼Z(yǔ)句輸出錯(cuò)誤的信息提示，或修改這個(gè)函數(shù)做出適當(dāng)?shù)腻e(cuò)誤處理。
1、STM32F10xD.LIB是DEBUG模式的庫(kù)庫(kù)文件。
2、STM32F10xR.LIB是Release模式的庫(kù)庫(kù)文件。
3、要選擇DEBUG和RELEASE模式，需要修改stm32f10x_conf.h的內(nèi)容。
#define DEBUG 表示DEBUG模式，把該語(yǔ)句注釋掉，則為RELEASE模式。
4、要選擇DEBUG和RELEASE模式，也可以在Options,C/C++,Define里填入DEBUG的預(yù)定義。
這樣，就不需要修改stm32f10x_conf.h的內(nèi)容。
5、如果把庫(kù)加入項(xiàng)目，則不需要將ST的庫(kù)源文件加入項(xiàng)目，比較方便。
但是，庫(kù)的選擇要和DEBUG預(yù)定義對(duì)應(yīng)。
posted on 2012-05-31 16:53
鷹空獨(dú)舞 閱讀(23918)
評(píng)論(1) 編輯 收藏 所屬分類:
STM32