Technical Product Specification

Customization Intel® Local Control Panel TPS
Revision 1.2
Intel order number C96442-003
32
10.4 Menu Customization
The Intel
®
Local Control Panel supports customization of the menus. This customization
includes changing the order of listed menus, adding or removing menu items, and adding new
menu items to display existing Intel
®
Local Control Panel functions. To understand the menu
structure, correlate the 128 menu numbers (ranged 0-127) to the first 128 strings of the string
data.
The Intel
®
Local Control Panel menus are defined by a packed array of data bytes. This array
consists of 128 menu items, with each menu item defined by eight bytes. Each menu item has a
menu item number that equates to that menu item‟s position in the menu array. For example,
the 4th set of eight bytes in the array has a menu item number of 03h. Menu item 00h in the
array is a special menu item number and is used as a terminator. Menu item 00h should not be
modified other than changing the next pointer if desired.
The eight bytes of an individual menu item are defined by the following for the menu:
1. Index of previous menu item in the menu: This byte is a pointer to the menu item
number of the menu item that appears before this menu item in the menu display. This is
the menu item that the Intel
®
Local Control Panel will navigate to when the user presses
the Up button.
2. Index of the next menu item in the menu: This byte is a pointer to the menu item
number of the menu item that appears after this menu item in the menu display. This is
the menu item that the Intel
®
Local Control Panel will navigate to when the user presses
the Down button.
3. Index of the parent: This byte is a pointer to the menu item number of the menu item
that will act as a parent menu in the menu display. This is the menu item that the Intel
®
Local Control Panel will navigate to when the user presses the Back button. The menu
item will only appear if the user first navigates to the parent menu.
4. Index of the operation to execute when the Enter button is pressed while this item
is highlighted: This byte is a pointer to the built-in operations of the Intel
®
Local Control
Panel. Some operations require additional arguments. These arguments are defined by
data bytes 5 and 6.
5. Argument 1 for the operation (byte): This argument is used with the operation index
number.
6. Argument 2 for the operation (byte): This argument is used with the operation index
number.
7. Behavior flags for the menu item: These define functionality for a specific operation.
This allows for the modification of the execution path of the menu option, such as the
ability to set a menu field as an editable value, instead of a displayed value.
8. Security access level for the item (access level required to trigger the operation):
Sets the IPMI privilege level required to execute the menu item.