EFI_IFR_DEFAULT opcode를 통해 모든 기본 값이 표시되는 것을 볼 수 있다.
EFI_IFR_DEFAULT
Summary:
Provides a default value for the current question
Prototype:
#define EFI_IFR_DEFAULT_OP 0x5b
typedef struct _EFI_IFR_DEFAULT {
EFI_IFR_OP_HEADER Header;
UINT16 DefaultId;
UINT8 Type;
EFI_IFR_TYPE_VALUE Value;
} EFI_IFR_DEFAULT;
typedef struct _EFI_IFR_DEFAULT_2 {
EFI_IFR_OP_HEADER Header;
UINT16 DefaultId;
UINT8 Type;
} EFI_IFR_DEFAULT_2;
Members:
Header The sequence that defines the type of opcode as well as the length of the opcode being defined.
For this tag, Header.OpCode = EFI_IFR_DEFAULT_OP.
DefaultId Identifies the default store for this value. The default store must have previously been created using EFI_IFR_DEFAULTSTORE.
Type The type of data in the Value field. See EFI_IFR_TYPE_x in EFI_IFR_ONE_OF_OPTION.
Value The default value. The actual size of this field depends on Type. If Type is EFI_IFR_TYPE_OTHER, then the default value
is provided by a nested EFI_IFR_VALUE.
Description:
This opcode specifies a default value for the current question. There are two forms. The first (EFI_IFR_DEFAULT) assumes that the default value is a constant, embedded directly in the Value member. The second (EFI_IFR_DEFAULT_2) assumes that the default value is specified using a nested EFI_IFR_VALUE opcode.
위 모든 구문은 값 필드가 포함된 구조체의 첫 번째 형식(EFI_IFR_DEFAULT)을 사용한다. 가능한 값 유형은 다음과 같다.
또한 위 모든 구문의 DefaultId 값이 0 인 것을 알 수 있따. 이제 그럼 기본 저장소가 무엇인지에 대해 알아보자.
기본 저장소
먼저 UEFI formset에서 여러 기본 저장소를 정의할 수 있다는 것을 이해해야 한다.
만약 HIIFormDataElements application의 Form.list 파일을 보게 된다면 formset이 이미 2개의 기본 저장소를 가진 것을 볼 수 있다.
Build/UefiLessonsPkg/RELEASE_GCC5/X64/UefiLessonsPkg/HIIFormDataElements/HIIFormDataElements/DEBUG/Form.lst
EFI_IFR_DEFAULTSTORE
Summary:
Provides a declaration for the type of default values that a question can be associated with.
Prototype:
#define EFI_IFR_DEFAULTSTORE_OP 0x5c
typedef struct _EFI_IFR_DEFAULTSTORE {
EFI_IFR_OP_HEADER Header;
EFI_STRING_ID DefaultName;
UINT16 DefaultId;
} EFI_IFR_DEFAULTSTORE;
Members:
Header The sequence that defines the type of opcode as well as the length of the opcode being defined.
For this tag, Header.OpCode = EFI_IFR_DEFAULTSTORE_OP
DefaultName A string token reference for the human readable string associated with the type of default being declared.
DefaultId The default identifier, which is unique within the current form set. The default identifier creates a group of defaults.
Description:
Declares a class of default which can then have question default values associated with. An EFI_IFR_DEFAULTSTORE with a specified DefaultId must appear in the IFR before it can be referenced by an EFI_IFR_DEFAULT.
코드에서 ID가 0x0000 및 0x0001 이면서이름이 없는 두 개의 기본 저장소를 정의한다.
일반적으로 UEFI 스은 기본 저장소 ID(UINT16)에 대해 가능한 모든 값을 4개의 클래스로 나눈다.
0x0000-0x3fff: UEFI Spec에 의해 예약되어짐
0x4000-0x7fff: 플랫폼 공급자 사용
0x8000-0xbfff: 하드웨어 공급업체 사용
0xc000-0xffff: 펌웨어 공급업체 사용
첫 번째 그룹에는 이미 정의된 3개의 클래스가 있다.
0x0000 - "standard defaults"(정상 작동을 위한 시스템/장치를 준비하는데 사용하는 기본 값)
0x0001 - "manufacturing defaults"(제조를 위해 시스템/장치를 준비하는데 사용하는 기본 값)
0x0002 - "safe defaults"("안전 모드" 또는 낮은 위험모드에서 시스템을 부팅하는데 사용되는 기본 값)
이를 통해 formset에 "standard defaults"과 "manufacturing defaults"이라는 기본 저장소가 있다는 것을 알 수 있다. 이들은 항상 VFR 컴파일러에 의해 모든 formset에 생성되어 진다.
EFI_IFR_RESET_BUTTON
Summary:
Create a reset or submit button on the current form.
Prototype:
#define EFI_IFR_RESET_BUTTON_OP 0x0d
typedef struct _EFI_IFR_RESET_BUTTON {
EFI_IFR_OP_HEADER Header;
EFI_IFR_STATEMENT_HEADER Statement;
EFI_DEFAULT_ID DefaultId;
} EFI_IFR_RESET_BUTTON;
typedef UINT16 EFI_DEFAULT_ID;
Members:
Header The standard header, where Header.OpCode = EFI_IFR_RESET_BUTTON_OP.
Statement Standard statement header, including the prompt and help text.
DefaultId Specifies the set of default store to use when restoring the defaults to the questions on this form.
Description:
This opcode creates a user-selectable button that resets the question values for all questions on the current form to the default values specified by DefaultId.
기본 값을 정의하는 다른 방법
oneof 는 모든 HII 메뉴에서 가장 공통적인 요소이며 flags 필드와 함께 옵션 대신 "standard storage" 과 "manufacturing storage" 값을 정의할 수 있다. 이를 통해 요소 가독성을 높힐 수 있다.
oneof
varid = FormData.OneOfValue,
prompt = STRING_TOKEN(ONEOF_PROMPT),
help = STRING_TOKEN(ONEOF_HELP),
option text = STRING_TOKEN(ONEOF_OPTION1), value = 0x00, flags = 0;
option text = STRING_TOKEN(ONEOF_OPTION2), value = 0x33, flags = MANUFACTURING;
option text = STRING_TOKEN(ONEOF_OPTION3), value = 0x55, flags = DEFAULT;
endoneof;
이 경우 0x55 값은 "standard storage", 0x33 값은 "manufacturing storage"로 설정되었다. 앞서 만들었던 resetbuuton를 통해 이 기능을 확인할 수 있다.
flags 로 정의된 기본 값과 default 키워드로 정의된 것을 혼합하여 사용할 수 있지만, 이 경우 UEFI Spec은 엄격한 우선 순위를 갖는다. 하지만 사용하지 않는 것을 추천한다.
flags 는 오직 "standard storage" 와 "manufacturing storage" 에 대한 참조 생성에 이용된다는 점을 기억하자. 기본 저장소 ID는 다른 사용자 지정 저장소에 대한 참조를 정의할 수 없다.
일정하지 않은 기본 값
기본 값을 표현식으로 정의할 수 있다. 이 경우에는 defaults value = <...> 와 같은 문법이 사용된다. 대부분의 경우 기본 값이 다른 question 값에 속해 있을 때 사용된다.
oneof
name = OneOfQuestion,
varid = FormData.OneOfValue,
prompt = STRING_TOKEN(ONEOF_PROMPT),
help = STRING_TOKEN(ONEOF_HELP),
option text = STRING_TOKEN(ONEOF_OPTION1), value = 0x00, flags = 0;
option text = STRING_TOKEN(ONEOF_OPTION2), value = 0x33, flags = MANUFACTURING;
option text = STRING_TOKEN(ONEOF_OPTION3), value = 0x55, flags = DEFAULT;
endoneof;
numeric
name = NumericQuestion,
varid = FormData.NumericValue,
prompt = STRING_TOKEN(NUMERIC_PROMPT),
help = STRING_TOKEN(NUMERIC_HELP),
flags = NUMERIC_SIZE_2 | DISPLAY_UINT_HEX,
minimum = 0,
maximum = 0xff,
step = 1,
default value = questionref(OneOfQuestion),
endnumeric;
이 코드를 통해 "standard storage"로 재설정하면 numeric 기본값이 0x55 로 변경되는 결과와 "manufacturing storage"로 재설정하면 numberic 기본값이 0x33 으로 변경되는 결과를 얻을 수 있다.
참조하는 name 은실제 questionref(< name>) 사용 전에 정의되어야 한다는 점을 유의하자.
지금 IFR 코드를 보면 완전히 다른 방식으로 인코딩 되었다는 것을 볼 수 있다.
numeric
...
default value = questionref(OneOfQuestion),
>000000AE: 5B 85 00 00 08 // EFI_IFR_DEFAULT_2 (structure form without a `Value` field)
>000000B3: 5A 82 // EFI_IFR_VALUE
>000000B5: 40 04 02 00 // EFI_IFR_QUESTION_REF1
이 경우에 EFI_IFR_DEFAULT_2 구조체의 Type 필드가 EFI_IFR_TYPE_OTHER 값임이 확인된다.
EFI_IFR_VALUE 와 EFI_IFR_QUESTION_REF1 에 대한 정의이다.
EFI_IFR_VALUE
Summary:
Provides a value for the current question or default.
Prototype:
#define EFI_IFR_VALUE_OP 0x5a
typedef struct _EFI_IFR_VALUE {
EFI_IFR_OP_HEADER Header;
} EFI_IFR_VALUE;
Members:
Header The sequence that defines the type of opcode as well as the length of the opcode being defined.
For this tag, Header.OpCode = EFI_IFR_VALUE_OP
Description:
Creates a value for the current question or default with no storage. The value is the result of the expression nested in the scope.
EFI_IFR_QUESTION_REF1
Summary:
Push a question’s value on the expression stack
Prototype:
#define EFI_IFR_QUESTION_REF1_OP 0x40
typedef struct _EFI_IFR_QUESTION_REF1 {
EFI_IFR_OP_HEADER Header;
EFI_QUESTION_ID QuestionId;
} EFI_IFR_QUESTION_REF1;
Members:
Header The byte sequence that defines the type of opcode as well as the length of the opcode being defined.
Header.OpCode = EFI_IFR_QUESTION_REF1_OP.
QuestionId The question’s identifier, which must be unique within the form set.
Description:
Push the value of the question specified by QuestionId on to the expression stack
기본 저장소 우선 순위
만약 resetbutton 요소를 이용해 기본 저장소의 값을 ID=0x5555 로 정의했으나 default 와 같은 요소로 기본 저장소의 값을 다른 값으로 (예로 ID=0x3333) 지정했을 경우에 어떤 일이 발생하는지 알아보자.
