/** @file\r
EDK II specific HII relative definition.\r
\r
- Copyright (c) 2006 - 2007, Intel Corporation. All rights reserved.<BR>\r
+ Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>\r
\r
- This program and the accompanying materials are licensed and made available\r
- under the terms and conditions of the BSD License which accompanies this\r
- 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
- File Name: MdeModuleHii.h\r
+ SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#define WIDE_CHAR 0xFFF1\r
#define NON_BREAKING_CHAR 0xFFF2\r
\r
-#define GLYPH_WIDTH EFI_GLYPH_WIDTH\r
-#define GLYPH_HEIGHT EFI_GLYPH_HEIGHT\r
-\r
-//\r
-// State defined for password statemachine \r
-//\r
+///\r
+/// State defined for password statemachine .\r
+///\r
#define BROWSER_STATE_VALIDATE_PASSWORD 0\r
#define BROWSER_STATE_SET_PASSWORD 1\r
\r
-\r
-//\r
-// Tiano Implementation specific Device Path definition.\r
-//\r
-#pragma pack(1)\r
-typedef struct {\r
- VENDOR_DEVICE_PATH VendorDevicePath;\r
- UINT32 Reserved;\r
- UINT64 UniqueId;\r
-} HII_VENDOR_DEVICE_PATH_NODE;\r
-#pragma pack()\r
-\r
-typedef struct {\r
- HII_VENDOR_DEVICE_PATH_NODE Node;\r
- EFI_DEVICE_PATH_PROTOCOL End;\r
-} HII_VENDOR_DEVICE_PATH;\r
-\r
-\r
-//\r
-// GUIDed opcodes defined for Tiano\r
-//\r
+///\r
+/// GUIDed opcodes defined for EDKII implementation.\r
+///\r
#define EFI_IFR_TIANO_GUID \\r
{ 0xf0b1735, 0x87a0, 0x4193, {0xb2, 0x66, 0x53, 0x8c, 0x38, 0xaf, 0x48, 0xce} }\r
\r
#pragma pack(1)\r
\r
+///\r
+/// EDKII implementation extension opcodes, new extension can be added here later.\r
+///\r
#define EFI_IFR_EXTEND_OP_LABEL 0x0\r
#define EFI_IFR_EXTEND_OP_BANNER 0x1\r
#define EFI_IFR_EXTEND_OP_TIMEOUT 0x2\r
#define EFI_IFR_EXTEND_OP_CLASS 0x3\r
#define EFI_IFR_EXTEND_OP_SUBCLASS 0x4\r
\r
+///\r
+/// Label opcode.\r
+///\r
typedef struct _EFI_IFR_GUID_LABEL {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_TIANO_GUID.\r
+ ///\r
EFI_GUID Guid;\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_LABEL.\r
+ ///\r
UINT8 ExtendOpCode;\r
+ ///\r
+ /// Label Number.\r
+ ///\r
UINT16 Number;\r
} EFI_IFR_GUID_LABEL;\r
\r
#define EFI_IFR_BANNER_ALIGN_CENTER 1\r
#define EFI_IFR_BANNER_ALIGN_RIGHT 2\r
\r
+///\r
+/// Banner opcode.\r
+///\r
typedef struct _EFI_IFR_GUID_BANNER {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_TIANO_GUID.\r
+ ///\r
EFI_GUID Guid;\r
- UINT8 ExtendOpCode; // Extended opcode is EFI_IFR_EXTEND_OP_BANNER\r
- EFI_STRING_ID Title; // The string token for the banner title\r
- UINT16 LineNumber; // 1-based line number\r
- UINT8 Alignment; // left, center, or right-aligned\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_BANNER\r
+ ///\r
+ UINT8 ExtendOpCode;\r
+ EFI_STRING_ID Title; ///< The string token for the banner title.\r
+ UINT16 LineNumber; ///< 1-based line number.\r
+ UINT8 Alignment; ///< left, center, or right-aligned.\r
} EFI_IFR_GUID_BANNER;\r
\r
+///\r
+/// Timeout opcode.\r
+///\r
typedef struct _EFI_IFR_GUID_TIMEOUT {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_TIANO_GUID.\r
+ ///\r
EFI_GUID Guid;\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_TIMEOUT.\r
+ ///\r
UINT8 ExtendOpCode;\r
- UINT16 TimeOut;\r
+ UINT16 TimeOut; ///< TimeOut Value.\r
} EFI_IFR_GUID_TIMEOUT;\r
\r
#define EFI_NON_DEVICE_CLASS 0x00\r
#define EFI_ON_BOARD_DEVICE_CLASS 0x10\r
#define EFI_OTHER_DEVICE_CLASS 0x20\r
\r
+///\r
+/// Device Class opcode.\r
+///\r
typedef struct _EFI_IFR_GUID_CLASS {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_TIANO_GUID.\r
+ ///\r
EFI_GUID Guid;\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_CLASS.\r
+ ///\r
UINT8 ExtendOpCode;\r
- UINT16 Class;\r
+ UINT16 Class; ///< Device Class from the above.\r
} EFI_IFR_GUID_CLASS;\r
\r
#define EFI_SETUP_APPLICATION_SUBCLASS 0x00\r
#define EFI_FRONT_PAGE_SUBCLASS 0x02\r
#define EFI_SINGLE_USE_SUBCLASS 0x03\r
\r
+///\r
+/// SubClass opcode\r
+///\r
typedef struct _EFI_IFR_GUID_SUBCLASS {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_TIANO_GUID.\r
+ ///\r
EFI_GUID Guid;\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_SUBCLASS.\r
+ ///\r
UINT8 ExtendOpCode;\r
- UINT16 SubClass;\r
+ UINT16 SubClass; ///< Sub Class type from the above.\r
} EFI_IFR_GUID_SUBCLASS;\r
\r
-//\r
-// GUIDed opcodes defined for Tiano\r
-//\r
+///\r
+/// GUIDed opcodes support for framework vfr.\r
+///\r
#define EFI_IFR_FRAMEWORK_GUID \\r
{ 0x31ca5d1a, 0xd511, 0x4931, { 0xb7, 0x82, 0xae, 0x6b, 0x2b, 0x17, 0x8c, 0xd7 } }\r
\r
+///\r
+/// Two extended opcodes are added, and new extensions can be added here later.\r
+/// One is for framework OneOf question Option Key value;\r
+/// another is for framework vareqval.\r
+///\r
#define EFI_IFR_EXTEND_OP_OPTIONKEY 0x0\r
#define EFI_IFR_EXTEND_OP_VAREQNAME 0x1\r
-//\r
-// Store the framework vfr option key value\r
-//\r
+\r
+///\r
+/// Store the framework vfr option key value.\r
+///\r
typedef struct _EFI_IFR_GUID_OPTIONKEY {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_FRAMEWORK_GUID.\r
+ ///\r
EFI_GUID Guid;\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_OPTIONKEY.\r
+ ///\r
UINT8 ExtendOpCode;\r
+ ///\r
+ /// OneOf Questiond ID binded by OneOf Option.\r
+ ///\r
EFI_QUESTION_ID QuestionId;\r
+ ///\r
+ /// The OneOf Option Value.\r
+ ///\r
EFI_IFR_TYPE_VALUE OptionValue;\r
- EFI_QUESTION_ID KeyValue;\r
+ ///\r
+ /// The Framework OneOf Option Key Value.\r
+ ///\r
+ UINT16 KeyValue;\r
} EFI_IFR_GUID_OPTIONKEY;\r
\r
-//\r
-// Store the framework vfr vareqval name number\r
-//\r
+///\r
+/// Store the framework vfr vareqval name number.\r
+///\r
typedef struct _EFI_IFR_GUID_VAREQNAME {\r
EFI_IFR_OP_HEADER Header;\r
+ ///\r
+ /// EFI_IFR_FRAMEWORK_GUID.\r
+ ///\r
EFI_GUID Guid;\r
+ ///\r
+ /// EFI_IFR_EXTEND_OP_VAREQNAME.\r
+ ///\r
UINT8 ExtendOpCode;\r
+ ///\r
+ /// Question ID of the Numeric Opcode created.\r
+ ///\r
EFI_QUESTION_ID QuestionId;\r
- EFI_STRING_ID NameId;\r
+ ///\r
+ /// For vareqval (0x100), NameId is 0x100.\r
+ /// This value will convert to a Unicode String following this rule;\r
+ /// sprintf(StringBuffer, "%d", NameId) .\r
+ /// The Unicode String will be used as a EFI Variable Name.\r
+ ///\r
+ UINT16 NameId;\r
} EFI_IFR_GUID_VAREQNAME;\r
\r
+///\r
+/// EDKII implementation extension GUID, used to indicate there are bit fields in the varstore.\r
+///\r
+#define EDKII_IFR_BIT_VARSTORE_GUID \\r
+ { 0x82DDD68B, 0x9163, 0x4187, {0x9B, 0x27, 0x20, 0xA8, 0xFD, 0x60 ,0xA7, 0x1D}}\r
+\r
+///\r
+/// EDKII implementation extension flags, used to indicate the display style and bit width for bit filed storage.\r
+/// Two high bits for display style and the low six bits for bit width.\r
+///\r
+#define EDKII_IFR_DISPLAY_BIT 0xC0\r
+#define EDKII_IFR_DISPLAY_INT_DEC_BIT 0x00\r
+#define EDKII_IFR_DISPLAY_UINT_DEC_BIT 0x40\r
+#define EDKII_IFR_DISPLAY_UINT_HEX_BIT 0x80\r
+\r
+#define EDKII_IFR_NUMERIC_SIZE_BIT 0x3F\r
+\r
#pragma pack()\r
\r
+extern EFI_GUID gEfiIfrTianoGuid;\r
+extern EFI_GUID gEfiIfrFrameworkGuid;\r
+extern EFI_GUID gEdkiiIfrBitVarStoreGuid;\r
+\r
#endif\r
\r