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

【经验分享】STM32H7的终极调试组件Event Recorder

[复制链接]
STMCU小助手 发布时间:2022-1-1 18:00
8.1   重要提示(必读)
  •   只要是MDK支持的调试下载器,基本都支持Event Recorder,本教程测试了JLINK,STLINK和CMSIS-DAP。

  •   务必使用MDK5.25及其以上版本。

  •   使用ARM_Compiler 软件包V1.4.0及其以上版本。

  •   CMSIS软件包 要是使用V5.3.0及其以上版本,详情本教程8.3小节末尾的说明。

  •   为了实现Event Recorder组件的最高性能,最好将下载器的时钟速度设置到所支持的最大值,另外,根据需要加大EventRecorderConf.h文件中的缓冲大小,默认可以缓冲64个消息(动态更新的FIFO空间)。

  •   此调试组件不需要用到SWO引脚,使用标准的下载接口即可。以我们的开发板为例,用到VCC,GND,SWDIO,SWCLK和NRST。大家使用三线JLINK-OB也是没问题的,仅需用到GND,SWDIO和SWCLK。


    ( W+ q2 A. E* P0 i6 t- l' y8 N
    5 a, c6 r6 \! n6 m- l1 x9 v
    2 m3 B: L9 X8 `3 \3 @" D6 h* C, H5 {- ~
8.2   Event Recorder简介

前面的专题教程中为大家讲解了使用SEGGER的RTT功能来替代串口打印,比较方便。只是这种方法限制用户必须使用JLINK才可以。而使用Event Recorder的话,无此限制,各种LINK通吃。只要是MDK支持的即可。

Event Recorder是MDK在5.22版本的时增加的功能,到了5.25版本后,这个功能就更加完善了,增加了时间测量和功耗测量的功能。

此调试组件不需要用到SWO引脚,使用标准的下载接口即可。以我们的开发板为例,用到VCC,GND,SWDIO,SWCLK和NRST。大家使用三线JLINK-OB也是没问题的,仅需用到GND,SWDIO和SWCLK。

  •   JTAG接口和SWD接口区别


    % ^2 U5 n  U- B; i% |. F

    ( Z) H0 z4 k6 }  H

    , s8 l2 \; R5 `/ z9 ?

下图分别是20pin的标准JTAG引脚和SWD( Serial Wire Debug)引脚,一般SWD接口仅需要Vref,SWDIO,SWCLK,RESET和GND五个引脚即可,SWO(Serial Wire Output)引脚是可选的。有了SWO引脚才可以实现数据从芯片到电脑端的数据发送。

  •   词条 SWV(Serial Wire Viewer)

    ' @5 t0 ~! E5 b2 s
    * x- s+ @: E3 x/ `" l- F

SWV是由仪器化跟踪宏单元ITM(Instrumentation Trace Macrocell)和SWO构成的。SWV实现了一种从MCU内部获取信息的低成本方案,SWO接口支持输出两种格式的跟踪数据,但是任意时刻只能使用一种。两种格式的数据编码分别是UART(串行)和Manchester(曼彻斯特)。当前JLINK仅支持UART编码,SWO引脚可以根据不同的信息发送不同的数据包。当前M3/M4可以通过SWO引脚输出以下三种信息:

  • ITM支持printf函数的debug调用(工程需要做一下接口重定向即可)。ITM有32个通道,如果使用MDK的话,通道0用于输出调试字符或者实现printf函数,通道31用于Event Viewer,这就是为什么实现Event Viewer需要配置SWV的原因。

  • 数据观察点和跟踪DWT(Data Watchpoint and Trace)可用于变量的实时监测和PC程序计数器采样。

  • ITM 还附带了一个时间戳的功能:当一个新的跟踪数据包进入了ITM的FIFO 时,ITM 就会把一个差分的时间戳数据包插入到跟踪数据流中。跟踪捕获设备在得到了这些时间戳后,就可以找出各跟踪数据之间的时间相关信息。另外,在时间戳计数器溢出时也会发送时间戳数据包。


    0 Z/ ~( e* [/ l& m) e

    ! ]3 _/ t- h" `5 ~

    : A* I: t! ]0 |  _, T6 p
8.2.1        Event Recorder的特色

Event Recorder的特色主要有以下几点:

  • 提升应用程序动态执行期间的检测能力。

  • 支持的事件类型滤除机制,比如运行错误、API调用、内部操作和操作信息的区分。

  • 可以在任务中、RTOS内核中和中断服务程序中任意调用。

  • 对于带ITM功能的Cortex-M3/M4/M7/M33内核芯片,执行记录期间,全程无需开关中断操作。对于不带ITM功能的Cortex-M0/M0+/M23,是需要开关中断的。

  • 支持printf重定向。

  • 各种link通吃,支持SWD接口或者JTAG接口方式的JLINK、STLINK、ULINK和CMSIS-DAP。

  • 对于带DWT时钟周期计数器功能的Cortex-M3/M4/M7/M33内核芯片,创建时间戳时,可以有效降低系统负担,无需专用定时器来实现。

  • Event Recorder执行时间具有时间确定性,即执行的时间是确定的,而且执行速度超快,因此,实际产品中的代码依然可以带有这部分,无需创建debug和release两种版本。

  • RTX5及其所有中间件都支持Event Recorder调试。

    4 P' q; T$ }: P5 y
    : J$ y( D9 D) l, M+ J5 ^6 N
    " f6 n+ h4 B# D8 g" i
8.2.2        Event Recorder是如何工作的

首先来看下面这张图:

在截图的左下角有个Memory内存区,在这个内存区里面有一个缓冲Event Buffer,其实就是一个大数组。MDK通过访问这个数组实现消息的图形化展示。为了正确的图形化展示,数组缓冲里面的数据就得有一定的数据格式。而这个数据格式就是通过左侧截图里面的Event Recorder和Event Filter来实现的。Event Recorder的API实现数据记录和整理,Event Filter的API实现数据的筛选,从而可以选择哪些数据可以在MDK的Event Recorder调试组件里面展示出来。

这就是Event Recorder的基本工作流程。

8.2.3  Event Statistics时间测量功能

Event Statistics提供的时间测量功能简单易用,在测试代码前后加上测量函数即可:

在本章教程程的8.6小节为大家详细进行了讲解。通过这个时间测量功能,用户可以方便测试代码的执行时间,从而根据需要,进行合理的优化,提高代码执行效率。

8.2.4  Event Statistics功耗测量功能

Event Statistics提供的功耗测量功能,当前只有KEIL的ULINKplus支持此功能,由于ULINKplus价格不便宜,一套5000多,大家作为了解即可,实际效果如下:

8.2.5  Event Recorder的实现原理

每条Event Recorder消息是由16字节的数据组成,32位的ID,32位的时间戳,两个32位的数据,共计16个字节。其中32位ID最重要,格式如下:

Level指定消息分类,主要用于消息筛选:

Component number指定事件消息所属的软件组件,也可用于过滤:

看了下Event Recorder的源码,每条消息大体是一样的:

  1. typedef struct {
    ) O1 w* }' y, Z; A' S# d

  2. " }6 H" F8 k3 E3 l- T7 ]
  3.   uint32_t ts;                  // Timestamp (32-bit, Toggle bit instead of MSB)
    & G" f& ?5 y, T) ]5 g! ^7 S8 r  s

  4. * m4 t# F( Y: M/ {% n' q- d+ S
  5.   uint32_t val1;                // Value 1   (32-bit, Toggle bit instead of MSB)3 a6 }8 W4 _$ t* r
  6. # }; M3 p# s4 r8 Z. d" x' C' n
  7.   uint32_t val2;                // Value 2   (32-bit, Toggle bit instead of MSB)
    + ~0 {3 q. o$ q& A
  8. 4 Z! Z/ {0 V' v5 T2 `" c; U
  9.   uint32_t info;                // Record Information
    * c; i, B3 F6 }  }
  10. . L' C$ v1 C' O/ s' W
  11.                                 //  [ 7.. 0]: Message ID (8-bit)7 s; T& [5 b! p) |$ V

  12. . e+ f4 N/ ]& ^9 w/ s
  13.                                 //  [15.. 8]: Component ID (8-bit)8 l& [  A4 z, ~2 R% i# F+ M# ?
  14. - o9 |: m, x3 Q7 j' @8 u+ G
  15.                                 //  [18..16]: Data Length (1..8) / Event Context
    , z' E; F. \% x6 l( W: v" ]

  16. " t) a6 [: X# B4 I* h
  17.                                 //      [19]: IRQ Flag: p, n4 ?- {) J6 {4 G8 [( m
  18. 2 W# w1 v. ]% R# V, P
  19.                                 //  [23..20]: Sequence Number
    + ~% V+ [" ^1 I8 C0 P* L
  20. ; X5 g0 }2 I- Z4 s
  21.                                 //      [24]: First Record% K# W' p& g% Q+ f

  22. & \! x4 z  _( |! g/ d
  23.                                 //      [25]: Last Record5 g7 ?0 i* K% `1 ]! A

  24. . H% `6 V8 Q0 S
  25.                                 //      [26]: Locked Record
    7 ^3 g6 c; ]/ k/ `3 ^( V
  26. ) w* N2 K1 s) N0 b. t$ E9 I
  27.                                 //      [27]: Valid Record
    ! K5 T7 J' z  F' q: t* M

  28.   _; }2 D9 M& F
  29.                                 //      [28]: Timestamp MSB( R- [" t* A: _% m) c
  30. 9 Z' @4 _' \9 N8 @* R* E& E
  31.                                 //      [29]: Value 1 MSB! ^- I1 y2 v4 M; M: D( O* ?4 t

  32. 8 [  l4 _/ ?0 m- F( R
  33.                                 //      [30]: Value 2 MSB
    2 b& Z/ h  x' u2 L5 l6 o4 e; W
  34. 6 f( _" e7 Y7 g
  35.                                 //      [31]: Toggle bit- B) d& f" k, ~  ^# X

  36. : M  o' k. [! \) d& E+ v7 A
  37. } EventRecord_t;
复制代码

. x; L# D$ j) A/ \7 ?9 _

其中参数成员info最重要,也就是前面说的32位ID,这里的说明与前面的说明稍有不同。这里是经过处理后,实际存储到Event Recorder缓冲里面的数据。
3 f& n+ c4 F# F5 Q: M9 m

对于Event Recorder,大家了解了这些知识点基本就够用了。

8.3   创建工程模板和注意事项

Event Recorder工程的创建比较简单,这里分步为大家做个介绍。

  第1步:准备好一个使用MDK5.25或以上版本创建的工程模板。

  第2步:安装ARM_Compiler V1.4.0或以上版本(如果有最新版,直接安装最新的),详情见帖子:

http://www.armbbs.cn/forum.php?mod=viewthread&tid=87175 。

  第3步:打开MDK5.25或以上版本创建的RTE环境。

  第4步:通过RTE环境,为工程添加Event Recorder功能。

  第5步:为了实现printf重定向,我们需要将STDOUT的输出方式改为Event Recorder,即选项里面的EVR。

  第6步:打开通过RTE环境为工程添加的文件EventRecorderConf.h,配置如下:

这里主要设置方框里面的两个参数。

Number of Records:表示Event Recorder缓冲可以记录的消息条数。

Time Stamp Source:表示时间戳来源,有如下四种可以选择,我们这里使用DWT时钟周期计数器。

由于选择的是DWT,因此EventRecorderCong.h文件中的Systick Configuration配置就不用管了。

==========================

通过上面的6步就完成了Event Recorder功能的添加,效果如下:

添加完成后,还有非常重要的两点要特别注意:

  •   第1点:一定要使用当前最新的CMSIS软件包,当前是V5.4.0(随着时间的推移,如果升级了新版本,直接使用新版即可)。


    # [0 B0 Q% ]$ f' @

下载并导入到MDK后,需要大家更新自己现有工程CMSIS文件里面的头文件,可以直接将CMSIS文件夹中Include文件里面的所有文件全部删掉,替换为MDK安装目录如下路径里面的所有头文件:

ARM\PACK\ARM\CMSIS\5.4.0\CMSIS\Include。保证头文件都是最新的5.4.0版本。

  • 第2点:由于使能了printf重定向,大家的工程里面一定不要再做重定向了,比如fpuc,fgetc。另外当前选择了微库MicroLib:


    ; C5 B& a) ^' ~$ p. F+ Z
    ! K, u# f; p% Z

注意这两点后,就可以使用Event Recorder的功能了。

8.4   Event Recorder事件记录的实现

Event Recorder的使用也比较省事,这里也分步为大家进行说明:

  第1步:初始化,仅需添加如下两行代码即可。

  1. /* 初始化EventRecorder并开启 */
    8 X. W2 T/ `( G. ^2 Q
  2. " P/ q- _! B4 z8 ?- W# t
  3. EventRecorderInitialize(EventRecordAll, 1U);
    8 o5 P9 V) c( s, b& K, V. W- q

  4. 2 O2 {# G3 k2 V/ y4 D* e
  5. EventRecorderStart();
复制代码


+ s8 t0 h+ p" V. `8 o/ t

  第2步:调用Event Recorder的API就可以使用了,主要有以下三个API:

EventRecord2:可以发送两个32位数据。

EventRecord4:可以发送四个32位数据。

EventRecordData:可以发送字符串。

显然这三个函数没有printf使用方便,所以对于这三个函数,大家做个简单的了解即可。教程配套例子里面有调用到这三个函数,可以操作熟悉下。这三个API的说明是在对应的help文档中,即MDK安装目录路径:/ARM/PACK/Keil/ARM_Compiler/1.6.0/Doc/General/html/index.html。

  第3步:进入调试状态,选上周期更新:

点击全速运行:

然后将Event Recorder调试组件展示出来:

效果如下:

另外,这里有个知识点需要大家了解下,如果程序里面也调用了Event Statistics时间测量函数,那么也会在这个界面里面展示消息的,如何才能仅展示大家想看的功能呢?这就需要用到Event Recorder支持的筛选功能。使用这个功能需要大家先暂停全速运行,然后点击下面这个选项:

弹出的界面里面可以设置哪些选项显示,哪些选项不显示(勾上表示显示),我们这里取消Event Statistics的显示,设置完毕后记得点击OK按钮。

这就不展示Event Statistics的内容了。再次启动全速运行前,下面这个选项的对勾别忘了勾上。

8.5   Event Recorder实现printf重定向

实现printf输出需要用到MDK调试组件中的Debug(printf) Viewer,输出效果就跟大家使用串口调试软件一样,可以输出中文和英文。

MDK的printf调试组件使用方法跟本章8.4小节中的说明一样,点击调试,选中周期运行,然后显示Debug(printf) Viewer调试组件:

效果如下:

另外,还有一个知识点需要给大家做个补充,使用SWD接口的SWO引脚也是可以做串口打印的,并且也是通过这个调试组件Debug(printf) Viewer进行输出。只是这种方式的性能没有Event Viewer强,而且要多占用一个SWO引脚。

! W. ?5 r5 [1 N; `
8.6   Event Statistics 时间测量功能的实现

时间测量功能简单易用,仅需一个起始函数,一个停止函数即可。当前支持4组,每组支持16路测量,也就是可以同时测量64路。

时间测量的API函数支持多任务和中断里面随意调用。

1、  测量起始函数:EventStartG (slot) 或者EventStartGv (slot, val1, val2)

  • 函数中的字母G是表示分组A,B,C,D,即实际调用函数为EventStartA,EventStartB,EventStartC和EventStartD。

  •   函数的第一个形参slot的范围是0-15,也就是每个分组可以测试16路。

  •   函数后面的两个形象val1和val2是32位变量,用户可以用这两个形参来传递变量数值给Event Statistics调试组件里面,方便图形化展示。简单的说,这两个变量仅仅起到一个传递变量数值的作用。


    " g6 q# U9 k. ?1 l+ g+ j
    ; K8 p( d! X! x8 {- i

    3 i1 A& r% s3 e# z) B0 E

2、  测量停止函数:EventStopG (slot) 或者  EventStopGv (slot, val1, val2)

  •   函数中的字母G是表示分组A,B,C,D,即实际调用函数为EventStopA,EventStopB,EventStopC和EventStopD。

  •   函数的第一个形参slot的范围是0-15,也就是每个分组可以测试16路。

  • 函数后面的两个形象val1和val2是32位变量,用户可以用这两个形参来传递变量数值给Event Statistics调试组件里面,方便图形化展示。简单的说,这两个变量仅仅起到一个传递变量数值的作用。

    , w% m  g' T4 k! K
      \7 [1 b% z1 f2 _% E/ j/ @

这里也分步为大家说明Event Statistics时间测量功能的使用方法。

  第1步:初始化,仅需添加如下两行代码即可。


  •   h- {/ \0 U9 i* R/ j& J7 k

    5 @! J; `+ N  ^) u
    /* 初始化EventRecorder并开启 */3 e4 e( _6 P# n' p6 P

    9 Z/ f  D0 r. k1 I

  • ) o. Q% \+ N$ O4 k* b& c* x+ J- U

    / V& i( X; I7 k+ ?4 [" ]! s& N
    * R4 S+ R: H, W( ^8 r( `9 C6 M
    / F5 \' |4 c  ?/ Y0 L& x) C1 O; Q
  • 6 v( ~( u* T# w1 Z( _

    5 a' j: u) y  f8 f/ t
    EventRecorderInitialize(EventRecordAll, 1U);: V% v% [0 t3 H0 s' y

    : a& w; @1 @, F+ J; r
  • 5 `& A$ f! K+ z* F4 L" }7 C

    ( Y3 _$ G. I% C( N2 n& m

    : T! x$ T6 l* ~1 h2 |5 ~

    % ?$ t  D! I* ^9 ]  ^, ^8 Y

  • * n2 K- V3 v' X6 s" z

    & U5 G1 X  l3 L$ G3 A' a5 i  L
    EventRecorderStart();1 S# L$ s0 @' y+ D1 K( v9 u+ O

    . X7 R8 R  k) l& {0 P3 d; j6 I/ c; {" u3 @6 P1 {

    7 ?! T2 g, N/ O' O) ]$ D, b% K

  第2步:在要测量的代码前后加上起始和结束时间。


  • - |) p( j+ U2 n& U

    # w0 E0 Y( j, H6 G) W5 W' k/ T& ?* H
    EventStartA(0);
    7 e# M- Q& a+ K' b/ s6 u
    4 ^. C5 _* x" d" n2 w, Q: S5 F

  • # J7 V" G5 O( V% h6 ?7 h2 }$ a
    3 i0 g4 p, `0 V! k

    # m) K! p& D" z/ R9 N$ {3 I& f! u
    $ U: k7 n5 H3 S

  • " l7 T  k" q: U1 n+ Z
    # ^, u, c4 a& {2 Z6 U+ I
    //测量的代码部分2 V2 C3 e% d3 @- D5 t4 n8 X3 i

    & ~* f- J  v) q7 u
  • % W9 O4 [, S6 l, C" U
    " N( N- e$ z9 |$ U

    ' T# M4 K6 H6 H: h6 P$ e

    $ T# _3 k4 [  @; M

  • ; b% H& k* @' b" q- }& E- v
    5 n, l( C# f  c! y& R/ q
    EventStopA(0);) A2 ^: B9 d- b# y

    ; Y- C. o# q0 C5 M$ U6 {! |- O, ?. i5 e& ~2 |! U
    " G$ I% s3 T1 i5 d3 O" Q7 j

这里是用分组A的测量通道0。

  第3步:跟本章8.4小节讲解的一样,点击调试,选择周期更新选项,然后全速运行。

  第4步:全速运行后,显示Event Statistics调试组件。

比如我这里简单的测试了一个5ms的延迟函数,效果如下(测量时间是动态更新的):

另外要注意一点,微秒的时间单位us可能无法正常显示,这个是没有关系的:

8.7   Event Statistics 功耗测量功能的实现

当前仅KEIL自家的ULINKplus支持功耗测量功能,这款下载器不便宜,一套5000多,大家有个了解即可,我们这里就不做讲解了。

8.8   Event Recorder对RTX5及其所有中间件的支持

后面做RTX5及其所有中间件的教程时会为大家做讲解,这里让大家看下效果:

  •   RTX5组件和使用Event Recoder的效果:


    $ }2 v1 Y+ p  t+ C
    4 F. z: H' A0 U$ R- Y4 R+ e

  •   网络调试组件效果展示:


    7 B0 s$ T' e: v' L
    ! {; Z$ j  s. p- Z" J

  •   文件系统和USB协议栈的效果展示:


    % U& Y, |, P( @# ?

    * K# w1 H1 s2 c$ W

8.9   JLINK配置说明

为了帮助大家更好的使用JLINK,这里将JLINK配置中关键的几个地方做个说明。

  •   下面这个地方最重要,一定要正确设置当前系统工作的主频,如果不正确,会导致Event Statistics的时间统计不正确(对于H7,Core部分要填400MHz)。

    ) N3 }) N2 W( b8 A

    - \$ h/ i& j9 L, u! v5 ^% `1 y( q6 H

注:如果大家调试状态弹出SWD配置时钟超出范围的问题,可以考虑将上面截图中的Enable选项的对勾取消掉即可,但内核时钟一定要修改为芯片的主频。

另外,进入调试状态后,右下角的时间是否正常更新都没有关系:

  •   其它选项配置如下(只要大家的工程能够正常调试,配置就是没问题的):

    7 K" @  l5 Q$ L+ r9 w

    $ g+ \3 c0 `# b5 }+ p2 \8 F" o

8.10 STLINK配置说明

为了帮助大家更好的使用STLINK,这里将STLINK配置中关键的几个地方做个说明。

  •   下面这个地方最重要,一定要正确设置当前系统工作的主频,如果不正确,会导致Event Statistics的时间统计是不正确的(对于H7,Core部分要填400MHz)。


    * v* h) l$ k% H1 @( G6 W# `5 U5 Z
    , Z6 J. F( x4 J3 E: b7 H. f# _

另外注意,进入调试状态后,右下角的时间是否正常更新都没有关系:

  • 其它选项配置如下(只要大家的工程能够正常调试,配置就是没问题的):


    9 c9 x" |4 ^' K1 D" T5 X' ]
    5 H7 }1 {! {0 f9 }

8.11 CMSIS-DAP配置说明

为了帮助大家更好的使用CMSIS-DAP,这里将CMSIS-DAP配置中关键的几个地方做个说明。

  •   下面这个地方最重要,一定要正确设置当前系统工作的主频,如果不正确,会导致Event Statistics的时间统计不正确(对于H7,Core部分要填400MHz)。

    . [+ Q' R+ g: V, D+ P* y

    0 u. j9 ^9 r9 P4 ]. c- ]  H! B

另外注意,进入调试状态后,右下角的时间是否正常更新都没有关系:

  •   其它选项配置如下(只要大家的工程能够正常调试,配置就是没问题的):


    ! a6 W1 Q- j- ^+ n5 w
    ' _6 B" V8 ^: F/ n: {2 T0 ^

8.12 ULINK配置说明

由于手头没有ULINK,这里就不做讲解了。如果大家需要相关配置,按照前面小节三款LINK的配置照葫芦画瓢搞一下即可,或者在MDK安装目录的路径ARM\Hlp下有对应的文档说明:

8.13 配套例子

本章节教程配套了如下例程,仅MDK版本。

  •   V7-008_终极调试组件EventRecoder的使用


    & h3 H0 p/ s# N- p- N2 y# t
    4 g. r  q' Y- a' q8 s

具体代码实现也比较简单,以V6开发板为例,定义一个TIM6的中断,中断频率是500Hz,通过Event Statistics测量中断的执行频率。代码如下:

  1. #include "bsp.h"9 D+ X4 ~0 I" N1 b8 S1 |
  2. - R/ n- w& r+ a# X" y2 N
  3. #include "EventRecorder.h"
    * C. Q( ~; w( ?' p* O
  4. /* 定时器频率,500Hz */
    : d! u! S7 _  y: h
  5. #define  timerINTERRUPT_FREQUENCY    5004 T3 v6 U4 P# X1 ^3 P* J
  6. /* 中断优先级 */% |& I9 b# z/ ^: `9 k# }: b1 p
  7. #define  timerHIGHEST_PRIORITY       10* h+ D  ^: f. I* x3 q& k
  8. /*
    ; B- S) l" r1 R5 y. W% Y0 x3 _) m
  9. *********************************************************************************************************" f2 [, e: }7 l1 O* m1 y9 p
  10. *    函 数 名: vEventRecorderTest
    & Z* [6 X" s8 L7 O3 {
  11. *    功能说明: 创建定时器$ e/ @; l- C7 n- L1 g
  12. *    形    参: 无
    ) G. N  v! [8 `. R; u1 A
  13. *    返 回 值: 无5 L! N, u+ D& X
  14. *********************************************************************************************************
    % C8 ~/ _/ M% {) ~# j* F* l
  15. */1 W2 K' p) ?, l3 b" J2 X% P
  16. void vEventRecorderTest(void)
    $ J4 o; q) z& T% q* d: ]
  17. {
    % H0 c# |' m9 U% |: t5 Z
  18.      bsp_SetTIMforInt(TIM6, timerINTERRUPT_FREQUENCY, timerHIGHEST_PRIORITY, 0);
    - w4 |  P$ e5 D6 O* ~% Q7 T+ v
  19.      EventStartB(0);   
    , g* [( W% ?" I7 R8 ]% _, n9 Z8 Y
  20. }
    , C8 A- R4 V! F) W! E+ t+ W
  21. ' G# _/ |- z* O5 S" Z0 K
  22. /*9 \/ z* E) T! U6 ^) ~
  23. *********************************************************************************************************  o% H5 }0 N  `3 p# n( ^
  24. *    函 数 名: TIM6_DAC_IRQHandler% N: q: `$ s( x' G: ^* W/ k
  25. *    功能说明: TIM6中断服务程序。, v& {% L4 H! z2 b# `3 u4 {4 C
  26. *    形    参: 无: f" y" N$ f/ y$ e5 q$ L
  27. *    返 回 值: 无
    4 p  j4 J/ b1 C6 |+ H; I/ _
  28. *********************************************************************************************************- ^0 x& d5 x$ X9 {" z- k' A& y! ?# _
  29. */
    / w. f/ g& U& }; @2 V/ x
  30. void TIM6_DAC_IRQHandler( void )
    : v% N8 K% D2 l+ z+ J/ K
  31. {$ P1 }* H9 G& `* ?$ J3 _) {
  32.      if((TIM6->SR & TIM_FLAG_UPDATE) != RESET)
    / V7 T1 }: {, q
  33.      {4 N- D# L% T( E" E0 c
  34.          EventStopB(0);   
    ; O8 F3 n; F' g! F1 J
  35.          EventStartB(0);   
    1 ]* o- d/ \- q" n
  36.          /* 清除更新标志 */
    * a2 T' Y3 o3 z  A- Q
  37.          TIM6->SR = ~ TIM_FLAG_UPDATE;
    * y- f* g' G& V! G
  38.      }
      L/ m/ U; K. n8 `* b0 ?
  39. }
复制代码

5 E( c- I% F) c* Q/ W

效果如下,测量的平均频率是1.98ms,与我们设计的500Hz基本符合:

应用程序的设计如下:

  1. #include "bsp.h"            /* 底层硬件驱动 */
    9 B9 `6 A" h+ _7 v; U9 |  H+ _
  2. #include "EventRecorder.h"+ n- _9 V5 {; L4 ~/ p2 Q

  3. ; M- G) r% d+ a
  4. /*) D; y& a; J( d# P' Q9 B" g/ j4 L
  5. *********************************************************************************************************
    1 i/ x. m. F; p2 z
  6. *                                              函数和变量; f. k) H3 X- z0 h9 |' A
  7. *********************************************************************************************************
    # [) X! o8 v+ y2 i+ B2 C2 @& ?
  8. */
    6 U$ c' M* c; d! `0 Y3 i4 }8 Q5 j
  9. extern void vEventRecorderTest(void);
    ! N1 }: v, d5 `. U
  10. uint8_t s_ucBuf[10] = "armfly";
    3 p2 W+ P2 y& H# `7 v+ |7 Q6 t
  11. # k7 S: d9 {8 o! R! l7 C
  12. /*/ n$ ]) t6 ]" a) b8 y6 m
  13. *********************************************************************************************************% v/ A5 ^' F+ Q) d& C, t) T
  14. *    函 数 名: main4 n9 o( L9 i9 l6 T* Q2 A7 p
  15. *    功能说明: c程序入口+ q2 K$ V- o6 P4 _7 K" l3 t0 \: E
  16. *    形    参:无
    1 K% [- n- \: \& A& [6 `8 F
  17. *    返 回 值: 错误代码(无需处理)& a9 \* n/ ~7 A8 ?- g
  18. *********************************************************************************************************; _; U- u6 |1 p7 _3 j3 h; q, j6 J
  19. */1 W" O6 e  i. ]7 Y& Q  J3 k3 ]/ c
  20. * S1 q5 G# |8 H- O: t+ b
  21. int main(void)
    4 v7 r2 @. J5 n3 X6 s0 d
  22. {: x" ^: o; D$ R* A
  23.      uint8_t ucKeyCode;     /* 按键代码 */
    9 t: Z. m) c5 \2 C) f5 f

  24. ! |; h7 {" M- _2 H7 ~
  25.      uint32_t t0 = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0;
    ) D6 k* U: Z. y- d

  26.   B% g- D& b' U( J$ j
  27.      /* 初始化EventRecorder并开启 */
    * }5 @% i+ B  c
  28. 9 z( n: {" s: C, C
  29.      EventRecorderInitialize(EventRecordAll, 1U);1 g, ^5 v1 J/ Y1 v

  30. 3 c7 }4 X9 F- }4 B8 A, t% _
  31.      EventRecorderStart();9 S, w0 n4 y/ j0 a+ s( n0 L  P" G# G

  32. 6 f9 B+ ]# S# n/ {# c5 |2 x% r
  33.      bsp_Init();        /* 硬件初始化 */
    ' [: ^6 S! r2 Y. f6 t; o, r
  34. 8 a, d& B, n6 t- A0 Y) E+ O( }
  35.      bsp_StartAutoTimer(0, 200); /* 启动1个200ms的自动重装的定时器 */' j! U3 Z4 e2 H6 z
  36. $ J. G2 J+ \# A
  37.      /* 测量中断周期 */
    2 ?" p) j/ y. G3 D$ {
  38.      vEventRecorderTest();
    # n$ X# Q, S  z
  39. ' p; ^( V$ A& v" c% ^. @
  40.      /* 进入主程序循环体 */
    $ U) H" |) E: V4 ]  p
  41.      while (1)$ Z% g' w) g6 L8 U
  42.      {
    ! e7 s, W/ {$ D* F: {, c8 \0 E
  43.          bsp_Idle();        /* 这个函数在bsp.c文件。用户可以修改这个函数实现CPU休眠和喂狗 */
    4 i6 N: f  L! Q4 ]! l7 Y

  44. , D% W% F2 P* w, e7 [' _
  45.          /* 判断定时器超时时间 */
    7 _# O$ ^& H9 a* ]8 a4 n! s
  46.          if (bsp_CheckTimer(0))
    + t) m. y1 g& A+ x" [3 D& Z
  47.          {
    * }$ e4 Q* B" P4 F7 I4 ]
  48.               EventStartA(0);  
    - A9 |& M' {6 w1 q4 Q4 f
  49.               EventStopA(0);
    % o* {/ w0 q* B/ r0 o  N8 L7 u: f
  50.               EventStartA(1);  c1 d, B) l3 r/ ?1 j. i" C
  51.               bsp_DelayMS(5);
    4 t0 ~' T6 }+ S4 N8 k# R: I/ e
  52.               EventStopA(1);6 z& N; E  o% M$ q7 Z) {+ ?7 J
  53.               EventStartA(2);
    2 W' O" x3 b( f  |2 m5 u9 v
  54.               bsp_DelayMS(30);, G# b' p* `  ]- {# }6 Z% ~
  55.               EventStopA(2);9 k1 l: g' `" w" }% z2 _# ?# r# t4 \

  56. , M5 H/ m7 b# e( m, D
  57.               t0++;
    . ]2 O/ U3 p- k
  58.               EventStartAv(3, t0, t0);. E+ f3 {4 B) o# }6 v
  59.               bsp_DelayMS(30);9 J' O/ F/ e5 J6 E) t
  60.               EventStopAv(3, t0, t0);
    5 s2 V0 q" X" ?. `) [
  61.          }* a3 k: S& u& e5 L0 T5 {, o0 H, Z6 N
  62. ! |! Y% q8 u+ ]' G4 v$ B* R
  63.          /* 按键滤波和检测由后台systick中断服务程序实现,我们只需要调用bsp_GetKey读取键值即可。 */3 _8 }, ^" `+ }1 W' I) ~
  64.          ucKeyCode = bsp_GetKey();   /* 读取键值, 无键按下时返回 KEY_NONE = 0 */( l, {5 W8 H, @2 [0 H
  65.          if (ucKeyCode != KEY_NONE)
    7 z! e6 P0 j- u
  66.          {
    ( g7 ?+ @- \6 r; [7 Z1 ?
  67.               switch (ucKeyCode)
    ) _, t9 o4 F3 v2 Y9 q+ ^
  68.               {. c: ~6 m4 L) T) g, Q
  69.                    case KEY_DOWN_K1:           /* K1键按下 */
    . y1 G! L( ~0 ~% \3 @( b
  70.                        t1 += 1;! q% C- Y4 X: x# J1 U
  71.                        t2 += 2;
    4 ?) {; f$ f5 y7 \( j, q8 m
  72.                        EventRecord2(1+EventLevelAPI, t1, t2);! X. P# e: Q% `; n: n) t
  73.                        t3 += 3;  x7 {9 o2 ^  k8 s2 {1 R! F
  74.                        t4 += 4;5 a4 `9 d  b" r
  75.                        EventRecord4(2+EventLevelOp, t1, t2, t3, t4);% R0 N9 k2 u( I% }
  76.                        EventRecordData(3+EventLevelOp, s_ucBuf, sizeof(s_ucBuf));8 n& m" I+ n; j9 U) T# F
  77.                        break;' t* k. J  d* C) r& c- p6 _
  78. $ w0 |7 t! W9 |" x. l
  79.                    case KEY_DOWN_K2:           /* K2键按下 */" T+ Z1 e  p8 A0 F
  80.                        printf("K2按键按下\r\n");, ^0 o$ B" j- [  G
  81.                        break;
    8 T" p% |7 I  A7 I1 ]
  82. $ C8 x1 g- ^+ B' @- I/ P6 Z
  83.                    case KEY_DOWN_K3:           /* K3键按下 */
    ( w! [# `3 e+ [! ?! y/ |# g
  84.                        printf("K3按键按下\r\n");
    " S' h/ l& p& d2 s( {# `/ I
  85.                        break;
    2 |/ z% q7 U6 m% f/ K

  86. $ n. }2 M) ^4 ^0 v4 Y6 g* q+ R
  87.                    default:
    0 ^" ?9 a* b7 p/ Z- `
  88.                         /* 其它的键值不处理 */% Q6 L) Y- z3 \1 C
  89.                        break;
    + M. S1 g  F& S# m3 G6 O! n9 A
  90.               }
    + Z" N* O" `/ E3 ]! ^
  91.          }  w' ^: b# j% ^: f7 n
  92.      }
    $ Z5 K, l+ N! G* N+ m
  93. }
复制代码


) @* _( M0 M  u6 f/ Z

应用程序里面主要实现了三个功能:

  1、利用测量分组A实现4路时间的测量(第1路什么也没有测量,可以用来表示这两个函数本身执行占用的时间)。每100ms测量一次时间,效果如下:

  2、利用函数EventRecord2,EventRecord4和EventRecordData发送消息事件。按下按键K1进行更新,效果如下:

  3、基于Event Recorder的printf重定向。按下按键K2或者K3会打印消息,效果如下:

8.14 总结

Event Recoder还是非常实用的,建议大家多使用几次,熟练掌握。基本用上几次就上瘾,离不开了,的确是工程调试的利器。


; H2 u& q# W' v, v! o
赞 收藏 评论0 发布时间:2022-1-1 18:00

举报

0个回答

所属标签

相似技术帖

官网相关资源

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