全网首发，硬核！小华HC32F072之nr_micro_shell移植+源码

原创嵌入式ARM 2023-08-21 12:01

TI MCU方案：能源基础设施实时控制 如何提升高压系统的实时性能?

周末在家，闲来无事，顺便把前段时间研究的一个开源代码库的移植案例整理分享出来，希望给大家提供便利。

我移植的MCU是小华HC32F072。

一、开源nr_micro_shell介绍

在进行调试和维护时，常常需要与单片机进行交互，获取、设置某些参数或执行某些操作，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）占用资源对比，如下表所示：

	原始工程	添加nr_micro_shell增加量	添加finsh增加量
ROM	63660	+3832	+26908
RAM	4696	+1104	+1304

代码仓库地址：https://gitee.com/nrush/nr_micro_shell

二、移植步骤

这么优秀的一个代码库，我们又该如何移植呢？如果你学会了移植到某一款MCU上之后，其他MCU都是照葫芦画瓢。

1、使用git工具下载源码到你的工程目录下：

然后把源码添加到mdk工程中，如下图所示：

2、接下来，我们就要修改源码中的接口函数了。

（1）修改nr_micro_shell_config.h文件中的一个宏定义和一个uart发送字符的接口函数：

（2）在ansi_port.c中，修改接口如下：

（3）此时基本就改好了，你会发现有了发送，接收怎么办呢？

这就需要在自己工程中的串口接收中断函数中添加一个shell(ch);接口函数：

值得注意的是，此接口也可以不放在中断里面哦，也可以放在RTOS中的某个任务里。

（4）万事俱备，只欠东风啦！那是啥呢？聪明的你应该想到了，那就是初始化！调用 shell_init();接口即可。

三、测试验证

四、扩展

那么，如何添加自己的命令呢？源码nr_micro_shell_commands.c中有模板：

我自己添加的cmd如下：


/** * [url=home.php?mod=space&uid=247401]@brief[/url] ls command */void shell_ls_cmd(char argc, char *argv){        unsigned int i = 0;        if (argc > 1)        {                if (!strcmp("cmd", &argv[argv[1]]))                {                        for (i = 0; nr_shell.static_cmd[i].fp != NULL; i++)                        {                                shell_printf("%s",nr_shell.static_cmd[i].cmd);                                shell_printf("\r\n");                        }                }                else if (!strcmp("-v", &argv[argv[1]]))                {                        shell_printf("version date: 20230326.\r\n");                }                else if (!strcmp("-h", &argv[argv[1]]))                {                        shell_printf("useage: ls [options]\r\n");                        shell_printf("options: \r\n");                        shell_printf("\t -h \t: show help\r\n");                        shell_printf("\t -v \t: show version\r\n");                        shell_printf("\t cmd \t: show all commands\r\n");                }        }        else        {                shell_printf("ls need more arguments!\r\n");        }}
/*argc是参数的数目argv存储每个参数的起始地址和内容*/void shell_reboot_cmd(char argc, char *argv){   if (!strcmp("reboot", &argv[argv[0]]))   {           shell_printf("MCU Reboot now!!\r\n");           MCU_soft_Reset();           }}
/*显示各种输入信号的信息*/void shell_speed_cmd(char argc, char *argv){        if (!strcmp("speed", &argv[argv[0]]))        {                                shell_printf("\r\n供电电压 = %d (MV) 油量 = %02d%%",Analog.Bat_vol,Analog.Oil_precent);                shell_printf("\r\n轴流滚筒转速 = %d rpm",Drum.Speed);                shell_printf("\r\n割台上下限范围 = [%d - %d]",Getai.Limit_Down_height,Getai.Limit_UP_height);        }}
/*** [url=home.php?mod=space&uid=247401]@brief[/url] 显示配置参数 */void shell_config_opt_cmd(char argc, char *argv){    if (argc > 1)        {                if (!strcmp("erase", &argv[argv[1]]))                {                        shell_printf("Erease Flash Sector [250 ~ 254] !!\r\n");                        Flash_SectorErase(Sector250_BaseAddr);                        Flash_SectorErase(Sector251_BaseAddr);                        Flash_SectorErase(Sector253_BaseAddr);                        Flash_SectorErase(Sector254_BaseAddr);                        Flash_SectorErase(Sector255_BaseAddr);                }                else if (!strcmp("read", &argv[argv[1]]))                {                        shell_printf("dump flash config.\r\n");                }        }        else        {                shell_printf("config need another arguments!\r\n");                shell_printf("You can press 'config erase' or 'config read'!\r\n");        }}


#ifdef NR_SHELL_USING_EXPORT_CMDNR_SHELL_CMD_EXPORT(ls, shell_ls_cmd);NR_SHELL_CMD_EXPORT(test, shell_test_cmd);#elseconst static_cmd_st static_cmd[] =        {                {"ls", shell_ls_cmd},                {"config", shell_config_opt_cmd},        {"reboot", shell_reboot_cmd},        {"speed", shell_speed_cmd},                {"\0", NULL}};#endif