U-boot 添加命令 U_BOOT_CMD

U-Boot的每一个命令都是通过U_BOOT_CMD宏定义的。这个宏在include/command.h头文件中定义，每一个命令定义一个cmd_tbl_t结构体。



/*命令宏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用cmd_tbl_t结构体描述一个命令

struct cmd_tbl_s {

char *name; /* Command Name */

int maxargs; /* maximum number of arguments */

int repeatable; /* autorepeat allowed? */

/* 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

#ifdef CONFIG_AUTO_COMPLETE

/* do auto completion on the arguments */

int (*complete)(int argc, char *argv[], char last_char, int maxv, char *cmdv[]);

#endif

};

参数意义是：

name	这是命令名字，不需要用双引号括起来
maxargs	最大参数的个数
rep	命令是否可重复，就是下一次按回车时再执行
cmd	对应的函数指针
usage	字符串表示的简短说明
help	字符串表示的详细说明

在源代码里可发现命令都是在cmd_xxx.c里实现的

现在我们添加一个简单的测试命令

1、在common目录下添加一个hello.c文件

#include <common.h>

#include <command.h>

#ifdef CONFIG_CMD_HELLO

int do_hello(cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])

{

int i;

printf("argc = %d\n",argc);

for(i = 0; i < argc; i++)

printf("i = %d, %s\n",i,argv[i]);

return 0;

}

U_BOOT_CMD(hello,CONFIG_SYS_MAXARGS,0,do_h

do_xxx函数必须定义成这样形式：

cmd_tbl_s 结构体里的成员 int (*cmd)(struct cmd_tbl_s *, int, int, char *[]);

int do_hello(cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])

在填参数个数时要注意，CONFIG_SYS_MAXARGS是在include/configs/smdk2140.h里定义的，默认16
2、在common/Makefile中的#command添加如下内容：

COBJS-$(CONFIG_CMD_TEST) += cmd_hello.o

3、在include/configs/smdk2410.h(该文件名根据实际操作，要针对自己的平台文件改，如smdk2410.h等)添加如下内容：
在#include <config_cmd_default.h>后添加：
#define CONFIG_CMD_HELLO

或者在include/config_cmd_default.h文件中，添加该命令的宏定义。
4、编译后下到板上

U-Boot 2009.11 (12鏈?14 2011 - 00:44:00)

DRAM: 64 MB

Flash: 512 kB

NAND: NAND_ECC_NONE selected by board driver. This is not recommended !!

64 MiB

In: serial

Out: serial

Err: serial

Net: dm9000

Hit any key to stop autoboot: 0

BAI2011/12/13 # hello

argc = 1

i = 0, hello

BAI2011/12/13 # hello this is my test!

argc = 5

i = 0, hello

i = 1, this

i = 2, is

i = 3, my

i = 4, test!

BAI2011/12/13 #