如何在UBOOT中添加命令的方法

下面以添加 menu 命令为例分析 U-Boot 添加命令的方法。

（1） 在 common 目录下新建 cmd_menu.c 文件

习惯上把通用命令源代码放在 common 目录下，与开发板专有命令源代码则放在

board/<board_dir>目录下，命名方式只是习惯而已。为了方便阅读和查询习惯以“cmd_<

命令名>.c”为文件名。

（2） 定义“menu”命令

在 cmd_menu.c 中使用如下的代码定义“menu”命令：

U_BOOT_CMD(

各个参数的意义如下：

name：命令名，非字符串，但在 U_BOOT_CMD 中用“#”符号转化为字符串

maxargs：命令的最大参数个数

rep：是否自动重复（按 Enter 键是否会重复执行）

cmd：该命令对应的响应函数

usage：简短的使用说明（字符串）

help：较详细的使用说明（字符串）

在内存中保存命令的 help 字段会占用一定的内存，通过配置 U-Boot 可以选择是否保

存 help 字段。若在 include/configs/mini2440.h 中定义了 CONFIG_SYS_LONGHELP 宏，

则在 U-Boot 中使用 help 命令查看某个命令的帮助信息时将显示 usage 和 help 字段的内容，

否则就只显示 usage 字段的内容。

其中的 cmd_tbl_t 在 include/command.h 中定义如下：

struct cmd_tbl_s {

char *name; /* 命令名 */

int maxargs; /* 最大参数个数 */

int repeatable; /* 是否自动重复 */

int (*cmd)(struct cmd_tbl_s *, int, int, char *[]); /* 响应函数 */

char *usage; /* 简短的帮助信息 */

#ifdef CONFIG_SYS_LONGHELP

char *help; /* 较详细的帮助信息 */

#endif

一个 cmd_tbl_t 结构体变量包含了调用一条命令的所需要的信息。

其中 Struct_Section 在 include/command.h 中定义如下：

#define Struct_Section __attribute__ ((unused,section (".u_boot_cmd")))

凡是带有__attribute__ ((unused,section (".u_boot_cmd"))属性声明的变量都将被存放

在".u_boot_cmd"段中，并且即使该变量没有在代码中显式的使用编译器也不产生警告信息。

在 U-Boot 连接脚本 u-boot.lds 中定义了".u_boot_cmd"段：

. = .;

__u_boot_cmd_start = .; /*将 __u_boot_cmd_start 指定为当前地址 */

.u_boot_cmd : { *(.u_boot_cmd) }

__u_boot_cmd_end = .; /* 将__u_boot_cmd_end 指定为当前地址 */

{menu, 3, 0, do_menu, "menu - display a menu, to select the items to do something\n", " -

display a menu, to select the items to do something"}

实质上就是用 U_BOOT_CMD 宏定义的信息构造了一个 cmd_tbl_t 类型的结构体。编

译器将该结构体放在“u_boot_cmd”段，执行命令时就可以在“u_boot_cmd”段查找到对应的

cmd_tbl_t 类型结构体。

（3） 实现命令的函数

即 U_BOOT_CMD(name,maxargs,rep,cmd,usage,help)中的 cmd 参数

在 cmd_menu.c 中添加“menu”命令的响应函数的实现。具体的实现代码略：

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

{

/* 实现代码略 */

（5）menu 命令执行的过程

在 U-Boot 中输入“menu”命令执行时，U-Boot 接收输入的字符串“menu”，传递给

run_command 函数。run_command 函数调用 common/command.c 中实现的 find_cmd 函

数在__u_boot_cmd_start 与__u_boot_cmd_end 间查找命令，并返回 menu 命令的

cmd_tbl_t 结构。然后 run_command 函数使用返回的 cmd_tbl_t 结构中的函数指针调用

menu 命令的响应函数 do_menu，从而完成了命令的执行。

（6）例子：TFTP 下载，命令很简单。

#include <common.h>

#include <command.h>

/**功能：等待键盘输入***/