uboot的命令体系

uboot的命令体系

1、uboot中的命令在哪里存放？

在uboot/common/cmd_xxx.c中，有若干个.c文件和命令体系有关。每个命令对应一个函数，如bmp命令所执行的函数是do_bmp，函数的格式通常为do_xxx。

2、命令参数以argc和argv传给函数

有些uboot的命令支持传递参数。如help命令，

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

函数接收的参数列表有argc和argv，当我们执行命令help mnd时，此时argc = 2，argv[0] = help,argv[1] = mnd。

3、uboot的命令解析和执行过程

uboot启动的第二阶段，最后进入一个main_loop函数，这个函数执行一遍，就是一个获取命令、解析命令、执行命令的过程。，run_command函数就是用来执行命令的函数。

4、run_command的几个要点

（1）控制台命令获取

（2）命令解析。parse_line函数

（3）查找命令。find_cmd函数

（4）执行命令。最后用函数指针的方式调用执行了对应函数。

 

 

uboot是如何完成命令设计的，命令如何去注册、存储、管理、索引？

5、uboot如何处理命令集

可能的管理方式：

(1)数组。结构体数组，数组中每一个结构体成员就是一个命令的所有信息。

(2)链表。链表的每个节点data段就是一个命令结构体，所有的命令都放在一条链表上。这样就解决了数组方式的不灵活。坏处是需要额外的内存开销，然后各种算法（遍历、插入、删除等）需要一定复杂度的代码执行。

uboot使用的方式：填充一个结构体构成一个命令，给命令结构体实例附加特定段属性，链接时将带有该属性的内容连接在一起排例（可能是乱序的，但不会掺杂有其他东西）。uboot重定位时将该段整体加载到DDR中，段起始地址和结束地址决定了这些命令集的开始和结束地址。

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

};

（1）name: 命令名称，字符串格式。

（2）Maxargs: 命令最多可以接收多少个参数。

（3）repeatable：指示这个命令是否可重复执行。重复执行是uboot命令行的一种工作机制，就是直接按回车则执行上一次执行的命令。

（4）cmd：函数指针。

（5）usage：命令的短帮助信息。对命令的简单描述。

（6）help：命令的长帮助信息。细节的帮助信息。

（7）complete：函数指针，指向这个命令的自动补全的函数。

如何实现命令功能？

U_BOOT_CMD宏定义？定义在uboot/common/command.h。例：

U_BOOT_CMD(

version, 1, 1, do_version,

"version - print monitor version\n",

NULL);

#define Struct_Section  __attribute__ ((unused,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}

这个宏替换后变成：

cmd_tbl_t __u_boot_cmd_version __attribute__ ((unused,section (".u_boot_cmd"))) = {#name, maxargs, rep, cmd, usage, help}

名字使用##作为连字符，附加了用户自定义段属性，以保证链接时将这些数据结构链接在一起排布。

6、find_cmd函数

find_cmd函数的任务是从当前uboot的命令集中查找是否有某个命令。如果找到则返回这个命令结构体的指针，如果未找到返回NULL。遍历查找方式。

 

7、自己添加命令

1、在uboot目录下 vi common/command.c文件,新增如下内容。

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

{

        printf ("\n%s\n", "test by mushan");

        return 0;

}       

U_BOOT_CMD(

         mycmd,        1,              1,      do_mycmd,

        "mycmd - print mycmd test\n",

        "mycmd -long help test\n"

);      

然后重新编译。

make distclean

make x210_sd_config

make

cd sd_fusing

ls /dev/sdc

./sd_fusing.sh   /dev/sdc

2、新建新文件添加

在common目录下创建新文件，添加以上同样的内容，在Makefile添加新建文件的.o文件。重新编译。