Tom Rini | 70df9d6 | 2018-05-07 17:02:21 -0400 | [diff] [blame] | 1 | /* SPDX-License-Identifier: GPL-2.0+ */ |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 2 | /* |
| 3 | * EFI application loader |
| 4 | * |
| 5 | * Copyright (c) 2016 Alexander Graf |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 6 | */ |
| 7 | |
Heinrich Schuchardt | c2fd477 | 2017-10-18 18:13:07 +0200 | [diff] [blame] | 8 | #ifndef _EFI_LOADER_H |
| 9 | #define _EFI_LOADER_H 1 |
| 10 | |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 11 | #include <common.h> |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 12 | #include <part_efi.h> |
| 13 | #include <efi_api.h> |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 14 | |
| 15 | /* No need for efi loader support in SPL */ |
Stephen Warren | d0de806 | 2018-08-30 15:43:43 -0600 | [diff] [blame] | 16 | #if CONFIG_IS_ENABLED(EFI_LOADER) |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 17 | |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 18 | #include <linux/list.h> |
| 19 | |
Heinrich Schuchardt | 2f528c2 | 2018-06-28 12:45:32 +0200 | [diff] [blame] | 20 | /* Maximum number of configuration tables */ |
| 21 | #define EFI_MAX_CONFIGURATION_TABLES 16 |
| 22 | |
Heinrich Schuchardt | 79d7202 | 2018-09-20 21:58:23 +0200 | [diff] [blame] | 23 | /* GUID used by the root node */ |
| 24 | #define U_BOOT_GUID \ |
| 25 | EFI_GUID(0xe61d73b9, 0xa384, 0x4acc, \ |
| 26 | 0xae, 0xab, 0x82, 0xe8, 0x28, 0xf3, 0x62, 0x8b) |
| 27 | |
AKASHI Takahiro | 0b27575 | 2019-04-16 13:24:20 +0900 | [diff] [blame] | 28 | /* Root node */ |
| 29 | extern efi_handle_t efi_root; |
| 30 | |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 31 | int __efi_entry_check(void); |
| 32 | int __efi_exit_check(void); |
Heinrich Schuchardt | 4d66489 | 2017-08-18 17:45:16 +0200 | [diff] [blame] | 33 | const char *__efi_nesting(void); |
Rob Clark | e7896c3 | 2017-07-27 08:04:19 -0400 | [diff] [blame] | 34 | const char *__efi_nesting_inc(void); |
| 35 | const char *__efi_nesting_dec(void); |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 36 | |
Rob Clark | 63ea77a | 2017-07-27 08:04:17 -0400 | [diff] [blame] | 37 | /* |
| 38 | * Enter the u-boot world from UEFI: |
| 39 | */ |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 40 | #define EFI_ENTRY(format, ...) do { \ |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 41 | assert(__efi_entry_check()); \ |
Rob Clark | e7896c3 | 2017-07-27 08:04:19 -0400 | [diff] [blame] | 42 | debug("%sEFI: Entry %s(" format ")\n", __efi_nesting_inc(), \ |
| 43 | __func__, ##__VA_ARGS__); \ |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 44 | } while(0) |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 45 | |
Rob Clark | 63ea77a | 2017-07-27 08:04:17 -0400 | [diff] [blame] | 46 | /* |
| 47 | * Exit the u-boot world back to UEFI: |
| 48 | */ |
Rob Clark | 84a19a0 | 2017-07-24 10:31:52 -0400 | [diff] [blame] | 49 | #define EFI_EXIT(ret) ({ \ |
xypron.glpk@gmx.de | 8f9dd92 | 2017-08-17 18:57:36 +0200 | [diff] [blame] | 50 | typeof(ret) _r = ret; \ |
Rob Clark | e7896c3 | 2017-07-27 08:04:19 -0400 | [diff] [blame] | 51 | debug("%sEFI: Exit: %s: %u\n", __efi_nesting_dec(), \ |
xypron.glpk@gmx.de | 8f9dd92 | 2017-08-17 18:57:36 +0200 | [diff] [blame] | 52 | __func__, (u32)((uintptr_t) _r & ~EFI_ERROR_MASK)); \ |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 53 | assert(__efi_exit_check()); \ |
| 54 | _r; \ |
Rob Clark | 84a19a0 | 2017-07-24 10:31:52 -0400 | [diff] [blame] | 55 | }) |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 56 | |
Rob Clark | 63ea77a | 2017-07-27 08:04:17 -0400 | [diff] [blame] | 57 | /* |
Heinrich Schuchardt | 91e5b8a | 2017-09-15 10:06:10 +0200 | [diff] [blame] | 58 | * Call non-void UEFI function from u-boot and retrieve return value: |
| 59 | */ |
| 60 | #define EFI_CALL(exp) ({ \ |
| 61 | debug("%sEFI: Call: %s\n", __efi_nesting_inc(), #exp); \ |
| 62 | assert(__efi_exit_check()); \ |
| 63 | typeof(exp) _r = exp; \ |
| 64 | assert(__efi_entry_check()); \ |
| 65 | debug("%sEFI: %lu returned by %s\n", __efi_nesting_dec(), \ |
| 66 | (unsigned long)((uintptr_t)_r & ~EFI_ERROR_MASK), #exp); \ |
| 67 | _r; \ |
| 68 | }) |
| 69 | |
| 70 | /* |
| 71 | * Call void UEFI function from u-boot: |
Rob Clark | 63ea77a | 2017-07-27 08:04:17 -0400 | [diff] [blame] | 72 | */ |
Heinrich Schuchardt | 91e5b8a | 2017-09-15 10:06:10 +0200 | [diff] [blame] | 73 | #define EFI_CALL_VOID(exp) do { \ |
Rob Clark | e7896c3 | 2017-07-27 08:04:19 -0400 | [diff] [blame] | 74 | debug("%sEFI: Call: %s\n", __efi_nesting_inc(), #exp); \ |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 75 | assert(__efi_exit_check()); \ |
Rob Clark | 63ea77a | 2017-07-27 08:04:17 -0400 | [diff] [blame] | 76 | exp; \ |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 77 | assert(__efi_entry_check()); \ |
Rob Clark | e7896c3 | 2017-07-27 08:04:19 -0400 | [diff] [blame] | 78 | debug("%sEFI: Return From: %s\n", __efi_nesting_dec(), #exp); \ |
Rob Clark | 63ea77a | 2017-07-27 08:04:17 -0400 | [diff] [blame] | 79 | } while(0) |
| 80 | |
Heinrich Schuchardt | 4d66489 | 2017-08-18 17:45:16 +0200 | [diff] [blame] | 81 | /* |
Heinrich Schuchardt | 3d2abc3 | 2018-01-11 08:16:01 +0100 | [diff] [blame] | 82 | * Write an indented message with EFI prefix |
Heinrich Schuchardt | 4d66489 | 2017-08-18 17:45:16 +0200 | [diff] [blame] | 83 | */ |
Heinrich Schuchardt | 3d2abc3 | 2018-01-11 08:16:01 +0100 | [diff] [blame] | 84 | #define EFI_PRINT(format, ...) ({ \ |
| 85 | debug("%sEFI: " format, __efi_nesting(), \ |
| 86 | ##__VA_ARGS__); \ |
Heinrich Schuchardt | 4d66489 | 2017-08-18 17:45:16 +0200 | [diff] [blame] | 87 | }) |
| 88 | |
Alexander Graf | 59254d6 | 2018-04-23 07:59:47 +0200 | [diff] [blame] | 89 | #ifdef CONFIG_SYS_CACHELINE_SIZE |
| 90 | #define EFI_CACHELINE_SIZE CONFIG_SYS_CACHELINE_SIZE |
| 91 | #else |
| 92 | /* Just use the greatest cache flush alignment requirement I'm aware of */ |
| 93 | #define EFI_CACHELINE_SIZE 128 |
| 94 | #endif |
| 95 | |
Heinrich Schuchardt | 0f233c4 | 2018-07-02 12:53:55 +0200 | [diff] [blame] | 96 | /* Key identifying current memory map */ |
| 97 | extern efi_uintn_t efi_memory_map_key; |
| 98 | |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 99 | extern struct efi_runtime_services efi_runtime_services; |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 100 | extern struct efi_system_table systab; |
| 101 | |
Heinrich Schuchardt | 580c13b | 2017-10-26 19:25:59 +0200 | [diff] [blame] | 102 | extern struct efi_simple_text_output_protocol efi_con_out; |
Heinrich Schuchardt | 3dabffd | 2018-09-08 10:20:10 +0200 | [diff] [blame] | 103 | extern struct efi_simple_text_input_protocol efi_con_in; |
Heinrich Schuchardt | 580c13b | 2017-10-26 19:25:59 +0200 | [diff] [blame] | 104 | extern struct efi_console_control_protocol efi_console_control; |
xypron.glpk@gmx.de | 3c042b2 | 2017-07-11 22:06:25 +0200 | [diff] [blame] | 105 | extern const struct efi_device_path_to_text_protocol efi_device_path_to_text; |
Leif Lindholm | b6e6fdc | 2018-03-09 17:43:21 +0100 | [diff] [blame] | 106 | /* implementation of the EFI_DEVICE_PATH_UTILITIES_PROTOCOL */ |
| 107 | extern const struct efi_device_path_utilities_protocol |
| 108 | efi_device_path_utilities; |
Heinrich Schuchardt | 18ed8cf | 2019-05-16 18:19:00 +0200 | [diff] [blame] | 109 | /* deprecated version of the EFI_UNICODE_COLLATION_PROTOCOL */ |
| 110 | extern const struct efi_unicode_collation_protocol |
| 111 | efi_unicode_collation_protocol; |
| 112 | /* current version of the EFI_UNICODE_COLLATION_PROTOCOL */ |
Heinrich Schuchardt | e59072a | 2018-09-04 19:34:58 +0200 | [diff] [blame] | 113 | extern const struct efi_unicode_collation_protocol |
Heinrich Schuchardt | b325884 | 2019-05-16 07:52:58 +0200 | [diff] [blame] | 114 | efi_unicode_collation_protocol2; |
AKASHI Takahiro | ca8aa71 | 2019-01-21 12:13:00 +0900 | [diff] [blame] | 115 | extern const struct efi_hii_config_routing_protocol efi_hii_config_routing; |
| 116 | extern const struct efi_hii_config_access_protocol efi_hii_config_access; |
Leif Lindholm | 5aab1b8 | 2019-01-21 12:12:57 +0900 | [diff] [blame] | 117 | extern const struct efi_hii_database_protocol efi_hii_database; |
| 118 | extern const struct efi_hii_string_protocol efi_hii_string; |
Alexander Graf | 4aacacc | 2016-03-04 01:10:00 +0100 | [diff] [blame] | 119 | |
Rob Clark | 85dd721 | 2017-09-13 18:05:30 -0400 | [diff] [blame] | 120 | uint16_t *efi_dp_str(struct efi_device_path *dp); |
| 121 | |
Heinrich Schuchardt | 79d7202 | 2018-09-20 21:58:23 +0200 | [diff] [blame] | 122 | /* GUID of the U-Boot root node */ |
| 123 | extern const efi_guid_t efi_u_boot_guid; |
Heinrich Schuchardt | 405afb5 | 2018-01-19 20:24:45 +0100 | [diff] [blame] | 124 | /* GUID of the EFI_BLOCK_IO_PROTOCOL */ |
| 125 | extern const efi_guid_t efi_block_io_guid; |
Rob Clark | c84c110 | 2017-09-13 18:05:38 -0400 | [diff] [blame] | 126 | extern const efi_guid_t efi_global_variable_guid; |
Alexander Graf | 4aacacc | 2016-03-04 01:10:00 +0100 | [diff] [blame] | 127 | extern const efi_guid_t efi_guid_console_control; |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 128 | extern const efi_guid_t efi_guid_device_path; |
Heinrich Schuchardt | 760255f | 2018-01-11 08:16:02 +0100 | [diff] [blame] | 129 | /* GUID of the EFI_DRIVER_BINDING_PROTOCOL */ |
| 130 | extern const efi_guid_t efi_guid_driver_binding_protocol; |
Heinrich Schuchardt | 672d99e | 2018-02-18 15:17:51 +0100 | [diff] [blame] | 131 | /* event group ExitBootServices() invoked */ |
| 132 | extern const efi_guid_t efi_guid_event_group_exit_boot_services; |
| 133 | /* event group SetVirtualAddressMap() invoked */ |
| 134 | extern const efi_guid_t efi_guid_event_group_virtual_address_change; |
| 135 | /* event group memory map changed */ |
| 136 | extern const efi_guid_t efi_guid_event_group_memory_map_change; |
| 137 | /* event group boot manager about to boot */ |
| 138 | extern const efi_guid_t efi_guid_event_group_ready_to_boot; |
| 139 | /* event group ResetSystem() invoked (before ExitBootServices) */ |
| 140 | extern const efi_guid_t efi_guid_event_group_reset_system; |
Heinrich Schuchardt | 44ab21b | 2018-03-03 15:29:03 +0100 | [diff] [blame] | 141 | /* GUID of the device tree table */ |
| 142 | extern const efi_guid_t efi_guid_fdt; |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 143 | extern const efi_guid_t efi_guid_loaded_image; |
AKASHI Takahiro | bbe13da | 2019-03-27 13:40:32 +0900 | [diff] [blame] | 144 | extern const efi_guid_t efi_guid_loaded_image_device_path; |
xypron.glpk@gmx.de | 3c042b2 | 2017-07-11 22:06:25 +0200 | [diff] [blame] | 145 | extern const efi_guid_t efi_guid_device_path_to_text_protocol; |
Rob Clark | 5314203 | 2017-09-13 18:05:34 -0400 | [diff] [blame] | 146 | extern const efi_guid_t efi_simple_file_system_protocol_guid; |
| 147 | extern const efi_guid_t efi_file_info_guid; |
Heinrich Schuchardt | 37fb4b9 | 2018-04-04 15:42:11 +0200 | [diff] [blame] | 148 | /* GUID for file system information */ |
| 149 | extern const efi_guid_t efi_file_system_info_guid; |
Leif Lindholm | b6e6fdc | 2018-03-09 17:43:21 +0100 | [diff] [blame] | 150 | extern const efi_guid_t efi_guid_device_path_utilities_protocol; |
Heinrich Schuchardt | 18ed8cf | 2019-05-16 18:19:00 +0200 | [diff] [blame] | 151 | /* GUID of the deprecated Unicode collation protocol */ |
| 152 | extern const efi_guid_t efi_guid_unicode_collation_protocol; |
Heinrich Schuchardt | e59072a | 2018-09-04 19:34:58 +0200 | [diff] [blame] | 153 | /* GUID of the Unicode collation protocol */ |
Heinrich Schuchardt | b325884 | 2019-05-16 07:52:58 +0200 | [diff] [blame] | 154 | extern const efi_guid_t efi_guid_unicode_collation_protocol2; |
AKASHI Takahiro | ca8aa71 | 2019-01-21 12:13:00 +0900 | [diff] [blame] | 155 | extern const efi_guid_t efi_guid_hii_config_routing_protocol; |
| 156 | extern const efi_guid_t efi_guid_hii_config_access_protocol; |
Leif Lindholm | 5aab1b8 | 2019-01-21 12:12:57 +0900 | [diff] [blame] | 157 | extern const efi_guid_t efi_guid_hii_database_protocol; |
| 158 | extern const efi_guid_t efi_guid_hii_string_protocol; |
Alexander Graf | 4e0c1c1 | 2016-03-04 01:09:58 +0100 | [diff] [blame] | 159 | |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 160 | extern unsigned int __efi_runtime_start, __efi_runtime_stop; |
| 161 | extern unsigned int __efi_runtime_rel_start, __efi_runtime_rel_stop; |
| 162 | |
Heinrich Schuchardt | 2e4b41f | 2019-05-21 17:51:35 +0200 | [diff] [blame] | 163 | /** |
| 164 | * struct efi_open_protocol_info_item - open protocol info item |
| 165 | * |
Heinrich Schuchardt | a277d3a | 2018-01-11 08:15:57 +0100 | [diff] [blame] | 166 | * When a protocol is opened a open protocol info entry is created. |
| 167 | * These are maintained in a list. |
Heinrich Schuchardt | 2e4b41f | 2019-05-21 17:51:35 +0200 | [diff] [blame] | 168 | * |
| 169 | * @link: link to the list of open protocol info entries of a protocol |
| 170 | * @info: information about the opening of a protocol |
Heinrich Schuchardt | a277d3a | 2018-01-11 08:15:57 +0100 | [diff] [blame] | 171 | */ |
| 172 | struct efi_open_protocol_info_item { |
Heinrich Schuchardt | a277d3a | 2018-01-11 08:15:57 +0100 | [diff] [blame] | 173 | struct list_head link; |
| 174 | struct efi_open_protocol_info_entry info; |
| 175 | }; |
| 176 | |
Heinrich Schuchardt | 2e4b41f | 2019-05-21 17:51:35 +0200 | [diff] [blame] | 177 | /** |
| 178 | * struct efi_handler - single protocol interface of a handle |
| 179 | * |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 180 | * When the UEFI payload wants to open a protocol on an object to get its |
| 181 | * interface (usually a struct with callback functions), this struct maps the |
Heinrich Schuchardt | a277d3a | 2018-01-11 08:15:57 +0100 | [diff] [blame] | 182 | * protocol GUID to the respective protocol interface |
Heinrich Schuchardt | 2e4b41f | 2019-05-21 17:51:35 +0200 | [diff] [blame] | 183 | * |
| 184 | * @link: link to the list of protocols of a handle |
| 185 | * @guid: GUID of the protocol |
| 186 | * @protocol_interface: protocol interface |
| 187 | * @open_infos link to the list of open protocol info items |
Heinrich Schuchardt | a277d3a | 2018-01-11 08:15:57 +0100 | [diff] [blame] | 188 | */ |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 189 | struct efi_handler { |
Heinrich Schuchardt | 99ce206 | 2017-11-26 14:05:17 +0100 | [diff] [blame] | 190 | struct list_head link; |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 191 | const efi_guid_t *guid; |
xypron.glpk@gmx.de | c35c924 | 2017-07-11 22:06:14 +0200 | [diff] [blame] | 192 | void *protocol_interface; |
Heinrich Schuchardt | a277d3a | 2018-01-11 08:15:57 +0100 | [diff] [blame] | 193 | struct list_head open_infos; |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 194 | }; |
| 195 | |
Heinrich Schuchardt | adb50d0 | 2018-09-26 05:27:55 +0200 | [diff] [blame] | 196 | /** |
Heinrich Schuchardt | b27ced4 | 2019-05-01 14:20:18 +0200 | [diff] [blame] | 197 | * enum efi_object_type - type of EFI object |
| 198 | * |
| 199 | * In UnloadImage we must be able to identify if the handle relates to a |
| 200 | * started image. |
| 201 | */ |
| 202 | enum efi_object_type { |
| 203 | EFI_OBJECT_TYPE_UNDEFINED = 0, |
Heinrich Schuchardt | 2e0a790 | 2019-05-05 16:55:06 +0200 | [diff] [blame] | 204 | EFI_OBJECT_TYPE_U_BOOT_FIRMWARE, |
Heinrich Schuchardt | b27ced4 | 2019-05-01 14:20:18 +0200 | [diff] [blame] | 205 | EFI_OBJECT_TYPE_LOADED_IMAGE, |
| 206 | EFI_OBJECT_TYPE_STARTED_IMAGE, |
| 207 | }; |
| 208 | |
| 209 | /** |
Heinrich Schuchardt | adb50d0 | 2018-09-26 05:27:55 +0200 | [diff] [blame] | 210 | * struct efi_object - dereferenced EFI handle |
| 211 | * |
| 212 | * @link: pointers to put the handle into a linked list |
| 213 | * @protocols: linked list with the protocol interfaces installed on this |
| 214 | * handle |
| 215 | * |
| 216 | * UEFI offers a flexible and expandable object model. The objects in the UEFI |
| 217 | * API are devices, drivers, and loaded images. struct efi_object is our storage |
| 218 | * structure for these objects. |
| 219 | * |
| 220 | * When including this structure into a larger structure always put it first so |
| 221 | * that when deleting a handle the whole encompassing structure can be freed. |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 222 | * |
Heinrich Schuchardt | adb50d0 | 2018-09-26 05:27:55 +0200 | [diff] [blame] | 223 | * A pointer to this structure is referred to as a handle. Typedef efi_handle_t |
| 224 | * has been created for such pointers. |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 225 | */ |
| 226 | struct efi_object { |
| 227 | /* Every UEFI object is part of a global object list */ |
| 228 | struct list_head link; |
Heinrich Schuchardt | 99ce206 | 2017-11-26 14:05:17 +0100 | [diff] [blame] | 229 | /* The list of protocols */ |
| 230 | struct list_head protocols; |
Heinrich Schuchardt | b27ced4 | 2019-05-01 14:20:18 +0200 | [diff] [blame] | 231 | enum efi_object_type type; |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 232 | }; |
| 233 | |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 234 | /** |
Heinrich Schuchardt | 3c3a735 | 2018-09-23 17:21:51 +0200 | [diff] [blame] | 235 | * struct efi_loaded_image_obj - handle of a loaded image |
Heinrich Schuchardt | 7292872 | 2018-09-26 05:27:56 +0200 | [diff] [blame] | 236 | * |
| 237 | * @header: EFI object header |
Heinrich Schuchardt | 3d44512 | 2019-04-30 17:57:30 +0200 | [diff] [blame] | 238 | * @exit_status: exit status passed to Exit() |
| 239 | * @exit_data_size: exit data size passed to Exit() |
| 240 | * @exit_data: exit data passed to Exit() |
Heinrich Schuchardt | 7292872 | 2018-09-26 05:27:56 +0200 | [diff] [blame] | 241 | * @exit_jmp: long jump buffer for returning form started image |
| 242 | * @entry: entry address of the relocated image |
Heinrich Schuchardt | 3c3a735 | 2018-09-23 17:21:51 +0200 | [diff] [blame] | 243 | */ |
| 244 | struct efi_loaded_image_obj { |
Heinrich Schuchardt | 7292872 | 2018-09-26 05:27:56 +0200 | [diff] [blame] | 245 | struct efi_object header; |
Heinrich Schuchardt | 3c3a735 | 2018-09-23 17:21:51 +0200 | [diff] [blame] | 246 | efi_status_t exit_status; |
Heinrich Schuchardt | 3d44512 | 2019-04-30 17:57:30 +0200 | [diff] [blame] | 247 | efi_uintn_t *exit_data_size; |
| 248 | u16 **exit_data; |
Heinrich Schuchardt | 3c3a735 | 2018-09-23 17:21:51 +0200 | [diff] [blame] | 249 | struct jmp_buf_data exit_jmp; |
| 250 | EFIAPI efi_status_t (*entry)(efi_handle_t image_handle, |
| 251 | struct efi_system_table *st); |
Heinrich Schuchardt | 3758752 | 2019-05-01 20:07:04 +0200 | [diff] [blame] | 252 | u16 image_type; |
Heinrich Schuchardt | 3c3a735 | 2018-09-23 17:21:51 +0200 | [diff] [blame] | 253 | }; |
| 254 | |
| 255 | /** |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 256 | * struct efi_event |
| 257 | * |
Heinrich Schuchardt | 370c7a8 | 2018-02-18 15:17:50 +0100 | [diff] [blame] | 258 | * @link: Link to list of all events |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 259 | * @type: Type of event, see efi_create_event |
| 260 | * @notify_tpl: Task priority level of notifications |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 261 | * @nofify_function: Function to call when the event is triggered |
| 262 | * @notify_context: Data to be passed to the notify function |
Heinrich Schuchardt | bf7f169 | 2018-02-18 15:17:52 +0100 | [diff] [blame] | 263 | * @group: Event group |
Heinrich Schuchardt | 370c7a8 | 2018-02-18 15:17:50 +0100 | [diff] [blame] | 264 | * @trigger_time: Period of the timer |
| 265 | * @trigger_next: Next time to trigger the timer |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 266 | * @trigger_type: Type of timer, see efi_set_timer |
Heinrich Schuchardt | 370c7a8 | 2018-02-18 15:17:50 +0100 | [diff] [blame] | 267 | * @is_queued: The notification function is queued |
| 268 | * @is_signaled: The event occurred. The event is in the signaled state. |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 269 | */ |
| 270 | struct efi_event { |
Heinrich Schuchardt | 370c7a8 | 2018-02-18 15:17:50 +0100 | [diff] [blame] | 271 | struct list_head link; |
xypron.glpk@gmx.de | 3ecc6bd | 2017-07-19 19:22:34 +0200 | [diff] [blame] | 272 | uint32_t type; |
Heinrich Schuchardt | f8d4ec3 | 2017-11-06 21:17:47 +0100 | [diff] [blame] | 273 | efi_uintn_t notify_tpl; |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 274 | void (EFIAPI *notify_function)(struct efi_event *event, void *context); |
| 275 | void *notify_context; |
Heinrich Schuchardt | bf7f169 | 2018-02-18 15:17:52 +0100 | [diff] [blame] | 276 | const efi_guid_t *group; |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 277 | u64 trigger_next; |
| 278 | u64 trigger_time; |
xypron.glpk@gmx.de | 3ecc6bd | 2017-07-19 19:22:34 +0200 | [diff] [blame] | 279 | enum efi_timer_delay trigger_type; |
Heinrich Schuchardt | 1bbee39 | 2017-10-04 15:03:24 +0200 | [diff] [blame] | 280 | bool is_queued; |
| 281 | bool is_signaled; |
xypron.glpk@gmx.de | 3070823 | 2017-07-18 20:17:18 +0200 | [diff] [blame] | 282 | }; |
| 283 | |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 284 | /* This list contains all UEFI objects we know of */ |
| 285 | extern struct list_head efi_obj_list; |
Heinrich Schuchardt | bf7f169 | 2018-02-18 15:17:52 +0100 | [diff] [blame] | 286 | /* List of all events */ |
| 287 | extern struct list_head efi_events; |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 288 | |
Heinrich Schuchardt | 6eec42d | 2019-05-04 17:27:54 +0200 | [diff] [blame] | 289 | /** |
Heinrich Schuchardt | d375e75 | 2019-05-21 18:19:01 +0200 | [diff] [blame] | 290 | * struct efi_protocol_notification - handle for notified protocol |
| 291 | * |
| 292 | * When a protocol interface is installed for which an event was registered with |
| 293 | * the RegisterProtocolNotify() service this structure is used to hold the |
| 294 | * handle on which the protocol interface was installed. |
| 295 | * |
| 296 | * @link: link to list of all handles notified for this event |
| 297 | * @handle: handle on which the notified protocol interface was installed |
| 298 | */ |
| 299 | struct efi_protocol_notification { |
| 300 | struct list_head link; |
| 301 | efi_handle_t handle; |
| 302 | }; |
| 303 | |
| 304 | /** |
Heinrich Schuchardt | 6eec42d | 2019-05-04 17:27:54 +0200 | [diff] [blame] | 305 | * efi_register_notify_event - event registered by RegisterProtocolNotify() |
| 306 | * |
| 307 | * The address of this structure serves as registration value. |
| 308 | * |
Heinrich Schuchardt | d375e75 | 2019-05-21 18:19:01 +0200 | [diff] [blame] | 309 | * @link: link to list of all registered events |
| 310 | * @event: registered event. The same event may registered for multiple |
| 311 | * GUIDs. |
| 312 | * @protocol: protocol for which the event is registered |
| 313 | * @handles: linked list of all handles on which the notified protocol was |
| 314 | * installed |
Heinrich Schuchardt | 6eec42d | 2019-05-04 17:27:54 +0200 | [diff] [blame] | 315 | */ |
| 316 | struct efi_register_notify_event { |
| 317 | struct list_head link; |
| 318 | struct efi_event *event; |
| 319 | efi_guid_t protocol; |
Heinrich Schuchardt | d375e75 | 2019-05-21 18:19:01 +0200 | [diff] [blame] | 320 | struct list_head handles; |
Heinrich Schuchardt | 6eec42d | 2019-05-04 17:27:54 +0200 | [diff] [blame] | 321 | }; |
| 322 | |
| 323 | /* List of all events registered by RegisterProtocolNotify() */ |
| 324 | extern struct list_head efi_register_notify_events; |
| 325 | |
AKASHI Takahiro | 7e0badb | 2018-12-30 15:16:55 +0100 | [diff] [blame] | 326 | /* Initialize efi execution environment */ |
| 327 | efi_status_t efi_init_obj_list(void); |
Heinrich Schuchardt | 79d7202 | 2018-09-20 21:58:23 +0200 | [diff] [blame] | 328 | /* Called by bootefi to initialize root node */ |
| 329 | efi_status_t efi_root_node_register(void); |
Heinrich Schuchardt | 15070db | 2018-06-28 12:45:31 +0200 | [diff] [blame] | 330 | /* Called by bootefi to initialize runtime */ |
| 331 | efi_status_t efi_initialize_system_table(void); |
xypron.glpk@gmx.de | 54c7a8e | 2017-07-18 20:17:22 +0200 | [diff] [blame] | 332 | /* Called by bootefi to make console interface available */ |
Heinrich Schuchardt | a92e9ab | 2018-10-02 06:08:26 +0200 | [diff] [blame] | 333 | efi_status_t efi_console_register(void); |
Alexander Graf | e83be45 | 2016-03-04 01:10:02 +0100 | [diff] [blame] | 334 | /* Called by bootefi to make all disk storage accessible as EFI objects */ |
Heinrich Schuchardt | cde7a36 | 2018-02-09 20:55:47 +0100 | [diff] [blame] | 335 | efi_status_t efi_disk_register(void); |
Heinrich Schuchardt | 6f3de6b | 2018-01-19 20:24:47 +0100 | [diff] [blame] | 336 | /* Create handles and protocols for the partitions of a block device */ |
| 337 | int efi_disk_create_partitions(efi_handle_t parent, struct blk_desc *desc, |
| 338 | const char *if_typename, int diskid, |
| 339 | const char *pdevname); |
Alexander Graf | d65783d | 2016-03-15 18:38:21 +0100 | [diff] [blame] | 340 | /* Called by bootefi to make GOP (graphical) interface available */ |
Heinrich Schuchardt | b91c084 | 2018-03-03 15:28:55 +0100 | [diff] [blame] | 341 | efi_status_t efi_gop_register(void); |
Alexander Graf | 94c4b99 | 2016-05-06 21:01:01 +0200 | [diff] [blame] | 342 | /* Called by bootefi to make the network interface available */ |
Heinrich Schuchardt | 6f5c73f | 2018-03-03 15:28:56 +0100 | [diff] [blame] | 343 | efi_status_t efi_net_register(void); |
Heinrich Schuchardt | 18081d4 | 2017-10-18 18:13:04 +0200 | [diff] [blame] | 344 | /* Called by bootefi to make the watchdog available */ |
Heinrich Schuchardt | f2704cc | 2018-03-03 15:28:57 +0100 | [diff] [blame] | 345 | efi_status_t efi_watchdog_register(void); |
Alexander Graf | 66f96e1 | 2016-08-19 01:23:29 +0200 | [diff] [blame] | 346 | /* Called by bootefi to make SMBIOS tables available */ |
Simon Glass | 2e2858f | 2018-05-16 09:42:19 -0600 | [diff] [blame] | 347 | /** |
Bin Meng | 2cfbdae | 2018-06-27 20:38:03 -0700 | [diff] [blame] | 348 | * efi_acpi_register() - write out ACPI tables |
| 349 | * |
| 350 | * Called by bootefi to make ACPI tables available |
| 351 | * |
| 352 | * @return 0 if OK, -ENOMEM if no memory is available for the tables |
| 353 | */ |
| 354 | efi_status_t efi_acpi_register(void); |
| 355 | /** |
Simon Glass | 2e2858f | 2018-05-16 09:42:19 -0600 | [diff] [blame] | 356 | * efi_smbios_register() - write out SMBIOS tables |
| 357 | * |
| 358 | * Called by bootefi to make SMBIOS tables available |
| 359 | * |
| 360 | * @return 0 if OK, -ENOMEM if no memory is available for the tables |
| 361 | */ |
Heinrich Schuchardt | 7a369c4 | 2018-03-03 15:28:54 +0100 | [diff] [blame] | 362 | efi_status_t efi_smbios_register(void); |
Alexander Graf | 94c4b99 | 2016-05-06 21:01:01 +0200 | [diff] [blame] | 363 | |
Rob Clark | 5314203 | 2017-09-13 18:05:34 -0400 | [diff] [blame] | 364 | struct efi_simple_file_system_protocol * |
| 365 | efi_fs_from_path(struct efi_device_path *fp); |
| 366 | |
Alexander Graf | 94c4b99 | 2016-05-06 21:01:01 +0200 | [diff] [blame] | 367 | /* Called by networking code to memorize the dhcp ack package */ |
| 368 | void efi_net_set_dhcp_ack(void *pkt, int len); |
Heinrich Schuchardt | 18081d4 | 2017-10-18 18:13:04 +0200 | [diff] [blame] | 369 | /* Called by efi_set_watchdog_timer to reset the timer */ |
| 370 | efi_status_t efi_set_watchdog(unsigned long timeout); |
Alexander Graf | 94c4b99 | 2016-05-06 21:01:01 +0200 | [diff] [blame] | 371 | |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 372 | /* Called from places to check whether a timer expired */ |
| 373 | void efi_timer_check(void); |
| 374 | /* PE loader implementation */ |
Heinrich Schuchardt | 408fbcc | 2018-12-26 12:49:09 +0100 | [diff] [blame] | 375 | efi_status_t efi_load_pe(struct efi_loaded_image_obj *handle, void *efi, |
| 376 | struct efi_loaded_image *loaded_image_info); |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 377 | /* Called once to store the pristine gd pointer */ |
| 378 | void efi_save_gd(void); |
Rob Clark | 86789d5 | 2017-07-27 08:04:18 -0400 | [diff] [blame] | 379 | /* Special case handler for error/abort that just tries to dtrt to get |
| 380 | * back to u-boot world */ |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 381 | void efi_restore_gd(void); |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 382 | /* Call this to relocate the runtime section to an address space */ |
| 383 | void efi_runtime_relocate(ulong offset, struct efi_mem_desc *map); |
Alexander Graf | 8f19f26 | 2016-03-04 01:10:14 +0100 | [diff] [blame] | 384 | /* Call this to set the current device name */ |
Alexander Graf | c49a1b8 | 2016-04-11 16:16:19 +0200 | [diff] [blame] | 385 | void efi_set_bootdev(const char *dev, const char *devnr, const char *path); |
Heinrich Schuchardt | 967d7de | 2017-11-26 14:05:23 +0100 | [diff] [blame] | 386 | /* Add a new object to the object list. */ |
Heinrich Schuchardt | adb50d0 | 2018-09-26 05:27:55 +0200 | [diff] [blame] | 387 | void efi_add_handle(efi_handle_t obj); |
Heinrich Schuchardt | eb6106e | 2017-10-26 19:25:49 +0200 | [diff] [blame] | 388 | /* Create handle */ |
Heinrich Schuchardt | b7cb8b4 | 2018-01-11 08:16:09 +0100 | [diff] [blame] | 389 | efi_status_t efi_create_handle(efi_handle_t *handle); |
Heinrich Schuchardt | 7d13546 | 2017-12-04 18:03:02 +0100 | [diff] [blame] | 390 | /* Delete handle */ |
Heinrich Schuchardt | adb50d0 | 2018-09-26 05:27:55 +0200 | [diff] [blame] | 391 | void efi_delete_handle(efi_handle_t obj); |
Heinrich Schuchardt | 274cc87 | 2017-11-06 21:17:50 +0100 | [diff] [blame] | 392 | /* Call this to validate a handle and find the EFI object for it */ |
Heinrich Schuchardt | b7cb8b4 | 2018-01-11 08:16:09 +0100 | [diff] [blame] | 393 | struct efi_object *efi_search_obj(const efi_handle_t handle); |
AKASHI Takahiro | b0ad905 | 2019-03-05 14:53:31 +0900 | [diff] [blame] | 394 | /* Load image */ |
| 395 | efi_status_t EFIAPI efi_load_image(bool boot_policy, |
| 396 | efi_handle_t parent_image, |
| 397 | struct efi_device_path *file_path, |
| 398 | void *source_buffer, |
| 399 | efi_uintn_t source_size, |
| 400 | efi_handle_t *image_handle); |
Heinrich Schuchardt | 2f8eb08 | 2018-12-26 13:28:09 +0100 | [diff] [blame] | 401 | /* Start image */ |
| 402 | efi_status_t EFIAPI efi_start_image(efi_handle_t image_handle, |
| 403 | efi_uintn_t *exit_data_size, |
| 404 | u16 **exit_data); |
AKASHI Takahiro | b0ad905 | 2019-03-05 14:53:31 +0900 | [diff] [blame] | 405 | /* Unload image */ |
| 406 | efi_status_t EFIAPI efi_unload_image(efi_handle_t image_handle); |
Heinrich Schuchardt | 5aef61d | 2017-10-26 19:25:53 +0200 | [diff] [blame] | 407 | /* Find a protocol on a handle */ |
Heinrich Schuchardt | b7cb8b4 | 2018-01-11 08:16:09 +0100 | [diff] [blame] | 408 | efi_status_t efi_search_protocol(const efi_handle_t handle, |
Heinrich Schuchardt | 5aef61d | 2017-10-26 19:25:53 +0200 | [diff] [blame] | 409 | const efi_guid_t *protocol_guid, |
| 410 | struct efi_handler **handler); |
| 411 | /* Install new protocol on a handle */ |
Heinrich Schuchardt | b7cb8b4 | 2018-01-11 08:16:09 +0100 | [diff] [blame] | 412 | efi_status_t efi_add_protocol(const efi_handle_t handle, |
| 413 | const efi_guid_t *protocol, |
Heinrich Schuchardt | 5aef61d | 2017-10-26 19:25:53 +0200 | [diff] [blame] | 414 | void *protocol_interface); |
| 415 | /* Delete protocol from a handle */ |
Heinrich Schuchardt | b7cb8b4 | 2018-01-11 08:16:09 +0100 | [diff] [blame] | 416 | efi_status_t efi_remove_protocol(const efi_handle_t handle, |
| 417 | const efi_guid_t *protocol, |
Heinrich Schuchardt | 5aef61d | 2017-10-26 19:25:53 +0200 | [diff] [blame] | 418 | void *protocol_interface); |
| 419 | /* Delete all protocols from a handle */ |
Heinrich Schuchardt | b7cb8b4 | 2018-01-11 08:16:09 +0100 | [diff] [blame] | 420 | efi_status_t efi_remove_all_protocols(const efi_handle_t handle); |
Heinrich Schuchardt | 744d83e | 2019-04-12 06:59:49 +0200 | [diff] [blame] | 421 | /* Install multiple protocol interfaces */ |
| 422 | efi_status_t EFIAPI efi_install_multiple_protocol_interfaces |
| 423 | (efi_handle_t *handle, ...); |
xypron.glpk@gmx.de | 852a0e177 | 2017-07-18 20:17:20 +0200 | [diff] [blame] | 424 | /* Call this to create an event */ |
Heinrich Schuchardt | f8d4ec3 | 2017-11-06 21:17:47 +0100 | [diff] [blame] | 425 | efi_status_t efi_create_event(uint32_t type, efi_uintn_t notify_tpl, |
xypron.glpk@gmx.de | 852a0e177 | 2017-07-18 20:17:20 +0200 | [diff] [blame] | 426 | void (EFIAPI *notify_function) ( |
| 427 | struct efi_event *event, |
| 428 | void *context), |
Heinrich Schuchardt | bf7f169 | 2018-02-18 15:17:52 +0100 | [diff] [blame] | 429 | void *notify_context, efi_guid_t *group, |
| 430 | struct efi_event **event); |
xypron.glpk@gmx.de | a587fd1 | 2017-07-18 20:17:21 +0200 | [diff] [blame] | 431 | /* Call this to set a timer */ |
xypron.glpk@gmx.de | 3ecc6bd | 2017-07-19 19:22:34 +0200 | [diff] [blame] | 432 | efi_status_t efi_set_timer(struct efi_event *event, enum efi_timer_delay type, |
xypron.glpk@gmx.de | a587fd1 | 2017-07-18 20:17:21 +0200 | [diff] [blame] | 433 | uint64_t trigger_time); |
xypron.glpk@gmx.de | 54c7a8e | 2017-07-18 20:17:22 +0200 | [diff] [blame] | 434 | /* Call this to signal an event */ |
Heinrich Schuchardt | d8b878a | 2018-01-19 20:24:51 +0100 | [diff] [blame] | 435 | void efi_signal_event(struct efi_event *event, bool check_tpl); |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 436 | |
Rob Clark | 5314203 | 2017-09-13 18:05:34 -0400 | [diff] [blame] | 437 | /* open file system: */ |
| 438 | struct efi_simple_file_system_protocol *efi_simple_file_system( |
| 439 | struct blk_desc *desc, int part, struct efi_device_path *dp); |
| 440 | |
| 441 | /* open file from device-path: */ |
| 442 | struct efi_file_handle *efi_file_from_path(struct efi_device_path *fp); |
| 443 | |
Heinrich Schuchardt | dcdca29 | 2018-11-18 17:58:49 +0100 | [diff] [blame] | 444 | /** |
| 445 | * efi_size_in_pages() - convert size in bytes to size in pages |
| 446 | * |
| 447 | * This macro returns the number of EFI memory pages required to hold 'size' |
| 448 | * bytes. |
| 449 | * |
| 450 | * @size: size in bytes |
| 451 | * Return: size in pages |
| 452 | */ |
| 453 | #define efi_size_in_pages(size) ((size + EFI_PAGE_MASK) >> EFI_PAGE_SHIFT) |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 454 | /* Generic EFI memory allocator, call this to get memory */ |
| 455 | void *efi_alloc(uint64_t len, int memory_type); |
| 456 | /* More specific EFI memory allocator, called by EFI payloads */ |
Heinrich Schuchardt | 798a441 | 2017-11-06 21:17:48 +0100 | [diff] [blame] | 457 | efi_status_t efi_allocate_pages(int type, int memory_type, efi_uintn_t pages, |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 458 | uint64_t *memory); |
Stefan Brüns | a4f4302 | 2016-10-01 23:32:27 +0200 | [diff] [blame] | 459 | /* EFI memory free function. */ |
Heinrich Schuchardt | 798a441 | 2017-11-06 21:17:48 +0100 | [diff] [blame] | 460 | efi_status_t efi_free_pages(uint64_t memory, efi_uintn_t pages); |
Stefan Brüns | 5a09aef | 2016-10-09 22:17:18 +0200 | [diff] [blame] | 461 | /* EFI memory allocator for small allocations */ |
Heinrich Schuchardt | 798a441 | 2017-11-06 21:17:48 +0100 | [diff] [blame] | 462 | efi_status_t efi_allocate_pool(int pool_type, efi_uintn_t size, |
Stefan Brüns | 5a09aef | 2016-10-09 22:17:18 +0200 | [diff] [blame] | 463 | void **buffer); |
Stefan Brüns | 67b67d9 | 2016-10-09 22:17:26 +0200 | [diff] [blame] | 464 | /* EFI pool memory free function. */ |
| 465 | efi_status_t efi_free_pool(void *buffer); |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 466 | /* Returns the EFI memory map */ |
Heinrich Schuchardt | 798a441 | 2017-11-06 21:17:48 +0100 | [diff] [blame] | 467 | efi_status_t efi_get_memory_map(efi_uintn_t *memory_map_size, |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 468 | struct efi_mem_desc *memory_map, |
Heinrich Schuchardt | 798a441 | 2017-11-06 21:17:48 +0100 | [diff] [blame] | 469 | efi_uintn_t *map_key, |
| 470 | efi_uintn_t *descriptor_size, |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 471 | uint32_t *descriptor_version); |
| 472 | /* Adds a range into the EFI memory map */ |
| 473 | uint64_t efi_add_memory_map(uint64_t start, uint64_t pages, int memory_type, |
| 474 | bool overlap_only_ram); |
Heinrich Schuchardt | 11206f4 | 2018-01-21 19:29:30 +0100 | [diff] [blame] | 475 | /* Called by board init to initialize the EFI drivers */ |
Heinrich Schuchardt | 8f3cc5b | 2018-02-01 12:53:32 +0100 | [diff] [blame] | 476 | efi_status_t efi_driver_init(void); |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 477 | /* Called by board init to initialize the EFI memory map */ |
| 478 | int efi_memory_init(void); |
Alexander Graf | c5c1163 | 2016-08-19 01:23:24 +0200 | [diff] [blame] | 479 | /* Adds new or overrides configuration table entry to the system table */ |
| 480 | efi_status_t efi_install_configuration_table(const efi_guid_t *guid, void *table); |
Heinrich Schuchardt | 7db9f89 | 2017-12-04 18:03:01 +0100 | [diff] [blame] | 481 | /* Sets up a loaded image */ |
Heinrich Schuchardt | 3c3a735 | 2018-09-23 17:21:51 +0200 | [diff] [blame] | 482 | efi_status_t efi_setup_loaded_image(struct efi_device_path *device_path, |
| 483 | struct efi_device_path *file_path, |
| 484 | struct efi_loaded_image_obj **handle_ptr, |
| 485 | struct efi_loaded_image **info_ptr); |
Heinrich Schuchardt | 83d96b7 | 2018-04-05 11:56:21 +0200 | [diff] [blame] | 486 | /* Print information about all loaded images */ |
| 487 | void efi_print_image_infos(void *pc); |
Alexander Graf | 8623f92 | 2016-03-04 01:10:04 +0100 | [diff] [blame] | 488 | |
Alexander Graf | 7c00a3c | 2016-05-11 18:25:48 +0200 | [diff] [blame] | 489 | #ifdef CONFIG_EFI_LOADER_BOUNCE_BUFFER |
| 490 | extern void *efi_bounce_buffer; |
| 491 | #define EFI_LOADER_BOUNCE_BUFFER_SIZE (64 * 1024 * 1024) |
| 492 | #endif |
| 493 | |
Rob Clark | f90cb9f | 2017-09-13 18:05:28 -0400 | [diff] [blame] | 494 | |
| 495 | struct efi_device_path *efi_dp_next(const struct efi_device_path *dp); |
Heinrich Schuchardt | 753e248 | 2017-10-26 19:25:48 +0200 | [diff] [blame] | 496 | int efi_dp_match(const struct efi_device_path *a, |
| 497 | const struct efi_device_path *b); |
Rob Clark | f90cb9f | 2017-09-13 18:05:28 -0400 | [diff] [blame] | 498 | struct efi_object *efi_dp_find_obj(struct efi_device_path *dp, |
| 499 | struct efi_device_path **rem); |
Heinrich Schuchardt | 51ca4f5 | 2018-04-16 07:59:08 +0200 | [diff] [blame] | 500 | /* get size of the first device path instance excluding end node */ |
| 501 | efi_uintn_t efi_dp_instance_size(const struct efi_device_path *dp); |
| 502 | /* size of multi-instance device path excluding end node */ |
| 503 | efi_uintn_t efi_dp_size(const struct efi_device_path *dp); |
Rob Clark | f90cb9f | 2017-09-13 18:05:28 -0400 | [diff] [blame] | 504 | struct efi_device_path *efi_dp_dup(const struct efi_device_path *dp); |
| 505 | struct efi_device_path *efi_dp_append(const struct efi_device_path *dp1, |
| 506 | const struct efi_device_path *dp2); |
| 507 | struct efi_device_path *efi_dp_append_node(const struct efi_device_path *dp, |
| 508 | const struct efi_device_path *node); |
Heinrich Schuchardt | b41c8e2 | 2018-04-16 07:59:05 +0200 | [diff] [blame] | 509 | /* Create a device path node of given type, sub-type, length */ |
| 510 | struct efi_device_path *efi_dp_create_device_node(const u8 type, |
| 511 | const u8 sub_type, |
| 512 | const u16 length); |
Heinrich Schuchardt | cb0f7ce | 2018-04-16 07:59:09 +0200 | [diff] [blame] | 513 | /* Append device path instance */ |
| 514 | struct efi_device_path *efi_dp_append_instance( |
| 515 | const struct efi_device_path *dp, |
| 516 | const struct efi_device_path *dpi); |
| 517 | /* Get next device path instance */ |
| 518 | struct efi_device_path *efi_dp_get_next_instance(struct efi_device_path **dp, |
| 519 | efi_uintn_t *size); |
| 520 | /* Check if a device path contains muliple instances */ |
| 521 | bool efi_dp_is_multi_instance(const struct efi_device_path *dp); |
Rob Clark | f90cb9f | 2017-09-13 18:05:28 -0400 | [diff] [blame] | 522 | |
| 523 | struct efi_device_path *efi_dp_from_dev(struct udevice *dev); |
| 524 | struct efi_device_path *efi_dp_from_part(struct blk_desc *desc, int part); |
Heinrich Schuchardt | 6c6307c | 2018-01-19 20:24:46 +0100 | [diff] [blame] | 525 | /* Create a device node for a block device partition. */ |
| 526 | struct efi_device_path *efi_dp_part_node(struct blk_desc *desc, int part); |
Rob Clark | f90cb9f | 2017-09-13 18:05:28 -0400 | [diff] [blame] | 527 | struct efi_device_path *efi_dp_from_file(struct blk_desc *desc, int part, |
| 528 | const char *path); |
| 529 | struct efi_device_path *efi_dp_from_eth(void); |
Rob Clark | 18ceba7 | 2017-10-10 08:23:06 -0400 | [diff] [blame] | 530 | struct efi_device_path *efi_dp_from_mem(uint32_t mem_type, |
| 531 | uint64_t start_address, |
| 532 | uint64_t end_address); |
Heinrich Schuchardt | 0976f8b | 2018-01-19 20:24:49 +0100 | [diff] [blame] | 533 | /* Determine the last device path node that is not the end node. */ |
| 534 | const struct efi_device_path *efi_dp_last_node( |
| 535 | const struct efi_device_path *dp); |
Heinrich Schuchardt | 468bf97 | 2018-01-19 20:24:37 +0100 | [diff] [blame] | 536 | efi_status_t efi_dp_split_file_path(struct efi_device_path *full_path, |
| 537 | struct efi_device_path **device_path, |
| 538 | struct efi_device_path **file_path); |
AKASHI Takahiro | 035fb01 | 2018-10-17 16:32:03 +0900 | [diff] [blame] | 539 | efi_status_t efi_dp_from_name(const char *dev, const char *devnr, |
| 540 | const char *path, |
| 541 | struct efi_device_path **device, |
| 542 | struct efi_device_path **file); |
Rob Clark | f90cb9f | 2017-09-13 18:05:28 -0400 | [diff] [blame] | 543 | |
| 544 | #define EFI_DP_TYPE(_dp, _type, _subtype) \ |
| 545 | (((_dp)->type == DEVICE_PATH_TYPE_##_type) && \ |
| 546 | ((_dp)->sub_type == DEVICE_PATH_SUB_TYPE_##_subtype)) |
| 547 | |
Heinrich Schuchardt | 7b588f4 | 2018-09-20 19:57:54 +0200 | [diff] [blame] | 548 | /** |
| 549 | * ascii2unicode() - convert ASCII string to UTF-16 string |
| 550 | * |
| 551 | * A zero terminated ASCII string is converted to a zero terminated UTF-16 |
| 552 | * string. The output buffer must be preassigned. |
| 553 | * |
| 554 | * @unicode: preassigned output buffer for UTF-16 string |
| 555 | * @ascii: ASCII string to be converted |
| 556 | */ |
Simon Glass | 302d4f8 | 2016-05-14 14:03:05 -0600 | [diff] [blame] | 557 | static inline void ascii2unicode(u16 *unicode, const char *ascii) |
Alexander Graf | 8f19f26 | 2016-03-04 01:10:14 +0100 | [diff] [blame] | 558 | { |
| 559 | while (*ascii) |
| 560 | *(unicode++) = *(ascii++); |
Heinrich Schuchardt | 164026c | 2018-04-04 15:42:10 +0200 | [diff] [blame] | 561 | *unicode = 0; |
Alexander Graf | 8f19f26 | 2016-03-04 01:10:14 +0100 | [diff] [blame] | 562 | } |
| 563 | |
Rob Clark | 544df3b | 2017-07-24 07:59:11 -0400 | [diff] [blame] | 564 | static inline int guidcmp(const efi_guid_t *g1, const efi_guid_t *g2) |
| 565 | { |
| 566 | return memcmp(g1, g2, sizeof(efi_guid_t)); |
| 567 | } |
| 568 | |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 569 | /* |
| 570 | * Use these to indicate that your code / data should go into the EFI runtime |
| 571 | * section and thus still be available when the OS is running |
| 572 | */ |
Alexander Graf | 94a10f2 | 2018-06-12 07:48:37 +0200 | [diff] [blame] | 573 | #define __efi_runtime_data __attribute__ ((section (".data.efi_runtime"))) |
| 574 | #define __efi_runtime __attribute__ ((section (".text.efi_runtime"))) |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 575 | |
Heinrich Schuchardt | 69c1576 | 2018-07-29 09:49:04 +0200 | [diff] [blame] | 576 | /* Update CRC32 in table header */ |
| 577 | void __efi_runtime efi_update_table_header_crc32(struct efi_table_hdr *table); |
| 578 | |
Alexander Graf | 7725609 | 2016-08-16 21:08:45 +0200 | [diff] [blame] | 579 | /* Call this with mmio_ptr as the _pointer_ to a pointer to an MMIO region |
| 580 | * to make it available at runtime */ |
Heinrich Schuchardt | 099b3b7 | 2018-03-03 15:28:59 +0100 | [diff] [blame] | 581 | efi_status_t efi_add_runtime_mmio(void *mmio_ptr, u64 len); |
Alexander Graf | 7725609 | 2016-08-16 21:08:45 +0200 | [diff] [blame] | 582 | |
| 583 | /* Boards may provide the functions below to implement RTS functionality */ |
| 584 | |
Alexander Graf | 393dd91 | 2016-10-14 13:45:30 +0200 | [diff] [blame] | 585 | void __efi_runtime EFIAPI efi_reset_system( |
Alexander Graf | 7725609 | 2016-08-16 21:08:45 +0200 | [diff] [blame] | 586 | enum efi_reset_type reset_type, |
| 587 | efi_status_t reset_status, |
| 588 | unsigned long data_size, void *reset_data); |
Heinrich Schuchardt | 099b3b7 | 2018-03-03 15:28:59 +0100 | [diff] [blame] | 589 | |
| 590 | /* Architecture specific initialization of the EFI subsystem */ |
| 591 | efi_status_t efi_reset_system_init(void); |
Alexander Graf | 7725609 | 2016-08-16 21:08:45 +0200 | [diff] [blame] | 592 | |
Alexander Graf | 393dd91 | 2016-10-14 13:45:30 +0200 | [diff] [blame] | 593 | efi_status_t __efi_runtime EFIAPI efi_get_time( |
Alexander Graf | 7725609 | 2016-08-16 21:08:45 +0200 | [diff] [blame] | 594 | struct efi_time *time, |
| 595 | struct efi_time_cap *capabilities); |
Alexander Graf | 7725609 | 2016-08-16 21:08:45 +0200 | [diff] [blame] | 596 | |
Heinrich Schuchardt | 289121e | 2019-05-31 07:38:29 +0200 | [diff] [blame] | 597 | efi_status_t __efi_runtime EFIAPI efi_set_time(struct efi_time *time); |
| 598 | |
Heinrich Schuchardt | d33ae3e | 2017-09-15 10:06:11 +0200 | [diff] [blame] | 599 | #ifdef CONFIG_CMD_BOOTEFI_SELFTEST |
| 600 | /* |
| 601 | * Entry point for the tests of the EFI API. |
| 602 | * It is called by 'bootefi selftest' |
| 603 | */ |
| 604 | efi_status_t EFIAPI efi_selftest(efi_handle_t image_handle, |
| 605 | struct efi_system_table *systab); |
| 606 | #endif |
| 607 | |
Heinrich Schuchardt | e06ae19 | 2018-12-30 20:53:51 +0100 | [diff] [blame] | 608 | efi_status_t EFIAPI efi_get_variable(u16 *variable_name, |
| 609 | const efi_guid_t *vendor, u32 *attributes, |
| 610 | efi_uintn_t *data_size, void *data); |
Heinrich Schuchardt | d6a6baa | 2018-05-17 07:57:05 +0200 | [diff] [blame] | 611 | efi_status_t EFIAPI efi_get_next_variable_name(efi_uintn_t *variable_name_size, |
| 612 | u16 *variable_name, |
Heinrich Schuchardt | e06ae19 | 2018-12-30 20:53:51 +0100 | [diff] [blame] | 613 | const efi_guid_t *vendor); |
| 614 | efi_status_t EFIAPI efi_set_variable(u16 *variable_name, |
| 615 | const efi_guid_t *vendor, u32 attributes, |
Heinrich Schuchardt | 73e2ab0 | 2018-12-30 21:03:15 +0100 | [diff] [blame] | 616 | efi_uintn_t data_size, const void *data); |
Rob Clark | 15f3d74 | 2017-09-13 18:05:37 -0400 | [diff] [blame] | 617 | |
AKASHI Takahiro | bd23774 | 2018-11-05 18:06:41 +0900 | [diff] [blame] | 618 | /* |
| 619 | * See section 3.1.3 in the v2.7 UEFI spec for more details on |
| 620 | * the layout of EFI_LOAD_OPTION. In short it is: |
| 621 | * |
| 622 | * typedef struct _EFI_LOAD_OPTION { |
| 623 | * UINT32 Attributes; |
| 624 | * UINT16 FilePathListLength; |
| 625 | * // CHAR16 Description[]; <-- variable length, NULL terminated |
| 626 | * // EFI_DEVICE_PATH_PROTOCOL FilePathList[]; |
| 627 | * <-- FilePathListLength bytes |
| 628 | * // UINT8 OptionalData[]; |
| 629 | * } EFI_LOAD_OPTION; |
| 630 | */ |
| 631 | struct efi_load_option { |
| 632 | u32 attributes; |
| 633 | u16 file_path_length; |
| 634 | u16 *label; |
| 635 | struct efi_device_path *file_path; |
Heinrich Schuchardt | 9df002e | 2019-04-29 13:51:45 +0200 | [diff] [blame] | 636 | const u8 *optional_data; |
AKASHI Takahiro | bd23774 | 2018-11-05 18:06:41 +0900 | [diff] [blame] | 637 | }; |
| 638 | |
| 639 | void efi_deserialize_load_option(struct efi_load_option *lo, u8 *data); |
| 640 | unsigned long efi_serialize_load_option(struct efi_load_option *lo, u8 **data); |
AKASHI Takahiro | 14ff23b | 2019-04-19 12:22:35 +0900 | [diff] [blame] | 641 | efi_status_t efi_bootmgr_load(efi_handle_t *handle); |
Rob Clark | c84c110 | 2017-09-13 18:05:38 -0400 | [diff] [blame] | 642 | |
Stephen Warren | d0de806 | 2018-08-30 15:43:43 -0600 | [diff] [blame] | 643 | #else /* CONFIG_IS_ENABLED(EFI_LOADER) */ |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 644 | |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 645 | /* Without CONFIG_EFI_LOADER we don't have a runtime section, stub it out */ |
Alexander Graf | 393dd91 | 2016-10-14 13:45:30 +0200 | [diff] [blame] | 646 | #define __efi_runtime_data |
| 647 | #define __efi_runtime |
Heinrich Schuchardt | 099b3b7 | 2018-03-03 15:28:59 +0100 | [diff] [blame] | 648 | static inline efi_status_t efi_add_runtime_mmio(void *mmio_ptr, u64 len) |
| 649 | { |
| 650 | return EFI_SUCCESS; |
| 651 | } |
Alexander Graf | 0bd425a | 2016-03-04 01:10:01 +0100 | [diff] [blame] | 652 | |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 653 | /* No loader configured, stub out EFI_ENTRY */ |
| 654 | static inline void efi_restore_gd(void) { } |
Alexander Graf | c49a1b8 | 2016-04-11 16:16:19 +0200 | [diff] [blame] | 655 | static inline void efi_set_bootdev(const char *dev, const char *devnr, |
| 656 | const char *path) { } |
Alexander Graf | 94c4b99 | 2016-05-06 21:01:01 +0200 | [diff] [blame] | 657 | static inline void efi_net_set_dhcp_ack(void *pkt, int len) { } |
Heinrich Schuchardt | 83d96b7 | 2018-04-05 11:56:21 +0200 | [diff] [blame] | 658 | static inline void efi_print_image_infos(void *pc) { } |
Alexander Graf | c15d921 | 2016-03-04 01:09:59 +0100 | [diff] [blame] | 659 | |
Stephen Warren | d0de806 | 2018-08-30 15:43:43 -0600 | [diff] [blame] | 660 | #endif /* CONFIG_IS_ENABLED(EFI_LOADER) */ |
Heinrich Schuchardt | c2fd477 | 2017-10-18 18:13:07 +0200 | [diff] [blame] | 661 | |
| 662 | #endif /* _EFI_LOADER_H */ |