【STM32笔记】：P04 断言的使用

来生硬件工程师2025-10-20 13:12

stm32f10x_conf.h 这个文件还可配置是否使用"断言"编译选项

断言配置，如下：

javascript 复制代码

#ifdef  USE_FULL_ASSERT

/**
  * @brief  The assert_param macro is used for function's parameters check.
  * @param  expr: If expr is false, it calls assert_failed function which reports 
  *         the name of the source file and the source line number of the call 
  *         that failed. If expr is true, it returns no value.
  * @retval None
  */
  #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__))
/* Exported functions ------------------------------------------------------- */
  void assert_failed(uint8_t* file, uint32_t line);
#else
  #define assert_param(expr) ((void)0)
#endif /* USE_FULL_ASSERT */

在 ST 标准库的函数中，一般会包含输入参数检查，即上述代码中的"assert_param"宏，当参数不符合要求时，会调用"assert_failed"函数，这个函数默认是空的。实际开发中使用断言时，先通过定义 USE_FULL_ASSERT 宏来使能断言，然后定义"assert_failed"函数，通常我们会让它调用 printf 函数输出错误说明。使能断言后，程序运行时会检查函数的输入参数，当软件经过测试，可发布时，会取消 USE_FULL_ASSERT 宏来去掉断言功能，使程序全速运行。