MM32F013x——Event Recorder使用方法

两只袜子 · 发表于 2021-5-20 14:50

Event Recorder简介
Event Recorder的特色主要有以下几个方面：
1. 提升应用程序动态执行期间的检测能力。
2. 支持事件类型滤除机制，比如运行错误，API调用，内部操作和操作信息的区分。
3. 可以在任务中，RTOS内核中和中断服务程序中任意调用。
4. 对于带ITM功能的Cortex-M3/M4/M7/M33内核芯片，执行记录期间，全程无需开关中断操作。
对于不带ITM功能的Cortex-M0/M0+/M23，是需要开关中断的。
5. 支持printf重定向。
6. 各种Link通吃，支持SWD接口或者JTAG接口方式的J-Link、U-Link和CMSIS-DAP。
7. 对于带DWT时钟周期计数器功能的Cortex-M3/M4/M7/M33内核芯片，创建时间戳时，可以有效降低系统负担，无需专用定时器来实现。
8. Event Recorder执行时间具有时间确定性，即执行的时间是确定的，而且执行速度超快，因此，实际产品中的代码依然可以带有这部分，无需创建debug和release两种版本。
9. RTX5及其所有中间件都支持Event Recorder调试。

两只袜子 · 发表于 2021-5-20 14:52

本帖最后由两只袜子于 2021-5-20 14:54 编辑

创建Event Recorder工程
01
添加Event Recorder组件
使用MDK5.25以上版本创建MM32F013x工程模板（或者是能够被MDK5.25版本正确打开的工程），具体的工程搭建这里不做过多的介绍，具体请参考MM32官方的工程搭建文档。
111119umonmnuo93pjb997.png.thumb.jpg

两只袜子 · 发表于 2021-5-20 14:54

打开RTE（Manage Run-time-Environment窗口），在Compiler组件下勾选Event Recorder，并在Compiler组件下面的I/O组件下中的STDOUT中的Variant修改为EVR，此处的修改是为了将printf函数冲定向到Event Recorder上。

在需要使用Event Recorder的代码处，直接调用Event Recorder的API函数，如果需要使用printf函数的地方直接使用printf函数输出即可，在MDK中需要勾选microLib，并删掉文件中的重定向函数。

两只袜子 · 发表于 2021-5-20 14:56

添加Event Recorder的功能以后，打开EventRecorderConf.h，具体的配置如下：

Number of Recorder：表示Event Recorder缓冲可以记录的消息条数。
Time Stamp Source：表示时间戳来源，有如下四种可以选择，我们这里使用DWT时钟周期计数器。
到此，添加工程文件已经完成。

两只袜子 · 发表于 2021-5-20 14:58

02
Event Recorder注意事项
使用CMSIS软件包一定要使用当前最新的，否则可能会出现错误。
下载完成以后需要将工程下面Device文件夹下面的\CMSIS\KEIL_CORE文件中的文件替换为MDK安装路径下面ARM\PACK\ARM\CMSIS\5.3.0\CMSIS\Include中的文件。

03
Event Recorder代码实现
在主函数中加入Event Recorder初始化函数：EventRecorderInitialize(EventRecordAll, 1U);
EventRecorderStart();

在主函数的wilie循环中加入以下函数：EventStartA(0);
BSP_LED1_TOGGLE();
EventStopA(0);

EventStartA(1);
BSP_LED2_TOGGLE();
EventStopA(1);

EventStartA(2);
BSP_LED3_TOGGLE();
EventStopA(2);

t0++;
EventStartAv(3, t0, t0);
BSP_LED4_TOGGLE();
EventStopAv(3, t0, t0);
t1 += 1;
t2 += 2;
EventRecord2(1 + EventLevelAPI, t1, t2);

两只袜子 · 发表于 2021-5-20 15:01

04
API接口函数
时间测量功能简单易用，仅需一个起始函数，一个停止函数即可。当前支持4组，每组支持16路测量，也就是可以同时测量64路。
时间测量的API函数支持多任务和中断里面随意调用，测量起始函数：EventStartG(slot) 或者EventStartGv (slot, val1, val2)，函数中的字母G是表示分组A，B，C，D，即实际调用函数为EventStartA，EventStartB，EventStartC和EventStartD，函数的第一个形参slot的范围是0-15，也就是每个分组可以测试16路，函数后面的两个形象val1和val2是32位变量，用户可以用这两个形参来传递变量数值给Event Statistics调试组件里面，方便图形化展示。简单的说，这两个变量仅仅起到一个传递变量数值的作用。
测量停止函数：EventStopG(slot) 或者EventStopGv (slot, val1, val2)，函数中的字母G是表示分组A，B，C，D，即实际调用函数为EventStopA，EventStopB，EventStopC和EventStopD，函数的第一个形参slot的范围是0-15，也就是每个分组可以测试16路，函数后面的两个形象val1和val2是32位变量，用户可以用这两个形参来传递变量数值给Event Statistics调试组件里面，方便图形化展示。简单的说，这两个变量仅仅起到一个传递变量数值的作用。
到此程序的配置已经完成。