1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Extensible Firmware Interface 4 * Based on 'Extensible Firmware Interface Specification' version 0.9, 5 * April 30, 1999 6 * 7 * Copyright (C) 1999 VA Linux Systems 8 * Copyright (C) 1999 Walt Drummond <drummond@valinux.com> 9 * Copyright (C) 1999, 2002-2003 Hewlett-Packard Co. 10 * David Mosberger-Tang <davidm@hpl.hp.com> 11 * Stephane Eranian <eranian@hpl.hp.com> 12 * 13 * From include/linux/efi.h in kernel 4.1 with some additions/subtractions 14 */ 15 16 #ifndef _EFI_API_H 17 #define _EFI_API_H 18 19 #include <efi.h> 20 21 #ifdef CONFIG_EFI_LOADER 22 #include <asm/setjmp.h> 23 #endif 24 25 /* UEFI spec version 2.7 */ 26 #define EFI_SPECIFICATION_VERSION (2 << 16 | 70) 27 28 /* Types and defines for EFI CreateEvent */ 29 enum efi_timer_delay { 30 EFI_TIMER_STOP = 0, 31 EFI_TIMER_PERIODIC = 1, 32 EFI_TIMER_RELATIVE = 2 33 }; 34 35 #define efi_intn_t ssize_t 36 #define efi_uintn_t size_t 37 typedef uint16_t *efi_string_t; 38 39 #define EVT_TIMER 0x80000000 40 #define EVT_RUNTIME 0x40000000 41 #define EVT_NOTIFY_WAIT 0x00000100 42 #define EVT_NOTIFY_SIGNAL 0x00000200 43 #define EVT_SIGNAL_EXIT_BOOT_SERVICES 0x00000201 44 #define EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE 0x60000202 45 46 #define TPL_APPLICATION 0x04 47 #define TPL_CALLBACK 0x08 48 #define TPL_NOTIFY 0x10 49 #define TPL_HIGH_LEVEL 0x1F 50 51 struct efi_event; 52 53 /* EFI Boot Services table */ 54 #define EFI_BOOT_SERVICES_SIGNATURE 0x56524553544f4f42 55 struct efi_boot_services { 56 struct efi_table_hdr hdr; 57 efi_status_t (EFIAPI *raise_tpl)(efi_uintn_t new_tpl); 58 void (EFIAPI *restore_tpl)(efi_uintn_t old_tpl); 59 60 efi_status_t (EFIAPI *allocate_pages)(int, int, efi_uintn_t, 61 efi_physical_addr_t *); 62 efi_status_t (EFIAPI *free_pages)(efi_physical_addr_t, efi_uintn_t); 63 efi_status_t (EFIAPI *get_memory_map)(efi_uintn_t *memory_map_size, 64 struct efi_mem_desc *desc, 65 efi_uintn_t *key, 66 efi_uintn_t *desc_size, 67 u32 *desc_version); 68 efi_status_t (EFIAPI *allocate_pool)(int, efi_uintn_t, void **); 69 efi_status_t (EFIAPI *free_pool)(void *); 70 71 efi_status_t (EFIAPI *create_event)(uint32_t type, 72 efi_uintn_t notify_tpl, 73 void (EFIAPI *notify_function) ( 74 struct efi_event *event, 75 void *context), 76 void *notify_context, struct efi_event **event); 77 efi_status_t (EFIAPI *set_timer)(struct efi_event *event, 78 enum efi_timer_delay type, 79 uint64_t trigger_time); 80 efi_status_t (EFIAPI *wait_for_event)(efi_uintn_t number_of_events, 81 struct efi_event **event, 82 efi_uintn_t *index); 83 efi_status_t (EFIAPI *signal_event)(struct efi_event *event); 84 efi_status_t (EFIAPI *close_event)(struct efi_event *event); 85 efi_status_t (EFIAPI *check_event)(struct efi_event *event); 86 #define EFI_NATIVE_INTERFACE 0x00000000 87 efi_status_t (EFIAPI *install_protocol_interface)( 88 efi_handle_t *handle, const efi_guid_t *protocol, 89 int protocol_interface_type, void *protocol_interface); 90 efi_status_t (EFIAPI *reinstall_protocol_interface)( 91 efi_handle_t handle, const efi_guid_t *protocol, 92 void *old_interface, void *new_interface); 93 efi_status_t (EFIAPI *uninstall_protocol_interface)( 94 efi_handle_t handle, const efi_guid_t *protocol, 95 void *protocol_interface); 96 efi_status_t (EFIAPI *handle_protocol)( 97 efi_handle_t handle, const efi_guid_t *protocol, 98 void **protocol_interface); 99 void *reserved; 100 efi_status_t (EFIAPI *register_protocol_notify)( 101 const efi_guid_t *protocol, struct efi_event *event, 102 void **registration); 103 efi_status_t (EFIAPI *locate_handle)( 104 enum efi_locate_search_type search_type, 105 const efi_guid_t *protocol, void *search_key, 106 efi_uintn_t *buffer_size, efi_handle_t *buffer); 107 efi_status_t (EFIAPI *locate_device_path)(const efi_guid_t *protocol, 108 struct efi_device_path **device_path, 109 efi_handle_t *device); 110 efi_status_t (EFIAPI *install_configuration_table)( 111 efi_guid_t *guid, void *table); 112 113 efi_status_t (EFIAPI *load_image)(bool boot_policiy, 114 efi_handle_t parent_image, 115 struct efi_device_path *file_path, void *source_buffer, 116 efi_uintn_t source_size, efi_handle_t *image); 117 efi_status_t (EFIAPI *start_image)(efi_handle_t handle, 118 efi_uintn_t *exitdata_size, 119 u16 **exitdata); 120 efi_status_t (EFIAPI *exit)(efi_handle_t handle, 121 efi_status_t exit_status, 122 efi_uintn_t exitdata_size, u16 *exitdata); 123 efi_status_t (EFIAPI *unload_image)(efi_handle_t image_handle); 124 efi_status_t (EFIAPI *exit_boot_services)(efi_handle_t, unsigned long); 125 126 efi_status_t (EFIAPI *get_next_monotonic_count)(u64 *count); 127 efi_status_t (EFIAPI *stall)(unsigned long usecs); 128 efi_status_t (EFIAPI *set_watchdog_timer)(unsigned long timeout, 129 uint64_t watchdog_code, unsigned long data_size, 130 uint16_t *watchdog_data); 131 efi_status_t(EFIAPI *connect_controller)(efi_handle_t controller_handle, 132 efi_handle_t *driver_image_handle, 133 struct efi_device_path *remaining_device_path, 134 bool recursive); 135 efi_status_t (EFIAPI *disconnect_controller)( 136 efi_handle_t controller_handle, 137 efi_handle_t driver_image_handle, 138 efi_handle_t child_handle); 139 #define EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL 0x00000001 140 #define EFI_OPEN_PROTOCOL_GET_PROTOCOL 0x00000002 141 #define EFI_OPEN_PROTOCOL_TEST_PROTOCOL 0x00000004 142 #define EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER 0x00000008 143 #define EFI_OPEN_PROTOCOL_BY_DRIVER 0x00000010 144 #define EFI_OPEN_PROTOCOL_EXCLUSIVE 0x00000020 145 efi_status_t (EFIAPI *open_protocol)(efi_handle_t handle, 146 const efi_guid_t *protocol, void **interface, 147 efi_handle_t agent_handle, 148 efi_handle_t controller_handle, u32 attributes); 149 efi_status_t (EFIAPI *close_protocol)( 150 efi_handle_t handle, const efi_guid_t *protocol, 151 efi_handle_t agent_handle, 152 efi_handle_t controller_handle); 153 efi_status_t(EFIAPI *open_protocol_information)(efi_handle_t handle, 154 const efi_guid_t *protocol, 155 struct efi_open_protocol_info_entry **entry_buffer, 156 efi_uintn_t *entry_count); 157 efi_status_t (EFIAPI *protocols_per_handle)(efi_handle_t handle, 158 efi_guid_t ***protocol_buffer, 159 efi_uintn_t *protocols_buffer_count); 160 efi_status_t (EFIAPI *locate_handle_buffer) ( 161 enum efi_locate_search_type search_type, 162 const efi_guid_t *protocol, void *search_key, 163 efi_uintn_t *no_handles, efi_handle_t **buffer); 164 efi_status_t (EFIAPI *locate_protocol)(const efi_guid_t *protocol, 165 void *registration, void **protocol_interface); 166 efi_status_t (EFIAPI *install_multiple_protocol_interfaces)( 167 efi_handle_t *handle, ...); 168 efi_status_t (EFIAPI *uninstall_multiple_protocol_interfaces)( 169 efi_handle_t handle, ...); 170 efi_status_t (EFIAPI *calculate_crc32)(const void *data, 171 efi_uintn_t data_size, 172 u32 *crc32); 173 void (EFIAPI *copy_mem)(void *destination, const void *source, 174 size_t length); 175 void (EFIAPI *set_mem)(void *buffer, size_t size, uint8_t value); 176 efi_status_t (EFIAPI *create_event_ex)( 177 uint32_t type, efi_uintn_t notify_tpl, 178 void (EFIAPI *notify_function) ( 179 struct efi_event *event, 180 void *context), 181 void *notify_context, 182 efi_guid_t *event_group, 183 struct efi_event **event); 184 }; 185 186 /* Types and defines for EFI ResetSystem */ 187 enum efi_reset_type { 188 EFI_RESET_COLD = 0, 189 EFI_RESET_WARM = 1, 190 EFI_RESET_SHUTDOWN = 2, 191 EFI_RESET_PLATFORM_SPECIFIC = 3, 192 }; 193 194 /* EFI Runtime Services table */ 195 #define EFI_RUNTIME_SERVICES_SIGNATURE 0x56524553544e5552ULL 196 197 #define CAPSULE_FLAGS_PERSIST_ACROSS_RESET 0x00010000 198 #define CAPSULE_FLAGS_POPULATE_SYSTEM_TABLE 0x00020000 199 #define CAPSULE_FLAGS_INITIATE_RESET 0x00040000 200 201 struct efi_capsule_header { 202 efi_guid_t *capsule_guid; 203 u32 header_size; 204 u32 flags; 205 u32 capsule_image_size; 206 }; 207 208 struct efi_runtime_services { 209 struct efi_table_hdr hdr; 210 efi_status_t (EFIAPI *get_time)(struct efi_time *time, 211 struct efi_time_cap *capabilities); 212 efi_status_t (EFIAPI *set_time)(struct efi_time *time); 213 efi_status_t (EFIAPI *get_wakeup_time)(char *enabled, char *pending, 214 struct efi_time *time); 215 efi_status_t (EFIAPI *set_wakeup_time)(char enabled, 216 struct efi_time *time); 217 efi_status_t (EFIAPI *set_virtual_address_map)( 218 unsigned long memory_map_size, 219 unsigned long descriptor_size, 220 uint32_t descriptor_version, 221 struct efi_mem_desc *virtmap); 222 efi_status_t (*convert_pointer)(unsigned long dbg, void **address); 223 efi_status_t (EFIAPI *get_variable)(u16 *variable_name, 224 const efi_guid_t *vendor, 225 u32 *attributes, 226 efi_uintn_t *data_size, void *data); 227 efi_status_t (EFIAPI *get_next_variable_name)( 228 efi_uintn_t *variable_name_size, 229 u16 *variable_name, const efi_guid_t *vendor); 230 efi_status_t (EFIAPI *set_variable)(u16 *variable_name, 231 const efi_guid_t *vendor, 232 u32 attributes, 233 efi_uintn_t data_size, 234 const void *data); 235 efi_status_t (EFIAPI *get_next_high_mono_count)( 236 uint32_t *high_count); 237 void (EFIAPI *reset_system)(enum efi_reset_type reset_type, 238 efi_status_t reset_status, 239 unsigned long data_size, void *reset_data); 240 efi_status_t (EFIAPI *update_capsule)( 241 struct efi_capsule_header **capsule_header_array, 242 efi_uintn_t capsule_count, 243 u64 scatter_gather_list); 244 efi_status_t (EFIAPI *query_capsule_caps)( 245 struct efi_capsule_header **capsule_header_array, 246 efi_uintn_t capsule_count, 247 u64 *maximum_capsule_size, 248 u32 *reset_type); 249 efi_status_t (EFIAPI *query_variable_info)( 250 u32 attributes, 251 u64 *maximum_variable_storage_size, 252 u64 *remaining_variable_storage_size, 253 u64 *maximum_variable_size); 254 }; 255 256 /* EFI event group GUID definitions */ 257 #define EFI_EVENT_GROUP_EXIT_BOOT_SERVICES \ 258 EFI_GUID(0x27abf055, 0xb1b8, 0x4c26, 0x80, 0x48, \ 259 0x74, 0x8f, 0x37, 0xba, 0xa2, 0xdf) 260 261 #define EFI_EVENT_GROUP_VIRTUAL_ADDRESS_CHANGE \ 262 EFI_GUID(0x13fa7698, 0xc831, 0x49c7, 0x87, 0xea, \ 263 0x8f, 0x43, 0xfc, 0xc2, 0x51, 0x96) 264 265 #define EFI_EVENT_GROUP_MEMORY_MAP_CHANGE \ 266 EFI_GUID(0x78bee926, 0x692f, 0x48fd, 0x9e, 0xdb, \ 267 0x01, 0x42, 0x2e, 0xf0, 0xd7, 0xab) 268 269 #define EFI_EVENT_GROUP_READY_TO_BOOT \ 270 EFI_GUID(0x7ce88fb3, 0x4bd7, 0x4679, 0x87, 0xa8, \ 271 0xa8, 0xd8, 0xde, 0xe5, 0x0d, 0x2b) 272 273 #define EFI_EVENT_GROUP_RESET_SYSTEM \ 274 EFI_GUID(0x62da6a56, 0x13fb, 0x485a, 0xa8, 0xda, \ 275 0xa3, 0xdd, 0x79, 0x12, 0xcb, 0x6b) 276 277 /* EFI Configuration Table and GUID definitions */ 278 #define NULL_GUID \ 279 EFI_GUID(0x00000000, 0x0000, 0x0000, 0x00, 0x00, \ 280 0x00, 0x00, 0x00, 0x00, 0x00, 0x00) 281 282 #define EFI_GLOBAL_VARIABLE_GUID \ 283 EFI_GUID(0x8be4df61, 0x93ca, 0x11d2, 0xaa, 0x0d, \ 284 0x00, 0xe0, 0x98, 0x03, 0x2b, 0x8c) 285 286 #define LOADED_IMAGE_PROTOCOL_GUID \ 287 EFI_GUID(0x5b1b31a1, 0x9562, 0x11d2, 0x8e, 0x3f, \ 288 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 289 290 #define EFI_FDT_GUID \ 291 EFI_GUID(0xb1b621d5, 0xf19c, 0x41a5, \ 292 0x83, 0x0b, 0xd9, 0x15, 0x2c, 0x69, 0xaa, 0xe0) 293 294 #define EFI_ACPI_TABLE_GUID \ 295 EFI_GUID(0x8868e871, 0xe4f1, 0x11d3, \ 296 0xbc, 0x22, 0x00, 0x80, 0xc7, 0x3c, 0x88, 0x81) 297 298 #define SMBIOS_TABLE_GUID \ 299 EFI_GUID(0xeb9d2d31, 0x2d88, 0x11d3, \ 300 0x9a, 0x16, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d) 301 302 struct efi_configuration_table { 303 efi_guid_t guid; 304 void *table; 305 } __packed; 306 307 #define EFI_SYSTEM_TABLE_SIGNATURE ((u64)0x5453595320494249ULL) 308 309 struct efi_system_table { 310 struct efi_table_hdr hdr; 311 u16 *fw_vendor; /* physical addr of wchar_t vendor string */ 312 u32 fw_revision; 313 efi_handle_t con_in_handle; 314 struct efi_simple_text_input_protocol *con_in; 315 efi_handle_t con_out_handle; 316 struct efi_simple_text_output_protocol *con_out; 317 efi_handle_t stderr_handle; 318 struct efi_simple_text_output_protocol *std_err; 319 struct efi_runtime_services *runtime; 320 struct efi_boot_services *boottime; 321 efi_uintn_t nr_tables; 322 struct efi_configuration_table *tables; 323 }; 324 325 #define LOADED_IMAGE_GUID \ 326 EFI_GUID(0x5b1b31a1, 0x9562, 0x11d2, \ 327 0x8e, 0x3f, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 328 329 #define EFI_LOADED_IMAGE_PROTOCOL_REVISION 0x1000 330 331 struct efi_loaded_image { 332 u32 revision; 333 void *parent_handle; 334 struct efi_system_table *system_table; 335 efi_handle_t device_handle; 336 struct efi_device_path *file_path; 337 void *reserved; 338 u32 load_options_size; 339 void *load_options; 340 void *image_base; 341 aligned_u64 image_size; 342 unsigned int image_code_type; 343 unsigned int image_data_type; 344 unsigned long unload; 345 }; 346 347 #define DEVICE_PATH_GUID \ 348 EFI_GUID(0x09576e91, 0x6d3f, 0x11d2, \ 349 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 350 351 #define DEVICE_PATH_TYPE_END 0x7f 352 # define DEVICE_PATH_SUB_TYPE_INSTANCE_END 0x01 353 # define DEVICE_PATH_SUB_TYPE_END 0xff 354 355 struct efi_device_path { 356 u8 type; 357 u8 sub_type; 358 u16 length; 359 } __packed; 360 361 struct efi_mac_addr { 362 u8 addr[32]; 363 } __packed; 364 365 #define DEVICE_PATH_TYPE_HARDWARE_DEVICE 0x01 366 # define DEVICE_PATH_SUB_TYPE_MEMORY 0x03 367 # define DEVICE_PATH_SUB_TYPE_VENDOR 0x04 368 369 struct efi_device_path_memory { 370 struct efi_device_path dp; 371 u32 memory_type; 372 u64 start_address; 373 u64 end_address; 374 } __packed; 375 376 struct efi_device_path_vendor { 377 struct efi_device_path dp; 378 efi_guid_t guid; 379 u8 vendor_data[]; 380 } __packed; 381 382 #define DEVICE_PATH_TYPE_ACPI_DEVICE 0x02 383 # define DEVICE_PATH_SUB_TYPE_ACPI_DEVICE 0x01 384 385 #define EFI_PNP_ID(ID) (u32)(((ID) << 16) | 0x41D0) 386 #define EISA_PNP_ID(ID) EFI_PNP_ID(ID) 387 #define EISA_PNP_NUM(ID) ((ID) >> 16) 388 389 struct efi_device_path_acpi_path { 390 struct efi_device_path dp; 391 u32 hid; 392 u32 uid; 393 } __packed; 394 395 #define DEVICE_PATH_TYPE_MESSAGING_DEVICE 0x03 396 # define DEVICE_PATH_SUB_TYPE_MSG_ATAPI 0x01 397 # define DEVICE_PATH_SUB_TYPE_MSG_SCSI 0x02 398 # define DEVICE_PATH_SUB_TYPE_MSG_USB 0x05 399 # define DEVICE_PATH_SUB_TYPE_MSG_MAC_ADDR 0x0b 400 # define DEVICE_PATH_SUB_TYPE_MSG_USB_CLASS 0x0f 401 # define DEVICE_PATH_SUB_TYPE_MSG_SD 0x1a 402 # define DEVICE_PATH_SUB_TYPE_MSG_MMC 0x1d 403 404 struct efi_device_path_atapi { 405 struct efi_device_path dp; 406 u8 primary_secondary; 407 u8 slave_master; 408 u16 logical_unit_number; 409 } __packed; 410 411 struct efi_device_path_scsi { 412 struct efi_device_path dp; 413 u16 target_id; 414 u16 logical_unit_number; 415 } __packed; 416 417 struct efi_device_path_usb { 418 struct efi_device_path dp; 419 u8 parent_port_number; 420 u8 usb_interface; 421 } __packed; 422 423 struct efi_device_path_mac_addr { 424 struct efi_device_path dp; 425 struct efi_mac_addr mac; 426 u8 if_type; 427 } __packed; 428 429 struct efi_device_path_usb_class { 430 struct efi_device_path dp; 431 u16 vendor_id; 432 u16 product_id; 433 u8 device_class; 434 u8 device_subclass; 435 u8 device_protocol; 436 } __packed; 437 438 struct efi_device_path_sd_mmc_path { 439 struct efi_device_path dp; 440 u8 slot_number; 441 } __packed; 442 443 #define DEVICE_PATH_TYPE_MEDIA_DEVICE 0x04 444 # define DEVICE_PATH_SUB_TYPE_HARD_DRIVE_PATH 0x01 445 # define DEVICE_PATH_SUB_TYPE_CDROM_PATH 0x02 446 # define DEVICE_PATH_SUB_TYPE_FILE_PATH 0x04 447 448 struct efi_device_path_hard_drive_path { 449 struct efi_device_path dp; 450 u32 partition_number; 451 u64 partition_start; 452 u64 partition_end; 453 u8 partition_signature[16]; 454 u8 partmap_type; 455 u8 signature_type; 456 } __packed; 457 458 struct efi_device_path_cdrom_path { 459 struct efi_device_path dp; 460 u32 boot_entry; 461 u64 partition_start; 462 u64 partition_end; 463 } __packed; 464 465 struct efi_device_path_file_path { 466 struct efi_device_path dp; 467 u16 str[]; 468 } __packed; 469 470 #define BLOCK_IO_GUID \ 471 EFI_GUID(0x964e5b21, 0x6459, 0x11d2, \ 472 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 473 474 struct efi_block_io_media { 475 u32 media_id; 476 char removable_media; 477 char media_present; 478 char logical_partition; 479 char read_only; 480 char write_caching; 481 u8 pad[3]; 482 u32 block_size; 483 u32 io_align; 484 u8 pad2[4]; 485 u64 last_block; 486 /* Added in revision 2 of the protocol */ 487 u64 lowest_aligned_lba; 488 u32 logical_blocks_per_physical_block; 489 /* Added in revision 3 of the protocol */ 490 u32 optimal_transfer_length_granualarity; 491 }; 492 493 #define EFI_BLOCK_IO_PROTOCOL_REVISION2 0x00020001 494 #define EFI_BLOCK_IO_PROTOCOL_REVISION3 0x0002001f 495 496 struct efi_block_io { 497 u64 revision; 498 struct efi_block_io_media *media; 499 efi_status_t (EFIAPI *reset)(struct efi_block_io *this, 500 char extended_verification); 501 efi_status_t (EFIAPI *read_blocks)(struct efi_block_io *this, 502 u32 media_id, u64 lba, efi_uintn_t buffer_size, 503 void *buffer); 504 efi_status_t (EFIAPI *write_blocks)(struct efi_block_io *this, 505 u32 media_id, u64 lba, efi_uintn_t buffer_size, 506 void *buffer); 507 efi_status_t (EFIAPI *flush_blocks)(struct efi_block_io *this); 508 }; 509 510 struct simple_text_output_mode { 511 s32 max_mode; 512 s32 mode; 513 s32 attribute; 514 s32 cursor_column; 515 s32 cursor_row; 516 bool cursor_visible; 517 }; 518 519 #define EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL_GUID \ 520 EFI_GUID(0x387477c2, 0x69c7, 0x11d2, \ 521 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 522 523 #define EFI_BLACK 0x00 524 #define EFI_BLUE 0x01 525 #define EFI_GREEN 0x02 526 #define EFI_CYAN 0x03 527 #define EFI_RED 0x04 528 #define EFI_MAGENTA 0x05 529 #define EFI_BROWN 0x06 530 #define EFI_LIGHTGRAY 0x07 531 #define EFI_BRIGHT 0x08 532 #define EFI_DARKGRAY 0x08 533 #define EFI_LIGHTBLUE 0x09 534 #define EFI_LIGHTGREEN 0x0a 535 #define EFI_LIGHTCYAN 0x0b 536 #define EFI_LIGHTRED 0x0c 537 #define EFI_LIGHTMAGENTA 0x0d 538 #define EFI_YELLOW 0x0e 539 #define EFI_WHITE 0x0f 540 #define EFI_BACKGROUND_BLACK 0x00 541 #define EFI_BACKGROUND_BLUE 0x10 542 #define EFI_BACKGROUND_GREEN 0x20 543 #define EFI_BACKGROUND_CYAN 0x30 544 #define EFI_BACKGROUND_RED 0x40 545 #define EFI_BACKGROUND_MAGENTA 0x50 546 #define EFI_BACKGROUND_BROWN 0x60 547 #define EFI_BACKGROUND_LIGHTGRAY 0x70 548 549 /* extract foreground color from EFI attribute */ 550 #define EFI_ATTR_FG(attr) ((attr) & 0x07) 551 /* treat high bit of FG as bright/bold (similar to edk2) */ 552 #define EFI_ATTR_BOLD(attr) (((attr) >> 3) & 0x01) 553 /* extract background color from EFI attribute */ 554 #define EFI_ATTR_BG(attr) (((attr) >> 4) & 0x7) 555 556 struct efi_simple_text_output_protocol { 557 void *reset; 558 efi_status_t (EFIAPI *output_string)( 559 struct efi_simple_text_output_protocol *this, 560 const efi_string_t str); 561 efi_status_t (EFIAPI *test_string)( 562 struct efi_simple_text_output_protocol *this, 563 const efi_string_t str); 564 efi_status_t(EFIAPI *query_mode)( 565 struct efi_simple_text_output_protocol *this, 566 unsigned long mode_number, unsigned long *columns, 567 unsigned long *rows); 568 efi_status_t(EFIAPI *set_mode)( 569 struct efi_simple_text_output_protocol *this, 570 unsigned long mode_number); 571 efi_status_t(EFIAPI *set_attribute)( 572 struct efi_simple_text_output_protocol *this, 573 unsigned long attribute); 574 efi_status_t(EFIAPI *clear_screen) ( 575 struct efi_simple_text_output_protocol *this); 576 efi_status_t(EFIAPI *set_cursor_position) ( 577 struct efi_simple_text_output_protocol *this, 578 unsigned long column, unsigned long row); 579 efi_status_t(EFIAPI *enable_cursor)( 580 struct efi_simple_text_output_protocol *this, 581 bool enable); 582 struct simple_text_output_mode *mode; 583 }; 584 585 #define EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL_GUID \ 586 EFI_GUID(0xdd9e7534, 0x7762, 0x4698, \ 587 0x8c, 0x14, 0xf5, 0x85, 0x17, 0xa6, 0x25, 0xaa) 588 589 struct efi_input_key { 590 u16 scan_code; 591 s16 unicode_char; 592 }; 593 594 #define EFI_SHIFT_STATE_INVALID 0x00000000 595 #define EFI_RIGHT_SHIFT_PRESSED 0x00000001 596 #define EFI_LEFT_SHIFT_PRESSED 0x00000002 597 #define EFI_RIGHT_CONTROL_PRESSED 0x00000004 598 #define EFI_LEFT_CONTROL_PRESSED 0x00000008 599 #define EFI_RIGHT_ALT_PRESSED 0x00000010 600 #define EFI_LEFT_ALT_PRESSED 0x00000020 601 #define EFI_RIGHT_LOGO_PRESSED 0x00000040 602 #define EFI_LEFT_LOGO_PRESSED 0x00000080 603 #define EFI_MENU_KEY_PRESSED 0x00000100 604 #define EFI_SYS_REQ_PRESSED 0x00000200 605 #define EFI_SHIFT_STATE_VALID 0x80000000 606 607 #define EFI_TOGGLE_STATE_INVALID 0x00 608 #define EFI_SCROLL_LOCK_ACTIVE 0x01 609 #define EFI_NUM_LOCK_ACTIVE 0x02 610 #define EFI_CAPS_LOCK_ACTIVE 0x04 611 #define EFI_KEY_STATE_EXPOSED 0x40 612 #define EFI_TOGGLE_STATE_VALID 0x80 613 614 struct efi_key_state { 615 u32 key_shift_state; 616 u8 key_toggle_state; 617 }; 618 619 struct efi_key_data { 620 struct efi_input_key key; 621 struct efi_key_state key_state; 622 }; 623 624 struct efi_simple_text_input_ex_protocol { 625 efi_status_t (EFIAPI *reset) ( 626 struct efi_simple_text_input_ex_protocol *this, 627 bool extended_verification); 628 efi_status_t (EFIAPI *read_key_stroke_ex) ( 629 struct efi_simple_text_input_ex_protocol *this, 630 struct efi_key_data *key_data); 631 struct efi_event *wait_for_key_ex; 632 efi_status_t (EFIAPI *set_state) ( 633 struct efi_simple_text_input_ex_protocol *this, 634 u8 key_toggle_state); 635 efi_status_t (EFIAPI *register_key_notify) ( 636 struct efi_simple_text_input_ex_protocol *this, 637 struct efi_key_data *key_data, 638 efi_status_t (EFIAPI *key_notify_function)( 639 struct efi_key_data *key_data), 640 void **notify_handle); 641 efi_status_t (EFIAPI *unregister_key_notify) ( 642 struct efi_simple_text_input_ex_protocol *this, 643 void *notification_handle); 644 }; 645 646 #define EFI_SIMPLE_TEXT_INPUT_PROTOCOL_GUID \ 647 EFI_GUID(0x387477c1, 0x69c7, 0x11d2, \ 648 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 649 650 struct efi_simple_text_input_protocol { 651 efi_status_t(EFIAPI *reset)(struct efi_simple_text_input_protocol *this, 652 bool extended_verification); 653 efi_status_t(EFIAPI *read_key_stroke)( 654 struct efi_simple_text_input_protocol *this, 655 struct efi_input_key *key); 656 struct efi_event *wait_for_key; 657 }; 658 659 #define EFI_DEVICE_PATH_TO_TEXT_PROTOCOL_GUID \ 660 EFI_GUID(0x8b843e20, 0x8132, 0x4852, \ 661 0x90, 0xcc, 0x55, 0x1a, 0x4e, 0x4a, 0x7f, 0x1c) 662 663 struct efi_device_path_to_text_protocol { 664 uint16_t *(EFIAPI *convert_device_node_to_text)( 665 struct efi_device_path *device_node, 666 bool display_only, 667 bool allow_shortcuts); 668 uint16_t *(EFIAPI *convert_device_path_to_text)( 669 struct efi_device_path *device_path, 670 bool display_only, 671 bool allow_shortcuts); 672 }; 673 674 #define EFI_DEVICE_PATH_UTILITIES_PROTOCOL_GUID \ 675 EFI_GUID(0x0379be4e, 0xd706, 0x437d, \ 676 0xb0, 0x37, 0xed, 0xb8, 0x2f, 0xb7, 0x72, 0xa4) 677 678 struct efi_device_path_utilities_protocol { 679 efi_uintn_t (EFIAPI *get_device_path_size)( 680 const struct efi_device_path *device_path); 681 struct efi_device_path *(EFIAPI *duplicate_device_path)( 682 const struct efi_device_path *device_path); 683 struct efi_device_path *(EFIAPI *append_device_path)( 684 const struct efi_device_path *src1, 685 const struct efi_device_path *src2); 686 struct efi_device_path *(EFIAPI *append_device_node)( 687 const struct efi_device_path *device_path, 688 const struct efi_device_path *device_node); 689 struct efi_device_path *(EFIAPI *append_device_path_instance)( 690 const struct efi_device_path *device_path, 691 const struct efi_device_path *device_path_instance); 692 struct efi_device_path *(EFIAPI *get_next_device_path_instance)( 693 struct efi_device_path **device_path_instance, 694 efi_uintn_t *device_path_instance_size); 695 bool (EFIAPI *is_device_path_multi_instance)( 696 const struct efi_device_path *device_path); 697 struct efi_device_path *(EFIAPI *create_device_node)( 698 uint8_t node_type, 699 uint8_t node_sub_type, 700 uint16_t node_length); 701 }; 702 703 #define EFI_GOP_GUID \ 704 EFI_GUID(0x9042a9de, 0x23dc, 0x4a38, \ 705 0x96, 0xfb, 0x7a, 0xde, 0xd0, 0x80, 0x51, 0x6a) 706 707 #define EFI_GOT_RGBA8 0 708 #define EFI_GOT_BGRA8 1 709 #define EFI_GOT_BITMASK 2 710 711 struct efi_gop_mode_info { 712 u32 version; 713 u32 width; 714 u32 height; 715 u32 pixel_format; 716 u32 pixel_bitmask[4]; 717 u32 pixels_per_scanline; 718 }; 719 720 struct efi_gop_mode { 721 u32 max_mode; 722 u32 mode; 723 struct efi_gop_mode_info *info; 724 unsigned long info_size; 725 efi_physical_addr_t fb_base; 726 unsigned long fb_size; 727 }; 728 729 struct efi_gop_pixel { 730 u8 blue; 731 u8 green; 732 u8 red; 733 u8 reserved; 734 }; 735 736 #define EFI_BLT_VIDEO_FILL 0 737 #define EFI_BLT_VIDEO_TO_BLT_BUFFER 1 738 #define EFI_BLT_BUFFER_TO_VIDEO 2 739 #define EFI_BLT_VIDEO_TO_VIDEO 3 740 741 struct efi_gop { 742 efi_status_t (EFIAPI *query_mode)(struct efi_gop *this, u32 mode_number, 743 efi_uintn_t *size_of_info, 744 struct efi_gop_mode_info **info); 745 efi_status_t (EFIAPI *set_mode)(struct efi_gop *this, u32 mode_number); 746 efi_status_t (EFIAPI *blt)(struct efi_gop *this, 747 struct efi_gop_pixel *buffer, 748 u32 operation, efi_uintn_t sx, 749 efi_uintn_t sy, efi_uintn_t dx, 750 efi_uintn_t dy, efi_uintn_t width, 751 efi_uintn_t height, efi_uintn_t delta); 752 struct efi_gop_mode *mode; 753 }; 754 755 #define EFI_SIMPLE_NETWORK_GUID \ 756 EFI_GUID(0xa19832b9, 0xac25, 0x11d3, \ 757 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d) 758 759 struct efi_mac_address { 760 char mac_addr[32]; 761 }; 762 763 struct efi_ip_address { 764 u8 ip_addr[16]; 765 } __attribute__((aligned(4))); 766 767 enum efi_simple_network_state { 768 EFI_NETWORK_STOPPED, 769 EFI_NETWORK_STARTED, 770 EFI_NETWORK_INITIALIZED, 771 }; 772 773 struct efi_simple_network_mode { 774 enum efi_simple_network_state state; 775 u32 hwaddr_size; 776 u32 media_header_size; 777 u32 max_packet_size; 778 u32 nvram_size; 779 u32 nvram_access_size; 780 u32 receive_filter_mask; 781 u32 receive_filter_setting; 782 u32 max_mcast_filter_count; 783 u32 mcast_filter_count; 784 struct efi_mac_address mcast_filter[16]; 785 struct efi_mac_address current_address; 786 struct efi_mac_address broadcast_address; 787 struct efi_mac_address permanent_address; 788 u8 if_type; 789 u8 mac_changeable; 790 u8 multitx_supported; 791 u8 media_present_supported; 792 u8 media_present; 793 }; 794 795 /* receive_filters bit mask */ 796 #define EFI_SIMPLE_NETWORK_RECEIVE_UNICAST 0x01 797 #define EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST 0x02 798 #define EFI_SIMPLE_NETWORK_RECEIVE_BROADCAST 0x04 799 #define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS 0x08 800 #define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS_MULTICAST 0x10 801 802 /* interrupt status bit mask */ 803 #define EFI_SIMPLE_NETWORK_RECEIVE_INTERRUPT 0x01 804 #define EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT 0x02 805 #define EFI_SIMPLE_NETWORK_COMMAND_INTERRUPT 0x04 806 #define EFI_SIMPLE_NETWORK_SOFTWARE_INTERRUPT 0x08 807 808 /* revision of the simple network protocol */ 809 #define EFI_SIMPLE_NETWORK_PROTOCOL_REVISION 0x00010000 810 811 struct efi_simple_network { 812 u64 revision; 813 efi_status_t (EFIAPI *start)(struct efi_simple_network *this); 814 efi_status_t (EFIAPI *stop)(struct efi_simple_network *this); 815 efi_status_t (EFIAPI *initialize)(struct efi_simple_network *this, 816 ulong extra_rx, ulong extra_tx); 817 efi_status_t (EFIAPI *reset)(struct efi_simple_network *this, 818 int extended_verification); 819 efi_status_t (EFIAPI *shutdown)(struct efi_simple_network *this); 820 efi_status_t (EFIAPI *receive_filters)(struct efi_simple_network *this, 821 u32 enable, u32 disable, int reset_mcast_filter, 822 ulong mcast_filter_count, 823 struct efi_mac_address *mcast_filter); 824 efi_status_t (EFIAPI *station_address)(struct efi_simple_network *this, 825 int reset, struct efi_mac_address *new_mac); 826 efi_status_t (EFIAPI *statistics)(struct efi_simple_network *this, 827 int reset, ulong *stat_size, void *stat_table); 828 efi_status_t (EFIAPI *mcastiptomac)(struct efi_simple_network *this, 829 int ipv6, struct efi_ip_address *ip, 830 struct efi_mac_address *mac); 831 efi_status_t (EFIAPI *nvdata)(struct efi_simple_network *this, 832 int read_write, ulong offset, ulong buffer_size, 833 char *buffer); 834 efi_status_t (EFIAPI *get_status)(struct efi_simple_network *this, 835 u32 *int_status, void **txbuf); 836 efi_status_t (EFIAPI *transmit)(struct efi_simple_network *this, 837 size_t header_size, size_t buffer_size, void *buffer, 838 struct efi_mac_address *src_addr, 839 struct efi_mac_address *dest_addr, u16 *protocol); 840 efi_status_t (EFIAPI *receive)(struct efi_simple_network *this, 841 size_t *header_size, size_t *buffer_size, void *buffer, 842 struct efi_mac_address *src_addr, 843 struct efi_mac_address *dest_addr, u16 *protocol); 844 struct efi_event *wait_for_packet; 845 struct efi_simple_network_mode *mode; 846 }; 847 848 #define EFI_PXE_GUID \ 849 EFI_GUID(0x03c4e603, 0xac28, 0x11d3, \ 850 0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d) 851 852 struct efi_pxe_packet { 853 u8 packet[1472]; 854 }; 855 856 struct efi_pxe_mode { 857 u8 started; 858 u8 ipv6_available; 859 u8 ipv6_supported; 860 u8 using_ipv6; 861 u8 bis_supported; 862 u8 bis_detected; 863 u8 auto_arp; 864 u8 send_guid; 865 u8 dhcp_discover_valid; 866 u8 dhcp_ack_received; 867 u8 proxy_offer_received; 868 u8 pxe_discover_valid; 869 u8 pxe_reply_received; 870 u8 pxe_bis_reply_received; 871 u8 icmp_error_received; 872 u8 tftp_error_received; 873 u8 make_callbacks; 874 u8 ttl; 875 u8 tos; 876 u8 pad; 877 struct efi_ip_address station_ip; 878 struct efi_ip_address subnet_mask; 879 struct efi_pxe_packet dhcp_discover; 880 struct efi_pxe_packet dhcp_ack; 881 struct efi_pxe_packet proxy_offer; 882 struct efi_pxe_packet pxe_discover; 883 struct efi_pxe_packet pxe_reply; 884 }; 885 886 struct efi_pxe { 887 u64 rev; 888 void (EFIAPI *start)(void); 889 void (EFIAPI *stop)(void); 890 void (EFIAPI *dhcp)(void); 891 void (EFIAPI *discover)(void); 892 void (EFIAPI *mftp)(void); 893 void (EFIAPI *udpwrite)(void); 894 void (EFIAPI *udpread)(void); 895 void (EFIAPI *setipfilter)(void); 896 void (EFIAPI *arp)(void); 897 void (EFIAPI *setparams)(void); 898 void (EFIAPI *setstationip)(void); 899 void (EFIAPI *setpackets)(void); 900 struct efi_pxe_mode *mode; 901 }; 902 903 #define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \ 904 EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \ 905 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 906 #define EFI_FILE_PROTOCOL_REVISION 0x00010000 907 908 struct efi_file_handle { 909 u64 rev; 910 efi_status_t (EFIAPI *open)(struct efi_file_handle *file, 911 struct efi_file_handle **new_handle, 912 u16 *file_name, u64 open_mode, u64 attributes); 913 efi_status_t (EFIAPI *close)(struct efi_file_handle *file); 914 efi_status_t (EFIAPI *delete)(struct efi_file_handle *file); 915 efi_status_t (EFIAPI *read)(struct efi_file_handle *file, 916 efi_uintn_t *buffer_size, void *buffer); 917 efi_status_t (EFIAPI *write)(struct efi_file_handle *file, 918 efi_uintn_t *buffer_size, void *buffer); 919 efi_status_t (EFIAPI *getpos)(struct efi_file_handle *file, 920 u64 *pos); 921 efi_status_t (EFIAPI *setpos)(struct efi_file_handle *file, 922 u64 pos); 923 efi_status_t (EFIAPI *getinfo)(struct efi_file_handle *file, 924 const efi_guid_t *info_type, efi_uintn_t *buffer_size, 925 void *buffer); 926 efi_status_t (EFIAPI *setinfo)(struct efi_file_handle *file, 927 const efi_guid_t *info_type, efi_uintn_t buffer_size, 928 void *buffer); 929 efi_status_t (EFIAPI *flush)(struct efi_file_handle *file); 930 }; 931 932 #define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID \ 933 EFI_GUID(0x964e5b22, 0x6459, 0x11d2, \ 934 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 935 #define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION 0x00010000 936 937 struct efi_simple_file_system_protocol { 938 u64 rev; 939 efi_status_t (EFIAPI *open_volume)(struct efi_simple_file_system_protocol *this, 940 struct efi_file_handle **root); 941 }; 942 943 #define EFI_FILE_INFO_GUID \ 944 EFI_GUID(0x9576e92, 0x6d3f, 0x11d2, \ 945 0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 946 947 #define EFI_FILE_SYSTEM_INFO_GUID \ 948 EFI_GUID(0x09576e93, 0x6d3f, 0x11d2, \ 949 0x8e, 0x39, 0x00, 0xa0, 0xc9, 0x69, 0x72, 0x3b) 950 951 #define EFI_FILE_MODE_READ 0x0000000000000001 952 #define EFI_FILE_MODE_WRITE 0x0000000000000002 953 #define EFI_FILE_MODE_CREATE 0x8000000000000000 954 955 #define EFI_FILE_READ_ONLY 0x0000000000000001 956 #define EFI_FILE_HIDDEN 0x0000000000000002 957 #define EFI_FILE_SYSTEM 0x0000000000000004 958 #define EFI_FILE_RESERVED 0x0000000000000008 959 #define EFI_FILE_DIRECTORY 0x0000000000000010 960 #define EFI_FILE_ARCHIVE 0x0000000000000020 961 #define EFI_FILE_VALID_ATTR 0x0000000000000037 962 963 struct efi_file_info { 964 u64 size; 965 u64 file_size; 966 u64 physical_size; 967 struct efi_time create_time; 968 struct efi_time last_access_time; 969 struct efi_time modification_time; 970 u64 attribute; 971 u16 file_name[0]; 972 }; 973 974 struct efi_file_system_info { 975 u64 size; 976 u8 read_only; 977 u64 volume_size; 978 u64 free_space; 979 u32 block_size; 980 u16 volume_label[0]; 981 }; 982 983 #define EFI_DRIVER_BINDING_PROTOCOL_GUID \ 984 EFI_GUID(0x18a031ab, 0xb443, 0x4d1a,\ 985 0xa5, 0xc0, 0x0c, 0x09, 0x26, 0x1e, 0x9f, 0x71) 986 struct efi_driver_binding_protocol { 987 efi_status_t (EFIAPI * supported)( 988 struct efi_driver_binding_protocol *this, 989 efi_handle_t controller_handle, 990 struct efi_device_path *remaining_device_path); 991 efi_status_t (EFIAPI * start)( 992 struct efi_driver_binding_protocol *this, 993 efi_handle_t controller_handle, 994 struct efi_device_path *remaining_device_path); 995 efi_status_t (EFIAPI * stop)( 996 struct efi_driver_binding_protocol *this, 997 efi_handle_t controller_handle, 998 efi_uintn_t number_of_children, 999 efi_handle_t *child_handle_buffer); 1000 u32 version; 1001 efi_handle_t image_handle; 1002 efi_handle_t driver_binding_handle; 1003 }; 1004 1005 #define EFI_UNICODE_COLLATION_PROTOCOL2_GUID \ 1006 EFI_GUID(0xa4c751fc, 0x23ae, 0x4c3e, \ 1007 0x92, 0xe9, 0x49, 0x64, 0xcf, 0x63, 0xf3, 0x49) 1008 struct efi_unicode_collation_protocol { 1009 efi_intn_t (EFIAPI *stri_coll)( 1010 struct efi_unicode_collation_protocol *this, u16 *s1, u16 *s2); 1011 bool (EFIAPI *metai_match)(struct efi_unicode_collation_protocol *this, 1012 const u16 *string, const u16 *patter); 1013 void (EFIAPI *str_lwr)(struct efi_unicode_collation_protocol 1014 *this, u16 *string); 1015 void (EFIAPI *str_upr)(struct efi_unicode_collation_protocol *this, 1016 u16 *string); 1017 void (EFIAPI *fat_to_str)(struct efi_unicode_collation_protocol *this, 1018 efi_uintn_t fat_size, char *fat, u16 *string); 1019 bool (EFIAPI *str_to_fat)(struct efi_unicode_collation_protocol *this, 1020 const u16 *string, efi_uintn_t fat_size, 1021 char *fat); 1022 char *supported_languages; 1023 }; 1024 1025 #endif 1026