summaryrefslogtreecommitdiff
path: root/IntelFrameworkPkg/Include/Framework/FrameworkInternalFormRepresentation.h
blob: 925defebf39293769f5d185861683ef2f3128a9e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
/** @file
  This file defines the encoding for the VFR (Visual Form Representation) language.
  Framework IFR is primarily consumed by the EFI presentation engine, and produced by EFI
  internal application and drivers as well as all add-in card option-ROM drivers

  Copyright (c) 2007 - 2009, Intel Corporation                                                         
  All rights reserved. This program and the accompanying materials                          
  are licensed and made available under the terms and conditions of the BSD License         
  which accompanies this distribution.  The full text of the license may be found at        
  http://opensource.org/licenses/bsd-license.php                                            

  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

  @par Revision Reference:
  These definitions are from Framework Specification HII 0.92.

**/

#ifndef __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__
#define __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__

typedef UINT16  STRING_REF;

//
// IFR Op codes
//
#define FRAMEWORK_EFI_IFR_FORM_OP                 0x01
#define FRAMEWORK_EFI_IFR_SUBTITLE_OP             0x02
#define FRAMEWORK_EFI_IFR_TEXT_OP                 0x03
#define EFI_IFR_GRAPHIC_OP                        0x04
#define FRAMEWORK_EFI_IFR_ONE_OF_OP               0x05
#define FRAMEWORK_EFI_IFR_CHECKBOX_OP             0x06
#define FRAMEWORK_EFI_IFR_NUMERIC_OP              0x07
#define FRAMEWORK_EFI_IFR_PASSWORD_OP             0x08
#define FRAMEWORK_EFI_IFR_ONE_OF_OPTION_OP        0x09  ///< ONEOF OPTION field
#define FRAMEWORK_EFI_IFR_SUPPRESS_IF_OP          0x0A
#define EFI_IFR_END_FORM_OP                       0x0B
#define EFI_IFR_HIDDEN_OP                         0x0C
#define EFI_IFR_END_FORM_SET_OP                   0x0D
#define FRAMEWORK_EFI_IFR_FORM_SET_OP             0x0E
#define FRAMEWORK_EFI_IFR_REF_OP                  0x0F
#define EFI_IFR_END_ONE_OF_OP                     0x10
#define FRAMEWORK_EFI_IFR_END_OP                  EFI_IFR_END_ONE_OF_OP
#define FRAMEWORK_EFI_IFR_INCONSISTENT_IF_OP      0x11
#define FRAMEWORK_EFI_IFR_EQ_ID_VAL_OP            0x12
#define FRAMEWORK_EFI_IFR_EQ_ID_ID_OP             0x13
#define FRAMEWORK_EFI_IFR_EQ_ID_LIST_OP           0x14
#define FRAMEWORK_EFI_IFR_AND_OP                  0x15
#define FRAMEWORK_EFI_IFR_OR_OP                   0x16
#define FRAMEWORK_EFI_IFR_NOT_OP                  0x17
#define EFI_IFR_END_IF_OP                         0x18  ///< for endif of inconsistentif, suppressif, grayoutif
#define EFI_IFR_GRAYOUT_IF_OP                     0x19
#define FRAMEWORK_EFI_IFR_DATE_OP                 0x1A
#define FRAMEWORK_EFI_IFR_TIME_OP                 0x1B
#define FRAMEWORK_EFI_IFR_STRING_OP               0x1C
#define EFI_IFR_LABEL_OP                          0x1D
#define EFI_IFR_SAVE_DEFAULTS_OP                  0x1E
#define EFI_IFR_RESTORE_DEFAULTS_OP               0x1F
#define EFI_IFR_BANNER_OP                         0x20
#define EFI_IFR_INVENTORY_OP                      0x21
#define EFI_IFR_EQ_VAR_VAL_OP                     0x22
#define FRAMEWORK_EFI_IFR_ORDERED_LIST_OP         0x23
#define FRAMEWORK_EFI_IFR_VARSTORE_OP             0x24
#define EFI_IFR_VARSTORE_SELECT_OP                0x25
#define EFI_IFR_VARSTORE_SELECT_PAIR_OP           0x26
#define EFI_IFR_LAST_OPCODE                       EFI_IFR_VARSTORE_SELECT_PAIR_OP
#define EFI_IFR_OEM_OP                            0xFE
#define EFI_IFR_NV_ACCESS_COMMAND                 0xFF

//
// Define values for the flags fields in some VFR opcodes. These are
// bitmasks.
//
#define EFI_IFR_FLAG_DEFAULT            0x01
#define EFI_IFR_FLAG_MANUFACTURING      0x02
#define EFI_IFR_FLAG_INTERACTIVE        0x04
#define EFI_IFR_FLAG_NV_ACCESS          0x08
#define EFI_IFR_FLAG_RESET_REQUIRED     0x10
#define EFI_IFR_FLAG_LATE_CHECK         0x20

#define EFI_NON_DEVICE_CLASS              0x00  ///< Useful when you do not want something in the Device Manager
#define EFI_DISK_DEVICE_CLASS             0x01
#define EFI_VIDEO_DEVICE_CLASS            0x02
#define EFI_NETWORK_DEVICE_CLASS          0x04
#define EFI_INPUT_DEVICE_CLASS            0x08
#define EFI_ON_BOARD_DEVICE_CLASS         0x10
#define EFI_OTHER_DEVICE_CLASS            0x20

#define EFI_SETUP_APPLICATION_SUBCLASS    0x00
#define EFI_GENERAL_APPLICATION_SUBCLASS  0x01
#define EFI_FRONT_PAGE_SUBCLASS           0x02
#define EFI_SINGLE_USE_SUBCLASS           0x03  ///< Used to display a single entity and then exit

///
/// Used to flag dynamically created op-codes. This is meaningful to the IFR Library set
/// and the browser since we need to distinguish between compiled NV map data and created data.
/// We do not allow new entries to be created in the NV map dynamically, but we do need
/// to display this information correctly.  To dynamically create op-codes and assume that their
/// data will be saved, ensure that the NV starting location they refer to is pre-defined in the
/// NV map.
///
#define EFI_IFR_FLAG_CREATED  128


#pragma pack(1)
//
// IFR Structure definitions
//
typedef struct {
  UINT8                             OpCode;
  UINT8                             Length;
} FRAMEWORK_EFI_IFR_OP_HEADER;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  EFI_GUID                          Guid;
  STRING_REF                        FormSetTitle;
  STRING_REF                        Help;
  EFI_PHYSICAL_ADDRESS              CallbackHandle;
  UINT16                            Class;
  UINT16                            SubClass;
  UINT16                            NvDataSize; ///< set once, size of the NV data as defined in the script
} FRAMEWORK_EFI_IFR_FORM_SET;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            FormId;
  STRING_REF                        FormTitle;
} FRAMEWORK_EFI_IFR_FORM;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            LabelId;
} EFI_IFR_LABEL;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  STRING_REF                        SubTitle;
} FRAMEWORK_EFI_IFR_SUBTITLE;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  STRING_REF                        Help;
  STRING_REF                        Text;
  STRING_REF                        TextTwo;
  UINT8                             Flags;  ///< This is included solely for purposes of interactive/dynamic support.
  UINT16                            Key;    ///< Value to be passed to caller to identify this particular op-code
} FRAMEWORK_EFI_IFR_TEXT;

//
// goto
//
typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            FormId;
  STRING_REF                        Prompt;
  STRING_REF                        Help;   ///< The string Token for the context-help
  UINT8                             Flags;  ///< This is included solely for purposes of interactive/dynamic support.
  UINT16                            Key;    ///< Value to be passed to caller to identify this particular op-code
} FRAMEWORK_EFI_IFR_REF;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} EFI_IFR_END_FORM;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} EFI_IFR_END_FORM_SET;

//
// Also notice that the IFR_ONE_OF and IFR_CHECK_BOX are identical in structure......
// code assumes this to be true, if this ever changes we need to revisit the InitializeTagStructures code
//
typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId; ///< The ID designating what the question is about...
  UINT8                             Width;      ///< The Size of the Data being saved
  STRING_REF                        Prompt;     ///< The String Token for the Prompt
  STRING_REF                        Help;       ///< The string Token for the context-help
} FRAMEWORK_EFI_IFR_ONE_OF;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId; ///< The offset in NV for storage of the data
  UINT8                             MaxEntries; ///< The maximum number of options in the ordered list (=size of NVStore)
  STRING_REF                        Prompt;     ///< The string token for the prompt
  STRING_REF                        Help;       ///< The string token for the context-help
} FRAMEWORK_EFI_IFR_ORDERED_LIST;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId; ///< The ID designating what the question is about...
  UINT8                             Width;      ///< The Size of the Data being saved
  STRING_REF                        Prompt;     ///< The String Token for the Prompt
  STRING_REF                        Help;       ///< The string Token for the context-help
  UINT8                             Flags;      ///< If non-zero, means that it is the default option
  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code
} FRAMEWORK_EFI_IFR_CHECKBOX, EFI_IFR_CHECK_BOX;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  STRING_REF                        Option;     ///< The string token describing the option
  UINT16                            Value;      ///< The value associated with this option that is stored in the NVRAM
  UINT8                             Flags;      ///< If non-zero, means that it is the default option
  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code
} FRAMEWORK_EFI_IFR_ONE_OF_OPTION;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId; ///< The ID designating what the question is about...
  UINT8                             Width;      ///< The Size of the Data being saved
  STRING_REF                        Prompt;     ///< The String Token for the Prompt
  STRING_REF                        Help;       ///< The string Token for the context-help
  UINT8                             Flags;      ///< This is included solely for purposes of interactive/dynamic support.
  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code
  UINT16                            Minimum;
  UINT16                            Maximum;
  UINT16                            Step;       ///< Zero means manual input, otherwise, arrow selection is called for
  UINT16                            Default;
} FRAMEWORK_EFI_IFR_NUMERIC;

//
// There is an interesting twist with regards to Time and Date.  This is one of the few items which can accept input
// from a user, and may or may not need to use storage in the NVRAM space.  The decided method for determining 
// if NVRAM space will be used (only for a TimeOp or DateOp) is:  If .QuestionId == 0 && .Width == 0 (normally an 
// impossibility) then use system resources to store the data away and not NV resources.  In other words, the setup
// engine will call gRT->SetTime, and gRT->SetDate for the saving of data, and the values displayed will be from the
// gRT->GetXXXX series of calls.
//
typedef struct {
  FRAMEWORK_EFI_IFR_NUMERIC         Hour;
  FRAMEWORK_EFI_IFR_NUMERIC         Minute;
  FRAMEWORK_EFI_IFR_NUMERIC         Second;
} FRAMEWORK_EFI_IFR_TIME;

typedef struct {
  FRAMEWORK_EFI_IFR_NUMERIC         Year;
  FRAMEWORK_EFI_IFR_NUMERIC         Month;
  FRAMEWORK_EFI_IFR_NUMERIC         Day;
} FRAMEWORK_EFI_IFR_DATE;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId;///< The ID designating what the question is about...
  UINT8                             Width;     ///< The Size of the Data being saved
  STRING_REF                        Prompt;    ///< The String Token for the Prompt
  STRING_REF                        Help;      ///< The string Token for the context-help
  UINT8                             Flags;     ///< This is included solely for purposes of interactive/dynamic support.
  UINT16                            Key;       ///< Value to be passed to caller to identify this particular op-code
  UINT8                             MinSize;   ///< Minimum allowable sized password
  UINT8                             MaxSize;   ///< Maximum allowable sized password
  UINT16                            Encoding;
} FRAMEWORK_EFI_IFR_PASSWORD;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId; ///< The ID designating what the question is about...
  UINT8                             Width;      ///< The Size of the Data being saved 
  STRING_REF                        Prompt;     ///< The String Token for the Prompt
  STRING_REF                        Help;       ///< The string Token for the context-help
  UINT8                             Flags;      ///< This is included solely for purposes of interactive/dynamic support.
  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code
  UINT8                             MinSize;    ///< Minimum allowable sized password
  UINT8                             MaxSize;    ///< Maximum allowable sized password
} FRAMEWORK_EFI_IFR_STRING;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} EFI_IFR_END_ONE_OF;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            Value;
  UINT16                            Key;
} EFI_IFR_HIDDEN;

///
/// Inconsistent with specification here:
/// Following defintion may not comply with Framework Specification HII 0.92. To 
/// keep the inconsistant is for implementation needed.
///
typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT8                             Flags;
} EFI_IFR_SUPPRESS;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT8                             Flags;
} EFI_IFR_GRAY_OUT;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  STRING_REF                        Popup;
  UINT8                             Flags;
} EFI_IFR_INCONSISTENT;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId;   ///< offset into variable storage
  UINT8                             Width;        ///< size of variable storage
  UINT16                            Value;        ///< value to compare against
} FRAMEWORK_EFI_IFR_EQ_ID_VAL;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId;   ///< offset into variable storage
  UINT8                             Width;        ///< size of variable storage
  UINT16                            ListLength;
  UINT16                            ValueList[1];
} FRAMEWORK_EFI_IFR_EQ_ID_LIST;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            QuestionId1;  ///< offset into variable storage for first value to compare
  UINT8                             Width;        ///< size of variable storage (must be same for both)
  UINT16                            QuestionId2;  ///< offset into variable storage for second value to compare
} FRAMEWORK_EFI_IFR_EQ_ID_ID;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            VariableId;   ///< offset into variable storage
  UINT16                            Value;        ///< value to compare against
} EFI_IFR_EQ_VAR_VAL;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} FRAMEWORK_EFI_IFR_AND;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} FRAMEWORK_EFI_IFR_OR;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} FRAMEWORK_EFI_IFR_NOT;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
} EFI_IFR_END_EXPR, EFI_IFR_END_IF;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            FormId;
  STRING_REF                        Prompt;
  STRING_REF                        Help;
  UINT8                             Flags;
  UINT16                            Key;
} EFI_IFR_SAVE_DEFAULTS;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  STRING_REF                        Help;
  STRING_REF                        Text;
  STRING_REF                        TextTwo;    ///< optional text
} EFI_IFR_INVENTORY;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  EFI_GUID                          Guid;       ///< GUID for the variable
  UINT16                            VarId;      ///< variable store ID, as referenced elsewhere in the form
  UINT16                            Size;       ///< size of the variable storage
} FRAMEWORK_EFI_IFR_VARSTORE;

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            VarId;      ///< variable store ID, as referenced elsewhere in the form
} EFI_IFR_VARSTORE_SELECT;

///
/// Used for the ideqid VFR statement where two variable stores may be referenced in the
/// same VFR statement.
/// A browser should treat this as an FRAMEWORK_EFI_IFR_VARSTORE_SELECT statement and assume that all following
/// IFR opcodes use the VarId as defined here.
///
typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  UINT16                            VarId;          ///< variable store ID, as referenced elsewhere in the form
  UINT16                            SecondaryVarId; ///< variable store ID, as referenced elsewhere in the form
} EFI_IFR_VARSTORE_SELECT_PAIR;

///
/// Save defaults and restore defaults have same structure
///
#define EFI_IFR_RESTORE_DEFAULTS  EFI_IFR_SAVE_DEFAULTS

typedef struct {
  FRAMEWORK_EFI_IFR_OP_HEADER       Header;
  STRING_REF                        Title;        ///< The string token for the banner title
  UINT16                            LineNumber;   ///< 1-based line number
  UINT8                             Alignment;    ///< left, center, or right-aligned
} EFI_IFR_BANNER;

#define EFI_IFR_BANNER_ALIGN_LEFT   0
#define EFI_IFR_BANNER_ALIGN_CENTER 1
#define EFI_IFR_BANNER_ALIGN_RIGHT  2
#define EFI_IFR_BANNER_TIMEOUT      0xFF

#pragma pack()

#endif