一个开源轻量级单片机命令行交互组件

命令行交互在上位机软件中很常见，在单片机中实现命令交互也有很多案例。这里我想分享一个开源的命令行工具：nr_micro_shell。

项目地址: github.com/Nrusher/nr_micro_shell

1、工具介绍

在调试和维护单片机时，经常需要与单片机进行交互，获取、设置参数或执行操作。nr_micro_shell是一个基本命令行工具，专为资源较少的MCU编写。

尽管RT_Thread组件中提供了强大的finsh命令行交互工具，但对于ROM和RAM资源较少的单片机，finsh显得有些庞大。在这些平台上，如果希望保留基本的命令行交互功能，nr_micro_shell是一个不错的选择。

nr_micro_shell具有以下优点：

1. 占用资源少，使用简单，灵活方便。使用过程只需要调用shell_init()和shell()两个函数，无论是使用RTOS还是裸机都可以方便地应用该工具，不需要额外的编码工作。

2. 交互体验好。它完全类似于Linux的shell命令行，当串口终端支持ANSI（如Hypertrm终端）时，它不仅支持基本的命令行交互，还提供了Tab键命令补全、查询历史命令和方向键移动光标的修改功能。

3. 扩展性好。nr_micro_shell为用户提供自定义命令的标准函数原型，用户只需要按照命令编写相应的命令函数，并注册这些命令函数，就可以使用这些命令。

你还可能想知道nr_micro_shell和相同配置下的finsh（finsh不使用msh）在资源占用方面的对比情况。

两者配置都为

• 最多3条历史命令。
• 支持Tab补全 。
• 命令行最大长度为100。
• 最多10个命令参数。
• 命令行线程堆栈为512字节。

nr_micro_shell演示效果如下

1.1 目录结构

1.2 许可证

nr_micro_shell package 遵循 MIT 许可，详见 LICENSE 文件。

1.3 依赖

无依赖

2、RT_Thread 下 ENV 工具使用

RT_Thread 使用 nr_micro_shell package package 需要在 RT-Thread 的包管理器中选择它，具体路径如下：

RT-Thread online packages
    tools packages ---> 
        [*] nr_micro_shell:Lightweight command line interaction tool. --->

相关的设置在按下sapce键选中后，按enter可进行相关参数配置。然后让 RT-Thread 的包管理器自动更新，或者使用 pkgs --update 命令更新包到 BSP 中。

若您需要运行示例，请保证RT_Thread配置中的Using console for kt_printf.选项是被打开的，kt_printf可以正常工作，且Use components automatically initialization.选项打开。编译直接下载或仿真便可以使用nr_micro_shell。命令行空白时按Tab，可显示所有支持的命令，测试示例命令可见doc/pic下的使用示例动图。自定义命令过程，参照下文3. 裸机下使用nr_micro_shell package中的方法。

3、裸机下使用

3.1 配置:

所有配置工作都可以在 *nr_micro_shell_config.h* 中完成。有关详细信息，请参见文件中的注释。

3.2 用法:

• 确保所有文件都已添加到项目中。
• 确保 *nr_micro_shell_config.h* 中的宏函数”shell_printf()，ansi_show_char()”可以在项目中正常使用。
• 使用示例如下

#include "nr_micro_shell.h"

int main(void)
{
    /* 初始化 */
    shell_init();

    while(1)
    {
        if(USART GET A CHAR 'c')
        {
            /* nr_micro_shell接收字符 */
            shell(c);
        }
    }
}

建议直接使用硬件输入前，建议使用如下代码(确保可以正常打印信息)，验证nr_micro_shell是否可以正常运行

#include "nr_micro_shell.h"

int main(void)
{
    unsigned int i = 0;
    //匹配好结束符配置 NR_SHELL_END_OF_LINE 0
    char test_line[] = "test 1 2 3\n"
    /* 初始化 */
    shell_init();
    
    /* 初步测试代码 */
    for(i = 0; i while(1)
    {
        if(USART GET A CHAR 'c')
        {
            /* nr_micro_shell接收字符 */
            shell(c);
        }
    }
}

3.3 添加自己的命令

STEP1:

您需要在nr_micro_shell_commands.c*中实现一个命令函数。命令函数的原型如下

void your_command_funtion(char argc, char *argv)
{
    .....
}

argc是参数的数目。argv存储每个参数的起始地址和内容。如果输入字符串是

test -a 1

则argc为3，argv的内容为

-------------------------------------------------------------
0x03|0x08|0x0b|'t'|'e'|'s'|'t'|'\0'|'-'|'a'|'\0'|'1'|'\0'|
-------------------------------------------------------------

如果想知道第一个或第二个参数的内容，应该使用

/* "-a" */
printf(argv[argv[1]])
/* "1" */
printf(argv[argv[2]])

STEP2: 在使用命令前需要注册命令，共有两种方法注册命令

1.当配置文件中NR_SHELL_USING_EXPORT_CMD未被定义，在static_cmd[]表中写入

const static_cmd_st static_cmd[] =
{
   .....
   {"your_command_name",your_command_funtion},
   .....
   {"\0",NULL}
};

*注意：不要删除{“\0″，NULL}！*

2.当配置文件中NR_SHELL_USING_EXPORT_CMD被定义，且NR_SHELL_CMD_EXPORT()支持使用的编译器时，可以使用以下方式注册命令

NR_SHELL_CMD_EXPORT(your_command_name,your_command_funtion);

4、linux下使用nr_micro_shell仿真

在工程./examples/simulator/目录下存放着nr_micro_shell仿真代码，仍在./examples/nr_micro_shell_commands.c文件中按上述方式添加自定义命令，添加完成后可以使用make命令编译源码，生产的可执行文件为./examples/simulator/out/nr_micro_shell或./examples/simulator/out/nr_micro_shell_db。可使用的make命令如下

# 编译可执行文件
make
# 编译可仿真执行文件
make debug
# 清除编译生成文件
make clean

5、注意事项

根据你的使用习惯使用NR_SHELL_USING_EXPORT_CMD选择命令注册方式。

使用注册表注册命令时，确保您的工程中存在注册表

const static_cmd_st static_cmd[] =
{
   .....
   {"\0",NULL}
};

使用NR_SHELL_CMD_EXPORT()时确保，NR_SHELL_CMD_EXPORT()支持使用的编译器，否则会报错。

nr_micro_shell 不支持ESC键等控制键（控制符）。

以上就是良许教程网为各位朋友分享的Linu系统相关内容。想要了解更多Linux相关知识记得关注公众号“良许Linux”，或扫描下方二维码进行关注，更多干货等着你 ！