[PATCH v4 1/2] menu: Add a function to set the default by matching the item data

From: Frieder Schrempf frieder.schrempf@kontron.de
In order to make it possible to auto select a default entry by matching the data of the menu entries by an external matching function, we add some helpers and expose the menu_set_default_by_item_data_match() function.
Signed-off-by: Frieder Schrempf frieder.schrempf@kontron.de --- Changes in v4: * Use the proper style for the function description * Move the comment for the function description to the header file
Changes in v3: * Add a full function comment to describe menu_set_default_by_item_data_match().
Changes in v2: * Keep the menu structs private and instead only expose one additional function, that sets the default by calling an external matching function on each entry. * Change the title and commit message to reflect the changes. --- common/menu.c | 40 ++++++++++++++++++++++++++++++++++++++++ include/menu.h | 19 +++++++++++++++++++ 2 files changed, 59 insertions(+)
diff --git a/common/menu.c b/common/menu.c index 7b66d199a9..e16a0a4a50 100644 --- a/common/menu.c +++ b/common/menu.c @@ -160,6 +160,46 @@ static inline struct menu_item *menu_item_by_key(struct menu *m, return menu_items_iter(m, menu_item_key_match, item_key); }
+/* + * Find the first matching item, if any exists by calling a matching function + * on the items data field. + */ +static inline struct menu_item *menu_item_by_matching_fn(struct menu *m, + int match(void *, void *), void * extra) +{ + struct list_head *pos, *n; + struct menu_item *item; + int ret; + + list_for_each_safe(pos, n, &m->items) { + item = list_entry(pos, struct menu_item, list); + if (item->key) { + ret = match(item->data, extra); + if (ret == 1) + return item; + } + } + + return NULL; +} + +/* + * Sets a menu default option by calling a matching function on each of the + * menu items data field. + */ +int menu_set_default_by_item_data_match(struct menu *m, + int match(void *, void *), void *extra, char **key) +{ + struct menu_item *item = menu_item_by_matching_fn(m, match, extra); + + if (!item) + return -ENOENT; + + *key = item->key; + m->default_item = item; + return 0; +} + /* * Set *choice to point to the default item's data, if any default item was * set, and returns 1. If no default item was set, returns -ENOENT. diff --git a/include/menu.h b/include/menu.h index 2d227c20bd..96c9fcac03 100644 --- a/include/menu.h +++ b/include/menu.h @@ -19,6 +19,25 @@ int menu_destroy(struct menu *m); void menu_display_statusline(struct menu *m); int menu_default_choice(struct menu *m, void **choice);
+/** + * menu_set_default_by_item_data_match() - - sets a menu default option by + * calling a matching function on each of the menu items data field. + * + * @m: Points to a menu created by menu_create(). + * @match: Points to a function that is passed a pointer to the items data field + * and a pointer to extra data to compare with. It should return 1 on a + * match. + * @extra: Points to some data that is passed as a second parameter to the + * matching function. + * @key: Points to a char array that will be set to hold the key of the matched + * menu item. + * @return 0 if a matching item was found, + * -ENOENT if no matching item was found + */ +int menu_set_default_by_item_data_match(struct menu *m, + int match(void *, void *), void *extra, + char **key); + /** * menu_show() Show a boot menu *

From: Frieder Schrempf frieder.schrempf@kontron.de
In order to auto-select an option from the pxe boot menu, that matches the detected board, we check the board model string in the devicetree and set the default menu selection, if it matches the label of the menu entry and there is no default selection already set.
This is useful in combination with SPL that loads a FIT image with U-Boot and multiple DTBs. SPL can detect the board and choose the matching configuration in the FIT by using board_fit_config_name_match().
Signed-off-by: Frieder Schrempf frieder.schrempf@kontron.de --- Changes in v4: * Remove #ifdef that would cause build failures in case of OF_CONTROL being disabled.
Changes in v3: * Get rid of #ifdef by using IS_ENABLED() in else branch.
Changes in v2: * Don't use internal structs of menu, but instead call --- cmd/pxe_utils.c | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+)
diff --git a/cmd/pxe_utils.c b/cmd/pxe_utils.c index 53af04d7dc..9a6c67c93a 100644 --- a/cmd/pxe_utils.c +++ b/cmd/pxe_utils.c @@ -1220,6 +1220,44 @@ struct pxe_menu *parse_pxefile(cmd_tbl_t *cmdtp, unsigned long menucfg) return cfg; }
+int pxe_match_menu_label_with_str(void *data, void *str) +{ + struct pxe_label *label; + + if (!data || !str) + return 0; + + label = (struct pxe_label *)data; + + if (strcmp(label->name, str) == 0) + return 1; + + return 0; +} + +int pxe_runtime_select_menu_default(struct menu *m) +{ + DECLARE_GLOBAL_DATA_PTR; + const char *model; + char *key; + int ret; + + model = fdt_getprop(gd->fdt_blob, 0, "model", NULL); + + if (!model) + return 0; + + ret = menu_set_default_by_item_data_match(m, + pxe_match_menu_label_with_str, (void *)model, &key); + if (ret) + return ret; + + printf("Menu entry %s fits detected board. " \ + "Use as default selection...\n", key); + + return 0; +} + /* * Converts a pxe_menu struct into a menu struct for use with U-Boot's generic * menu code. @@ -1258,6 +1296,8 @@ static struct menu *pxe_menu_to_menu(struct pxe_menu *cfg) /* * After we've created items for each label in the menu, set the * menu's default label if one was specified. + * If OF_CONTROL is enabled and we don't have a default specified, + * we try to use an entry that matches the board/model name as default. */ if (default_num) { err = menu_default_set(m, default_num); @@ -1269,6 +1309,10 @@ static struct menu *pxe_menu_to_menu(struct pxe_menu *cfg)
printf("Missing default: %s\n", cfg->default_label); } + } else if (IS_ENABLED(CONFIG_OF_CONTROL) && + pxe_runtime_select_menu_default(m)) { + menu_destroy(m); + return NULL; }
return m;

On Wed, 12 Feb 2020 at 03:37, Schrempf Frieder frieder.schrempf@kontron.de wrote:
From: Frieder Schrempf frieder.schrempf@kontron.de
In order to auto-select an option from the pxe boot menu, that matches the detected board, we check the board model string in the devicetree and set the default menu selection, if it matches the label of the menu entry and there is no default selection already set.
This is useful in combination with SPL that loads a FIT image with U-Boot and multiple DTBs. SPL can detect the board and choose the matching configuration in the FIT by using board_fit_config_name_match().
Signed-off-by: Frieder Schrempf frieder.schrempf@kontron.de
Changes in v4:
- Remove #ifdef that would cause build failures in case of OF_CONTROL being disabled.
Changes in v3:
- Get rid of #ifdef by using IS_ENABLED() in else branch.
Changes in v2:
- Don't use internal structs of menu, but instead call
cmd/pxe_utils.c | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+)
Reviewed-by: Simon Glass sjg@chromium.org

On 12.02.20 11:37, Schrempf Frieder wrote:
From: Frieder Schrempf frieder.schrempf@kontron.de
In order to make it possible to auto select a default entry by matching the data of the menu entries by an external matching function, we add some helpers and expose the menu_set_default_by_item_data_match() function.
Signed-off-by: Frieder Schrempf frieder.schrempf@kontron.de
Changes in v4:
- Use the proper style for the function description
- Move the comment for the function description to the header file
Changes in v3:
- Add a full function comment to describe menu_set_default_by_item_data_match().
Changes in v2:
- Keep the menu structs private and instead only expose one additional function, that sets the default by calling an external matching function on each entry.
- Change the title and commit message to reflect the changes.
common/menu.c | 40 ++++++++++++++++++++++++++++++++++++++++ include/menu.h | 19 +++++++++++++++++++ 2 files changed, 59 insertions(+)
diff --git a/common/menu.c b/common/menu.c index 7b66d199a9..e16a0a4a50 100644 --- a/common/menu.c +++ b/common/menu.c @@ -160,6 +160,46 @@ static inline struct menu_item *menu_item_by_key(struct menu *m, return menu_items_iter(m, menu_item_key_match, item_key); }
+/*
- Find the first matching item, if any exists by calling a matching function
- on the items data field.
- */
+static inline struct menu_item *menu_item_by_matching_fn(struct menu *m,
int match(void *, void *), void * extra)
+{
- struct list_head *pos, *n;
- struct menu_item *item;
- int ret;
- list_for_each_safe(pos, n, &m->items) {
item = list_entry(pos, struct menu_item, list);
if (item->key) {
ret = match(item->data, extra);
if (ret == 1)
return item;
}
- }
- return NULL;
+}
+/*
- Sets a menu default option by calling a matching function on each of the
- menu items data field.
- */
+int menu_set_default_by_item_data_match(struct menu *m,
int match(void *, void *), void *extra, char **key)
+{
- struct menu_item *item = menu_item_by_matching_fn(m, match, extra);
- if (!item)
return -ENOENT;
- *key = item->key;
- m->default_item = item;
- return 0;
+}
- /*
- Set *choice to point to the default item's data, if any default item was
- set, and returns 1. If no default item was set, returns -ENOENT.
diff --git a/include/menu.h b/include/menu.h index 2d227c20bd..96c9fcac03 100644 --- a/include/menu.h +++ b/include/menu.h @@ -19,6 +19,25 @@ int menu_destroy(struct menu *m); void menu_display_statusline(struct menu *m); int menu_default_choice(struct menu *m, void **choice);
+/**
- menu_set_default_by_item_data_match() - - sets a menu default option by
I just saw, that there's a superfluous hyphen here. Sorry, will fix it if a new version is requested.
- calling a matching function on each of the menu items data field.
- @m: Points to a menu created by menu_create().
- @match: Points to a function that is passed a pointer to the items data field
and a pointer to extra data to compare with. It should return 1 on a
match.
- @extra: Points to some data that is passed as a second parameter to the
matching function.
- @key: Points to a char array that will be set to hold the key of the matched
menu item.
- @return 0 if a matching item was found,
-ENOENT if no matching item was found
- */
+int menu_set_default_by_item_data_match(struct menu *m,
int match(void *, void *), void *extra,
char **key);
- /**
- menu_show() Show a boot menu

On Wed, 12 Feb 2020 at 03:37, Schrempf Frieder frieder.schrempf@kontron.de wrote:
From: Frieder Schrempf frieder.schrempf@kontron.de
In order to make it possible to auto select a default entry by matching the data of the menu entries by an external matching function, we add some helpers and expose the menu_set_default_by_item_data_match() function.
Signed-off-by: Frieder Schrempf frieder.schrempf@kontron.de
Changes in v4:
- Use the proper style for the function description
- Move the comment for the function description to the header file
Changes in v3:
- Add a full function comment to describe menu_set_default_by_item_data_match().
Changes in v2:
- Keep the menu structs private and instead only expose one additional function, that sets the default by calling an external matching function on each entry.
- Change the title and commit message to reflect the changes.
common/menu.c | 40 ++++++++++++++++++++++++++++++++++++++++ include/menu.h | 19 +++++++++++++++++++ 2 files changed, 59 insertions(+)
Looks good.
diff --git a/common/menu.c b/common/menu.c index 7b66d199a9..e16a0a4a50 100644 --- a/common/menu.c +++ b/common/menu.c @@ -160,6 +160,46 @@ static inline struct menu_item *menu_item_by_key(struct menu *m, return menu_items_iter(m, menu_item_key_match, item_key); }
+/*
- Find the first matching item, if any exists by calling a matching function
- on the items data field.
- */
+static inline struct menu_item *menu_item_by_matching_fn(struct menu *m,
int match(void *, void *), void * extra)
No space after *
What is extra? This function needs a comment I think.
+{
struct list_head *pos, *n;
struct menu_item *item;
int ret;
list_for_each_safe(pos, n, &m->items) {
item = list_entry(pos, struct menu_item, list);
if (item->key) {
ret = match(item->data, extra);
if (ret == 1)
return item;
}
}
return NULL;
+}
+/*
- Sets a menu default option by calling a matching function on each of the
- menu items data field.
- */
+int menu_set_default_by_item_data_match(struct menu *m,
int match(void *, void *), void *extra, char **key)
+{
struct menu_item *item = menu_item_by_matching_fn(m, match, extra);
if (!item)
return -ENOENT;
*key = item->key;
m->default_item = item;
blank line before return
return 0;
+}
/*
- Set *choice to point to the default item's data, if any default item was
- set, and returns 1. If no default item was set, returns -ENOENT.
diff --git a/include/menu.h b/include/menu.h index 2d227c20bd..96c9fcac03 100644 --- a/include/menu.h +++ b/include/menu.h @@ -19,6 +19,25 @@ int menu_destroy(struct menu *m); void menu_display_statusline(struct menu *m); int menu_default_choice(struct menu *m, void **choice);
+/**
- menu_set_default_by_item_data_match() - - sets a menu default option by
- calling a matching function on each of the menu items data field.
- @m: Points to a menu created by menu_create().
- @match: Points to a function that is passed a pointer to the items data field
and a pointer to extra data to compare with. It should return 1 on a
match.
else 0 ?
Also, can you document the args to match()? Can they be const *? I actually wonder if you should add a typedef to make this a bit clearer? I know we don't use them for structs but I think they have value with function pointers.
- @extra: Points to some data that is passed as a second parameter to the
matching function.
- @key: Points to a char array that will be set to hold the key of the matched
menu item.
- @return 0 if a matching item was found,
-ENOENT if no matching item was found
- */
+int menu_set_default_by_item_data_match(struct menu *m,
int match(void *, void *), void *extra,
char **key);
/**
- menu_show() Show a boot menu
-- 2.17.1
participants (2)
-
Schrempf Frieder
-
Simon Glass