标签: assert

在进行STM8S相关项目开发的过程中 看到assert_param(--)的使用，通常是判断函数的输入参数是否合格。 找了一下的答案，关于assert的说明 第一个参考：http://power.21ic.com/digi/technical/201512/44852.html 用于开发调试时使用，生产时务必不要使用。在debug时有效，release模式失效。 通常用于两点：   1、验证函数先决条件，判断函数的输入参数满足条件否； void System_State（unsigned int state） {   assert(state4);   SystemState = state; }   2、验证函数的后置条件； unsigned int System_State（unsigned int state） {   assert(state4);   SystemState = state;   assert(state 5);   return SystemState; } 第二个参考：http://www.51hei.com/bbs/dpj-34439-1.html 在STM32的固件库和提供的例程中，到处都可以见到assert_param()的使用。如果打开任何一个例程中的stm32f10x_conf.h文件，就可以看到实际上assert_param是一个宏定义； 在固件库中，它的作用就是检测传递给函数的参数是否是有效的参数。 所谓有效的参数是指满足规定范围的参数，比如某个参数的取值范围只能是小于3的正整数，如果给出的参数大于3， 则这个assert_param()可以在运行的程序调用到这个函数时报告错误，使程序员可以及时发现错误，而不必等到程序运行结果的错误而大费周折。 这是一种常见的软件技术，可以在调试阶段帮助程序员快速地排除那些明显的错误。 它确实在程序的运行上牺牲了效率(但只是在调试阶段)，但在项目的开发上却帮助你提高了效率。 当你的项目开发成功，使用release模式编译之后，或在stm32f10x_conf.h文件中注释掉对USE_FULL_ASSERT的宏定义，所有的assert_param()检验都消失了，不会影响最终程序的运行效率。 #define assert_param(expr) ((expr) ? (void)0 : assert_failed((u8 *)__FILE__, __LINE__)) 。。。 assert_param(IS_ADC_ALL_PERIPH(ADCx)); 。。。 在执行assert_param()的检验时，如果发现参数出错，它会调用函数assert_failed()向程序员报告错误，在任何一个例程中的main.c中都有这个函数的模板，如下： void assert_failed(uint8_t* file, uint32_t line) { while (1) {} } 你可以按照自己使用的环境需求，添加适当的语句输出错误的信息提示，或修改这个函数做出适当的错误处理

文献阅读时经常会碰到Assert和deassert，发现理解这个的含义对于IP性能的理解很重要，所以网上查找了一下，把它们的含义转载出来，供查阅。        Assert（Asserting、Asserted），De-assert（Deassert、deasserting、deasserted）        assert的意思就是把信号变为active（可以理解为有效），根据系统有求不同，该有效电平可以是高电平（即高有效）也可以是低电平（即低有效）。         de-assert的意思就是解除active状态，就是信号变为非active状态，可以是高也可以是低。