blob: 502fffed200df38721d6e9172bc48fdbba1ea587 [file] [log] [blame]
Simon Glass867a6ac2015-07-31 09:31:36 -06001/*
2 * Extensible Firmware Interface
3 * Based on 'Extensible Firmware Interface Specification' version 0.9,
4 * April 30, 1999
5 *
6 * Copyright (C) 1999 VA Linux Systems
7 * Copyright (C) 1999 Walt Drummond <drummond@valinux.com>
8 * Copyright (C) 1999, 2002-2003 Hewlett-Packard Co.
9 * David Mosberger-Tang <davidm@hpl.hp.com>
10 * Stephane Eranian <eranian@hpl.hp.com>
11 *
12 * From include/linux/efi.h in kernel 4.1 with some additions/subtractions
13 */
14
15#ifndef _EFI_API_H
16#define _EFI_API_H
17
18#include <efi.h>
19
Alexander Grafa86aeaf2016-05-20 23:28:23 +020020#ifdef CONFIG_EFI_LOADER
21#include <asm/setjmp.h>
22#endif
23
Alexander Graf2bb9b792016-03-04 01:09:57 +010024/* Types and defines for EFI CreateEvent */
xypron.glpk@gmx.deb521d292017-07-19 19:22:34 +020025enum efi_timer_delay {
Alexander Graf2bb9b792016-03-04 01:09:57 +010026 EFI_TIMER_STOP = 0,
27 EFI_TIMER_PERIODIC = 1,
28 EFI_TIMER_RELATIVE = 2
29};
30
Heinrich Schuchardt152cade2017-11-06 21:17:47 +010031#define efi_uintn_t size_t
Rob Clark3a45bc72017-09-13 18:05:44 -040032typedef uint16_t *efi_string_t;
xypron.glpk@gmx.de503f2692017-07-18 20:17:19 +020033
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +020034#define EVT_TIMER 0x80000000
35#define EVT_RUNTIME 0x40000000
36#define EVT_NOTIFY_WAIT 0x00000100
37#define EVT_NOTIFY_SIGNAL 0x00000200
38#define EVT_SIGNAL_EXIT_BOOT_SERVICES 0x00000201
39#define EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE 0x60000202
40
41#define TPL_APPLICATION 0x04
42#define TPL_CALLBACK 0x08
43#define TPL_NOTIFY 0x10
44#define TPL_HIGH_LEVEL 0x1F
Jonathan Gray37a980b2017-03-12 19:26:06 +110045
xypron.glpk@gmx.de2fd945f2017-07-18 20:17:17 +020046struct efi_event;
47
Simon Glass867a6ac2015-07-31 09:31:36 -060048/* EFI Boot Services table */
49struct efi_boot_services {
50 struct efi_table_hdr hdr;
Heinrich Schuchardt152cade2017-11-06 21:17:47 +010051 efi_status_t (EFIAPI *raise_tpl)(efi_uintn_t new_tpl);
52 void (EFIAPI *restore_tpl)(efi_uintn_t old_tpl);
Simon Glass867a6ac2015-07-31 09:31:36 -060053
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +010054 efi_status_t (EFIAPI *allocate_pages)(int, int, efi_uintn_t,
Simon Glass867a6ac2015-07-31 09:31:36 -060055 efi_physical_addr_t *);
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +010056 efi_status_t (EFIAPI *free_pages)(efi_physical_addr_t, efi_uintn_t);
57 efi_status_t (EFIAPI *get_memory_map)(efi_uintn_t *memory_map_size,
58 struct efi_mem_desc *desc,
59 efi_uintn_t *key,
60 efi_uintn_t *desc_size,
61 u32 *desc_version);
62 efi_status_t (EFIAPI *allocate_pool)(int, efi_uintn_t, void **);
Simon Glass867a6ac2015-07-31 09:31:36 -060063 efi_status_t (EFIAPI *free_pool)(void *);
64
xypron.glpk@gmx.deb521d292017-07-19 19:22:34 +020065 efi_status_t (EFIAPI *create_event)(uint32_t type,
Heinrich Schuchardt152cade2017-11-06 21:17:47 +010066 efi_uintn_t notify_tpl,
xypron.glpk@gmx.de2fd945f2017-07-18 20:17:17 +020067 void (EFIAPI *notify_function) (
68 struct efi_event *event,
69 void *context),
70 void *notify_context, struct efi_event **event);
xypron.glpk@gmx.deb521d292017-07-19 19:22:34 +020071 efi_status_t (EFIAPI *set_timer)(struct efi_event *event,
72 enum efi_timer_delay type,
73 uint64_t trigger_time);
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +010074 efi_status_t (EFIAPI *wait_for_event)(efi_uintn_t number_of_events,
75 struct efi_event **event,
76 efi_uintn_t *index);
xypron.glpk@gmx.de2fd945f2017-07-18 20:17:17 +020077 efi_status_t (EFIAPI *signal_event)(struct efi_event *event);
78 efi_status_t (EFIAPI *close_event)(struct efi_event *event);
79 efi_status_t (EFIAPI *check_event)(struct efi_event *event);
xypron.glpk@gmx.dee0549f82017-07-11 22:06:16 +020080#define EFI_NATIVE_INTERFACE 0x00000000
Alexander Graf2bb9b792016-03-04 01:09:57 +010081 efi_status_t (EFIAPI *install_protocol_interface)(
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +020082 void **handle, const efi_guid_t *protocol,
Alexander Graf2bb9b792016-03-04 01:09:57 +010083 int protocol_interface_type, void *protocol_interface);
84 efi_status_t (EFIAPI *reinstall_protocol_interface)(
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +020085 void *handle, const efi_guid_t *protocol,
Alexander Graf2bb9b792016-03-04 01:09:57 +010086 void *old_interface, void *new_interface);
Heinrich Schuchardt2074f702018-01-11 08:16:09 +010087 efi_status_t (EFIAPI *uninstall_protocol_interface)(
88 efi_handle_t handle, const efi_guid_t *protocol,
89 void *protocol_interface);
90 efi_status_t (EFIAPI *handle_protocol)(
91 efi_handle_t handle, const efi_guid_t *protocol,
92 void **protocol_interface);
Simon Glass867a6ac2015-07-31 09:31:36 -060093 void *reserved;
Alexander Graf2bb9b792016-03-04 01:09:57 +010094 efi_status_t (EFIAPI *register_protocol_notify)(
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +020095 const efi_guid_t *protocol, struct efi_event *event,
Alexander Graf2bb9b792016-03-04 01:09:57 +010096 void **registration);
Simon Glass867a6ac2015-07-31 09:31:36 -060097 efi_status_t (EFIAPI *locate_handle)(
98 enum efi_locate_search_type search_type,
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +020099 const efi_guid_t *protocol, void *search_key,
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100100 efi_uintn_t *buffer_size, efi_handle_t *buffer);
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +0200101 efi_status_t (EFIAPI *locate_device_path)(const efi_guid_t *protocol,
Simon Glass867a6ac2015-07-31 09:31:36 -0600102 struct efi_device_path **device_path,
103 efi_handle_t *device);
Alexander Graf2bb9b792016-03-04 01:09:57 +0100104 efi_status_t (EFIAPI *install_configuration_table)(
105 efi_guid_t *guid, void *table);
Simon Glass867a6ac2015-07-31 09:31:36 -0600106
107 efi_status_t (EFIAPI *load_image)(bool boot_policiy,
108 efi_handle_t parent_image,
109 struct efi_device_path *file_path, void *source_buffer,
110 unsigned long source_size, efi_handle_t *image);
111 efi_status_t (EFIAPI *start_image)(efi_handle_t handle,
112 unsigned long *exitdata_size,
113 s16 **exitdata);
114 efi_status_t (EFIAPI *exit)(efi_handle_t handle,
115 efi_status_t exit_status,
116 unsigned long exitdata_size, s16 *exitdata);
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100117 efi_status_t (EFIAPI *unload_image)(efi_handle_t image_handle);
Simon Glass867a6ac2015-07-31 09:31:36 -0600118 efi_status_t (EFIAPI *exit_boot_services)(efi_handle_t, unsigned long);
119
120 efi_status_t (EFIAPI *get_next_monotonic_count)(u64 *count);
121 efi_status_t (EFIAPI *stall)(unsigned long usecs);
Alexander Graf2bb9b792016-03-04 01:09:57 +0100122 efi_status_t (EFIAPI *set_watchdog_timer)(unsigned long timeout,
123 uint64_t watchdog_code, unsigned long data_size,
124 uint16_t *watchdog_data);
Simon Glass867a6ac2015-07-31 09:31:36 -0600125 efi_status_t(EFIAPI *connect_controller)(efi_handle_t controller_handle,
126 efi_handle_t *driver_image_handle,
127 struct efi_device_path *remaining_device_path,
128 bool recursive);
Heinrich Schuchardt3ebcd002018-01-11 08:16:03 +0100129 efi_status_t (EFIAPI *disconnect_controller)(
130 efi_handle_t controller_handle,
131 efi_handle_t driver_image_handle,
132 efi_handle_t child_handle);
Simon Glass867a6ac2015-07-31 09:31:36 -0600133#define EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL 0x00000001
134#define EFI_OPEN_PROTOCOL_GET_PROTOCOL 0x00000002
135#define EFI_OPEN_PROTOCOL_TEST_PROTOCOL 0x00000004
136#define EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER 0x00000008
137#define EFI_OPEN_PROTOCOL_BY_DRIVER 0x00000010
138#define EFI_OPEN_PROTOCOL_EXCLUSIVE 0x00000020
139 efi_status_t (EFIAPI *open_protocol)(efi_handle_t handle,
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +0200140 const efi_guid_t *protocol, void **interface,
Simon Glass867a6ac2015-07-31 09:31:36 -0600141 efi_handle_t agent_handle,
142 efi_handle_t controller_handle, u32 attributes);
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100143 efi_status_t (EFIAPI *close_protocol)(
144 efi_handle_t handle, const efi_guid_t *protocol,
145 efi_handle_t agent_handle,
146 efi_handle_t controller_handle);
Simon Glass867a6ac2015-07-31 09:31:36 -0600147 efi_status_t(EFIAPI *open_protocol_information)(efi_handle_t handle,
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +0200148 const efi_guid_t *protocol,
Simon Glass867a6ac2015-07-31 09:31:36 -0600149 struct efi_open_protocol_info_entry **entry_buffer,
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100150 efi_uintn_t *entry_count);
Simon Glass867a6ac2015-07-31 09:31:36 -0600151 efi_status_t (EFIAPI *protocols_per_handle)(efi_handle_t handle,
152 efi_guid_t ***protocol_buffer,
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100153 efi_uintn_t *protocols_buffer_count);
Simon Glass867a6ac2015-07-31 09:31:36 -0600154 efi_status_t (EFIAPI *locate_handle_buffer) (
155 enum efi_locate_search_type search_type,
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +0200156 const efi_guid_t *protocol, void *search_key,
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100157 efi_uintn_t *no_handles, efi_handle_t **buffer);
Heinrich Schuchardt5a9682d2017-10-05 16:35:53 +0200158 efi_status_t (EFIAPI *locate_protocol)(const efi_guid_t *protocol,
Alexander Graf2bb9b792016-03-04 01:09:57 +0100159 void *registration, void **protocol_interface);
160 efi_status_t (EFIAPI *install_multiple_protocol_interfaces)(
161 void **handle, ...);
162 efi_status_t (EFIAPI *uninstall_multiple_protocol_interfaces)(
163 void *handle, ...);
164 efi_status_t (EFIAPI *calculate_crc32)(void *data,
165 unsigned long data_size, uint32_t *crc32);
Heinrich Schuchardtfc05a952017-10-05 16:35:52 +0200166 void (EFIAPI *copy_mem)(void *destination, const void *source,
167 size_t length);
168 void (EFIAPI *set_mem)(void *buffer, size_t size, uint8_t value);
Simon Glass867a6ac2015-07-31 09:31:36 -0600169 void *create_event_ex;
170};
171
172/* Types and defines for EFI ResetSystem */
173enum efi_reset_type {
174 EFI_RESET_COLD = 0,
175 EFI_RESET_WARM = 1,
176 EFI_RESET_SHUTDOWN = 2
177};
178
179/* EFI Runtime Services table */
180#define EFI_RUNTIME_SERVICES_SIGNATURE 0x5652453544e5552ULL
181#define EFI_RUNTIME_SERVICES_REVISION 0x00010000
182
183struct efi_runtime_services {
184 struct efi_table_hdr hdr;
Alexander Graf2bb9b792016-03-04 01:09:57 +0100185 efi_status_t (EFIAPI *get_time)(struct efi_time *time,
186 struct efi_time_cap *capabilities);
187 efi_status_t (EFIAPI *set_time)(struct efi_time *time);
188 efi_status_t (EFIAPI *get_wakeup_time)(char *enabled, char *pending,
189 struct efi_time *time);
190 efi_status_t (EFIAPI *set_wakeup_time)(char enabled,
191 struct efi_time *time);
192 efi_status_t (EFIAPI *set_virtual_address_map)(
193 unsigned long memory_map_size,
194 unsigned long descriptor_size,
195 uint32_t descriptor_version,
196 struct efi_mem_desc *virtmap);
197 efi_status_t (*convert_pointer)(unsigned long dbg, void **address);
Simon Glass867a6ac2015-07-31 09:31:36 -0600198 efi_status_t (EFIAPI *get_variable)(s16 *variable_name,
199 efi_guid_t *vendor, u32 *attributes,
200 unsigned long *data_size, void *data);
201 efi_status_t (EFIAPI *get_next_variable)(
202 unsigned long *variable_name_size,
203 s16 *variable_name, efi_guid_t *vendor);
204 efi_status_t (EFIAPI *set_variable)(s16 *variable_name,
205 efi_guid_t *vendor, u32 attributes,
206 unsigned long data_size, void *data);
Alexander Graf2bb9b792016-03-04 01:09:57 +0100207 efi_status_t (EFIAPI *get_next_high_mono_count)(
208 uint32_t *high_count);
Simon Glass867a6ac2015-07-31 09:31:36 -0600209 void (EFIAPI *reset_system)(enum efi_reset_type reset_type,
210 efi_status_t reset_status,
211 unsigned long data_size, void *reset_data);
212 void *update_capsule;
213 void *query_capsule_caps;
214 void *query_variable_info;
215};
216
217/* EFI Configuration Table and GUID definitions */
218#define NULL_GUID \
219 EFI_GUID(0x00000000, 0x0000, 0x0000, 0x00, 0x00, \
220 0x00, 0x00, 0x00, 0x00, 0x00, 0x00)
221
Rob Clark9975fe92017-09-13 18:05:38 -0400222#define EFI_GLOBAL_VARIABLE_GUID \
223 EFI_GUID(0x8be4df61, 0x93ca, 0x11d2, 0xaa, 0x0d, \
224 0x00, 0xe0, 0x98, 0x03, 0x2b, 0x8c)
225
Simon Glass867a6ac2015-07-31 09:31:36 -0600226#define LOADED_IMAGE_PROTOCOL_GUID \
227 EFI_GUID(0x5b1b31a1, 0x9562, 0x11d2, 0x8e, 0x3f, \
228 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
229
Alexander Graf2bb9b792016-03-04 01:09:57 +0100230#define EFI_FDT_GUID \
231 EFI_GUID(0xb1b621d5, 0xf19c, 0x41a5, \
232 0x83, 0x0b, 0xd9, 0x15, 0x2c, 0x69, 0xaa, 0xe0)
233
Alexander Grafe663b352016-08-19 01:23:29 +0200234#define SMBIOS_TABLE_GUID \
235 EFI_GUID(0xeb9d2d31, 0x2d88, 0x11d3, \
236 0x9a, 0x16, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
237
Alexander Graf2bb9b792016-03-04 01:09:57 +0100238struct efi_configuration_table
239{
240 efi_guid_t guid;
241 void *table;
242};
243
244#define EFI_SYSTEM_TABLE_SIGNATURE ((u64)0x5453595320494249ULL)
245
Simon Glass867a6ac2015-07-31 09:31:36 -0600246struct efi_system_table {
247 struct efi_table_hdr hdr;
248 unsigned long fw_vendor; /* physical addr of wchar_t vendor string */
249 u32 fw_revision;
250 unsigned long con_in_handle;
251 struct efi_simple_input_interface *con_in;
252 unsigned long con_out_handle;
253 struct efi_simple_text_output_protocol *con_out;
254 unsigned long stderr_handle;
Alexander Graf2bb9b792016-03-04 01:09:57 +0100255 struct efi_simple_text_output_protocol *std_err;
Simon Glass867a6ac2015-07-31 09:31:36 -0600256 struct efi_runtime_services *runtime;
257 struct efi_boot_services *boottime;
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100258 efi_uintn_t nr_tables;
Alexander Graf2bb9b792016-03-04 01:09:57 +0100259 struct efi_configuration_table *tables;
Simon Glass867a6ac2015-07-31 09:31:36 -0600260};
261
Alexander Graf2bb9b792016-03-04 01:09:57 +0100262#define LOADED_IMAGE_GUID \
263 EFI_GUID(0x5b1b31a1, 0x9562, 0x11d2, \
264 0x8e, 0x3f, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
265
Simon Glass867a6ac2015-07-31 09:31:36 -0600266struct efi_loaded_image {
267 u32 revision;
268 void *parent_handle;
269 struct efi_system_table *system_table;
270 void *device_handle;
271 void *file_path;
272 void *reserved;
273 u32 load_options_size;
274 void *load_options;
275 void *image_base;
276 aligned_u64 image_size;
277 unsigned int image_code_type;
278 unsigned int image_data_type;
279 unsigned long unload;
Alexander Grafa86aeaf2016-05-20 23:28:23 +0200280
281 /* Below are efi loader private fields */
282#ifdef CONFIG_EFI_LOADER
283 efi_status_t exit_status;
284 struct jmp_buf_data exit_jmp;
285#endif
Simon Glass867a6ac2015-07-31 09:31:36 -0600286};
287
Alexander Graf2bb9b792016-03-04 01:09:57 +0100288#define DEVICE_PATH_GUID \
289 EFI_GUID(0x09576e91, 0x6d3f, 0x11d2, \
290 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b )
291
292#define DEVICE_PATH_TYPE_END 0x7f
293# define DEVICE_PATH_SUB_TYPE_END 0xff
294
Simon Glass867a6ac2015-07-31 09:31:36 -0600295struct efi_device_path {
296 u8 type;
297 u8 sub_type;
298 u16 length;
Rob Clarka8606ef2017-09-13 18:05:26 -0400299} __packed;
Simon Glass867a6ac2015-07-31 09:31:36 -0600300
Oleksandr Tymoshenkod7608ab2016-10-24 10:47:01 -0700301struct efi_mac_addr {
302 u8 addr[32];
Rob Clarka8606ef2017-09-13 18:05:26 -0400303} __packed;
Oleksandr Tymoshenkod7608ab2016-10-24 10:47:01 -0700304
Peter Jonesc80214c2017-09-13 18:05:27 -0400305#define DEVICE_PATH_TYPE_HARDWARE_DEVICE 0x01
Rob Clarkbf192732017-10-10 08:23:06 -0400306# define DEVICE_PATH_SUB_TYPE_MEMORY 0x03
Peter Jonesc80214c2017-09-13 18:05:27 -0400307# define DEVICE_PATH_SUB_TYPE_VENDOR 0x04
308
Rob Clarkbf192732017-10-10 08:23:06 -0400309struct efi_device_path_memory {
310 struct efi_device_path dp;
311 u32 memory_type;
312 u64 start_address;
313 u64 end_address;
314} __packed;
315
Peter Jonesc80214c2017-09-13 18:05:27 -0400316struct efi_device_path_vendor {
317 struct efi_device_path dp;
318 efi_guid_t guid;
319 u8 vendor_data[];
320} __packed;
321
322#define DEVICE_PATH_TYPE_ACPI_DEVICE 0x02
323# define DEVICE_PATH_SUB_TYPE_ACPI_DEVICE 0x01
324
325#define EFI_PNP_ID(ID) (u32)(((ID) << 16) | 0x41D0)
326#define EISA_PNP_ID(ID) EFI_PNP_ID(ID)
Rob Clarkadae4312017-09-13 18:05:30 -0400327#define EISA_PNP_NUM(ID) ((ID) >> 16)
Peter Jonesc80214c2017-09-13 18:05:27 -0400328
329struct efi_device_path_acpi_path {
330 struct efi_device_path dp;
331 u32 hid;
332 u32 uid;
333} __packed;
334
Oleksandr Tymoshenkod7608ab2016-10-24 10:47:01 -0700335#define DEVICE_PATH_TYPE_MESSAGING_DEVICE 0x03
Heinrich Schuchardtaf3106a2017-12-11 12:56:44 +0100336# define DEVICE_PATH_SUB_TYPE_MSG_ATAPI 0x01
337# define DEVICE_PATH_SUB_TYPE_MSG_SCSI 0x02
Peter Jonesc80214c2017-09-13 18:05:27 -0400338# define DEVICE_PATH_SUB_TYPE_MSG_USB 0x05
Oleksandr Tymoshenkod7608ab2016-10-24 10:47:01 -0700339# define DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR 0x0b
Rob Clarkb66c60d2017-09-13 18:05:28 -0400340# define DEVICE_PATH_SUB_TYPE_MSG_USB_CLASS 0x0f
Peter Jonesc80214c2017-09-13 18:05:27 -0400341# define DEVICE_PATH_SUB_TYPE_MSG_SD 0x1a
342# define DEVICE_PATH_SUB_TYPE_MSG_MMC 0x1d
343
Heinrich Schuchardtaf3106a2017-12-11 12:56:44 +0100344struct efi_device_path_atapi {
345 struct efi_device_path dp;
346 u8 primary_secondary;
347 u8 slave_master;
348 u16 logical_unit_number;
349} __packed;
350
351struct efi_device_path_scsi {
352 struct efi_device_path dp;
353 u16 target_id;
354 u16 logical_unit_number;
355} __packed;
356
Peter Jonesc80214c2017-09-13 18:05:27 -0400357struct efi_device_path_usb {
358 struct efi_device_path dp;
359 u8 parent_port_number;
360 u8 usb_interface;
361} __packed;
Oleksandr Tymoshenkod7608ab2016-10-24 10:47:01 -0700362
363struct efi_device_path_mac_addr {
364 struct efi_device_path dp;
365 struct efi_mac_addr mac;
366 u8 if_type;
Rob Clarka8606ef2017-09-13 18:05:26 -0400367} __packed;
Oleksandr Tymoshenkod7608ab2016-10-24 10:47:01 -0700368
Rob Clarkb66c60d2017-09-13 18:05:28 -0400369struct efi_device_path_usb_class {
370 struct efi_device_path dp;
371 u16 vendor_id;
372 u16 product_id;
373 u8 device_class;
374 u8 device_subclass;
375 u8 device_protocol;
376} __packed;
377
Peter Jonesc80214c2017-09-13 18:05:27 -0400378struct efi_device_path_sd_mmc_path {
379 struct efi_device_path dp;
380 u8 slot_number;
381} __packed;
382
Alexander Graf2bb9b792016-03-04 01:09:57 +0100383#define DEVICE_PATH_TYPE_MEDIA_DEVICE 0x04
Peter Jonesc80214c2017-09-13 18:05:27 -0400384# define DEVICE_PATH_SUB_TYPE_HARD_DRIVE_PATH 0x01
385# define DEVICE_PATH_SUB_TYPE_CDROM_PATH 0x02
Alexander Graf2bb9b792016-03-04 01:09:57 +0100386# define DEVICE_PATH_SUB_TYPE_FILE_PATH 0x04
387
Peter Jonesc80214c2017-09-13 18:05:27 -0400388struct efi_device_path_hard_drive_path {
389 struct efi_device_path dp;
390 u32 partition_number;
391 u64 partition_start;
392 u64 partition_end;
393 u8 partition_signature[16];
394 u8 partmap_type;
395 u8 signature_type;
396} __packed;
397
398struct efi_device_path_cdrom_path {
399 struct efi_device_path dp;
400 u32 boot_entry;
401 u64 partition_start;
402 u64 partition_end;
403} __packed;
404
Alexander Graf2bb9b792016-03-04 01:09:57 +0100405struct efi_device_path_file_path {
406 struct efi_device_path dp;
Rob Clark61b7e222017-09-13 18:05:39 -0400407 u16 str[];
Rob Clarka8606ef2017-09-13 18:05:26 -0400408} __packed;
Alexander Graf2bb9b792016-03-04 01:09:57 +0100409
410#define BLOCK_IO_GUID \
411 EFI_GUID(0x964e5b21, 0x6459, 0x11d2, \
412 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
413
414struct efi_block_io_media
415{
416 u32 media_id;
417 char removable_media;
418 char media_present;
419 char logical_partition;
420 char read_only;
421 char write_caching;
422 u8 pad[3];
423 u32 block_size;
424 u32 io_align;
425 u8 pad2[4];
426 u64 last_block;
427};
428
429struct efi_block_io {
430 u64 revision;
431 struct efi_block_io_media *media;
432 efi_status_t (EFIAPI *reset)(struct efi_block_io *this,
433 char extended_verification);
434 efi_status_t (EFIAPI *read_blocks)(struct efi_block_io *this,
435 u32 media_id, u64 lba, unsigned long buffer_size,
436 void *buffer);
437 efi_status_t (EFIAPI *write_blocks)(struct efi_block_io *this,
438 u32 media_id, u64 lba, unsigned long buffer_size,
439 void *buffer);
440 efi_status_t (EFIAPI *flush_blocks)(struct efi_block_io *this);
441};
442
Simon Glass867a6ac2015-07-31 09:31:36 -0600443struct simple_text_output_mode {
444 s32 max_mode;
445 s32 mode;
446 s32 attribute;
447 s32 cursor_column;
448 s32 cursor_row;
449 bool cursor_visible;
450};
451
Rob Clarka17e62c2017-07-24 10:39:01 -0400452
453#define EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL_GUID \
454 EFI_GUID(0x387477c2, 0x69c7, 0x11d2, \
455 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
456
Rob Clark2d5dc2a2017-10-10 08:23:01 -0400457#define EFI_BLACK 0x00
458#define EFI_BLUE 0x01
459#define EFI_GREEN 0x02
460#define EFI_CYAN 0x03
461#define EFI_RED 0x04
462#define EFI_MAGENTA 0x05
463#define EFI_BROWN 0x06
464#define EFI_LIGHTGRAY 0x07
465#define EFI_BRIGHT 0x08
466#define EFI_DARKGRAY 0x08
467#define EFI_LIGHTBLUE 0x09
468#define EFI_LIGHTGREEN 0x0a
469#define EFI_LIGHTCYAN 0x0b
470#define EFI_LIGHTRED 0x0c
471#define EFI_LIGHTMAGENTA 0x0d
472#define EFI_YELLOW 0x0e
473#define EFI_WHITE 0x0f
474#define EFI_BACKGROUND_BLACK 0x00
475#define EFI_BACKGROUND_BLUE 0x10
476#define EFI_BACKGROUND_GREEN 0x20
477#define EFI_BACKGROUND_CYAN 0x30
478#define EFI_BACKGROUND_RED 0x40
479#define EFI_BACKGROUND_MAGENTA 0x50
480#define EFI_BACKGROUND_BROWN 0x60
481#define EFI_BACKGROUND_LIGHTGRAY 0x70
482
483/* extract foreground color from EFI attribute */
484#define EFI_ATTR_FG(attr) ((attr) & 0x07)
485/* treat high bit of FG as bright/bold (similar to edk2) */
486#define EFI_ATTR_BOLD(attr) (((attr) >> 3) & 0x01)
487/* extract background color from EFI attribute */
488#define EFI_ATTR_BG(attr) (((attr) >> 4) & 0x7)
489
Simon Glass867a6ac2015-07-31 09:31:36 -0600490struct efi_simple_text_output_protocol {
491 void *reset;
492 efi_status_t (EFIAPI *output_string)(
493 struct efi_simple_text_output_protocol *this,
Rob Clark3a45bc72017-09-13 18:05:44 -0400494 const efi_string_t str);
Alexander Graf2bb9b792016-03-04 01:09:57 +0100495 efi_status_t (EFIAPI *test_string)(
496 struct efi_simple_text_output_protocol *this,
Rob Clark3a45bc72017-09-13 18:05:44 -0400497 const efi_string_t str);
Simon Glass867a6ac2015-07-31 09:31:36 -0600498 efi_status_t(EFIAPI *query_mode)(
499 struct efi_simple_text_output_protocol *this,
500 unsigned long mode_number, unsigned long *columns,
501 unsigned long *rows);
502 efi_status_t(EFIAPI *set_mode)(
503 struct efi_simple_text_output_protocol *this,
504 unsigned long mode_number);
505 efi_status_t(EFIAPI *set_attribute)(
506 struct efi_simple_text_output_protocol *this,
507 unsigned long attribute);
508 efi_status_t(EFIAPI *clear_screen) (
509 struct efi_simple_text_output_protocol *this);
510 efi_status_t(EFIAPI *set_cursor_position) (
511 struct efi_simple_text_output_protocol *this,
512 unsigned long column, unsigned long row);
Alexander Graf2bb9b792016-03-04 01:09:57 +0100513 efi_status_t(EFIAPI *enable_cursor)(
514 struct efi_simple_text_output_protocol *this,
515 bool enable);
Simon Glass867a6ac2015-07-31 09:31:36 -0600516 struct simple_text_output_mode *mode;
517};
518
519struct efi_input_key {
520 u16 scan_code;
521 s16 unicode_char;
522};
523
Rob Clarka17e62c2017-07-24 10:39:01 -0400524#define EFI_SIMPLE_TEXT_INPUT_PROTOCOL_GUID \
525 EFI_GUID(0x387477c1, 0x69c7, 0x11d2, \
526 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
527
Simon Glass867a6ac2015-07-31 09:31:36 -0600528struct efi_simple_input_interface {
529 efi_status_t(EFIAPI *reset)(struct efi_simple_input_interface *this,
530 bool ExtendedVerification);
531 efi_status_t(EFIAPI *read_key_stroke)(
532 struct efi_simple_input_interface *this,
533 struct efi_input_key *key);
xypron.glpk@gmx.de2fd945f2017-07-18 20:17:17 +0200534 struct efi_event *wait_for_key;
Simon Glass867a6ac2015-07-31 09:31:36 -0600535};
536
Alexander Graf2bb9b792016-03-04 01:09:57 +0100537#define CONSOLE_CONTROL_GUID \
538 EFI_GUID(0xf42f7782, 0x12e, 0x4c12, \
539 0x99, 0x56, 0x49, 0xf9, 0x43, 0x4, 0xf7, 0x21)
540#define EFI_CONSOLE_MODE_TEXT 0
541#define EFI_CONSOLE_MODE_GFX 1
542
543struct efi_console_control_protocol
544{
545 efi_status_t (EFIAPI *get_mode)(
546 struct efi_console_control_protocol *this, int *mode,
547 char *uga_exists, char *std_in_locked);
548 efi_status_t (EFIAPI *set_mode)(
549 struct efi_console_control_protocol *this, int mode);
550 efi_status_t (EFIAPI *lock_std_in)(
551 struct efi_console_control_protocol *this,
552 uint16_t *password);
553};
554
xypron.glpk@gmx.decc5b7082017-07-11 22:06:25 +0200555#define EFI_DEVICE_PATH_TO_TEXT_PROTOCOL_GUID \
556 EFI_GUID(0x8b843e20, 0x8132, 0x4852, \
557 0x90, 0xcc, 0x55, 0x1a, 0x4e, 0x4a, 0x7f, 0x1c)
558
xypron.glpk@gmx.decc5b7082017-07-11 22:06:25 +0200559struct efi_device_path_to_text_protocol
560{
561 uint16_t *(EFIAPI *convert_device_node_to_text)(
Rob Clark9309a1b2017-09-13 18:05:29 -0400562 struct efi_device_path *device_node,
xypron.glpk@gmx.decc5b7082017-07-11 22:06:25 +0200563 bool display_only,
564 bool allow_shortcuts);
565 uint16_t *(EFIAPI *convert_device_path_to_text)(
Rob Clark9309a1b2017-09-13 18:05:29 -0400566 struct efi_device_path *device_path,
xypron.glpk@gmx.decc5b7082017-07-11 22:06:25 +0200567 bool display_only,
568 bool allow_shortcuts);
569};
570
Alexander Grafbe8d3242016-03-15 18:38:21 +0100571#define EFI_GOP_GUID \
572 EFI_GUID(0x9042a9de, 0x23dc, 0x4a38, \
573 0x96, 0xfb, 0x7a, 0xde, 0xd0, 0x80, 0x51, 0x6a)
574
575#define EFI_GOT_RGBA8 0
576#define EFI_GOT_BGRA8 1
577#define EFI_GOT_BITMASK 2
578
579struct efi_gop_mode_info
580{
581 u32 version;
582 u32 width;
583 u32 height;
584 u32 pixel_format;
585 u32 pixel_bitmask[4];
586 u32 pixels_per_scanline;
587};
588
589struct efi_gop_mode
590{
591 u32 max_mode;
592 u32 mode;
593 struct efi_gop_mode_info *info;
594 unsigned long info_size;
595 efi_physical_addr_t fb_base;
596 unsigned long fb_size;
597};
598
599#define EFI_BLT_VIDEO_FILL 0
600#define EFI_BLT_VIDEO_TO_BLT_BUFFER 1
601#define EFI_BLT_BUFFER_TO_VIDEO 2
602#define EFI_BLT_VIDEO_TO_VIDEO 3
603
604struct efi_gop
605{
606 efi_status_t (EFIAPI *query_mode)(struct efi_gop *this, u32 mode_number,
Heinrich Schuchardt1c38a772017-10-26 19:25:51 +0200607 efi_uintn_t *size_of_info,
Alexander Grafbe8d3242016-03-15 18:38:21 +0100608 struct efi_gop_mode_info **info);
609 efi_status_t (EFIAPI *set_mode)(struct efi_gop *this, u32 mode_number);
610 efi_status_t (EFIAPI *blt)(struct efi_gop *this, void *buffer,
Heinrich Schuchardt1c38a772017-10-26 19:25:51 +0200611 u32 operation, efi_uintn_t sx,
612 efi_uintn_t sy, efi_uintn_t dx,
613 efi_uintn_t dy, efi_uintn_t width,
614 efi_uintn_t height, efi_uintn_t delta);
Alexander Grafbe8d3242016-03-15 18:38:21 +0100615 struct efi_gop_mode *mode;
616};
617
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200618#define EFI_SIMPLE_NETWORK_GUID \
619 EFI_GUID(0xa19832b9, 0xac25, 0x11d3, \
620 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
621
622struct efi_mac_address {
623 char mac_addr[32];
624};
625
626struct efi_ip_address {
627 u8 ip_addr[16];
628};
629
630enum efi_simple_network_state {
631 EFI_NETWORK_STOPPED,
632 EFI_NETWORK_STARTED,
633 EFI_NETWORK_INITIALIZED,
634};
635
636struct efi_simple_network_mode {
637 enum efi_simple_network_state state;
638 u32 hwaddr_size;
639 u32 media_header_size;
640 u32 max_packet_size;
641 u32 nvram_size;
642 u32 nvram_access_size;
643 u32 receive_filter_mask;
644 u32 receive_filter_setting;
645 u32 max_mcast_filter_count;
646 u32 mcast_filter_count;
647 struct efi_mac_address mcast_filter[16];
648 struct efi_mac_address current_address;
649 struct efi_mac_address broadcast_address;
650 struct efi_mac_address permanent_address;
651 u8 if_type;
652 u8 mac_changeable;
653 u8 multitx_supported;
654 u8 media_present_supported;
655 u8 media_present;
656};
657
Heinrich Schuchardt2e0864a2017-10-05 16:35:56 +0200658/* receive_filters bit mask */
659#define EFI_SIMPLE_NETWORK_RECEIVE_UNICAST 0x01
660#define EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST 0x02
661#define EFI_SIMPLE_NETWORK_RECEIVE_BROADCAST 0x04
662#define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS 0x08
663#define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS_MULTICAST 0x10
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200664
Heinrich Schuchardt891b3d92017-10-05 16:36:02 +0200665/* interrupt status bit mask */
666#define EFI_SIMPLE_NETWORK_RECEIVE_INTERRUPT 0x01
667#define EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT 0x02
668#define EFI_SIMPLE_NETWORK_COMMAND_INTERRUPT 0x04
669#define EFI_SIMPLE_NETWORK_SOFTWARE_INTERRUPT 0x08
670
Heinrich Schuchardtbdecf972017-10-05 16:35:57 +0200671/* revision of the simple network protocol */
672#define EFI_SIMPLE_NETWORK_PROTOCOL_REVISION 0x00010000
673
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200674struct efi_simple_network
675{
676 u64 revision;
677 efi_status_t (EFIAPI *start)(struct efi_simple_network *this);
678 efi_status_t (EFIAPI *stop)(struct efi_simple_network *this);
679 efi_status_t (EFIAPI *initialize)(struct efi_simple_network *this,
680 ulong extra_rx, ulong extra_tx);
681 efi_status_t (EFIAPI *reset)(struct efi_simple_network *this,
682 int extended_verification);
683 efi_status_t (EFIAPI *shutdown)(struct efi_simple_network *this);
684 efi_status_t (EFIAPI *receive_filters)(struct efi_simple_network *this,
685 u32 enable, u32 disable, int reset_mcast_filter,
686 ulong mcast_filter_count,
687 struct efi_mac_address *mcast_filter);
688 efi_status_t (EFIAPI *station_address)(struct efi_simple_network *this,
689 int reset, struct efi_mac_address *new_mac);
690 efi_status_t (EFIAPI *statistics)(struct efi_simple_network *this,
691 int reset, ulong *stat_size, void *stat_table);
692 efi_status_t (EFIAPI *mcastiptomac)(struct efi_simple_network *this,
693 int ipv6, struct efi_ip_address *ip,
694 struct efi_mac_address *mac);
695 efi_status_t (EFIAPI *nvdata)(struct efi_simple_network *this,
696 int read_write, ulong offset, ulong buffer_size,
697 char *buffer);
698 efi_status_t (EFIAPI *get_status)(struct efi_simple_network *this,
699 u32 *int_status, void **txbuf);
700 efi_status_t (EFIAPI *transmit)(struct efi_simple_network *this,
Heinrich Schuchardt8db174d2017-10-05 16:36:03 +0200701 size_t header_size, size_t buffer_size, void *buffer,
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200702 struct efi_mac_address *src_addr,
703 struct efi_mac_address *dest_addr, u16 *protocol);
704 efi_status_t (EFIAPI *receive)(struct efi_simple_network *this,
Heinrich Schuchardt8db174d2017-10-05 16:36:03 +0200705 size_t *header_size, size_t *buffer_size, void *buffer,
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200706 struct efi_mac_address *src_addr,
707 struct efi_mac_address *dest_addr, u16 *protocol);
Heinrich Schuchardt84a12ce2017-10-05 16:35:55 +0200708 struct efi_event *wait_for_packet;
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200709 struct efi_simple_network_mode *mode;
710};
711
712#define EFI_PXE_GUID \
713 EFI_GUID(0x03c4e603, 0xac28, 0x11d3, \
714 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
715
716struct efi_pxe_packet {
717 u8 packet[1472];
718};
719
720struct efi_pxe_mode
721{
722 u8 unused[52];
723 struct efi_pxe_packet dhcp_discover;
724 struct efi_pxe_packet dhcp_ack;
725 struct efi_pxe_packet proxy_offer;
726 struct efi_pxe_packet pxe_discover;
727 struct efi_pxe_packet pxe_reply;
728};
729
730struct efi_pxe {
731 u64 rev;
732 void (EFIAPI *start)(void);
733 void (EFIAPI *stop)(void);
734 void (EFIAPI *dhcp)(void);
735 void (EFIAPI *discover)(void);
736 void (EFIAPI *mftp)(void);
737 void (EFIAPI *udpwrite)(void);
738 void (EFIAPI *udpread)(void);
739 void (EFIAPI *setipfilter)(void);
740 void (EFIAPI *arp)(void);
741 void (EFIAPI *setparams)(void);
742 void (EFIAPI *setstationip)(void);
743 void (EFIAPI *setpackets)(void);
744 struct efi_pxe_mode *mode;
745};
746
Rob Clark2a920802017-09-13 18:05:34 -0400747#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \
748 EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \
749 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
750#define EFI_FILE_PROTOCOL_REVISION 0x00010000
751
752struct efi_file_handle {
753 u64 rev;
754 efi_status_t (EFIAPI *open)(struct efi_file_handle *file,
755 struct efi_file_handle **new_handle,
756 s16 *file_name, u64 open_mode, u64 attributes);
757 efi_status_t (EFIAPI *close)(struct efi_file_handle *file);
758 efi_status_t (EFIAPI *delete)(struct efi_file_handle *file);
759 efi_status_t (EFIAPI *read)(struct efi_file_handle *file,
760 u64 *buffer_size, void *buffer);
761 efi_status_t (EFIAPI *write)(struct efi_file_handle *file,
762 u64 *buffer_size, void *buffer);
763 efi_status_t (EFIAPI *getpos)(struct efi_file_handle *file,
764 u64 *pos);
765 efi_status_t (EFIAPI *setpos)(struct efi_file_handle *file,
766 u64 pos);
767 efi_status_t (EFIAPI *getinfo)(struct efi_file_handle *file,
768 efi_guid_t *info_type, u64 *buffer_size, void *buffer);
769 efi_status_t (EFIAPI *setinfo)(struct efi_file_handle *file,
770 efi_guid_t *info_type, u64 buffer_size, void *buffer);
771 efi_status_t (EFIAPI *flush)(struct efi_file_handle *file);
772};
773
774#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \
775 EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \
776 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
777#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION 0x00010000
778
779struct efi_simple_file_system_protocol {
780 u64 rev;
781 efi_status_t (EFIAPI *open_volume)(struct efi_simple_file_system_protocol *this,
782 struct efi_file_handle **root);
783};
784
785#define EFI_FILE_INFO_GUID \
786 EFI_GUID(0x9576e92, 0x6d3f, 0x11d2, \
787 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
788
789#define EFI_FILE_MODE_READ 0x0000000000000001
790#define EFI_FILE_MODE_WRITE 0x0000000000000002
791#define EFI_FILE_MODE_CREATE 0x8000000000000000
792
793#define EFI_FILE_READ_ONLY 0x0000000000000001
794#define EFI_FILE_HIDDEN 0x0000000000000002
795#define EFI_FILE_SYSTEM 0x0000000000000004
796#define EFI_FILE_RESERVED 0x0000000000000008
797#define EFI_FILE_DIRECTORY 0x0000000000000010
798#define EFI_FILE_ARCHIVE 0x0000000000000020
799#define EFI_FILE_VALID_ATTR 0x0000000000000037
800
801struct efi_file_info {
802 u64 size;
803 u64 file_size;
804 u64 physical_size;
805 struct efi_time create_time;
806 struct efi_time last_access_time;
807 struct efi_time modification_time;
808 u64 attribute;
809 s16 file_name[0];
810};
811
Heinrich Schuchardtf0959db2018-01-11 08:16:02 +0100812#define EFI_DRIVER_BINDING_PROTOCOL_GUID \
813 EFI_GUID(0x18a031ab, 0xb443, 0x4d1a,\
814 0xa5, 0xc0, 0x0c, 0x09, 0x26, 0x1e, 0x9f, 0x71)
815struct efi_driver_binding_protocol {
816 efi_status_t (EFIAPI * supported)(
817 struct efi_driver_binding_protocol *this,
818 efi_handle_t controller_handle,
819 struct efi_device_path *remaining_device_path);
820 efi_status_t (EFIAPI * start)(
821 struct efi_driver_binding_protocol *this,
822 efi_handle_t controller_handle,
823 struct efi_device_path *remaining_device_path);
824 efi_status_t (EFIAPI * stop)(
825 struct efi_driver_binding_protocol *this,
826 efi_handle_t controller_handle,
827 efi_uintn_t number_of_children,
828 efi_handle_t *child_handle_buffer);
829 u32 version;
830 efi_handle_t image_handle;
831 efi_handle_t driver_binding_handle;
832};
833
Simon Glass867a6ac2015-07-31 09:31:36 -0600834#endif