在STM32的固件庫和提供的例程中，到處都可以見到assert_param()的使用。如果打開任何一個例程中的stm32f10x_conf.h文件，就可以看到實際上assert_param是一個宏定義；在固件庫中，它的作用就是檢測傳遞給函數的參數是否是有效的參數。所謂有效的參數是指滿足規定范圍的參數，比如某個參數的取值范圍只能是小于3的正整數，如果給出的參數大于3，則這個assert_param()可以在運行的程序調用到這個函數時報告錯誤，使程序員可以及時發現錯誤，而不必等到程序運行結果的錯誤而大費周折。
這是一種常見的軟件技術，可以在調試階段幫助程序員快速地排除那些明顯的錯誤。
它確實在程序的運行上犧牲了效率(但只是在調試階段)，但在項目的開發上卻幫助你提高了效率。
當你的項目開發成功，使用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));
。。。
在執行assert_param()的檢驗時，如果發現參數出錯，它會調用函數assert_failed()向程序員報告錯誤，在任何一個例程中的main.c中都有這個函數的模板，如下：
void assert_failed(uint8_t* file, uint32_t line)
{
while (1)
{}
}
你可以按照自己使用的環境需求，添加適當的語句輸出錯誤的信息提示，或修改這個函數做出適當的錯誤處理。
1、STM32F10xD.LIB是DEBUG模式的庫庫文件。
2、STM32F10xR.LIB是Release模式的庫庫文件。
3、要選擇DEBUG和RELEASE模式，需要修改stm32f10x_conf.h的內容。
#define DEBUG 表示DEBUG模式，把該語句注釋掉，則為RELEASE模式。
4、要選擇DEBUG和RELEASE模式，也可以在Options,C/C++,Define里填入DEBUG的預定義。
這樣，就不需要修改stm32f10x_conf.h的內容。
5、如果把庫加入項目，則不需要將ST的庫源文件加入項目，比較方便。
但是，庫的選擇要和DEBUG預定義對應。
posted on 2012-05-31 16:53
鷹空獨舞 閱讀(23919)
評論(1) 編輯 收藏 所屬分類:
STM32