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命令了。



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章