U-Boot menu菜单分析

于 2024-05-24 21:44:24 发布
阅读量799 收藏 22
点赞数 14
分类专栏： 嵌入式Linux 文章标签： linux U-Boot 嵌入式
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/cattle_l/article/details/139185141
版权

文章目录

前言

在某个厂家的开发板中，在进入它的U-Boot后，会自动弹出一个菜单页面，输入对应的选项就会执行对应的功能。如SD卡镜像更新、显示设置等：
image.png

目标

本文主要分析U-Boot在程序中的执行顺序，又如何在U-Boot阶段调起菜单？相信大家都试过，在U-Boot倒数结束前按任意按键后，会进入U-Boot命令行模式。
这里先留一个问题：如何做到按键按下后，调启的是自己的U-Boot菜单，而不再是进入冷冰冰的命令行模式？

环境背景

本文介绍所用的U-Boot版本：2018

U-Boot如何自动调起菜单

U-Boot的入口程序文件是<u-boot>/common/main.c，入口函数main_loop()：

/* We come here after U-Boot is initialised and ready to process commands */
/* 在U-Boot初始化并准备好处理命令之后，我们来到这里。 */
void main_loop(void)
{
    const char *s;

    bootstage_mark_name(BOOTSTAGE_ID_MAIN_LOOP, "main_loop");	

    #ifdef CONFIG_VERSION_VARIABLE
    env_set("ver", version_string);  /* set version variable */		
    #endif /* CONFIG_VERSION_VARIABLE */

    cli_init();							//命令初始化有关，初始化 hush shell 相关的变量

    run_preboot_environment_command();	//获取环境变量 perboot 的内容

    #if defined(CONFIG_UPDATE_TFTP)
    update_tftp(0UL, NULL, NULL);		
    #endif /* CONFIG_UPDATE_TFTP */

    s = bootdelay_process();	//此函数会读取环境变量 bootdelay 和 bootcmd 的内容
    if (cli_process_fdt(&s))
        cli_secure_boot_cmd(s);

    autoboot_command(s);		//开启倒计时，并在倒计时结束前检测是否有按键按下

    cli_loop();					//命令行处理函数（即进入U-Boot命令行）
    panic("No CLI available");
}

关键函数是autoboot_command()，该函数的实现在<u-boot>/common/autoboot.c：

void autoboot_command(const char *s)
{
    debug("### main_loop: bootcmd=\"%s\"\n", s ? s : "<UNDEFINED>");

    if (stored_bootdelay != -1 && s && !abortboot(stored_bootdelay)) {	// 倒计时过程中，没有按键按下
#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    int prev = disable_ctrlc(1);    /* disable Control C checking */
#endif

    run_command_list(s, -1, 0);		// 倒计时结束后，启动内核

#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    disable_ctrlc(prev);    /* restore Control C checking */
#endif
    }

#ifdef CONFIG_MENUKEY
    if (menukey == CONFIG_MENUKEY) {
        s = env_get("menucmd");
        if (s)
            run_command_list(s, -1, 0);
    }
#endif /* CONFIG_MENUKEY */
}

进入autoboot_command()后，先看第一个if：

void autoboot_command(const char *s)
{
    ...
        
    if (stored_bootdelay != -1 && s && !abortboot(stored_bootdelay))

    ...
}

这里有三个条件：

  • stored_bootdelay != -1：stored_bootdelay是倒数的总时间，就是常见的3秒、5秒不等；
  • s：传进来的参数s不能为空；
  • !abortboot(stored_bootdelay)：该函数会从stored_bootdelay开始倒计时，期间判断是否有按键按下。函数实现如下，倒计时过程中若检测到按键按下，则令abort=1。无按键按下，则abort=0。最后返回abort。
static int __abortboot(int bootdelay)
{
        int abort = 0;
        unsigned long ts;

#ifdef CONFIG_MENUPROMPT
        printf(CONFIG_MENUPROMPT);
#else
        printf("Hit any key to stop autoboot: %2d ", bootdelay);
#endif

        /*
         * Check if key already pressed
         */
        if (tstc()) {   /* we got a key press   */
                (void) getc();  /* consume input        */
                puts("\b\b\b 0");
                abort = 1;      /* don't auto boot      */
        }

        while ((bootdelay > 0) && (!abort)) {
                --bootdelay;
                /* delay 1000 ms */
                ts = get_timer(0);
                do {
                        if (tstc()) {   /* we got a key press   */
                                abort  = 1;     /* don't auto boot      */
                                bootdelay = 0;  /* no more delay        */
# ifdef CONFIG_MENUKEY
                                menukey = getc();
# else
                                (void) getc();  /* consume input        */
# endif
                                break;
                        }
                        udelay(10000);
                } while (!abort && get_timer(ts) < 1000);

                printf("\b\b\b%2d ", bootdelay);
        }

        putc('\n');

        return abort;
}

刚刚说了，abortboot()函数执行期间有按键按下的话，abortboot()会返回1，那就不会进入第一个if，程序会接着往下运行直至该函数运行结束。autoboot_command()结束后继续返回到main_loop()，随后立刻执行cli_loop()，进入我们所熟悉的U-Boot命令行模式。

void main_loop(void)
{
    ...
    
    autoboot_command(s);		//检查倒计时是否结束

    cli_loop();					//命令行处理函数
}

image.png
至此，就实现了U-Boot倒数期间，有按键按下，则进入U-Boot的命令行模式。
现在继续回到第一个if：

void autoboot_command(const char *s)
{
    ...
        
    if (stored_bootdelay != -1 && s && !abortboot(stored_bootdelay)) {	// 倒计时过程中，没有按键按下
#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    int prev = disable_ctrlc(1);    /* disable Control C checking */
#endif

    run_command_list(s, -1, 0);		// 倒计时结束后，启动内核

#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    disable_ctrlc(prev);    /* restore Control C checking */
#endif
    }

    ...
}

如果在autoboot倒计时结束前，一直没有按键按下呢？那abortboot()最后会返回0，第一个if的三个条件全部满足。进入if，run_command_list()执行一系列命令后，启动内核。注意，这里的现象是直接启动内核，run_command_list()后的程序不再执行。

解析到这里，我们得出一个结论：在autoboot倒计时中，如果有按键按下的话，会进入U-Boot的命令行模式。无按键按下则在倒计时结束后直接启动内核。
那现在可以回答第一个问题，如何做到按下按键后，是自启动U-Boot菜单，而不是进入U-Boot命令行呢？答案是在执行cli_loop()之前，我们可以在autoboot检测到按键按下后，调用run_command()函数执行menu命令，从而调起菜单。

void autoboot_command(const char *s)
{
    debug("### main_loop: bootcmd=\"%s\"\n", s ? s : "<UNDEFINED>");

    if (stored_bootdelay != -1 && s && !abortboot(stored_bootdelay)) {
#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    int prev = disable_ctrlc(1);    /* disable Control C checking */
#endif

    run_command_list(s, -1, 0);

#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    disable_ctrlc(prev);    /* restore Control C checking */
#endif
    }

    //启动菜单
    run_command("menu", 0);
    
#ifdef CONFIG_MENUKEY
    if (menukey == CONFIG_MENUKEY) {
        s = env_get("menucmd");
        if (s)
            run_command_list(s, -1, 0);
    }
#endif /* CONFIG_MENUKEY */
}

U-Boot添加自定义命令

难道通过run_command()执行menu命令后，菜单就自己出来了？这是一个理所当然的猜想。实际上U-Boot根本不认识menu命令：
image.png
接下来看看如何添加U-Boot命令，参考一下别人的代码：

int do_brightness(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
{
	int rcode = 0;
	ulong side;
	ulong bright;

	switch (argc) {
	case 3:
		side = simple_strtoul(argv[1], NULL, 10);
		bright = simple_strtoul(argv[2], NULL, 10);
		if ((side >= 0) && (side <= 3) &&
			(bright >= 0) && (bright <= 1000)) {
			vcxk_setbrightness(side, bright);
			rcode = 0;
		} else {
			printf("parameters out of range\n");
			printf("Usage:\n%s\n", cmdtp->usage);
			rcode = 1;
		}
		break;
	default:
		printf("Usage:\n%s\n", cmdtp->usage);
		rcode = 1;
		break;
	}
	return rcode;
}

U_BOOT_CMD(
	bright,	3,	0,	do_brightness,
	"sets the display brightness\n",
	" <side> <0..1000>\n        side: 0/3=both; 1=first; 2=second\n"
);

先看最底下的U_BOOT_CMD，这是一个宏，用来添加U-Boot命令：

#define U_BOOT_CMD(_name, _maxargs, _rep, _cmd, _usage, _help)		\
	U_BOOT_CMD_COMPLETE(_name, _maxargs, _rep, _cmd, _usage, _help, NULL)
  • _name：命令的名字
  • _maxargs：添加的命令最多有几个参数
  • _rep：是否重复（1重复，0不重复），指在U-Boot命令行按下Enter键的时候，重复执行上次的命令
  • _cmd：执行函数（即执行该命令后，运行哪个函数）
  • _usage：短帮助信息
  • _help：长帮助信息

再来看看执行函数do_brightness的声名：

int (*cmd)(struct cmd_tbl_s *cmdtp, int flag, int argc, char *const argv[]);
  • cmdtp：Table entry describing the command (see above).
  • flag：A bitmap which may contain the following bit
    • CMD_FLAG_REPEAT - The last command is repeated.
    • CMD_FLAG_BOOTD - The command is called by the bootd command.
    • CMD_FLAG_ENV - The command is called by the run command.
  • argc：执行命令时，传入的参数数量
  • argv：传入的参数

实践

下面，添加一个U-Boot菜单，不过只作打印，没有实际功能。
在<u-boot>/drivers下创建一个名为mymenu的文件夹：
image.png
在mymenu文件夹下创建mymenu.c，内容如下：

#include <common.h>
#include <command.h>
#include <linux/ctype.h>
#include <cli.h>
#include <fs.h>

static int do_mymenu(struct cmd_tbl_s *cmdtp, int flag, int argc, char *const argv[])
{
    if(argc != 2)
        return 0;
    
    if(!strcmp(argv[1], "pageone"))
        printf("\n======== pageone ========\n");            
    else if(!strcmp(argv[1], "pagetwo"))
        printf("\n======== pagetwo ========\n"); 
    else
        printf("\n======== pageone ========\n"); 

    printf("== [1] xxxxxx\n");
    printf("== [2] xxxxxx\n");
    printf("== [3] xxxxxx\n");
    printf("== [4] xxxxxx\n");
    printf("=========================\n\n");

    return 0;
}

U_BOOT_CMD(
	mymenu,	2,	1, do_mymenu,
	"here is uboot mymenu\n",
	"here is uboot mymenu, make in 2024-05-15\n"
);

还需在mymenu文件夹下创建一个Makefile文件，内容如下：

obj-y += mymenu.o

最后修改<u-boot>/drivers/下的Makefile，在结尾加上如下内容，表示要编译mymenu路径下的文件：
image.png
编译U-Boot，更新U-Boot，重启单板，在U-Boot倒计时结束前，按任意按键进入U-Boot命令行，输入mymenu后，可以看到命令被正确识别，对应的函数也执行成功：
image.png
那如何做到按任意按键后直接调起菜单呢？上面有说过，可以在autoboot检测到按键按下后，调用run_command()函数执行mymenu命令，从而调起菜单。

void autoboot_command(const char *s)
{
    debug("### main_loop: bootcmd=\"%s\"\n", s ? s : "<UNDEFINED>");

    if (stored_bootdelay != -1 && s && !abortboot(stored_bootdelay)) {
#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    int prev = disable_ctrlc(1);    /* disable Control C checking */
#endif

    run_command_list(s, -1, 0);

#if defined(CONFIG_AUTOBOOT_KEYED) && !defined(CONFIG_AUTOBOOT_KEYED_CTRLC)
    disable_ctrlc(prev);    /* restore Control C checking */
#endif
    }

    //启动菜单
    run_command("mymenu", 0);
    
#ifdef CONFIG_MENUKEY
    if (menukey == CONFIG_MENUKEY) {
        s = env_get("menucmd");
        if (s)
            run_command_list(s, -1, 0);
    }
#endif /* CONFIG_MENUKEY */
}

image.png
剩下的菜单程序编写就是根据实际功能来开发了。

林政硕（Cohen0415）
关注
  • 14
    点赞
  • 踩
  • 22
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
uboot中的快捷菜单的制作说明
qiancainiao的专栏
02-27 536
这个菜单其实就是一个uboot中的命令，uboot启动时，如果进入下载模式，就先运行这个命令。命令的执行内容就是通过串口打印出一个菜单，等待输入数字，再执行相应的动作。 新建一个名为：cmd_menu.c的文件，放到common目录下，修改同目录下的Makefile文件，加入编译选项： COBJS-$(CONFIG_CMD_MENU) += cmd_menu.o 编写cmd_menu
在uboot上创建菜单
weixin_33779515的博客
02-24 188
一、原理     菜单其实就是一个uboot中的命令，和其他的命令没有什么差别。 　 uboot启动时，如果进入uboot命令模式，先运行这个命令，就会打印出一个菜单界面。     在uboot的命令模式，通过键入“menu”命令，同样可以调出这个界面。 二、操作步骤 1、在common目录下创建cmd_menu.c 内容如下： #include &lt;common.h&g...
uboot命令菜单解析实现分析
风雨无阻
08-17 441
命令解析过程分析
linux boot菜单列表,U-boot启动菜单实现
weixin_34177886的博客
05-15 413
1、实现原理向U-boot中添加命令bootmenu(实现菜单)，并设置U-boot自启动参数为该命令，改变U-boot启动延时为1，则U-boot启动后就运行该命令。2、实现过程(1)、在common目录下新增bootmenu.c文件，代码如下：#include #include static char waitconsoleinput(unsigned long delay){int i;if...
u-boot菜单实现源码
07-31
uboot菜单简单实现，免费分享，呵呵。
u-boot-1.1.6-TQ6410_V0.1
07-18
ARM11 S3C6410底层软件 UOOBT 启动 支持SD启动 WINCE LINUX TQ6410 u-boot 版本：u-boot-1.1.6 主要功能： 1、支持一键式菜单，操作简单方便 2、支持Nand Flash擦除、读、写 3、支持USB 下载镜像 4、支持打印、设置...
U盘启动文件menu.lst菜单介绍.docx
09-27
标题中的"U盘启动文件menu.lst菜单介绍"指的是在创建U盘启动盘时，U盘根目录下会有一个名为menu.lst的配置文件。这个文件的主要作用是定义U盘启动时显示的菜单及其对应的启动选项。menu.lst是GRUB4DOS（一个引导加载...
U 盘启动制作工具 AIO Boot 0.9.9.19.zip
05-07
开源免费 U 盘启动制作工具 AIO Boot 中文版开源免费 U 盘启动制作工具 AIO Boot 中文版 AIO Boot 特色： 对于旧版 MBR：Grub2，Grub4dos，Syslinux 和 Clover [旧版]。 对于 UEFI-GPT：Grub2，Clover [UEFI]和 ...
U盘启动菜单文件详解.docx
09-27
标题中的“U盘启动菜单文件详解.docx”指的是关于如何理解和使用U盘作为启动设备时，其中menu.lst文件的详细解析。menu.lst文件是GRUB（Grand Unified Bootloader）引导加载器的一部分，它用于定制启动菜单，允许...
Uboot移植添加启动菜单
阿生的专栏
11-19 2266
当uboot启动过程中可以按任意键中断uboot的启动，进入uboot命令行模式，这里是添加进入命令行之前的菜单，实现简易的菜单选择。启动菜单的设置所有文件都在uboot/common目录下。 第一步，在uboot/common目录下创建名为cmd_menu.c的文件，并添加如下代码： /* * add uboot cmd_menu by sn02241 */ #include #
uboot移植（十六）添加启动菜单
跬步千里，窥叶知秋
06-10 2853
参考帮助文档 doc/README.bootmenu 首先我们需要在 Louis210.h 中增加 4 个宏 另外，帮助文档还提到要定义 CONFIG_BOOTDELAY，表示显示菜单多久，这个宏已经定义了，默认为 3s 现在重新编译 u-boot， 从 NAND FLASH 启动开发板， 将 u-boot.bin 烧写到 NAND FLASH         我这里将所有命令写在一行...
u-boot-2019 引导菜单分析
sense的专栏
12-03 550
configs/ls2k_core.h 中定义了默认的菜单项及其他默认变量 #define CONFIG_EXTRA_ENV_SETTINGS \ CONSOLE_STDOUT_SETTINGS \ "loadaddr=" __stringify(CONFIG_SYS_LOAD_ADDR) "\0" \ "rd_start=0x86000000\0" \ "rd_siz
UBOOT通用菜单menu的实现
leochen_career的专栏
12-26 2503
1. 概述 在uboot中经常需要开发一个菜单，用来进行一些选项类的操作，如下图所示 网上有很多介绍菜单的开发方法，但很多都是自己开发，没有统一的开发框架。最近研究uboot代码时发现，其实uboot（版本为2016）代码中有一个菜单框架，以及使用这个框架的一个具体例子，可以根据自己的需要进行适当的修改，用起来非常方便。 2.具体实现 菜单框架代码位于/common/menu.c文...
U-Boot 图形化配置
weixin_46829095的博客
01-17 693
U-Boot 图形化配置
linux uboot制作自定义菜单指令menu
最新发布
qq_45147279的博客
09-12 350
由于有时候需要不同类型的屏幕显示，但是来回烧写又显得非常的麻烦，遇到上述问题的话，我们可以采取以下方法去解决刚刚的问题。尝试过在STM32MP157,RK356X,RK3588里使用。U_BOOT_CMD()函数。
U-Boot添加menu命令的方法及U-Boot命令执行过程
weixin_30305735的博客
09-18 206
转;http://chenxing777414.blog.163.com/blog/static/186567350201141791224740/ 下面以添加menu命令（启动菜单）为例讲解U-Boot添加命令的方法。 （1） 建立common/cmd_menu.c 习惯上通用命令源代码放在common目录下，与开发板专有命令源代码则放在board/<b...
u-boot 怎么进入menu界面
06-11
在 U-Boot 中，进入菜单界面需要通过按键触发，具体的按键和触发方式可能因不同的设备而异。一般情况下，你需要按下串口终端或者显示器输入设备上的某个键才能进入菜单界面。 以下是一些常见的触发方式： 1. 按下空格键：在 U-Boot 启动过程中按下空格键，即可进入菜单界面。 2. 按下 Ctrl+C：在 U-Boot 启动过程中按下 Ctrl+C 键组合，即可进入菜单界面。 3. 按下 Esc 键：在 U-Boot 启动过程中按下 Esc 键，即可进入菜单界面。 4. 按下任意键：在 U-Boot 启动过程中按下任意键，即可进入菜单界面。 需要注意的是，不同版本的 U-Boot 可能具有不同的菜单界面和操作方式。如果你无法通过以上方式进入菜单界面，可以查阅 U-Boot 的官方文档或者设备的技术手册，以获取更详细的信息。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值