uboot命令的实现以及解析

解析run_command

1.argc = parse_line (finaltoken, argv)   //解析命令的参数有几个

2.cmdtp = find_cmd(argv[0]       //获取命令的结构体

3.(cmdtp->cmd) (cmdtp, flag, argc, argv)  //执行命令的实现函数

在分析之前先说一个命令的结构体

1.结构体cmd_tbl_t *cmdtp;

定义如下：typedef struct cmd_tbl_s    cmd_tbl_t;

struct cmd_tbl_s {
	char		*name;		/* Command Name			命令的名字*/
	int		maxargs;	/* maximum number of arguments	命令的最大参数的个数*/
	int		repeatable;	/* autorepeat allowed?		命令是否可以重复，比如执行过一个命令后，再按下Enter重复之前的命令*/
					/* Implementation function	命令的实现函数*/
	int		(*cmd)(struct cmd_tbl_s *, int, int, char *[]);
	char		*usage;		/* Usage message	(short)	命令的使用方法*/
#ifdef	CFG_LONGHELP
	char		*help;		/* Help  message	(long)	命令的详细使用方法*/
#endif
};

重要的函数;
cmdtp = find_cmd(argv[0])//这个函数通过argv[0]也即命令的名字来找到cmd_tbl_s的结构体。
如果没有找到输入命令的结构体，则会打印错误输出信息：
Unknown command '%s' - try 'help'
下面看下函数find_cmd是如何处理的：

for (cmdtp = &__u_boot_cmd_start;
	     cmdtp != &__u_boot_cmd_end;
	     cmdtp++) {
		if (strncmp (cmd, cmdtp->name, len) == 0) {
			if (len == strlen (cmdtp->name))
				return cmdtp;	/* full match */

			cmdtp_temp = cmdtp;	/* abbreviated command ? */
			n_found++;
		}
	}

它是在__u_boot_cmd_start与__u_boot_cmd_end段之间一一的和cmd name进行比对，如果匹配上，则返回该命令的cmdtp结构体。
其中__u_boot_cmd_start与__u_boot_cmd_end的定义是在链接脚本u-boot.lds中定义：
__u_boot_cmd_start = .;
. u_boot_cmd : { *(.u_boot_cmd) }
__u_boot_cmd_end = .;
这两个段之间放的就是uboot的命令，.u_boot_cmd段

定义如下：
#define Struct_Section  __attribute__ ((unused,section (".u_boot_cmd")))
这句话的意思是Struct_Section的宏定以为一个属性，这个属性转换为 .u_boot_cmd段

下面就看看Struct_Section被哪些cmd使用到了。
经过source insight搜索，发现Struct_Section 在另一个宏U_BOOT_CMD中使用到了，

#define U_BOOT_CMD(name,maxargs,rep,cmd,usage,help) \
cmd_tbl_t __u_boot_cmd_##name Struct_Section = {#name, maxargs, rep, cmd, usage, help}

可以想象U_BOOT_CMD就是uboot命令的宏.继续使用si搜索U_BOOT_CMD，发现这个宏在很多的文件中使用，选择一个cmd_bootm.c发现：

U_BOOT_CMD(
 	bootm,	CFG_MAXARGS,	1,	do_bootm,
 	"bootm   - boot application image from memory\n",
 	"[addr [arg ...]]\n    - boot application image stored in memory\n"
 	"\tpassing arguments 'arg ...'; when booting a Linux kernel,\n"
 	"\t'arg' can be the address of an initrd image\n"
#ifdef CONFIG_OF_FLAT_TREE
	"\tWhen booting a Linux kernel which requires a flat device-tree\n"
	"\ta third argument is required which is the address of the of the\n"
	"\tdevice-tree blob. To boot that kernel without an initrd image,\n"
	"\tuse a '-' for the second argument. If you do not pass a third\n"
	"\ta bd_info struct will be passed instead\n"
#endif
);

将其展开：

cmd_tbl_t __u_boot_cmd_bootm  __attribute__ ((unused,section (".u_boot_cmd")))= 
{bootm, CFG_MAXARGS, 1, do_bootm, 
  "bootm   - boot application image from memory\n",
  "[addr [arg ...]]\n    - boot application image stored in memory\n"
  "\tpassing arguments 'arg ...'; when booting a Linux kernel,\n"
  "\t'arg' can be the address of an initrd image\n"
#ifdef CONFIG_OF_FLAT_TREE
 "\tWhen booting a Linux kernel which requires a flat device-tree\n"
 "\ta third argument is required which is the address of the of the\n"
 "\tdevice-tree blob. To boot that kernel without an initrd image,\n"
 "\tuse a '-' for the second argument. If you do not pass a third\n"
 "\ta bd_info struct will be passed instead\n"
#endif}

可以看到定义了一个类型为cmd_tbl_t的__u_boot_cmd_bootm，属性强制设为.u_boot_cmd段，这也就解释了为什么uboot命令存放在__u_boot_cmd_start 与__u_boot_cmd_end 之间的原因了。

下面自己添加一个命令的实例cmd_hello.c：

#include <common.h>
#include <watchdog.h>
#include <command.h>
#include <image.h>
#include <malloc.h>
#include <zlib.h>
#include <bzlib.h>
#include <environment.h>
#include <asm/byteorder.h>

int do_hello(cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
{
    printf("Hello World\n");
    return 0;
}

U_BOOT_CMD(
    hello,  CFG_MAXARGS,    1,  do_hello,
    "hello   - hello for test\n",
    "Hello long test........\n"
);

修改Makefile,在COBJS   =  后面加上cmd_hello.o重新编译即可.