下面以添加menu命令（啟動菜單）為例講解U-Boot添加命令的方法。

（1）    建立common/cmd_menu.c

    習慣上通用命令源代碼放在common目錄下，與開發板專有命令源代碼則放在board/目錄下，并且習慣以“cmd_<命令名>.c”為文件名。

（2）    定義“menu”命令

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

_BOOT_CMD(

    menu,   3,  0,  do_menu,

    'menu - display a menu, to select the items to do somethingn',

    ' - display a menu, to select the items to do something'

);

    其中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/mini2440.h中定義了CONFIG_SYS_LONGHELP宏，則在U-Boot中使用help命令查看某個命令的幫助信息時將顯示usage和help字段的內容，否則就只顯示usage字段的內容。

    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}

    “##”與“#”都是預編譯操作符，“##”有字符串連接的功能，“#”表示后面緊接著的是一個字符串。

    其中的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

#ifdef CONFIG_AUTO_COMPLETE

    /* 自動補全參數 */

    int     (*complete)(int argc, char *argv[], char last_char, int maxv, char *cmdv[]);

#endif

};

typedef struct cmd_tbl_s    cmd_tbl_t;

    一個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指定為當前地址  */

    這表明帶有“.u_boot_cmd”聲明的函數或變量將存儲在“u_boot_cmd”段。這樣只要將U-Boot所有命令對應的cmd_tbl_t變量加上“.u_boot_cmd”聲明，編譯器就會自動將其放在“u_boot_cmd”段，查找cmd_tbl_t變量時只要在__u_boot_cmd_start與__u_boot_cmd_end之間查找就可以了。

    因此“menu”命令的定義經過宏展開后如下：

cmd_tbl_t __u_boot_cmd_menu __attribute__ ((unused,section ('.u_boot_cmd'))) = {menu, 3, 0, do_menu, 'menu - display a menu, to select the items to do somethingn', ' - 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）    實現命令的函數

    在cmd_menu.c中添加“menu”命令的響應函數的實現。具體的實現代碼略：

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

{

    /* 實現代碼略 */

}

（4）    將common/cmd_menu.c編譯進u-boot.bin

    在common/Makefile中加入如下代碼：

COBJS-$(CONFIG_BOOT_MENU) += cmd_menu.o

    在include/configs/mini2440.h加入如代碼：

#define CONFIG_BOOT_MENU 1

    重新編譯下載U-Boot就可以使用menu命令了

（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，從而完成了命令的執行。