[mirror_edk2.git] / IntelFrameworkPkg / Include / Framework / FrameworkInternalFormRepresentation.h

/** @file\r
  This file defines the encoding for the VFR (Visual Form Representation) language.\r
  Framework IFR is primarily consumed by the EFI presentation engine, and produced by EFI\r
  internal application and drivers as well as all add-in card option-ROM drivers\r
\r
  Copyright (c) 2007, Intel Corporation                                                         \r
  All rights reserved. This program and the accompanying materials                          \r
  are licensed and made available under the terms and conditions of the BSD License         \r
  which accompanies this distribution.  The full text of the license may be found at        \r
  http://opensource.org/licenses/bsd-license.php                                            \r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
\r
  @par Revision Reference:\r
  These definitions are from Framework Specification HII 0.92.\r
\r
**/\r
\r
#ifndef __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__\r
#define __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__\r
\r
//\r
// IFR Op codes\r
//\r
#define FRAMEWORK_EFI_IFR_FORM_OP                 0x01\r
#define FRAMEWORK_EFI_IFR_SUBTITLE_OP             0x02\r
#define FRAMEWORK_EFI_IFR_TEXT_OP                 0x03\r
#define FRAMEWORK_EFI_IFR_GRAPHIC_OP              0x04\r
#define FRAMEWORK_EFI_IFR_ONE_OF_OP               0x05\r
#define FRAMEWORK_EFI_IFR_CHECKBOX_OP             0x06\r
#define FRAMEWORK_EFI_IFR_NUMERIC_OP              0x07\r
#define FRAMEWORK_EFI_IFR_PASSWORD_OP             0x08\r
#define FRAMEWORK_EFI_IFR_ONE_OF_OPTION_OP        0x09  // ONEOF OPTION field\r
#define FRAMEWORK_EFI_IFR_SUPPRESS_IF_OP          0x0A\r
#define FRAMEWORK_EFI_IFR_END_FORM_OP             0x0B\r
#define FRAMEWORK_EFI_IFR_HIDDEN_OP               0x0C\r
#define FRAMEWORK_EFI_IFR_END_FORM_SET_OP         0x0D\r
#define FRAMEWORK_EFI_IFR_FORM_SET_OP             0x0E\r
#define FRAMEWORK_EFI_IFR_REF_OP                  0x0F\r
#define FRAMEWORK_EFI_IFR_END_ONE_OF_OP           0x10\r
#define FRAMEWORK_EFI_IFR_END_OP                  FRAMEWORK_EFI_IFR_END_ONE_OF_OP\r
#define FRAMEWORK_EFI_IFR_INCONSISTENT_IF_OP      0x11\r
#define FRAMEWORK_EFI_IFR_EQ_ID_VAL_OP            0x12\r
#define FRAMEWORK_EFI_IFR_EQ_ID_ID_OP             0x13\r
#define FRAMEWORK_EFI_IFR_EQ_ID_LIST_OP           0x14\r
#define FRAMEWORK_EFI_IFR_AND_OP                  0x15\r
#define FRAMEWORK_EFI_IFR_OR_OP                   0x16\r
#define FRAMEWORK_EFI_IFR_NOT_OP                  0x17\r
#define FRAMEWORK_EFI_IFR_END_IF_OP               0x18  // for endif of inconsistentif, suppressif, grayoutif\r
#define FRAMEWORK_EFI_IFR_GRAYOUT_IF_OP           0x19\r
#define FRAMEWORK_EFI_IFR_DATE_OP                 0x1A\r
#define FRAMEWORK_EFI_IFR_TIME_OP                 0x1B\r
#define FRAMEWORK_EFI_IFR_STRING_OP               0x1C\r
#define FRAMEWORK_EFI_IFR_LABEL_OP                0x1D\r
#define FRAMEWORK_EFI_IFR_SAVE_DEFAULTS_OP        0x1E\r
#define FRAMEWORK_EFI_IFR_RESTORE_DEFAULTS_OP     0x1F\r
#define FRAMEWORK_EFI_IFR_BANNER_OP               0x20\r
#define FRAMEWORK_EFI_IFR_INVENTORY_OP            0x21\r
#define FRAMEWORK_EFI_IFR_EQ_VAR_VAL_OP           0x22\r
#define FRAMEWORK_EFI_IFR_ORDERED_LIST_OP         0x23\r
#define FRAMEWORK_EFI_IFR_VARSTORE_OP             0x24\r
#define FRAMEWORK_EFI_IFR_VARSTORE_SELECT_OP      0x25\r
#define FRAMEWORK_EFI_IFR_VARSTORE_SELECT_PAIR_OP 0x26\r
#define FRAMEWORK_EFI_IFR_TRUE_OP                 0x27\r
#define FRAMEWORK_EFI_IFR_FALSE_OP                0x28\r
#define FRAMEWORK_EFI_IFR_GT_OP                   0x29\r
#define FRAMEWORK_EFI_IFR_GE_OP                   0x2A\r
#define FRAMEWORK_EFI_IFR_OEM_DEFINED_OP          0x2B\r
#define FRAMEWORK_EFI_IFR_LAST_OPCODE             FRAMEWORK_EFI_IFR_OEM_DEFINED_OP\r
#define FRAMEWORK_EFI_IFR_OEM_OP                  0xFE\r
#define FRAMEWORK_EFI_IFR_NV_ACCESS_COMMAND       0xFF\r
\r
//\r
// Define values for the flags fields in some VFR opcodes. These are\r
// bitmasks.\r
//\r
#define FRAMEWORK_EFI_IFR_FLAG_DEFAULT              0x01\r
#define FRAMEWORK_EFI_IFR_FLAG_MANUFACTURING        0x02\r
#define FRAMEWORK_EFI_IFR_FLAG_INTERACTIVE          0x04\r
#define FRAMEWORK_EFI_IFR_FLAG_NV_ACCESS            0x08\r
#define FRAMEWORK_EFI_IFR_FLAG_RESET_REQUIRED       0x10\r
#define FRAMEWORK_EFI_IFR_FLAG_LATE_CHECK           0x20\r
\r
#define EFI_NON_DEVICE_CLASS              0x00  // Useful when you do not want something in the Device Manager\r
#define EFI_DISK_DEVICE_CLASS             0x01\r
#define EFI_VIDEO_DEVICE_CLASS            0x02\r
#define EFI_NETWORK_DEVICE_CLASS          0x04\r
#define EFI_INPUT_DEVICE_CLASS            0x08\r
#define EFI_ON_BOARD_DEVICE_CLASS         0x10\r
#define EFI_OTHER_DEVICE_CLASS            0x20\r
\r
#define EFI_SETUP_APPLICATION_SUBCLASS    0x00\r
#define EFI_GENERAL_APPLICATION_SUBCLASS  0x01\r
#define EFI_FRONT_PAGE_SUBCLASS           0x02\r
#define EFI_SINGLE_USE_SUBCLASS           0x03  // Used to display a single entity and then exit\r
\r
//\r
// Used to flag dynamically created op-codes. This is meaningful to the IFR Library set\r
// and the browser since we need to distinguish between compiled NV map data and created data.\r
// We do not allow new entries to be created in the NV map dynamically however we still need\r
// to display this information correctly.  To dynamically create op-codes and assume that their\r
// data will be saved, ensure that the NV starting location they refer to is pre-defined in the\r
// NV map.\r
//\r
#define FRAMEWORK_EFI_IFR_FLAG_CREATED  128\r
\r
\r
#pragma pack(1)\r
//\r
// IFR Structure definitions\r
//\r
typedef struct {\r
  UINT8 OpCode;\r
  UINT8 Length;\r
} FRAMEWORK_EFI_IFR_OP_HEADER;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER     Header;\r
  EFI_GUID              Guid;\r
  STRING_REF            FormSetTitle;\r
  STRING_REF            Help;\r
  EFI_PHYSICAL_ADDRESS  CallbackHandle;\r
  UINT16                Class;\r
  UINT16                SubClass;\r
  UINT16                NvDataSize; // set once, size of the NV data as defined in the script\r
} FRAMEWORK_EFI_IFR_FORM_SET;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            FormId;\r
  STRING_REF        FormTitle;\r
} FRAMEWORK_EFI_IFR_FORM;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            LabelId;\r
} FRAMEWORK_EFI_IFR_LABEL;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  STRING_REF        SubTitle;\r
} FRAMEWORK_EFI_IFR_SUBTITLE;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  STRING_REF        Help;\r
  STRING_REF        Text;\r
  STRING_REF        TextTwo;\r
  UINT8             Flags;          // This is included solely for purposes of interactive/dynamic support.\r
  UINT16            Key;            // Value to be passed to caller to identify this particular op-code\r
} FRAMEWORK_EFI_IFR_TEXT;\r
\r
//\r
// goto\r
//\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            FormId;\r
  STRING_REF        Prompt;\r
  STRING_REF        Help;   // The string Token for the context-help\r
  UINT8             Flags;  // This is included solely for purposes of interactive/dynamic support.\r
  UINT16            Key;    // Value to be passed to caller to identify this particular op-code\r
} FRAMEWORK_EFI_IFR_REF;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_END_FORM;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_END_FORM_SET;\r
\r
//\r
// Also notice that the IFR_ONE_OF and IFR_CHECK_BOX are identical in structure......code assumes this to be true, if this ever\r
// changes we need to revisit the InitializeTagStructures code\r
//\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
  UINT8             Width;      // The Size of the Data being saved\r
  STRING_REF        Prompt;     // The String Token for the Prompt\r
  STRING_REF        Help;       // The string Token for the context-help\r
} FRAMEWORK_EFI_IFR_ONE_OF;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId; // The offset in NV for storage of the data\r
  UINT8             MaxEntries; // The maximum number of options in the ordered list (=size of NVStore)\r
  STRING_REF        Prompt;     // The string token for the prompt\r
  STRING_REF        Help;       // The string token for the context-help\r
} FRAMEWORK_EFI_IFR_ORDERED_LIST;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
  UINT8             Width;      // The Size of the Data being saved\r
  STRING_REF        Prompt;     // The String Token for the Prompt\r
  STRING_REF        Help;       // The string Token for the context-help\r
  UINT8             Flags;      // For now, if non-zero, means that it is the default option, - further definition likely\r
  UINT16            Key;        // Value to be passed to caller to identify this particular op-code\r
} FRAMEWORK_EFI_IFR_CHECKBOX, FRAMEWORK_EFI_IFR_CHECK_BOX;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  STRING_REF        Option;     // The string token describing the option\r
  UINT16            Value;      // The value associated with this option that is stored in the NVRAM if chosen\r
  UINT8             Flags;      // For now, if non-zero, means that it is the default option, - further definition likely above\r
  UINT16            Key;        // Value to be passed to caller to identify this particular op-code\r
} FRAMEWORK_EFI_IFR_ONE_OF_OPTION;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
  UINT8             Width;      // The Size of the Data being saved\r
  STRING_REF        Prompt;     // The String Token for the Prompt\r
  STRING_REF        Help;       // The string Token for the context-help\r
  UINT8             Flags;      // This is included solely for purposes of interactive/dynamic support.\r
  UINT16            Key;        // Value to be passed to caller to identify this particular op-code\r
  UINT16            Minimum;\r
  UINT16            Maximum;\r
  UINT16            Step;       // If step is 0, then manual input is specified, otherwise, left/right arrow selection is called for\r
  UINT16            Default;\r
} FRAMEWORK_EFI_IFR_NUMERIC;\r
\r
//\r
// There is an interesting twist with regards to Time and Date.  This is one of the few items which can accept input from\r
// a user, however may or may not need to use storage in the NVRAM space.  The decided method for determining if NVRAM space\r
// will be used (only for a TimeOp or DateOp) is:  If .QuestionId == 0 && .Width == 0 (normally an impossibility) then use system\r
// resources to store the data away and not NV resources.  In other words, the setup engine will call gRT->SetTime, and gRT->SetDate\r
// for the saving of data, and the values displayed will be from the gRT->GetXXXX series of calls.\r
//\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_NUMERIC Hour;\r
  FRAMEWORK_EFI_IFR_NUMERIC Minute;\r
  FRAMEWORK_EFI_IFR_NUMERIC Second;\r
} FRAMEWORK_EFI_IFR_TIME;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_NUMERIC Year;\r
  FRAMEWORK_EFI_IFR_NUMERIC Month;\r
  FRAMEWORK_EFI_IFR_NUMERIC Day;\r
} FRAMEWORK_EFI_IFR_DATE;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId;   // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
  UINT8             Width;        // The Size of the Data being saved  @bug -- remove someday\r
  STRING_REF        Prompt;       // The String Token for the Prompt\r
  STRING_REF        Help;         // The string Token for the context-help\r
  UINT8             Flags;        // This is included solely for purposes of interactive/dynamic support.\r
  UINT16            Key;          // Value to be passed to caller to identify this particular op-code\r
  UINT8             MinSize;      // Minimum allowable sized password\r
  UINT8             MaxSize;      // Maximum allowable sized password\r
  UINT16            Encoding;\r
} FRAMEWORK_EFI_IFR_PASSWORD;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId;   // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
  UINT8             Width;        // The Size of the Data being saved  @bug -- remove someday\r
  STRING_REF        Prompt;       // The String Token for the Prompt\r
  STRING_REF        Help;         // The string Token for the context-help\r
  UINT8             Flags;        // This is included solely for purposes of interactive/dynamic support.\r
  UINT16            Key;          // Value to be passed to caller to identify this particular op-code\r
  UINT8             MinSize;      // Minimum allowable sized password\r
  UINT8             MaxSize;      // Maximum allowable sized password\r
} FRAMEWORK_EFI_IFR_STRING;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_END_ONE_OF;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            Value;\r
  UINT16            Key;\r
} FRAMEWORK_EFI_IFR_HIDDEN;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT8             Flags;\r
} FRAMEWORK_EFI_IFR_SUPPRESS;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT8             Flags;\r
} FRAMEWORK_EFI_IFR_GRAY_OUT;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  STRING_REF        Popup;\r
  UINT8             Flags;\r
} FRAMEWORK_EFI_IFR_INCONSISTENT;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId;   // offset into variable storage\r
  UINT8             Width;        // size of variable storage\r
  UINT16            Value;        // value to compare against\r
} FRAMEWORK_EFI_IFR_EQ_ID_VAL;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId;   // offset into variable storage\r
  UINT8             Width;        // size of variable storage\r
  UINT16            ListLength;\r
  UINT16            ValueList[1];\r
} FRAMEWORK_EFI_IFR_EQ_ID_LIST;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            QuestionId1;  // offset into variable storage for first value to compare\r
  UINT8             Width;        // size of variable storage (must be same for both)\r
  UINT16            QuestionId2;  // offset into variable storage for second value to compare\r
} FRAMEWORK_EFI_IFR_EQ_ID_ID;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            VariableId;   // offset into variable storage\r
  UINT16            Value;        // value to compare against\r
} FRAMEWORK_EFI_IFR_EQ_VAR_VAL;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_AND;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_OR;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_NOT;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_END_EXPR, FRAMEWORK_EFI_IFR_END_IF;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            FormId;\r
  STRING_REF        Prompt;\r
  STRING_REF        Help;\r
  UINT8             Flags;\r
  UINT16            Key;\r
} FRAMEWORK_EFI_IFR_SAVE_DEFAULTS;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  STRING_REF        Help;\r
  STRING_REF        Text;\r
  STRING_REF        TextTwo;      // optional text\r
} FRAMEWORK_EFI_IFR_INVENTORY;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  EFI_GUID          Guid;         // GUID for the variable\r
  UINT16            VarId;        // variable store ID, as referenced elsewhere in the form\r
  UINT16            Size;         // size of the variable storage\r
} FRAMEWORK_EFI_IFR_VARSTORE;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            VarId;        // variable store ID, as referenced elsewhere in the form\r
} FRAMEWORK_EFI_IFR_VARSTORE_SELECT;\r
\r
//\r
// Used for the ideqid VFR statement where two variable stores may be referenced in the\r
// same VFR statement.\r
// A browser should treat this as an FRAMEWORK_EFI_IFR_VARSTORE_SELECT statement and assume that all following\r
// IFR opcodes use the VarId as defined here.\r
//\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  UINT16            VarId;          // variable store ID, as referenced elsewhere in the form\r
  UINT16            SecondaryVarId; // variable store ID, as referenced elsewhere in the form\r
} FRAMEWORK_EFI_IFR_VARSTORE_SELECT_PAIR;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_TRUE;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_FALSE;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_GT;\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
} FRAMEWORK_EFI_IFR_GE;\r
\r
//\r
// Save defaults and restore defaults have same structure\r
//\r
#define FRAMEWORK_EFI_IFR_RESTORE_DEFAULTS  FRAMEWORK_EFI_IFR_SAVE_DEFAULTS\r
\r
typedef struct {\r
  FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
  STRING_REF        Title;        // The string token for the banner title\r
  UINT16            LineNumber;   // 1-based line number\r
  UINT8             Alignment;    // left, center, or right-aligned\r
} FRAMEWORK_EFI_IFR_BANNER;\r
\r
#define FRAMEWORK_EFI_IFR_BANNER_ALIGN_LEFT   0\r
#define FRAMEWORK_EFI_IFR_BANNER_ALIGN_CENTER 1\r
#define FRAMEWORK_EFI_IFR_BANNER_ALIGN_RIGHT  2\r
#define FRAMEWORK_EFI_IFR_BANNER_TIMEOUT      0xFF\r
\r
#pragma pack()\r
\r
#endif\r
Commit	Line	Data
61789197	1	/** @file\r
	2	This file defines the encoding for the VFR (Visual Form Representation) language.\r
	3	Framework IFR is primarily consumed by the EFI presentation engine, and produced by EFI\r
	4	internal application and drivers as well as all add-in card option-ROM drivers\r
	5	\r
	6	Copyright (c) 2007, Intel Corporation \r
	7	All rights reserved. This program and the accompanying materials \r
	8	are licensed and made available under the terms and conditions of the BSD License \r
	9	which accompanies this distribution. The full text of the license may be found at \r
	10	http://opensource.org/licenses/bsd-license.php \r
	11	\r
	12	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	13	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	14	\r
	15	@par Revision Reference:\r
	16	These definitions are from Framework Specification HII 0.92.\r
	17	\r
	18	**/\r
	19	\r
	20	#ifndef __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__\r
	21	#define __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__\r
	22	\r
61789197	23	//\r
	24	// IFR Op codes\r
	25	//\r
	26	#define FRAMEWORK_EFI_IFR_FORM_OP 0x01\r
	27	#define FRAMEWORK_EFI_IFR_SUBTITLE_OP 0x02\r
	28	#define FRAMEWORK_EFI_IFR_TEXT_OP 0x03\r
	29	#define FRAMEWORK_EFI_IFR_GRAPHIC_OP 0x04\r
	30	#define FRAMEWORK_EFI_IFR_ONE_OF_OP 0x05\r
	31	#define FRAMEWORK_EFI_IFR_CHECKBOX_OP 0x06\r
	32	#define FRAMEWORK_EFI_IFR_NUMERIC_OP 0x07\r
	33	#define FRAMEWORK_EFI_IFR_PASSWORD_OP 0x08\r
	34	#define FRAMEWORK_EFI_IFR_ONE_OF_OPTION_OP 0x09 // ONEOF OPTION field\r
	35	#define FRAMEWORK_EFI_IFR_SUPPRESS_IF_OP 0x0A\r
	36	#define FRAMEWORK_EFI_IFR_END_FORM_OP 0x0B\r
	37	#define FRAMEWORK_EFI_IFR_HIDDEN_OP 0x0C\r
	38	#define FRAMEWORK_EFI_IFR_END_FORM_SET_OP 0x0D\r
	39	#define FRAMEWORK_EFI_IFR_FORM_SET_OP 0x0E\r
	40	#define FRAMEWORK_EFI_IFR_REF_OP 0x0F\r
	41	#define FRAMEWORK_EFI_IFR_END_ONE_OF_OP 0x10\r
	42	#define FRAMEWORK_EFI_IFR_END_OP FRAMEWORK_EFI_IFR_END_ONE_OF_OP\r
	43	#define FRAMEWORK_EFI_IFR_INCONSISTENT_IF_OP 0x11\r
	44	#define FRAMEWORK_EFI_IFR_EQ_ID_VAL_OP 0x12\r
	45	#define FRAMEWORK_EFI_IFR_EQ_ID_ID_OP 0x13\r
	46	#define FRAMEWORK_EFI_IFR_EQ_ID_LIST_OP 0x14\r
	47	#define FRAMEWORK_EFI_IFR_AND_OP 0x15\r
	48	#define FRAMEWORK_EFI_IFR_OR_OP 0x16\r
	49	#define FRAMEWORK_EFI_IFR_NOT_OP 0x17\r
	50	#define FRAMEWORK_EFI_IFR_END_IF_OP 0x18 // for endif of inconsistentif, suppressif, grayoutif\r
	51	#define FRAMEWORK_EFI_IFR_GRAYOUT_IF_OP 0x19\r
	52	#define FRAMEWORK_EFI_IFR_DATE_OP 0x1A\r
	53	#define FRAMEWORK_EFI_IFR_TIME_OP 0x1B\r
	54	#define FRAMEWORK_EFI_IFR_STRING_OP 0x1C\r
	55	#define FRAMEWORK_EFI_IFR_LABEL_OP 0x1D\r
	56	#define FRAMEWORK_EFI_IFR_SAVE_DEFAULTS_OP 0x1E\r
	57	#define FRAMEWORK_EFI_IFR_RESTORE_DEFAULTS_OP 0x1F\r
	58	#define FRAMEWORK_EFI_IFR_BANNER_OP 0x20\r
	59	#define FRAMEWORK_EFI_IFR_INVENTORY_OP 0x21\r
	60	#define FRAMEWORK_EFI_IFR_EQ_VAR_VAL_OP 0x22\r
	61	#define FRAMEWORK_EFI_IFR_ORDERED_LIST_OP 0x23\r
	62	#define FRAMEWORK_EFI_IFR_VARSTORE_OP 0x24\r
	63	#define FRAMEWORK_EFI_IFR_VARSTORE_SELECT_OP 0x25\r
	64	#define FRAMEWORK_EFI_IFR_VARSTORE_SELECT_PAIR_OP 0x26\r
	65	#define FRAMEWORK_EFI_IFR_TRUE_OP 0x27\r
	66	#define FRAMEWORK_EFI_IFR_FALSE_OP 0x28\r
	67	#define FRAMEWORK_EFI_IFR_GT_OP 0x29\r
	68	#define FRAMEWORK_EFI_IFR_GE_OP 0x2A\r
	69	#define FRAMEWORK_EFI_IFR_OEM_DEFINED_OP 0x2B\r
	70	#define FRAMEWORK_EFI_IFR_LAST_OPCODE FRAMEWORK_EFI_IFR_OEM_DEFINED_OP\r
	71	#define FRAMEWORK_EFI_IFR_OEM_OP 0xFE\r
	72	#define FRAMEWORK_EFI_IFR_NV_ACCESS_COMMAND 0xFF\r
	73	\r
	74	//\r
	75	// Define values for the flags fields in some VFR opcodes. These are\r
	76	// bitmasks.\r
	77	//\r
	78	#define FRAMEWORK_EFI_IFR_FLAG_DEFAULT 0x01\r
	79	#define FRAMEWORK_EFI_IFR_FLAG_MANUFACTURING 0x02\r
	80	#define FRAMEWORK_EFI_IFR_FLAG_INTERACTIVE 0x04\r
	81	#define FRAMEWORK_EFI_IFR_FLAG_NV_ACCESS 0x08\r
	82	#define FRAMEWORK_EFI_IFR_FLAG_RESET_REQUIRED 0x10\r
	83	#define FRAMEWORK_EFI_IFR_FLAG_LATE_CHECK 0x20\r
	84	\r
	85	#define EFI_NON_DEVICE_CLASS 0x00 // Useful when you do not want something in the Device Manager\r
	86	#define EFI_DISK_DEVICE_CLASS 0x01\r
87	#define EFI_VIDEO_DEVICE_CLASS 0x02\r
88	#define EFI_NETWORK_DEVICE_CLASS 0x04\r
89	#define EFI_INPUT_DEVICE_CLASS 0x08\r
90	#define EFI_ON_BOARD_DEVICE_CLASS 0x10\r
91	#define EFI_OTHER_DEVICE_CLASS 0x20\r
92	\r
93	#define EFI_SETUP_APPLICATION_SUBCLASS 0x00\r
94	#define EFI_GENERAL_APPLICATION_SUBCLASS 0x01\r
95	#define EFI_FRONT_PAGE_SUBCLASS 0x02\r
96	#define EFI_SINGLE_USE_SUBCLASS 0x03 // Used to display a single entity and then exit\r
97	\r
98	//\r
99	// Used to flag dynamically created op-codes. This is meaningful to the IFR Library set\r
100	// and the browser since we need to distinguish between compiled NV map data and created data.\r
101	// We do not allow new entries to be created in the NV map dynamically however we still need\r
102	// to display this information correctly. To dynamically create op-codes and assume that their\r
103	// data will be saved, ensure that the NV starting location they refer to is pre-defined in the\r
104	// NV map.\r
105	//\r
106	#define FRAMEWORK_EFI_IFR_FLAG_CREATED 128\r
107	\r
108	\r
109	#pragma pack(1)\r
110	//\r
111	// IFR Structure definitions\r
112	//\r
113	typedef struct {\r
114	UINT8 OpCode;\r
115	UINT8 Length;\r
116	} FRAMEWORK_EFI_IFR_OP_HEADER;\r
117	\r
118	typedef struct {\r
119	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
120	EFI_GUID Guid;\r
121	STRING_REF FormSetTitle;\r
122	STRING_REF Help;\r
123	EFI_PHYSICAL_ADDRESS CallbackHandle;\r
124	UINT16 Class;\r
125	UINT16 SubClass;\r
126	UINT16 NvDataSize; // set once, size of the NV data as defined in the script\r
127	} FRAMEWORK_EFI_IFR_FORM_SET;\r
128	\r
129	typedef struct {\r
130	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
131	UINT16 FormId;\r
132	STRING_REF FormTitle;\r
133	} FRAMEWORK_EFI_IFR_FORM;\r
134	\r
135	typedef struct {\r
136	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
137	UINT16 LabelId;\r
138	} FRAMEWORK_EFI_IFR_LABEL;\r
139	\r
140	typedef struct {\r
141	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
142	STRING_REF SubTitle;\r
143	} FRAMEWORK_EFI_IFR_SUBTITLE;\r
144	\r
145	typedef struct {\r
146	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
147	STRING_REF Help;\r
148	STRING_REF Text;\r
149	STRING_REF TextTwo;\r
150	UINT8 Flags; // This is included solely for purposes of interactive/dynamic support.\r
151	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
152	} FRAMEWORK_EFI_IFR_TEXT;\r
153	\r
154	//\r
155	// goto\r
156	//\r
157	typedef struct {\r
158	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
159	UINT16 FormId;\r
160	STRING_REF Prompt;\r
161	STRING_REF Help; // The string Token for the context-help\r
162	UINT8 Flags; // This is included solely for purposes of interactive/dynamic support.\r
163	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
164	} FRAMEWORK_EFI_IFR_REF;\r
165	\r
166	typedef struct {\r
167	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
168	} FRAMEWORK_EFI_IFR_END_FORM;\r
169	\r
170	typedef struct {\r
171	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
172	} FRAMEWORK_EFI_IFR_END_FORM_SET;\r
173	\r
174	//\r
175	// Also notice that the IFR_ONE_OF and IFR_CHECK_BOX are identical in structure......code assumes this to be true, if this ever\r
176	// changes we need to revisit the InitializeTagStructures code\r
177	//\r
178	typedef struct {\r
179	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
180	UINT16 QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
181	UINT8 Width; // The Size of the Data being saved\r
182	STRING_REF Prompt; // The String Token for the Prompt\r
183	STRING_REF Help; // The string Token for the context-help\r
184	} FRAMEWORK_EFI_IFR_ONE_OF;\r
185	\r
186	typedef struct {\r
187	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
188	UINT16 QuestionId; // The offset in NV for storage of the data\r
189	UINT8 MaxEntries; // The maximum number of options in the ordered list (=size of NVStore)\r
190	STRING_REF Prompt; // The string token for the prompt\r
191	STRING_REF Help; // The string token for the context-help\r
192	} FRAMEWORK_EFI_IFR_ORDERED_LIST;\r
193	\r
194	typedef struct {\r
195	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
196	UINT16 QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
197	UINT8 Width; // The Size of the Data being saved\r
198	STRING_REF Prompt; // The String Token for the Prompt\r
199	STRING_REF Help; // The string Token for the context-help\r
200	UINT8 Flags; // For now, if non-zero, means that it is the default option, - further definition likely\r
201	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
202	} FRAMEWORK_EFI_IFR_CHECKBOX, FRAMEWORK_EFI_IFR_CHECK_BOX;\r
203	\r
204	typedef struct {\r
205	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
206	STRING_REF Option; // The string token describing the option\r
207	UINT16 Value; // The value associated with this option that is stored in the NVRAM if chosen\r
208	UINT8 Flags; // For now, if non-zero, means that it is the default option, - further definition likely above\r
209	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
210	} FRAMEWORK_EFI_IFR_ONE_OF_OPTION;\r
211	\r
212	typedef struct {\r
213	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
214	UINT16 QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
215	UINT8 Width; // The Size of the Data being saved\r
216	STRING_REF Prompt; // The String Token for the Prompt\r
217	STRING_REF Help; // The string Token for the context-help\r
218	UINT8 Flags; // This is included solely for purposes of interactive/dynamic support.\r
219	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
220	UINT16 Minimum;\r
221	UINT16 Maximum;\r
222	UINT16 Step; // If step is 0, then manual input is specified, otherwise, left/right arrow selection is called for\r
223	UINT16 Default;\r
224	} FRAMEWORK_EFI_IFR_NUMERIC;\r
225	\r
226	//\r
227	// There is an interesting twist with regards to Time and Date. This is one of the few items which can accept input from\r
228	// a user, however may or may not need to use storage in the NVRAM space. The decided method for determining if NVRAM space\r
229	// will be used (only for a TimeOp or DateOp) is: If .QuestionId == 0 && .Width == 0 (normally an impossibility) then use system\r
230	// resources to store the data away and not NV resources. In other words, the setup engine will call gRT->SetTime, and gRT->SetDate\r
231	// for the saving of data, and the values displayed will be from the gRT->GetXXXX series of calls.\r
232	//\r
233	typedef struct {\r
234	FRAMEWORK_EFI_IFR_NUMERIC Hour;\r
235	FRAMEWORK_EFI_IFR_NUMERIC Minute;\r
236	FRAMEWORK_EFI_IFR_NUMERIC Second;\r
237	} FRAMEWORK_EFI_IFR_TIME;\r
238	\r
239	typedef struct {\r
240	FRAMEWORK_EFI_IFR_NUMERIC Year;\r
241	FRAMEWORK_EFI_IFR_NUMERIC Month;\r
242	FRAMEWORK_EFI_IFR_NUMERIC Day;\r
243	} FRAMEWORK_EFI_IFR_DATE;\r
244	\r
245	typedef struct {\r
246	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
247	UINT16 QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
f7cf806e	248	UINT8 Width; // The Size of the Data being saved @bug -- remove someday\r
61789197	249	STRING_REF Prompt; // The String Token for the Prompt\r
	250	STRING_REF Help; // The string Token for the context-help\r
	251	UINT8 Flags; // This is included solely for purposes of interactive/dynamic support.\r
	252	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
	253	UINT8 MinSize; // Minimum allowable sized password\r
	254	UINT8 MaxSize; // Maximum allowable sized password\r
	255	UINT16 Encoding;\r
	256	} FRAMEWORK_EFI_IFR_PASSWORD;\r
	257	\r
	258	typedef struct {\r
	259	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	260	UINT16 QuestionId; // The ID designating what the question is about...sucked in from a #define, likely in the form of a variable name\r
f7cf806e	261	UINT8 Width; // The Size of the Data being saved @bug -- remove someday\r
61789197	262	STRING_REF Prompt; // The String Token for the Prompt\r
	263	STRING_REF Help; // The string Token for the context-help\r
	264	UINT8 Flags; // This is included solely for purposes of interactive/dynamic support.\r
	265	UINT16 Key; // Value to be passed to caller to identify this particular op-code\r
	266	UINT8 MinSize; // Minimum allowable sized password\r
	267	UINT8 MaxSize; // Maximum allowable sized password\r
	268	} FRAMEWORK_EFI_IFR_STRING;\r
	269	\r
	270	typedef struct {\r
	271	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	272	} FRAMEWORK_EFI_IFR_END_ONE_OF;\r
	273	\r
	274	typedef struct {\r
	275	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	276	UINT16 Value;\r
	277	UINT16 Key;\r
	278	} FRAMEWORK_EFI_IFR_HIDDEN;\r
	279	\r
	280	typedef struct {\r
	281	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	282	UINT8 Flags;\r
	283	} FRAMEWORK_EFI_IFR_SUPPRESS;\r
	284	\r
	285	typedef struct {\r
	286	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	287	UINT8 Flags;\r
	288	} FRAMEWORK_EFI_IFR_GRAY_OUT;\r
	289	\r
	290	typedef struct {\r
	291	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	292	STRING_REF Popup;\r
	293	UINT8 Flags;\r
	294	} FRAMEWORK_EFI_IFR_INCONSISTENT;\r
	295	\r
	296	typedef struct {\r
	297	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	298	UINT16 QuestionId; // offset into variable storage\r
	299	UINT8 Width; // size of variable storage\r
	300	UINT16 Value; // value to compare against\r
	301	} FRAMEWORK_EFI_IFR_EQ_ID_VAL;\r
	302	\r
	303	typedef struct {\r
	304	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	305	UINT16 QuestionId; // offset into variable storage\r
	306	UINT8 Width; // size of variable storage\r
	307	UINT16 ListLength;\r
	308	UINT16 ValueList[1];\r
	309	} FRAMEWORK_EFI_IFR_EQ_ID_LIST;\r
	310	\r
	311	typedef struct {\r
	312	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	313	UINT16 QuestionId1; // offset into variable storage for first value to compare\r
	314	UINT8 Width; // size of variable storage (must be same for both)\r
	315	UINT16 QuestionId2; // offset into variable storage for second value to compare\r
	316	} FRAMEWORK_EFI_IFR_EQ_ID_ID;\r
	317	\r
	318	typedef struct {\r
	319	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
	320	UINT16 VariableId; // offset into variable storage\r
	321	UINT16 Value; // value to compare against\r
	322	} FRAMEWORK_EFI_IFR_EQ_VAR_VAL;\r
	323	\r
	324	typedef struct {\r
	325	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
326	} FRAMEWORK_EFI_IFR_AND;\r
327	\r
328	typedef struct {\r
329	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
330	} FRAMEWORK_EFI_IFR_OR;\r
331	\r
332	typedef struct {\r
333	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
334	} FRAMEWORK_EFI_IFR_NOT;\r
335	\r
336	typedef struct {\r
337	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
338	} FRAMEWORK_EFI_IFR_END_EXPR, FRAMEWORK_EFI_IFR_END_IF;\r
339	\r
340	typedef struct {\r
341	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
342	UINT16 FormId;\r
343	STRING_REF Prompt;\r
344	STRING_REF Help;\r
345	UINT8 Flags;\r
346	UINT16 Key;\r
347	} FRAMEWORK_EFI_IFR_SAVE_DEFAULTS;\r
348	\r
349	typedef struct {\r
350	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
351	STRING_REF Help;\r
352	STRING_REF Text;\r
353	STRING_REF TextTwo; // optional text\r
354	} FRAMEWORK_EFI_IFR_INVENTORY;\r
355	\r
356	typedef struct {\r
357	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
358	EFI_GUID Guid; // GUID for the variable\r
359	UINT16 VarId; // variable store ID, as referenced elsewhere in the form\r
360	UINT16 Size; // size of the variable storage\r
361	} FRAMEWORK_EFI_IFR_VARSTORE;\r
362	\r
363	typedef struct {\r
364	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
365	UINT16 VarId; // variable store ID, as referenced elsewhere in the form\r
366	} FRAMEWORK_EFI_IFR_VARSTORE_SELECT;\r
367	\r
368	//\r
369	// Used for the ideqid VFR statement where two variable stores may be referenced in the\r
370	// same VFR statement.\r
371	// A browser should treat this as an FRAMEWORK_EFI_IFR_VARSTORE_SELECT statement and assume that all following\r
372	// IFR opcodes use the VarId as defined here.\r
373	//\r
374	typedef struct {\r
375	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
376	UINT16 VarId; // variable store ID, as referenced elsewhere in the form\r
377	UINT16 SecondaryVarId; // variable store ID, as referenced elsewhere in the form\r
378	} FRAMEWORK_EFI_IFR_VARSTORE_SELECT_PAIR;\r
379	\r
380	typedef struct {\r
381	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
382	} FRAMEWORK_EFI_IFR_TRUE;\r
383	\r
384	typedef struct {\r
385	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
386	} FRAMEWORK_EFI_IFR_FALSE;\r
387	\r
388	typedef struct {\r
389	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
390	} FRAMEWORK_EFI_IFR_GT;\r
391	\r
392	typedef struct {\r
393	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
394	} FRAMEWORK_EFI_IFR_GE;\r
395	\r
396	//\r
397	// Save defaults and restore defaults have same structure\r
398	//\r
399	#define FRAMEWORK_EFI_IFR_RESTORE_DEFAULTS FRAMEWORK_EFI_IFR_SAVE_DEFAULTS\r
400	\r
401	typedef struct {\r
402	FRAMEWORK_EFI_IFR_OP_HEADER Header;\r
403	STRING_REF Title; // The string token for the banner title\r
404	UINT16 LineNumber; // 1-based line number\r
405	UINT8 Alignment; // left, center, or right-aligned\r
406	} FRAMEWORK_EFI_IFR_BANNER;\r
407	\r
408	#define FRAMEWORK_EFI_IFR_BANNER_ALIGN_LEFT 0\r
409	#define FRAMEWORK_EFI_IFR_BANNER_ALIGN_CENTER 1\r
410	#define FRAMEWORK_EFI_IFR_BANNER_ALIGN_RIGHT 2\r
411	#define FRAMEWORK_EFI_IFR_BANNER_TIMEOUT 0xFF\r
412	\r
413	#pragma pack()\r
414	\r
415	#endif\r