(转)uboot命令增加过程

原文出处：http://blog.sina.com.cn/s/blog_54f82cc2010125um.html

uboot命令添加过程

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 #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

每一个命令定义一个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; int maxargs; int repeatable; int (*cmd)(struct cmd_tbl_s *, int, int, char *[]); char *usage; #ifdef CFG_LONGHELP char *help; #endif #ifdef CONFIG_AUTO_COMPLETE 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 #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

按照这2步就可以添加U-BOOT命令了。

1、 u-boot的命令格式：

U_BOOT_CMD(name,maxargs,repeatable,command,”usage”,"help")

name:命令的名字，不是一个字符串；

maxargs：最大的参数个数；

repeatable：命令是可重复的；

command:对应的函数指针

U-Boot的每一个命令都是通过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
#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
每一个命令定义一个cmd_tbl_t结构体,而cmd_tbl_t只不过是cmd_tbl_s的一个typedef，如下所示：
typedef struct cmd_tbl_s cmd_tbl_t;

从控制台输入的命令是由common/command.c中的程序解释执行的。find_cmd()负责匹配输入的命令，从列表中找出对应的命令结构体。

基于U-Boot命令的基本框架，来分析一下简单的icache操作命令，就可以知道添加新命令的方法。

（1）定义CACHE命令。在include/cmd_confdefs.h中定义了所有U-Boot命令的标志位。

#define CFG_CMD_CACHE 0x00000010ULL

如果有更多的命令，也要在这里添加定义。

（2）实现CACHE命令的操作函数。下面是common/cmd_cache.c文件中icache命令部分的代码。

#if (CONFIG_COMMANDS & CFG_CMD_CACHE)

static int on_off (const char *s)

{ //这个函数解析参数，判断是打开cache，还是关闭cache

if (strcmp(s, "on") == 0) { //参数为“on”

return (1);

} else if (strcmp(s, "off") == 0) { //参数为“off”

return (0);

}

return (-1);

}

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

{ //对指令cache的操作函数

switch (argc) {

case 2:

switch (on_off(argv[1])) {

case 0: icache_disable(); //打开指令cache

break;

case 1: icache_enable (); //关闭指令cache

break;

}

case 1:

printf ("Instruction Cache is %s\n",

icache_status() ? "ON" : "OFF");

return 0;

default: //其他缺省情况下，打印命令使用说明

printf ("Usage:\n%s\n", cmdtp->usage);

return 1;

}

return 0;

}

……

U_Boot_CMD( //通过宏定义命令

icache, 2, 1, do_icache, //命令为icache，命令执行函数为do_icache()

"icache - enable or disable instruction cache\n", //帮助信息

"[on, off]\n"

" - enable or disable instruction cache\n"

);

……

#endif

U-Boot的命令都是通过结构体__U_Boot_cmd_##name来描述的。根据U_Boot_CMD在include/command.h中的两行定义可以明白。

#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}

还有，不要忘了在common/Makefile中添加编译的目标文件。

（3）打开CONFIG_COMMANDS选项的命令标志位。这个程序文件开头有#if语句需要预处理是否包含这个命令函数。CONFIG_COMMANDS选项在开发板的配置文件中定义。例如：SMDK2410平台在include/configs/smdk2410.h中有如下定义。

#define CONFIG_COMMANDS \

(CONFIG_CMD_DFL | \

CFG_CMD_CACHE | \

CFG_CMD_REGINFO | \

CFG_CMD_DATE | \

CFG_CMD_ELF)

按照这3步，就可以添加新的U-Boot命令。

下面以添加 "Hello Word!" 命令为例！

(1)
在include/configs/qljt2440.h中增加一项：

#define CONFIG_CMD_ASKENV
#define CONFIG_CMD_CACHE
#define CONFIG_CMD_DATE
#define CONFIG_CMD_DHCP
#define CONFIG_CMD_ELF
#define CONFIG_CMD_PING
#define CONFIG_CMD_NAND //ql18
#define CONFIG_CMD_REGINFO //ql18
#define CONFIG_CMD_HELLOWORD

(2)
在 /board/qljt/qljt2440/ 目录下添加 helloword.c 文件
内容如下

#include
#include

#ifdef CONFIG_CMD_HELLOWORD
void helloword(void)
{
qljt_printf("-----------------------------------------------Hello Word!\n");
}
U_BOOT_CMD(
hello,
1,
2,
helloword,
"hell - helloword command ",
" QL add u-boot command!\n"
);

#endif
(3) 在/board/qljt/qljt2440/ 目录下的Makefile 添加要编译的目标文件,即在 Makefile的变量COBJS中加入：cmd_test_zwx.o

重新编译u-boot，完毕！

修改网卡控制字在文件dm9000x.c里，发送自定义包可以在/common/cmd_net.c文件里添加命令。

零值广播

static void start_ip_zerobro (void)
{
int i = 0;
uchar udp[14+20+8+306] = {
0x23,0x45,0x3f,0x56,0xe3,0x2d,
0x32,0x34,0xde,0x2d,0x4c,0x27,
0x08,0x00,

0x45,0x00,0x01,0x4e,
0xc1,0x3e,0x00,0x00,
0x40,0x11,0xf6,0x36,
0xc0,0xa8,0x01,0x82,
0x00,0x00,0x00,0x00,

0x0f,0x10,0x00,0x50,
0x01,0x3a,0x2d,0x3b

};

while (i++<10)
{
eth_send((volatile void*)udp,sizeof(udp));
printf("send ip zerobro package ok\n");
sleep("1");
}
}

static int sleep (char *string)
{
ulong start = get_timer(0);
ulong delay;

delay = simple_strtoul(string, NULL, 10) * CONFIG_SYS_HZ;

while (get_timer(start) < delay) {
if (ctrlc ()) {
return (-1);
}
udelay (100);
}
return 0;
}