u-boot.git/include/menu.h, branch v2026.04

cmd: bootmenu: permit to select bootmenu entry with a shortcut

2025-06-05T22:57:35+00:00

Permit to select a bootmenu entry with a key shortcut. This is
especially useful in production or testing scenario to automate flashing
procedure or testing procedure.

The boot entry are changed to append the shortcut key to it.

Example:
      1. Run default boot command.
      2. Boot system via TFTP.
      3. Boot production system from NAND.
      4. Boot recovery system from NAND.
      5. Load production system via TFTP then write to NAND.
      6. Load recovery system via TFTP then write to NAND.
      7. Load BL31+U-Boot FIP via TFTP then write to NAND.
      8. Load BL2 preloader via TFTP then write to NAND.
      9. Reboot.
      a. Reset all settings to factory defaults.
      0. Exit

0 is always reserved for Exit to console.
On pressing the keyboard key 2, the bootmenu entry 2 is selected and
executed.

Up to 34 key shortcut (0 excluded as reserved) are supported from 1-9
and a-z.
If a shortcut key not present in the bootmenu list is pressed, it is
simply ignored and eventually the autoboot is interrupted.

Capital A-Z are converted to lower a-z and the related option is
selected.

Suggested-by: Weijie Gao 
Signed-off-by: Christian Marangi 
Tested-by: Petr Štetiar

bootmenu: add reprint check

2024-11-04T22:41:38+00:00

Record the last active menu item and check if it equals to the
current selected item before reprint.

Signed-off-by: Weijie Gao 
Reviewed-by: Daniel Golle 
Tested-by: Daniel Golle

menu: add support to check if menu needs to be reprinted

2024-11-04T22:41:38+00:00

This patch adds a new callback named need_reprint for menu.
The need_reprint will be called before printing the menu. If the
callback exists and returns FALSE, menu printing will be canceled.

This is very useful if the menu was not changed. It can save time
for serial-based menu to handle more input data.

Signed-off-by: Weijie Gao 
Reviewed-by: Daniel Golle 
Tested-by: Daniel Golle

expo: Support handling any key in cedit

2023-10-11T19:43:55+00:00

At present cedit only supports menu keys. For textline objects we need
to insert normal ASCII characters.

We also need to handle backspace, which is ASCII 9.

In fact, expo does not make use of all the menu keys, so partition
them accordingly and update the logic to support normal ASCII
characters, too.

Signed-off-by: Simon Glass

eficonfig: CTRL+S to save the boot order

2023-02-10T12:05:39+00:00

The change boot order menu in eficonfig can have at most INT_MAX lines
and it is troublesome to scroll down to the "Save" entry.

This commit assigns CTRL+S to save the boot order.

Signed-off-by: Masahisa Kojima 
Acked-by: Heinrich Schuchardt

menu: Factor out menu-keypress decoding

2023-01-16T23:26:50+00:00

Move this code into a separate function so that it can be used in the new
VBE menu.

Signed-off-by: Simon Glass

menu: Make use of CLI character processing

2023-01-16T19:14:11+00:00

Avoid duplicating some of the escape-sequence processing here and use the
CLI function instead.

Signed-off-by: Simon Glass

menu: Update bootmenu_loop() to return the code

2023-01-16T19:14:11+00:00

Use the return value to save having to pass around a pointer. This also
resolves any ambiguity about what *key contains when the function is
called.

Signed-off-by: Simon Glass

menu: Update bootmenu_autoboot_loop() to return the code

2023-01-16T19:14:11+00:00

Use the return value to save having to pass around a pointer. This also
resolves any ambiguity about what *key contains when the function is
called.

Signed-off-by: Simon Glass

menu: Rename KEY_... to BKEY_...

2023-01-16T19:14:11+00:00

This enum values conflict with linux/input.h so rename them.

Signed-off-by: Simon Glass