blob: 205f8f1f7007a1ab29d82e08864861632aea5fe3 [file] [log] [blame]
Simon Glass9539e692015-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 Graf988c0662016-05-20 23:28:23 +020020#ifdef CONFIG_EFI_LOADER
21#include <asm/setjmp.h>
22#endif
23
Alexander Graf3ad57b42016-03-04 01:09:57 +010024/* Types and defines for EFI CreateEvent */
xypron.glpk@gmx.de3ecc6bd2017-07-19 19:22:34 +020025enum efi_timer_delay {
Alexander Graf3ad57b42016-03-04 01:09:57 +010026 EFI_TIMER_STOP = 0,
27 EFI_TIMER_PERIODIC = 1,
28 EFI_TIMER_RELATIVE = 2
29};
30
Heinrich Schuchardtf8d4ec32017-11-06 21:17:47 +010031#define efi_uintn_t size_t
Rob Clark1ef185d2017-09-13 18:05:44 -040032typedef uint16_t *efi_string_t;
xypron.glpk@gmx.de48df2092017-07-18 20:17:19 +020033
xypron.glpk@gmx.de30708232017-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 Gray00cfc6a2017-03-12 19:26:06 +110045
xypron.glpk@gmx.decdbf3ac2017-07-18 20:17:17 +020046struct efi_event;
47
Simon Glass9539e692015-07-31 09:31:36 -060048/* EFI Boot Services table */
49struct efi_boot_services {
50 struct efi_table_hdr hdr;
Heinrich Schuchardtf8d4ec32017-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 Glass9539e692015-07-31 09:31:36 -060053
Heinrich Schuchardt798a4412017-11-06 21:17:48 +010054 efi_status_t (EFIAPI *allocate_pages)(int, int, efi_uintn_t,
Simon Glass9539e692015-07-31 09:31:36 -060055 efi_physical_addr_t *);
Heinrich Schuchardt798a4412017-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 Glass9539e692015-07-31 09:31:36 -060063 efi_status_t (EFIAPI *free_pool)(void *);
64
xypron.glpk@gmx.de3ecc6bd2017-07-19 19:22:34 +020065 efi_status_t (EFIAPI *create_event)(uint32_t type,
Heinrich Schuchardtf8d4ec32017-11-06 21:17:47 +010066 efi_uintn_t notify_tpl,
xypron.glpk@gmx.decdbf3ac2017-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.de3ecc6bd2017-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 Schuchardt798a4412017-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.decdbf3ac2017-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.de0581fa82017-07-11 22:06:16 +020080#define EFI_NATIVE_INTERFACE 0x00000000
Alexander Graf3ad57b42016-03-04 01:09:57 +010081 efi_status_t (EFIAPI *install_protocol_interface)(
Heinrich Schuchardte547c662017-10-05 16:35:53 +020082 void **handle, const efi_guid_t *protocol,
Alexander Graf3ad57b42016-03-04 01:09:57 +010083 int protocol_interface_type, void *protocol_interface);
84 efi_status_t (EFIAPI *reinstall_protocol_interface)(
Heinrich Schuchardte547c662017-10-05 16:35:53 +020085 void *handle, const efi_guid_t *protocol,
Alexander Graf3ad57b42016-03-04 01:09:57 +010086 void *old_interface, void *new_interface);
Heinrich Schuchardtb7cb8b42018-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 Glass9539e692015-07-31 09:31:36 -060093 void *reserved;
Alexander Graf3ad57b42016-03-04 01:09:57 +010094 efi_status_t (EFIAPI *register_protocol_notify)(
Heinrich Schuchardte547c662017-10-05 16:35:53 +020095 const efi_guid_t *protocol, struct efi_event *event,
Alexander Graf3ad57b42016-03-04 01:09:57 +010096 void **registration);
Simon Glass9539e692015-07-31 09:31:36 -060097 efi_status_t (EFIAPI *locate_handle)(
98 enum efi_locate_search_type search_type,
Heinrich Schuchardte547c662017-10-05 16:35:53 +020099 const efi_guid_t *protocol, void *search_key,
Heinrich Schuchardt798a4412017-11-06 21:17:48 +0100100 efi_uintn_t *buffer_size, efi_handle_t *buffer);
Heinrich Schuchardte547c662017-10-05 16:35:53 +0200101 efi_status_t (EFIAPI *locate_device_path)(const efi_guid_t *protocol,
Simon Glass9539e692015-07-31 09:31:36 -0600102 struct efi_device_path **device_path,
103 efi_handle_t *device);
Alexander Graf3ad57b42016-03-04 01:09:57 +0100104 efi_status_t (EFIAPI *install_configuration_table)(
105 efi_guid_t *guid, void *table);
Simon Glass9539e692015-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 Schuchardtb7cb8b42018-01-11 08:16:09 +0100117 efi_status_t (EFIAPI *unload_image)(efi_handle_t image_handle);
Simon Glass9539e692015-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 Graf3ad57b42016-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 Glass9539e692015-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 Schuchardt04840612018-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 Glass9539e692015-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 Schuchardte547c662017-10-05 16:35:53 +0200140 const efi_guid_t *protocol, void **interface,
Simon Glass9539e692015-07-31 09:31:36 -0600141 efi_handle_t agent_handle,
142 efi_handle_t controller_handle, u32 attributes);
Heinrich Schuchardtb7cb8b42018-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 Glass9539e692015-07-31 09:31:36 -0600147 efi_status_t(EFIAPI *open_protocol_information)(efi_handle_t handle,
Heinrich Schuchardte547c662017-10-05 16:35:53 +0200148 const efi_guid_t *protocol,
Simon Glass9539e692015-07-31 09:31:36 -0600149 struct efi_open_protocol_info_entry **entry_buffer,
Heinrich Schuchardt798a4412017-11-06 21:17:48 +0100150 efi_uintn_t *entry_count);
Simon Glass9539e692015-07-31 09:31:36 -0600151 efi_status_t (EFIAPI *protocols_per_handle)(efi_handle_t handle,
152 efi_guid_t ***protocol_buffer,
Heinrich Schuchardt798a4412017-11-06 21:17:48 +0100153 efi_uintn_t *protocols_buffer_count);
Simon Glass9539e692015-07-31 09:31:36 -0600154 efi_status_t (EFIAPI *locate_handle_buffer) (
155 enum efi_locate_search_type search_type,
Heinrich Schuchardte547c662017-10-05 16:35:53 +0200156 const efi_guid_t *protocol, void *search_key,
Heinrich Schuchardt798a4412017-11-06 21:17:48 +0100157 efi_uintn_t *no_handles, efi_handle_t **buffer);
Heinrich Schuchardte547c662017-10-05 16:35:53 +0200158 efi_status_t (EFIAPI *locate_protocol)(const efi_guid_t *protocol,
Alexander Graf3ad57b42016-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 Schuchardtd0a349e2017-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 Glass9539e692015-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 Graf3ad57b42016-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 Glass9539e692015-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 Graf3ad57b42016-03-04 01:09:57 +0100207 efi_status_t (EFIAPI *get_next_high_mono_count)(
208 uint32_t *high_count);
Simon Glass9539e692015-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 Clarkc84c1102017-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 Glass9539e692015-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 Graf3ad57b42016-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 Graf66f96e12016-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 Graf3ad57b42016-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 Glass9539e692015-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;
Heinrich Schuchardtb1fbb212018-01-19 20:24:52 +0100250 efi_handle_t con_in_handle;
Simon Glass9539e692015-07-31 09:31:36 -0600251 struct efi_simple_input_interface *con_in;
Heinrich Schuchardtb1fbb212018-01-19 20:24:52 +0100252 efi_handle_t con_out_handle;
Simon Glass9539e692015-07-31 09:31:36 -0600253 struct efi_simple_text_output_protocol *con_out;
Heinrich Schuchardtb1fbb212018-01-19 20:24:52 +0100254 efi_handle_t stderr_handle;
Alexander Graf3ad57b42016-03-04 01:09:57 +0100255 struct efi_simple_text_output_protocol *std_err;
Simon Glass9539e692015-07-31 09:31:36 -0600256 struct efi_runtime_services *runtime;
257 struct efi_boot_services *boottime;
Heinrich Schuchardt798a4412017-11-06 21:17:48 +0100258 efi_uintn_t nr_tables;
Alexander Graf3ad57b42016-03-04 01:09:57 +0100259 struct efi_configuration_table *tables;
Simon Glass9539e692015-07-31 09:31:36 -0600260};
261
Alexander Graf3ad57b42016-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 Glass9539e692015-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 Graf988c0662016-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 Glass9539e692015-07-31 09:31:36 -0600286};
287
Alexander Graf3ad57b42016-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 Glass9539e692015-07-31 09:31:36 -0600295struct efi_device_path {
296 u8 type;
297 u8 sub_type;
298 u16 length;
Rob Clark88aab262017-09-13 18:05:26 -0400299} __packed;
Simon Glass9539e692015-07-31 09:31:36 -0600300
Oleksandr Tymoshenko5c861d42016-10-24 10:47:01 -0700301struct efi_mac_addr {
302 u8 addr[32];
Rob Clark88aab262017-09-13 18:05:26 -0400303} __packed;
Oleksandr Tymoshenko5c861d42016-10-24 10:47:01 -0700304
Peter Jones6d3ce762017-09-13 18:05:27 -0400305#define DEVICE_PATH_TYPE_HARDWARE_DEVICE 0x01
Rob Clark18ceba72017-10-10 08:23:06 -0400306# define DEVICE_PATH_SUB_TYPE_MEMORY 0x03
Peter Jones6d3ce762017-09-13 18:05:27 -0400307# define DEVICE_PATH_SUB_TYPE_VENDOR 0x04
308
Rob Clark18ceba72017-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 Jones6d3ce762017-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 Clark85dd7212017-09-13 18:05:30 -0400327#define EISA_PNP_NUM(ID) ((ID) >> 16)
Peter Jones6d3ce762017-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 Tymoshenko5c861d42016-10-24 10:47:01 -0700335#define DEVICE_PATH_TYPE_MESSAGING_DEVICE 0x03
Heinrich Schuchardte2dcb9a2017-12-11 12:56:44 +0100336# define DEVICE_PATH_SUB_TYPE_MSG_ATAPI 0x01
337# define DEVICE_PATH_SUB_TYPE_MSG_SCSI 0x02
Peter Jones6d3ce762017-09-13 18:05:27 -0400338# define DEVICE_PATH_SUB_TYPE_MSG_USB 0x05
Oleksandr Tymoshenko5c861d42016-10-24 10:47:01 -0700339# define DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR 0x0b
Rob Clarkf90cb9f2017-09-13 18:05:28 -0400340# define DEVICE_PATH_SUB_TYPE_MSG_USB_CLASS 0x0f
Peter Jones6d3ce762017-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 Schuchardte2dcb9a2017-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 Jones6d3ce762017-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 Tymoshenko5c861d42016-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 Clark88aab262017-09-13 18:05:26 -0400367} __packed;
Oleksandr Tymoshenko5c861d42016-10-24 10:47:01 -0700368
Rob Clarkf90cb9f2017-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 Jones6d3ce762017-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 Graf3ad57b42016-03-04 01:09:57 +0100383#define DEVICE_PATH_TYPE_MEDIA_DEVICE 0x04
Peter Jones6d3ce762017-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 Graf3ad57b42016-03-04 01:09:57 +0100386# define DEVICE_PATH_SUB_TYPE_FILE_PATH 0x04
387
Peter Jones6d3ce762017-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 Graf3ad57b42016-03-04 01:09:57 +0100405struct efi_device_path_file_path {
406 struct efi_device_path dp;
Rob Clark325ea8b2017-09-13 18:05:39 -0400407 u16 str[];
Rob Clark88aab262017-09-13 18:05:26 -0400408} __packed;
Alexander Graf3ad57b42016-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;
Heinrich Schuchardt0844f792018-01-19 20:24:48 +0100427 /* Added in revision 2 of the protocol */
428 u64 lowest_aligned_lba;
429 u32 logical_blocks_per_physical_block;
430 /* Added in revision 3 of the protocol */
431 u32 optimal_transfer_length_granualarity;
Alexander Graf3ad57b42016-03-04 01:09:57 +0100432};
433
Heinrich Schuchardt0844f792018-01-19 20:24:48 +0100434#define EFI_BLOCK_IO_PROTOCOL_REVISION2 0x00020001
435#define EFI_BLOCK_IO_PROTOCOL_REVISION3 0x0002001f
436
Alexander Graf3ad57b42016-03-04 01:09:57 +0100437struct efi_block_io {
438 u64 revision;
439 struct efi_block_io_media *media;
440 efi_status_t (EFIAPI *reset)(struct efi_block_io *this,
441 char extended_verification);
442 efi_status_t (EFIAPI *read_blocks)(struct efi_block_io *this,
Heinrich Schuchardt0844f792018-01-19 20:24:48 +0100443 u32 media_id, u64 lba, efi_uintn_t buffer_size,
Alexander Graf3ad57b42016-03-04 01:09:57 +0100444 void *buffer);
445 efi_status_t (EFIAPI *write_blocks)(struct efi_block_io *this,
Heinrich Schuchardt0844f792018-01-19 20:24:48 +0100446 u32 media_id, u64 lba, efi_uintn_t buffer_size,
Alexander Graf3ad57b42016-03-04 01:09:57 +0100447 void *buffer);
448 efi_status_t (EFIAPI *flush_blocks)(struct efi_block_io *this);
449};
450
Simon Glass9539e692015-07-31 09:31:36 -0600451struct simple_text_output_mode {
452 s32 max_mode;
453 s32 mode;
454 s32 attribute;
455 s32 cursor_column;
456 s32 cursor_row;
457 bool cursor_visible;
458};
459
Rob Clark49f7b4b2017-07-24 10:39:01 -0400460
461#define EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL_GUID \
462 EFI_GUID(0x387477c2, 0x69c7, 0x11d2, \
463 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
464
Rob Clark87ef0012017-10-10 08:23:01 -0400465#define EFI_BLACK 0x00
466#define EFI_BLUE 0x01
467#define EFI_GREEN 0x02
468#define EFI_CYAN 0x03
469#define EFI_RED 0x04
470#define EFI_MAGENTA 0x05
471#define EFI_BROWN 0x06
472#define EFI_LIGHTGRAY 0x07
473#define EFI_BRIGHT 0x08
474#define EFI_DARKGRAY 0x08
475#define EFI_LIGHTBLUE 0x09
476#define EFI_LIGHTGREEN 0x0a
477#define EFI_LIGHTCYAN 0x0b
478#define EFI_LIGHTRED 0x0c
479#define EFI_LIGHTMAGENTA 0x0d
480#define EFI_YELLOW 0x0e
481#define EFI_WHITE 0x0f
482#define EFI_BACKGROUND_BLACK 0x00
483#define EFI_BACKGROUND_BLUE 0x10
484#define EFI_BACKGROUND_GREEN 0x20
485#define EFI_BACKGROUND_CYAN 0x30
486#define EFI_BACKGROUND_RED 0x40
487#define EFI_BACKGROUND_MAGENTA 0x50
488#define EFI_BACKGROUND_BROWN 0x60
489#define EFI_BACKGROUND_LIGHTGRAY 0x70
490
491/* extract foreground color from EFI attribute */
492#define EFI_ATTR_FG(attr) ((attr) & 0x07)
493/* treat high bit of FG as bright/bold (similar to edk2) */
494#define EFI_ATTR_BOLD(attr) (((attr) >> 3) & 0x01)
495/* extract background color from EFI attribute */
496#define EFI_ATTR_BG(attr) (((attr) >> 4) & 0x7)
497
Simon Glass9539e692015-07-31 09:31:36 -0600498struct efi_simple_text_output_protocol {
499 void *reset;
500 efi_status_t (EFIAPI *output_string)(
501 struct efi_simple_text_output_protocol *this,
Rob Clark1ef185d2017-09-13 18:05:44 -0400502 const efi_string_t str);
Alexander Graf3ad57b42016-03-04 01:09:57 +0100503 efi_status_t (EFIAPI *test_string)(
504 struct efi_simple_text_output_protocol *this,
Rob Clark1ef185d2017-09-13 18:05:44 -0400505 const efi_string_t str);
Simon Glass9539e692015-07-31 09:31:36 -0600506 efi_status_t(EFIAPI *query_mode)(
507 struct efi_simple_text_output_protocol *this,
508 unsigned long mode_number, unsigned long *columns,
509 unsigned long *rows);
510 efi_status_t(EFIAPI *set_mode)(
511 struct efi_simple_text_output_protocol *this,
512 unsigned long mode_number);
513 efi_status_t(EFIAPI *set_attribute)(
514 struct efi_simple_text_output_protocol *this,
515 unsigned long attribute);
516 efi_status_t(EFIAPI *clear_screen) (
517 struct efi_simple_text_output_protocol *this);
518 efi_status_t(EFIAPI *set_cursor_position) (
519 struct efi_simple_text_output_protocol *this,
520 unsigned long column, unsigned long row);
Alexander Graf3ad57b42016-03-04 01:09:57 +0100521 efi_status_t(EFIAPI *enable_cursor)(
522 struct efi_simple_text_output_protocol *this,
523 bool enable);
Simon Glass9539e692015-07-31 09:31:36 -0600524 struct simple_text_output_mode *mode;
525};
526
527struct efi_input_key {
528 u16 scan_code;
529 s16 unicode_char;
530};
531
Rob Clark49f7b4b2017-07-24 10:39:01 -0400532#define EFI_SIMPLE_TEXT_INPUT_PROTOCOL_GUID \
533 EFI_GUID(0x387477c1, 0x69c7, 0x11d2, \
534 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
535
Simon Glass9539e692015-07-31 09:31:36 -0600536struct efi_simple_input_interface {
537 efi_status_t(EFIAPI *reset)(struct efi_simple_input_interface *this,
538 bool ExtendedVerification);
539 efi_status_t(EFIAPI *read_key_stroke)(
540 struct efi_simple_input_interface *this,
541 struct efi_input_key *key);
xypron.glpk@gmx.decdbf3ac2017-07-18 20:17:17 +0200542 struct efi_event *wait_for_key;
Simon Glass9539e692015-07-31 09:31:36 -0600543};
544
Alexander Graf3ad57b42016-03-04 01:09:57 +0100545#define CONSOLE_CONTROL_GUID \
546 EFI_GUID(0xf42f7782, 0x12e, 0x4c12, \
547 0x99, 0x56, 0x49, 0xf9, 0x43, 0x4, 0xf7, 0x21)
548#define EFI_CONSOLE_MODE_TEXT 0
549#define EFI_CONSOLE_MODE_GFX 1
550
551struct efi_console_control_protocol
552{
553 efi_status_t (EFIAPI *get_mode)(
554 struct efi_console_control_protocol *this, int *mode,
555 char *uga_exists, char *std_in_locked);
556 efi_status_t (EFIAPI *set_mode)(
557 struct efi_console_control_protocol *this, int mode);
558 efi_status_t (EFIAPI *lock_std_in)(
559 struct efi_console_control_protocol *this,
560 uint16_t *password);
561};
562
xypron.glpk@gmx.de3c042b22017-07-11 22:06:25 +0200563#define EFI_DEVICE_PATH_TO_TEXT_PROTOCOL_GUID \
564 EFI_GUID(0x8b843e20, 0x8132, 0x4852, \
565 0x90, 0xcc, 0x55, 0x1a, 0x4e, 0x4a, 0x7f, 0x1c)
566
xypron.glpk@gmx.de3c042b22017-07-11 22:06:25 +0200567struct efi_device_path_to_text_protocol
568{
569 uint16_t *(EFIAPI *convert_device_node_to_text)(
Rob Clark18e73d32017-09-13 18:05:29 -0400570 struct efi_device_path *device_node,
xypron.glpk@gmx.de3c042b22017-07-11 22:06:25 +0200571 bool display_only,
572 bool allow_shortcuts);
573 uint16_t *(EFIAPI *convert_device_path_to_text)(
Rob Clark18e73d32017-09-13 18:05:29 -0400574 struct efi_device_path *device_path,
xypron.glpk@gmx.de3c042b22017-07-11 22:06:25 +0200575 bool display_only,
576 bool allow_shortcuts);
577};
578
Alexander Grafd65783d2016-03-15 18:38:21 +0100579#define EFI_GOP_GUID \
580 EFI_GUID(0x9042a9de, 0x23dc, 0x4a38, \
581 0x96, 0xfb, 0x7a, 0xde, 0xd0, 0x80, 0x51, 0x6a)
582
583#define EFI_GOT_RGBA8 0
584#define EFI_GOT_BGRA8 1
585#define EFI_GOT_BITMASK 2
586
587struct efi_gop_mode_info
588{
589 u32 version;
590 u32 width;
591 u32 height;
592 u32 pixel_format;
593 u32 pixel_bitmask[4];
594 u32 pixels_per_scanline;
595};
596
597struct efi_gop_mode
598{
599 u32 max_mode;
600 u32 mode;
601 struct efi_gop_mode_info *info;
602 unsigned long info_size;
603 efi_physical_addr_t fb_base;
604 unsigned long fb_size;
605};
606
607#define EFI_BLT_VIDEO_FILL 0
608#define EFI_BLT_VIDEO_TO_BLT_BUFFER 1
609#define EFI_BLT_BUFFER_TO_VIDEO 2
610#define EFI_BLT_VIDEO_TO_VIDEO 3
611
612struct efi_gop
613{
614 efi_status_t (EFIAPI *query_mode)(struct efi_gop *this, u32 mode_number,
Heinrich Schuchardt8b28d5c2017-10-26 19:25:51 +0200615 efi_uintn_t *size_of_info,
Alexander Grafd65783d2016-03-15 18:38:21 +0100616 struct efi_gop_mode_info **info);
617 efi_status_t (EFIAPI *set_mode)(struct efi_gop *this, u32 mode_number);
618 efi_status_t (EFIAPI *blt)(struct efi_gop *this, void *buffer,
Heinrich Schuchardt8b28d5c2017-10-26 19:25:51 +0200619 u32 operation, efi_uintn_t sx,
620 efi_uintn_t sy, efi_uintn_t dx,
621 efi_uintn_t dy, efi_uintn_t width,
622 efi_uintn_t height, efi_uintn_t delta);
Alexander Grafd65783d2016-03-15 18:38:21 +0100623 struct efi_gop_mode *mode;
624};
625
Alexander Graf94c4b992016-05-06 21:01:01 +0200626#define EFI_SIMPLE_NETWORK_GUID \
627 EFI_GUID(0xa19832b9, 0xac25, 0x11d3, \
628 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
629
630struct efi_mac_address {
631 char mac_addr[32];
632};
633
634struct efi_ip_address {
635 u8 ip_addr[16];
636};
637
638enum efi_simple_network_state {
639 EFI_NETWORK_STOPPED,
640 EFI_NETWORK_STARTED,
641 EFI_NETWORK_INITIALIZED,
642};
643
644struct efi_simple_network_mode {
645 enum efi_simple_network_state state;
646 u32 hwaddr_size;
647 u32 media_header_size;
648 u32 max_packet_size;
649 u32 nvram_size;
650 u32 nvram_access_size;
651 u32 receive_filter_mask;
652 u32 receive_filter_setting;
653 u32 max_mcast_filter_count;
654 u32 mcast_filter_count;
655 struct efi_mac_address mcast_filter[16];
656 struct efi_mac_address current_address;
657 struct efi_mac_address broadcast_address;
658 struct efi_mac_address permanent_address;
659 u8 if_type;
660 u8 mac_changeable;
661 u8 multitx_supported;
662 u8 media_present_supported;
663 u8 media_present;
664};
665
Heinrich Schuchardt41372272017-10-05 16:35:56 +0200666/* receive_filters bit mask */
667#define EFI_SIMPLE_NETWORK_RECEIVE_UNICAST 0x01
668#define EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST 0x02
669#define EFI_SIMPLE_NETWORK_RECEIVE_BROADCAST 0x04
670#define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS 0x08
671#define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS_MULTICAST 0x10
Alexander Graf94c4b992016-05-06 21:01:01 +0200672
Heinrich Schuchardte371c5f2017-10-05 16:36:02 +0200673/* interrupt status bit mask */
674#define EFI_SIMPLE_NETWORK_RECEIVE_INTERRUPT 0x01
675#define EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT 0x02
676#define EFI_SIMPLE_NETWORK_COMMAND_INTERRUPT 0x04
677#define EFI_SIMPLE_NETWORK_SOFTWARE_INTERRUPT 0x08
678
Heinrich Schuchardtd54396a2017-10-05 16:35:57 +0200679/* revision of the simple network protocol */
680#define EFI_SIMPLE_NETWORK_PROTOCOL_REVISION 0x00010000
681
Alexander Graf94c4b992016-05-06 21:01:01 +0200682struct efi_simple_network
683{
684 u64 revision;
685 efi_status_t (EFIAPI *start)(struct efi_simple_network *this);
686 efi_status_t (EFIAPI *stop)(struct efi_simple_network *this);
687 efi_status_t (EFIAPI *initialize)(struct efi_simple_network *this,
688 ulong extra_rx, ulong extra_tx);
689 efi_status_t (EFIAPI *reset)(struct efi_simple_network *this,
690 int extended_verification);
691 efi_status_t (EFIAPI *shutdown)(struct efi_simple_network *this);
692 efi_status_t (EFIAPI *receive_filters)(struct efi_simple_network *this,
693 u32 enable, u32 disable, int reset_mcast_filter,
694 ulong mcast_filter_count,
695 struct efi_mac_address *mcast_filter);
696 efi_status_t (EFIAPI *station_address)(struct efi_simple_network *this,
697 int reset, struct efi_mac_address *new_mac);
698 efi_status_t (EFIAPI *statistics)(struct efi_simple_network *this,
699 int reset, ulong *stat_size, void *stat_table);
700 efi_status_t (EFIAPI *mcastiptomac)(struct efi_simple_network *this,
701 int ipv6, struct efi_ip_address *ip,
702 struct efi_mac_address *mac);
703 efi_status_t (EFIAPI *nvdata)(struct efi_simple_network *this,
704 int read_write, ulong offset, ulong buffer_size,
705 char *buffer);
706 efi_status_t (EFIAPI *get_status)(struct efi_simple_network *this,
707 u32 *int_status, void **txbuf);
708 efi_status_t (EFIAPI *transmit)(struct efi_simple_network *this,
Heinrich Schuchardtf66b2e32017-10-05 16:36:03 +0200709 size_t header_size, size_t buffer_size, void *buffer,
Alexander Graf94c4b992016-05-06 21:01:01 +0200710 struct efi_mac_address *src_addr,
711 struct efi_mac_address *dest_addr, u16 *protocol);
712 efi_status_t (EFIAPI *receive)(struct efi_simple_network *this,
Heinrich Schuchardtf66b2e32017-10-05 16:36:03 +0200713 size_t *header_size, size_t *buffer_size, void *buffer,
Alexander Graf94c4b992016-05-06 21:01:01 +0200714 struct efi_mac_address *src_addr,
715 struct efi_mac_address *dest_addr, u16 *protocol);
Heinrich Schuchardt530ba8a2017-10-05 16:35:55 +0200716 struct efi_event *wait_for_packet;
Alexander Graf94c4b992016-05-06 21:01:01 +0200717 struct efi_simple_network_mode *mode;
718};
719
720#define EFI_PXE_GUID \
721 EFI_GUID(0x03c4e603, 0xac28, 0x11d3, \
722 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d)
723
724struct efi_pxe_packet {
725 u8 packet[1472];
726};
727
728struct efi_pxe_mode
729{
730 u8 unused[52];
731 struct efi_pxe_packet dhcp_discover;
732 struct efi_pxe_packet dhcp_ack;
733 struct efi_pxe_packet proxy_offer;
734 struct efi_pxe_packet pxe_discover;
735 struct efi_pxe_packet pxe_reply;
736};
737
738struct efi_pxe {
739 u64 rev;
740 void (EFIAPI *start)(void);
741 void (EFIAPI *stop)(void);
742 void (EFIAPI *dhcp)(void);
743 void (EFIAPI *discover)(void);
744 void (EFIAPI *mftp)(void);
745 void (EFIAPI *udpwrite)(void);
746 void (EFIAPI *udpread)(void);
747 void (EFIAPI *setipfilter)(void);
748 void (EFIAPI *arp)(void);
749 void (EFIAPI *setparams)(void);
750 void (EFIAPI *setstationip)(void);
751 void (EFIAPI *setpackets)(void);
752 struct efi_pxe_mode *mode;
753};
754
Rob Clark53142032017-09-13 18:05:34 -0400755#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \
756 EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \
757 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
758#define EFI_FILE_PROTOCOL_REVISION 0x00010000
759
760struct efi_file_handle {
761 u64 rev;
762 efi_status_t (EFIAPI *open)(struct efi_file_handle *file,
763 struct efi_file_handle **new_handle,
764 s16 *file_name, u64 open_mode, u64 attributes);
765 efi_status_t (EFIAPI *close)(struct efi_file_handle *file);
766 efi_status_t (EFIAPI *delete)(struct efi_file_handle *file);
767 efi_status_t (EFIAPI *read)(struct efi_file_handle *file,
768 u64 *buffer_size, void *buffer);
769 efi_status_t (EFIAPI *write)(struct efi_file_handle *file,
770 u64 *buffer_size, void *buffer);
771 efi_status_t (EFIAPI *getpos)(struct efi_file_handle *file,
772 u64 *pos);
773 efi_status_t (EFIAPI *setpos)(struct efi_file_handle *file,
774 u64 pos);
775 efi_status_t (EFIAPI *getinfo)(struct efi_file_handle *file,
776 efi_guid_t *info_type, u64 *buffer_size, void *buffer);
777 efi_status_t (EFIAPI *setinfo)(struct efi_file_handle *file,
778 efi_guid_t *info_type, u64 buffer_size, void *buffer);
779 efi_status_t (EFIAPI *flush)(struct efi_file_handle *file);
780};
781
782#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \
783 EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \
784 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
785#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION 0x00010000
786
787struct efi_simple_file_system_protocol {
788 u64 rev;
789 efi_status_t (EFIAPI *open_volume)(struct efi_simple_file_system_protocol *this,
790 struct efi_file_handle **root);
791};
792
793#define EFI_FILE_INFO_GUID \
794 EFI_GUID(0x9576e92, 0x6d3f, 0x11d2, \
795 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b)
796
797#define EFI_FILE_MODE_READ 0x0000000000000001
798#define EFI_FILE_MODE_WRITE 0x0000000000000002
799#define EFI_FILE_MODE_CREATE 0x8000000000000000
800
801#define EFI_FILE_READ_ONLY 0x0000000000000001
802#define EFI_FILE_HIDDEN 0x0000000000000002
803#define EFI_FILE_SYSTEM 0x0000000000000004
804#define EFI_FILE_RESERVED 0x0000000000000008
805#define EFI_FILE_DIRECTORY 0x0000000000000010
806#define EFI_FILE_ARCHIVE 0x0000000000000020
807#define EFI_FILE_VALID_ATTR 0x0000000000000037
808
809struct efi_file_info {
810 u64 size;
811 u64 file_size;
812 u64 physical_size;
813 struct efi_time create_time;
814 struct efi_time last_access_time;
815 struct efi_time modification_time;
816 u64 attribute;
817 s16 file_name[0];
818};
819
Heinrich Schuchardt760255f2018-01-11 08:16:02 +0100820#define EFI_DRIVER_BINDING_PROTOCOL_GUID \
821 EFI_GUID(0x18a031ab, 0xb443, 0x4d1a,\
822 0xa5, 0xc0, 0x0c, 0x09, 0x26, 0x1e, 0x9f, 0x71)
823struct efi_driver_binding_protocol {
824 efi_status_t (EFIAPI * supported)(
825 struct efi_driver_binding_protocol *this,
826 efi_handle_t controller_handle,
827 struct efi_device_path *remaining_device_path);
828 efi_status_t (EFIAPI * start)(
829 struct efi_driver_binding_protocol *this,
830 efi_handle_t controller_handle,
831 struct efi_device_path *remaining_device_path);
832 efi_status_t (EFIAPI * stop)(
833 struct efi_driver_binding_protocol *this,
834 efi_handle_t controller_handle,
835 efi_uintn_t number_of_children,
836 efi_handle_t *child_handle_buffer);
837 u32 version;
838 efi_handle_t image_handle;
839 efi_handle_t driver_binding_handle;
840};
841
Simon Glass9539e692015-07-31 09:31:36 -0600842#endif