uboot快捷菜单命令.doc

下面以添加menu命令为例分析U-Boot添加命令的方法。 （1） 在common目录下新建cmd_menu.c文件 习惯上把通用命令源代码放在common目录下，与开发板专有命令源代码则放在board/board_dir目录下，命名方式只是习惯而已。为了方便阅读和查询习惯以“cmd_命令名.c”为文件名。 （2） 定义“menu”命令 在cmd_menu.c中使用如下的代码定义“menu”命令： U_BOOT_CMD( menu, 3, 0, do_menu, menu - display a menu, to select the items to do something\n, - 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变量时只要在_