1 /* $NetBSD: efi.h,v 1.3 2023/05/22 16:27:49 riastradh Exp $ */ 2 3 /*- 4 * Copyright (c) 2004 Marcel Moolenaar 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 */ 28 29 #ifndef _DEV_EFI_EFI_H_ 30 #define _DEV_EFI_EFI_H_ 31 32 /* 33 * Machine-independent UEFI protocol definitions. Based on: 34 * 35 * Unified Extensible Firmware Interface (UEFI) Specification, 36 * Version 2.9, UEFI Forum, Inc., March 2021. 37 * 38 * https://uefi.org/sites/default/files/resources/UEFI_Spec_2_9_2021_03_18.pdf 39 */ 40 41 #if defined(__i386__) || defined(__x86_64__) 42 #define EFIAPI __attribute__((__ms_abi__)) 43 #else 44 #define EFIAPI /* empty */ 45 #endif 46 47 #ifdef _LP64 48 #define EFIERR(x) (0x8000000000000000 | (x)) 49 #else 50 #define EFIERR(x) (0x80000000 | (x)) 51 #endif 52 53 #define EFI_SUCCESS 0 54 #define EFI_INVALID_PARAMETER EFIERR(2) 55 #define EFI_UNSUPPORTED EFIERR(3) 56 #define EFI_BUFFER_TOO_SMALL EFIERR(5) 57 #define EFI_DEVICE_ERROR EFIERR(7) 58 #define EFI_WRITE_PROTECTED EFIERR(8) 59 #define EFI_OUT_OF_RESOURCES EFIERR(9) 60 #define EFI_NOT_FOUND EFIERR(14) 61 #define EFI_SECURITY_VIOLATION EFIERR(26) 62 63 enum efi_reset { 64 EFI_RESET_COLD, 65 EFI_RESET_WARM, 66 EFI_RESET_SHUTDOWN, 67 EFI_RESET_PLATFORM_SPECIFIC, 68 }; 69 70 typedef uint16_t efi_char; 71 typedef unsigned long efi_status; 72 73 struct efi_cfgtbl { 74 struct uuid ct_uuid; 75 void *ct_data; 76 }; 77 78 struct efi_md { 79 uint32_t md_type; 80 #define EFI_MD_TYPE_NULL 0 81 #define EFI_MD_TYPE_CODE 1 /* Loader text. */ 82 #define EFI_MD_TYPE_DATA 2 /* Loader data. */ 83 #define EFI_MD_TYPE_BS_CODE 3 /* Boot services text. */ 84 #define EFI_MD_TYPE_BS_DATA 4 /* Boot services data. */ 85 #define EFI_MD_TYPE_RT_CODE 5 /* Runtime services text. */ 86 #define EFI_MD_TYPE_RT_DATA 6 /* Runtime services data. */ 87 #define EFI_MD_TYPE_FREE 7 /* Unused/free memory. */ 88 #define EFI_MD_TYPE_BAD 8 /* Bad memory */ 89 #define EFI_MD_TYPE_RECLAIM 9 /* ACPI reclaimable memory. */ 90 #define EFI_MD_TYPE_FIRMWARE 10 /* ACPI NV memory */ 91 #define EFI_MD_TYPE_IOMEM 11 /* Memory-mapped I/O. */ 92 #define EFI_MD_TYPE_IOPORT 12 /* I/O port space. */ 93 #define EFI_MD_TYPE_PALCODE 13 /* PAL */ 94 #define EFI_MD_TYPE_PMEM 14 /* Persistent memory. */ 95 uint32_t __pad; 96 uint64_t md_phys; 97 uint64_t md_virt; 98 uint64_t md_pages; 99 uint64_t md_attr; 100 #define EFI_MD_ATTR_UC 0x0000000000000001UL 101 #define EFI_MD_ATTR_WC 0x0000000000000002UL 102 #define EFI_MD_ATTR_WT 0x0000000000000004UL 103 #define EFI_MD_ATTR_WB 0x0000000000000008UL 104 #define EFI_MD_ATTR_UCE 0x0000000000000010UL 105 #define EFI_MD_ATTR_WP 0x0000000000001000UL 106 #define EFI_MD_ATTR_RP 0x0000000000002000UL 107 #define EFI_MD_ATTR_XP 0x0000000000004000UL 108 #define EFI_MD_ATTR_NV 0x0000000000008000UL 109 #define EFI_MD_ATTR_MORE_RELIABLE 0x0000000000010000UL 110 #define EFI_MD_ATTR_RO 0x0000000000020000UL 111 #define EFI_MD_ATTR_SP 0x0000000000040000UL 112 #define EFI_MD_ATTR_CPU_CRYPTO 0x0000000000080000UL 113 #define EFI_MD_ATTR_RT 0x8000000000000000UL 114 }; 115 116 struct efi_tm { 117 uint16_t tm_year; /* 1998 - 20XX */ 118 uint8_t tm_mon; /* 1 - 12 */ 119 uint8_t tm_mday; /* 1 - 31 */ 120 uint8_t tm_hour; /* 0 - 23 */ 121 uint8_t tm_min; /* 0 - 59 */ 122 uint8_t tm_sec; /* 0 - 59 */ 123 uint8_t __pad1; 124 uint32_t tm_nsec; /* 0 - 999,999,999 */ 125 int16_t tm_tz; /* -1440 to 1440 or 2047 */ 126 uint8_t tm_dst; 127 uint8_t __pad2; 128 }; 129 130 struct efi_tmcap { 131 uint32_t tc_res; /* 1e-6 parts per million */ 132 uint32_t tc_prec; /* hertz */ 133 uint8_t tc_stz; /* Set clears sub-second time */ 134 }; 135 136 struct efi_tblhdr { 137 uint64_t th_sig; 138 uint32_t th_rev; 139 uint32_t th_hdrsz; 140 uint32_t th_crc32; 141 uint32_t __res; 142 }; 143 144 struct efi_rt { 145 struct efi_tblhdr rt_hdr; 146 efi_status (*rt_gettime)(struct efi_tm *, struct efi_tmcap *) 147 EFIAPI; 148 efi_status (*rt_settime)(struct efi_tm *) EFIAPI; 149 efi_status (*rt_getwaketime)(uint8_t *, uint8_t *, 150 struct efi_tm *) EFIAPI; 151 efi_status (*rt_setwaketime)(uint8_t, struct efi_tm *) EFIAPI; 152 efi_status (*rt_setvirtual)(u_long, u_long, uint32_t, 153 struct efi_md *) EFIAPI; 154 efi_status (*rt_cvtptr)(u_long, void **) EFIAPI; 155 efi_status (*rt_getvar)(efi_char *, struct uuid *, uint32_t *, 156 u_long *, void *) EFIAPI; 157 efi_status (*rt_scanvar)(u_long *, efi_char *, struct uuid *) 158 EFIAPI; 159 efi_status (*rt_setvar)(efi_char *, struct uuid *, uint32_t, 160 u_long, void *) EFIAPI; 161 efi_status (*rt_gethicnt)(uint32_t *) EFIAPI; 162 efi_status (*rt_reset)(enum efi_reset, efi_status, u_long, 163 efi_char *) EFIAPI; 164 }; 165 166 struct efi_systbl { 167 struct efi_tblhdr st_hdr; 168 #define EFI_SYSTBL_SIG 0x5453595320494249UL 169 efi_char *st_fwvendor; 170 uint32_t st_fwrev; 171 #ifdef _LP64 172 uint32_t __pad; 173 #endif 174 void *st_cin; 175 void *st_cinif; 176 void *st_cout; 177 void *st_coutif; 178 void *st_cerr; 179 void *st_cerrif; 180 struct efi_rt *st_rt; 181 void *st_bs; 182 u_long st_entries; 183 struct efi_cfgtbl *st_cfgtbl; 184 }; 185 #ifdef _LP64 186 __CTASSERT(sizeof(struct efi_systbl) == 120); 187 #else 188 __CTASSERT(sizeof(struct efi_systbl) == 72); 189 #endif 190 191 #endif /* _DEV_EFI_EFI_H_ */ 192