uboot命令添加过程
U-Boot的命令为用户提供了交互功能,并且已经实现了几十个常用的命令。如果开发板需要很特殊的操作,可以添加新的U-Boot命令。
U-Boot的每一个命令都是通过U_Boot_CMD宏定义的。这个宏在<include/command.h>头文件中定义
每一个命令定义一个cmd_tbl_t结构体,而cmd_tbl_t只不过是cmd_tbl_s的一个typedef,如下所示:
而cmd_tbl_s的定义则在同一文件<command.h>下,如下所示:
这样每一个U-Boot命令有一个结构体来描述。结构体包含的成员变量:命令名称、最大参数个数、重复数、命令执行函数、用法、帮助。
从控制台输入的命令是由common/command.c中的程序解释执行的。find_cmd()负责匹配输入的命令,从列表中找出对应的命令结构体并返回指向这一结构体的指针。
基于U-Boot命令的基本框架,来分析一下简单的ping操作命令,就可以知道添加新命令的方法。
(1)定义PING命令
在<config_cmd_all.h>与<config_cmd_default.h>中定义了所有UBOOT支持的命令的标志位
其中, <config_cmd_default.h>中定义的命令是由板子默认支持的,这是由于在板子的配置文件中包含进了该头文件,如果让板子支持 <config_cmd_default.h>中没有而 <config_cmd_all.h>中命令,还必须在板子的配置文件中进行相关的定义,如我的 <config_cmd_default.h>并没有进行PING的相关定义,我要想板子支持ping,我只需要在我的板子配置文件<mypxa255.h>中加入上面那句就可。也可以直接把定义语句写在 <config_cmd_default.h>中。
(2)定义PING命令的操作函数。下面是ping命令的具体实现,在<common/cmd_net.c>中。
U-Boot的命令都是通过结构体__u_boot_cmd_##name来描述的。根据U_Boot_CMD在<include/command.h>中的两行定义可以明白。
按照这2步就可以添加U-BOOT命令了。
U-Boot的命令为用户提供了交互功能,并且已经实现了几十个常用的命令。如果开发板需要很特殊的操作,可以添加新的U-Boot命令。
U-Boot的每一个命令都是通过U_Boot_CMD宏定义的。这个宏在<include/command.h>头文件中定义
#ifdef CFG_LONGHELP
#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}
#else /* no long help info */
#define U_BOOT_CMD(name,maxargs,rep,cmd,usage,help) \
cmd_tbl_t __u_boot_cmd_##name Struct_Section = {#name, maxargs, rep, cmd, usage}
#endif /* CFG_LONGHELP */
每一个命令定义一个cmd_tbl_t结构体,而cmd_tbl_t只不过是cmd_tbl_s的一个typedef,如下所示:
typedef struct cmd_tbl_s cmd_tbl_t;
而cmd_tbl_s的定义则在同一文件<command.h>下,如下所示:
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
};
这样每一个U-Boot命令有一个结构体来描述。结构体包含的成员变量:命令名称、最大参数个数、重复数、命令执行函数、用法、帮助。
从控制台输入的命令是由common/command.c中的程序解释执行的。find_cmd()负责匹配输入的命令,从列表中找出对应的命令结构体并返回指向这一结构体的指针。
基于U-Boot命令的基本框架,来分析一下简单的ping操作命令,就可以知道添加新命令的方法。
(1)定义PING命令
在<config_cmd_all.h>与<config_cmd_default.h>中定义了所有UBOOT支持的命令的标志位
#define CONFIG_CMD_PING
其中, <config_cmd_default.h>中定义的命令是由板子默认支持的,这是由于在板子的配置文件中包含进了该头文件,如果让板子支持 <config_cmd_default.h>中没有而 <config_cmd_all.h>中命令,还必须在板子的配置文件中进行相关的定义,如我的 <config_cmd_default.h>并没有进行PING的相关定义,我要想板子支持ping,我只需要在我的板子配置文件<mypxa255.h>中加入上面那句就可。也可以直接把定义语句写在 <config_cmd_default.h>中。
(2)定义PING命令的操作函数。下面是ping命令的具体实现,在<common/cmd_net.c>中。
#if defined(CONFIG_CMD_PING)
int do_ping (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])
{
if (argc < 2)
return -1;
NetPingIP = string_to_ip(argv[1]);
if (NetPingIP == 0) {
printf ("Usage:\n%s\n", cmdtp->usage);
return -1;
}
if (NetLoop(PING) < 0) {
printf("ping failed; host %s is not alive\n", argv[1]);
return 1;
}
printf("host %s is alive\n", argv[1]);
return 0;
}
U_BOOT_CMD(//通过宏定义命令
ping, 2, 1, do_ping,// 命令为ping,对应的执行函数为do_ping
"ping\t- send ICMP ECHO_REQUEST to network host\n",
"pingAddress\n"
);
#endif
U-Boot的命令都是通过结构体__u_boot_cmd_##name来描述的。根据U_Boot_CMD在<include/command.h>中的两行定义可以明白。
#define Struct_Section __attribute__ ((unused,section (".u_boot_cmd")))
#ifdef CFG_LONGHELP
#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}
#else /* no long help info */
#define U_BOOT_CMD(name,maxargs,rep,cmd,usage,help) \
cmd_tbl_t __u_boot_cmd_##name Struct_Section = {#name, maxargs, rep, cmd, usage}
#endif /* CFG_LONGHELP */
按照这2步就可以添加U-BOOT命令了。