大家在用stm32庫(kù)函數(shù)的時(shí)候幾乎都會(huì)發(fā)現(xiàn)assert_param()這個(gè)函數(shù)，這個(gè)函數(shù)是判斷參數(shù)有沒(méi)有錯(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) 來(lái)使能，我們?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ù)里面就可以看見(jiàn)我們今天要學(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))

我們來(lái)計(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);

我們反過(guò)來(lái)在看stm32f10x_conf.h代碼的那部分，如果定義USE_FULL_ASSERT，那么就會(huì)定義

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

如果沒(méi)定義USE_FULL_ASSERT，那么就會(huì)定義#define assert_param(expr) ((void)0)，這是為什么呢，是因?yàn)橛脩粼诖a調(diào)試階段很可能會(huì)輸入錯(cuò)誤的參數(shù)而出現(xiàn)錯(cuò)誤，一般這種錯(cuò)誤不會(huì)察覺(jué)到，所以當(dāng)我們想檢查這種錯(cuò)誤的時(shí)候就定義USE_FULL_ASSERT，當(dāng)我們完成工程項(xiàng)目開(kāi)始投入生產(chǎn)以后，代碼肯定是沒(méi)有這方面的錯(cuò)誤了，我們不需要程序在檢查我們的參數(shù)了我們就不用定義USE_FULL_ASSERT。這樣我們的代碼會(huì)小一點(diǎn)。

所以我們?cè)趕tm32f10x_conf.h中打開(kāi)注釋，這樣就會(huì)檢查我們代碼中要求檢查的參數(shù)了，當(dāng)我們參數(shù)沒(méi)有錯(cuò)誤時(shí)，就相當(dāng)于assert_param(1);，進(jìn)入函數(shù)assert_param();觀察，就會(huì)執(zhí)行(void)0，意思就是什么也不執(zhí)行，因?yàn)榇藭r(shí)參數(shù)沒(méi)有錯(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ù)里面干什么就干什么，它的原型程序里面沒(méi)有，總之我沒(méi)找到，后來(lái)我在網(wǎng)上看見(jiàn)一文章，他說(shuō)他在官方例子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語(yǔ)言自帶的把，具體是怎么獲取錯(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ù)有沒(méi)有錯(cuò)誤。官方這個(gè)查錯(cuò)功能不是萬(wàn)能的。