Specifications
AMD Geode™ GeodeROM Functional Specification 251
Configuring/Customizing
32087C
LABEL_ITEM user_label
Labels the current item with the user label and makes the following information PUBLIC:
• LABEL_ITEM_user_label - The label of the item entry definition for the current item.
• ITEM_MENU_ORDINAL_user_label - The ordinal of the menu containing the item.
• ITEM_ORDINAL_user_label - The ordinal of the item within the menu.
ITEM_HELP help_text
Defines the help text that appears on the bottom line of the menu screen when this item is highlighted. Help text must con-
sist of only one line and be no wider than the menu screen. The help text starts in column two of the menu screen. There
may be only one ITEM_HELP line for each item.
LONG_HELP long_help_text
Defines one line of a long help displayed when the F1 key is pressed while an item is highlighted. There may be more than
one LONG_HELP line for the item. Each displays as a separate line in the long help screen. If there are more lines than fit
on the long help screen, the user can scroll up and down using the PgUp and PgDown keys.
GOTO_MENU menu_name
Tells the system to display the menu specified by menu_name. Menu_name must be the same as a Name parameter of a
MENU entry. In addition menu_name may be one of the following special entries:
• QUIT_TO_TOP - Exit to the menu with the TOP_MENU flag. If no menu has a TOP_MENU flag set, then exit the menu
system.
• PREV_MENU - Go to the menu that called this menu.
• SAME_MENU - Stay on this menu.
DO_FUNCTION function_name
Tells the system that the function specified by function_name will be executed. The function is a ‘c’ function external to the
smenu.asm file. This function cannot be used for an item containing the CHOICE or RANGE entries described on
page 252. The prototype of the function is:
int function_name(int menu, int item);
Menu is the ordinal number of the menu that contains the item.
Item is the ordinal number of the item within the menu.
The function must return one of the following:
• Zero - The function had an error. An error beep will sound. No GOTO_MENU (if any was defined) will be executed.
• One - The function was successful. Any GOTO_MENU defined will be executed.
• Negative number - Exit up n levels of menu. A -1 will go up one menu.
FIELD_DEF field_type,field_name,length,conflict
Defines a field that is executed when the item is selected. There may be only one FIELD_DEF for an item.
Parameters Description
field_type Always the literal “TOKEN”
field_name The NVRAM TOKEN this field acts upon.
length The length of this field in bits.
conflict Used for conflict checking. All fields with the same conflict number are compared for identical val-
ues. If identical values are found “?Conflict nn” is displayed next to all items with the same conflict
number. (nn is the conflict number.) In addition, the flag “ZERO_OK” may be OR’ed in with the con-
flict number to indicate that multiple items with the value zero are not a conflict.