blob: 2868ca25abb493d3ec5e867591eb65e9811c0ad4 [file] [log] [blame]
Tom Rinif739fcd2018-05-07 17:02:21 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Alexander Grafcb149c62016-03-04 01:09:58 +01002/*
3 * EFI application loader
4 *
5 * Copyright (c) 2016 Alexander Graf
Alexander Grafcb149c62016-03-04 01:09:58 +01006 */
7
Heinrich Schuchardtcd9e18d2017-10-18 18:13:07 +02008#ifndef _EFI_LOADER_H
9#define _EFI_LOADER_H 1
10
Alexander Grafbee91162016-03-04 01:09:59 +010011#include <common.h>
Alexander Grafcb149c62016-03-04 01:09:58 +010012#include <part_efi.h>
13#include <efi_api.h>
Alexander Grafbee91162016-03-04 01:09:59 +010014
15/* No need for efi loader support in SPL */
16#if defined(CONFIG_EFI_LOADER) && !defined(CONFIG_SPL_BUILD)
17
Alexander Grafcb149c62016-03-04 01:09:58 +010018#include <linux/list.h>
19
Rob Clarkc160d2f2017-07-27 08:04:18 -040020int __efi_entry_check(void);
21int __efi_exit_check(void);
Heinrich Schuchardtae0bd3a2017-08-18 17:45:16 +020022const char *__efi_nesting(void);
Rob Clarkaf65db82017-07-27 08:04:19 -040023const char *__efi_nesting_inc(void);
24const char *__efi_nesting_dec(void);
Rob Clarkc160d2f2017-07-27 08:04:18 -040025
Rob Clarka095aad2017-07-27 08:04:17 -040026/*
27 * Enter the u-boot world from UEFI:
28 */
Alexander Grafbee91162016-03-04 01:09:59 +010029#define EFI_ENTRY(format, ...) do { \
Rob Clarkc160d2f2017-07-27 08:04:18 -040030 assert(__efi_entry_check()); \
Rob Clarkaf65db82017-07-27 08:04:19 -040031 debug("%sEFI: Entry %s(" format ")\n", __efi_nesting_inc(), \
32 __func__, ##__VA_ARGS__); \
Alexander Grafbee91162016-03-04 01:09:59 +010033 } while(0)
Alexander Grafbee91162016-03-04 01:09:59 +010034
Rob Clarka095aad2017-07-27 08:04:17 -040035/*
36 * Exit the u-boot world back to UEFI:
37 */
Rob Clark804b1d72017-07-24 10:31:52 -040038#define EFI_EXIT(ret) ({ \
xypron.glpk@gmx.dec81883d2017-08-17 18:57:36 +020039 typeof(ret) _r = ret; \
Rob Clarkaf65db82017-07-27 08:04:19 -040040 debug("%sEFI: Exit: %s: %u\n", __efi_nesting_dec(), \
xypron.glpk@gmx.dec81883d2017-08-17 18:57:36 +020041 __func__, (u32)((uintptr_t) _r & ~EFI_ERROR_MASK)); \
Rob Clarkc160d2f2017-07-27 08:04:18 -040042 assert(__efi_exit_check()); \
43 _r; \
Rob Clark804b1d72017-07-24 10:31:52 -040044 })
Alexander Grafbee91162016-03-04 01:09:59 +010045
Rob Clarka095aad2017-07-27 08:04:17 -040046/*
Heinrich Schuchardtea630ce2017-09-15 10:06:10 +020047 * Call non-void UEFI function from u-boot and retrieve return value:
Rob Clarka095aad2017-07-27 08:04:17 -040048 */
Heinrich Schuchardtea630ce2017-09-15 10:06:10 +020049#define EFI_CALL(exp) ({ \
50 debug("%sEFI: Call: %s\n", __efi_nesting_inc(), #exp); \
51 assert(__efi_exit_check()); \
52 typeof(exp) _r = exp; \
53 assert(__efi_entry_check()); \
54 debug("%sEFI: %lu returned by %s\n", __efi_nesting_dec(), \
55 (unsigned long)((uintptr_t)_r & ~EFI_ERROR_MASK), #exp); \
56 _r; \
57})
58
59/*
60 * Call void UEFI function from u-boot:
61 */
62#define EFI_CALL_VOID(exp) do { \
Rob Clarkaf65db82017-07-27 08:04:19 -040063 debug("%sEFI: Call: %s\n", __efi_nesting_inc(), #exp); \
Rob Clarkc160d2f2017-07-27 08:04:18 -040064 assert(__efi_exit_check()); \
Rob Clarka095aad2017-07-27 08:04:17 -040065 exp; \
Rob Clarkc160d2f2017-07-27 08:04:18 -040066 assert(__efi_entry_check()); \
Rob Clarkaf65db82017-07-27 08:04:19 -040067 debug("%sEFI: Return From: %s\n", __efi_nesting_dec(), #exp); \
Rob Clarka095aad2017-07-27 08:04:17 -040068 } while(0)
69
Heinrich Schuchardtae0bd3a2017-08-18 17:45:16 +020070/*
Heinrich Schuchardtd5504142018-01-11 08:16:01 +010071 * Write an indented message with EFI prefix
Heinrich Schuchardtae0bd3a2017-08-18 17:45:16 +020072 */
Heinrich Schuchardtd5504142018-01-11 08:16:01 +010073#define EFI_PRINT(format, ...) ({ \
74 debug("%sEFI: " format, __efi_nesting(), \
75 ##__VA_ARGS__); \
Heinrich Schuchardtae0bd3a2017-08-18 17:45:16 +020076 })
77
Alexander Graf50149ea2016-03-04 01:10:01 +010078extern struct efi_runtime_services efi_runtime_services;
Alexander Grafbee91162016-03-04 01:09:59 +010079extern struct efi_system_table systab;
80
Heinrich Schuchardtebb4dd52017-10-26 19:25:59 +020081extern struct efi_simple_text_output_protocol efi_con_out;
xypron.glpk@gmx.de91be9a72017-07-18 20:17:22 +020082extern struct efi_simple_input_interface efi_con_in;
Heinrich Schuchardtebb4dd52017-10-26 19:25:59 +020083extern struct efi_console_control_protocol efi_console_control;
xypron.glpk@gmx.decc5b7082017-07-11 22:06:25 +020084extern const struct efi_device_path_to_text_protocol efi_device_path_to_text;
Leif Lindholme70f8df2018-03-09 17:43:21 +010085/* implementation of the EFI_DEVICE_PATH_UTILITIES_PROTOCOL */
86extern const struct efi_device_path_utilities_protocol
87 efi_device_path_utilities;
Alexander Grafc1311ad2016-03-04 01:10:00 +010088
Rob Clarkadae4312017-09-13 18:05:30 -040089uint16_t *efi_dp_str(struct efi_device_path *dp);
90
Heinrich Schuchardtb3dd14b2018-01-19 20:24:45 +010091/* GUID of the EFI_BLOCK_IO_PROTOCOL */
92extern const efi_guid_t efi_block_io_guid;
Rob Clark9975fe92017-09-13 18:05:38 -040093extern const efi_guid_t efi_global_variable_guid;
Alexander Grafc1311ad2016-03-04 01:10:00 +010094extern const efi_guid_t efi_guid_console_control;
Alexander Grafcb149c62016-03-04 01:09:58 +010095extern const efi_guid_t efi_guid_device_path;
Heinrich Schuchardtf0959db2018-01-11 08:16:02 +010096/* GUID of the EFI_DRIVER_BINDING_PROTOCOL */
97extern const efi_guid_t efi_guid_driver_binding_protocol;
Heinrich Schuchardta3a28f52018-02-18 15:17:51 +010098/* event group ExitBootServices() invoked */
99extern const efi_guid_t efi_guid_event_group_exit_boot_services;
100/* event group SetVirtualAddressMap() invoked */
101extern const efi_guid_t efi_guid_event_group_virtual_address_change;
102/* event group memory map changed */
103extern const efi_guid_t efi_guid_event_group_memory_map_change;
104/* event group boot manager about to boot */
105extern const efi_guid_t efi_guid_event_group_ready_to_boot;
106/* event group ResetSystem() invoked (before ExitBootServices) */
107extern const efi_guid_t efi_guid_event_group_reset_system;
Heinrich Schuchardtbc4f9132018-03-03 15:29:03 +0100108/* GUID of the device tree table */
109extern const efi_guid_t efi_guid_fdt;
Alexander Grafcb149c62016-03-04 01:09:58 +0100110extern const efi_guid_t efi_guid_loaded_image;
xypron.glpk@gmx.decc5b7082017-07-11 22:06:25 +0200111extern const efi_guid_t efi_guid_device_path_to_text_protocol;
Rob Clark2a920802017-09-13 18:05:34 -0400112extern const efi_guid_t efi_simple_file_system_protocol_guid;
113extern const efi_guid_t efi_file_info_guid;
Heinrich Schuchardt9e6835e2018-04-04 15:42:11 +0200114/* GUID for file system information */
115extern const efi_guid_t efi_file_system_info_guid;
Leif Lindholme70f8df2018-03-09 17:43:21 +0100116extern const efi_guid_t efi_guid_device_path_utilities_protocol;
Alexander Grafcb149c62016-03-04 01:09:58 +0100117
Alexander Graf50149ea2016-03-04 01:10:01 +0100118extern unsigned int __efi_runtime_start, __efi_runtime_stop;
119extern unsigned int __efi_runtime_rel_start, __efi_runtime_rel_stop;
120
Alexander Grafbee91162016-03-04 01:09:59 +0100121/*
Heinrich Schuchardtfe1599d2018-01-11 08:15:57 +0100122 * When a protocol is opened a open protocol info entry is created.
123 * These are maintained in a list.
124 */
125struct efi_open_protocol_info_item {
126 /* Link to the list of open protocol info entries of a protocol */
127 struct list_head link;
128 struct efi_open_protocol_info_entry info;
129};
130
131/*
Alexander Grafbee91162016-03-04 01:09:59 +0100132 * When the UEFI payload wants to open a protocol on an object to get its
133 * interface (usually a struct with callback functions), this struct maps the
Heinrich Schuchardtfe1599d2018-01-11 08:15:57 +0100134 * protocol GUID to the respective protocol interface
135 */
Alexander Grafbee91162016-03-04 01:09:59 +0100136struct efi_handler {
Heinrich Schuchardt69fb6b12017-11-26 14:05:17 +0100137 /* Link to the list of protocols of a handle */
138 struct list_head link;
Alexander Grafbee91162016-03-04 01:09:59 +0100139 const efi_guid_t *guid;
xypron.glpk@gmx.deb5349f72017-07-11 22:06:14 +0200140 void *protocol_interface;
Heinrich Schuchardtfe1599d2018-01-11 08:15:57 +0100141 /* Link to the list of open protocol info items */
142 struct list_head open_infos;
Alexander Grafbee91162016-03-04 01:09:59 +0100143};
144
145/*
146 * UEFI has a poor man's OO model where one "object" can be polymorphic and have
147 * multiple different protocols (classes) attached to it.
148 *
149 * This struct is the parent struct for all of our actual implementation objects
150 * that can include it to make themselves an EFI object
151 */
152struct efi_object {
153 /* Every UEFI object is part of a global object list */
154 struct list_head link;
Heinrich Schuchardt69fb6b12017-11-26 14:05:17 +0100155 /* The list of protocols */
156 struct list_head protocols;
Alexander Grafbee91162016-03-04 01:09:59 +0100157 /* The object spawner can either use this for data or as identifier */
158 void *handle;
159};
160
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200161/**
162 * struct efi_event
163 *
Heinrich Schuchardt43bce442018-02-18 15:17:50 +0100164 * @link: Link to list of all events
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200165 * @type: Type of event, see efi_create_event
166 * @notify_tpl: Task priority level of notifications
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200167 * @nofify_function: Function to call when the event is triggered
168 * @notify_context: Data to be passed to the notify function
Heinrich Schuchardtb095f3c2018-02-18 15:17:52 +0100169 * @group: Event group
Heinrich Schuchardt43bce442018-02-18 15:17:50 +0100170 * @trigger_time: Period of the timer
171 * @trigger_next: Next time to trigger the timer
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200172 * @trigger_type: Type of timer, see efi_set_timer
Heinrich Schuchardt43bce442018-02-18 15:17:50 +0100173 * @is_queued: The notification function is queued
174 * @is_signaled: The event occurred. The event is in the signaled state.
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200175 */
176struct efi_event {
Heinrich Schuchardt43bce442018-02-18 15:17:50 +0100177 struct list_head link;
xypron.glpk@gmx.deb521d292017-07-19 19:22:34 +0200178 uint32_t type;
Heinrich Schuchardt152cade2017-11-06 21:17:47 +0100179 efi_uintn_t notify_tpl;
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200180 void (EFIAPI *notify_function)(struct efi_event *event, void *context);
181 void *notify_context;
Heinrich Schuchardtb095f3c2018-02-18 15:17:52 +0100182 const efi_guid_t *group;
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200183 u64 trigger_next;
184 u64 trigger_time;
xypron.glpk@gmx.deb521d292017-07-19 19:22:34 +0200185 enum efi_timer_delay trigger_type;
Heinrich Schuchardte190e892017-10-04 15:03:24 +0200186 bool is_queued;
187 bool is_signaled;
xypron.glpk@gmx.dec6841592017-07-18 20:17:18 +0200188};
189
Alexander Grafbee91162016-03-04 01:09:59 +0100190/* This list contains all UEFI objects we know of */
191extern struct list_head efi_obj_list;
Heinrich Schuchardtb095f3c2018-02-18 15:17:52 +0100192/* List of all events */
193extern struct list_head efi_events;
Alexander Grafbee91162016-03-04 01:09:59 +0100194
xypron.glpk@gmx.de91be9a72017-07-18 20:17:22 +0200195/* Called by bootefi to make console interface available */
196int efi_console_register(void);
Alexander Graf2a22d052016-03-04 01:10:02 +0100197/* Called by bootefi to make all disk storage accessible as EFI objects */
Heinrich Schuchardtdf9cf562018-02-09 20:55:47 +0100198efi_status_t efi_disk_register(void);
Heinrich Schuchardt64e4db02018-01-19 20:24:47 +0100199/* Create handles and protocols for the partitions of a block device */
200int efi_disk_create_partitions(efi_handle_t parent, struct blk_desc *desc,
201 const char *if_typename, int diskid,
202 const char *pdevname);
Alexander Grafbe8d3242016-03-15 18:38:21 +0100203/* Called by bootefi to make GOP (graphical) interface available */
Heinrich Schuchardt80ea9b02018-03-03 15:28:55 +0100204efi_status_t efi_gop_register(void);
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200205/* Called by bootefi to make the network interface available */
Heinrich Schuchardt075d4252018-03-03 15:28:56 +0100206efi_status_t efi_net_register(void);
Heinrich Schuchardtb3d60902017-10-18 18:13:04 +0200207/* Called by bootefi to make the watchdog available */
Heinrich Schuchardtd7b181d2018-03-03 15:28:57 +0100208efi_status_t efi_watchdog_register(void);
Alexander Grafe663b352016-08-19 01:23:29 +0200209/* Called by bootefi to make SMBIOS tables available */
Heinrich Schuchardt76571522018-03-03 15:28:54 +0100210efi_status_t efi_smbios_register(void);
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200211
Rob Clark2a920802017-09-13 18:05:34 -0400212struct efi_simple_file_system_protocol *
213efi_fs_from_path(struct efi_device_path *fp);
214
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200215/* Called by networking code to memorize the dhcp ack package */
216void efi_net_set_dhcp_ack(void *pkt, int len);
Heinrich Schuchardtb3d60902017-10-18 18:13:04 +0200217/* Called by efi_set_watchdog_timer to reset the timer */
218efi_status_t efi_set_watchdog(unsigned long timeout);
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200219
Alexander Grafbee91162016-03-04 01:09:59 +0100220/* Called from places to check whether a timer expired */
221void efi_timer_check(void);
222/* PE loader implementation */
Alexander Grafcb149c62016-03-04 01:09:58 +0100223void *efi_load_pe(void *efi, struct efi_loaded_image *loaded_image_info);
Alexander Grafbee91162016-03-04 01:09:59 +0100224/* Called once to store the pristine gd pointer */
225void efi_save_gd(void);
Rob Clarkc160d2f2017-07-27 08:04:18 -0400226/* Special case handler for error/abort that just tries to dtrt to get
227 * back to u-boot world */
Alexander Grafbee91162016-03-04 01:09:59 +0100228void efi_restore_gd(void);
Alexander Graf50149ea2016-03-04 01:10:01 +0100229/* Call this to relocate the runtime section to an address space */
230void efi_runtime_relocate(ulong offset, struct efi_mem_desc *map);
Alexander Graf0f4060e2016-03-04 01:10:14 +0100231/* Call this to set the current device name */
Alexander Grafc07ad7c2016-04-11 16:16:19 +0200232void efi_set_bootdev(const char *dev, const char *devnr, const char *path);
Heinrich Schuchardt44549d62017-11-26 14:05:23 +0100233/* Add a new object to the object list. */
234void efi_add_handle(struct efi_object *obj);
Heinrich Schuchardt2edab5e2017-10-26 19:25:49 +0200235/* Create handle */
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100236efi_status_t efi_create_handle(efi_handle_t *handle);
Heinrich Schuchardt678e03a2017-12-04 18:03:02 +0100237/* Delete handle */
238void efi_delete_handle(struct efi_object *obj);
Heinrich Schuchardt1b681532017-11-06 21:17:50 +0100239/* Call this to validate a handle and find the EFI object for it */
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100240struct efi_object *efi_search_obj(const efi_handle_t handle);
Heinrich Schuchardt3f79a2b2017-10-26 19:25:53 +0200241/* Find a protocol on a handle */
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100242efi_status_t efi_search_protocol(const efi_handle_t handle,
Heinrich Schuchardt3f79a2b2017-10-26 19:25:53 +0200243 const efi_guid_t *protocol_guid,
244 struct efi_handler **handler);
245/* Install new protocol on a handle */
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100246efi_status_t efi_add_protocol(const efi_handle_t handle,
247 const efi_guid_t *protocol,
Heinrich Schuchardt3f79a2b2017-10-26 19:25:53 +0200248 void *protocol_interface);
249/* Delete protocol from a handle */
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100250efi_status_t efi_remove_protocol(const efi_handle_t handle,
251 const efi_guid_t *protocol,
Heinrich Schuchardt3f79a2b2017-10-26 19:25:53 +0200252 void *protocol_interface);
253/* Delete all protocols from a handle */
Heinrich Schuchardt2074f702018-01-11 08:16:09 +0100254efi_status_t efi_remove_all_protocols(const efi_handle_t handle);
xypron.glpk@gmx.de49deb452017-07-18 20:17:20 +0200255/* Call this to create an event */
Heinrich Schuchardt152cade2017-11-06 21:17:47 +0100256efi_status_t efi_create_event(uint32_t type, efi_uintn_t notify_tpl,
xypron.glpk@gmx.de49deb452017-07-18 20:17:20 +0200257 void (EFIAPI *notify_function) (
258 struct efi_event *event,
259 void *context),
Heinrich Schuchardtb095f3c2018-02-18 15:17:52 +0100260 void *notify_context, efi_guid_t *group,
261 struct efi_event **event);
xypron.glpk@gmx.debfc72462017-07-18 20:17:21 +0200262/* Call this to set a timer */
xypron.glpk@gmx.deb521d292017-07-19 19:22:34 +0200263efi_status_t efi_set_timer(struct efi_event *event, enum efi_timer_delay type,
xypron.glpk@gmx.debfc72462017-07-18 20:17:21 +0200264 uint64_t trigger_time);
xypron.glpk@gmx.de91be9a72017-07-18 20:17:22 +0200265/* Call this to signal an event */
Heinrich Schuchardt9bc96642018-01-19 20:24:51 +0100266void efi_signal_event(struct efi_event *event, bool check_tpl);
Alexander Graf50149ea2016-03-04 01:10:01 +0100267
Rob Clark2a920802017-09-13 18:05:34 -0400268/* open file system: */
269struct efi_simple_file_system_protocol *efi_simple_file_system(
270 struct blk_desc *desc, int part, struct efi_device_path *dp);
271
272/* open file from device-path: */
273struct efi_file_handle *efi_file_from_path(struct efi_device_path *fp);
274
275
Alexander Graf5d009952016-03-04 01:10:04 +0100276/* Generic EFI memory allocator, call this to get memory */
277void *efi_alloc(uint64_t len, int memory_type);
278/* More specific EFI memory allocator, called by EFI payloads */
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100279efi_status_t efi_allocate_pages(int type, int memory_type, efi_uintn_t pages,
Alexander Graf5d009952016-03-04 01:10:04 +0100280 uint64_t *memory);
Stefan Brünsb61d8572016-10-01 23:32:27 +0200281/* EFI memory free function. */
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100282efi_status_t efi_free_pages(uint64_t memory, efi_uintn_t pages);
Stefan Brünsead12742016-10-09 22:17:18 +0200283/* EFI memory allocator for small allocations */
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100284efi_status_t efi_allocate_pool(int pool_type, efi_uintn_t size,
Stefan Brünsead12742016-10-09 22:17:18 +0200285 void **buffer);
Stefan Brüns42417bc2016-10-09 22:17:26 +0200286/* EFI pool memory free function. */
287efi_status_t efi_free_pool(void *buffer);
Alexander Graf5d009952016-03-04 01:10:04 +0100288/* Returns the EFI memory map */
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100289efi_status_t efi_get_memory_map(efi_uintn_t *memory_map_size,
Alexander Graf5d009952016-03-04 01:10:04 +0100290 struct efi_mem_desc *memory_map,
Heinrich Schuchardtf5a2a932017-11-06 21:17:48 +0100291 efi_uintn_t *map_key,
292 efi_uintn_t *descriptor_size,
Alexander Graf5d009952016-03-04 01:10:04 +0100293 uint32_t *descriptor_version);
294/* Adds a range into the EFI memory map */
295uint64_t efi_add_memory_map(uint64_t start, uint64_t pages, int memory_type,
296 bool overlap_only_ram);
Heinrich Schuchardt05ef48a2018-01-21 19:29:30 +0100297/* Called by board init to initialize the EFI drivers */
Heinrich Schuchardt038782a2018-02-01 12:53:32 +0100298efi_status_t efi_driver_init(void);
Alexander Graf5d009952016-03-04 01:10:04 +0100299/* Called by board init to initialize the EFI memory map */
300int efi_memory_init(void);
Alexander Graf488bf122016-08-19 01:23:24 +0200301/* Adds new or overrides configuration table entry to the system table */
302efi_status_t efi_install_configuration_table(const efi_guid_t *guid, void *table);
Heinrich Schuchardt56d92882017-12-04 18:03:01 +0100303/* Sets up a loaded image */
304efi_status_t efi_setup_loaded_image(
305 struct efi_loaded_image *info, struct efi_object *obj,
306 struct efi_device_path *device_path,
307 struct efi_device_path *file_path);
Rob Clark9975fe92017-09-13 18:05:38 -0400308efi_status_t efi_load_image_from_path(struct efi_device_path *file_path,
309 void **buffer);
Heinrich Schuchardtc9a63f42018-04-05 11:56:21 +0200310/* Print information about a loaded image */
311efi_status_t efi_print_image_info(struct efi_loaded_image *image, void *pc);
312/* Print information about all loaded images */
313void efi_print_image_infos(void *pc);
Alexander Graf5d009952016-03-04 01:10:04 +0100314
Alexander Graf51735ae2016-05-11 18:25:48 +0200315#ifdef CONFIG_EFI_LOADER_BOUNCE_BUFFER
316extern void *efi_bounce_buffer;
317#define EFI_LOADER_BOUNCE_BUFFER_SIZE (64 * 1024 * 1024)
318#endif
319
Rob Clarkb66c60d2017-09-13 18:05:28 -0400320
321struct efi_device_path *efi_dp_next(const struct efi_device_path *dp);
Heinrich Schuchardtff401d32017-10-26 19:25:48 +0200322int efi_dp_match(const struct efi_device_path *a,
323 const struct efi_device_path *b);
Rob Clarkb66c60d2017-09-13 18:05:28 -0400324struct efi_object *efi_dp_find_obj(struct efi_device_path *dp,
325 struct efi_device_path **rem);
Heinrich Schuchardtf6dd3f32018-04-16 07:59:08 +0200326/* get size of the first device path instance excluding end node */
327efi_uintn_t efi_dp_instance_size(const struct efi_device_path *dp);
328/* size of multi-instance device path excluding end node */
329efi_uintn_t efi_dp_size(const struct efi_device_path *dp);
Rob Clarkb66c60d2017-09-13 18:05:28 -0400330struct efi_device_path *efi_dp_dup(const struct efi_device_path *dp);
331struct efi_device_path *efi_dp_append(const struct efi_device_path *dp1,
332 const struct efi_device_path *dp2);
333struct efi_device_path *efi_dp_append_node(const struct efi_device_path *dp,
334 const struct efi_device_path *node);
Heinrich Schuchardt211314c2018-04-16 07:59:05 +0200335/* Create a device path node of given type, sub-type, length */
336struct efi_device_path *efi_dp_create_device_node(const u8 type,
337 const u8 sub_type,
338 const u16 length);
Heinrich Schuchardt3acef5d2018-04-16 07:59:09 +0200339/* Append device path instance */
340struct efi_device_path *efi_dp_append_instance(
341 const struct efi_device_path *dp,
342 const struct efi_device_path *dpi);
343/* Get next device path instance */
344struct efi_device_path *efi_dp_get_next_instance(struct efi_device_path **dp,
345 efi_uintn_t *size);
346/* Check if a device path contains muliple instances */
347bool efi_dp_is_multi_instance(const struct efi_device_path *dp);
Rob Clarkb66c60d2017-09-13 18:05:28 -0400348
349struct efi_device_path *efi_dp_from_dev(struct udevice *dev);
350struct efi_device_path *efi_dp_from_part(struct blk_desc *desc, int part);
Heinrich Schuchardt98d48bd2018-01-19 20:24:46 +0100351/* Create a device node for a block device partition. */
352struct efi_device_path *efi_dp_part_node(struct blk_desc *desc, int part);
Rob Clarkb66c60d2017-09-13 18:05:28 -0400353struct efi_device_path *efi_dp_from_file(struct blk_desc *desc, int part,
354 const char *path);
355struct efi_device_path *efi_dp_from_eth(void);
Rob Clarkbf192732017-10-10 08:23:06 -0400356struct efi_device_path *efi_dp_from_mem(uint32_t mem_type,
357 uint64_t start_address,
358 uint64_t end_address);
Heinrich Schuchardt65436f92018-01-19 20:24:49 +0100359/* Determine the last device path node that is not the end node. */
360const struct efi_device_path *efi_dp_last_node(
361 const struct efi_device_path *dp);
Heinrich Schuchardt04298682018-01-19 20:24:37 +0100362efi_status_t efi_dp_split_file_path(struct efi_device_path *full_path,
363 struct efi_device_path **device_path,
364 struct efi_device_path **file_path);
Rob Clarkb66c60d2017-09-13 18:05:28 -0400365
366#define EFI_DP_TYPE(_dp, _type, _subtype) \
367 (((_dp)->type == DEVICE_PATH_TYPE_##_type) && \
368 ((_dp)->sub_type == DEVICE_PATH_SUB_TYPE_##_subtype))
369
Alexander Graf0f4060e2016-03-04 01:10:14 +0100370/* Convert strings from normal C strings to uEFI strings */
Simon Glass487d7562016-05-14 14:03:05 -0600371static inline void ascii2unicode(u16 *unicode, const char *ascii)
Alexander Graf0f4060e2016-03-04 01:10:14 +0100372{
373 while (*ascii)
374 *(unicode++) = *(ascii++);
Heinrich Schuchardtc4121662018-04-04 15:42:10 +0200375 *unicode = 0;
Alexander Graf0f4060e2016-03-04 01:10:14 +0100376}
377
Rob Clark3e094c52017-07-24 07:59:11 -0400378static inline int guidcmp(const efi_guid_t *g1, const efi_guid_t *g2)
379{
380 return memcmp(g1, g2, sizeof(efi_guid_t));
381}
382
Alexander Graf50149ea2016-03-04 01:10:01 +0100383/*
384 * Use these to indicate that your code / data should go into the EFI runtime
385 * section and thus still be available when the OS is running
386 */
Alexander Graf3c63db92016-10-14 13:45:30 +0200387#define __efi_runtime_data __attribute__ ((section ("efi_runtime_data")))
388#define __efi_runtime __attribute__ ((section ("efi_runtime_text")))
Alexander Grafbee91162016-03-04 01:09:59 +0100389
Alexander Graf80a48002016-08-16 21:08:45 +0200390/* Call this with mmio_ptr as the _pointer_ to a pointer to an MMIO region
391 * to make it available at runtime */
Heinrich Schuchardt22c793e2018-03-03 15:28:59 +0100392efi_status_t efi_add_runtime_mmio(void *mmio_ptr, u64 len);
Alexander Graf80a48002016-08-16 21:08:45 +0200393
394/* Boards may provide the functions below to implement RTS functionality */
395
Alexander Graf3c63db92016-10-14 13:45:30 +0200396void __efi_runtime EFIAPI efi_reset_system(
Alexander Graf80a48002016-08-16 21:08:45 +0200397 enum efi_reset_type reset_type,
398 efi_status_t reset_status,
399 unsigned long data_size, void *reset_data);
Heinrich Schuchardt22c793e2018-03-03 15:28:59 +0100400
401/* Architecture specific initialization of the EFI subsystem */
402efi_status_t efi_reset_system_init(void);
Alexander Graf80a48002016-08-16 21:08:45 +0200403
Alexander Graf3c63db92016-10-14 13:45:30 +0200404efi_status_t __efi_runtime EFIAPI efi_get_time(
Alexander Graf80a48002016-08-16 21:08:45 +0200405 struct efi_time *time,
406 struct efi_time_cap *capabilities);
Heinrich Schuchardt14ad49d2018-03-03 15:29:00 +0100407efi_status_t efi_get_time_init(void);
Alexander Graf80a48002016-08-16 21:08:45 +0200408
Heinrich Schuchardt623b3a52017-09-15 10:06:11 +0200409#ifdef CONFIG_CMD_BOOTEFI_SELFTEST
410/*
411 * Entry point for the tests of the EFI API.
412 * It is called by 'bootefi selftest'
413 */
414efi_status_t EFIAPI efi_selftest(efi_handle_t image_handle,
415 struct efi_system_table *systab);
416#endif
417
Rob Clarkad644e72017-09-13 18:05:37 -0400418efi_status_t EFIAPI efi_get_variable(s16 *variable_name,
419 efi_guid_t *vendor, u32 *attributes,
420 unsigned long *data_size, void *data);
421efi_status_t EFIAPI efi_get_next_variable(
422 unsigned long *variable_name_size,
423 s16 *variable_name, efi_guid_t *vendor);
424efi_status_t EFIAPI efi_set_variable(s16 *variable_name,
425 efi_guid_t *vendor, u32 attributes,
426 unsigned long data_size, void *data);
427
Rob Clark9975fe92017-09-13 18:05:38 -0400428void *efi_bootmgr_load(struct efi_device_path **device_path,
429 struct efi_device_path **file_path);
430
Alexander Grafbee91162016-03-04 01:09:59 +0100431#else /* defined(EFI_LOADER) && !defined(CONFIG_SPL_BUILD) */
432
Alexander Graf50149ea2016-03-04 01:10:01 +0100433/* Without CONFIG_EFI_LOADER we don't have a runtime section, stub it out */
Alexander Graf3c63db92016-10-14 13:45:30 +0200434#define __efi_runtime_data
435#define __efi_runtime
Heinrich Schuchardt22c793e2018-03-03 15:28:59 +0100436static inline efi_status_t efi_add_runtime_mmio(void *mmio_ptr, u64 len)
437{
438 return EFI_SUCCESS;
439}
Alexander Graf50149ea2016-03-04 01:10:01 +0100440
Alexander Grafbee91162016-03-04 01:09:59 +0100441/* No loader configured, stub out EFI_ENTRY */
442static inline void efi_restore_gd(void) { }
Alexander Grafc07ad7c2016-04-11 16:16:19 +0200443static inline void efi_set_bootdev(const char *dev, const char *devnr,
444 const char *path) { }
Alexander Graf0efe1bc2016-05-06 21:01:01 +0200445static inline void efi_net_set_dhcp_ack(void *pkt, int len) { }
Heinrich Schuchardtc9a63f42018-04-05 11:56:21 +0200446static inline void efi_print_image_infos(void *pc) { }
Alexander Grafbee91162016-03-04 01:09:59 +0100447
Heinrich Schuchardtcd9e18d2017-10-18 18:13:07 +0200448#endif /* CONFIG_EFI_LOADER && !CONFIG_SPL_BUILD */
449
450#endif /* _EFI_LOADER_H */