uboot U_BOOT_CMD

其中U_BOOT_CMD命令格式以下：

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

　各個參數的意義以下：

1. name：命令名，非字符串，但在U_BOOT_CMD中用「#」符號轉化爲字符串

2. maxargs：命令的最大參數個數

3. repeatable：是否自動重複（按Enter鍵是否會重複執行）

4. command：該命令對應的響應函數指針

5. usage：簡短的使用說明（字符串）

6. help：較詳細的使用說明（字符串）

U_BOOT_CMD宏在include/command.h中定義：

1. #define U_BOOT_CMD(name,maxargs,rep,cmd,usage,help) \

2. 　　　　cmd_tbl_t __u_boot_cmd_##name Struct_Section = {#name, maxargs, rep, cmd, usage, help}

「##」與「#」都是預編譯操做符，「##」有字符串鏈接的功能，「#」表示後面緊接着的是一個字符串。

其中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」段：

1. . = .;

2. __u_boot_cmd_start = .; /*將 __u_boot_cmd_start指定爲當前地址 */

3. .u_boot_cmd : { *(.u_boot_cmd) }

4. __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 之間查找就能夠了。

 

cmd_tbl_t在include/command.h中定義以下： 

1. struct cmd_tbl_s {

2.     char        *name;        /* Command Name            */

3.     int          maxargs;    /* maximum number of arguments    */

4.     int          repeatable;    /* autorepeat allowed?        */

5.                     /* Implementation function    */

6.     int        (*cmd)(struct cmd_tbl_s *, int, int, char * const []);

7.     char        *usage;        /* Usage message    (short)    */

8. #ifdef    CONFIG_SYS_LONGHELP

9.     char        *help;        /* Help  message    (long)    */

10. #endif

11. #ifdef CONFIG_AUTO_COMPLETE

12.     /* do auto completion on the arguments */

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

14. #endif

15. };

16.  

17. typedef struct cmd_tbl_s    cmd_tbl_t;

一個cmd_tbl_t結構體變量包含了調用一條命令的所須要的信息。

 

以「boot」命令的定義通過宏展開後以下：

　　　　cmd_tbl_t __u_boot_cmd_boot __attribute__ ((unused,section (".u_boot_cmd"))) = {boot, 1, 1, do_bootd, "boot    - boot default, i.e., run 'bootcmd'\n", " NULL"}

 

1. int do_bootd (cmd_tbl_t *cmdtp, int flag, int argc, char *argv[])

2. {

3. int rcode = 0;

4.  

5. if (run_command(getenv("bootcmd"), flag) < 0)

6. rcode = 1;

7. return rcode;

8. }

run_command 命令分析：

u-boot啓動第二階段最後跳到main_loop函數中循環

1. s = getenv ("bootcmd");

2. if (bootdelay >= 0 && s && !abortboot (bootdelay)) {

3. ......

4. run_command (s, 0);

5. ......

6. }

從main_loop中咱們知道，若是bootdelay時間內未按下按鍵則啓動Linux內核，按下按鍵則進入uboot命令行等待用戶輸入命令。

用戶輸入命令則調取run_command函數，在該函數中有下面幾個比較重要的點：

1. 從註釋咱們很容易知道這段代碼是在對命令進行分離，而且u-boot支持’;’分離命令。

1. /*

2. * Find separator, or string end

3. * Allow simple escape of ';' by writing "\;"

4. */

5. for (inquotes = 0, sep = str; *sep; sep++) {

6. if ((*sep=='\'') &&

7. (*(sep-1) != '\\'))

8. inquotes=!inquotes;

9.  

10. if (!inquotes &&

11. (*sep == ';') && /* separator */

12. ( sep != str) && /* past string start */

13. (*(sep-1) != '\\')) /* and NOT escaped */

14. break;

15. }

2. 分離參數

1. /* Extract arguments */

2. if ((argc = parse_line (finaltoken, argv)) == 0) {

3. rc = -1; /* no command at all */

4. continue;

5. }

3. 用第一個參數argv[0]在命令列表中尋找對應的命令，並返回一個cmd_tbl_t類型的實例。咱們能夠猜到這個結構體應該保函了有關命令的一系列內容。

1. /* Look up command in command table */

2. if ((cmdtp = find_cmd(argv[0])) == NULL) {

3. printf ("Unknown command '%s' - try 'help'\n", argv[0]);

4. rc = -1; /* give up after bad command */

5. continue;

6. }

在common/command.c 中查看find_cmd函數

1. /*__u_boot_cmd_start與__u_boot_cmd_end間查找命令，並返回cmdtp->name命令的cmd_tbl_t結構。*/

2. cmd_tbl_t *cmdtp;

3. cmd_tbl_t *cmdtp_temp = &__u_boot_cmd_start; /*Init value */

4. const char *p;

5. int len;

6. int n_found = 0;

7.  

8. /*

9. * Some commands allow length modifiers (like "cp.b");

10. * compare command name only until first dot.

11. */

12. len = ((p = strchr(cmd, '.')) == NULL) ? strlen (cmd) : (p - cmd);

13.  

14. for (cmdtp = &__u_boot_cmd_start;

15. cmdtp != &__u_boot_cmd_end;

16. cmdtp++) {

17. if (strncmp (cmd, cmdtp->name, len) == 0) {

18. if (len == strlen (cmdtp->name))

19. return cmdtp; /* full match */

20.  

21. cmdtp_temp = cmdtp; /* abbreviated command ? */

22. n_found++;

23. }

24. }

5、總結命令執行過程

① 在u-boot控制檯中輸入「boot」命令執行時，u-boot控制檯接收輸入的字符串「boot」，傳遞給run_command函數。

② run_command函數調用common/command.c中實現的find_cmd函數在__u_boot_cmd_start與__u_boot_cmd_end間查找命令，並返回boot命令的cmd_tbl_t結構。

③ 而後run_command函數使用返回的cmd_tbl_t結構中的函數指針調用boot命令的響應函數do_bootd，從而完成了命令的執行。

6、自制u-boot命令

https://blog.csdn.net/yexiangCSDN/article/details/81773093