120 lines
3.0 KiB
Plaintext
120 lines
3.0 KiB
Plaintext
/*
|
|
* Copyright 2010-2011 Calxeda, Inc.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the Free
|
|
* Software Foundation; either version 2 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
* This program is distributed in the hope it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
* more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along with
|
|
* this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
U-boot provides a set of interfaces for creating and using simple, text
|
|
based menus. Menus are displayed as lists of labeled entries on the
|
|
console, and an entry can be selected by entering its label.
|
|
|
|
To use the menu code, enable CONFIG_MENU, and include "menu.h" where
|
|
the interfaces should be available.
|
|
|
|
Menus are composed of items. Each item has a key used to identify it in
|
|
the menu, and an opaque pointer to data controlled by the consumer.
|
|
|
|
Interfaces
|
|
----------
|
|
#include "menu.h"
|
|
|
|
/*
|
|
* Consumers of the menu interfaces will use a struct menu * as the
|
|
* handle for a menu. struct menu is only fully defined in menu.c,
|
|
* preventing consumers of the menu interfaces from accessing its
|
|
* contents directly.
|
|
*/
|
|
struct menu;
|
|
|
|
/*
|
|
* NOTE: See comments in common/menu.c for more detailed documentation on
|
|
* these interfaces.
|
|
*/
|
|
|
|
/*
|
|
* menu_create() - Creates a menu handle with default settings
|
|
*/
|
|
struct menu *menu_create(char *title, int timeout, int prompt,
|
|
void (*item_data_print)(void *));
|
|
|
|
/*
|
|
* menu_item_add() - Adds or replaces a menu item
|
|
*/
|
|
int menu_item_add(struct menu *m, char *item_key, void *item_data);
|
|
|
|
/*
|
|
* menu_default_set() - Sets the default choice for the menu
|
|
*/
|
|
int menu_default_set(struct menu *m, char *item_key);
|
|
|
|
/*
|
|
* menu_get_choice() - Returns the user's selected menu entry, or the
|
|
* default if the menu is set to not prompt or the timeout expires.
|
|
*/
|
|
int menu_get_choice(struct menu *m, void **choice);
|
|
|
|
/*
|
|
* menu_destroy() - frees the memory used by a menu and its items.
|
|
*/
|
|
int menu_destroy(struct menu *m);
|
|
|
|
|
|
Example Code
|
|
------------
|
|
This example creates a menu that always prompts, and allows the user
|
|
to pick from a list of tools. The item key and data are the same.
|
|
|
|
#include "menu.h"
|
|
|
|
char *tools[] = {
|
|
"Hammer",
|
|
"Screwdriver",
|
|
"Nail gun",
|
|
NULL
|
|
};
|
|
|
|
char *pick_a_tool(void)
|
|
{
|
|
struct menu *m;
|
|
int i;
|
|
char *tool = NULL;
|
|
|
|
m = menu_create("Tools", 0, 1, NULL);
|
|
|
|
for(i = 0; tools[i]; i++) {
|
|
if (menu_item_add(m, tools[i], tools[i]) != 1) {
|
|
printf("failed to add item!");
|
|
menu_destroy(m);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
if (menu_get_choice(m, (void **)&tool) != 1)
|
|
printf("Problem picking tool!\n");
|
|
|
|
menu_destroy(m);
|
|
|
|
return tool;
|
|
}
|
|
|
|
void caller(void)
|
|
{
|
|
char *tool = pick_a_tool();
|
|
|
|
if (tool) {
|
|
printf("picked a tool: %s\n", tool);
|
|
use_tool(tool);
|
|
}
|
|
}
|