u-boot分析 七 (添加u-boot命令，学习u-boot命令实现原理)

u-boot分析 七

(添加u-boot命令，学习u-boot命令实现原理)

本文目标：

理解u-boot命令的实现原理。

上一篇文章分析了u-boot是如何启动kernel的，其中就涉及到bootm命令，考虑到文章主题需要，当时并没有对bootm命令做过多的解释。然而，u-boot命令行又是u-boot及其重要的一部分。这篇文章，我们就通过实战来理解u-boot命令的实现原理。

我们要做的很简单，就是添加一条uboot command，希望在开发板上，uboot命令行中输入itxiebo时，能够从串口打印出一句log。

一、具体实现步骤：

1. 在./common文件夹下新建cmd_itxiebo.c，并在此文件中添加如下内容

#include <common.h>
#include <command.h>

static int do_itxiebo(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
{
    printf("do_itxiebo command is ready now!");
    return 0;
}

U_BOOT_CMD(
    itxiebo,    2,  0,  do_itxiebo,
    "itxiebo - this is a itxiebo command, do nothing",
    "- this is a itxiebo command, do nothing"
);

2.在./common/Makefile中添加：

obj-y += cmd_itxiebo.o

3.在linux环境下，重新编译u-boot，得到u-boot.bin，并升级到自己的开发板中（如果你没有开发板，没有关系，你只需要明白我们要在开发板中验证自己添加的命令itxiebo）

4.升级完后，在开发板启动内核之前，按space键进入u-boot命令行模式。

5.在串口终端中输入help命令，回车，可以发现itxiebo命令行已经添加成功。

6.在串口终端中输入itxiebo命令，回车执行该命令，发现我们添加的打印log，可以正确打印出来：

二、命令原理分析

实战见效果了，我们继续分析。不难发现，只要能搞清上面代码中的“U_BOOT_CMD”，就能弄明白uboot命令实现原理。

U_BOOT_CMD格式如下：

U_BOOT_CMD(_name, _maxargs, _rep, _cmd, _usage, _help)

其中，各个参数解释如下：

参数名	说明
_name	命令名，非字符串，但在U_BOOT_CMD中用“#”符号转化为字符串
_maxargs	命令的最大参数个数
_rep	是否自动重复（按Enter键是否会重复执行）
_cmd	该命令对应的响应函数
_usage	简短的使用说明（字符串）
_help	较详细的使用说明（字符串）

说明：
在内存中保存命令的help字段会占用一定的内存，通过配置U-Boot可以选择是否保存help字段。若在include/configs/s5p4418_urbetter.h 中定义了CONFIG_SYS_LONGHELP宏，则在U-Boot中使用help命令查看某个命令的帮助信息时将显示_usage和_help字段的内容，否则就只显示usage字段的内容，而不显示_help字段的内容。

另外，在include/command.h中，对U_BOOT_CMD的define 如下：

#define ll_entry_declare(_type, _name, _list)               \
    _type _u_boot_list_2_##_list##_2_##_name __aligned(4) __attribute__((unused,    section(".u_boot_list_2_"#_list"_2_"#_name)))

#define U_BOOT_CMD_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, _help, _comp) \
    ll_entry_declare(cmd_tbl_t, _name, cmd) =           \
        U_BOOT_CMD_MKENT_COMPLETE(_name, _maxargs, _rep, _cmd,  _usage, _help, _comp);

#define U_BOOT_CMD(_name, _maxargs, _rep, _cmd, _usage, _help)      \
    U_BOOT_CMD_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, _help, NULL)

最后，同样在include/command.h中定义了一个结构体cmd_tbl_t：

如此，我们便可以将U_BOOT_COM解析，如下

U_BOOT_CMD( itxiebo, 2, 0, do_itxiebo, "itxiebo - this is a itxiebo command, do nothing", "- this is a itxiebo command, do nothing" );

解析为：

cmd_tbl_t _u_boot_list_2_do_itxiebo_2_itxiebo __aligned(4) __attribute__((unused,section(".u_boot_list_2_"do_itxiebo"_2_"itxiebo)))

其中，“u_boot_list”，《u-boot分析 三》分析u-boot.lds时解释过。也就是说咱们新增的itxiebo command会被储存在u_boot_list段内。

.u_boot_list : {
        KEEP(*(SORT(.u_boot_list*)));
        /*.data段结束后，紧接着存放u-boot自有的一些function，例如u-boot command等*/
    }

三、itxiebo命令的执行过程：

在U-Boot中输入(串口终端)“itxiebo”命令执行时，U-Boot接收输入的字符串“itxiebo”，传递给run_command()函数。run_command()函数调用common/command.c中实现的find_cmd()函数在u_boot_list段内查找命令，并返回itxiebo命令的cmd_tbl_t结构。然后run_command()函数使用返回的cmd_tbl_t结构中的函数指针调用itxiebo命令的响应函数do_itxiebo，从而完成了命令的执行。

参考：
http://www.cnblogs.com/sdphome/archive/2011/08/19/2146327.html

完事儿。