詳解stm32中的assert_param()函數(shù)
掃描二維碼
隨時(shí)隨地手機(jī)看文章
大家在用stm32庫函數(shù)的時(shí)候幾乎都會(huì)發(fā)現(xiàn)assert_param()這個(gè)函數(shù)，這個(gè)函數(shù)是判斷參數(shù)有沒有錯(cuò)誤，具體是什么錯(cuò)誤呢，我會(huì)在后面貼圖的。
assert_param()這個(gè)函數(shù)在stm32f10x_conf.h中定義：
#ifdef USE_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
以上代碼就是stm32f10x_conf.h中的一部分，我們?cè)倏聪旅娴拇a：
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB|RCC_APB2Periph_GPIOE, ENABLE);
這個(gè)函數(shù)是使能GPIOB和GPIOE端口的時(shí)鐘的。GPIOB和GPIOE是屬于APB2外設(shè)的所以用函數(shù)RCC_APB2PeriphClockCmd( xxx , xxx) 來使能，我們?cè)谶M(jìn)RCC_APB2PeriphClockCmd( xxx , xxx)函數(shù)里面看看：
void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState)
{
assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph));
assert_param(IS_FUNCTIONAL_STATE(NewState));
if (NewState != DISABLE)
{
RCC->APB2ENR |= RCC_APB2Periph;
}
else
{
RCC->APB2ENR &= ~RCC_APB2Periph;
}
}
在這個(gè)函數(shù)里面就可以看見我們今天要學(xué)習(xí)的函數(shù)了，在這里我們就分析函數(shù)1，以點(diǎn)帶面
1、assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph));
2、assert_param(IS_FUNCTIONAL_STATE(NewState));
函數(shù)1里面的參數(shù)是IS_RCC_APB2_PERIPH(RCC_APB2Periph)，我們?cè)谶M(jìn)入這個(gè)函數(shù)里面看看：
這是一個(gè)宏定義
#define IS_RCC_APB2_PERIPH(PERIPH) ((((PERIPH) & 0xFFC00002) == 0x00) && ((PERIPH) != 0x00))
我們來計(jì)算一下，PERIPH 是我們傳遞的參數(shù) RCC_APB2Periph_GPIOB|RCC_APB2Periph_GPIOE，
RCC_APB2Periph_GPIOB|RCC_APB2Periph_GPIOE=0x00000008|0x00000040
(PERIPH) & 0xFFC00002 = 0x00，所以((((PERIPH) & 0xFFC00002) == 0x00) && ((PERIPH) != 0x00)) = 1
所以就相當(dāng)于assert_param(1);
我們反過來在看stm32f10x_conf.h代碼的那部分，如果定義USE_FULL_ASSERT，那么就會(huì)定義
#define assert_param(expr) ((expr) ? (void)0: assert_failed((uint8_t *)__FILE__, __LINE__))
如果沒定義USE_FULL_ASSERT，那么就會(huì)定義#define assert_param(expr) ((void)0)，這是為什么呢，是因?yàn)橛脩粼诖a調(diào)試階段很可能會(huì)輸入錯(cuò)誤的參數(shù)而出現(xiàn)錯(cuò)誤，一般這種錯(cuò)誤不會(huì)察覺到，所以當(dāng)我們想檢查這種錯(cuò)誤的時(shí)候就定義USE_FULL_ASSERT，當(dāng)我們完成工程項(xiàng)目開始投入生產(chǎn)以后，代碼肯定是沒有這方面的錯(cuò)誤了，我們不需要程序在檢查我們的參數(shù)了我們就不用定義USE_FULL_ASSERT。這樣我們的代碼會(huì)小一點(diǎn)。
所以我們?cè)趕tm32f10x_conf.h中打開注釋，這樣就會(huì)檢查我們代碼中要求檢查的參數(shù)了，當(dāng)我們參數(shù)沒有錯(cuò)誤時(shí)，就相當(dāng)于assert_param(1);，進(jìn)入函數(shù)assert_param();觀察，就會(huì)執(zhí)行(void)0，意思就是什么也不執(zhí)行，因?yàn)榇藭r(shí)參數(shù)沒有錯(cuò)誤。
我們現(xiàn)在需要制造出一個(gè)錯(cuò)誤，在觀察函數(shù)是怎么執(zhí)行的。
現(xiàn)在我們傳遞一個(gè)錯(cuò)誤的參數(shù)
RCC_APB2PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE);
我們?cè)谟?jì)算一下，RCC_APB1Periph_TIM3=0x00000002
(PERIPH) & 0xFFC00002) ！= 0x00
所以IS_RCC_APB2_PERIPH(PERIPH)返回0
所以相當(dāng)于assert_param(0);
進(jìn)入assert_param();函數(shù)觀察
#define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))
就會(huì)執(zhí)行這個(gè)函數(shù)assert_failed((uint8_t *)__FILE__, __LINE__)，我們解釋一下這個(gè)函數(shù)是干什么的，這個(gè)函數(shù)是用戶自己發(fā)揮的，想在這個(gè)函數(shù)里面干什么就干什么，它的原型程序里面沒有，總之我沒找到，后來我在網(wǎng)上看見一文章，他說他在官方例子main.c里面找到的，所以我就拷貝到我的main.c中，函數(shù)原型如下：
void assert_failed(u8* file, u32 line)
{
//User can add his own implementation to report the file name and line number,
// ex: printf("Wrong parameters value: file %s on line %drn", file, line)
//用戶可以在這里添加錯(cuò)誤信息:比如打印出出錯(cuò)的文件名和行號(hào)
// Infinite loop
while (1)
{
}
}
這個(gè)函數(shù)就是在程序運(yùn)行時(shí)，可以打印出我們參數(shù)錯(cuò)誤的文件和行號(hào)，我把這個(gè)函數(shù)修改為：
void assert_failed(u8* file, u32 line)
{
printf("Wrong parametersvalue: file %s on line %drn", file, line);
}
你也可以添加別的函數(shù)，總之能顯示錯(cuò)誤信息就ok，不一定用串口顯示。
如果參數(shù)有錯(cuò)誤的話，就會(huì)向串口打印出錯(cuò)誤處的文件和行號(hào)，看下圖是串口打印出的錯(cuò)誤信息：
錯(cuò)誤文件為stm32f10x_rcc.c 行號(hào)1098，我們?cè)诳匆幌鲁绦蚴遣皇沁@里出現(xiàn)了參數(shù)錯(cuò)誤，如下圖：
還真是這里出現(xiàn)了參數(shù)錯(cuò)誤，因?yàn)槲覀儌鬟f的參數(shù)是
RCC_APB2PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE);
這里我就基本介紹完了，下面在介紹幾點(diǎn)。
1、assert_failed((uint8_t *)__FILE__, __LINE__)這個(gè)函數(shù)的__FILE__, __LINE__形參，可能是c語言自帶的把，具體是怎么獲取錯(cuò)誤參數(shù)的文件和行號(hào)我也不知道。
2、加入我們傳遞的參數(shù)是RCC_APB2PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE);雖然RCC_APB1Periph_TIM2是屬于APB1的，則在程序運(yùn)行時(shí)是打印不出錯(cuò)誤參數(shù)的，因?yàn)镽CC_APB1Periph_TIM2和RCC_APB2Periph_AFIO都等于0x00000001，大家可以去stm32f10x_rcc.h文件去看。所以大家在使用參數(shù)檢查功能時(shí)還要自己注意一下參數(shù)有沒有錯(cuò)誤。官方這個(gè)查錯(cuò)功能不是萬能的。
下載文檔
