SetupDesignGuide.pdf - Firmware Encoding Index

Setup Design Guide
DRAFT
should only be used in cases where the calling application is intended to be a pre-boot only utility. For
further information on the DYNAMIC and INTERACTIVE flags, see sections 4.3.3 and 4.3.4.
Example: oneof
varid = NULL.BootOptionSelection,
prompt = STR_BOOT_OPTION_SELECTION,
help = STR_BOOT_OPTION_HELP,
key = BOOT_OPTION_KEY,
flags = DYNAMIC | INTERACTIVE,
// There are no options defined in this case. The initial set of options are
// not known since they are system specific. For instance – when looking up
// a file, one cannot know how many file systems will be found on available
// media.
endoneof;
More information about interacting with hardware is contained in section 2.6.
4.2.12 checkbox / endcheckbox
The result returned by Checkbox is zero if the box is not checked and one if it is. If the default value
needs to be one, set the flags parameter to turn on the DEFAULT flag bit.
Notice that this is an example that the results of the user’s choice can be reflected into a NVRAM
storage location. See 6.2 to learn more about NVRAM configuration and to better understand how this
works programmatically.
Example: checkbox
4.2.13 numeric
endcheckbox;
varid = NvRamMap.SerialPortQuestion2,
prompt = STR_CHECK_BOX,
help = STR_CHECK_BOX_HELP,
flags = DEFAULT,
This command allows for numeric entry by selecting from numeric choices. The step portion of the
numeric command allows for the defining of at what rate the value increments when selection the next
or previous entry. If the step is set to zero, the user will be prompted for manual input of the numeric
value.
Notice that this is an example that the results of the user’s choice can be reflected into a NVRAM
storage location. See 6.2 to learn more about NVRAM configuration and to better understand how this
works programmatically.
Example: numeric
varid = NvRamMap.SystemTimeoutValue,
prompt = STR_NUMERIC,
help = STR_NUMERIC_HELP,
min = 0,
max = 35,
32