全网首发,硬核!
周末在家,顺便把前段时间研究的一个开源代码库的移植案例整理分享出来,希望给坛友们提供便利。我移植的mcu是小华HC32F072。
1. 开源nr_micro_shell介绍
[td]
原始工程 | 添加nr_micro_shell增加量 | 添加finsh增加量 | |
ROM | 63660 | +3832 | +26908 |
RAM | 4696 | +1104 | +1304 |
代码仓库地址: https://gitee.com/nrush/nr_micro_shell
2. 移植步骤
这么好这么优秀的一个代码库,我们该如何移植呢?如果你学会了移植到某一款mcu上之后,其他mcu都是照葫芦画瓢的哦。
2.1 使用git工具下载源码到你的工程目录下:
然后把源码添加到mdk工程中,如下图所示:
2.2 这里我们就要修改源码中的接口函数了
2.2.1 修改nr_micro_shell_config.h文件中的一个宏定义和一个uart发送字符的接口函数:
2.2.2 在ansi_port.c中,修改接口如下:
2.2.3 此时基本就改好了,你会发现有了发送,接收怎么办呢?
此时需要再自己工程中的串口接收中断函数中添加一个shell(ch);接口函数:
值得注意的是,此接口也可以不放在中断里面哦,也可以放在RTOS中的某个任务里。
2.2.4 万事俱备,只欠东风啦!那是啥呢?聪明的你应该想到了,那就是初始化!调用 shell_init();接口即可。
3. 测试验证
4. 扩展: 如何添加自己的命令呢?源码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_CMD
NR_SHELL_CMD_EXPORT(ls, shell_ls_cmd);
NR_SHELL_CMD_EXPORT(test, shell_test_cmd);
#else
const 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
至此,整个移植过程就完美结束啦。
如果还有什么疑问,欢迎留言讨论哦。
---------------------
作者:caizhiwei
链接:https://bbs.21ic.com/icview-3303434-1-1.html
来源:21ic.com
此文章已获得原创/原创奖标签,著作权归21ic所有,任何人未经允许禁止转载。