RT thread add MSH command

In this paper, the reference 《RT-Thread Programming manual 》https://www.bookstack.cn/read/rtthread-manual-doc/10.6.md

How to add a command

In the use of FinSH when , The system provides some useful commands , such as ：

In fact, we can add some commands to msh in , The method is as follows ：

MSH_CMD_EXPORT(command, desc);

command Is the command to be added （ Function name ）,desc It's a description of the command .

A simple test

Here's a simple my_hello Command to test , Add the following code to the project ：

void my_hello(void)
{
    
	rt_kprintf("hello world\n");
}

MSH_CMD_EXPORT(my_hello, msh cmd test);

stay msh Type... On the command line help command , You can see our my_hello The command has been added to the command list ：

Input my_hello command , Successfully run my_hello() function ：

Variable parameter commands

Functions can usually take arguments ,msh Commands can also take parameters , also msh It also supports commands for adding variable parameters , The format of the definition is ：

void my_cmd(int argc, char **argv)

Again , Let's write a simple test example ：（ Remember to open it. MicroLIB）

#include <string.h>
#include <stdio.h>

void led_ctrl(int argc, char **argv)
{
    
	if(argc != 3)
	{
    
		rt_kprintf(" Correct format ：led_ctrl LEDx ON/OFF\n");
		return;
	}
	
	if(!strcmp(argv[1] , "LED0"))
	{
    
		if(!strcmp(argv[2] , "ON"))
		{
    
			rt_kprintf("led0 on!\n");
		}
		else if(!strcmp(argv[2] , "OFF"))
		{
    
			rt_kprintf("led0 off!\n");
		}
	}
	else if(!strcmp(argv[1] , "LED1"))
	{
    
		if(!strcmp(argv[2] , "ON"))
		{
    
			rt_kprintf("led1 on!\n");
		}
		else if(!strcmp(argv[2] , "OFF"))
		{
    
			rt_kprintf("led1 off!\n");
		}
	}
}

MSH_CMD_EXPORT(led_ctrl, "LEDx ON/OFF"); //  No double quotes ,ON/OFF  Will be displayed as 1/0

test result ：（ Different parameters , The content of operation is also different ）