你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

【经验分享】关于STM32中assert_param的分析

[复制链接]
STMCU小助手 发布时间:2022-6-30 18:00
    我们在学STM32的时候函数assert_param出现的几率非常大,上网搜索一下,网上一般解释为断言机制,做为程序开发调试阶段时使用。下面我就谈一下我对这些应用的看法,学习东西抱着知其然也要知其所以然。
: z! y: T. q: n1 O7 J1 F
    我们在分析库函数的时候,几乎每一个函数的原型有这个函数assert_param();下面以assert_param(IS_GPIO_ALL_PERIPH(GPIOx));为例说一下我的理解,函数的参数IS_GPIO_ALL_PERIPH(GPIOx),我们可以寻找到原型
  1. #defineIS_GPIO_ALL_PERIPH(PERIPH) (((*(uint32_t*)&(PERIPH)) == GPIOA_BASE) ||0 S6 C7 K5 \- l0 U, C! M# _

  2. , A: V6 |5 c& @0 o+ Q1 N6 b  n
  3. ((*(uint32_t*)&(PERIPH)) ==GPIOB_BASE) ||! D8 G! ~9 }# f" e. ~% U

  4. + z+ u! a  w- D( n
  5. ((*(uint32_t*)&(PERIPH)) ==GPIOC_BASE) ||: E: p7 L9 P7 e$ y1 l
  6. ' u0 a! P1 w! }6 b2 x" l
  7. ((*(uint32_t*)&(PERIPH)) ==GPIOD_BASE) ||4 T/ t8 H' @! a# g7 s6 r

  8. ! S) H  c  C# P& p4 D+ F
  9. ((*(uint32_t*)&(PERIPH)) ==GPIOE_BASE) ||
    7 v) n+ [+ L/ ?; ^. r* t

  10. 7 f) j9 d9 }+ J5 H# a0 h/ b. o) B
  11. ((*(uint32_t*)&(PERIPH)) ==GPIOF_BASE) ||  ^& b1 H7 Q: _6 d

  12. " e5 p" Q4 C: O( F. ]# Z3 w
  13. ((*(uint32_t*)&(PERIPH)) ==GPIOG_BASE))- j: r- K9 N: {) h' o) |- s; b

  14. , e% E; K' o" e; s
复制代码

$ ~1 t' w  j+ T7 L9 K; p  i

0 _( y+ r  q0 p4 c1 Z
    这个宏定义的作用就是检查参数PERIPH,判断参数PERIPH是否为GPIOX(A...G)基址中的一个,只要有一个为真则其值为真,否则为假,不用多说,这是C语言中基本的逻辑运算。当然这个库函数也用的很有意思,看:首先对PERIPH进行取址,也就是求地址,&PERIPH,然后对这个地址强制转化为32位的指针,即前面加(uint32_t *),然后通过*进行访问这个地址(指针)中的内容。不多说了,看几遍就能明白。
    下面我们再回到assert_param这个函数,这个函数是哪里的呢?在stm32f10x_conf.h寻找到原型如下:
  1. #ifdef USE_FULL_ASSERT
    $ T. b- N* X! R) f
  2. ! T1 K" }: y+ v' _3 ?
  3. #define assert_param(expr) ((expr) ? (void)0 :assert_failed((uint8_t *)__FILE__, __LINE__))# U+ H: ~6 k# ]  w2 H

  4. : z  W$ b. }; v; t* E
  5. void assert_failed(uint8_t* file,uint32_t line);) W- l5 x! s" k- {3 _% s) F

  6. 0 t5 ?( e7 h, J7 Q
  7. #else
      Z2 M( Y8 v) Z" U2 L

  8. 3 Q5 |' _, b3 u( B1 W
  9. #define assert_param(expr)((void)0)/ e' t+ q) z( v2 y  S7 U$ K# j, w

  10. * J) V  h6 H9 ?) D" H2 [
  11. #endif
复制代码
( z& o/ d: w* K  [# a$ i
    这是一个预编译文件,若是定义了USE_FULL_ASSERT这个文件,则执行后面的文件,我们在程序中一般都没什么定义,即执行后面这个语句((void)0),这个语句不用多想,没有定义USE_FULL_ASSERT就是什么也不执行。说的明白点,对上面的那个语句IS_GPIO_ALL_PERIPH(GPIOx)不执行任何操作。
: Q% T" Z: r2 t6 r% C: z
    若是定义了USE_FULL_ASSERT它,我们调用这个函数assert_param时,及对参数IS_GPIO_ALL_PERIPH(GPIOx)的正确性进行检查,通过一个C语言中的双目运算符来判断,若是返回1,执行语句(void)0,跟上面一样,若是返回0,则执行后面的函数assert_failed((uint8_t *)__FILE__, __LINE__),函数的作用在库函数中有解释,用来指示出错的行数和文件。注意:__FILE__, __LINE__是标准库函数中的宏定义!切记
void assert_failed(uint8_t* file,uint32_t line);刚开始没看明白为什么加在这里,仔细一想是在头文件的函数声明。至于函数实体呢?我们从官方文件的模板中main.c中可以找到。如下:
  1. void assert_failed(u8* file, u32line)
    - P3 ^) e( S& b% e5 H
  2. % _: t- |9 E. n6 t  q( R( X! R
  3. { ! A) C! C0 T1 M0 X  u% a
  4. + L! [7 O. P4 ^+ D5 b9 a/ o# j5 s
  5.     /* User can add his ownimplementation to report the file name and line number,
    $ `+ |" E4 B: Q+ D9 Q

  6. $ i" M% r8 Y/ ^0 ]: v" X# [9 t
  7.        ex: printf("Wrong parametersvalue: file %s on line %drn", file, line) */ . w3 n7 z! B) A5 I% \2 s1 c

  8. . Z; ^# {# ?* X! y
  9.     /* Infinite loop */
    0 X1 s* O5 ~' d6 p0 [
  10. 8 Y% x' v) T* r. l- l  K5 \' E
  11.     while (1) { }
    , e9 `( `* S8 @( ?6 d7 ]4 i; F
  12. $ ]$ P: s( M& U! f7 u% b
  13. }
复制代码

# j4 s4 M4 J" h% U
    英文注释也说明了怎么应用,通过输入参数来确定位置,最简单的方法就是串口打印了,这个函数的主要思想是在输入参数有问题的时候,但是有编译不出来,它可以帮你检查参数的有效性,好处不必多言,自己领悟就行。

  v) v* t1 j* j% M& q
    继续说明如下:assert_param是怎样包含进去的呢?我们在stm32f10x_conf.h这个头文件中定义的函数声明还是宏定义,怎么在其它文件中都能应用呢?也很多网上朋友在刚开始学习的时候都遇到编译不过去的问题出现,最后通过在文件中添加USE_STDPERIPH_DRIVER来解决的:
. p3 S" Q! d$ X4 ^/ [& U
微信图片_20220629180904.jpg
: M+ D) v/ C8 w) c
    我们可以在整个工程中进行搜索USE_STDPERIPH_DRIVER,通过头文件可以看出,是使用标准外设文件。在stm32f10x.h文件中我们可以搜索到如下情况:
  1. #if !defined USE_STDPERIPH_DRIVER, \( z& d- m2 Z$ q- H

  2. # m0 e; l( ?, v, T8 H5 d
  3. /**( W/ x$ J  N& s4 E; Z

  4. 8 v) X" z' E; `% _- J% n; m
  5. * @brief Comment the line belowif you will not use the peripherals drivers.) A/ d% {3 ^. V, I! F) t2 N
  6. & P% i3 i( U: |6 A8 W9 W
  7. In this case, these drivers willnot be included and the application code will ! @9 V5 Z" i3 N* ~$ K
  8. 7 x& q) ?- I: [) r
  9. be based on direct access toperipherals registers / |9 m2 J$ c2 Q) |

  10. " G  k3 R0 j2 h9 Y2 Q
  11. */! e- N- p8 t) A

  12. ! [  o; p  x# K- N# \" r. k
  13. #define USE_STDPERIPH_DRIVER* y& x5 Z5 R! s) b
  14. 4 t& A, C1 G+ u) `7 B3 h
  15. #endif) b: i, T" W8 [; E3 T3 O6 ^
  16. * k1 Z& f, S, W2 i

  17. 3 N! G- s: g! |# W9 m% t% j8 m
  18. # V* E! n4 |) S$ }. k+ t; o( ?$ J
  19. #ifdef USE_STDPERIPH_DRIVER
    % W$ {' K5 s1 c7 ]  B! z+ ~/ `
  20. - j9 I& c; P$ U+ b, C2 D
  21. #include "stm32f10x_conf.h"
    : K3 N) m3 w& ~1 @0 i

  22. $ C" ~8 p5 @" r, ~& z5 m! A3 p
  23. #endif
复制代码

0 u& S( r4 p5 T! Q6 X; }
6 F3 J# I3 q% E0 X$ Q4 a  c
    可以很容易看出来,我们不在那里添加,这个头文件中也给我们设置了开关,只要把第一个的注释去掉,就不用在配置中添加USE_STDPERIPH_DRIVER了,在第二个文件中我们可以知道怎样包含这个控制开关文件了,呵呵。我们也明白为什么我们在写程序的时候只要包含stm32f10x.h就能很容易的包含所有的文件文件了吧,我们只要在stm32f10x_conf.h配置一下就能包含所需要的库文件了。
, b7 e' f, L$ u9 d
    通过以上可以看出,通过头文件的相互包含,来控制外设以及调试文件的调用,这样我们理清思路,理解起来就好多了。当然在学**可能有些C语言问题还没有理解透彻,多上网搜一下,或者多看书,很快就搞明白的。

6 q( V$ o+ \5 I9 A1 V8 ^# g2 n$ w
赞 收藏 评论0 发布时间:2022-6-30 18:00

举报

0个回答

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版