RT-Thread零基础快速入门第7讲——FinSH控制台「建议收藏」

RT-Thread零基础快速入门第7讲——FinSH控制台「建议收藏」目录一、前言源码链接二、FinSH控制台使用方法第一步:配置FinSH第二步:烧录程序并把串口连接到PC端第三步:打开xshell或者串口助手第四步:测试FinSH命令三、自定义FinSH命令自定义msh命令自定义C-Style命令和变量自定义命令重命名四、项目实战五、结束语一、前言本来我是打算先讲完RT-thread的内核,再讲设备和组件,但是考虑到后面很多地方都会用到FinSH控制台…

大家好,又见面了,我是你们的朋友全栈君。

一、 前言

本来我是打算先讲完RT-thread的内核,再讲设备和组件,但是考虑到后面很多地方都会用到FinSH控制台,所以我就先把这个讲了,这样大家在后面的学习就不会有很多疑问了。
FinSH 是 RT-Thread 的命令行组件(shell),它提供一套供用户在命令行调用的操作接口,主要用于调试或查看系统信息,可以使用串口 / 以太网 / USB 等方式与 PC 机进行通信。一般我们默认用串口1和PC机通讯,通过串口我们可以查看单片机运行的情况,也可以通过发送命令控制单片机执行某些操作。关于FinSH更多详细的内容,大家可以在官网上面查看。
FinSH控制台组件介绍:https://www.rt-thread.org/document/site/programming-manual/finsh/finsh/#

源码链接

我发布的所有关于RT-thread的教程源代码都在下面这个链接里面,随着我教程的更新,新的代码也会加入进去。
教程源码下载链接:https://pan.baidu.com/s/1N2D8dM31deKIqNqaIQfPiA
提取码:7nsx

二、FinSH控制台使用方法

第一步:配置FinSH

在一个项目工程中打开env,输入menuconfig,选中finsh shell选项即可,一般默认都是打开的。
如果你不知道menuconfig怎么使用,可以在下面这个链接查看。
Menuconfig使用方法:https://www.rt-thread.org/document/site/programming-manual/env/env/#bsp-menuconfig
在这里插入图片描述使能串口1,这个如果没有修改过的话,也是默认打开的
在这里插入图片描述

第二步:烧录程序并把串口连接到PC端

单片机把配置好的工程下载到板子上,并通过usb转串口把单片机的串口1连接到电脑上。

第三步:打开xshell或者串口助手

在这里插入图片描述

第四步:测试FinSH命令

复位一下单片机就可以看到上电时串口打印的版本信息
在这里插入图片描述
FinSH控制台的基本操作和Linux是一样的
在这里插入图片描述
我们可以先输入tab键查看当前系统支持的命令。如下图所示,左边是命令名称,右边是关于命令的描述,如下图所示。
在这里插入图片描述
我们输入命令之后按下回车键就可以执行命令了,例如我输入list_thread命令,会返回了所有线程的信息,如下图所示,led0和led1是我自己创建的线程,另外几个则是系统的线程。
在这里插入图片描述
这些命令的作用我就不一一描述了,大家可以在官网上面查看。
FinSH内置命令详解:https://www.rt-thread.org/document/site/programming-manual/finsh/finsh/#finsh_2

三、自定义FinSH命令

自定义FinSH命令是这一讲我重点要讲的内容,在项目的实际应用中,为了方便调试,我们经常会自定义FinSH命令。
Rt-thread支持三种自定义模式

自定义msh命令

这是传统的命令行模式,也是最常用的一种。
在这里插入图片描述
该命令可以导出有参数的命令,也可以导出无参数的命令。导出无参数命令时,函数的入参为 void,示例如下:

void hello(void)
{ 
   
    rt_kprintf("hello RT-Thread!\n");
}
MSH_CMD_EXPORT(hello , say hello to RT-Thread);//hello是命令名称,say hello to RT-Thread是命令描述

导出有参数的命令时,函数的入参为 int argc 和 char**argv。argc 表示参数的个数,argv 表示命令行参数字符串指针数组指针。导出有参数命令示例如下:

static void atcmd(int argc, char**argv)
{ 
   
    ……
}
MSH_CMD_EXPORT(atcmd, atcmd sample: atcmd <server|client>);

自定义C-Style 命令和变量

自定义C-Style命令能够解析执行大部分 C 语言的表达式,并使用类似 C 语言的函数调用方式访问系统中的函数及全局变量,此外它也能够通过命令行方式创建变量,不过我个人基本没怎么用这种方式,最常用的还是msh命令。
在这里插入图片描述
以下示例定义了一个 hello 函数,并将它导出成 C-Style 模式下的命令

void hello(void)
{ 
   
    rt_kprintf("hello RT-Thread!\n");
}
FINSH_FUNCTION_EXPORT(hello , say hello to RT-Thread);

以下示例定义了一个 dummy 变量,并将它导出成 C-Style 模式下的变量命令:

static int dummy = 0;
FINSH_VAR_EXPORT(dummy, finsh_type_int, dummy variable for finsh)

自定义命令重命名

FinSH 的函数名字长度是有限制的,默认是 16 字节。因此当一个函数名长度超过了上限,只有函数名前16个字节会保留下来,所以如果输入了全部命令执行的时候就会出错。这时就可以使用自定义命令重命名来对导出的命令进行重命名了。
在这里插入图片描述
在重命名的命令名字前加 _cmd 就可以将命令导出到 msh 模式,否则,命令会被导出到 C-Style 模式。以下示例定义了一个 hello 函数,并将它重命名为 ho 后导出成 C-Style 模式下的命令。

void hello(void)
{ 
   
    rt_kprintf("hello RT-Thread!\n");
}
FINSH_FUNCTION_EXPORT_ALIAS(hello , ho, say hello to RT-Thread);

四、项目实战

我这里创建了两个自定义msh命令,一个是带参数的一个是不带参数的。

#include <rtthread.h>
#include <rtdevice.h>
#include <board.h>
#define LED0_PIN GET_PIN(F, 9)
#define LED1_PIN GET_PIN(F, 10)
#define THREAD_PRIORITY 25 //线程优先级
#define THREAD_TIMESLICE 5 //线程时间片
/* 静态线程参数定义 */
ALIGN(RT_ALIGN_SIZE)
static char led1_stack[1024];  //线程栈内存空间
static struct rt_thread led1;  //线程句柄
int main(void)
{ 

int i = 0;
while (1)
{ 

rt_thread_mdelay(200);
}
}
/* led0函数 */
void led0_init(void)
{ 

rt_pin_mode(LED0_PIN, PIN_MODE_OUTPUT);
while(1)
{ 

rt_pin_write(LED0_PIN, PIN_LOW);
rt_kprintf("LED0_ON \n");
rt_thread_mdelay(1000);
rt_pin_write(LED0_PIN, PIN_HIGH);
rt_kprintf("LED0_OFF \n");
rt_thread_mdelay(1000);
}
}
MSH_CMD_EXPORT(led0_init, led0 init);
/* msh命令测试函数: argc是输入变量的个数,argv是输入变量的内容 */
void msh_test(int argc, char**argv)
{ 

/* 检查输入的变量是否有两个 */
if (argc < 2)
{ 

rt_kprintf("Please input'msh_test <a|b>'\n");
return;
}
if (!rt_strcmp(argv[1], "a"))
{ 
/* 输入的是a */
rt_kprintf("Hello world ! \n");
}
else if (!rt_strcmp(argv[1], "b"))
{ 
/* 输入的是b */
rt_kprintf("Hello RT-thread ! \n");
}
else
{ 
/* 输入的是其他内容 */
rt_kprintf("Please input'msh_test <a|b>'\n");
}
}
MSH_CMD_EXPORT(msh_test, msh test sample : msh_test a|b);

运行的结果如下图所示:
执行“led0_init”指令之后,led灯就跑起来了。
在这里插入图片描述
这是带参数的指令,输入的时候除了指令的输入还需要再输入一个参数,输入不同的参数会有不同的效果,具体要执行什么操作可以在函数里面自己去定义。
在这里插入图片描述
到这里可能有些同学就会问了,如果我不想用命令导出那要怎么做?这就需要用到自动初始化了,比如INIT_APP_EXPORT()函数,用了自动初始化函数之后就不需要手动输入命令去调用了,关于自动初始化的更多内容我后面会单独写一篇博客。

五、结束语

好了,关于FinSH控制台的编程讲解就到这里,如果还有什么问题可以私信给我。如果需要本文对应的源码的话可以在博文前言部分的链接下载。
如果觉得这篇文章对你有用,点赞+关注支持一下博主呗。
后续我会继续更新RT-thread入门教程系列,如果感兴趣的同学可以关注一下博主,谢谢!

RT-thread相关教程汇总:https://blog.csdn.net/ShenZhen_zixian/article/details/120563891

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/143437.html原文链接:https://javaforall.cn

【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛

【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

(0)
blank

相关推荐

  • busybox rootfs 与 ubuntu rootfs_boot.img root

    busybox rootfs 与 ubuntu rootfs_boot.img root下载busybox的源码,解压后,设定ARCH和CROSS_COMPILE的两个基本环境变量,选择defconfig作为默认配置,大部分的busybox工具都会被编译出来。如果不指定输出目录,默认输出到根目录的_install目录下面,如果需要指定目录,配置CONFIG_PREFIX=/a/b/c/rootfs,这样make生成的/bin,/sbin,/usr三个默认文件夹就直接在rootfs目录下。makeARCH=armCROSS_COMPILE=arm…

  • 亿能bms上位机_上位机软件 上位机PC软件 bms电池管理系统测试系统软件「建议收藏」

    亿能bms上位机_上位机软件 上位机PC软件 bms电池管理系统测试系统软件「建议收藏」上位机软件上位机PC软件bms电池管理系统测试系统软件上海鸣野软件开发公司从创立伊始就立足于差异化竞争,只做自己有竞争优势的事,13391389262,,在上位机软件,上位机开发,bms电池管理系统测试系统软件,上位机软件外包积累了丰富的开发经验,通过学习和创新,不断地扩大和加强公司在行业中的优势,是企业发展之道。关注别人所不关注的,看到别人所看不到的,做到别人所做不到的,是鸣野软件开发公司*…

  • 很黄很暴力国际版「建议收藏」

    很黄很暴力国际版「建议收藏」英文版:Veryeroticandveryviolent正体中文版:很黃很暴力大陆版:很黄很暴力日本版:すごくエッチで乱暴でならない荷兰版:Zeergeelenzeerhevig葡萄牙版:Muitoamareloemuitoviolento俄语版:Оченьжелтыйцветиоченьяростная法语版:Trèsjauneettrèsviolent

    2022年10月14日
  • 【Java面试题】一次完整的Http请求过程(非常详细)

    【Java面试题】一次完整的Http请求过程(非常详细)当我们在浏览器的地址栏输入 www.google.com ,然后回车,回车这一瞬间到看到页面到底发生了什么呢?以下过程仅是个人理解:域名解析–>发起TCP的3次握手–>建立TCP连接后发起http请求–>服务器响应http请求,浏览器得到html代码–>浏览器解析html代码,并请求html代码中的资源(如js、css、图片等)

  • Java线程池设置名称,看完必会

    点击上方☝,轻松关注!及时获取有趣有料的技术文章本文讲一下Java线程池中创建 ThreadFactory 设置线程名称的三种方式。设置线程名称是很重要的,如果你没有设置过,说明你还“涩…

  • leetcode 回文数_字符串反转java

    leetcode 回文数_字符串反转java原题链接请你来实现一个 myAtoi(string s) 函数,使其能将字符串转换成一个 32 位有符号整数(类似 C/C++ 中的 atoi 函数)。函数 myAtoi(string s) 的算法如下:读入字符串并丢弃无用的前导空格检查下一个字符(假设还未到字符末尾)为正还是负号,读取该字符(如果有)。 确定最终结果是负数还是正数。 如果两者都不存在,则假定结果为正。读入下一个字符,直到到达下一个非数字字符或到达输入的结尾。字符串的其余部分将被忽略。将前面步骤读入的这些数字转换为整数(即,“1

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号