STM32固件庫中assert_param的作用
在學習stm32庫函數過程中，筆者遇到大量的assert_param語句。經查明，assert_param的作用就是用來判斷傳遞給函數的參數是否是有效值。
以下是從固件庫中復制粘貼的：
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;
}
}
筆者用keil中的鼠標右鍵“go to definition xxxxxx""
查看assert_param(IS_RCC_APB2_PERIPH(RCC_APB2Periph));語句中IS_RCC_APB2_PERIPH的定義，得到如下結果：
#define RCC_APB2Periph_AFIO((uint32_t)0x00000001)
#define RCC_APB2Periph_GPIOA((uint32_t)0x00000004)
#define RCC_APB2Periph_GPIOB((uint32_t)0x00000008)
#define RCC_APB2Periph_GPIOC((uint32_t)0x00000010)
#define RCC_APB2Periph_GPIOD((uint32_t)0x00000020)
#define RCC_APB2Periph_GPIOE((uint32_t)0x00000040)
#define RCC_APB2Periph_GPIOF((uint32_t)0x00000080)
#define RCC_APB2Periph_GPIOG((uint32_t)0x00000100)
#define RCC_APB2Periph_ADC1((uint32_t)0x00000200)
#define RCC_APB2Periph_ADC2((uint32_t)0x00000400)
#define RCC_APB2Periph_TIM1((uint32_t)0x00000800)
#define RCC_APB2Periph_SPI1((uint32_t)0x00001000)
#define RCC_APB2Periph_TIM8((uint32_t)0x00002000)
#define RCC_APB2Periph_USART1((uint32_t)0x00004000)
#define RCC_APB2Periph_ADC3((uint32_t)0x00008000)
#define RCC_APB2Periph_TIM15((uint32_t)0x00010000)
#define RCC_APB2Periph_TIM16((uint32_t)0x00020000)
#define RCC_APB2Periph_TIM17((uint32_t)0x00040000)
#define RCC_APB2Periph_TIM9((uint32_t)0x00080000)
#define RCC_APB2Periph_TIM10((uint32_t)0x00100000)
#define RCC_APB2Periph_TIM11((uint32_t)0x00200000)
#define IS_RCC_APB2_PERIPH(PERIPH) ((((PERIPH) & 0xFFC00002) == 0x00) && ((PERIPH) != 0x00))
。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。
以這個函數為例：
void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph,
FunctionalState
NewState)的作用就是使能APB2外設時鐘，而當我們調用這個函數的時候，所給它的參數必須是以上規(guī)定的幾個數值中的一個，不可隨意填一個未定義的值進去。assert_param（）函數有效的解決了這個問題，它在函數運行之初，便判斷工程師所給的值是否為這個函數的有效值，以達到糾錯報錯的功能。同時，當我們不知道這個函數該填入什么樣的值的時候，就可以使用keil中提供的右鍵“go
to definition xxxx"查看assert_param（）括號中的定義。
下載文檔
