U-boot分析与移植（4）----U-boot 添加命令

我们初步了解U-Boot执行流程后，知道

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

[cpp] view plaincopyprint?

1. /*命令宏U_BOOT_CMD*/  
2. #define U_BOOT_CMD(name,maxargs,rep,cmd,usage,help) \  
3. cmd_tbl_t    __u_boot_cmd_##name     Struct_Section = {#name, maxargs, rep, cmd, usage, help}  

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

[cpp] view plaincopyprint?

1. struct cmd_tbl_s {  
2.     char        *name;      /* Command Name         */  
3.     int     maxargs;    /* maximum number of arguments  */  
4.     int     repeatable; /* autorepeat allowed?      */  
5.                     /* Implementation function  */  
6.     int     (*cmd)(struct cmd_tbl_s *, int, int, char *[]);  
7.     char        *usage;     /* Usage message    (short) */  
8. #ifdef  CFG_LONGHELP   
9.     char        *help;      /* Help  message    (long)  */  
10. #endif   
11. #ifdef CONFIG_AUTO_COMPLETE  
12.     /* do auto completion on the arguments */  
13.     int     (*complete)(int argc, char *argv[], char last_char, int maxv, char *cmdv[]);  
14. #endif   
15. };  

struct cmd_tbl_s {char*name;/* Command Name*/intmaxargs;/* maximum number of arguments*/intrepeatable;/* autorepeat allowed?*//* Implementation function*/int(*cmd)(struct cmd_tbl_s *, int, int, char *[]);char*usage;/* Usage message(short)*/#ifdefCFG_LONGHELPchar*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文件

[cpp] view plaincopyprint?

1. #include <common.h>   
2. #include <command.h>   
3.   
4. #ifdef CONFIG_CMD_HELLO    
5. int do_hello(cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])  
6. {  
7.     int i;  
8.     printf("argc = %d\n",argc);  
9.     for(i = 0; i < argc; i++)  
10.         printf("i = %d, %s\n",i,argv[i]);  
11.     return 0;  
12. }  
13. U_BOOT_CMD(hello,CONFIG_SYS_MAXARGS,0,do_h  

#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函数必须定义成这样形式：

[cpp] view plaincopyprint?

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

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、编译后下到板上

[cpp] view plaincopyprint?

1. U-Boot 2009.11 (12鏈?14 2011 - 00:44:00)  
2.   
3.   
4. DRAM:  64 MB  
5.   
6. Flash: 512 kB  
7.   
8. NAND:  NAND_ECC_NONE selected by board driver. This is not recommended !!  
9.   
10. 64 MiB  
11.   
12. In:    serial  
13.   
14. Out:   serial  
15.   
16. Err:   serial  
17.   
18. Net:   dm9000  
19.   
20. Hit any key to stop autoboot:  0   
21.   
22. BAI2011/12/13 # hello  
23.   
24. argc = 1  
25.   
26. i = 0, hello  
27.   
28. BAI2011/12/13 # hello this is my test!  
29.   
30. argc = 5  
31.   
32. i = 0, hello  
33.   
34. i = 1, this  
35.   
36. i = 2, is  
37.   
38. i = 3, my  
39.   
40. i = 4, test!  
41.   
42. BAI2011/12/13 #