同步操作将从 Nrush/nr_micro_shell 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
作者:纪友州
Licence: MIT
如果你认为这个项目对你有所帮助,请在github或gitee进行Star,以鼓励作者。
Github address:nr_micro_shell
Gitee address:nr_micro_shell
nr_micro_shell旨在在MCU(例如stm32f103c8t6)上提供与linux shell命令行类似的交互体验。
在进行实际调试和维护时,常常需要与单片机进行交互,获取或设置某些参数,以了解系统工作状态。nr_micro_shell正是为满足这一需求,针对资源较少的MCU编写的开源命令行工具。nr_micro_shell具有以下优点
1.使用简单,灵活方便。使用过程只涉及两个shell_init()和shell()两个函数,无论是使用RTOS还是裸机都可以方便的应用该工具,不需要额外的编码工作。
2.交互体验好。完全类似于linux shell命令行,当串口终端支持ANSI(如Hypertrm终端)时,其不仅支持基本的命令行交互,还提供Tab键命令补全,查询历史命令,方向键移动光标修改功能。
3.可扩展性好。nr_micro_shell为用户提供自定义命令的标准函数原型,只需要按照命令编写命令函数,并注册命令函数即可使用命令。
nr_micro_shell提供以下功能:
基本命令行功能。
使用Tab键自动补全命令。
使用上下方向键查询历史命令。
使用左右方向键查调整光标位置。
注意:如果您要使用后三个功能,则必须使用支持ANSI的串口终端软件,例如Hypertrm。
以下是在stm32f103c8t6平台,串口终端为Hypertrm下的测试效果
所有配置工作都可以在nr_micro_shell_config.h中完成。有关详细信息,请参见文件中的注释。
确保所有文件都已添加到项目中。
确保函数“printf(),putchar()”可以在项目中正常使用。
示例如下
#include "nr_micro_shell.h"
int main(void)
{
/* 初始化 */
shell_init();
while(1)
{
if(USART GET A CHAR 'c')
{
/* nr_micro_shell接收字符 */
shell(c);
}
}
}
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:
在**static_cmd[]**表中注册命令
const static_cmd_st static_cmd[] =
{
.....
{"your_command_name",your_command_funtion},
.....
{"\0",NULL}
};
注意:不要删除{"\0",NULL}!
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。