1. 基本介绍

nr_micro_shell 就是一个命令行交互工具，可以读取用户的命令输入，解析并执行命令对应的函数。nr_micro_shell 对于 ROM 和 RAM 的资源占用比较少，非常适合用于在嵌入式 MCU 的使用场合。

nr_micro_shell具有以下优点

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

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

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

移植完之后的启动效果如下：

作者的代码仓库地址：

https://gitee.com/nrush/nr_micro_shell

2. 在 STM32+FreeRTOS上移植使用

我所使用的硬件平台是 STM32F407ZGT6，移植前我们需要准备好可以正常运行 FreeRTOS 和可以正常通过 printf 打印输出到串口终端的工程源码。如果使用裸机的话，那么就不用把 FreeRTOS 添加进来了，而且使用裸机移植会更简单。

要有正常运行 FreeRTOS 和串口工程源码，对于 STM32 来说非常方便，直接使用 STM32CubeMX 生成一份 MDK 的工程源码就行，这里我不多介绍这点了。

2.1 添加 nr_micro_shell 源码到工程目录

把 nr_micro_shell 源码拷贝到自己的工程目录下

添加 nr_micro_shell /src 目录的所有C文件，和 nr_micro_shell /examples 目录下的 nr_micro_shell_commands.c 文件。

添加头文件路径包含：

2.2 修改 nr_micro_shell_config.h 配置文件

1、把下面第44、45行包含了 RT-Thread 的头文件给注释掉，或者自己定义 NR_MICRO_SHELL_SIMULATOR 这个宏进行头文件包含屏蔽也可以。

2、对于 shell 输出的末尾行模式，我们选择修改为 1 ，即选择 \r 结尾。原来的代码默认是 0，即 \n 结尾，如果选择默认的行结尾模式的话，会导致 shell 终端运行不正常（我踩了这个坑，输入回车之后，命令不会执行。）

其实选择默认的 \n 结尾模式也可以，但是 shell 接收到 \r 结尾符的时候，要多输出一个 \n 。如下代码：

void task_shell(void const * argument)
{
   
	char ch;
    
	for(;;)
	{
   
		ch = uart1_get_char();
		shell(ch);
		if (ch == '\r')			// 遇到 \r 的时候，shell要多接收一个 \n 字符
			shell('\n');
	}
}

2.3 实现串口输出一个字符函数

在 nr_micro_shell_config.h 文件中的 144、145 行使用到了库函数 printf 和 putchar 函数，我们需要重新实现 fputc 函数才能正常打印输出，不然会导致程序死掉。

fputc 函数代码如下：

int fputc(int ch, FILE