標題: 如何使用assert_param [打印本頁]
作者: hongniu    時間: 2015-6-24 18:42
標題: 如何使用assert_param
在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ā)上卻幫助你提高了效率。

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



--------------------------------------------------------------------------------


在執(zhí)行assert_param()的檢驗時，如果發(fā)現(xiàn)參數(shù)出錯，它會調(diào)用函數(shù)assert_failed()向程序員報告錯誤，在任何一個例程中的main.c中都有這個函數(shù)的模板，如下：

void assert_failed(uint8_t* file, uint32_t line)
{
  /* User can add his own implementation to report the file name and line number,
     ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */

  while (1)
  {}
}

你可以按照自己使用的環(huán)境需求，添加適當?shù)恼Z句輸出錯誤的信息提示，或修改這個函數(shù)做出適當?shù)腻e誤處理。





歡迎光臨 (http://www.torrancerestoration.com/bbs/) Powered by Discuz! X3.1