RTT4-RTThread使用Shell finsh及TC测试框架.doc

使用RT-Thread 1.0.2 部分引自 HYPERLINK /Prife \t _blank Prife的《RT_Thread的测试框架使用及分析》，仔细阅读后作了修订。 /prife/article/details/7487038 1.Finsh组件配置 在例程源代码中，系统配置已经完毕，首先是修改了 rtconfig.h 文件，将使用 Finsh组件的宏打开 其次将 Finsh 组件的源文件加入到工程中编译 2.连接串口 下载程序后，连接好串口1，打开SecureCRT.exe，设置波特率115200，后连接。 3.使用命令 开发板上电后，显示： 输入list()后回车 ，list()命令的作用就是将系统中支持的所有 shell命令都打印出来，也可以按TAB键。有点类似与其他系统中的 help命令。有了这些命令和描述信息，我们就可以深入内核，查看它们的信息。 当前系统中运行的线程信息。敲入 list_thread()，回车。 当前系统实际运行时所有线程信息。当前系统中运行着10个线程。 线程的名称，优先级，运行状态，堆栈地址，堆栈大小，最大使用堆栈，剩余运行 tick 时间，错误信息都一览无遗，呵呵，是不是很方便。 其实，Finsh 的更强大功能还等着你挖掘呢. 4.一个最简单的测试用例（不使用TestCase框架） 在application.c中的最后添加如下代码 int testfunc(void) { rt_kprintf(hello, rt-thread!\n); return 0; } #include finsh.h FINSH_FUNCTION_EXPORT(testfunc, just a test function); 重新编译工程，启动串口工具 输入命令 list() 或者按Tab键 多出一行。 接下来，在finsh上输入 t 然后按下Tab键，finsh会自动地为我们补全testfunc，然后我们手动输入 ()后回车，可以看到如下运行效果： finsh /testfunc() hello, rt-thread! 0, 0finsh / 注：finsh跟linux下的shell很像，都具有tab键自动补全的功能，但是又有些不同，finsh的命令是C语言风格的，命令即函数调用语句。 实际上，在正式的项目开发中，测试是非常重要的环节，是程序质量的重要保障。我们可能为此编写大量的测试用例，此时一个一个在finsh中手动的输入函数名来运行测试用例的方式显然后有些原始，这个工作没有任何技术含量，枯燥乏味且令人恼火，那么这种情况下，改怎么办呢？ 5.测试用例框架 别担心，RTT为我们提供了所谓的 测试用例(TestCase, 简称为TC) 框架。TC框架可以帮助我们依次，自动的调用多个测试用例函数。 将添加一个testfunc2函数，跟testfunc函数一起采用TC框架，首先准备两个测试用例代码（为了代码的清晰，我么将测试用例放在独立的c文件中）. 5.1 新建文件 在当前BSP主目录下，创建一个名为testcase的文件夹。将下面代码保存为 testfunc1.c ，存放到testcase/下。 #include rtthread.h void testfunc1(void) { rt_kprintf(hello, rt-thread! this is testfunc1\n); } #include finsh.h FINSH_FUNCTION_EXPORT(testfunc1, just a test function); 将下面代码保存为 testfunc2.c 存放到testcase/下。 #include rtthread.h void testfunc2(void) { rt_kprintf(hello, rt-thread! this is testfunc2\n); } #include finsh.h FINSH_FUNCTION_EXPORT(testfunc2, just a test function); 5.2编写基于TC框架的测试用例 1. 修改rtconfig.h 使能如下两个宏 #define RT_USING_TC #define RT_USING_FINSH 2.添加TC框架源码以及测试用例源码 因为TC测试框架需要如下这两个文件，tc_comm.ctc_comm.h这两个文件位于RTT源码包examples/kernel/目录下，此目录下出这两个文件以外，还包含其他很多文件，那些文件是RTT官方提供基于TC框架的测试用例，它们用于测试RTT内核的基本功能。 这里，笔者要忍不住吐槽两句，当前RTT的文件放置仍然