uboot2019引导菜单分析

configs/ls2k_core.h 中定义了默认的菜单项及其他默认变量

#define CONFIG_EXTRA_ENV_SETTINGS \CONSOLE_STDOUT_SETTINGS \"loadaddr&＃61;" __stringify(CONFIG_SYS_LOAD_ADDR) "\0" \"rd_start&＃61;0x86000000\0" \"rd_size&＃61;0x02000000\0" \"mtdids&＃61;" CONFIG_MTDIDS_DEFAULT "\0" \"mtdparts&＃61;" CONFIG_MTDPARTS_DEFAULT "\0" \"splashpos&＃61;m,m\0" \"panel0&＃61;" "hz101wx" "\0" \"panel1&＃61;" "hz101wx" "\0" \"menucmd&＃61;bootmenu\0" \"bootmenu_0&＃61;0. U-Boot boot order&＃61;boot\0" \"bootmenu_1&＃61;1. Boot From SATA&＃61;" BOOT_SATA_DEFAULT "\0" \"bootmenu_2&＃61;2. Boot From SATA CFG&＃61;" BOOT_SATA_CFG_DEFAULT "\0" \"bootmenu_3&＃61;3. Boot From NAND&＃61;" BOOT_NAND_DEFAULT "\0" \"bootmenu_4&＃61;4. Update Kernel(tftp to nand)&＃61;loongson_update tftp kernel nand\0" \"bootmenu_5&＃61;5. Update Kernel(tftp to sata)&＃61;loongson_update tftp kernel sata\0" \"bootmenu_6&＃61;6. Update Rootfs(tftp to nand)&＃61;loongson_update tftp rootfs\0" \"bootmenu_7&＃61;7. Update U-Boot(tftp)&＃61;loongson_update tftp uboot\0" \"bootmenu_8&＃61;8. Update Kernel(usb to nand)&＃61;loongson_update usb kernel nand\0" \"bootmenu_9&＃61;9. Update Kernel(usb to sata)&＃61;loongson_update usb kernel sata\0" \"bootmenu_10&＃61;10. Update Rootfs(usb to nand)&＃61;loongson_update usb rootfs\0" \"bootmenu_11&＃61;11. Update U-Boot(usb)&＃61;loongson_update usb uboot\0" \"bootmenu_12&＃61;12. Update All(usb)&＃61;loongson_update usb all nand\0" \"bootmenu_13&＃61;13. Recover system&＃61;recover_cmd\0" \"bootmenu_delay&＃61;10\0" \


include/env_default.h 中定义了字符串数组 default_environment 其中的定义如下

#ifdef DEFAULT_ENV_INSTANCE_EMBEDDED
env_t embedded_environment __UBOOT_ENV_SECTION__(environment) &＃61; {ENV_CRC, /* CRC Sum */
#ifdef CONFIG_SYS_REDUNDAND_ENVIRONMENT1, /* Flags: valid */
#endif{
#elif defined(DEFAULT_ENV_INSTANCE_STATIC)
static char default_environment[] &＃61; {
#else
const uchar default_environment[] &＃61; {
#endif
#ifdef CONFIG_USE_BOOTARGS"bootargs&＃61;" CONFIG_BOOTARGS "\0"
#endif
#ifdef CONFIG_BOOTCOMMAND"bootcmd&＃61;" CONFIG_BOOTCOMMAND "\0"
#endif
#ifdef CONFIG_ENV_VARS_UBOOT_CONFIG"arch&＃61;" CONFIG_SYS_ARCH "\0"
#ifdef CONFIG_SYS_CPU"cpu&＃61;" CONFIG_SYS_CPU "\0"
#endif
#ifdef CONFIG_SYS_BOARD"board&＃61;" CONFIG_SYS_BOARD "\0""board_name&＃61;" CONFIG_SYS_BOARD "\0"
#endif
#ifdef CONFIG_SYS_VENDOR"vendor&＃61;" CONFIG_SYS_VENDOR "\0"
#endif
#ifdef CONFIG_SYS_SOC"soc&＃61;" CONFIG_SYS_SOC "\0"
#endif
#endif
#if defined(CONFIG_BOOTCOUNT_BOOTLIMIT) && (CONFIG_BOOTCOUNT_BOOTLIMIT > 0)"bootlimit&＃61;" __stringify(CONFIG_BOOTCOUNT_BOOTLIMIT)"\0"
#endif
#ifdef CONFIG_EXTRA_ENV_SETTINGSCONFIG_EXTRA_ENV_SETTINGS
#endif"\0"
#else /* CONFIG_USE_DEFAULT_ENV_FILE */
#include "generated/defaultenv_autogenerated.h"
#endif
#ifdef DEFAULT_ENV_INSTANCE_EMBEDDED}
#endif
};

菜单项显示及工作流程

do_bootmenu cmd/bootmenu.cbootmenu_show bootmenu_create 创建所有菜单项&＃xff0c;是一个链表结构bootmenu_getoption 获取bootmenu_%d 变量&＃xff0c;赋值给bootmenu_entry. 上面default_environment中定义了bootmenu_xx 变量menu_create 创建菜单bootmenu_print_entry 打印菜单项 回调函数bootmenu_choice_entry 等待用户选择菜单项 回调函数bootmenu_autoboot_loop 提示延时 bootmenu_loop 等待用户按键选择 menu_item_add 添加前面创建的菜单项加到此菜单中menu_default_set 设置默认菜单项menu_get_choice 获取用户选择的菜单项&＃xff0c;基中包含命令及标题等信息menu_interactive_choice common/menu.cmenu_display 显示菜单项menu_display_statusline 打印菜单状态栏“U-Boot Boot Menu” 与 “Press UP/DOWN to move, ENTER to select"” menu_item_by_key 调用bootmenu_print_entry 依次打印每个菜单项


common/menu.c 中定义的menu与menu_item

struct menu {struct menu_item *default_item;int timeout;char *title;int prompt;void (*item_data_print)(void *);char *(*item_choice)(void *);void *item_choice_data;struct list_head items;int item_cnt;
};struct menu_item {char *key;void *data;struct list_head list;
};

cmd/bootmenu.c 中定义中bootmenu_entry 和 bootmenu_data

struct bootmenu_entry {unsigned short int num; /* unique number 0 .. MAX_COUNT */char key[3]; /* key identifier of number */char *title; /* title of entry */char *command; /* hush command of entry */struct bootmenu_data *menu; /* this bootmenu */struct bootmenu_entry *next; /* next menu entry (num&＃43;1) */
};struct bootmenu_data {int delay; /* delay for autoboot */int active; /* active menu entry */int count; /* total count of menu entries */struct bootmenu_entry *first; /* first menu entry */
};


整个关联起来之后 menu_item 中的data 对应的就是bootmenu_entry。 bootmenu_entry 是可以根据需要而自已定义相应的结构体数据。bootmenu_data对应的是menu中的item_choice_data

添加自已的菜单

struct menu *menu_create(char *title, int timeout, int prompt,void (*item_data_print)(void *),char *(*item_choice)(void *),void *item_choice_data);
int menu_default_set(struct menu *m, char *item_key);
int menu_get_choice(struct menu *m, void **choice);
int menu_item_add(struct menu *m, char *item_key, void *item_data);
int menu_destroy(struct menu *m);
void menu_display_statusline(struct menu *m);
int menu_default_choice(struct menu *m, void **choice);


操作菜单相关的接口都在 common/menu.c 中有实现。 要添加菜单只需实现item_data_print和 item_choice 回调及item_choice_data 自定义的数据结构。 具体流程可以参考cmd/bootmenu.c中的do_bootmenu