RT Thread RTOS应用之二——使用finsh组件.doc

RT Thread RTOS应用之二使用finsh shell系统实验描述：开启RTT 的finsh组件；向finsh中添加用户函数；利用finsh观察RTT个线程的运行状态；通过finsh调用用户函数。实验讲解开始：“每个线程栈应该设定多大最合适？”，“当前到底启动了哪几个线程？”“我的程序没有正常运行，到底是哪个线程出现了问题？”，“我想要随时获得任意变量的数值应该怎么办？”，“我想要在程序运行中，人为插入一些操作应该如何实现？”。这些问题都是使用RTOS的人经常会碰到的，这些问题在传统的OS中并不好解决，需要用户自行设计解决方法。而在RT Thread中却非常容易解决。原因就在于他的finsh shell系统。RT-Thread的shell系统finsh，提供了一套供用户在命令行操作的接口，主要用于调试、查看系统信息。finsh被设计成一个不同于传统命令行的C语言表达式解释器：由于很多嵌入式系统都是采用C语言来编写，finsh正是采用了这种系统软件开发人员都会的语法形式，把C语言表达式变成了命令行的风格。它能够解析执行大部分C语言的表达式，也能够使用类似于C语言的函数调用方式访问系统中的函数及全局变量，此外它也能够通过命令行方式创建变量引自RT-Thread实时操作系统编程指南。移植finsh系统移植finsh系统非常简单，只需要将rtt文件夹中的components文件夹下的finsh文件夹中的文件添加进入MDK。结果如图：之后，在MDK中包含finsh的文件路径，以保证可以检测到全部finsh相关的头文件，如下图所示：开启finsh系统在RTT中启用finsh系统非常容易，只需要在rtconfig.h头文件中，定义/* SECTION: finsh, a C-Express shell */#define RT_USING_FINSH/* Using symbol table */#define FINSH_USING_SYMTAB#define FINSH_USING_DESCRIPTION这三个宏。其中第一个宏会开启finsh系统。后面两个宏可以使finsh系统支持列表输出和输出函数描述。修改finsh对应usart端口默认情况下finsh使用usart1端口，如果你需要更改finsh对应的usart端口，可以按照下面三个步骤来进行：1. 修改STM32_CONSOLE_USART宏的数值。该宏定义在board.h头文件下。/ Console on USART: no console USART 1 USART 2 USART 3/ Default: 1#define STM32_CONSOLE_USART1默认是1，表示usart1端口，你可以根据自己的需要修改端口号2. 修改RT_USING_UART1的数值/* SECTION: Device System */* Using Device System */#define RT_USING_DEVICE#define RT_USING_UART1如果你需要使用usart2的话，需要将这个宏定义成RT_USING_UART23. 修改startup.c文件#ifdef RT_USING_FINSH/* init finsh */finsh_system_init();finsh_set_device(uart1);#endif将其中标红的uart1修改成你需要的端口号码，如uart2等。4. 修改MDK设置为了保证用户自行添加的函数不会被编译器优化掉，需要修改MDK的设置，如下：在Misc controls标签下，键入”-keep _fsym_* -keep _vsym_*”这个命令，该命令会保留未被函数主体调用的函数。至此，finsh的修改和配置就完成了。连接finshFinsh系统通过usart端口与PC端的232串口相连接。调试推荐使用windows自带的超级终端。具体的通讯参数如下：串口设置：每秒位数 115200数据位 8奇偶校验 无停止位 1数据流控制 无下面介绍一下finsh中经常使用的函数为了照顾C语言编写者的习惯（也就是照顾咱们的习惯），finsh中每个命令后面都需要一个()表示结束，同时如果函数带有参数，参数按照顺序写入（）中。这点和平时C语言书写函数一样。常用的finsh命令：1.list_thread()这个命令可以将当前系统的线程状态返回到超级终端中，通过这个函数我们可以获得当前系统中运行的线程名称，数量，以及其线程栈的使用情况。并且RTT会记录每个线程最大的线程栈使用情况，这样为我们优化程序，降低程序资源占用提供了很大的方便。2. 宏方式输出函数、变量当使能了FINSH USING SYMTAB宏时，也能够使用宏输出的方式向finsh shell增加命令。当需要输出函数或变量到finsh shell时，可以通过引用宏：FINSH FUNCTION EXPORT和FINSH VAR EXPORT的方式例如本例中，为了通过finsh控制LED2的状态，编写了LED2控制函数LED2_control(char state),并且将该函数添加进入finsh系统：#ifdef RT_USING_FINSH#include void LED2_control(char state) if (state=0) LED2(OFF);/0表示LED2关闭 else LED2(ON);/非0表示LED2开启 FINSH_FUNCTION_EXPORT(LED2_control, control LED2s state);/将该函数添加进入finsh，方便以后调用#endif其他的相关finsh命令请参考RT-Thread实时操作系统编程指南程序实现：本例为建立在第一个例子之上，添加了finsh系统，可以通过超级终端控制野火开发板上的LED2的状